Class SQLDocumentProxy
- All Implemented Interfaces:
Document
,SQLDocument
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.nuxeo.ecm.core.model.Document
Document.BlobAccessor, Document.WriteContext
-
Field Summary
Fields inherited from interface org.nuxeo.ecm.core.storage.sql.coremodel.SQLDocument
BINARY_TEXT_SYS_PROP, FULLTEXT_JOBID_SYS_PROP, IS_TRASHED_SYS_PROP, SIMPLE_TEXT_SYS_PROP
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionCreates a new child document of the given type.boolean
Adds a facet to this document.Creates a new version.void
checkOut()
boolean
void
followTransition
(String transition) Follows a given life cycle transition.Gets the facets available on this document (from the type and the instance facets).Returns the allowed state transitions for this document.Gets the version to which a checked in document is linked.Gets the current change token for this document.Gets the version check in comment of this document if it's a version or a proxy.Gets a child document given its name.Gets the children of the document.Gets a list of the children ids.String[]
Gets the facets defined on this document instance.Gets the last version of this document.Gets the life cycle policy of this document.Gets the life cycle state of this document.getLock()
Gets the lock if one set on this document.getName()
Gets the name of this document.getNode()
Returns the node with info about the hierarchy location.Gets the parent document, ornull
if this is the root document.getPath()
Gets the path of this document.getPos()
Gets the document's position in its containing folder (if ordered).getPropertyValue
(String name) Gets a simple property value.protected static String
getProxyChangeToken
(String proxyToken, String targetToken) Gets the repository in which the document lives.String[]
Gets the retained property xpaths of this document instance at the time it became a record.Gets the retention date for the document.protected String
Gets the session that owns this document.Gets the source for this document.<T extends Serializable>
TgetSystemProp
(String name, Class<T> type) Gets a system property.Gets the document (version or live document) to which this proxy points.getType()
Gets the type of this document.getUUID()
Gets this document's UUID.Gets a property value.getVersion
(String label) Gets a version of this document, given its label.Gets the version creation date of this document if it's a version or a proxy.Gets the version label.Gets the versions for this document.Gets the version series id.Gets the list of version ids for this document.Gets the working copy for this document.Gets a write context for the current document.boolean
Checks whether this document has a child of the given name.boolean
Tests if the document has any children.boolean
Checks whether this document has a given facet, either from its type or added on the instance.int
hashCode()
boolean
Checks if the document has a legal hold set.boolean
Checks whether this document is checked out.boolean
boolean
isFolder()
Checks whether this document is a folder.boolean
Checks whether this document is the latest major version.boolean
Checks whether this document is the latest version.boolean
Checks whether this document is a major version.protected boolean
isPropertyForProxy
(String xpath) Checks if the given property should be resolved on the proxy or the target.boolean
isProxy()
Checks whether or not this document is a proxy.boolean
Checks whether this document is readonly or not.boolean
isRecord()
Checks if the document is a record.boolean
isRetainable
(String xpath) Can the property be put under retention or legal hold.boolean
isRetained
(String xpath) Is the property under retention or legal hold.boolean
Checks whether this document is under active retention.protected boolean
isSchemaForProxy
(String schema) Checks if the given schema should be resolved on the proxy or the target.boolean
Checks if the document has a retention date in the future or has a legal hold.boolean
Checks whether this document is a version document.boolean
Checks if there is a checked out working copy for the version series of this document.void
Turns the document into a flexible record.void
Turns the document into an enforced record.void
Marks the document as being modified by a user change.void
orderBefore
(String src, String dest) Orders the given source child before the destination child.void
Loads aDocumentPart
from storage.void
remove()
Removes this document and all its children, if any.void
remove
(NuxeoPrincipal principal) Removes this document and all its children, if any.boolean
removeFacet
(String facet) Removes a facet from this document.removeLock
(String owner) Removes a lock from this document.void
Removes this document only, without its children.replaceBlobDigest
(String key, String newKey, String newDigest) Visits the blobs of this document and, for those with a matching key, replace their key and digest with new ones.void
Replaces this document's content with the version specified.void
setCurrentLifeCycleState
(String state) Sets the life cycle state of this document.void
setLegalHold
(boolean hold) Sets or removes a legal hold on the document (a record).void
setLifeCyclePolicy
(String policy) Sets the life cycle policy of this document.Sets a lock on this document.void
setPropertyValue
(String name, Serializable value) Sets a simple property value.void
setReadOnly
(boolean readonly) Sets this document as readonly or not.void
setRetainUntil
(Calendar retainUntil) Sets a retention date for the document (a record).void
setRetentionActive
(boolean retentionActive) Sets or unsets this document as under active retention.void
setSystemProp
(String name, Serializable value) Sets a system property.void
setTargetDocument
(Document target) Sets the document (version or live document) to which this proxy points.void
Sets a property value.toString()
boolean
validateUserVisibleChangeToken
(String userVisibleChangeToken) Validates that the passed user-visible change token is compatible with the one for this document.void
visitBlobs
(Consumer<Document.BlobAccessor> blobVisitor) Visits all the blobs of this document and calls the passed blob visitor on each one.boolean
writeDocumentPart
(DocumentPart dp, Document.WriteContext writeContext, boolean create) Writes aDocumentPart
to storage.Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.nuxeo.ecm.core.model.Document
getBlobKeys, isEnforcedRecord, writeDocumentPart
-
Field Details
-
CHANGE_TOKEN_PROXY_SEP
- See Also:
-
-
Constructor Details
-
SQLDocumentProxy
-
-
Method Details
-
getSchema
-
isSchemaForProxy
Checks if the given schema should be resolved on the proxy or the target. -
isPropertyForProxy
Checks if the given property should be resolved on the proxy or the target. -
getNode
Description copied from interface:SQLDocument
Returns the node with info about the hierarchy location.- Specified by:
getNode
in interfaceSQLDocument
-
isProxy
public boolean isProxy()Description copied from interface:Document
Checks whether or not this document is a proxy. -
getUUID
Description copied from interface:Document
Gets this document's UUID. -
getName
Description copied from interface:Document
Gets the name of this document. -
getPos
Description copied from interface:Document
Gets the document's position in its containing folder (if ordered). -
getParent
Description copied from interface:Document
Gets the parent document, ornull
if this is the root document. -
getPath
Description copied from interface:Document
Gets the path of this document. -
remove
public void remove()Description copied from interface:Document
Removes this document and all its children, if any. -
remove
Description copied from interface:Document
Removes this document and all its children, if any. -
removeSingleton
public void removeSingleton()Description copied from interface:Document
Removes this document only, without its children.- Specified by:
removeSingleton
in interfaceDocument
-
getType
Description copied from interface:Document
Gets the type of this document. -
getRepositoryName
Description copied from interface:Document
Gets the repository in which the document lives.- Specified by:
getRepositoryName
in interfaceDocument
- Returns:
- the repository name.
-
getSession
Description copied from interface:Document
Gets the session that owns this document.- Specified by:
getSession
in interfaceDocument
- Returns:
- the session
-
isFolder
public boolean isFolder()Description copied from interface:Document
Checks whether this document is a folder. -
setReadOnly
public void setReadOnly(boolean readonly) Description copied from interface:Document
Sets this document as readonly or not.- Specified by:
setReadOnly
in interfaceDocument
-
isReadOnly
public boolean isReadOnly()Description copied from interface:Document
Checks whether this document is readonly or not.- Specified by:
isReadOnly
in interfaceDocument
-
readDocumentPart
Description copied from interface:Document
Loads aDocumentPart
from storage.Reading data is done by
DocumentPart
because of per-proxy schemas.- Specified by:
readDocumentPart
in interfaceDocument
- Throws:
PropertyException
-
getWriteContext
Description copied from interface:Document
Gets a write context for the current document.- Specified by:
getWriteContext
in interfaceDocument
-
writeDocumentPart
public boolean writeDocumentPart(DocumentPart dp, Document.WriteContext writeContext, boolean create) throws PropertyException Description copied from interface:Document
Writes aDocumentPart
to storage.Writing data is done by
DocumentPart
because of per-proxy schemas.- Specified by:
writeDocumentPart
in interfaceDocument
- Parameters:
dp
- the document partwriteContext
- the write contextcreate
- whether this is for a document creation- Returns:
true
if something changed- Throws:
PropertyException
-
setSystemProp
Description copied from interface:Document
Sets a system property.- Specified by:
setSystemProp
in interfaceDocument
-
getSystemProp
Description copied from interface:Document
Gets a system property.- Specified by:
getSystemProp
in interfaceDocument
-
getChangeToken
Description copied from interface:Document
Gets the current change token for this document.- Specified by:
getChangeToken
in interfaceDocument
- Returns:
- the change token
-
getProxyChangeToken
-
validateUserVisibleChangeToken
Description copied from interface:Document
Validates that the passed user-visible change token is compatible with the one for this document.- Specified by:
validateUserVisibleChangeToken
in interfaceDocument
- Returns:
false
if the change token is not valid
-
markUserChange
public void markUserChange()Description copied from interface:Document
Marks the document as being modified by a user change.This causes an additional change token increment and check during save.
- Specified by:
markUserChange
in interfaceDocument
-
getAllFacets
Description copied from interface:Document
Gets the facets available on this document (from the type and the instance facets).- Specified by:
getAllFacets
in interfaceDocument
- Returns:
- the facets
-
getFacets
Description copied from interface:Document
Gets the facets defined on this document instance. The type facets are not returned. -
hasFacet
Description copied from interface:Document
Checks whether this document has a given facet, either from its type or added on the instance. -
addFacet
Description copied from interface:Document
Adds a facet to this document.Does nothing if the facet was already present on the document.
-
removeFacet
Description copied from interface:Document
Removes a facet from this document.It's not possible to remove a facet coming from the document type.
- Specified by:
removeFacet
in interfaceDocument
- Parameters:
facet
- the facet name- Returns:
true
if the facet was removed, orfalse
if it isn't present or is present on the type or does not exit
-
makeRecord
public void makeRecord()Description copied from interface:Document
Turns the document into an enforced record.A record is a document with specific capabilities related to mandatory retention until a given date, and legal holds. In addition, its main blob receives special treatment from the document blob manager to make sure it's never shared with another blob at the storage level, and is deleted as soon as the record is deleted.
If the document is already a record, this method has no effect.
The permission "MakeRecord" is required.
- Specified by:
makeRecord
in interfaceDocument
- See Also:
-
makeFlexibleRecord
public void makeFlexibleRecord()Description copied from interface:Document
Turns the document into a flexible record.A record is a document with specific capabilities related to mandatory retention until a given date, and legal holds.
If the document is already a flexible record, this method has no effect. An enforced record cannot be turned into a flexible record.
The permission "MakeRecord" is required.
- Specified by:
makeFlexibleRecord
in interfaceDocument
- See Also:
-
isRecord
public boolean isRecord()Description copied from interface:Document
Checks if the document is a record. -
isFlexibleRecord
public boolean isFlexibleRecord()- Specified by:
isFlexibleRecord
in interfaceDocument
- Returns:
true
if the document is a flexible record,false
otherwise
-
setRetainUntil
Description copied from interface:Document
Sets a retention date for the document (a record).If no previous retention date was set, or if the previous retention date was indeterminate, or if the previous retention date was before the given value, then the retention date is set to the given value.
If the previous retention date was after the given value (that is, if trying to reduce the retention time), an exception is thrown.
If the given value is
null
and the previous retention date is in the past (it has already expired), then the retention date is set tonull
.The permission "SetRetention" is required.
- Specified by:
setRetainUntil
in interfaceDocument
- Parameters:
retainUntil
- the new retention date- See Also:
-
getRetainUntil
Description copied from interface:Document
Gets the retention date for the document.- Specified by:
getRetainUntil
in interfaceDocument
- Returns:
- the retention date, or "SetRetention" for a
retention in the indeterminate future, or
null
if there is no retention date - See Also:
-
setLegalHold
public void setLegalHold(boolean hold) Description copied from interface:Document
Sets or removes a legal hold on the document (a record).The permission "ManageLegalHold" is required.
- Specified by:
setLegalHold
in interfaceDocument
- Parameters:
hold
-true
to set a legal hold,false
to remove it- See Also:
-
hasLegalHold
public boolean hasLegalHold()Description copied from interface:Document
Checks if the document has a legal hold set.- Specified by:
hasLegalHold
in interfaceDocument
- Returns:
true
if a legal hold has been set on the document,false
otherwise- See Also:
-
isUnderRetentionOrLegalHold
public boolean isUnderRetentionOrLegalHold()Description copied from interface:Document
Checks if the document has a retention date in the future or has a legal hold.- Specified by:
isUnderRetentionOrLegalHold
in interfaceDocument
- Returns:
true
if the document has a retention date in the future or if it has a legal hold,false
otherwise- See Also:
-
setRetentionActive
public void setRetentionActive(boolean retentionActive) Description copied from interface:Document
Sets or unsets this document as under active retention.- Specified by:
setRetentionActive
in interfaceDocument
-
isRetentionActive
public boolean isRetentionActive()Description copied from interface:Document
Checks whether this document is under active retention.- Specified by:
isRetentionActive
in interfaceDocument
-
getLifeCyclePolicy
Description copied from interface:Document
Gets the life cycle policy of this document.- Specified by:
getLifeCyclePolicy
in interfaceDocument
- Returns:
- the life cycle policy
-
setLifeCyclePolicy
Description copied from interface:Document
Sets the life cycle policy of this document.- Specified by:
setLifeCyclePolicy
in interfaceDocument
- Parameters:
policy
- the life cycle policy
-
getLifeCycleState
Description copied from interface:Document
Gets the life cycle state of this document.- Specified by:
getLifeCycleState
in interfaceDocument
- Returns:
- the life cycle state
-
setCurrentLifeCycleState
Description copied from interface:Document
Sets the life cycle state of this document.- Specified by:
setCurrentLifeCycleState
in interfaceDocument
- Parameters:
state
- the life cycle state
-
followTransition
Description copied from interface:Document
Follows a given life cycle transition.This will update the life cycle state of the document.
- Specified by:
followTransition
in interfaceDocument
- Parameters:
transition
- the name of the transition to follow- Throws:
LifeCycleException
-
getAllowedStateTransitions
Description copied from interface:Document
Returns the allowed state transitions for this document.- Specified by:
getAllowedStateTransitions
in interfaceDocument
- Returns:
- a collection of state transitions
-
getLock
Description copied from interface:Document
Gets the lock if one set on this document. -
setLock
Description copied from interface:Document
Sets a lock on this document. -
removeLock
Description copied from interface:Document
Removes a lock from this document.- Specified by:
removeLock
in interfaceDocument
- Parameters:
owner
- the owner to check, ornull
for no check- Returns:
null
if there was no lock or if removal succeeded, or a lock if it blocks removal due to owner mismatch
-
isVersion
public boolean isVersion()Description copied from interface:Document
Checks whether this document is a version document. -
getBaseVersion
Description copied from interface:Document
Gets the version to which a checked in document is linked.Returns
null
for a checked out document or a version or a proxy.- Specified by:
getBaseVersion
in interfaceDocument
- Returns:
- the version, or
null
-
getVersionSeriesId
Description copied from interface:Document
Gets the version series id.- Specified by:
getVersionSeriesId
in interfaceDocument
- Returns:
- the version series id
-
getSourceDocument
Description copied from interface:Document
Gets the source for this document.For a version, it's the working copy.
For a proxy, it's the version the proxy points to.
- Specified by:
getSourceDocument
in interfaceDocument
- Returns:
- the source document
-
checkIn
Description copied from interface:Document
Creates a new version. -
checkOut
public void checkOut() -
isCheckedOut
public boolean isCheckedOut()Description copied from interface:Document
Checks whether this document is checked out.- Specified by:
isCheckedOut
in interfaceDocument
- Returns:
true
if the document is checked out, orfalse
otherwise
-
isLatestVersion
public boolean isLatestVersion()Description copied from interface:Document
Checks whether this document is the latest version.- Specified by:
isLatestVersion
in interfaceDocument
- Returns:
true
if this is the latest version, orfalse
otherwise
-
isMajorVersion
public boolean isMajorVersion()Description copied from interface:Document
Checks whether this document is a major version.- Specified by:
isMajorVersion
in interfaceDocument
- Returns:
true
if this is a major version, orfalse
otherwise
-
isLatestMajorVersion
public boolean isLatestMajorVersion()Description copied from interface:Document
Checks whether this document is the latest major version.- Specified by:
isLatestMajorVersion
in interfaceDocument
- Returns:
true
if this is the latest major version, orfalse
otherwise
-
isVersionSeriesCheckedOut
public boolean isVersionSeriesCheckedOut()Description copied from interface:Document
Checks if there is a checked out working copy for the version series of this document.- Specified by:
isVersionSeriesCheckedOut
in interfaceDocument
- Returns:
true
if there is a checked out working copy
-
getVersionLabel
Description copied from interface:Document
Gets the version label.- Specified by:
getVersionLabel
in interfaceDocument
- Returns:
- the version label
-
getCheckinComment
Description copied from interface:Document
Gets the version check in comment of this document if it's a version or a proxy.- Specified by:
getCheckinComment
in interfaceDocument
- Returns:
- the check in comment, or
null
if it's not a version or a proxy
-
getWorkingCopy
Description copied from interface:Document
Gets the working copy for this document.- Specified by:
getWorkingCopy
in interfaceDocument
- Returns:
- the working copy
-
getVersionCreationDate
Description copied from interface:Document
Gets the version creation date of this document if it's a version or a proxy.- Specified by:
getVersionCreationDate
in interfaceDocument
- Returns:
- the version creation date, or
null
if it's not a version or a proxy
-
restore
Description copied from interface:Document
Replaces this document's content with the version specified. -
getVersionsIds
Description copied from interface:Document
Gets the list of version ids for this document.- Specified by:
getVersionsIds
in interfaceDocument
- Returns:
- the list of version ids
-
getVersion
Description copied from interface:Document
Gets a version of this document, given its label.- Specified by:
getVersion
in interfaceDocument
- Parameters:
label
- the version label- Returns:
- the version
-
getVersions
Description copied from interface:Document
Gets the versions for this document.- Specified by:
getVersions
in interfaceDocument
- Returns:
- the versions of the document, or an empty list if there are no versions
-
getLastVersion
Description copied from interface:Document
Gets the last version of this document.Returns
null
if there is no version at all.- Specified by:
getLastVersion
in interfaceDocument
- Returns:
- the last version, or
null
if there is no version
-
getChild
Description copied from interface:Document
Gets a child document given its name.Throws
DocumentNotFoundException
if the document could not be found. -
getChildren
Description copied from interface:Document
Gets the children of the document.- Specified by:
getChildren
in interfaceDocument
- Returns:
- the children
-
getChildrenIds
Description copied from interface:Document
Gets a list of the children ids.- Specified by:
getChildrenIds
in interfaceDocument
- Returns:
- a list of children ids.
-
hasChild
Description copied from interface:Document
Checks whether this document has a child of the given name. -
hasChildren
public boolean hasChildren()Description copied from interface:Document
Tests if the document has any children.- Specified by:
hasChildren
in interfaceDocument
- Returns:
true
if the document has children,false
otherwise
-
addChild
Description copied from interface:Document
Creates a new child document of the given type. -
orderBefore
Description copied from interface:Document
Orders the given source child before the destination child.Both source and destination must be names that point to child documents of this document. The source document will be placed before the destination one. If destination is
null
, the source document will be appended at the end of the children list.- Specified by:
orderBefore
in interfaceDocument
- Parameters:
src
- the document to movedest
- the document before which to place the source document
-
getTargetDocument
Description copied from interface:Document
Gets the document (version or live document) to which this proxy points.- Specified by:
getTargetDocument
in interfaceDocument
-
setTargetDocument
Description copied from interface:Document
Sets the document (version or live document) to which this proxy points.- Specified by:
setTargetDocument
in interfaceDocument
-
getPropertyValue
Description copied from interface:Document
Gets a simple property value.For more generic properties described by an xpath, use
Document.getValue(java.lang.String)
instead.- Specified by:
getPropertyValue
in interfaceDocument
- Parameters:
name
- the name of the property to get- Returns:
- the property value or
null
if the property is not set - See Also:
-
setPropertyValue
Description copied from interface:Document
Sets a simple property value.For more generic properties described by an xpath, use
Document.setValue(java.lang.String, java.lang.Object)
instead.- Specified by:
setPropertyValue
in interfaceDocument
- Parameters:
name
- the name of the property to setvalue
- the value to set- See Also:
-
getValue
Description copied from interface:Document
Gets a property value.The xpath may point to a partial path, in which case the value may be a complex
List
orMap
.- Specified by:
getValue
in interfaceDocument
- Parameters:
xpath
- the xpath of the property to set- Returns:
- the property value or
null
if the property is not set - Throws:
PropertyException
- if the property does not exist
-
setValue
Description copied from interface:Document
Sets a property value.The xpath may point to a partial path, in which case the value may be a complex
List
orMap
.- Specified by:
setValue
in interfaceDocument
- Parameters:
xpath
- the xpath of the property to setvalue
- the value to set- Throws:
PropertyException
- if the property does not exist or the value is of the wrong type
-
visitBlobs
Description copied from interface:Document
Visits all the blobs of this document and calls the passed blob visitor on each one.- Specified by:
visitBlobs
in interfaceDocument
- Throws:
PropertyException
-
replaceBlobDigest
Description copied from interface:Document
Visits the blobs of this document and, for those with a matching key, replace their key and digest with new ones.- Specified by:
replaceBlobDigest
in interfaceDocument
- Parameters:
key
- the bob key to look fornewKey
- the new keynewDigest
- the new digest- Returns:
- the old digest if at least one replacement was done,
null
otherwise
-
toString
-
equals
-
hashCode
public int hashCode() -
getRetainedProperties
Description copied from interface:Document
Gets the retained property xpaths of this document instance at the time it became a record.- Specified by:
getRetainedProperties
in interfaceDocument
- Returns:
- the retained properties
-
isRetainable
Description copied from interface:Document
Can the property be put under retention or legal hold.- Specified by:
isRetainable
in interfaceDocument
- Parameters:
xpath
- the xpath- Returns:
- true if the property is retainable
-
isRetained
Description copied from interface:Document
Is the property under retention or legal hold.- Specified by:
isRetained
in interfaceDocument
- Parameters:
xpath
- the xpath- Returns:
- true if the property is retained and cannot be deleted/edited
-