com.atlassian.jira.versioning

Class NoOpEntityVersioningManager

java.lang.Object

com.atlassian.jira.versioning.NoOpEntityVersioningManager

All Implemented Interfaces:

EntityVersioningManager

public class NoOpEntityVersioningManager
extends Object
implements EntityVersioningManager

Constructor Summary

Constructors

Constructor and Description
NoOpEntityVersioningManager()

Method Summary

Modifier and Type	Method and Description
long	cleanAllDeletedEntityVersionsOlderThan(java.time.Duration duration) Removes all entity version records (issues, comments, & worklogs) for entites marked as deleted and older than duration.
void	cleanDeletedIssueVersion(long issueId) Remove a deleted issue and its all related comments and worklogs.
Optional<Long>	getCommentVersion(long commentId) Return the comment version for the comment identified by commentId or Optional.empty() if there is no version.
Optional<Long>	getIssueVersion(long issueId) Return the issue version for the issue identified by issueId or Optional.empty() if there is no version.
Map<Long,Long>	getRelatedCommentVersions(long parentIssueId) Return the comment versions for for all comments associated with the specified parentIssueId.
Map<Long,Long>	getRelatedWorklogVersions(long parentIssueId) Return the worklog versions for for all worklogs associated with the specified parentIssueId.
Optional<Long>	getWorklogVersion(long worklogId) Return the worklog version for the worklog identified by worklogId or Optional.empty() if there is no version.
void	incrementCommentVersion(long commentId, long parentIssueId) Increments the version number for the specified comment.
void	incrementIssueVersion(long issueId) Increments the version number for the specified issue.
void	incrementRelatedCommentVersions(long issueId) Bumps the versions for all comments associated with the specified parentIssueId.
void	incrementRelatedWorklogVersions(long issueId) Bumps the versions for all worklogs associated with the specified parentIssueId.
void	incrementWorklogVersion(long worklogId, long parentIssueId) Increments the version number for the specified worklog.
void	markCommentDeletedAndIncrementVersion(long commentId) Marks the specified comment as deleted and bumps its version by 1.
void	markEntityDeletedAndIncrementVersion(long entityId, AffectedIndex indexName) Convenience method for marking entity as deleted and incrementing its version basing on AffectedIndex.
void	markIssueDeletedAndIncrementVersion(long issueId) Marks the specified issue and all its related comments and worklogs as deleted bumps their versions by 1.
void	markWorklogDeletedAndIncrementVersion(long worklogId) Marks the specified worklog as deleted and bumps its version by 1.

Methods inherited from class java.lang.Object

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

Constructor Detail

NoOpEntityVersioningManager

public NoOpEntityVersioningManager()

Method Detail

incrementIssueVersion

public void incrementIssueVersion(long issueId)

Description copied from interface: EntityVersioningManager

Increments the version number for the specified issue. If a version number doesn't exist, one is created.

Specified by:

incrementIssueVersion in interface EntityVersioningManager

Parameters:

issueId - identifier for the issue whose version should be bumped

incrementCommentVersion

public void incrementCommentVersion(long commentId,
                                    long parentIssueId)

Description copied from interface: EntityVersioningManager

Increments the version number for the specified comment. If a version number doesn't exist, one is created.

Specified by:

incrementCommentVersion in interface EntityVersioningManager

Parameters:

commentId - identifier for the comment whose version should be bumped

parentIssueId - identifier for the Issue that the comment belongs to

incrementWorklogVersion

public void incrementWorklogVersion(long worklogId,
                                    long parentIssueId)

Description copied from interface: EntityVersioningManager

Increments the version number for the specified worklog. If a version number doesn't exist, one is created.

Specified by:

incrementWorklogVersion in interface EntityVersioningManager

Parameters:

worklogId - identifier for the worklog whose version should be bumped

parentIssueId - identifier for the Issue that the worklog belongs to

markIssueDeletedAndIncrementVersion

public void markIssueDeletedAndIncrementVersion(long issueId)

Description copied from interface: EntityVersioningManager

Marks the specified issue and all its related comments and worklogs as deleted bumps their versions by 1.

Specified by:

markIssueDeletedAndIncrementVersion in interface EntityVersioningManager

Parameters:

issueId - identifier for issue and all its related comments and worklogs to mark as deleted & whose version number to bump

markCommentDeletedAndIncrementVersion

public void markCommentDeletedAndIncrementVersion(long commentId)

Description copied from interface: EntityVersioningManager

Marks the specified comment as deleted and bumps its version by 1.

Specified by:

markCommentDeletedAndIncrementVersion in interface EntityVersioningManager

Parameters:

commentId - identifier for comment to mark as deleted & whose version number to bump

markWorklogDeletedAndIncrementVersion

public void markWorklogDeletedAndIncrementVersion(long worklogId)

Description copied from interface: EntityVersioningManager

Marks the specified worklog as deleted and bumps its version by 1.

Specified by:

markWorklogDeletedAndIncrementVersion in interface EntityVersioningManager

Parameters:

worklogId - identifier for worklog to mark as deleted & whose version number to bump

getIssueVersion

public Optional<Long> getIssueVersion(long issueId)

Description copied from interface: EntityVersioningManager

Return the issue version for the issue identified by issueId or Optional.empty() if there is no version.

Specified by:

getIssueVersion in interface EntityVersioningManager

Parameters:

issueId - identifies the issue whose current version will be retrieved

Returns:

An optional containing the current version for the specified issue; an empty optional if no version is found.

getCommentVersion

public Optional<Long> getCommentVersion(long commentId)

Description copied from interface: EntityVersioningManager

Return the comment version for the comment identified by commentId or Optional.empty() if there is no version.

Specified by:

getCommentVersion in interface EntityVersioningManager

Parameters:

commentId - identifies the comment whose current version will be retrieved

Returns:

An optional containing the current version for the specified comment; an empty optional if no version is found.

getWorklogVersion

public Optional<Long> getWorklogVersion(long worklogId)

Description copied from interface: EntityVersioningManager

Return the worklog version for the worklog identified by worklogId or Optional.empty() if there is no version.

Specified by:

getWorklogVersion in interface EntityVersioningManager

Parameters:

worklogId - identifies the worklog whose current version will be retrieved

Returns:

An optional containing the current version for the specified worklog; an empty optional if no version is found.

getRelatedCommentVersions

public Map<Long,Long> getRelatedCommentVersions(long parentIssueId)

Description copied from interface: EntityVersioningManager

Return the comment versions for for all comments associated with the specified parentIssueId.

Specified by:

getRelatedCommentVersions in interface EntityVersioningManager

Parameters:

parentIssueId - identifier for the Issue whose comments will be retrieved

Returns:

A map from commentId to comment version; an empty map if no version is found (because no version exists/no comment exists/issue doesn't exist).

getRelatedWorklogVersions

public Map<Long,Long> getRelatedWorklogVersions(long parentIssueId)

Description copied from interface: EntityVersioningManager

Return the worklog versions for for all worklogs associated with the specified parentIssueId.

Specified by:

getRelatedWorklogVersions in interface EntityVersioningManager

Parameters:

parentIssueId - identifier for the Issue whose worklogs will be retrieved

Returns:

A map from worklogId to worklog version; an empty map if no version is found (because no version exists/no worklog exists/issue doesn't exist).

markEntityDeletedAndIncrementVersion

public void markEntityDeletedAndIncrementVersion(long entityId,
                                                 AffectedIndex indexName)

Description copied from interface: EntityVersioningManager

Convenience method for marking entity as deleted and incrementing its version basing on AffectedIndex.

Specified by:

markEntityDeletedAndIncrementVersion in interface EntityVersioningManager

Parameters:

entityId - - id of entity to be processed

indexName - - which index entity to be processed belongs to

cleanDeletedIssueVersion

public void cleanDeletedIssueVersion(long issueId)

Description copied from interface: EntityVersioningManager

Remove a deleted issue and its all related comments and worklogs.

Specified by:

cleanDeletedIssueVersion in interface EntityVersioningManager

Parameters:

issueId - identifies the deleted issue

cleanAllDeletedEntityVersionsOlderThan

public long cleanAllDeletedEntityVersionsOlderThan(java.time.Duration duration)

Description copied from interface: EntityVersioningManager

Removes all entity version records (issues, comments, & worklogs) for entites marked as deleted and older than duration.

Specified by:

cleanAllDeletedEntityVersionsOlderThan in interface EntityVersioningManager

Parameters:

duration - threshold for deletion; entries marked as deleted and older than this will be removed.

Returns:

the number of entity version entries that were removed

incrementRelatedCommentVersions

public void incrementRelatedCommentVersions(long issueId)

Description copied from interface: EntityVersioningManager

Bumps the versions for all comments associated with the specified parentIssueId. If there isn't a version record associated with a given comment, it will be added.

Specified by:

incrementRelatedCommentVersions in interface EntityVersioningManager

Parameters:

issueId - identifier for the Issue whose comments will be bumped.

incrementRelatedWorklogVersions

public void incrementRelatedWorklogVersions(long issueId)

Description copied from interface: EntityVersioningManager

Bumps the versions for all worklogs associated with the specified parentIssueId. If there isn't a version record associated with a given worklog, it will be added.

Specified by:

incrementRelatedWorklogVersions in interface EntityVersioningManager

Parameters:

issueId - identifier for the Issue whose worklogs will be bumped.