com.atlassian.jira.issue.history

Class ChangeLogUtils

java.lang.Object

com.atlassian.jira.issue.history.ChangeLogUtils

public class ChangeLogUtils
extends Object

Utility methods for managing ChangeGroup entities on issues, also known as the Change Log or Change History.

TODO: Migrate methods to ChangeHistoryManager and deprecate

Constructor Summary

Constructors

Constructor and Description
ChangeLogUtils()

Method Summary

Modifier and Type	Method and Description
static org.ofbiz.core.entity.GenericValue	createChangeGroup(ApplicationUser changeAuthor, org.ofbiz.core.entity.GenericValue before, org.ofbiz.core.entity.GenericValue after, Collection<ChangeItemBean> incomingChangeItems, boolean generateChangeItems) Writes the given field changes to the db and optionally a changelog.
static org.ofbiz.core.entity.GenericValue	createChangeGroup(ApplicationUser changeAuthor, Issue before, Issue after, Collection<ChangeItemBean> incomingChangeItems, boolean generateChangeItems) Deprecated. Use createChangeGroup(com.atlassian.jira.user.ApplicationUser, org.ofbiz.core.entity.GenericValue, org.ofbiz.core.entity.GenericValue, java.util.Collection, boolean) instead. Since v6.0.
static void	deleteChangesForIssue(org.ofbiz.core.entity.GenericValue issue) Deprecated. use ChangeHistoryManager.removeAllChangeItems(com.atlassian.jira.issue.Issue) instead.
static ChangeItemBean	generateChangeItem(org.ofbiz.core.entity.GenericValue before, org.ofbiz.core.entity.GenericValue after, String fieldname)
static List<ChangeItemBean>	generateChangeItems(org.ofbiz.core.entity.GenericValue before, org.ofbiz.core.entity.GenericValue after) Returns a List of ChangeItemBean objects for each of the relevant fields that differ between the two issues.
static ChangeItemBean	generateSecurityChangeItem(String fieldname, String from, String to)

Methods inherited from class java.lang.Object

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

Constructor Detail

ChangeLogUtils

public ChangeLogUtils()

Method Detail

deleteChangesForIssue

@Deprecated
public static void deleteChangesForIssue(org.ofbiz.core.entity.GenericValue issue)

Deprecated. use ChangeHistoryManager.removeAllChangeItems(com.atlassian.jira.issue.Issue) instead.

Deletes all the change groups and change items associated with the provided issue.

Parameters:

issue - represents the issue that is being deleted

createChangeGroup

public static org.ofbiz.core.entity.GenericValue createChangeGroup(ApplicationUser changeAuthor,
                                                                   org.ofbiz.core.entity.GenericValue before,
                                                                   org.ofbiz.core.entity.GenericValue after,
                                                                   Collection<ChangeItemBean> incomingChangeItems,
                                                                   boolean generateChangeItems)

Writes the given field changes to the db and optionally a changelog.

Parameters:

before - The issue before the update.

after - This issue after the update.

incomingChangeItems - Some ChangeItemBean.

generateChangeItems - if true, a changelog is actually generated.

changeAuthor - the ApplicationUser making the change.

Returns:

the ChangeGroup GenericValue

createChangeGroup

public static org.ofbiz.core.entity.GenericValue createChangeGroup(ApplicationUser changeAuthor,
                                                                   Issue before,
                                                                   Issue after,
                                                                   Collection<ChangeItemBean> incomingChangeItems,
                                                                   boolean generateChangeItems)

Deprecated. Use createChangeGroup(com.atlassian.jira.user.ApplicationUser, org.ofbiz.core.entity.GenericValue, org.ofbiz.core.entity.GenericValue, java.util.Collection, boolean) instead. Since v6.0.

Parameters:

before - The issue before the update.

after - This issue after the update.

incomingChangeItems - Some ChangeItemBean.

generateChangeItems - if true, a changelog is actually generated.

changeAuthor - the User making the change.

Returns:

the ChangeGroup GenericValue

generateChangeItems

public static List<ChangeItemBean> generateChangeItems(org.ofbiz.core.entity.GenericValue before,
                                                       org.ofbiz.core.entity.GenericValue after)

Returns a List of ChangeItemBean objects for each of the relevant fields that differ between the two issues.

Parameters:

before - A GenericValue for the issue before the change.

after - A GenericValue for the issue after the change.

Returns:

the list of ChangeItemBeans.

generateChangeItem

public static ChangeItemBean generateChangeItem(org.ofbiz.core.entity.GenericValue before,
                                                org.ofbiz.core.entity.GenericValue after,
                                                String fieldname)

generateSecurityChangeItem

public static ChangeItemBean generateSecurityChangeItem(String fieldname,
                                                        String from,
                                                        String to)