Package org.nuxeo.ecm.core.versioning

Class VersioningComponent

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.ecm.core.versioning.VersioningComponent

All Implemented Interfaces:

VersioningService, Adaptable, Component, Extensible, TimestampedService

public class VersioningComponent
extends DefaultComponent
implements VersioningService

Versioning service component and implementation.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	VersioningComponent.VersioningFilterRegistry
protected static class	VersioningComponent.VersioningPolicyRegistry
protected static class	VersioningComponent.VersioningRestrictionRegistry

Field Summary

Fields

Modifier and Type	Field	Description
protected ComponentContext	context
VersioningService	service
protected static final StandardVersioningService	STANDARD_VERSIONING_SERVICE
static final String	VERSIONING_FILTER_XP
static final String	VERSIONING_POLICY_XP
static final String	VERSIONING_RESTRICTION_XP
static final String	VERSIONING_SERVICE_XP
protected VersioningComponent.VersioningFilterRegistry	versioningFiltersRegistry
protected VersioningComponent.VersioningPolicyRegistry	versioningPoliciesRegistry
protected VersioningComponent.VersioningRestrictionRegistry	versioningRestrictionsRegistry
protected Map<VersioningServiceDescriptor,VersioningService>	versioningServices

Fields inherited from class org.nuxeo.runtime.model.DefaultComponent

lastModified, name

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
VersioningComponent()

Method Summary

Modifier and Type	Method	Description
void	activate(ComponentContext context)	Activates the component.
void	deactivate(ComponentContext context)	Deactivates the component.
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.
List<VersioningOption>	getSaveOptions(DocumentModel docModel)	Checks what options are available on a document at save time.
protected Map<String,VersioningFilterDescriptor>	getVersioningFilters()
protected Map<String,VersioningPolicyDescriptor>	getVersioningPolicies()
protected Map<String,VersioningRestrictionDescriptor>	getVersioningRestrictions()
String	getVersionLabel(DocumentModel doc)	Gets the version label to display for a given document.
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 void	recompute()
void	registerContribution(Object contrib, String point, ComponentInstance contributor)
protected void	registerVersioningFilter(VersioningFilterDescriptor contrib)
protected void	registerVersioningPolicy(VersioningPolicyDescriptor contrib)
protected void	registerVersioningRestriction(VersioningRestrictionDescriptor contrib)
protected void	registerVersioningService(VersioningServiceDescriptor contrib)
void	unregisterContribution(Object contrib, String point, ComponentInstance contributor)
protected void	unregisterVersioningFilter(VersioningFilterDescriptor contrib)
protected void	unregisterVersioningPolicy(VersioningPolicyDescriptor contrib)
protected void	unregisterVersioningRestriction(VersioningRestrictionDescriptor contrib)
protected void	unregisterVersioningService(VersioningServiceDescriptor contrib)

Methods inherited from class org.nuxeo.runtime.model.DefaultComponent

addRuntimeMessage, addRuntimeMessage, getAdapter, getDescriptor, getDescriptors, getLastModified, getRegistry, register, registerExtension, setLastModified, setModifiedNow, setName, start, stop, unregister, unregisterExtension

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nuxeo.runtime.model.Component

getApplicationStartedOrder

Field Details

VERSIONING_SERVICE_XP

public static final String VERSIONING_SERVICE_XP

See Also:

• Constant Field Values

VERSIONING_POLICY_XP

public static final String VERSIONING_POLICY_XP

See Also:

• Constant Field Values

VERSIONING_FILTER_XP

public static final String VERSIONING_FILTER_XP

See Also:

• Constant Field Values

VERSIONING_RESTRICTION_XP

public static final String VERSIONING_RESTRICTION_XP

See Also:

• Constant Field Values

STANDARD_VERSIONING_SERVICE

protected static final StandardVersioningService STANDARD_VERSIONING_SERVICE

versioningServices

protected Map<VersioningServiceDescriptor,VersioningService> versioningServices

versioningPoliciesRegistry

protected VersioningComponent.VersioningPolicyRegistry versioningPoliciesRegistry

versioningFiltersRegistry

protected VersioningComponent.VersioningFilterRegistry versioningFiltersRegistry

versioningRestrictionsRegistry

protected VersioningComponent.VersioningRestrictionRegistry versioningRestrictionsRegistry

service

public VersioningService service

context

protected ComponentContext context

Constructor Details

VersioningComponent

public VersioningComponent()

Method Details

activate

public void activate(ComponentContext context)

Description copied from interface: Component

Activates the component.

This method is called by the runtime when a component is activated.

Specified by:

activate in interface Component

Overrides:

activate in class DefaultComponent

Parameters:

context - the runtime context

deactivate

public void deactivate(ComponentContext context)

Description copied from interface: Component

Deactivates the component.

This method is called by the runtime when a component is deactivated.

Specified by:

deactivate in interface Component

Overrides:

deactivate in class DefaultComponent

Parameters:

context - the runtime context

registerContribution

public void registerContribution(Object contrib,
 String point,
 ComponentInstance contributor)

Overrides:

registerContribution in class DefaultComponent

unregisterContribution

public void unregisterContribution(Object contrib,
 String point,
 ComponentInstance contributor)

Overrides:

unregisterContribution in class DefaultComponent

registerVersioningService

protected void registerVersioningService(VersioningServiceDescriptor contrib)

unregisterVersioningService

protected void unregisterVersioningService(VersioningServiceDescriptor contrib)

registerVersioningPolicy

protected void registerVersioningPolicy(VersioningPolicyDescriptor contrib)

unregisterVersioningPolicy

protected void unregisterVersioningPolicy(VersioningPolicyDescriptor contrib)

registerVersioningFilter

protected void registerVersioningFilter(VersioningFilterDescriptor contrib)

unregisterVersioningFilter

protected void unregisterVersioningFilter(VersioningFilterDescriptor contrib)

registerVersioningRestriction

protected void registerVersioningRestriction(VersioningRestrictionDescriptor contrib)

unregisterVersioningRestriction

protected void unregisterVersioningRestriction(VersioningRestrictionDescriptor contrib)

recompute

protected void recompute()

getVersioningPolicies

protected Map<String,VersioningPolicyDescriptor> getVersioningPolicies()

getVersioningFilters

protected Map<String,VersioningFilterDescriptor> getVersioningFilters()

getVersioningRestrictions

protected Map<String,VersioningRestrictionDescriptor> getVersioningRestrictions()

getVersionLabel

public String getVersionLabel(DocumentModel doc)

Description copied from interface: VersioningService

Gets the version label to display for a given document.

Specified by:

getVersionLabel in interface VersioningService

Parameters:

doc - the document

Returns:

the version label, like "2.1"

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

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

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)

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

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

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