org.alfresco.service.cmr.repository
Interface ContentAccessor

All Known Subinterfaces:
ContentReader, ContentWriter
All Known Implementing Classes:
AbstractContentAccessor, AbstractContentReader, AbstractContentWriter, EmptyContentReader, FileContentReader, FileContentWriter, HttpAlfrescoContentReader

public interface ContentAccessor

Interface for instances that provide read and write access to content.


Method Summary
 void addListener(ContentStreamListener listener)
          Use this method to register any interest in events against underlying content streams.
 ContentData getContentData()
          Get the data representation of the content being accessed.
 java.lang.String getContentUrl()
          Retrieve the URL that this accessor references
 java.lang.String getEncoding()
          Get the encoding of the content being accessed
 java.util.Locale getLocale()
          Get the locale of the content being accessed
 java.lang.String getMimetype()
          Get the content mimetype
 long getSize()
          Gets the size of the content that this reader references.
 boolean isChannelOpen()
          Gets the open/close state of the underlying IO Channel.
 void setEncoding(java.lang.String encoding)
          Set the String encoding for this accessor
 void setLocale(java.util.Locale locale)
          Set the Locale for this accessor
 void setMimetype(java.lang.String mimetype)
          Set the mimetype that must be used for accessing the content
 void setRetryingTransactionHelper(RetryingTransactionHelper helper)
          Set the transaction helper for callbacks.
 

Method Detail

isChannelOpen

boolean isChannelOpen()
Gets the open/close state of the underlying IO Channel.

Returns:
Returns true if the underlying IO Channel is open

addListener

void addListener(ContentStreamListener listener)
Use this method to register any interest in events against underlying content streams. output stream.

This method can only be used before the content stream has been retrieved.

When the stream has been closed, all listeners will be called within a transaction - to this end, a TransactionService must have been set as well.

Parameters:
listener - a listener that will be called for output stream event notification
See Also:
ContentAccessor.setRetryingTransactionHelper(RetryingTransactionHelper)

setRetryingTransactionHelper

void setRetryingTransactionHelper(RetryingTransactionHelper helper)
Set the transaction helper for callbacks.


getSize

long getSize()
Gets the size of the content that this reader references.

Returns:
Returns the document byte length, or OL if the content doesn't exist.

getContentData

ContentData getContentData()
Get the data representation of the content being accessed.

The content mimetype must be set before this method is called as the content data requires a mimetype whenever the content URL is specified.

Returns:
Returns the content data
See Also:
ContentData.ContentData(String, String, long, String)

getContentUrl

java.lang.String getContentUrl()
Retrieve the URL that this accessor references

Returns:
the content URL

getMimetype

java.lang.String getMimetype()
Get the content mimetype

Returns:
Returns a content mimetype

setMimetype

void setMimetype(java.lang.String mimetype)
Set the mimetype that must be used for accessing the content

Parameters:
mimetype - the content mimetype

getEncoding

java.lang.String getEncoding()
Get the encoding of the content being accessed

Returns:
Returns a valid java String encoding

setEncoding

void setEncoding(java.lang.String encoding)
Set the String encoding for this accessor

Parameters:
encoding - a java-recognised encoding format

getLocale

java.util.Locale getLocale()
Get the locale of the content being accessed

Returns:
Returns a valid java Locale

setLocale

void setLocale(java.util.Locale locale)
Set the Locale for this accessor

Parameters:
locale - a java-recognised locale


Copyright © 2005 - 2010 Alfresco Software, Inc. All Rights Reserved.