com.atlassian.confluence.core

Interface Versioned

All Known Implementing Classes:

AbstractLabelableEntityObject, AbstractPage, AbstractVersionedEntityObject, Attachment, BlogPost, Comment, ContentEntityObject, ContentEntitySimulacrum, CustomContentEntityObject, Draft, GlobalDescription, Mail, Page, PageContentEntityObject, PageTemplate, PersonalInformation, SpaceContentEntityObject, SpaceDescription, UserStatus

public interface Versioned

A Confluence object that can exist in multiple versions. Only a single history of versions is allowed for any object: branching versions are not supported.

Object versioning in Confluence works in a slightly unconventional way. The identity of the 'current' object (known in the interface as the 'original' or 'latest' version) always remains the same. The object's version history consists of cloned snapshots of that object, taken before each change to its state.

Or, to give a code example:

Versioned oldVersion = (Versioned) currentObject.clone();
 oldVersion.convertToHistoricalVersion();
 oldVersion.setOriginalVersion(currentObject);
 // make changes to currentObject
 currentVersion.setVersion(currentVersion.getVersion() + 1);
 // save both objects

For Confluence persistent objects, some of the above may be handled for you by the default DAO.

Method Summary

Modifier and Type	Method and Description
void	applyChildVersioningPolicy(Versioned versionToPromote, ObjectDao dao) If getVersionChildPolicy(com.atlassian.confluence.api.model.content.ContentType) specifies so, moves content from versionToPromote to this Versioned instance or makes no change.
void	convertToHistoricalVersion() Remove all data from the object that does not need to be saved by historical versions.
Versioned	getLatestVersion() Get the latest, current version of this versioned object.
ConfluenceEntityObject	getOriginalVersion() Deprecated. since 2.5. Use getLatestVersion() and isLatestVersion() instead.
int	getVersion() Return the version number of this version of the object.
VersionChildOwnerPolicy	getVersionChildPolicy(ContentType contentType) Returns the right VersionChildOwnerPolicy depending on the passed contentType.
boolean	isLatestVersion() Is this the latest version of the object? If this method returns true, then getOriginalVersion() will return null.
boolean	isNew() Is this the first version of this object?
void	setOriginalVersion(Versioned originalVersion) Set the current version of this object.
void	setVersion(int version) Set the version number of this version of the object.

Method Detail

getVersion

int getVersion()

Return the version number of this version of the object. Version numbers are integers in ascending chronological order from 1 (the first version). Clients must not assume if two versions x and y exist, that any integer versions between x and y also exist.

Returns:

the version number of this version of the object

setVersion

void setVersion(int version)

Set the version number of this version of the object. Only call this method if you are creating a new version.

Parameters:

version - the new version number for this version of the object.

convertToHistoricalVersion

void convertToHistoricalVersion()

Remove all data from the object that does not need to be saved by historical versions. For versioned objects that are persisted, this includes removing associations with other persisted objects that may otherwise cause us to break the expected arity of the database relations.

When using Hibernate to persist versioned objects, take special care to null any field that might contain a Hibernate-persisted collection, as Hibernate does not allow two different persistent objects to refer to the same persisted collection at the same time.

applyChildVersioningPolicy

void applyChildVersioningPolicy(@Nullable
                                Versioned versionToPromote,
                                ObjectDao dao)

If getVersionChildPolicy(com.atlassian.confluence.api.model.content.ContentType) specifies so, moves content from versionToPromote to this Versioned instance or makes no change.

Parameters:

versionToPromote - the new version of the current instance that we're getting the children from

dao - dao used to delete dangling contained content

isNew

boolean isNew()

Is this the first version of this object?

Returns:

true if this is the first version of this versioned object, false if it is a later version.

getOriginalVersion

@Deprecated
ConfluenceEntityObject getOriginalVersion()

Deprecated. since 2.5. Use getLatestVersion() and isLatestVersion() instead.

Get the "original version" of this versioned object. If this object is the original version, return null.

Deprecated: This method is broken because it returns ConfluenceEntityObject instead of Versioned. In some future version of Confluence, this mistake will be corrected, but the change will at the very least require that any code calling this method be recompiled.

Returns:

the original version of this versioned object, or null if this is the original version.

getLatestVersion

Versioned getLatestVersion()

Get the latest, current version of this versioned object. If this object is the current version, return this object.

Note that drafts are a special version of a ContentEntityObject so for drafts this method should return the ContentEntityObject the drafts points to if it exists and the draft itself otherwise.

Returns:

the current version of this object.

See Also:

ContentEntityObject.DRAFT

setOriginalVersion

void setOriginalVersion(Versioned originalVersion)

Set the current version of this object. After this method is called, this object will become an historical version of the object passed in.

Parameters:

originalVersion - the current version of this object.

isLatestVersion

boolean isLatestVersion()

Is this the latest version of the object? If this method returns true, then getOriginalVersion() will return null.

Returns:

true if this is the latest (current) version of the object, false if it is an historical version.

getVersionChildPolicy

VersionChildOwnerPolicy getVersionChildPolicy(ContentType contentType)

Returns the right VersionChildOwnerPolicy depending on the passed contentType. By default, VersionChildOwnerPolicy.currentVersion is returned

Right now, this is only enforced for children with content type Attachment or Comment