com.atlassian.jira.bc.issue.issuelink
Interface IssueLinkService

All Known Implementing Classes:
DefaultIssueLinkService

Deprecated. Use IssueLinkService instead. Since v5.0.

@PublicApi
public interface IssueLinkService

A service that provides issue linking capabilities

Since:
v4.4

Nested Class Summary
static class IssueLinkService.AddIssueLinkValidationResult
          Deprecated.  
static class IssueLinkService.DeleteIssueLinkValidationResult
          Deprecated.  
static class IssueLinkService.IssueLinkResult
          Deprecated.  
static class IssueLinkService.IssueLinkValidationResult
          Deprecated.  
 
Method Summary
 IssueLinkService.IssueLinkResult addIssueLinks(com.atlassian.crowd.embedded.api.User user, IssueLinkService.AddIssueLinkValidationResult result)
          Deprecated. Adds the issue link to the issue specified by the validation result.
 void delete(IssueLinkService.DeleteIssueLinkValidationResult deleteValidationResult)
          Deprecated. Deletes the issue link with the given id from the JIRA datastore, if the current user has permission to do so.
 IssueLink getIssueLink(Long sourceId, Long destinationId, Long issueLinkTypeId)
          Deprecated. Returns the issue link or null if not found.
 IssueLinkService.IssueLinkResult getIssueLinks(com.atlassian.crowd.embedded.api.User user, Issue issue)
          Deprecated. Returns the issue links that the specified user can see.
 IssueLinkService.IssueLinkResult getIssueLinks(com.atlassian.crowd.embedded.api.User user, Issue issue, boolean excludeSystemLinks)
          Deprecated.  
 Collection<IssueLinkType> getIssueLinkTypes()
          Deprecated.  
 IssueLinkService.AddIssueLinkValidationResult validateAddIssueLinks(com.atlassian.crowd.embedded.api.User user, Issue issue, Long issueLinkTypeId, Direction direction, Collection<String> linkKeys, boolean excludeSystemLinks)
          Deprecated.  
 IssueLinkService.AddIssueLinkValidationResult validateAddIssueLinks(com.atlassian.crowd.embedded.api.User user, Issue issue, String linkName, Collection<String> linkKeys)
          Deprecated. Validates that the user provided can add the link provided for a particular issue.
 IssueLinkService.DeleteIssueLinkValidationResult validateDelete(com.atlassian.crowd.embedded.api.User user, Issue issue, IssueLink issueLink)
          Deprecated. Validates parameters and checks permissions, and if all checks pass it will create a IssueLinkService.DeleteIssueLinkValidationResult that can be passed to the delete(DeleteIssueLinkValidationResult) method.
 

Method Detail

getIssueLinkTypes

Collection<IssueLinkType> getIssueLinkTypes()
Deprecated. 
Returns:
the all issue link types defined in JIRA

getIssueLink

IssueLink getIssueLink(Long sourceId,
                       Long destinationId,
                       Long issueLinkTypeId)
Deprecated. 
Returns the issue link or null if not found.

Parameters:
sourceId - source issue id of the link
destinationId - destination issue id of the link
issueLinkTypeId - link type id of the link
Returns:
issue link or null if not found

getIssueLinks

IssueLinkService.IssueLinkResult getIssueLinks(com.atlassian.crowd.embedded.api.User user,
                                               Issue issue)
Deprecated. 
Returns the issue links that the specified user can see. Will only return non-system (user-defined) links.

Parameters:
user - The user performing the operation
issue - The issue that links will retrieved on
Returns:
a result that contains the issue links

getIssueLinks

IssueLinkService.IssueLinkResult getIssueLinks(com.atlassian.crowd.embedded.api.User user,
                                               Issue issue,
                                               boolean excludeSystemLinks)
Deprecated. 
Parameters:
user - The user performing the operation
issue - The issue that links will retrieved on
excludeSystemLinks - whether or not to exclude system links
Returns:
a result that contains the issue links
See Also:
getIssueLinks(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue)

validateAddIssueLinks

IssueLinkService.AddIssueLinkValidationResult validateAddIssueLinks(com.atlassian.crowd.embedded.api.User user,
                                                                    Issue issue,
                                                                    String linkName,
                                                                    Collection<String> linkKeys)
Deprecated. 
Validates that the user provided can add the link provided for a particular issue. Validation will ensure that the user has the EDIT_ISSUE permission for the issue in question. The label will also be validated to ensure that it doesn't contain spaces and that it doesn't exceed the max length of 255 characters. Only user-created (i.e. non-system) links are allowed.

Parameters:
user - The user performing the operation
issue - The issue that links will be set on
linkName - The actual link name as strings to set on the issue
linkKeys - The collection of issue keys to link against
Returns:
a validation result, that can be used to set the labels or to display errors.

validateAddIssueLinks

IssueLinkService.AddIssueLinkValidationResult validateAddIssueLinks(com.atlassian.crowd.embedded.api.User user,
                                                                    Issue issue,
                                                                    Long issueLinkTypeId,
                                                                    Direction direction,
                                                                    Collection<String> linkKeys,
                                                                    boolean excludeSystemLinks)
Deprecated. 
Parameters:
user - The user performing the operation
issue - The issue that links will be set on
issueLinkTypeId - The actual link id to set on the issue
direction - which direction we are linking in
linkKeys - The collection of issue keys to link against
excludeSystemLinks - whether or not system links are okay
Returns:
a validation result, that can be used to set the labels or to display errors.

addIssueLinks

IssueLinkService.IssueLinkResult addIssueLinks(com.atlassian.crowd.embedded.api.User user,
                                               IssueLinkService.AddIssueLinkValidationResult result)
Deprecated. 
Adds the issue link to the issue specified by the validation result.

Parameters:
user - The user performing the operation
result - The validation result obtained via #validateAddIssueLinks(com.atlassian.crowd.embedded.api.User,com.atlassian.jira.issue.Issue, String, java.util.Collection
Returns:
result containing the new links

validateDelete

IssueLinkService.DeleteIssueLinkValidationResult validateDelete(com.atlassian.crowd.embedded.api.User user,
                                                                Issue issue,
                                                                IssueLink issueLink)
Deprecated. 
Validates parameters and checks permissions, and if all checks pass it will create a IssueLinkService.DeleteIssueLinkValidationResult that can be passed to the delete(DeleteIssueLinkValidationResult) method.

Parameters:
user - who the permission checks will be run against (can be null, indicating an anonymous user)
issue - issue the link is being deleted from
issueLink - issue link to be deleted
Returns:
a validation result, if all validation and permission passes it will contain a validated issue link id, otherwise the issue link id will be null

delete

void delete(IssueLinkService.DeleteIssueLinkValidationResult deleteValidationResult)
Deprecated. 
Deletes the issue link with the given id from the JIRA datastore, if the current user has permission to do so.

Parameters:
deleteValidationResult - contains the remote issue link id to delete. This should have been created by the validateDelete(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue, com.atlassian.jira.issue.issuelink.IssueLink) method. The result must have ServiceResult.isValid() return true. If false this method will throw an IllegalStateException.


Copyright © 2002-2012 Atlassian. All Rights Reserved.