com.atlassian.greenhopper.service.sprint
Interface SprintIssueService

All Known Implementing Classes:

SprintIssueServiceImpl

public interface SprintIssueService

Manipulates sprint information stored against issues.

Since:

v5.8.5

Author:

mtokar

Method Summary

ServiceOutcome<java.lang.Void>	addIssuesToSprint(com.atlassian.crowd.embedded.api.User user, Sprint sprint, java.util.Set<com.atlassian.jira.issue.Issue> issues) Updates the Default Sprint field on the specified issues to have the value of the specified Sprint.
ServiceOutcome<java.lang.Iterable<com.atlassian.jira.issue.Issue>>	getIssuesForSprint(com.atlassian.crowd.embedded.api.User user, Sprint sprint) Gets the issues assigned to a given sprint Note: This returns the issues in the given sprint RIGHT NOW! if you want issues which _have_ been in the sprint at some point, look at SprintHistoryService
ServiceOutcome<java.util.Collection<Sprint>>	getOpenSprintsForIssue(com.atlassian.crowd.embedded.api.User user, com.atlassian.jira.issue.Issue issue)
ServiceOutcome<java.util.Collection<Sprint>>	getSprintsForIssue(com.atlassian.crowd.embedded.api.User user, com.atlassian.jira.issue.Issue issue)
ServiceOutcome<java.lang.Void>	removeIssuesFromSprint(com.atlassian.crowd.embedded.api.User user, Sprint sprint, java.util.Set<com.atlassian.jira.issue.Issue> issues) removes the specified issues from a given sprint

Method Detail

addIssuesToSprint

@NotNull
ServiceOutcome<java.lang.Void> addIssuesToSprint(com.atlassian.crowd.embedded.api.User user,
                                                         Sprint sprint,
                                                         java.util.Set<com.atlassian.jira.issue.Issue> issues)

Updates the Default Sprint field on the specified issues to have the value of the specified Sprint.

Validation of the issue update is performed against all issues before attempting an update.

Note: if validation passes but the update operation does not, it is possible that some issues will have already been updated even though errors have been returned.

Parameters:

user - the user performing the sprint assignment

sprint - the sprint to assign issues to

issues - the issues to put into the sprint

Returns:

an outcome which contains the errors which occurred (if any)

getIssuesForSprint

@NotNull
ServiceOutcome<java.lang.Iterable<com.atlassian.jira.issue.Issue>> getIssuesForSprint(com.atlassian.crowd.embedded.api.User user,
                                                                                              Sprint sprint)

Gets the issues assigned to a given sprint Note: This returns the issues in the given sprint RIGHT NOW! if you want issues which _have_ been in the sprint at some point, look at SprintHistoryService

Parameters:

user - the user performing the query

sprint - the sprint to query

Returns:

an outcome which contains the issues for this sprint

removeIssuesFromSprint

@NotNull
ServiceOutcome<java.lang.Void> removeIssuesFromSprint(com.atlassian.crowd.embedded.api.User user,
                                                              Sprint sprint,
                                                              java.util.Set<com.atlassian.jira.issue.Issue> issues)

removes the specified issues from a given sprint

Parameters:

user - the user performing the sprint operation

sprint - the sprint to remove issues from

issues - the issues to remove from the sprint

Returns:

an outcome containing any errors which occured

getSprintsForIssue

@NotNull
ServiceOutcome<java.util.Collection<Sprint>> getSprintsForIssue(com.atlassian.crowd.embedded.api.User user,
                                                                        com.atlassian.jira.issue.Issue issue)

getOpenSprintsForIssue

@NotNull
ServiceOutcome<java.util.Collection<Sprint>> getOpenSprintsForIssue(com.atlassian.crowd.embedded.api.User user,
                                                                            com.atlassian.jira.issue.Issue issue)