com.atlassian.confluence.core
Interface ContentEntityManager

All Known Subinterfaces:
CommentManager, CustomContentManager, MailContentManager, PageManager, SpaceDescriptionManager, UserStatusManager
All Known Implementing Classes:
DefaultCommentManager, DefaultContentEntityManager, DefaultCustomContentManager, DefaultMailContentManager, DefaultPageManager, DefaultPersonalInformationManager, DefaultSpaceDescriptionManager, DefaultUserStatusManager

public interface ContentEntityManager


Field Summary
static int ITERATE_ALL
           
 
Method Summary
 ContentEntityObject getById(long id)
           
 ContentEntityObject getNextVersion(ContentEntityObject ceo)
           
 ContentEntityObject getOtherVersion(ContentEntityObject ceo, int version)
           
 ContentEntityObject getPreviousVersion(ContentEntityObject ceo)
           
 java.util.Iterator getRecentlyAddedEntities(java.lang.String spaceKey, int maxResults)
          Retrieve an iterator of recently added entities, in order of most recent to last.
 java.util.Iterator getRecentlyModifiedEntities(java.lang.String spaceKey, int maxResults)
          Retrieve an iterator of recently modified entities, in order of most recent to last.
 java.util.Iterator getRecentlyModifiedEntitiesForUser(java.lang.String username)
          Retrieve an iterator of recently modified entities, in order of most recent to last.
 java.util.List getRecentlyModifiedForChangeDigest(java.util.Date fromDate)
          Retrieves a list of ContentEntityObjects that have been newly added or modified since the date specified.
 java.util.List<VersionHistorySummary> getVersionHistorySummaries(ContentEntityObject ceo)
          Get a VersionHistorySummary for all previous versions of a ContentEntityObject, starting with the current content.
 void refreshContentEntity(ContentEntityObject obj)
          Refreshes the specified entity (including content) in the Hibernate session to ensure that subsequent retrievals are up-to-date.
 void removeContentEntity(ContentEntityObject obj)
          Removes given content entity object and all associated domain objects i.e.
 void removeHistoricalVersion(ContentEntityObject historicalVersion)
          Removes a historical ContentEntityObject.
 void revertContentEntityBackToVersion(ContentEntityObject obj, int version, java.lang.String revertComment, boolean revertTitle)
           Reverts a ContentEntityObject back to its state at the version specified by version.
 void saveContentEntity(ContentEntityObject obj, ContentEntityObject origObj, SaveContext saveContext)
          In order to create a history for this object, we need to pass in the modified as well as the original version of the object.
 void saveContentEntity(ContentEntityObject obj, SaveContext saveContext)
           
<T extends ContentEntityObject>
void
saveNewVersion(T current, Modification<T> modification)
          Applies the state changes supplied by modification and persists those changes to a new version.
<T extends ContentEntityObject>
void
saveNewVersion(T current, Modification<T> modification, SaveContext saveContext)
          Applies the state changes supplied by modification and persists those changes to a new version.
 void setEventManager(com.atlassian.event.EventManager eventManager)
          Deprecated. since 3.1 do not use. Implementation detail mistakenly added to service interface.
 void updateContentLinkingTo(SpaceContentEntityObject contentBeingRefactored, java.lang.String newSpaceKey, java.lang.String newTitle)
          Deprecated. since 4.0.
 void updateOutgoingLinksInContent(SpaceContentEntityObject contentBeingRefactored, java.lang.String newSpaceKey)
          Deprecated. since 4.0
 void updateSingleContentLinkinTo(ContentEntityObject referringContent, SpaceContentEntityObject contentBeingRefactored, java.lang.String newSpaceKey, java.lang.String newTitle)
          Deprecated. since 4.0
 void updateSingleContentLinkinTo(ContentEntityObject referringContent, SpaceContentEntityObject contentBeingRefactored, java.lang.String newSpaceKey, java.lang.String newTitle, SaveContext saveContext)
          Deprecated. since 4.0
 

Field Detail

ITERATE_ALL

static final int ITERATE_ALL
See Also:
Constant Field Values
Method Detail

refreshContentEntity

void refreshContentEntity(ContentEntityObject obj)
Refreshes the specified entity (including content) in the Hibernate session to ensure that subsequent retrievals are up-to-date.

Parameters:
obj - the object to be refreshed in the Hibernate session.

saveContentEntity

void saveContentEntity(ContentEntityObject obj,
                       SaveContext saveContext)
Parameters:
obj - - the ContentEntityObject to save
saveContext - - a SaveContext object for the manager.

saveContentEntity

void saveContentEntity(ContentEntityObject obj,
                       ContentEntityObject origObj,
                       SaveContext saveContext)
In order to create a history for this object, we need to pass in the modified as well as the original version of the object.

Parameters:
saveContext - - a SaveContext holding additional parameters for the manager to use when saving.

saveNewVersion

<T extends ContentEntityObject> void saveNewVersion(T current,
                                                    Modification<T> modification)
Applies the state changes supplied by modification and persists those changes to a new version.
 manager.<Page>saveNewVersion(page, new Modification<Page>() {
      public void modify(Page page) {
          page.setTitle("foobar");
      }
 });
 

Type Parameters:
T - the type content. This ensures that the type of current is the same as the type passed to the modification
Parameters:
current - the current / latest version
modification - an implementation of Modification which describes the state changes you require

saveNewVersion

<T extends ContentEntityObject> void saveNewVersion(T current,
                                                    Modification<T> modification,
                                                    SaveContext saveContext)
Applies the state changes supplied by modification and persists those changes to a new version.
 manager.<Page>saveNewVersion(page, new Modification<Page>() {
      public void modify(Page page) {
          page.setTitle("foobar");
      }
 }, new DefaultSaveContext());
 

Type Parameters:
T - the type content. This ensures that the type of current is the same as the type passed to the modification
Parameters:
current - the current / latest version
modification - an implementation of Modification which describes the state changes you require
saveContext - the save context (null if you have no specific requirements - or just use saveNewVersion(ContentEntityObject, Modification)).

removeContentEntity

void removeContentEntity(ContentEntityObject obj)
Removes given content entity object and all associated domain objects i.e. if we remove a page it removes all its labels and attachments


revertContentEntityBackToVersion

void revertContentEntityBackToVersion(ContentEntityObject obj,
                                      int version,
                                      java.lang.String revertComment,
                                      boolean revertTitle)

Reverts a ContentEntityObject back to its state at the version specified by version. Creates a new latest version that resembles the previous state.

Since Confluence 4.0 most ContentEntityObjects are assumed to be XHTML formatted. So in reverting a ContentEntityObject which actually has a WIKI BodyType this will be migrated on the fly to XHTML.

Parameters:
obj - The ContentEntityObject to revert
version - The version to revert to
revertComment - A comment to be associated with the revert
revertTitle - If true, the ContentEntityObject title will be reverted to the old state

getRecentlyAddedEntities

java.util.Iterator getRecentlyAddedEntities(java.lang.String spaceKey,
                                            int maxResults)
Retrieve an iterator of recently added entities, in order of most recent to last. The iterator is lazy-loading, so you can filter the output and return the first 'n' that interest you. For performance reasons, it's a VERY bad idea to supply both a space key, and infinite results. If you supply a space key, this WILL NOT RETURN ANY COMMENTS. There is currently no way around this, you have to retrieve comments separately and splice the results together. Sorry.

Parameters:
spaceKey - the space key to look up the entities for. If spaceKey is null, there is assumed to be no space, and things like user info and space descriptions will also be returned.
maxResults - the maximum number of entities to return in the iterator. Any number zero or less (Use the ITERATE_ALL constant) will cause the iterator to go over every entity.

getRecentlyModifiedEntities

java.util.Iterator getRecentlyModifiedEntities(java.lang.String spaceKey,
                                               int maxResults)
Retrieve an iterator of recently modified entities, in order of most recent to last. The iterator is lazy-loading, so you can filter the output and return the first 'n' that interest you. For performance reasons, it's a VERY bad idea to supply both a space key, and infinite results.

Parameters:
spaceKey - the space key to look up the entities for.
maxResults - the maximum number of entities to return in the iterator. Any number zero or less (Use the ITERATE_ALL constant) will cause the iterator to go over every entity.

getRecentlyModifiedForChangeDigest

java.util.List getRecentlyModifiedForChangeDigest(java.util.Date fromDate)
Retrieves a list of ContentEntityObjects that have been newly added or modified since the date specified. This list excludes drafts, space descriptions and mail.

Parameters:
fromDate - content modified after this date will be returned
Returns:
a list of ContentEntityObjects that have been newly added or modified since the date specified

getRecentlyModifiedEntitiesForUser

java.util.Iterator getRecentlyModifiedEntitiesForUser(java.lang.String username)
Retrieve an iterator of recently modified entities, in order of most recent to last. The iterator is lazy-loading, so you can filter the output and return the first 'n' that interest you.

Parameters:
username - the user for which to retrieve the modified content

getById

ContentEntityObject getById(long id)
Parameters:
id -
Returns:
the object with the corresponding id or null if the object with that id does not exist

updateContentLinkingTo

@Deprecated
void updateContentLinkingTo(SpaceContentEntityObject contentBeingRefactored,
                                       java.lang.String newSpaceKey,
                                       java.lang.String newTitle)
Deprecated. since 4.0.

Loops through all the content that currently links to 'contentBeingChanged' and renames all the links.
This will skip any referring content that is the 'contentBeingChanged' (i.e. content links to itself).
If you only want to change the links of a specific content object, use the 'updateSingleContentLinkinTo' function.
This rename will be recorded in the content's history


updateOutgoingLinksInContent

@Deprecated
void updateOutgoingLinksInContent(SpaceContentEntityObject contentBeingRefactored,
                                             java.lang.String newSpaceKey)
Deprecated. since 4.0

Update the links on the page itself. If links are local (refering to the current space), a spacekey has to be added to the link


updateSingleContentLinkinTo

@Deprecated
void updateSingleContentLinkinTo(ContentEntityObject referringContent,
                                            SpaceContentEntityObject contentBeingRefactored,
                                            java.lang.String newSpaceKey,
                                            java.lang.String newTitle)
Deprecated. since 4.0

Renames all links contained in the 'referringContent' that currently links to 'contentBeingRefactored'.
This rename will be recorded in the content's history


updateSingleContentLinkinTo

@Deprecated
void updateSingleContentLinkinTo(ContentEntityObject referringContent,
                                            SpaceContentEntityObject contentBeingRefactored,
                                            java.lang.String newSpaceKey,
                                            java.lang.String newTitle,
                                            SaveContext saveContext)
Deprecated. since 4.0

Parameters:
referringContent -
contentBeingRefactored -
newSpaceKey -
newTitle -
saveContext -

setEventManager

void setEventManager(com.atlassian.event.EventManager eventManager)
Deprecated. since 3.1 do not use. Implementation detail mistakenly added to service interface.


getPreviousVersion

ContentEntityObject getPreviousVersion(ContentEntityObject ceo)

getNextVersion

ContentEntityObject getNextVersion(ContentEntityObject ceo)

getOtherVersion

ContentEntityObject getOtherVersion(ContentEntityObject ceo,
                                    int version)

getVersionHistorySummaries

java.util.List<VersionHistorySummary> getVersionHistorySummaries(ContentEntityObject ceo)
Get a VersionHistorySummary for all previous versions of a ContentEntityObject, starting with the current content.

Parameters:
ceo - the entity object to return the version history of
Returns:
the full version history of that object, as VersionHistorySummary objects.

removeHistoricalVersion

void removeHistoricalVersion(ContentEntityObject historicalVersion)
Removes a historical ContentEntityObject.

Parameters:
historicalVersion - a historical entity object to remove


Copyright © 2003-2013 Atlassian. All Rights Reserved.