com.lexmark.saperion.client.document

Interface DocumentRevisionClient

All Known Implementing Classes:

DocumentRevisionClientImpl

public interface DocumentRevisionClient

This client provides read and write functionality to a given revision of a given document. Note that write methods will only work if the revision is the latest one. A ConcurrentWriteException will be thrown otherwise.

Author:

jschwarz

Method Summary

Modifier and Type	Method and Description
void	delete() This method deletes the specified document.
DocumentElementClient	getElement(DocumentElementReferenceType reference) This method returns the document element client for the given document element id.
DocumentRevisionType	load() This method loads a document revision with its content.
DocumentRevisionType	loadMetadata() This method loads a document revision without its content.
SearchClient<PropertyType>	searchMultiValueField(String fieldName) This method returns a search client for the content of the given multi value field of the given document revision.
DocumentStoreInformationType	update(DocumentElementType documentElement) This is a shorthand for update(Collections.<String, PropertyType> emptyMap(), documentElement) updating only the document element and leaving the index data untouched.
DocumentStoreInformationType	update(Map<String,PropertyType> indexData) This is a shorthand for update(indexData, null) updating only the index data and leaving the document structure untouched.
DocumentStoreInformationType	update(Map<String,PropertyType> indexData, DocumentElementType documentElement) This method updates the document instance and replaces the document with the given entity.
DocumentStoreInformationType	update(UpdateDocumentInputType properties) This method updates the document with the given properties containing index-data, structure-data and ACLs.

Method Detail

loadMetadata

DocumentRevisionType loadMetadata()
                           throws EcmException

This method loads a document revision without its content.

Returns:

the document revision without its content

Throws:

EcmException - indicates that a system exception occurred

load

DocumentRevisionType load()
                   throws EcmException

This method loads a document revision with its content.

Returns:

the complete document revision

Throws:

EcmException - indicates that a system exception occurred

searchMultiValueField

SearchClient<PropertyType> searchMultiValueField(String fieldName)
                                          throws EcmException

This method returns a search client for the content of the given multi value field of the given document revision.

Parameters:

fieldName - the name of the multi value field

Returns:

a search client for the content of the given multi value field of the given document revision

Throws:

EcmException

getElement

DocumentElementClient getElement(DocumentElementReferenceType reference)
                          throws EcmException

This method returns the document element client for the given document element id.

Parameters:

reference - the document element reference

Returns:

the document element client for the given document element id

Throws:

EcmException

delete

void delete()
     throws EcmException

This method deletes the specified document.

Throws:

EcmException - indicates that a system exception occurred

update

DocumentStoreInformationType update(Map<String,PropertyType> indexData,
                                    DocumentElementType documentElement)
                             throws EcmException

This method updates the document instance and replaces the document with the given entity.

Parameters:

indexData - the index data changes of the document

documentElement - the new document root structure

Throws:

EcmException - indicates that a system exception occurred

update

DocumentStoreInformationType update(DocumentElementType documentElement)
                             throws EcmException

This is a shorthand for update(Collections.<String, PropertyType> emptyMap(), documentElement) updating only the document element and leaving the index data untouched.

Parameters:

documentElement - the new document root structure

Throws:

EcmException

update

DocumentStoreInformationType update(Map<String,PropertyType> indexData)
                             throws EcmException

This is a shorthand for update(indexData, null) updating only the index data and leaving the document structure untouched.

Parameters:

indexData - the index data changes of the document

Throws:

EcmException

update

DocumentStoreInformationType update(UpdateDocumentInputType properties)
                             throws EcmException

This method updates the document with the given properties containing index-data, structure-data and ACLs.

Parameters:

properties - the properties to update

Returns:

information about the new revision

Throws:

EcmException - when updating the document failed