com.atlassian.jira.rest.client.domain
Class Issue

java.lang.Object
  com.atlassian.jira.rest.client.domain.BasicIssue
      com.atlassian.jira.rest.client.domain.Issue

All Implemented Interfaces:

AddressableEntity, ExpandableResource

public class Issue
extends BasicIssue
implements ExpandableResource

Single JIRA issue

Since:

v0.1

Constructor Summary

Issue(String summary, URI self, String key, BasicProject project, BasicIssueType issueType, BasicStatus status, String description, BasicPriority priority, BasicResolution resolution, Collection<Attachment> attachments, BasicUser reporter, BasicUser assignee, org.joda.time.DateTime creationDate, org.joda.time.DateTime updateDate, org.joda.time.DateTime dueDate, Collection<Version> affectedVersions, Collection<Version> fixVersions, Collection<BasicComponent> components, TimeTracking timeTracking, Collection<Field> fields, Collection<Comment> comments, URI transitionsUri, Collection<IssueLink> issueLinks, BasicVotes votes, Collection<Worklog> worklogs, BasicWatchers watchers, Iterable<String> expandos, Collection<Subtask> subtasks, Collection<ChangelogGroup> changelog, Set<String> labels)

Method Summary

Iterable<Version>	getAffectedVersions()
BasicUser	getAssignee()
Iterable<Attachment>	getAttachments()
URI	getAttachmentsUri()
Iterable<ChangelogGroup>	getChangelog() Returns changelog available for issues retrieved with CHANGELOG expanded.
Iterable<Comment>	getComments()
URI	getCommentsUri()
Iterable<BasicComponent>	getComponents()
org.joda.time.DateTime	getCreationDate()
String	getDescription()
org.joda.time.DateTime	getDueDate()
Iterable<String>	getExpandos()
Field	getField(String id)
Field	getFieldByName(String name) This method returns the first field with specified name.
Iterable<Field>	getFields()
Iterable<Version>	getFixVersions()
Iterable<IssueLink>	getIssueLinks()
BasicIssueType	getIssueType()
Set<String>	getLabels()
BasicPriority	getPriority()
BasicProject	getProject()
BasicUser	getReporter()
BasicResolution	getResolution()
BasicStatus	getStatus()
Iterable<Subtask>	getSubtasks()
String	getSummary()
TimeTracking	getTimeTracking()
URI	getTransitionsUri()
org.joda.time.DateTime	getUpdateDate()
BasicVotes	getVotes()
URI	getVotesUri()
BasicWatchers	getWatchers()
Iterable<Worklog>	getWorklogs()
URI	getWorklogUri()
String	toString()

Methods inherited from class com.atlassian.jira.rest.client.domain.BasicIssue

equals, getKey, getSelf, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Issue

public Issue(String summary,
             URI self,
             String key,
             BasicProject project,
             BasicIssueType issueType,
             BasicStatus status,
             String description,
             @Nullable
             BasicPriority priority,
             @Nullable
             BasicResolution resolution,
             Collection<Attachment> attachments,
             @Nullable
             BasicUser reporter,
             @Nullable
             BasicUser assignee,
             org.joda.time.DateTime creationDate,
             org.joda.time.DateTime updateDate,
             org.joda.time.DateTime dueDate,
             Collection<Version> affectedVersions,
             Collection<Version> fixVersions,
             Collection<BasicComponent> components,
             @Nullable
             TimeTracking timeTracking,
             Collection<Field> fields,
             Collection<Comment> comments,
             @Nullable
             URI transitionsUri,
             @Nullable
             Collection<IssueLink> issueLinks,
             BasicVotes votes,
             Collection<Worklog> worklogs,
             BasicWatchers watchers,
             Iterable<String> expandos,
             @Nullable
             Collection<Subtask> subtasks,
             @Nullable
             Collection<ChangelogGroup> changelog,
             Set<String> labels)

Method Detail

getStatus

public BasicStatus getStatus()

getReporter

@Nullable
public BasicUser getReporter()

Returns:

reporter of this issue or null if this issue has no reporter

getAssignee

@Nullable
public BasicUser getAssignee()

Returns:

assignee of this issue or null if this issue is unassigned.

getSummary

public String getSummary()

getPriority

@Nullable
public BasicPriority getPriority()

Returns:

priority of this issue

getIssueLinks

@Nullable
public Iterable<IssueLink> getIssueLinks()

Returns:

issue links for this issue (possibly nothing) or null when issue links are deactivated for this JIRA instance

getSubtasks

@Nullable
public Iterable<Subtask> getSubtasks()

getFields

public Iterable<Field> getFields()

Returns:

fields inaccessible by concrete getter methods (e.g. all custom fields)

getField

@Nullable
public Field getField(String id)

Parameters:

id - identifier of the field (inaccessible by concrete getter method)

Returns:

field with given id, or null when no field with given id exists for this issue

getFieldByName

@Nullable
public Field getFieldByName(String name)

This method returns the first field with specified name. Names of fields in JIRA do not need to be unique. Therefore this method does not guarantee that you will get what you really want. It's added just for convenience. For identify fields you should use id rather than name.

Parameters:

name - name of the field.

Returns:

the first field matching selected name or null when no field with given name exists for this issue

getExpandos

public Iterable<String> getExpandos()

Specified by:

getExpandos in interface ExpandableResource

getIssueType

public BasicIssueType getIssueType()

Returns:

issue type

getAttachments

public Iterable<Attachment> getAttachments()

Returns:

attachments of this issue

getAttachmentsUri

public URI getAttachmentsUri()

getWorklogUri

public URI getWorklogUri()

getComments

public Iterable<Comment> getComments()

Returns:

comments for this issue

getCommentsUri

public URI getCommentsUri()

getProject

public BasicProject getProject()

Returns:

project this issue belongs to

getVotes

@Nullable
public BasicVotes getVotes()

Returns:

null

getWorklogs

public Iterable<Worklog> getWorklogs()

getWatchers

@Nullable
public BasicWatchers getWatchers()

Returns:

null when watching is disabled in JIRA

getFixVersions

@Nullable
public Iterable<Version> getFixVersions()

getTransitionsUri

@Nullable
public URI getTransitionsUri()

getAffectedVersions

@Nullable
public Iterable<Version> getAffectedVersions()

getComponents

public Iterable<BasicComponent> getComponents()

getLabels

public Set<String> getLabels()

getChangelog

@Nullable
public Iterable<ChangelogGroup> getChangelog()

Returns changelog available for issues retrieved with CHANGELOG expanded.

Returns:

issue changelog or null if CHANGELOG has not been expanded or REST API on the server side does not serve this information (pre-5.0)

Since:

client 0.6, server 5.0

See Also:

IssueRestClient.getIssue(String, Iterable, com.atlassian.jira.rest.client.ProgressMonitor)

getVotesUri

public URI getVotesUri()

getResolution

@Nullable
public BasicResolution getResolution()

getCreationDate

public org.joda.time.DateTime getCreationDate()

getUpdateDate

public org.joda.time.DateTime getUpdateDate()

getDueDate

public org.joda.time.DateTime getDueDate()

getTimeTracking

@Nullable
public TimeTracking getTimeTracking()

getDescription

@Nullable
public String getDescription()

toString

public String toString()

Overrides:

toString in class BasicIssue