ContentReader (Alfresco 5.0.3 Public API)

Implementations that are able to provide inter-VM streaming, such as accessing WebDAV, would be Serializable. An accessor that has to access a local file on the server could not provide inter-VM streaming unless it specifically makes remote calls and opens sockets, etc.

Author:

Derek Hulley

See Also:

ContentWriter

Method Summary
boolean	exists() Check if the underlying content is present.
void	getContent(File file) Gets content from the repository direct to file
void	getContent(OutputStream os) Gets content from the repository.
InputStream	getContentInputStream() Get a stream to read from the underlying channel
String	getContentString() Gets content from the repository direct to `String`.
String	getContentString(int length) Gets content from the repository direct to `String`, but limiting the string size to a given number of characters.
FileChannel	getFileChannel() Provides read-only, random-access to the underlying content.
long	getLastModified() Gets the time of the last modification of the underlying content.
ReadableByteChannel	getReadableChannel() Provides low-level access to the underlying content.
ContentReader	getReader() Convenience method to get another reader onto the underlying content.
boolean	isClosed() Convenience method to find out if this reader has been closed.

Methods inherited from interface org.alfresco.service.cmr.repository.ContentAccessor

addListener, getContentData, getContentUrl, getEncoding, getLocale, getMimetype, getSize, isChannelOpen, setEncoding, setLocale, setMimetype

Method Detail

getReader

ContentReader getReader()
throws ContentIOException

Convenience method to get another reader onto the underlying content.

Returns:

Returns a reader onto the underlying content

Throws:

ContentIOException

exists

boolean exists()

Check if the underlying content is present.

Returns:

Returns true if there is content at the URL refered to by this reader

getLastModified

long getLastModified()

Gets the time of the last modification of the underlying content.

Returns:

Returns the last modification time using the standard long time, or 0L if the content doesn't exist.

See Also:

System.currentTimeMillis()

isClosed

boolean isClosed()

Convenience method to find out if this reader has been closed. Once closed, the content can no longer be read. This method could be used to wait for a particular read operation to complete, for example.

Returns:

Return true if the content input stream has been used and closed otherwise false.

getReadableChannel

ReadableByteChannel getReadableChannel()
throws ContentIOException

Provides low-level access to the underlying content.

Once the stream is provided to a client it should remain active (subject to any timeouts) until closed by the client.

Returns:

Returns a stream that can be read at will, but must be closed when completed

Throws:

ContentIOException

getFileChannel

FileChannel getFileChannel()
throws ContentIOException

Provides read-only, random-access to the underlying content. In general, this method should be considered more expensive than the sequential-access method, getReadableChannel().

Returns:

Returns a random-access channel onto the content

Throws:

ContentIOException

getContentInputStream

InputStream getContentInputStream()
throws ContentIOException

Get a stream to read from the underlying channel

Returns:

Returns an input stream onto the underlying channel

Throws:

ContentIOException

See Also: