com.atlassian.jira.mail
Class TemplateIssue

java.lang.Object
  com.atlassian.jira.mail.TemplateIssue

All Implemented Interfaces:

IssueContext, Issue, OfBizValueWrapper

public class TemplateIssue
extends Object
implements Issue

Decorator for the Issue Object.

This class will ensure backwards compatibility for templates accessing the issue object. This class also includes helper methods for retrieving rendered fields (e.g. description, environment) and nicely formatted date fields (e.g. Original Time Estimate, Time Spent, etc.).

This object is passed to the template through the TemplateContext for the velocity email templates

Constructor Summary

TemplateIssue(Issue issue, FieldLayoutManager fieldLayoutManager, RendererManager rendererManager, CustomFieldManager customFieldManager, JiraDurationUtils jiraDurationUtils, AggregateTimeTrackingCalculatorFactory aggregateTimeTrackingCalculatorFactory)

Method Summary

Collection<Version>	getAffectedVersions()
Long	getAggregateOriginalEstimate()
Long	getAggregateRemainingEstimate()
Long	getAggregateTimeSpent()
com.atlassian.crowd.embedded.api.User	getAssignee() Returns the Assignee User.
String	getAssigneeId()
com.atlassian.crowd.embedded.api.User	getAssigneeUser() Returns the Assignee User.
Collection<Attachment>	getAttachments()
Collection<ProjectComponent>	getComponentObjects()
Collection<org.ofbiz.core.entity.GenericValue>	getComponents()
Timestamp	getCreated()
CustomField	getCustomField(String id)
Object	getCustomFieldValue(CustomField customField)
Object	getCustomFieldValue(String id) Get value for a custom field.
String	getDescription() Retrieve the description of the issue.
Timestamp	getDueDate()
String	getEnvironment() Retrieve the environment of the issue.
Long	getEstimate() This is the "remaining estimate" of work left to be performed on this issue, in milliseconds.
Object	getExternalFieldValue(String fieldId)
Collection<Version>	getFixVersions()
org.ofbiz.core.entity.GenericValue	getGenericValue() Get the backing GenericValue object.
String	getHtmlDescription() Retrieves the html formatted description.
String	getHtmlEnvironment() Retrieves the html formatted environment.
Long	getId()
IssueRenderContext	getIssueRenderContext()
org.ofbiz.core.entity.GenericValue	getIssueType() Gets the IssueType for this Issue.
IssueType	getIssueTypeObject() Gets the IssueType for this Issue.
String	getKey()
Set<Label>	getLabels() Returns a set of all the labels for this issue or an empty set if none exist yet.
Long	getLong(String name) Retrieve a numeric field.
String	getNiceTimeAggregateOriginalEstimate(I18nHelper i18n) Return a formatted time string of the aggregate original time estimate.
String	getNiceTimeAggregateRemainingEstimate(I18nHelper i18n) Return a formatted time string of the aggregate time estimate.
String	getNiceTimeAggregateTimeSpent(I18nHelper i18n) Return a formatted time string of the aggregate time spent.
String	getNiceTimeEstimate(I18nHelper i18n) Return a formatted time string of the time estimate.
String	getNiceTimeOriginalEstimate(I18nHelper i18n) Return a formatted time string of the original time estimate.
String	getNiceTimeSpent(I18nHelper i18n) Return a formatted time string of the time spent.
Long	getOriginalEstimate() This is the "original estimate" of work to be performed on this issue, in milliseconds.
org.ofbiz.core.entity.GenericValue	getParent()
Long	getParentId()
Issue	getParentObject() If this issue is a subtask, return its parent.
org.ofbiz.core.entity.GenericValue	getPriority()
Priority	getPriorityObject()
org.ofbiz.core.entity.GenericValue	getProject() Gets the Project for this IssueContext.
Project	getProjectObject() Gets the Project for this Issue.
com.atlassian.crowd.embedded.api.User	getReporter() Returns the Reporter User.
String	getReporterId()
com.atlassian.crowd.embedded.api.User	getReporterUser() Return the reporter - an object will be returned even if the user has been deleted from the system.
org.ofbiz.core.entity.GenericValue	getResolution()
Timestamp	getResolutionDate() Returns the datetime that an issue was resolved on.
String	getResolutionId()
Resolution	getResolutionObject()
org.ofbiz.core.entity.GenericValue	getSecurityLevel()
Long	getSecurityLevelId()
org.ofbiz.core.entity.GenericValue	getStatus()
Status	getStatusObject()
String	getString(String name) Retrieve a String field.
Collection<Issue>	getSubTaskObjects() Gets all the issue's subtasks.
Collection<org.ofbiz.core.entity.GenericValue>	getSubTasks()
String	getSummary()
Long	getTimeSpent() This is the "total time spent" working on this issue, in milliseconds.
Timestamp	getTimestamp(String name) Retrieve a timestamp field.
Timestamp	getUpdated()
Long	getVotes()
Long	getWatches()
Long	getWorkflowId()
boolean	isAnyAggregateDifferent() Are any of the aggregates different?
boolean	isCreated()
boolean	isEditable()
boolean	isSubTask()
void	store() Persist this object's immediate fields.

Methods inherited from class java.lang.Object

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

Constructor Detail

TemplateIssue

public TemplateIssue(Issue issue,
                     FieldLayoutManager fieldLayoutManager,
                     RendererManager rendererManager,
                     CustomFieldManager customFieldManager,
                     JiraDurationUtils jiraDurationUtils,
                     AggregateTimeTrackingCalculatorFactory aggregateTimeTrackingCalculatorFactory)

Method Detail

getId

public Long getId()

Specified by:

getId in interface Issue

getProject

public org.ofbiz.core.entity.GenericValue getProject()

Description copied from interface: IssueContext

Gets the Project for this IssueContext.

A null return value is used to represent that this context applies to all Projects.

Specified by:

getProject in interface IssueContext

Specified by:

getProject in interface Issue

Returns:

The Project for this IssueContext (can be null).

getProjectObject

public Project getProjectObject()

Description copied from interface: Issue

Gets the Project for this Issue.

Specified by:

getProjectObject in interface IssueContext

Specified by:

getProjectObject in interface Issue

Returns:

The Project for this Issue.

getIssueType

public org.ofbiz.core.entity.GenericValue getIssueType()

Description copied from interface: Issue

Gets the IssueType for this Issue.

Specified by:

getIssueType in interface IssueContext

Specified by:

getIssueType in interface Issue

Returns:

The IssueType for this Issue.

getIssueTypeObject

public IssueType getIssueTypeObject()

Description copied from interface: Issue

Gets the IssueType for this Issue.

Specified by:

getIssueTypeObject in interface IssueContext

Specified by:

getIssueTypeObject in interface Issue

Returns:

The IssueType for this Issue.

getSummary

public String getSummary()

Specified by:

getSummary in interface Issue

getAssignee

public com.atlassian.crowd.embedded.api.User getAssignee()

Description copied from interface: Issue

Returns the Assignee User.

Warning: previous incarnations of this method returned com.opensymphony.user.User. This class has now been removed from the JIRA API, meaning that the 5.0 version is not binary or source compatible with earlier versions.

Specified by:

getAssignee in interface Issue

Returns:

the Assignee User.

getAssigneeId

public String getAssigneeId()

Specified by:

getAssigneeId in interface Issue

getAssigneeUser

public com.atlassian.crowd.embedded.api.User getAssigneeUser()

Description copied from interface: Issue

Returns the Assignee User.

If there is no assignee it returns null, else it is guaranteed to return a non-null User. If the User is no longer available, it will create a dummy User object based on the username.

Legacy synonym for Issue.getAssignee()

Specified by:

getAssigneeUser in interface Issue

Returns:

the Assignee User.

See Also:

Issue.getAssignee()

getComponents

public Collection<org.ofbiz.core.entity.GenericValue> getComponents()

Specified by:

getComponents in interface Issue

Returns:

A collection of component GenericValues.

getComponentObjects

public Collection<ProjectComponent> getComponentObjects()

Specified by:

getComponentObjects in interface Issue

Returns:

collection of project components (as objects) that this issue is assigned to

getReporter

public com.atlassian.crowd.embedded.api.User getReporter()

Description copied from interface: Issue

Returns the Reporter User.

Warning: previous incarnations of this method returned com.opensymphony.user.User. This class has now been removed from the JIRA API, meaning that the 5.0 version is not binary or source compatible with earlier versions.

Specified by:

getReporter in interface Issue

Returns:

the Reporter User.

getReporterId

public String getReporterId()

Specified by:

getReporterId in interface Issue

getReporterUser

public com.atlassian.crowd.embedded.api.User getReporterUser()

Return the reporter - an object will be returned even if the user has been deleted from the system.

Specified by:

getReporterUser in interface Issue

Returns:

Object a User or DummyUser object if the issue has an reporter

See Also:

Issue.getReporter()

getDescription

public String getDescription()

Retrieve the description of the issue.

Specified by:

getDescription in interface Issue

Returns:

String the issue description - rendered or text dependant on format

getHtmlDescription

public String getHtmlDescription()

Retrieves the html formatted description.

A simple string (with linked bug keys displayed) is returned if a rendered version cannot be generated.

Returns:

String the html formatted description.

getEnvironment

public String getEnvironment()

Retrieve the environment of the issue. Depending on the format specified - attempt to return the rendered description or the simple text

Specified by:

getEnvironment in interface Issue

Returns:

String the issue environment - rendered or text dependant on format specified

getHtmlEnvironment

public String getHtmlEnvironment()

Retrieves the html formatted environment.

A simple string (with linked bug keys displayed) is returned if a rendered version cannot be generated.

Returns:

String the html formatted environment.

getAffectedVersions

public Collection<Version> getAffectedVersions()

Specified by:

getAffectedVersions in interface Issue

Returns:

a collection of 'affects' Version objects.

getFixVersions

public Collection<Version> getFixVersions()

Specified by:

getFixVersions in interface Issue

Returns:

a collection of fix-for Version objects.

getDueDate

public Timestamp getDueDate()

Specified by:

getDueDate in interface Issue

getSecurityLevel

public org.ofbiz.core.entity.GenericValue getSecurityLevel()

Specified by:

getSecurityLevel in interface Issue

getSecurityLevelId

public Long getSecurityLevelId()

Specified by:

getSecurityLevelId in interface Issue

getPriority

public org.ofbiz.core.entity.GenericValue getPriority()

Specified by:

getPriority in interface Issue

getPriorityObject

public Priority getPriorityObject()

Specified by:

getPriorityObject in interface Issue

getResolutionId

public String getResolutionId()

Specified by:

getResolutionId in interface Issue

getResolution

public org.ofbiz.core.entity.GenericValue getResolution()

Specified by:

getResolution in interface Issue

getResolutionObject

public Resolution getResolutionObject()

Specified by:

getResolutionObject in interface Issue

getKey

public String getKey()

Specified by:

getKey in interface Issue

getVotes

public Long getVotes()

Specified by:

getVotes in interface Issue

getWatches

public Long getWatches()

Specified by:

getWatches in interface Issue

getCreated

public Timestamp getCreated()

Specified by:

getCreated in interface Issue

getResolutionDate

public Timestamp getResolutionDate()

Description copied from interface: Issue

Returns the datetime that an issue was resolved on. Will be null if it hasn't been resolved yet, or if an issue has been returned to the 'unresolved' state.

Specified by:

getResolutionDate in interface Issue

Returns:

Timestamp of when an issue was resolved, or null

getUpdated

public Timestamp getUpdated()

Specified by:

getUpdated in interface Issue

getWorkflowId

public Long getWorkflowId()

Specified by:

getWorkflowId in interface Issue

getCustomFieldValue

public Object getCustomFieldValue(CustomField customField)

Specified by:

getCustomFieldValue in interface Issue

Parameters:

customField - the CustomField

Returns:

A custom field's value. Will be a List, User, Timestamp etc, depending on custom field type.

getCustomField

public CustomField getCustomField(String id)

getCustomFieldValue

public Object getCustomFieldValue(String id)

Get value for a custom field.

Parameters:

id - Custom field key (eg. 'customfield_10010').

Returns:

custom field, or null if specified custom field doesn't exist or doesn't have a value in this issue.

getStatus

public org.ofbiz.core.entity.GenericValue getStatus()

Specified by:

getStatus in interface Issue

getStatusObject

public Status getStatusObject()

Specified by:

getStatusObject in interface Issue

getOriginalEstimate

public Long getOriginalEstimate()

Description copied from interface: Issue

This is the "original estimate" of work to be performed on this issue, in milliseconds.

Specified by:

getOriginalEstimate in interface Issue

Returns:

the "original estimate" of work to be performed on this issue, in milliseconds.

getEstimate

public Long getEstimate()

Description copied from interface: Issue

This is the "remaining estimate" of work left to be performed on this issue, in milliseconds.

A better name would be getRemainingEstimate but for historical reasons it is called what it is called.

Specified by:

getEstimate in interface Issue

Returns:

the "remaining estimate" of work left to be performed on this issue, in milliseconds.

getTimeSpent

public Long getTimeSpent()

Description copied from interface: Issue

This is the "total time spent" working on this issue, in milliseconds.

Specified by:

getTimeSpent in interface Issue

Returns:

the "total time spent" working on this issue, in milliseconds.

getAggregateOriginalEstimate

public Long getAggregateOriginalEstimate()

getAggregateRemainingEstimate

public Long getAggregateRemainingEstimate()

getAggregateTimeSpent

public Long getAggregateTimeSpent()

getExternalFieldValue

public Object getExternalFieldValue(String fieldId)

Specified by:

getExternalFieldValue in interface Issue

isSubTask

public boolean isSubTask()

Specified by:

isSubTask in interface Issue

getParentId

public Long getParentId()

Specified by:

getParentId in interface Issue

isCreated

public boolean isCreated()

Specified by:

isCreated in interface Issue

getParentObject

public Issue getParentObject()

Description copied from interface: Issue

If this issue is a subtask, return its parent.

Specified by:

getParentObject in interface Issue

Returns:

The parent Issue, or null if the issue is not a subtask.

getParent

public org.ofbiz.core.entity.GenericValue getParent()

Specified by:

getParent in interface Issue

getSubTasks

public Collection<org.ofbiz.core.entity.GenericValue> getSubTasks()

Specified by:

getSubTasks in interface Issue

getSubTaskObjects

public Collection<Issue> getSubTaskObjects()

Description copied from interface: Issue

Gets all the issue's subtasks.

Specified by:

getSubTaskObjects in interface Issue

Returns:

A collection of MutableIssues

isEditable

public boolean isEditable()

Specified by:

isEditable in interface Issue

getIssueRenderContext

public IssueRenderContext getIssueRenderContext()

Specified by:

getIssueRenderContext in interface Issue

getAttachments

public Collection<Attachment> getAttachments()

Specified by:

getAttachments in interface Issue

Returns:

A collection of Attachment objects

getString

public String getString(String name)

Description copied from interface: OfBizValueWrapper

Retrieve a String field.

Specified by:

getString in interface OfBizValueWrapper

Parameters:

name - the field name

Returns:

the value for the given field.

getTimestamp

public Timestamp getTimestamp(String name)

Description copied from interface: OfBizValueWrapper

Retrieve a timestamp field.

Specified by:

getTimestamp in interface OfBizValueWrapper

Parameters:

name - the field name

Returns:

the value for the given field.

getLabels

public Set<Label> getLabels()

Description copied from interface: Issue

Returns a set of all the labels for this issue or an empty set if none exist yet.

Specified by:

getLabels in interface Issue

Returns:

a set of all the labels for this issue or an empty set if none exist yet

getLong

public Long getLong(String name)

Description copied from interface: OfBizValueWrapper

Retrieve a numeric field.

Specified by:

getLong in interface OfBizValueWrapper

Parameters:

name - the field name

Returns:

the value for the given field.

getGenericValue

public org.ofbiz.core.entity.GenericValue getGenericValue()

Description copied from interface: OfBizValueWrapper

Get the backing GenericValue object.

Specified by:

getGenericValue in interface OfBizValueWrapper

Returns:

the backing GenericValue object.

store

public void store()

Description copied from interface: OfBizValueWrapper

Persist this object's immediate fields.

Specified by:

store in interface OfBizValueWrapper

getNiceTimeOriginalEstimate

public String getNiceTimeOriginalEstimate(I18nHelper i18n)

Return a formatted time string of the original time estimate.

Parameters:

i18n - helper bean for internationalization

Returns:

String formatted string of original time estimate

getNiceTimeEstimate

public String getNiceTimeEstimate(I18nHelper i18n)

Return a formatted time string of the time estimate.

Parameters:

i18n - helper bean for internationalization

Returns:

String formatted string of time estimate

getNiceTimeSpent

public String getNiceTimeSpent(I18nHelper i18n)

Return a formatted time string of the time spent.

Parameters:

i18n - helper bean for internationalization

Returns:

String formatted string of time spent

isAnyAggregateDifferent

public boolean isAnyAggregateDifferent()

Are any of the aggregates different?

Returns:

true if any of the aggregate time tracking values are different, false otherwise

getNiceTimeAggregateOriginalEstimate

public String getNiceTimeAggregateOriginalEstimate(I18nHelper i18n)

Return a formatted time string of the aggregate original time estimate.

Parameters:

i18n - helper bean for internationalization

Returns:

String formatted string of original time estimate

getNiceTimeAggregateRemainingEstimate

public String getNiceTimeAggregateRemainingEstimate(I18nHelper i18n)

Return a formatted time string of the aggregate time estimate.

Parameters:

i18n - helper bean for internationalization

Returns:

String formatted string of time estimate

getNiceTimeAggregateTimeSpent

public String getNiceTimeAggregateTimeSpent(I18nHelper i18n)

Return a formatted time string of the aggregate time spent.

Parameters:

i18n - helper bean for internationalization

Returns:

String formatted string of time spent