org.nuxeo.ecm.core.versioning

Class StandardVersioningService

java.lang.Object

org.nuxeo.ecm.core.versioning.StandardVersioningService

All Implemented Interfaces:

ExtendableVersioningService, VersioningService

Direct Known Subclasses:

CompatVersioningService

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 and Description
static String	APPROVED_STATE
protected static String	AUTO_CHECKED_OUT
static String	BACK_TO_PROJECT_TRANSITION
static String	FILE_TYPE
protected static String	MAJOR_VERSION Key for major version in Document API.
protected static String	MINOR_VERSION Key for minor version in Document API.
static String	NOTE_TYPE
static String	OBSOLETE_STATE
static String	PROJECT_STATE

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

CHECKIN_COMMENT, DISABLE_AUTO_CHECKOUT, MAJOR_VERSION_PROP, MINOR_VERSION_PROP, SKIP_VERSIONING, VERSIONING_OPTION

Constructor Summary

Constructors

Constructor and Description
StandardVersioningService()

Method Summary

Modifier and Type	Method and Description
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(Document doc, VersioningOption option, String checkinComment, Map<String,Serializable> options) Applies versioning options after document save.
VersioningOption	doPreSave(Document doc, boolean isDirty, VersioningOption option, String checkinComment, Map<String,Serializable> options) Applies versioning options before document save.
protected void	followTransitionByOption(Document doc, VersioningOption option)
protected long	getMajor(Document doc)
protected long	getMajor(DocumentModel docModel)
protected long	getMinor(Document doc)
protected long	getMinor(DocumentModel docModel)
protected List<VersioningOption>	getSaveOptions(boolean versionable, String lifecycleState, String type)
protected List<VersioningOption>	getSaveOptions(Document doc)
List<VersioningOption>	getSaveOptions(DocumentModel docModel) Checks what options are available on a document at save time.
protected long	getVersion(DocumentModel docModel, String prop)
protected long	getVersion(Document doc, String prop)
Map<String,VersioningRuleDescriptor>	getVersioningRules()
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)
boolean	isPostSaveDoingCheckIn(Document doc, VersioningOption option, Map<String,Serializable> options) Checks if VersioningService.doPostSave(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.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.
void	setDefaultVersioningRule(DefaultVersioningRuleDescriptor defaultVersioningRule) Set the default versioning rule for all document type.
protected void	setInitialVersion(Document doc) Sets the initial version on a document.
protected void	setVersion(Document doc, long major, long minor)
void	setVersioningRules(Map<String,VersioningRuleDescriptor> versioningRules) Add versioning rules for specific types.
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 Detail

FILE_TYPE

public static final String FILE_TYPE

See Also:

Constant Field Values

NOTE_TYPE

public static final String NOTE_TYPE

See Also:

Constant Field Values

PROJECT_STATE

public static final String PROJECT_STATE

See Also:

Constant Field Values

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

AUTO_CHECKED_OUT

protected static final String AUTO_CHECKED_OUT

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

Constructor Detail

StandardVersioningService

public StandardVersioningService()

Method Detail

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

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)

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.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.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(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:

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

Returns:

the validated option (to use in doPostSave)

followTransitionByOption

protected void followTransitionByOption(Document doc,
                                        VersioningOption option)

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.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.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(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:

doc - the document

option - an option chosen by the user or framework

checkinComment - a checkin comment

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

getVersioningRules

public Map<String,VersioningRuleDescriptor> getVersioningRules()

Specified by:

getVersioningRules in interface ExtendableVersioningService

Returns:

A Map containing the versioning rule for specific types.

setVersioningRules

public void setVersioningRules(Map<String,VersioningRuleDescriptor> versioningRules)

Description copied from interface: ExtendableVersioningService

Add versioning rules for specific types.

Specified by:

setVersioningRules in interface ExtendableVersioningService

setDefaultVersioningRule

public void setDefaultVersioningRule(DefaultVersioningRuleDescriptor defaultVersioningRule)

Description copied from interface: ExtendableVersioningService

Set the default versioning rule for all document type.

Specified by:

setDefaultVersioningRule in interface ExtendableVersioningService