com.tsgrp.opencontent.dctm.content

Class DCTMContentImpl

java.lang.Object

com.tsgrp.opencontent.core.content.AbstractContentImpl

com.tsgrp.opencontent.dctm.content.DCTMContentImpl

All Implemented Interfaces:

IContent

public class DCTMContentImpl
extends AbstractContentImpl

Service that provides content access and manipulation methods.

Field Summary

Fields inherited from class com.tsgrp.opencontent.core.content.AbstractContentImpl

ocPolicyComponent

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DCTMContentImpl()

Method Summary

Modifier and Type	Method and Description
java.lang.String[]	addRelation(AddRelationRequest req) Adds a relation between parent document and children.
void	applyAspect(java.lang.String ticket, java.lang.String objectId, java.lang.String aspectType, java.util.Map<java.lang.String,java.lang.Object> mandatoryProperties) Adds an aspect to a document.
boolean	cancelCheckout(java.lang.String ticket, java.lang.String objectId) Cancels checkout of document.
ContentResult	checkin(java.lang.String ticket, java.lang.String objectId, boolean keepLock, java.lang.String versionLabels, java.lang.String comment, boolean majorVersion) Checks in a document.
ContentResult	checkin(java.lang.String ticket, java.lang.String objectId, boolean keepLock, java.lang.String versionLabels, java.lang.String comment, boolean majorVersion, OpenContentObject object, boolean newVersion, javax.activation.DataHandler dh) Checks in a node to the repository.
ContentResult	checkin(java.lang.String ticket, java.lang.String objectId, boolean keepLock, java.lang.String versionLabels, java.lang.String comment, boolean majorVersion, OpenContentObject object, boolean newVersion, java.lang.Long size, javax.activation.DataHandler dataHandler) Checks in a node to the repository.
boolean	checkout(java.lang.String ticket, java.lang.String objectId) Checks out a document.
ContentResult	copyDocument(java.lang.String ticket, java.lang.String id, java.lang.String copyName) Returns objectId for the given copied document only, no content returned.
java.lang.String	createObject(java.lang.String ticket, CompleteObject object) Imports document content and properties to the repository.
boolean	deleteObjects(java.lang.String ticket, java.lang.String[] objectIds, boolean allVersions) Deletes objects in the content store.
ContentResult	doEnhancedCreateObject(java.lang.String ticket, EnhancedCompleteObject object)
ContentResult	doEnhancedDeleteObject(java.lang.String ticket, java.lang.String id, boolean allVersions, boolean forceDelete)
ContentResult	doEnhancedUpdateObject(java.lang.String ticket, java.lang.String id, EnhancedCompleteObject object, boolean newVersion, boolean majorVersion)
OpenContentObject	doUpdateObject(java.lang.String ticket, OpenContentObject oco)
ContentResult	enhancedGetObject(java.lang.String ticket, java.lang.String id, java.lang.String[] fileExtensionArr) Retrieves document content and properties.
ContentResult	enhancedGetObjectByPath(java.lang.String ticket, java.lang.String path, java.lang.String[] fileExtensionArr)
ContentResult	enhancedGetPathByFolderId(java.lang.String ticket, java.lang.String objectId) Obtain folder path by passing in folder ID
ContentResult	enhancedGetProperties(java.lang.String ticket, java.lang.String id) Returns metadata for the given id only, no content returned.
java.util.List<java.lang.String>	getAppliedAspects(java.lang.String ticket, java.lang.String objectId) Retrieves a list of aspects applied to the provided objectId.
ObjectContent	getContent(GetContentRequest request) Retrieves the content of a repository object.
EnhancedObjectProperty[]	getEnhancedProperties(java.lang.String ticket, java.lang.String objectId) Retrieves document properties.
UserResult	getLockOwner(java.lang.String ticket, java.lang.String objectId) Returns a UserResult.
OpenContentObject	getObjectByPath(java.lang.String ticket, java.lang.String path) Obtain object by passing its path WARNING: This method opens an InputStream.
OpenContentObject	getObjectByPath(java.lang.String ticket, java.lang.String path, boolean quietMode) Obtain object by passing its path This accepts a 'quietMode' parameter that will not throw an error if the object doesn't exist at that path.
ContentResult	getObjectByVersion(java.lang.String ticket, java.lang.String id, java.lang.String versionLabel, java.lang.String[] fileExtensionArr) Obtain object for a specific version
int	getPermissionsRequest(java.lang.String ticket, java.lang.String objectId) Retrieves permissions set on document.
java.util.ArrayList<java.lang.String>	link(java.lang.String ticket, java.lang.String childId, java.lang.String[] unLinkFrom, java.lang.String[] linkTo) Creates a link request between document and folders.
java.lang.String	lockDocument(java.lang.String ticket, java.lang.String objectId) Locks a document.
void	moveObject(java.lang.String ticket, java.lang.String objectId, java.lang.String parentPathOrId) Moves an object in the repository from one folder to another.
ContentResult	removeRelation(java.lang.String ticket, java.lang.String parentObjectId, java.lang.String[] childIds, java.lang.String relationName) Removes the relationship between the parentId and the childIds passed in of the relation type passed in
java.lang.String	unlockDocument(java.lang.String ticket, java.lang.String objectId) Unlocks out a document.
java.lang.String	updateObject(java.lang.String ticket, java.lang.String objectId, CompleteObject object, boolean newVersion, boolean majorVersion) Updates existing document object in the repository.
OpenContentObject[]	updateObjects(java.lang.String ticket, OpenContentObject[] ocos) Updates the objects with the same IDs as provided objects.

Methods inherited from class com.tsgrp.opencontent.core.content.AbstractContentImpl

bulkEnhancedCreateObjects, bulkEnhancedCreateObjects, enhancedCreateObject, enhancedCreateObject, enhancedDeleteObject, enhancedDeleteObject, enhancedUpdateObject, enhancedUpdateObject, generatePresignedUrl, getObject, setOcPolicyComponent, updateObject

Methods inherited from class java.lang.Object

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

Constructor Detail

DCTMContentImpl

protected DCTMContentImpl()

Method Detail

getEnhancedProperties

public EnhancedObjectProperty[] getEnhancedProperties(java.lang.String ticket,
                                                      java.lang.String objectId)

Retrieves document properties.

Parameters:

ticket - an authentication ticket

objectId - the identifier used to locate a document

Returns:

the properties of the object in array form

getContent

public ObjectContent getContent(GetContentRequest request)

Retrieves the content of a repository object.

Parameters:

request -

Returns:

the content of the object

createObject

public java.lang.String createObject(java.lang.String ticket,
                                     CompleteObject object)

Imports document content and properties to the repository.

Parameters:

ticket - an authentication ticket

object -

Returns:

the object ID of the newly created object

updateObject

public java.lang.String updateObject(java.lang.String ticket,
                                     java.lang.String objectId,
                                     CompleteObject object,
                                     boolean newVersion,
                                     boolean majorVersion)

Updates existing document object in the repository.

Parameters:

ticket - an authentication ticket

objectId - the identifier for the document to update

object -

newVersion - whether to version or overwrite the existing object

majorVersion - whether to increment the version to a new major version if versioning

Returns:

the object id of the updated or newly-versioned object

updateObjects

public OpenContentObject[] updateObjects(java.lang.String ticket,
                                         OpenContentObject[] ocos)

Description copied from interface: IContent

Updates the objects with the same IDs as provided objects. Note: This method 'replaces' the object the repo with the object you provide. Any properties on the repo object that are NOT on the supplied object will be removed/nulled out. Will attempt to update objectType, aspects, and properties. Note that this does not version or check in.

ocos - - The objects to update

Returns:

- The updated objects

See Also:

IContent.updateObjects(String, com.tsgrp.opencontent.core.model.json.OpenContentObject[])

deleteObjects

public boolean deleteObjects(java.lang.String ticket,
                             java.lang.String[] objectIds,
                             boolean allVersions)

Deletes objects in the content store.

Parameters:

ticket - an authentication ticket

objectIds - a list of object identifiers to delete

allVersions - if true, deletes all versions

Returns:

if deletion of all objects was successful

getPermissionsRequest

public int getPermissionsRequest(java.lang.String ticket,
                                 java.lang.String objectId)

Retrieves permissions set on document.

Parameters:

ticket - an authentication ticket

objectId - the identifier used to locate a document

Returns:

the permission on the object

cancelCheckout

public boolean cancelCheckout(java.lang.String ticket,
                              java.lang.String objectId)

Cancels checkout of document.

Parameters:

ticket - an authentication ticket

objectId - the identifier used to locate a document

Returns:

whether the operation was successful

checkout

public boolean checkout(java.lang.String ticket,
                        java.lang.String objectId)

Checks out a document.

Parameters:

ticket - an authentication ticket

objectId - the identifier used to locate a document

Returns:

whether the operation was successful

checkin

public ContentResult checkin(java.lang.String ticket,
                             java.lang.String objectId,
                             boolean keepLock,
                             java.lang.String versionLabels,
                             java.lang.String comment,
                             boolean majorVersion)

Checks in a document.

Parameters:

ticket - an authentication ticket

objectId - ID of the object to be checked in

keepLock - whether or not to keep the lock on the object

versionLabels - version label to check the document in to

comment - comment about the checkin

majorVersion - whether the object/document will be checked in as a major version

Returns:

the new object id, or null if unsuccessful

checkin

public ContentResult checkin(java.lang.String ticket,
                             java.lang.String objectId,
                             boolean keepLock,
                             java.lang.String versionLabels,
                             java.lang.String comment,
                             boolean majorVersion,
                             OpenContentObject object,
                             boolean newVersion,
                             java.lang.Long size,
                             javax.activation.DataHandler dataHandler)

Description copied from interface: IContent

Checks in a node to the repository. Overloaded for impls that require size

Parameters:

ticket - a valid OC ticket.

objectId - the objectId of the object to check in.

keepLock - whether to keep the lock or release it after the checkin is complete.

versionLabels - the version lable of the document that will be checked in.

comment - the comment for checking in the document.

majorVersion - true if the document should become a major version on checkin.

object - the object to use for setting new property values on checkin - NOTE: this is currently not implemented.

newVersion - whether this should be a new version or the same version.

size - the object size in bytes

dataHandler - the data handler containing the input stream for the new content of the checked in object.

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• objectId returns ID of the object checked in

addRelation

public java.lang.String[] addRelation(AddRelationRequest req)

Adds a relation between parent document and children.

Parameters:

req -

Returns:

link

public java.util.ArrayList<java.lang.String> link(java.lang.String ticket,
                                                  java.lang.String childId,
                                                  java.lang.String[] unLinkFrom,
                                                  java.lang.String[] linkTo)

Description copied from interface: IContent

Creates a link request between document and folders.

Parameters:

ticket - String representing the session's ticket

childId - ID of the object that is to be linked

unLinkFrom - String[] representing the folders that the object will be unlinked from

linkTo - String[] representing the folders that the object will be linked to

Returns:

A of folder IDs that objectId was linked to

See Also:

IContent.link(java.lang.String, java.lang.String, java.lang.String[], java.lang.String[])

doEnhancedCreateObject

public ContentResult doEnhancedCreateObject(java.lang.String ticket,
                                            EnhancedCompleteObject object)

Specified by:

doEnhancedCreateObject in class AbstractContentImpl

See Also:

IContent.enhancedCreateObject(java.lang.String, EnhancedCompleteObject)

doEnhancedDeleteObject

public ContentResult doEnhancedDeleteObject(java.lang.String ticket,
                                            java.lang.String id,
                                            boolean allVersions,
                                            boolean forceDelete)

Specified by:

doEnhancedDeleteObject in class AbstractContentImpl

Parameters:

forceDelete - - Not Implemented for DCTM, should always be False

See Also:

IContent.enhancedDeleteObject(java.lang.String, java.lang.String, boolean, boolean)

enhancedGetObject

public ContentResult enhancedGetObject(java.lang.String ticket,
                                       java.lang.String id,
                                       java.lang.String[] fileExtensionArr)

Description copied from interface: IContent

Retrieves document content and properties. If you only need properties, use IContent.enhancedGetProperties(String, String) instead. Note that since this method gets both content and properties, calling code must close the ContentResult with OCUtil.closeQuietly(ContentResult).

Parameters:

ticket - String representing the session's ticket

id - ID of the object to get

fileExtensionArr - An array of content types. By default, this array consists of {"pdf", ".*"}, which indicates PDF is preferred, then fall back to the native content.

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• object contains the Object we are trying to get

See Also:

IContent.enhancedGetObject(java.lang.String, java.lang.String, java.lang.String[])

doEnhancedUpdateObject

public ContentResult doEnhancedUpdateObject(java.lang.String ticket,
                                            java.lang.String id,
                                            EnhancedCompleteObject object,
                                            boolean newVersion,
                                            boolean majorVersion)

Specified by:

doEnhancedUpdateObject in class AbstractContentImpl

See Also:

IContent.enhancedUpdateObject(java.lang.String, java.lang.String, com.tsgrp.opencontent.core.content.enhanced.model.EnhancedCompleteObject, boolean, boolean)

enhancedGetObjectByPath

public ContentResult enhancedGetObjectByPath(java.lang.String ticket,
                                             java.lang.String path,
                                             java.lang.String[] fileExtensionArr)

Parameters:

ticket - String representing the session's ticket

path - path to the object to get

fileExtensionArr - An array of content types. By default, this array consists of {"pdf", ".*"}, which indicates PDF is preferred, then fall back to the native content.

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• object contains the Object we are trying to get

enhancedGetPathByFolderId

public ContentResult enhancedGetPathByFolderId(java.lang.String ticket,
                                               java.lang.String objectId)

Description copied from interface: IContent

Obtain folder path by passing in folder ID

Parameters:

ticket - String representing the session's ticket

objectId - id of the folder to get path from

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• ContentResult.result contains the folder path we are trying to get

See Also:

IContent.enhancedGetPathByFolderId(java.lang.String, java.lang.String)

getObjectByVersion

public ContentResult getObjectByVersion(java.lang.String ticket,
                                        java.lang.String id,
                                        java.lang.String versionLabel,
                                        java.lang.String[] fileExtensionArr)

Description copied from interface: IContent

Obtain object for a specific version

Parameters:

ticket - String representing the session's ticket

id - id of the object we are trying to get

versionLabel - version of the object we are trying to get

fileExtensionArr - An array of content types. By default, this array consists of {"pdf", ".*"}, which indicates PDF is preferred, then fall back to the native content.

Returns:

• ContentResult
• error returns true if get object by version failed, otherwise false
• object contains the Object we are trying to get

enhancedGetProperties

public ContentResult enhancedGetProperties(java.lang.String ticket,
                                           java.lang.String id)

Description copied from interface: IContent

Returns metadata for the given id only, no content returned.

Parameters:

ticket - String representing the session's ticket

id - ID of the object to get properties from

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• object
• objectType - repo specific object type
• props - metadata for object

See Also:

IContent.enhancedGetProperties(java.lang.String, java.lang.String)

removeRelation

public ContentResult removeRelation(java.lang.String ticket,
                                    java.lang.String parentObjectId,
                                    java.lang.String[] childIds,
                                    java.lang.String relationName)

Description copied from interface: IContent

Removes the relationship between the parentId and the childIds passed in of the relation type passed in

Parameters:

ticket - An authentication ticket

parentObjectId - ID of the parent object to remove the rendition relation from

childIds - An array of child IDs to remove from relation

relationName - - name of parent-child relation to remove

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• result set to parentId if the remove succeeded, null if it failed

No content is brought back on the EnhancedCompleteObjects representing our versions

copyDocument

public ContentResult copyDocument(java.lang.String ticket,
                                  java.lang.String id,
                                  java.lang.String copyName)

Description copied from interface: IContent

Returns objectId for the given copied document only, no content returned.

Parameters:

ticket - String representing the session's ticket

id - id of the object we want to make a copy of

copyName - name of the newly copied object. If set to null or "", the name of the new object will be "Copy of ${original object's name}".

Returns:

• ContentResult
• error returns true if get object by version failed, otherwise false
• object contains the newly copied object

See Also:

IContent.copyDocument(java.lang.String, java.lang.String, java.lang.String)

lockDocument

public java.lang.String lockDocument(java.lang.String ticket,
                                     java.lang.String objectId)

Description copied from interface: IContent

Locks a document.

Returns:

String

null if the document is already locked.

See Also:

IContent.lockDocument(java.lang.String, java.lang.String)

unlockDocument

public java.lang.String unlockDocument(java.lang.String ticket,
                                       java.lang.String objectId)

Description copied from interface: IContent

Unlocks out a document.

Returns:

String

null if the document is already locked.

See Also:

IContent.unlockDocument(java.lang.String, java.lang.String)

getLockOwner

public UserResult getLockOwner(java.lang.String ticket,
                               java.lang.String objectId)

Description copied from interface: IContent

Returns a UserResult. If the document is locked the UserBean[] will be populated with the UserBean of the locking User, otherwise, the UserBean[] field will be null.

Returns:

UserResult

• UserResult.getError() - True if there is an error
• UserResult.getErrorDetails() - Details about the error
• UserResult.getUserBeans() - If the document is locked, an array of length 1, containing the userbean of the locking user or null of there is no lock.

doUpdateObject

public OpenContentObject doUpdateObject(java.lang.String ticket,
                                        OpenContentObject oco)

Specified by:

doUpdateObject in class AbstractContentImpl

getObjectByPath

public OpenContentObject getObjectByPath(java.lang.String ticket,
                                         java.lang.String path)

Description copied from interface: IContent

Obtain object by passing its path WARNING: This method opens an InputStream. You must close this in the calling method.

Parameters:

ticket - String representing the session's ticket

path - path to the object to get

Returns:

OpenContentObject

getObjectByPath

public OpenContentObject getObjectByPath(java.lang.String ticket,
                                         java.lang.String path,
                                         boolean quietMode)

Description copied from interface: IContent

Obtain object by passing its path This accepts a 'quietMode' parameter that will not throw an error if the object doesn't exist at that path. In certain scenarios, a majority of the time the object won't be there, so we don't want to pollute the logs with stacktraces and/or errors.

Parameters:

ticket - sessions ticket

path - path to the object to het

quietMode - If true, we will not throw an error if the object doesn't exist

Returns:

getAppliedAspects

public java.util.List<java.lang.String> getAppliedAspects(java.lang.String ticket,
                                                          java.lang.String objectId)

Description copied from interface: IContent

Retrieves a list of aspects applied to the provided objectId. Note: For obvious reasons, this method will only produce results on an Alfresco backend. For other filesystems, will return an empty list of strings.

Returns:

A list of aspects applied to the given objectId in bean format eg, tsg_rendition

See Also:

IContent.getAppliedAspects(java.lang.String, java.lang.String)

applyAspect

public void applyAspect(java.lang.String ticket,
                        java.lang.String objectId,
                        java.lang.String aspectType,
                        java.util.Map<java.lang.String,java.lang.Object> mandatoryProperties)

Description copied from interface: IContent

Adds an aspect to a document. Note: This will throw an error if called from a non Alfresco backend.

Parameters:

ticket - a valid OC ticket

objectId - the object the aspect will be applied to

aspectType - the type of aspect to be added (in OCName format)

mandatoryProperties - a list of properties that are mandatory for the aspect (in OCName format). Set to null/empty map for no properties

See Also:

IContent.applyAspect(java.lang.String, java.lang.String, java.lang.String, java.util.Map)

checkin

public ContentResult checkin(java.lang.String ticket,
                             java.lang.String objectId,
                             boolean keepLock,
                             java.lang.String versionLabels,
                             java.lang.String comment,
                             boolean majorVersion,
                             OpenContentObject object,
                             boolean newVersion,
                             javax.activation.DataHandler dh)

Description copied from interface: IContent

Checks in a node to the repository. This may fail on implementations that require size (e.g. Dynamo). Use the overloaded checkin for implementations that require size.

Parameters:

ticket - a valid OC ticket.

objectId - the objectId of the object to check in.

keepLock - whether to keep the lock or release it after the checkin is complete.

versionLabels - the version lable of the document that will be checked in.

comment - the comment for checking in the document.

majorVersion - true if the document should become a major version on checkin.

object - the object to use for setting new property values on checkin - NOTE: this is currently not implemented.

newVersion - whether this should be a new version or the same version.

dh - the data handler containing the input stream for the new content of the checked in object.

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• objectId returns ID of the object checked in

moveObject

public void moveObject(java.lang.String ticket,
                       java.lang.String objectId,
                       java.lang.String parentPathOrId)

Description copied from interface: IContent

Moves an object in the repository from one folder to another.

Parameters:

ticket - a valid OC ticket.

objectId - the ID of the object to move to a new folder.

parentPathOrId - the path or ID of the folder to move the new object to.