Package com.atlassian.confluence.core.persistence.hibernate

Class CachingVersionHistoryDao

java.lang.Object

com.atlassian.confluence.internal.persistence.DelegatingObjectDaoInternal<VersionHistory>

com.atlassian.confluence.core.persistence.hibernate.CachingVersionHistoryDao

All Implemented Interfaces:

ObjectDao, VersionHistoryDao, ObjectDaoInternal<VersionHistory>, VersionHistoryDaoInternal

public class CachingVersionHistoryDao
extends DelegatingObjectDaoInternal<VersionHistory>
implements VersionHistoryDaoInternal

A cache decorator around VersionHistoryDaoInternal

Since:

7.14

Field Summary

Fields inherited from interface com.atlassian.confluence.core.persistence.VersionHistoryDao

UNKNOWN_BUILD_NUMBER

Constructor Summary

Constructors

Constructor	Description
CachingVersionHistoryDao(VersionHistoryDaoInternal delegate, com.atlassian.cache.CacheFactory cacheFactory, SynchronizationManager synchronizationManager)

Method Summary

Modifier and Type	Method	Description
void	addBuildToHistory(int buildNumber)	The version history consists of a list of builds that Confluence has been successfully upgraded to
void	finalizeBuild(int buildNumber)	Record the provided build number as finalized.
int	getFinalizedBuildNumber()	Obtains the latest build number to have been finalized using VersionHistoryDao.finalizeBuild(int).
List<VersionHistory>	getFullUpgradeHistory()
int	getLatestBuildNumber()	Get the highest build number from the database.
VersionHistory	getVersionHistory(int buildNumber)
boolean	tagBuild(int buildNumber, String tag)	Associates a tag with a build number

Methods inherited from class com.atlassian.confluence.internal.persistence.DelegatingObjectDaoInternal

findAll, findAllSorted, findAllSorted, findByClassIds, findByClassIdsFiltered, getPersistentClass, refresh, refreshEntity, remove, removeEntity, replicate, replicateEntity, save, saveEntity, saveRaw, saveRawEntity

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.confluence.internal.persistence.ObjectDaoInternal

findAll, findAllSorted, findAllSorted, findByClassIds, findByClassIdsFiltered, getPersistentClass, refresh, refreshEntity, remove, removeEntity, replicate, replicateEntity, save, saveEntity, saveRaw, saveRawEntity

Methods inherited from interface com.atlassian.confluence.internal.persistence.VersionHistoryDaoInternal

getUpgradeHistory

Constructor Detail

CachingVersionHistoryDao

public CachingVersionHistoryDao(VersionHistoryDaoInternal delegate,
                                com.atlassian.cache.CacheFactory cacheFactory,
                                SynchronizationManager synchronizationManager)

Method Detail

getLatestBuildNumber

public int getLatestBuildNumber()

Description copied from interface: VersionHistoryDao

Get the highest build number from the database. This should represent what version the database thinks Confluence is running at, which in turn is used to schedule database-hitting upgrade tasks.

If the number can not be determined (there are no versions in the database, or the version history table hasn't even been created yet) then the method will return UNKNOWN_BUILD_NUMBER. In this case, callers should assume that the database build number is identical to the configured build number.

Specified by:

getLatestBuildNumber in interface VersionHistoryDao

Returns:

the highest build number in version history table, or UNKNOWN_BUILD_NUMBER if that can not be determined.

addBuildToHistory

public void addBuildToHistory(int buildNumber)

Description copied from interface: VersionHistoryDao

The version history consists of a list of builds that Confluence has been successfully upgraded to

Specified by:

addBuildToHistory in interface VersionHistoryDao

getVersionHistory

public VersionHistory getVersionHistory(int buildNumber)

Specified by:

getVersionHistory in interface VersionHistoryDao

Returns:

the version history object associated with the build number (if there is more than one, return the latest)

tagBuild

public boolean tagBuild(int buildNumber,
                        String tag)

Description copied from interface: VersionHistoryDao

Associates a tag with a build number

Specified by:

tagBuild in interface VersionHistoryDao

Returns:

true if the build number was successfully tagged, false if the tag specified has already been associated with this build number

getFullUpgradeHistory

public List<VersionHistory> getFullUpgradeHistory()

Specified by:

getFullUpgradeHistory in interface VersionHistoryDaoInternal

getFinalizedBuildNumber

public int getFinalizedBuildNumber()

Description copied from interface: VersionHistoryDao

Obtains the latest build number to have been finalized using VersionHistoryDao.finalizeBuild(int).

Specified by:

getFinalizedBuildNumber in interface VersionHistoryDao

Returns:

latest build number that has been finalized

finalizeBuild

public void finalizeBuild(int buildNumber)

Description copied from interface: VersionHistoryDao

Record the provided build number as finalized. This occurs when a cluster exists ZDU mode at the end of an upgrade, or is upgraded without ZDU mode.

Specified by:

finalizeBuild in interface VersionHistoryDao