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 and Description
protected static class	VersioningComponent.VersioningRuleRegistry

Field Summary

Fields

Modifier and Type	Field and Description
protected ComponentContext	context
protected Deque<DefaultVersioningRuleDescriptor>	defaultVersioningRuleList
VersioningService	service
protected static StandardVersioningService	STANDARD_VERSIONING_SERVICE
static String	VERSIONING_RULE_XP
static String	VERSIONING_SERVICE_XP
protected VersioningComponent.VersioningRuleRegistry	versioningRulesRegistry
protected Map<VersioningServiceDescriptor,VersioningService>	versioningServices

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

lastModified

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

Method Summary

Modifier and Type	Method and Description
void	activate(ComponentContext context) Activates the component.
void	deactivate(ComponentContext context) Deactivates the component.
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 DefaultVersioningRuleDescriptor	getDefaultVersioningRule()
List<VersioningOption>	getSaveOptions(DocumentModel docModel) Checks what options are available on a document at save time.
protected Map<String,VersioningRuleDescriptor>	getVersioningRules()
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.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.
protected void	recompute()
void	registerContribution(Object contrib, String point, ComponentInstance contributor)
protected void	registerDefaultVersioningRule(DefaultVersioningRuleDescriptor contrib)
protected void	registerVersioningRule(VersioningRuleDescriptor contrib)
protected void	registerVersioningService(VersioningServiceDescriptor contrib)
void	unregisterContribution(Object contrib, String point, ComponentInstance contributor)
protected void	unregisterDefaultVersioningRule(DefaultVersioningRuleDescriptor contrib)
protected void	unregisterVersioningRule(VersioningRuleDescriptor contrib)
protected void	unregisterVersioningService(VersioningServiceDescriptor contrib)

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

applicationStarted, getAdapter, getApplicationStartedOrder, getLastModified, registerExtension, setLastModified, setModifiedNow, unregisterExtension

Methods inherited from class java.lang.Object

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

Field Detail

VERSIONING_SERVICE_XP

public static final String VERSIONING_SERVICE_XP

See Also:

Constant Field Values

VERSIONING_RULE_XP

public static final String VERSIONING_RULE_XP

See Also:

Constant Field Values

STANDARD_VERSIONING_SERVICE

protected static final StandardVersioningService STANDARD_VERSIONING_SERVICE

versioningServices

protected Map<VersioningServiceDescriptor,VersioningService> versioningServices

versioningRulesRegistry

protected VersioningComponent.VersioningRuleRegistry versioningRulesRegistry

defaultVersioningRuleList

protected Deque<DefaultVersioningRuleDescriptor> defaultVersioningRuleList

service

public VersioningService service

context

protected ComponentContext context

Constructor Detail

VersioningComponent

public VersioningComponent()

Method Detail

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)

registerVersioningRule

protected void registerVersioningRule(VersioningRuleDescriptor contrib)

unregisterVersioningRule

protected void unregisterVersioningRule(VersioningRuleDescriptor contrib)

registerDefaultVersioningRule

protected void registerDefaultVersioningRule(DefaultVersioningRuleDescriptor contrib)

unregisterDefaultVersioningRule

protected void unregisterDefaultVersioningRule(DefaultVersioningRuleDescriptor contrib)

recompute

protected void recompute()

getVersioningRules

protected Map<String,VersioningRuleDescriptor> getVersioningRules()

getDefaultVersioningRule

protected DefaultVersioningRuleDescriptor getDefaultVersioningRule()

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

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.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)

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