com.atlassian.jira.issue

Interface IssueFactory

All Known Implementing Classes:

DefaultIssueFactory, SimpleMockIssueFactory

public interface IssueFactory

The IssueFactory is used for creating Issues in Jira, as well as converting GenericValue issue objects to proper Issue objects. It only handles creational tasks. For update and retrieval see the IssueManager interface. Note: This is an internal method for creating issues. To create issues properly, you should use the IssueService interface instead. It will include data validation, permissions, proper event firing, and triggering of notifications and indexing.

Field Summary

Fields

Modifier and Type	Field and Description
static org.apache.commons.collections.Transformer	TO_GENERIC_VALUE Used for transforming collections of Issue objects to issue GenericValue objects.

Method Summary

Modifier and Type	Method and Description
MutableIssue	cloneIssue(Issue issue) Clones the Issue object which creates an editable copy.
MutableIssue	cloneIssueNoParent(Issue issue) Clone Issue for conversion from sub task to issue
MutableIssue	cloneIssueWithAllFields(Issue issue) Clones the Issue object which creates an editable copy.
MutableIssue	getIssue() Creates a new blank issue.
Issue	getIssue(org.apache.lucene.document.Document issueDocument) Creates an issue object for an issue represented by the Lucene Document
MutableIssue	getIssue(org.ofbiz.core.entity.GenericValue issueGV) Creates an issue object for an issue represented by the passed issueGV
MutableIssue	getIssueOrNull(org.ofbiz.core.entity.GenericValue issueGV) Creates an issue object for an issue represented by the passed issueGV.
List<Issue>	getIssues(Collection<org.ofbiz.core.entity.GenericValue> issueGVs) Convert a list of GenericValue objects into a list of MutableIssue objects.

Field Detail

TO_GENERIC_VALUE

static final org.apache.commons.collections.Transformer TO_GENERIC_VALUE

Used for transforming collections of Issue objects to issue GenericValue objects.

Method Detail

getIssue

MutableIssue getIssue()

Creates a new blank issue.

Returns:

A MutableIssue object

getIssue

MutableIssue getIssue(org.ofbiz.core.entity.GenericValue issueGV)

Creates an issue object for an issue represented by the passed issueGV

Parameters:

issueGV -

Returns:

A MutableIssue object that represents a copy of the issueGV

getIssueOrNull

MutableIssue getIssueOrNull(org.ofbiz.core.entity.GenericValue issueGV)

Creates an issue object for an issue represented by the passed issueGV. This will return null if it is passed null, which is different behaviour to getIssue(org.ofbiz.core.entity.GenericValue)

Parameters:

issueGV -

Returns:

A MutableIssue object that represents a copy of the issueGV, or null.

cloneIssue

MutableIssue cloneIssue(Issue issue)

Clones the Issue object which creates an editable copy. Does not clone custom field values.

Parameters:

issue - issue to be cloned

Returns:

A MutableIssue clone.

cloneIssueWithAllFields

MutableIssue cloneIssueWithAllFields(Issue issue)

Clones the Issue object which creates an editable copy.

Parameters:

issue - issue to be cloned

Returns:

A MutableIssue clone.

getIssues

List<Issue> getIssues(Collection<org.ofbiz.core.entity.GenericValue> issueGVs)

Convert a list of GenericValue objects into a list of MutableIssue objects. This is just a convenience method that calls getIssue(org.ofbiz.core.entity.GenericValue)

Parameters:

issueGVs - The issues to be retrieved

Returns:

Return a list of MutableIssue objects

See Also:

getIssue(org.ofbiz.core.entity.GenericValue)

getIssue

Issue getIssue(org.apache.lucene.document.Document issueDocument)

Creates an issue object for an issue represented by the Lucene Document

Parameters:

issueDocument -

Returns:

cloneIssueNoParent

MutableIssue cloneIssueNoParent(Issue issue)

Clone Issue for conversion from sub task to issue