com.atlassian.confluence.pages.persistence.dao.hibernate
Class CachingPageDao

java.lang.Object
  com.atlassian.confluence.pages.persistence.dao.hibernate.CachingPageDao

All Implemented Interfaces:

ObjectDao, ContentEntityObjectDao, VersionedObjectDao, PageDao

public class CachingPageDao
extends Object
implements PageDao

This maintains a cache of (space key, page title) -> (page id) mappings. All page ids cached refer to current pages. When a page is marked for deletion, it is removed from this cache.

Constructor Summary

CachingPageDao(PageDao delegateDao, PageIdCache pageIdCache)

Method Summary

List	findAll()
List	findAllSorted(String s)
long	findLatestVersionsCount() Returns the number of results for the latest versions of the current persistent class.
Iterator	findLatestVersionsIterator() Returns an iterator for the latest versions of the current persistent class.
List	findPagesWithHistoricalTitle(String pageTitle)
List<AbstractPage>	findPagesWithHistoricalTitleInAllPermittedSpacesExcept(String pageTitle, Space space, int maxResultCount) Searches for pages in all spaces except the one specified, looking for those that have the given title in a previous version, and returns the first maxResultCount results.
List<AbstractPage>	findPagesWithHistoricalTitleInPermittedSpace(String pageTitle, Space space, int maxResultCount) Searches for pages in the space specified, looking for those that have the given title in a previous version, and returns the first maxResultCount results.
List	findPreviousVersions(long originalContentId)
Iterator	getAllCurrentEntities()
int	getAuthoredPagesCountByUser(String username)
ContentEntityObject	getById(long id)
int	getCommentCountOnPage(long id) Count the number of comments on the passed in page.
List	getContentAuthoredByUser(String username)
List	getDescendentIds(Page page)
List<Page>	getDescendents(Page page)
ContentEntityObject	getFirstVersionAfter(long originalVersionContentId, int version)
ContentEntityObject	getFirstVersionBefore(long originalVersionContentId, int version)
List<ContentEntityObject>	getLastEditedVersionsOf(ContentEntityObject content) Retrieves all the last edited versions for each user who has contributed to the specified piece of content.
List	getLockedContentBySpace(String spaceKey)
String	getObjectType(long id)
List	getOrphanedPages(String spaceKey)
Page	getPage(Space space, String pageTitle) Get the page by space and title.
Page	getPage(String spaceKey, String pageTitle) Deprecated.
Page	getPage(String spaceKey, String pageTitle, boolean eagerLoadComments) Deprecated.
Page	getPageById(long id) Get the page with the given id.
Page	getPageByIdWithComments(long id) Get the page with the given id, and perform an eager load of the comments and their children.
List	getPageInTrash(String spaceKey, String title)
List	getPages(Space space, boolean currentOnly)
List	getPagesCreatedOrUpdatedSinceDate(Date previousLoginDate)
List	getPagesStartingWith(Space space, String s)
Page	getPageWithComments(Space space, String pageTitle) Get the page by space and title, and perform an eager load of the comments and their children.
List	getPermissionPages(Space space)
Class	getPersistentClass()
Iterator	getRecentlyAddedEntities(String spaceKey, int maxResults)
List	getRecentlyAddedPages(int maxCount, String spaceKey)
List	getRecentlyAuthoredPagesByUser(String username, int maxCount)
Iterator	getRecentlyModifiedEntities(int maxResults)
Iterator	getRecentlyModifiedEntities(String spaceKey, int maxResults)
Iterator	getRecentlyModifiedEntitiesForUser(String username)
List	getRecentlyModifiedForChangeDigest(Date fromDate) Retrieves a list of ContentEntityObjects that have been newly added or modified since the date specified.
List	getRecentlyUpdatedPages(int maxCount, String spaceKey)
List<Page>	getTopLevelPages(Space space)
List	getTrashedContent(String spaceKey)
List	getUndefinedPages(String spaceKey)
ContentEntityObject	getVersion(long originalVersionContentId, int version)
List	getVersionHistorySummary(long originalContentId)
void	refresh(com.atlassian.core.bean.EntityObject objectToRefresh)
void	remove(com.atlassian.core.bean.EntityObject object)
void	removeFromPageKeyCache(String spaceKey, String pageTitle) Deprecated.
void	replicate(Object objectToReplicate)
void	save(com.atlassian.core.bean.EntityObject objectToSave)
void	save(com.atlassian.core.bean.EntityObject objectToSave, com.atlassian.core.bean.EntityObject originalObject)
void	saveRaw(com.atlassian.core.bean.EntityObject objectToSave)

Methods inherited from class java.lang.Object

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

Constructor Detail

CachingPageDao

public CachingPageDao(PageDao delegateDao,
                      PageIdCache pageIdCache)

Method Detail

getPage

public Page getPage(Space space,
                    String pageTitle)

Description copied from interface: PageDao

Get the page by space and title.

Specified by:

getPage in interface PageDao

Parameters:

space - The space the page belongs to

pageTitle - The title of the page

Returns:

the page with the given title in the given space, or null if no such page exists

getPageWithComments

public Page getPageWithComments(Space space,
                                String pageTitle)

Description copied from interface: PageDao

Get the page by space and title, and perform an eager load of the comments and their children. This can be used as a performance optimisation when it is known that all comments will be displayed.

Specified by:

getPageWithComments in interface PageDao

Parameters:

space - The space the page belongs to

pageTitle - The title of the page

Returns:

the page with the given title in the given space, or null if no such page exists

removeFromPageKeyCache

@Deprecated
public void removeFromPageKeyCache(String spaceKey,
                                              String pageTitle)

Deprecated.

Specified by:

removeFromPageKeyCache in interface PageDao

remove

public void remove(com.atlassian.core.bean.EntityObject object)

Specified by:

remove in interface ObjectDao

save

public void save(com.atlassian.core.bean.EntityObject objectToSave,
                 com.atlassian.core.bean.EntityObject originalObject)

Specified by:

save in interface VersionedObjectDao

save

public void save(com.atlassian.core.bean.EntityObject objectToSave)

Specified by:

save in interface ObjectDao

saveRaw

public void saveRaw(com.atlassian.core.bean.EntityObject objectToSave)

Specified by:

saveRaw in interface ObjectDao

findAll

public List findAll()

Specified by:

findAll in interface ObjectDao

findAllSorted

public List findAllSorted(String s)

Specified by:

findAllSorted in interface ObjectDao

findLatestVersionsCount

public long findLatestVersionsCount()

Description copied from interface: VersionedObjectDao

Returns the number of results for the latest versions of the current persistent class.

Specified by:

findLatestVersionsCount in interface VersionedObjectDao

Returns:

a long representing the number of results

findLatestVersionsIterator

public Iterator findLatestVersionsIterator()

Description copied from interface: VersionedObjectDao

Returns an iterator for the latest versions of the current persistent class.

Specified by:

findLatestVersionsIterator in interface VersionedObjectDao

Returns:

Iterator

findPagesWithHistoricalTitle

public List findPagesWithHistoricalTitle(String pageTitle)

Specified by:

findPagesWithHistoricalTitle in interface PageDao

findPreviousVersions

public List findPreviousVersions(long originalContentId)

Specified by:

findPreviousVersions in interface ContentEntityObjectDao

findPagesWithHistoricalTitleInPermittedSpace

public List<AbstractPage> findPagesWithHistoricalTitleInPermittedSpace(String pageTitle,
                                                                       Space space,
                                                                       int maxResultCount)

Description copied from interface: PageDao

Searches for pages in the space specified, looking for those that have the given title in a previous version, and returns the first maxResultCount results.

Only pages in spaces the remote user is able to view will be returned.

Specified by:

findPagesWithHistoricalTitleInPermittedSpace in interface PageDao

Parameters:

pageTitle - title of a page in a previous version.

space - Space to search. Must not be null.

maxResultCount - maximum pages to return

findPagesWithHistoricalTitleInAllPermittedSpacesExcept

public List<AbstractPage> findPagesWithHistoricalTitleInAllPermittedSpacesExcept(String pageTitle,
                                                                                 Space space,
                                                                                 int maxResultCount)

Description copied from interface: PageDao

Searches for pages in all spaces except the one specified, looking for those that have the given title in a previous version, and returns the first maxResultCount results.

Only pages in spaces the remote user is able to view will be returned.

Specified by:

findPagesWithHistoricalTitleInAllPermittedSpacesExcept in interface PageDao

Parameters:

pageTitle - title of a page in a previous version.

space - Space to exclude from search. If null, all spaces are searched.

maxResultCount - maximum pages to return

getAllCurrentEntities

public Iterator getAllCurrentEntities()

Specified by:

getAllCurrentEntities in interface ContentEntityObjectDao

getAuthoredPagesCountByUser

public int getAuthoredPagesCountByUser(String username)

Specified by:

getAuthoredPagesCountByUser in interface PageDao

getById

public ContentEntityObject getById(long id)

Specified by:

getById in interface ContentEntityObjectDao

getContentAuthoredByUser

public List getContentAuthoredByUser(String username)

Specified by:

getContentAuthoredByUser in interface ContentEntityObjectDao

getDescendentIds

public List getDescendentIds(Page page)

Specified by:

getDescendentIds in interface PageDao

getDescendents

public List<Page> getDescendents(Page page)

Specified by:

getDescendents in interface PageDao

getFirstVersionAfter

public ContentEntityObject getFirstVersionAfter(long originalVersionContentId,
                                                int version)

Specified by:

getFirstVersionAfter in interface ContentEntityObjectDao

getFirstVersionBefore

public ContentEntityObject getFirstVersionBefore(long originalVersionContentId,
                                                 int version)

Specified by:

getFirstVersionBefore in interface ContentEntityObjectDao

getLockedContentBySpace

public List getLockedContentBySpace(String spaceKey)

Specified by:

getLockedContentBySpace in interface ContentEntityObjectDao

getObjectType

public String getObjectType(long id)

Specified by:

getObjectType in interface ContentEntityObjectDao

getOrphanedPages

public List getOrphanedPages(String spaceKey)

Specified by:

getOrphanedPages in interface PageDao

getPageById

public Page getPageById(long id)

Description copied from interface: PageDao

Get the page with the given id.

Specified by:

getPageById in interface PageDao

Parameters:

id - of the page to load

Returns:

the page with the given id, or null if no such page exists

getPageByIdWithComments

public Page getPageByIdWithComments(long id)

Description copied from interface: PageDao

Get the page with the given id, and perform an eager load of the comments and their children. This can be used as a performance optimisation when it is known that all comments will be displayed.

Specified by:

getPageByIdWithComments in interface PageDao

Parameters:

id - of the page to load

Returns:

the page with the given id, or null if no such page exists

getCommentCountOnPage

public int getCommentCountOnPage(long id)

Description copied from interface: PageDao

Count the number of comments on the passed in page.

Specified by:

getCommentCountOnPage in interface PageDao

Returns:

getPageInTrash

public List getPageInTrash(String spaceKey,
                           String title)

Specified by:

getPageInTrash in interface PageDao

getPages

public List getPages(Space space,
                     boolean currentOnly)

Specified by:

getPages in interface PageDao

getPagesCreatedOrUpdatedSinceDate

public List getPagesCreatedOrUpdatedSinceDate(Date previousLoginDate)

Specified by:

getPagesCreatedOrUpdatedSinceDate in interface PageDao

getPagesStartingWith

public List getPagesStartingWith(Space space,
                                 String s)

Specified by:

getPagesStartingWith in interface PageDao

getPermissionPages

public List getPermissionPages(Space space)

Specified by:

getPermissionPages in interface PageDao

getPersistentClass

public Class getPersistentClass()

Specified by:

getPersistentClass in interface ObjectDao

getRecentlyAddedEntities

public Iterator getRecentlyAddedEntities(String spaceKey,
                                         int maxResults)

Specified by:

getRecentlyAddedEntities in interface ContentEntityObjectDao

getRecentlyAddedPages

public List getRecentlyAddedPages(int maxCount,
                                  String spaceKey)

Specified by:

getRecentlyAddedPages in interface PageDao

getRecentlyAuthoredPagesByUser

public List getRecentlyAuthoredPagesByUser(String username,
                                           int maxCount)

Specified by:

getRecentlyAuthoredPagesByUser in interface PageDao

getRecentlyModifiedEntities

public Iterator getRecentlyModifiedEntities(int maxResults)

Specified by:

getRecentlyModifiedEntities in interface ContentEntityObjectDao

getRecentlyModifiedEntities

public Iterator getRecentlyModifiedEntities(String spaceKey,
                                            int maxResults)

Specified by:

getRecentlyModifiedEntities in interface ContentEntityObjectDao

getRecentlyModifiedEntitiesForUser

public Iterator getRecentlyModifiedEntitiesForUser(String username)

Specified by:

getRecentlyModifiedEntitiesForUser in interface ContentEntityObjectDao

getRecentlyModifiedForChangeDigest

public List getRecentlyModifiedForChangeDigest(Date fromDate)

Description copied from interface: ContentEntityObjectDao

Retrieves a list of ContentEntityObjects that have been newly added or modified since the date specified. This list excludes drafts, space descriptions and mail.

Specified by:

getRecentlyModifiedForChangeDigest in interface ContentEntityObjectDao

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

getRecentlyUpdatedPages

public List getRecentlyUpdatedPages(int maxCount,
                                    String spaceKey)

Specified by:

getRecentlyUpdatedPages in interface PageDao

getTopLevelPages

public List<Page> getTopLevelPages(Space space)

Specified by:

getTopLevelPages in interface PageDao

getTrashedContent

public List getTrashedContent(String spaceKey)

Specified by:

getTrashedContent in interface ContentEntityObjectDao

getUndefinedPages

public List getUndefinedPages(String spaceKey)

Specified by:

getUndefinedPages in interface PageDao

getVersion

public ContentEntityObject getVersion(long originalVersionContentId,
                                      int version)

Specified by:

getVersion in interface ContentEntityObjectDao

getVersionHistorySummary

public List getVersionHistorySummary(long originalContentId)

Specified by:

getVersionHistorySummary in interface ContentEntityObjectDao

refresh

public void refresh(com.atlassian.core.bean.EntityObject objectToRefresh)

Specified by:

refresh in interface ObjectDao

replicate

public void replicate(Object objectToReplicate)

Specified by:

replicate in interface ObjectDao

getPage

@Deprecated
public Page getPage(String spaceKey,
                               String pageTitle,
                               boolean eagerLoadComments)

Deprecated.

Description copied from interface: PageDao

Get the page by space key and title, and perform an eager load of the comments and their children. This can be used as a performance optimisation when it is known that all comments will be displayed.

Specified by:

getPage in interface PageDao

Parameters:

spaceKey - to match with

pageTitle - to match with

eagerLoadComments - true if comments should be loaded eagerly

Returns:

the page

getPage

@Deprecated
public Page getPage(String spaceKey,
                               String pageTitle)

Deprecated.

Specified by:

getPage in interface PageDao

getLastEditedVersionsOf

public List<ContentEntityObject> getLastEditedVersionsOf(ContentEntityObject content)

Description copied from interface: ContentEntityObjectDao

Retrieves all the last edited versions for each user who has contributed to the specified piece of content. That is, if a user has contributed multiple edits, only the version that corresponds to their latest edit will be added to the list returned. Result will be sorted with the earliest version coming first.

Specified by:

getLastEditedVersionsOf in interface ContentEntityObjectDao

Parameters:

content - content (must be the latest version)

Returns:

the last edited versions for each user who has contributed to the specified piece of content.