Package com.atlassian.confluence.content.apisupport

Class DefaultContentCreator

java.lang.Object

com.atlassian.confluence.content.apisupport.DefaultContentCreator

All Implemented Interfaces:

ContentCreator

@ExperimentalSpi
public class DefaultContentCreator
extends Object
implements ContentCreator

Constructor Summary

Constructors

Constructor

Description

DefaultContentCreator(SpaceManager spaceManager, ContentBodyConversionService contentBodyConversionService, PermissionManager permissionManager, PageManagerInternal pageManager, CustomContentManager customContentEntityManager, com.atlassian.event.api.EventPublisher eventPublisher, DraftAttributesCopier draftAttributesCopier, LabelManagerInternal labelManager, RelationManager relationManager, ContentEntityManagerInternal contentEntityManager)

Method Summary

Modifier and Type	Method	Description
<T extends ContentEntityObject> T	cloneForUpdate(T ceo)
<T extends ContentEntityObject> T	saveForCreate(T entity)	Deprecated. since 6.13.0, use saveNewContent(ContentEntityObject, Version, Draft)
<T extends ContentEntityObject> T	saveForCreate(T entity, @Nullable Version version, com.atlassian.fugue.Option<Draft> draft)	Deprecated. since 7.0.1.
<T extends ContentEntityObject> T	saveForCreate(T entity, com.atlassian.fugue.Option<Draft> draft)	Deprecated. since 6.13.0, use saveNewContent(ContentEntityObject, Version, Draft)
<T extends ContentEntityObject> T	saveNewContent(T entity, @Nullable Version version, @Nullable Draft draft)	Save a newly created content entity object
<T extends ContentEntityObject> T	saveNewVersion(T ceo, T originalCEO, Version version)	Save a new version of the CEO due to an update
boolean	setCommonMetadata(Content updatedContent, ContentEntityObject entity)	Sets the common metadata on the entity
void	setCommonPropertiesForCreate(Content newContent, ContentEntityObject entity, com.atlassian.user.User authenticatedUser)	Sets common properties on a newly created entity in preparation for being saved.
boolean	setCommonPropertiesForUpdate(Content updatedContent, ContentEntityObject entity)	Sets common properties on the entity in preparation for an update.
boolean	setContentBodyOnEntity(Content updatedContent, ContentEntityObject entity)	Sets the body content in updatedContent on the entity
boolean	setContentStatusOnEntity(Content updatedContent, ContentEntityObject entity)	Sets the content status from updatedContent on the entity
boolean	setLabelsMetadataOnEntity(Content updatedContent, ContentEntityObject entity)	Sets the labels metadata on the entity
boolean	setOriginalVersionOnEntity(Content updatedContent, ContentEntityObject entity)	This property only applies to shared drafts.
void	setSpaceForCreate(Content newContent, SpaceContentEntityObject spacedEntity, com.atlassian.user.User authenticatedUser)	Sets the space in newContent on this spacedEntity
boolean	setTitleOnEntity(Content updatedContent, ContentEntityObject entity)	Sets the title in updatedContent on the entity
<T extends ContentEntityObject> T	update(T ceo, T originalCEO, Version version)	Saves CEO
ValidationResult	validateCreate(ConfluenceUser confluenceUser, Content newContent, Class<? extends ContentEntityObject> entityClass)	Perform common validation checks for creation of content in a space
ValidationResult	validateUpdate(ConfluenceUser user, Content updatedContent, ContentEntityObject entity)	Perform common validation checks for updating content

Methods inherited from class java.lang.Object

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

Constructor Details

DefaultContentCreator

public DefaultContentCreator(SpaceManager spaceManager,
 ContentBodyConversionService contentBodyConversionService,
 PermissionManager permissionManager,
 PageManagerInternal pageManager,
 CustomContentManager customContentEntityManager,
 com.atlassian.event.api.EventPublisher eventPublisher,
 DraftAttributesCopier draftAttributesCopier,
 LabelManagerInternal labelManager,
 RelationManager relationManager,
 ContentEntityManagerInternal contentEntityManager)

Method Details

setCommonPropertiesForCreate

public void setCommonPropertiesForCreate(Content newContent,
 ContentEntityObject entity,
 com.atlassian.user.User authenticatedUser)

Sets common properties on a newly created entity in preparation for being saved.

The properties set include the title and content body, and if the entity is a SpacedContentEntityObject also the space

Specified by:

setCommonPropertiesForCreate in interface ContentCreator

Parameters:

newContent - the content containing the new properties to set on the entity

entity - the entity to set the new properties on

authenticatedUser - the user that performing the operation

validateUpdate

public ValidationResult validateUpdate(ConfluenceUser user,
 Content updatedContent,
 ContentEntityObject entity)

Perform common validation checks for updating content

Specified by:

validateUpdate in interface ContentCreator

Parameters:

user - the user to perform permission checks on

updatedContent - the content to be updated

entity - the entity to be updated

Returns:

a validation result indicating any validation errors that would occur on update

validateCreate

public ValidationResult validateCreate(ConfluenceUser confluenceUser,
 Content newContent,
 Class<? extends ContentEntityObject> entityClass)

Perform common validation checks for creation of content in a space

Specified by:

validateCreate in interface ContentCreator

Parameters:

confluenceUser - the user to perform permission checks on

newContent - the content to be created

entityClass - the class of content to create

Returns:

a validation result indicating any errors that would occur attempting to create content

setCommonPropertiesForUpdate

public boolean setCommonPropertiesForUpdate(Content updatedContent,
 ContentEntityObject entity)

Sets common properties on the entity in preparation for an update. For properties initialized include the title and the content body.

Specified by:

setCommonPropertiesForUpdate in interface ContentCreator

Parameters:

updatedContent - the content containing the properties to update on the entity

entity - the entity to be updated

Returns:

true if the entity was updated and requires being saved to the database

setLabelsMetadataOnEntity

public boolean setLabelsMetadataOnEntity(Content updatedContent,
 ContentEntityObject entity)

Sets the labels metadata on the entity

Specified by:

setLabelsMetadataOnEntity in interface ContentCreator

Parameters:

updatedContent - the content with the new body content

entity - the entity to be updated

Returns:

true if the entity was updated with labels metadata different to what it already had

setCommonMetadata

public boolean setCommonMetadata(Content updatedContent,
 ContentEntityObject entity)

Sets the common metadata on the entity

Specified by:

setCommonMetadata in interface ContentCreator

Parameters:

updatedContent - the content containing the properties to update on the entity

entity - the entity to be updated

Returns:

true if the entity was updated

setTitleOnEntity

public boolean setTitleOnEntity(Content updatedContent,
 ContentEntityObject entity)

Sets the title in updatedContent on the entity

Specified by:

setTitleOnEntity in interface ContentCreator

Parameters:

updatedContent - the content with the new title

entity - the entity to be updated

Returns:

true if the entity was updated with a different title to what it already had

setContentBodyOnEntity

public boolean setContentBodyOnEntity(Content updatedContent,
 ContentEntityObject entity)

Sets the body content in updatedContent on the entity

Specified by:

setContentBodyOnEntity in interface ContentCreator

Parameters:

updatedContent - the content with the new body content

entity - the entity to be updated

Returns:

true if the entity was updated with body content different to what it already had

setContentStatusOnEntity

public boolean setContentStatusOnEntity(Content updatedContent,
 ContentEntityObject entity)

Sets the content status from updatedContent on the entity

Specified by:

setContentStatusOnEntity in interface ContentCreator

Parameters:

updatedContent - the content with the new title

entity - the entity to be updated

Returns:

true if the content status was updated

setOriginalVersionOnEntity

public boolean setOriginalVersionOnEntity(Content updatedContent,
 ContentEntityObject entity)

This property only applies to shared drafts. If the content to be persisted is a draft, and the contentId provided already references an existing piece of content with CURRENT status, we set the original version on the draft to link the draft to the existing content.

Specified by:

setOriginalVersionOnEntity in interface ContentCreator

Parameters:

updatedContent - the content with the existing contentId

entity - the entity to be updated

Returns:

true if the original version was updated

setSpaceForCreate

public void setSpaceForCreate(Content newContent,
 SpaceContentEntityObject spacedEntity,
 com.atlassian.user.User authenticatedUser)

Sets the space in newContent on this spacedEntity

Specified by:

setSpaceForCreate in interface ContentCreator

Parameters:

newContent - the content with the new space to set

spacedEntity - the entity to be updated with the space

saveNewVersion

public <T extends ContentEntityObject> T saveNewVersion(T ceo,
 T originalCEO,
 Version version)

Save a new version of the CEO due to an update

Specified by:

saveNewVersion in interface ContentCreator

Parameters:

ceo - the new version of the CEO

originalCEO - the original version of the ceo

version - the version object with information about the new version to be saved

Returns:

the latest version of the CEO fetched from the database

update

public <T extends ContentEntityObject> T update(T ceo,
 T originalCEO,
 Version version)

Saves CEO

Specified by:

update in interface ContentCreator

Parameters:

ceo - CEO

originalCEO - ceo we are updating from

version - current version to update to

Returns:

the latest version of the CEO fetched from the database

saveForCreate

@Deprecated
public <T extends ContentEntityObject> T saveForCreate(T entity)

Deprecated.

since 6.13.0, use saveNewContent(ContentEntityObject, Version, Draft)

Save a newly created CEO

Specified by:

saveForCreate in interface ContentCreator

Parameters:

entity - the newly created CEO

Returns:

the latest version of the CEO fetched from the database

saveForCreate

@Deprecated
public <T extends ContentEntityObject> T saveForCreate(T entity,
 com.atlassian.fugue.Option<Draft> draft)

Deprecated.

since 6.13.0, use saveNewContent(ContentEntityObject, Version, Draft)

Save a newly created CEO

Specified by:

saveForCreate in interface ContentCreator

Parameters:

entity - the newly created CEO

draft - the draft object contains metadata which will be transferred into the entity

Returns:

the latest version of the CEO fetched from the database

saveForCreate

@Deprecated
public <T extends ContentEntityObject> T saveForCreate(T entity,
 @Nullable Version version,
 com.atlassian.fugue.Option<Draft> draft)

Deprecated.

since 7.0.1. Use saveNewContent(ContentEntityObject, Version, Draft)

Save a newly created content entity object

Specified by:

saveForCreate in interface ContentCreator

Parameters:

entity - the entity object to be saved

version - the version

draft - the draft object contains metadata which will be transferred into the entity

Returns:

the latest version of the content entity object fetched from the database

Since:

6.13.0

saveNewContent

public <T extends ContentEntityObject> T saveNewContent(T entity,
 @Nullable Version version,
 @Nullable Draft draft)

Save a newly created content entity object

Specified by:

saveNewContent in interface ContentCreator

Parameters:

entity - the entity object to be saved

version - the version

draft - the draft object contains metadata which will be transferred into the entity. Can be null.

Returns:

the latest version of the content entity object fetched from the database

Since:

7.0.1

cloneForUpdate

public <T extends ContentEntityObject> T cloneForUpdate(T ceo)

Specified by:

cloneForUpdate in interface ContentCreator