oracle.ifs.server

Class S_LibrarySessionContentStorageManager

java.lang.Object

oracle.ifs.server.S_LibrarySessionContentStorageManager

All Implemented Interfaces:

ContentStorageManager

Direct Known Subclasses:

OracleContentStorageManager, PostgresContentStorageManager

public abstract class S_LibrarySessionContentStorageManager
extends Object
implements ContentStorageManager

S_LibrarySessionContentStorageManager implements the ContentStorageManager interface to manage content storage.

An S_LibrarySessionContentStorageManager ("CSM") is created for and bound to each S_LibrarySession. CSM mediates access to the subsystem that stores, retrieves, and otherwise manages binary content. This subsystem includes:

• MEDIA and its subtypes
• the content storage tables
• content migration between MEDIAs
• read indication
• quota
• Oracle Text indexing
• Oracle Text themes, gists, and summaries

(Published)

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONTEXTROUTERTABLE_TABLENAME Name of the context router table.
protected static Long	INDEXINGSTATE_AWAITING_EXTRACTION The value of the INDEXINGSTATE column in ODMZ_CONTEXT_ROUTER to indicate content ready to be extracted for indirect full-text indexing.
protected static Long	INDEXINGSTATE_COMPLETE The value of the INDEXINGSTATE column in ODMZ_CONTEXT_ROUTER to indicate content requiring no further processing by CMSDK with respect to full-text indexing.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	S_LibrarySessionContentStorageManager(S_LibrarySession session) Constructs a CSM.

Method Summary

Modifier and Type	Method and Description
byte[]	acquireByteBuffer() Acquires a byte buffer.
void	deleteFromContextRouter(Long coId) Deletes a row from the context router table.
abstract int	deleteOldFilteredContent(S_LibrarySession session, long age) Delete old filtered content entries.
void	destroyContent(S_Media media, Long cid, Long coId, S_LibraryObjectDefinition sdef) Destroys the content, if any, for the specified ContentObject.
abstract void	destroyTextRenditions(S_ContentObject co) Destroy all text renditions: themes, summaries, and filtered content.
void	dispose() Disposes this CSM.
Long	extractContentForIndexing(Long previousContentObjectId, int batchSize) Called by the ContentAgent, identifies rows in ODMZ_CONTEXT_ROUTER whose content is ready for indirect full-text indexing, and for each such row, sets the INDEXABLECONTENT BLOB column to the content.
protected abstract void	extractContentForIndexing(S_ContentObject co) For the specified ContentObject, extracts the content and loads it into the INDEXABLECONTENT column in the corresponding ODMZ_CONTEXT_ROUTER row.
abstract void	filterContent(S_ContentObject co, boolean plaintext) Generate filtered content for the specified ContentObject.
abstract void	generateSummary(S_ContentObject co, String pointOfView, long sizeAsPercent, long sizeAsNumParagraphs, String summaryLevel) Generate Summary for specified ContentObject.
abstract void	generateThemes(S_ContentObject co, boolean fullThemes) Generate Themes for specified ContentObject.
int	getByteBufferSize() Estimates the size, in bytes, of a buffer that would be returned by acquireByteBuffer.
S_RandomAccessorImpl	getContentByRandomAccess(S_Document doc, S_ContentObject co) Gets a RandomAccessor for randomly reading the content of the specified document.
Reader	getContentReader(S_ContentObject co) Gets the content of the specified ContentObject as a Reader.
InputStream	getContentStream(S_ContentObject co) Gets the content of the specified ContentObject as an InputStream.
static ContextTable[]	getContextTables(S_LibrarySession sess) Called by search.
abstract Reader	getFilteredContent(S_ContentObject co) Gets the filtered content for specified ContentObject.
abstract String	getFullTextIndexName() Gets the name of the full text index.
static String	getIndexName()
Date	getLastAccessDate(Long coId) Gets the last access date for the specified ContentObject.
Long	getNewContentID() get's a new id from the master sequence
protected String	getOracleCharacterSet(String ianaCharset) Gets the Oracle character set corresponding to specified value of the IANA Character set, stored in the ContentObejct.CHARACTERSET attribute.
S_LibrarySession	getSession() Gets the session context.
abstract Reader	getSummary(S_ContentObject co, String pointOfView) Gets the summary for specified ContentObject and point of view.
abstract ContextTheme[]	getThemes(S_ContentObject co) Gets the generate Themes for specified ContentObject.
abstract void	insertIntoContextRouter(Long coId, Long coClassId, Long cid, S_Media media, S_ContentVaultEntry cve, long contentSize, String oracleCharacterSet, String oracleLanguage, boolean text, boolean indirectFullTextIndexing) Inserts (or schedules an insert of) a row in the context router table.
abstract void	invalidateFilteredContent(S_ContentObject co) Invalidates any Filtered Content that was generated for specified ContentObject.
abstract void	invalidateSummaries(S_ContentObject co) Invalidates any Summary that was generated for specified ContentObject.
abstract void	invalidateThemes(S_ContentObject co) Invalidates any Themes that have been generated for specified ContentObject.
abstract boolean	isFullTextIndexingEnabled() Gets whether full-text indexing is enabled.
abstract void	registerBfile(Object bfile) Binds the specified BFILE to this session.
void	registerRandomAccessor(S_RandomAccessorImpl ra) Binds the specified RandomAccessor to this session.
void	releaseByteBuffer(byte[] buffer) Releases a byte buffer previously acquired by acquireByteBuffer.
String	resolveCharacterSet(S_LibraryObjectDefinition def) Gets the CHARACTERSET attribute of the specified ContentObject definition, setting a default CHARACTERSET attribute if one isn't set.
Serializable	retrieveSerializedObject(Long contentRef) retrieveSerializedObject - retrieve serializable object in the default "Search" Media instance.
S_Media	selectMedia(S_ContentObject co, S_LibraryObjectDefinition def) Selects the media to use for the specified ContentObject.
void	setContentProperties(S_LibraryObjectDefinition sdef, S_ContentObject sco) Cascades updates to a ContentObject to other on-disk structures.
Long	storeSerializedObject(Serializable obj) storeSerializedObject - store serializable object in the default "Search" Media instance.
abstract void	syncIndex() Sync's the index.
abstract void	unregisterBfile(Object bfile) Unbinds the specified BFILE from this session.
void	unregisterRandomAccessor(S_RandomAccessorImpl ra) Unbinds the specified RandomAccessor from this session.
S_RandomAccessorImpl	updateContentByRandomAccess(S_Document doc, S_ContentObject co, S_LibraryObjectDefinition sdocdef, Long expirationPeriod) Gets a RandomAccessor for randomly writing and reading the content of the specified document.
protected void	updateLastAccessDate(Long coId) Updates a row in the last access date table, best efforts, inserting the row if it does not exist.
S_Media	validateMedia(S_ContentObject co, S_LibraryObjectDefinition def) Selects the media to use for the specified ContentObject.
void	validateMediaAndSetContent(S_ContentObject co, S_LibraryObjectDefinition def) Sets the content of the specified ContentObject.
void	verifyCanDestroyContent(S_Media media, Long cid) Verify that content can be destroyed for the specified Media.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface oracle.ifs.server.ContentStorageManager

manuallyInsertIntoContextRouter

Field Detail

CONTEXTROUTERTABLE_TABLENAME

public static final String CONTEXTROUTERTABLE_TABLENAME

Name of the context router table.

See Also:

Constant Field Values

(Unpublished)

INDEXINGSTATE_AWAITING_EXTRACTION

protected static final Long INDEXINGSTATE_AWAITING_EXTRACTION

The value of the INDEXINGSTATE column in ODMZ_CONTEXT_ROUTER to indicate content ready to be extracted for indirect full-text indexing.

(Unpublished)

INDEXINGSTATE_COMPLETE

protected static final Long INDEXINGSTATE_COMPLETE

The value of the INDEXINGSTATE column in ODMZ_CONTEXT_ROUTER to indicate content requiring no further processing by CMSDK with respect to full-text indexing.

(Unpublished)

Constructor Detail

S_LibrarySessionContentStorageManager

protected S_LibrarySessionContentStorageManager(S_LibrarySession session)
                                         throws IfsException

Constructs a CSM.

Parameters:

session - the sesion to which this CSM belongs; required

Throws:

IfsException - if the operation fails

(Unpublished)

Method Detail

getSession

public S_LibrarySession getSession()

Gets the session context.

Returns:

the session context

(Unpublished)

dispose

public void dispose()

Disposes this CSM.

Specified by:

dispose in interface ContentStorageManager

(Unpublished)

getContentStream

public InputStream getContentStream(S_ContentObject co)
                             throws IfsException

Gets the content of the specified ContentObject as an InputStream.

Specified by:

getContentStream in interface ContentStorageManager

Parameters:

co - the ContentObject; required

Returns:

the content stream

Throws:

IfsException - if the operation fails

(Unpublished)

getContentReader

public Reader getContentReader(S_ContentObject co)
                        throws IfsException

Gets the content of the specified ContentObject as a Reader.

Specified by:

getContentReader in interface ContentStorageManager

Parameters:

co - the ContentObject; required

Returns:

the content

Throws:

IfsException - if the operation fails

(Unpublished)

validateMediaAndSetContent

public void validateMediaAndSetContent(S_ContentObject co,
                                       S_LibraryObjectDefinition def)
                                throws IfsException

Sets the content of the specified ContentObject.

The ContentObject may be existing or new. An existing ContentObject must not already have content (or destroyContent must be called prior to this method.)

Specified by:

validateMediaAndSetContent in interface ContentStorageManager

Parameters:

co - the ContentObject; required

def - the ContentObject definition; required

Throws:

IfsException - if the operation fails

validateMedia

public S_Media validateMedia(S_ContentObject co,
                             S_LibraryObjectDefinition def)
                      throws IfsException

Selects the media to use for the specified ContentObject.

If media is specified in the definition, it is validated. Otherwise a media is chosen by default and set in the definition.

Specified by:

validateMedia in interface ContentStorageManager

Parameters:

co - the ContentObject; required

def - the ContentObject definition; required

Returns:

the resolved Media

Throws:

IfsException - if the operation fails

(Unpublished)

selectMedia

public S_Media selectMedia(S_ContentObject co,
                           S_LibraryObjectDefinition def)
                    throws IfsException

Selects the media to use for the specified ContentObject.

If media is specified in the definition, it is validated. Otherwise a media is chosen by default, and verified that it is writable.

Specified by:

selectMedia in interface ContentStorageManager

Parameters:

co - the ContentObject; required

def - the ContentObject definition; required

Returns:

the resolved Media

Throws:

IfsException - if the operation fails

(Unpublished)

getByteBufferSize

public int getByteBufferSize()
                      throws IfsException

Estimates the size, in bytes, of a buffer that would be returned by acquireByteBuffer.

Specified by:

getByteBufferSize in interface ContentStorageManager

Returns:

the estimated size, in bytes

Throws:

IfsException - if the operation fails

(Unpublished)

acquireByteBuffer

public byte[] acquireByteBuffer()
                         throws IfsException

Acquires a byte buffer.

releaseByteBuffer must be called to release the byte buffer when it is no longer needed.

Specified by:

acquireByteBuffer in interface ContentStorageManager

Returns:

the buffer

Throws:

IfsException - if the operation fails

(Unpublished)

releaseByteBuffer

public void releaseByteBuffer(byte[] buffer)
                       throws IfsException

Releases a byte buffer previously acquired by acquireByteBuffer.

Specified by:

releaseByteBuffer in interface ContentStorageManager

Parameters:

buffer - the buffer

Throws:

IfsException - if the operation fails

getNewContentID

public Long getNewContentID()
                     throws IfsException

get's a new id from the master sequence

Specified by:

getNewContentID in interface ContentStorageManager

Returns:

the ID to use for new content entry

Throws:

IfsException - if the operation fails

(Unpublished)

setContentProperties

public void setContentProperties(S_LibraryObjectDefinition sdef,
                                 S_ContentObject sco)
                          throws IfsException

Cascades updates to a ContentObject to other on-disk structures.

Specified by:

setContentProperties in interface ContentStorageManager

Parameters:

sdef - definition

sco - the existing ContentObject

Throws:

IfsException - if the operation fails

(Unpublished)

getContentByRandomAccess

public S_RandomAccessorImpl getContentByRandomAccess(S_Document doc,
                                                     S_ContentObject co)
                                              throws IfsException

Gets a RandomAccessor for randomly reading the content of the specified document.

Specified by:

getContentByRandomAccess in interface ContentStorageManager

Parameters:

doc - the document

co - the ContentObject of the document

Returns:

a RandomAccessor

Throws:

IfsException - if the operation fails

(Unpublished)

updateContentByRandomAccess

public S_RandomAccessorImpl updateContentByRandomAccess(S_Document doc,
                                                        S_ContentObject co,
                                                        S_LibraryObjectDefinition sdocdef,
                                                        Long expirationPeriod)
                                                 throws IfsException

Gets a RandomAccessor for randomly writing and reading the content of the specified document.

Specified by:

updateContentByRandomAccess in interface ContentStorageManager

Parameters:

doc - the document

co - the ContentObject of the document

sdocdef - a DocumentDefinition, as a S_LibraryObjectDefinition

expirationPeriod - the expiration period for the RandomAccessor, in seconds, or null for the default expiration period

Returns:

a RandomAccessor

Throws:

IfsException - if the operation fails

(Unpublished)

registerRandomAccessor

public void registerRandomAccessor(S_RandomAccessorImpl ra)
                            throws IfsException

Binds the specified RandomAccessor to this session.

Specified by:

registerRandomAccessor in interface ContentStorageManager

Parameters:

ra - the random acccessor

Throws:

IfsException - if the operation fails

(Unpublished)

unregisterRandomAccessor

public void unregisterRandomAccessor(S_RandomAccessorImpl ra)
                              throws IfsException

Unbinds the specified RandomAccessor from this session.

Specified by:

unregisterRandomAccessor in interface ContentStorageManager

Parameters:

ra - the random accessor

Throws:

IfsException - if the operation fails

(Unpublished)

destroyContent

public void destroyContent(S_Media media,
                           Long cid,
                           Long coId,
                           S_LibraryObjectDefinition sdef)
                    throws IfsException

Destroys the content, if any, for the specified ContentObject.

Specified by:

destroyContent in interface ContentStorageManager

Parameters:

media - the media

cid - the content id

coId - the ContentObject id

sdef - the ContentObject definition

Throws:

IfsException - if the operation fails

verifyCanDestroyContent

public void verifyCanDestroyContent(S_Media media,
                                    Long cid)
                             throws IfsException

Description copied from interface: ContentStorageManager

Verify that content can be destroyed for the specified Media.

Specified by:

verifyCanDestroyContent in interface ContentStorageManager

Parameters:

media - the Media to check

cid - the content ID

Throws:

IfsException - if the operation fails

storeSerializedObject

public Long storeSerializedObject(Serializable obj)
                           throws IfsException

storeSerializedObject - store serializable object in the default "Search" Media instance.

Specified by:

storeSerializedObject in interface ContentStorageManager

Parameters:

obj - the object to store

Returns:

the handle for the newly stored piece of content

Throws:

if - operation fails

IfsException - if the operation fails

(Unpublished)

retrieveSerializedObject

public Serializable retrieveSerializedObject(Long contentRef)
                                      throws IfsException

retrieveSerializedObject - retrieve serializable object in the default "Search" Media instance.

Specified by:

retrieveSerializedObject in interface ContentStorageManager

Parameters:

contentRef - the content reference

Returns:

the object to store

Throws:

if - operation fails

IfsException - if the operation fails

(Unpublished)

registerBfile

public abstract void registerBfile(Object bfile)
                            throws IfsException

Binds the specified BFILE to this session.

Specified by:

registerBfile in interface ContentStorageManager

Parameters:

bfile - the BFILE

Throws:

IfsException - if the operation fails

(Unpublished)

unregisterBfile

public abstract void unregisterBfile(Object bfile)
                              throws IfsException

Unbinds the specified BFILE from this session.

Specified by:

unregisterBfile in interface ContentStorageManager

Parameters:

bfile - the BFILE

Throws:

IfsException - if the operation fails

(Unpublished)

updateLastAccessDate

protected void updateLastAccessDate(Long coId)
                             throws IfsException

Updates a row in the last access date table, best efforts, inserting the row if it does not exist.

Parameters:

coId - the ContentObject id; required

Throws:

IfsException - if the operation fails

(Unpublished)

getLastAccessDate

public Date getLastAccessDate(Long coId)
                       throws IfsException

Gets the last access date for the specified ContentObject.

Specified by:

getLastAccessDate in interface ContentStorageManager

Parameters:

coId - the ContentObject id; required

Returns:

the last access date, or null if none

Throws:

IfsException - if the operation fails

(Unpublished)

isFullTextIndexingEnabled

public abstract boolean isFullTextIndexingEnabled()
                                           throws IfsException

Gets whether full-text indexing is enabled.

Each invocation of this method queries the database. S_LibrarySession.isFullTextIndexingEnabled() caches the value returned by this method, and should almost always be used instead of this method.

Specified by:

isFullTextIndexingEnabled in interface ContentStorageManager

Returns:

whether full-text indexing is enabled

Throws:

IfsException - if the operation fails

(Unpublished)

getFullTextIndexName

public abstract String getFullTextIndexName()

Gets the name of the full text index.

Specified by:

getFullTextIndexName in interface ContentStorageManager

Returns:

the name of the full text index

(Published)

getIndexName

public static String getIndexName()

(Unpublished)

getContextTables

public static ContextTable[] getContextTables(S_LibrarySession sess)
                                       throws IfsException

Called by search.

Throws:

IfsException

(Unpublished)

syncIndex

public abstract void syncIndex()
                        throws IfsException

Sync's the index. Note, this affects all context media.

Specified by:

syncIndex in interface ContentStorageManager

Throws:

IfsException - if the operation fails

(Unpublished)

insertIntoContextRouter

public abstract void insertIntoContextRouter(Long coId,
                                             Long coClassId,
                                             Long cid,
                                             S_Media media,
                                             S_ContentVaultEntry cve,
                                             long contentSize,
                                             String oracleCharacterSet,
                                             String oracleLanguage,
                                             boolean text,
                                             boolean indirectFullTextIndexing)
                                      throws IfsException

Inserts (or schedules an insert of) a row in the context router table.

Specified by:

insertIntoContextRouter in interface ContentStorageManager

Parameters:

coId - the ContentObject id; required

coClassId - the ContentObject class id; required

cid - the content id; required

media - the Media where the content is stored; required

contentSize - the content size; required

cve - the ContentVaultEntry (can be null)

oracleCharacterSet - the Oracle character set code

oracleLanguage - the Oracle language code

text - whether the context is a text format

indirectFullTextIndexing - whether to perform indirect full-text indexing

Throws:

IfsException - if the operation fails

(Unpublished)

deleteFromContextRouter

public void deleteFromContextRouter(Long coId)
                             throws IfsException

Deletes a row from the context router table.

Specified by:

deleteFromContextRouter in interface ContentStorageManager

Parameters:

coId - the ContentObject id; required

Throws:

IfsException - if the operation fails

(Unpublished)

extractContentForIndexing

public Long extractContentForIndexing(Long previousContentObjectId,
                                      int batchSize)
                               throws IfsException

Called by the ContentAgent, identifies rows in ODMZ_CONTEXT_ROUTER whose content is ready for indirect full-text indexing, and for each such row, sets the INDEXABLECONTENT BLOB column to the content.

To avoid long-running transactions, this method is repeatedly called to extract content in batches. Only rows in ODMZ_CONTEXT_ROUTER whose id is greater than previousContentObjectId are considered. Each invocation processes no more than batchSize rows in ODMZ_CONTEXT_ROUTER.

Specified by:

extractContentForIndexing in interface ContentStorageManager

Parameters:

previousContentObjectId - the id of the last ODMZ_CONTEXT_ROUTER row processed in the previous batch, or null if this is the first batch

batchSize - the maximum number of rows to process in this batch

Returns:

the id of the last ODMZ_CONTEXT_ROUTER row processed in this batch, or null if no rows were processed

Throws:

IfsException - 32385: if the operation fails

(Unpublished)

extractContentForIndexing

protected abstract void extractContentForIndexing(S_ContentObject co)
                                           throws IfsException

For the specified ContentObject, extracts the content and loads it into the INDEXABLECONTENT column in the corresponding ODMZ_CONTEXT_ROUTER row.

Parameters:

co - the ContentObject

Throws:

IfsException - if the operation fails

generateThemes

public abstract void generateThemes(S_ContentObject co,
                                    boolean fullThemes)
                             throws IfsException

Generate Themes for specified ContentObject.

Specified by:

generateThemes in interface ContentStorageManager

Parameters:

co - the ContentObject

fullThemes - whether full themes are desired

Throws:

IfsException - if the operation fails

getThemes

public abstract ContextTheme[] getThemes(S_ContentObject co)
                                  throws IfsException

Gets the generate Themes for specified ContentObject.

Specified by:

getThemes in interface ContentStorageManager

Parameters:

co - the ContentObject

Returns:

the themes

Throws:

IfsException - if the operation fails

invalidateThemes

public abstract void invalidateThemes(S_ContentObject co)
                               throws IfsException

Invalidates any Themes that have been generated for specified ContentObject.

Specified by:

invalidateThemes in interface ContentStorageManager

Parameters:

co - the ContentObject

Throws:

IfsException - if the operation fails

generateSummary

public abstract void generateSummary(S_ContentObject co,
                                     String pointOfView,
                                     long sizeAsPercent,
                                     long sizeAsNumParagraphs,
                                     String summaryLevel)
                              throws IfsException

Generate Summary for specified ContentObject.

Specified by:

generateSummary in interface ContentStorageManager

Parameters:

co - the ContentObject

pointOfView - the point Of view

sizeAsPercent - the size As Percent

sizeAsNumParagraphs - the size As number of paragraphs

summaryLevel - the summary level

Throws:

IfsException - if the operation fails

getSummary

public abstract Reader getSummary(S_ContentObject co,
                                  String pointOfView)
                           throws IfsException

Gets the summary for specified ContentObject and point of view.

Specified by:

getSummary in interface ContentStorageManager

Parameters:

co - the ContentObject

pointOfView - the point Of view

Returns:

the summary

Throws:

IfsException - if the operation fails

invalidateSummaries

public abstract void invalidateSummaries(S_ContentObject co)
                                  throws IfsException

Invalidates any Summary that was generated for specified ContentObject.

Specified by:

invalidateSummaries in interface ContentStorageManager

Parameters:

co - the ContentObject

Throws:

IfsException - if the operation fails

filterContent

public abstract void filterContent(S_ContentObject co,
                                   boolean plaintext)
                            throws IfsException

Generate filtered content for the specified ContentObject.

Specified by:

filterContent in interface ContentStorageManager

Parameters:

co - the ContentObject

plaintext - whether to use plain text

Throws:

IfsException - if the operation fails

getFilteredContent

public abstract Reader getFilteredContent(S_ContentObject co)
                                   throws IfsException

Gets the filtered content for specified ContentObject.

Specified by:

getFilteredContent in interface ContentStorageManager

Parameters:

co - the ContentObject

Returns:

the filtered content

Throws:

IfsException - if the operation fails

invalidateFilteredContent

public abstract void invalidateFilteredContent(S_ContentObject co)
                                        throws IfsException

Invalidates any Filtered Content that was generated for specified ContentObject.

Specified by:

invalidateFilteredContent in interface ContentStorageManager

Parameters:

co - the ContentObject

Throws:

IfsException - if the operation fails

destroyTextRenditions

public abstract void destroyTextRenditions(S_ContentObject co)
                                    throws IfsException

Destroy all text renditions: themes, summaries, and filtered content.

Specified by:

destroyTextRenditions in interface ContentStorageManager

Parameters:

co - the ContentObject

Throws:

IfsException - if the operation fails

deleteOldFilteredContent

public abstract int deleteOldFilteredContent(S_LibrarySession session,
                                             long age)
                                      throws IfsException

Delete old filtered content entries.

Specified by:

deleteOldFilteredContent in interface ContentStorageManager

Parameters:

session - the S_LibrarySession

age - the number of seconds that constitutes an "old" entry

Throws:

IfsException - if the operation fails

resolveCharacterSet

public String resolveCharacterSet(S_LibraryObjectDefinition def)
                           throws IfsException

Gets the CHARACTERSET attribute of the specified ContentObject definition, setting a default CHARACTERSET attribute if one isn't set.

The CHARACTERSET attribute, if set, should be a valid IANA charset (preferred) or the canonical name or alias of a valid Java charset. (In general, Java charset names follow the IANA charset conventions.) Although the CHARACTERSET attribute is not validated, some CMSDK operations (such as getting content as a Reader) will succeed only if the CHARACTERSET is a valid Java charset.

If the specified definition has the CHARACTERSET attribute set (including set to null), then that CHARACTERSET is returned. Otherwise, gets the default character set from the session's Localizer, sets the definition's CHARACTERSET attribute to that value, and also returns that value.

This method is called only if either the definition's FORMAT attribute has a BINARY value of false or content is set by Reader. In all other cases, no default CHARACTERSET is set on a ContentObject.

Specified by:

resolveCharacterSet in interface ContentStorageManager

Parameters:

def - the ContentObject definition

Returns:

the character set

Throws:

IfsException - if the operation fails

(Unpublished)

getOracleCharacterSet

protected String getOracleCharacterSet(String ianaCharset)

Gets the Oracle character set corresponding to specified value of the IANA Character set, stored in the ContentObejct.CHARACTERSET attribute.

The CHARACTERSET attribute of a ContentObject, if set, should be either an IANA charset (preferred) or the canonical name or alias of a Java charset. In contrast, the CHARACTERSET column of the odmz_context_router table must be an Oracle character set.

Parameters:

ianaCharset - the IANA character set

Returns:

the Oracle character set, or null

(Unpublished)