com.atlassian.jira.issue
Interface IssueManager

All Superinterfaces:

JiraManager

All Known Implementing Classes:

CachingIssueManager, DefaultIssueManager

public interface IssueManager
extends JiraManager

A class to manage interactions with issues

Method Summary

org.ofbiz.core.entity.GenericValue	createIssue(String remoteUserName, Map fields) Creates an issue.
org.ofbiz.core.entity.GenericValue	createIssue(User remoteUser, Issue issue) Persists a new issue.
org.ofbiz.core.entity.GenericValue	createIssue(User remoteUser, Map fields) Creates an issue.
List	execute(SearchRequest searchRequest, User searcher) Deprecated. Please use SearchProvider.search(SearchRequest, com.opensymphony.user.User, com.atlassian.jira.web.bean.PagerFilter) instead, which returns Issues.
List	getEntitiesByIssue(String relationName, org.ofbiz.core.entity.GenericValue issue) Deprecated. Use getEntitiesByIssueObject(String, Issue) instead.
List	getEntitiesByIssueObject(String relationName, Issue issue) Get a list of entities (versions, components etc) related to this issue.
org.ofbiz.core.entity.GenericValue	getIssue(Long id) Deprecated. Use getIssueObject(Long) instead.
org.ofbiz.core.entity.GenericValue	getIssue(String key) Deprecated. Use getIssueObject(String) instead.
org.ofbiz.core.entity.GenericValue	getIssueByWorkflow(Long wfid) Retrieves an issue GenericValue given a workflow ID.
Collection	getIssueIdsForProject(Long projectId) Returns all issue ids for a particular project.
MutableIssue	getIssueObject(Long id) Retrieves an issue by id.
MutableIssue	getIssueObject(String key) Retrieves the Issue that has the given key.
List	getIssues(Collection ids) Get issues with the following ids.
List	getIssuesByEntity(String relationName, org.ofbiz.core.entity.GenericValue entity) Get a list of issues related to an entity (version, component etc).
List	getIssueWatchers(org.ofbiz.core.entity.GenericValue issue) Deprecated. Use getIssueWatchers(Issue) instead
List	getIssueWatchers(Issue issue) Return a list of watchers for a particular issue.
List	getProjectIssues(org.ofbiz.core.entity.GenericValue project) Deprecated. only used in test cases, should use a search provider instead.
List	getVotedIssues(User user) Get a list of issues that the user has voted on
List	getWatchedIssues(User user) Get a list of issues that the user is watching
boolean	isEditable(Issue issue) Returns whether the issue can be edited.

Method Detail

getIssue

org.ofbiz.core.entity.GenericValue getIssue(Long id)
                                            throws DataAccessException

Deprecated. Use getIssueObject(Long) instead.

Retrieves an issue by its id.

Parameters:

id -

Returns:

An issue GenericValue.

Throws:

DataAccessException

getIssue

org.ofbiz.core.entity.GenericValue getIssue(String key)
                                            throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use getIssueObject(String) instead.

Retrieves the issue as a GenericValue with the given key.

Parameters:

key - the issue key.

Returns:

the issue as a GenericValue.

Throws:

org.ofbiz.core.entity.GenericEntityException - if there is a problem getting the data

getIssueByWorkflow

org.ofbiz.core.entity.GenericValue getIssueByWorkflow(Long wfid)
                                                      throws org.ofbiz.core.entity.GenericEntityException

Retrieves an issue GenericValue given a workflow ID. This is used when transitioning through the various steps of a workflow.

Parameters:

wfid -

Returns:

An issue GenericValue.

Throws:

org.ofbiz.core.entity.GenericEntityException

getIssueObject

MutableIssue getIssueObject(Long id)
                            throws DataAccessException

Retrieves an issue by id.

Parameters:

id -

Returns:

A MutableIssue

Throws:

DataAccessException

getIssueObject

MutableIssue getIssueObject(String key)
                            throws DataAccessException

Retrieves the Issue that has the given key.

Parameters:

key - the key.

Returns:

A MutableIssue

Throws:

DataAccessException - if a matching issue cannot be found.

getIssues

List getIssues(Collection ids)

Get issues with the following ids. The issues are sorted in the order that the ids were given in.

Parameters:

ids -

Returns:

A collection of issue GenericValues

getVotedIssues

List getVotedIssues(User user)
                    throws org.ofbiz.core.entity.GenericEntityException,
                           EntityNotFoundException

Get a list of issues that the user has voted on

Returns:

A list of Issue objects

Throws:

org.ofbiz.core.entity.GenericEntityException

EntityNotFoundException

getIssueWatchers

List getIssueWatchers(org.ofbiz.core.entity.GenericValue issue)
                      throws org.ofbiz.core.entity.GenericEntityException,
                             EntityNotFoundException

Deprecated. Use getIssueWatchers(Issue) instead

Return a list of watchers for a particular issue.

Parameters:

issue -

Returns:

A list of Users.

Throws:

org.ofbiz.core.entity.GenericEntityException

EntityNotFoundException

getIssueWatchers

List getIssueWatchers(Issue issue)
                      throws org.ofbiz.core.entity.GenericEntityException,
                             EntityNotFoundException

Return a list of watchers for a particular issue.

Parameters:

issue -

Returns:

A list of Users.

Throws:

org.ofbiz.core.entity.GenericEntityException

EntityNotFoundException

getWatchedIssues

List getWatchedIssues(User user)
                      throws org.ofbiz.core.entity.GenericEntityException,
                             EntityNotFoundException

Get a list of issues that the user is watching

Returns:

A list of Issue objects

Throws:

org.ofbiz.core.entity.GenericEntityException

EntityNotFoundException

execute

List execute(SearchRequest searchRequest,
             User searcher)
             throws SearchException

Deprecated. Please use SearchProvider.search(SearchRequest, com.opensymphony.user.User, com.atlassian.jira.web.bean.PagerFilter) instead, which returns Issues.

Takes a search request object and returns a list of issues that match the search request

Parameters:

searchRequest - object to be used to search for

searcher - User who is running the search. Make sure this user has permissions to see the issues you want!

Returns:

A List of Issues that match the search request, or null if the searchrequest supplied was null.

Throws:

SearchException

getEntitiesByIssue

List getEntitiesByIssue(String relationName,
                        org.ofbiz.core.entity.GenericValue issue)
                        throws org.ofbiz.core.entity.GenericEntityException

Deprecated. Use getEntitiesByIssueObject(String, Issue) instead.

Get a list of entities (versions, components etc) related to this issue.

Parameters:

relationName - A IssueRelationConstants string indicating some issue relation

issue - Issue to consider

Returns:

A list of entity GenericValues associated with the issue.

Throws:

org.ofbiz.core.entity.GenericEntityException

getEntitiesByIssueObject

List getEntitiesByIssueObject(String relationName,
                              Issue issue)
                              throws org.ofbiz.core.entity.GenericEntityException

Get a list of entities (versions, components etc) related to this issue.

Parameters:

relationName - A IssueRelationConstants string indicating some issue relation

issue - Issue to consider

Returns:

A list of entity GenericValues associated with the issue.

Throws:

org.ofbiz.core.entity.GenericEntityException

getIssuesByEntity

List getIssuesByEntity(String relationName,
                       org.ofbiz.core.entity.GenericValue entity)
                       throws org.ofbiz.core.entity.GenericEntityException

Get a list of issues related to an entity (version, component etc).

Parameters:

relationName - A IssueRelationConstants string indicating some relation of entity

entity - The entity related to the issues we're after

Returns:

A list of issue GenericValues associated with an entity.

Throws:

org.ofbiz.core.entity.GenericEntityException

createIssue

org.ofbiz.core.entity.GenericValue createIssue(String remoteUserName,
                                               Map fields)
                                               throws CreateException

Creates an issue.

Parameters:

remoteUserName - Issue creator

fields - A map of the issue's immediate field values. See the Issue definition in entitymodel.xml for values.

Returns:

GenericValue representing the new issue.

Throws:

CreateException

createIssue

org.ofbiz.core.entity.GenericValue createIssue(User remoteUser,
                                               Map fields)
                                               throws CreateException

Creates an issue.

Parameters:

remoteUser - Issue creator

fields - A map of the issue's immediate field values. See the Issue definition in entitymodel.xml for values.

Returns:

GenericValue representing the new issue.

Throws:

CreateException

createIssue

org.ofbiz.core.entity.GenericValue createIssue(User remoteUser,
                                               Issue issue)
                                               throws CreateException

Persists a new issue.

Parameters:

remoteUser - Issue creator

issue - The new issue.

Returns:

GenericValue representing the new issue.

Throws:

CreateException

getProjectIssues

List getProjectIssues(org.ofbiz.core.entity.GenericValue project)
                      throws org.ofbiz.core.entity.GenericEntityException

Deprecated. only used in test cases, should use a search provider instead.

Get all the issues for a given project.

Returns:

a List of GenericValue objects

Throws:

org.ofbiz.core.entity.GenericEntityException

isEditable

boolean isEditable(Issue issue)

Returns whether the issue can be edited. This is determined by looking at the workflow step the issue is in.

getIssueIdsForProject

Collection getIssueIdsForProject(Long projectId)
                                 throws org.ofbiz.core.entity.GenericEntityException

Returns all issue ids for a particular project. This uses constant memory (i.e. doesn't load all issues into memory.

Parameters:

projectId -

Returns:

A collection of issue ID strings

Throws:

org.ofbiz.core.entity.GenericEntityException