com.atlassian.jira.issue.changehistory
Class DefaultChangeHistoryManager

java.lang.Object
  com.atlassian.jira.issue.changehistory.DefaultChangeHistoryManager

All Implemented Interfaces:

ChangeHistoryManager

public class DefaultChangeHistoryManager
extends Object
implements ChangeHistoryManager

Constructor Summary

DefaultChangeHistoryManager(IssueManager issueManager, OfBizDelegator ofBizDelegator)

Method Summary

Issue	findMovedIssue(String originalKey) Returns an issue that has been moved by searching the change history of the original issue key for an updated issue key.
List	getChangeHistoriesForUser(Issue issue, User remoteUser) Returns a List of GenericValue ChangeGroup entities for the given issue.
List	getChangeItemsForField(Issue issue, String changeItemFieldName) Returns a List of ChangeItemBean's for the given issue which also are for the provided changeItemFieldName (i.e.
Collection	getPreviousIssueKeys(Long issueId) Returns the same as ChangeHistoryManager.getPreviousIssueKeys(String) but is slightly more efficient since no lookup of the issue id needs to be performed.
Collection	getPreviousIssueKeys(String issueKey) Given an issue key, this method returns a list of previous issue keys this issue was moved from.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultChangeHistoryManager

public DefaultChangeHistoryManager(IssueManager issueManager,
                                   OfBizDelegator ofBizDelegator)

Method Detail

getChangeHistoriesForUser

public List getChangeHistoriesForUser(Issue issue,
                                      User remoteUser)

Description copied from interface: ChangeHistoryManager

Returns a List of GenericValue ChangeGroup entities for the given issue.

Specified by:

getChangeHistoriesForUser in interface ChangeHistoryManager

Parameters:

issue - the issue.

remoteUser - the user who is asking.

Returns:

a List of GenericValue ChangeGroup entities.

getChangeItemsForField

public List getChangeItemsForField(Issue issue,
                                   String changeItemFieldName)

Description copied from interface: ChangeHistoryManager

Returns a List of ChangeItemBean's for the given issue which also are for the provided changeItemFieldName (i.e. Link, Fix Version/s, etc). The order of the list will from oldest to newest.

Specified by:

getChangeItemsForField in interface ChangeHistoryManager

Parameters:

issue - the issue the change items are associated with, not null.

changeItemFieldName - the field name the change item is stored under, not null or empty.

Returns:

a List of ChangeItemBean's for the given issue.

findMovedIssue

public Issue findMovedIssue(String originalKey)
                     throws org.ofbiz.core.entity.GenericEntityException

Description copied from interface: ChangeHistoryManager

Returns an issue that has been moved by searching the change history of the original issue key for an updated issue key.

Specified by:

findMovedIssue in interface ChangeHistoryManager

Parameters:

originalKey - the original key of an issue that has since been moved (moving between projects assigns a new key to an issue)

Returns:

the moved Issue object

Throws:

org.ofbiz.core.entity.GenericEntityException - if an unexpected error occurs

getPreviousIssueKeys

public Collection getPreviousIssueKeys(Long issueId)

Description copied from interface: ChangeHistoryManager

Returns the same as ChangeHistoryManager.getPreviousIssueKeys(String) but is slightly more efficient since no lookup of the issue id needs to be performed. If you have an issue object available with the issue's id use this method.

Specified by:

getPreviousIssueKeys in interface ChangeHistoryManager

Parameters:

issueId - The id of the issue being looked up.

Returns:

A collection of previous issue keys or an empty list if none exist.

getPreviousIssueKeys

public Collection getPreviousIssueKeys(String issueKey)

Description copied from interface: ChangeHistoryManager

Given an issue key, this method returns a list of previous issue keys this issue was moved from. This may be useful for source control plugins for example, where a given changeset should be displayed even after an issue has been moved and it's issue key has changed.

The list of previous issue keys is returned in chronological order, with the most recent issue key first.

Specified by:

getPreviousIssueKeys in interface ChangeHistoryManager

Parameters:

issueKey - The current issue key.

Returns:

A collection of previous issue keys or an empty list if none exist.