@Immutable @PublicApi public class

ChangeHistoryItem

extends Object
implements Comparable<T>
java.lang.Object
   ↳ com.atlassian.jira.issue.changehistory.ChangeHistoryItem

@PublicApi

This class is designed for plugins to consume (call its methods).

Clients of @PublicApi can expect that programs compiled against a given version will remain binary compatible with later versions of the @PublicApi as per each product's API policy as long as the client does not implement/extend @PublicApi interfaces or classes (refer to each product's API policy for the exact guarantee---usually binary compatibility is guaranteed at least across minor versions).

Note: since @PublicApi interfaces and classes are not designed to be implemented or extended by clients, we may perform certain types of binary-incompatible changes to these classes and interfaces, but these will not affect well-behaved clients that do not extend/implement these types (in general, only classes and interfaces annotated with @PublicSpi are safe to extend/implement).

Class Overview

A simple holder for change items

In 4.4 the behaviour of this domain object was changed to add support for changes that can can have multi value states for instance an affectedVersion could change from the state "4.4 4.4.1" -> "4.4 4.4.1 4.4.2" To this end end extra methods are added getFroms(), getTos() that return a map of all the changes in a single change item getFrom and getTo will return the first change in this list, this will not break behaviour for any of the supported single value fields. For Versions and other multi value fields the behaviour of getFrom(), getTo(), getFromValue() and get ToValue() will return only the first change in the map. It is preferred to use getFroms and getTos in this case. getFrom(), getTo(), getFromValue() and getToValue() are therefore all marked as deprecated and may be removed in future versions.

Summary

Nested Classes
class ChangeHistoryItem.Builder  
Public Constructors
ChangeHistoryItem(Long id, Long changeGroupId, Long projectId, Long issueId, String issueKey, String field, Timestamp created, String from, String to, String fromValue, String toValue, String userKey)
ChangeHistoryItem(Long id, Long changeGroupId, Long projectId, Long issueId, String issueKey, String field, Timestamp created, Timestamp nextChange, String from, String to, String fromValue, String toValue, String userKey)
Public Methods
int compareTo(ChangeHistoryItem other)
boolean containsFromValue(String fromValue)
boolean containsToValue(String toValue)
boolean equals(Object o)
Long getChangeGroupId()
Timestamp getCreated()
Long getDuration()
String getField()
@Deprecated String getFrom()
This method is deprecated. As of 4.4.2, prefer to use getFroms()
@Deprecated String getFromValue()
This method is deprecated. As of 4.4.2, prefer to use getFroms()
Map<StringString> getFroms()
Long getId()
Long getIssueId()
String getIssueKey()
Timestamp getNextChangeCreated()
Long getProjectId()
@Deprecated String getTo()
This method is deprecated. As of 4.4.2, prefer to use getTos()}
@Deprecated String getToValue()
This method is deprecated. As of 4.4.2, prefer to use getTos()
Map<StringString> getTos()
@Deprecated String getUser()
This method is deprecated. Use getUserKey() instead (for clarity only). Since v6.0.
String getUserKey()
int hashCode()
[Expand]
Inherited Methods
From class java.lang.Object
From interface java.lang.Comparable

Public Constructors

public ChangeHistoryItem (Long id, Long changeGroupId, Long projectId, Long issueId, String issueKey, String field, Timestamp created, String from, String to, String fromValue, String toValue, String userKey)

public ChangeHistoryItem (Long id, Long changeGroupId, Long projectId, Long issueId, String issueKey, String field, Timestamp created, Timestamp nextChange, String from, String to, String fromValue, String toValue, String userKey)

Public Methods

public int compareTo (ChangeHistoryItem other)

public boolean containsFromValue (String fromValue)

public boolean containsToValue (String toValue)

public boolean equals (Object o)

public Long getChangeGroupId ()

public Timestamp getCreated ()

public Long getDuration ()

public String getField ()

@Deprecated public String getFrom ()

This method is deprecated.
As of 4.4.2, prefer to use getFroms()

@Deprecated public String getFromValue ()

This method is deprecated.
As of 4.4.2, prefer to use getFroms()

public Map<StringString> getFroms ()

public Long getId ()

public Long getIssueId ()

public String getIssueKey ()

public Timestamp getNextChangeCreated ()

public Long getProjectId ()

@Deprecated public String getTo ()

This method is deprecated.
As of 4.4.2, prefer to use getTos()}

@Deprecated public String getToValue ()

This method is deprecated.
As of 4.4.2, prefer to use getTos()

public Map<StringString> getTos ()

@Deprecated public String getUser ()

This method is deprecated.
Use getUserKey() instead (for clarity only). Since v6.0.

Note: This is the user's key, which since 6.0 may not necessarily be the same as the username.

public String getUserKey ()

public int hashCode ()