com.atlassian.jira.issue.link
Interface IssueLinkTypeManager

All Known Implementing Classes:

DefaultIssueLinkTypeManager

public interface IssueLinkTypeManager

Manages IssueLinkTypes.

Method Summary

void	createIssueLinkType(String name, String outward, String inward, String style)
IssueLinkType	getIssueLinkType(Long id)
Collection<IssueLinkType>	getIssueLinkTypes()
Collection<IssueLinkType>	getIssueLinkTypesByInwardDescription(String desc) Returns a collection of IssueLinkTypes with the given description as the inward description.
Collection<IssueLinkType>	getIssueLinkTypesByName(String name) Returns a collection of IssueLinkTypes with the given name.
Collection<IssueLinkType>	getIssueLinkTypesByOutwardDescription(String desc) Returns a collection of IssueLinkTypes with the given description as the outward description.
Collection<IssueLinkType>	getIssueLinkTypesByStyle(String style)
void	removeIssueLinkType(Long issueLinkTypeId) This method removed the issue link type from the database WARNING: This method DOES NOT check if there are any existing issue links of this issue link type.
void	updateIssueLinkType(IssueLinkType issueLinkType, String name, String outward, String inward)

Method Detail

createIssueLinkType

void createIssueLinkType(String name,
                         String outward,
                         String inward,
                         String style)

updateIssueLinkType

void updateIssueLinkType(IssueLinkType issueLinkType,
                         String name,
                         String outward,
                         String inward)

removeIssueLinkType

void removeIssueLinkType(Long issueLinkTypeId)

This method removed the issue link type from the database
WARNING: This method DOES NOT check if there are any existing issue links of this issue link type. It simply removes the record from the datastore. Use IssueLinkTypeDestroyer to 'nicely' remove the issue link type taking care of exiting issue links.

Parameters:

issueLinkTypeId - the id of the IssueLinkType to remove

getIssueLinkTypes

Collection<IssueLinkType> getIssueLinkTypes()

getIssueLinkType

IssueLinkType getIssueLinkType(Long id)

getIssueLinkTypesByName

Collection<IssueLinkType> getIssueLinkTypesByName(String name)

Returns a collection of IssueLinkTypes with the given name. Actually this collection should always have either one or zero elements - it is illegal to have two link types with the same name.

Parameters:

name - The name to search for Issue Link Types by.

Returns:

a collection of IssueLinkTypes, or an empty collection if name isn't a link type. TODO: Reconsider this method. The GUI enforces unique names.

getIssueLinkTypesByInwardDescription

Collection<IssueLinkType> getIssueLinkTypesByInwardDescription(String desc)

Returns a collection of IssueLinkTypes with the given description as the inward description.

There is no restriction on inward and outward descriptions being unique across issue link types, which is why this may return more than one IssueLinkType.

Parameters:

desc - the inward description to search on

Returns:

the collection of matched issue link types; never null.

Since:

v4.0

getIssueLinkTypesByOutwardDescription

Collection<IssueLinkType> getIssueLinkTypesByOutwardDescription(String desc)

Returns a collection of IssueLinkTypes with the given description as the outward description.

There is no restriction on inward and outward descriptions being unique across issue link types, which is why this may return more than one IssueLinkType.

Parameters:

desc - the outward description to search on

Returns:

the collection of matched issue link types; never null.

Since:

v4.0

getIssueLinkTypesByStyle

Collection<IssueLinkType> getIssueLinkTypesByStyle(String style)