com.atlassian.bamboo.jira.jiraissues

Interface JiraIssueHelper

All Known Implementing Classes:

JiraIssueUtils

public interface JiraIssueHelper

A helper service for working with JIRA issues.

Method Summary

Modifier and Type	Method and Description
Set<String>	findIssueKeysInText(String string) Find the JIRA issue keys within the given string.
Set<String>	findIssueKeysInText(String string, boolean ignoreIfInUrl) Find the JIRA issue keys within the given string.
List<String>	findIssueKeysInTextAsList(String string, boolean ignoreIfInUrl) Deprecated. since 6.5 use findIssueKeysInText(String, boolean) instead
List<String>	findIssueKeysInTextAsList(String string, boolean ignoreIfInUrl, Pattern issueKeyBoundaryRegex) Deprecated. since 6.5 use findIssueKeysInText(String, boolean) instead
LinkedHashSet<String>	findPotentialIssueKeys(String string, boolean ignoreIfInUrl, Pattern issueKeyLeftBoundaryRegex, Pattern issueKeyRightBoundaryRegex) Find the JIRA issue keys within the given string.
boolean	isJiraServerSetup() Whether any JIRA server is linked with this instance of Bamboo.
boolean	isValidIssueKey(String string) Checks whether a given string could be a valid issue key.

Method Detail

isValidIssueKey

boolean isValidIssueKey(@NotNull
                        String string)

Checks whether a given string could be a valid issue key.

findIssueKeysInText

@NotNull
Set<String> findIssueKeysInText(@NotNull
                                         String string)

Find the JIRA issue keys within the given string.

Parameters:

string - text to search

Returns:

JIRA issue keys in order of appearance in the string

findIssueKeysInText

@NotNull
Set<String> findIssueKeysInText(@NotNull
                                         String string,
                                         boolean ignoreIfInUrl)

Find the JIRA issue keys within the given string.

Parameters:

string - text to search

ignoreIfInUrl - whether to ignore found keys if they're part of URLs

Returns:

JIRA issue keys in order of appearance in the string

findPotentialIssueKeys

@NotNull
LinkedHashSet<String> findPotentialIssueKeys(@NotNull
                                                      String string,
                                                      boolean ignoreIfInUrl,
                                                      Pattern issueKeyLeftBoundaryRegex,
                                                      Pattern issueKeyRightBoundaryRegex)

Find the JIRA issue keys within the given string. Preserves the order they were found in.

findIssueKeysInTextAsList

@NotNull
 @Deprecated
List<String> findIssueKeysInTextAsList(@NotNull
                                                             String string,
                                                             boolean ignoreIfInUrl)

Deprecated. since 6.5 use findIssueKeysInText(String, boolean) instead

Find the JIRA issue keys within the given string. Maintains the order they were found in. Does not contain duplicates.

Parameters:

string - text to search

ignoreIfInUrl - whether to ignore found keys if they're part of URLs

Returns:

A list of JIRA issue keys

findIssueKeysInTextAsList

@NotNull
 @Deprecated
List<String> findIssueKeysInTextAsList(@NotNull
                                                             String string,
                                                             boolean ignoreIfInUrl,
                                                             @NotNull
                                                             Pattern issueKeyBoundaryRegex)

Deprecated. since 6.5 use findIssueKeysInText(String, boolean) instead

Find the JIRA issue keys within the given string. Maintains the order they were found in. Does not contain duplicates.

This method accepts a Pattern as a parameter to test characters before and after discovered issue key, in order to adjust sensitivity of the search. As an example, for text "CR-BAM-1534", if the character "-" is disallowed by the boundary regex, the key "BAM-1534" will not be returned (as the "-" character is present in the text just before the key).

Parameters:

string - text to search

ignoreIfInUrl - whether to ignore found keys if they're part of URLs

issueKeyBoundaryRegex - regular expression which has to match characters before and after discovered issue key, for example "[^a-zA-Z0-9-]"

Returns:

A list of JIRA issue keys

isJiraServerSetup

boolean isJiraServerSetup()

Whether any JIRA server is linked with this instance of Bamboo.