Package org.nuxeo.ecm.core.versioning

Class StandardVersioningService

java.lang.Object

org.nuxeo.ecm.core.versioning.StandardVersioningService

All Implemented Interfaces:

VersioningService, ExtendableVersioningService

public class StandardVersioningService
extends Object
implements ExtendableVersioningService

Implementation of the versioning service that follows standard checkout / checkin semantics.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	APPROVED_STATE
static final String	BACK_TO_PROJECT_TRANSITION
static final String	CATEGORY
static final String	COMMENT
protected static final String	MAJOR_VERSION	Key for major version in Document API.
protected static final String	MINOR_VERSION	Key for minor version in Document API.
static final String	OBSOLETE_STATE

Fields inherited from interface org.nuxeo.ecm.core.api.versioning.VersioningService

CHECKIN_COMMENT, DISABLE_AUTO_CHECKOUT, DISABLE_AUTOMATIC_VERSIONING, MAJOR_VERSION_PROP, MINOR_VERSION_PROP, SKIP_VERSIONING, VERSIONING_OPTION

Constructor Summary

Constructors

Constructor	Description
StandardVersioningService()

Method Summary

Modifier and Type	Method	Description
protected List<VersioningOption>	computeRestrictionOptions(String lifeCycleState, String type)
void	doAutomaticVersioning(DocumentModel previousDocument, DocumentModel currentDocument, boolean before)	Does automatic versioning if a policy exists for the current input context.
Document	doCheckIn(Document doc, VersioningOption option, String checkinComment)	Applies version increment option and does a checkin.
void	doCheckOut(Document doc)	Apply modifications after doing a checkout.
void	doPostCreate(Document doc, Map<String,Serializable> options)	Applies versioning after document creation.
Document	doPostSave(CoreSession session, Document doc, VersioningOption option, String checkinComment, Map<String,Serializable> options)	Applies versioning options after document save.
VersioningOption	doPreSave(CoreSession session, Document doc, boolean isDirty, VersioningOption option, String checkinComment, Map<String,Serializable> options)	Applies versioning options before document save.
protected void	followTransitionByOption(CoreSession session, Document doc, Map<String,Serializable> options)
protected long	getMajor(DocumentModel docModel)
protected long	getMajor(Document doc)
protected long	getMinor(DocumentModel docModel)
protected long	getMinor(Document doc)
protected List<VersioningOption>	getSaveOptions(boolean versionable, String lifeCycleState, String type)
List<VersioningOption>	getSaveOptions(DocumentModel docModel)	Checks what options are available on a document at save time.
protected List<VersioningOption>	getSaveOptions(Document doc)
protected long	getVersion(DocumentModel docModel, String prop)
protected long	getVersion(Document doc, String prop)
String	getVersionLabel(DocumentModel docModel)	Gets the version label to display for a given document.
protected void	incrementByOption(Document doc, VersioningOption option)
protected void	incrementMajor(Document doc)
protected void	incrementMinor(Document doc)
protected boolean	isPolicyMatch(VersioningPolicyDescriptor policyDescriptor, DocumentModel previousDocument, DocumentModel currentDocument)
boolean	isPostSaveDoingCheckIn(Document doc, VersioningOption option, Map<String,Serializable> options)	Checks if VersioningService.doPostSave(org.nuxeo.ecm.core.api.CoreSession, org.nuxeo.ecm.core.model.Document, org.nuxeo.ecm.core.api.VersioningOption, java.lang.String, java.util.Map<java.lang.String, java.io.Serializable>) will do a checkin when called with the same arguments.
boolean	isPreSaveDoingCheckOut(Document doc, boolean isDirty, VersioningOption option, Map<String,Serializable> options)	Checks if VersioningService.doPreSave(org.nuxeo.ecm.core.api.CoreSession, org.nuxeo.ecm.core.model.Document, boolean, org.nuxeo.ecm.core.api.VersioningOption, java.lang.String, java.util.Map<java.lang.String, java.io.Serializable>) will do a checkout when called with the same arguments.
protected VersioningPolicyDescriptor	retrieveMatchingVersioningPolicy(DocumentModel previousDocument, DocumentModel currentDocument, boolean before)
protected void	sendEvent(CoreSession session, Document doc, String previousLifecycleState, Map<String,Serializable> options)
protected void	setInitialVersion(Document doc)	Sets the initial version on a document.
protected void	setVersion(Document doc, long major, long minor)
void	setVersioningFilters(Map<String,VersioningFilterDescriptor> versioningFilters)	Add versioning filters
void	setVersioningPolicies(Map<String,VersioningPolicyDescriptor> versioningPolicies)	Add versioning policies
void	setVersioningRestrictions(Map<String,VersioningRestrictionDescriptor> versioningRestrictions)	Add versioning filters
protected VersioningOption	validateOption(Document doc, VersioningOption option)

Methods inherited from class java.lang.Object

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

Field Details

APPROVED_STATE

public static final String APPROVED_STATE

See Also:

• Constant Field Values

OBSOLETE_STATE

public static final String OBSOLETE_STATE

See Also:

• Constant Field Values

BACK_TO_PROJECT_TRANSITION

public static final String BACK_TO_PROJECT_TRANSITION

See Also:

• Constant Field Values

MAJOR_VERSION

protected static final String MAJOR_VERSION

Key for major version in Document API.

See Also:

• Constant Field Values

MINOR_VERSION

protected static final String MINOR_VERSION

Key for minor version in Document API.

See Also:

• Constant Field Values

CATEGORY

public static final String CATEGORY

Since:

9.3

See Also:

• Constant Field Values

COMMENT

public static final String COMMENT

Since:

9.3

See Also:

• Constant Field Values

Constructor Details

StandardVersioningService

public StandardVersioningService()

Method Details

getVersionLabel

public String getVersionLabel(DocumentModel docModel)

Description copied from interface: VersioningService

Gets the version label to display for a given document.

Specified by:

getVersionLabel in interface VersioningService

Parameters:

docModel - the document

Returns:

the version label, like "2.1"

getMajor

protected long getMajor(DocumentModel docModel)

getMinor

protected long getMinor(DocumentModel docModel)

getVersion

protected long getVersion(DocumentModel docModel,
 String prop)

getMajor

protected long getMajor(Document doc)

getMinor

protected long getMinor(Document doc)

getVersion

protected long getVersion(Document doc,
 String prop)

setVersion

protected void setVersion(Document doc,
 long major,
 long minor)

incrementMajor

protected void incrementMajor(Document doc)

incrementMinor

protected void incrementMinor(Document doc)

incrementByOption

protected void incrementByOption(Document doc,
 VersioningOption option)

doPostCreate

public void doPostCreate(Document doc,
 Map<String,Serializable> options)

Description copied from interface: VersioningService

Applies versioning after document creation.

Specified by:

doPostCreate in interface VersioningService

Parameters:

doc - the document

options - map event info

setInitialVersion

protected void setInitialVersion(Document doc)

Sets the initial version on a document. Can be overridden.

getSaveOptions

public List<VersioningOption> getSaveOptions(DocumentModel docModel)

Description copied from interface: VersioningService

Checks what options are available on a document at save time.

Specified by:

getSaveOptions in interface VersioningService

Parameters:

docModel - the document

Returns:

the options, the first being the default

getSaveOptions

protected List<VersioningOption> getSaveOptions(Document doc)

getSaveOptions

protected List<VersioningOption> getSaveOptions(boolean versionable,
 String lifeCycleState,
 String type)

computeRestrictionOptions

protected List<VersioningOption> computeRestrictionOptions(String lifeCycleState,
 String type)

validateOption

protected VersioningOption validateOption(Document doc,
 VersioningOption option)

isPreSaveDoingCheckOut

public boolean isPreSaveDoingCheckOut(Document doc,
 boolean isDirty,
 VersioningOption option,
 Map<String,Serializable> options)

Description copied from interface: VersioningService

Checks if VersioningService.doPreSave(org.nuxeo.ecm.core.api.CoreSession, org.nuxeo.ecm.core.model.Document, boolean, org.nuxeo.ecm.core.api.VersioningOption, java.lang.String, java.util.Map<java.lang.String, java.io.Serializable>) will do a checkout when called with the same arguments.

Needed to be able to send "about to checkin" events.

Specified by:

isPreSaveDoingCheckOut in interface VersioningService

Parameters:

doc - the document

isDirty - true if there is actual data to save

option - an option chosen by the user or framework

options - map event info and options

Returns:

true if VersioningService.doPreSave(org.nuxeo.ecm.core.api.CoreSession, org.nuxeo.ecm.core.model.Document, boolean, org.nuxeo.ecm.core.api.VersioningOption, java.lang.String, java.util.Map<java.lang.String, java.io.Serializable>) will do a checkout

doPreSave

public VersioningOption doPreSave(CoreSession session,
 Document doc,
 boolean isDirty,
 VersioningOption option,
 String checkinComment,
 Map<String,Serializable> options)

Description copied from interface: VersioningService

Applies versioning options before document save.

Specified by:

doPreSave in interface VersioningService

Parameters:

session - the core session

doc - the document

isDirty - true if there is actual data to save

option - an option chosen by the user or framework

checkinComment - a checkin comment

options - map event info

Returns:

the validated option (to use in doPostSave)

followTransitionByOption

protected void followTransitionByOption(CoreSession session,
 Document doc,
 Map<String,Serializable> options)

isPostSaveDoingCheckIn

public boolean isPostSaveDoingCheckIn(Document doc,
 VersioningOption option,
 Map<String,Serializable> options)

Description copied from interface: VersioningService

Checks if VersioningService.doPostSave(org.nuxeo.ecm.core.api.CoreSession, org.nuxeo.ecm.core.model.Document, org.nuxeo.ecm.core.api.VersioningOption, java.lang.String, java.util.Map<java.lang.String, java.io.Serializable>) will do a checkin when called with the same arguments.

Specified by:

isPostSaveDoingCheckIn in interface VersioningService

Parameters:

doc - the document

option - an option chosen by the user or framework

options - map event info

Returns:

true if VersioningService.doPostSave(org.nuxeo.ecm.core.api.CoreSession, org.nuxeo.ecm.core.model.Document, org.nuxeo.ecm.core.api.VersioningOption, java.lang.String, java.util.Map<java.lang.String, java.io.Serializable>) will do a checkin

doPostSave

public Document doPostSave(CoreSession session,
 Document doc,
 VersioningOption option,
 String checkinComment,
 Map<String,Serializable> options)

Description copied from interface: VersioningService

Applies versioning options after document save. If a new version is checked in during the operation, the document for this version is returned to the caller.

Specified by:

doPostSave in interface VersioningService

Parameters:

session - the core session

doc - the document

option - an option chosen by the user or framework

checkinComment - a checkin comment

options - map event info

Returns:

checkedInDocument or null

doCheckIn

public Document doCheckIn(Document doc,
 VersioningOption option,
 String checkinComment)

Description copied from interface: VersioningService

Applies version increment option and does a checkin.

Specified by:

doCheckIn in interface VersioningService

Parameters:

doc - the document

option - an option chosen by the user or framework

checkinComment - a checkin comment

Returns:

the version

doCheckOut

public void doCheckOut(Document doc)

Description copied from interface: VersioningService

Apply modifications after doing a checkout.

Specified by:

doCheckOut in interface VersioningService

Parameters:

doc - the document

setVersioningPolicies

public void setVersioningPolicies(Map<String,VersioningPolicyDescriptor> versioningPolicies)

Description copied from interface: ExtendableVersioningService

Add versioning policies

Specified by:

setVersioningPolicies in interface ExtendableVersioningService

setVersioningFilters

public void setVersioningFilters(Map<String,VersioningFilterDescriptor> versioningFilters)

Description copied from interface: ExtendableVersioningService

Add versioning filters

Specified by:

setVersioningFilters in interface ExtendableVersioningService

setVersioningRestrictions

public void setVersioningRestrictions(Map<String,VersioningRestrictionDescriptor> versioningRestrictions)

Description copied from interface: ExtendableVersioningService

Add versioning filters

Specified by:

setVersioningRestrictions in interface ExtendableVersioningService

Parameters:

versioningRestrictions - the restrictions to apply in versioning system

doAutomaticVersioning

public void doAutomaticVersioning(DocumentModel previousDocument,
 DocumentModel currentDocument,
 boolean before)

Description copied from interface: VersioningService

Does automatic versioning if a policy exists for the current input context. Currently automatic versioning is either before or after document update, never both.

Specified by:

doAutomaticVersioning in interface VersioningService

Parameters:

before - the flag to trigger a before or after automatic versioning (used to retrieve the right policy)

retrieveMatchingVersioningPolicy

protected VersioningPolicyDescriptor retrieveMatchingVersioningPolicy(DocumentModel previousDocument,
 DocumentModel currentDocument,
 boolean before)

isPolicyMatch

protected boolean isPolicyMatch(VersioningPolicyDescriptor policyDescriptor,
 DocumentModel previousDocument,
 DocumentModel currentDocument)

sendEvent

protected void sendEvent(CoreSession session,
 Document doc,
 String previousLifecycleState,
 Map<String,Serializable> options)