com.atlassian.bamboo.jira.jiraissues

Class JiraIssueUtils

java.lang.Object

com.atlassian.bamboo.jira.jiraissues.JiraIssueUtils

All Implemented Interfaces:

JiraIssueHelper

public class JiraIssueUtils
extends Object
implements JiraIssueHelper

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JiraIssueUtils.JiraPanel

Field Summary

Fields

Modifier and Type	Field and Description
static Pattern	LENIENT_ISSUE_KEY_BOUNDARY_REGEX
static String	PROJECT_ISSUE_NUMBER_SEPARATOR
static String	RENDERED_JIRA_KEY
static String	RENDERED_JIRA_KEY_NO_SERVER
static Pattern	RESTRICTIVE_ISSUE_KEY_BOUNDARY_REGEX

Constructor Summary

Constructors

Constructor and Description
JiraIssueUtils(JiraApplinksService jiraApplinksService, ResultsSummaryManager resultsSummaryManager, com.atlassian.event.api.EventPublisher eventPublisher, AdministrationConfigurationAccessor administrationConfigurationAccessor)

Method Summary

Modifier and Type	Method and Description
static com.google.common.base.Function<JiraXmlSearchResultItemEntity,JiraIssueDetails>	buildJiraIssueDetailsFromSearchResultFunction(com.atlassian.applinks.api.ApplicationLink applicationLink, JiraIssueDetailsBuilderFactory jiraIssueDetailsBuilderFactory) Returns function which builds JiraIssueDetails from JIRA XML search result
void	findAndSaveJiraIssueKeys(String string, ResultsSummary buildResultsSummary) Finds any jira issue keys in the given input string, and saves them against the given build result summary.
LinkedHashSet<String>	findIssueKeys(String string, boolean ignoreIfInUrl, Pattern issueKeyBoundaryRegex) Deprecated. since 6.5 use findPotentialIssueKeys(String, boolean, Pattern, Pattern) instead
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) Find the JIRA issue keys within the given string.
List<String>	findIssueKeysInTextAsList(String string, boolean ignoreIfInUrl, Pattern issueKeyBoundaryRegex) Find the JIRA issue keys within the given string.
LinkedHashSet<String>	findPotentialIssueKeys(String string, boolean ignoreIfInUrl, Pattern issueKeyLeftBoundaryRegex, Pattern issueKeyRightBoundaryRegex) Find the JIRA issue keys within the given string.
List<LinkedJiraIssue>	getFilteredFixedJiraIssues(Collection<LinkedJiraIssue> possibleIssues, int numberNeeded)
List<LinkedJiraIssue>	getFilteredJiraIssues(Collection<LinkedJiraIssue> possibleIssues, int numberNeeded) Returns a required length list of jira issues and controls logic behind which are shown * Fixed issues are given preference This is needed so that only the required number of JIRA Issues will be retrieved from the jira server
List<LinkedJiraIssue>	getFilteredRelatedJiraIssues(Collection<LinkedJiraIssue> possibleIssues, int numberNeeded)
Set<LinkedJiraIssue>	getFixedJiraIssues(Iterable<LinkedJiraIssue> allIssues) returns a set of all jira issues with link type 'fixed'
static JiraIssueUtils	getFreemarkerInstance()
static String	getJiraDisplayUrl(com.atlassian.applinks.api.ApplicationLink applicationLink, String issueKey)
protected String	getJiraIssueTitleText()
static String	getJiraIssueUrl(String host, JiraIssueKey issueKey, JiraIssueUtils.JiraPanel panel)
static String	getJiraUrl(com.atlassian.applinks.api.ApplicationLink applicationLink, String issueKey)
Set<LinkedJiraIssue>	getRelatedJiraIssues(Iterable<LinkedJiraIssue> allIssues) returns a set of all jira issues with link type 'related'
String	getRenderedString(String inputString) Renders any jira links within the input string
String	getRenderedString(String inputString, DeploymentVersion deploymentVersion) Renders valid jira issues in the input string, valid issues are determined by what is stored in the DeploymentVersion
String	getRenderedString(String inputString, ImmutableResultsSummary resultsSummary) Renders valid jira issues in the input string, valid issues are determined by what is stored in the BuildResultSummary
String	getRenderedString(String inputString, String buildKey, Integer buildNumber) Renders valid jira issues in the input string, valid issues are determined by what is stored in the BuildResultSummary
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.
void	setAdministrationConfigurationAccessor(AdministrationConfigurationAccessor administrationConfigurationAccessor)
static com.google.common.base.Function<InternalLinkedJiraIssue,String>	transformJiraIssueToJiraIssueKey()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

RESTRICTIVE_ISSUE_KEY_BOUNDARY_REGEX

public static final Pattern RESTRICTIVE_ISSUE_KEY_BOUNDARY_REGEX

LENIENT_ISSUE_KEY_BOUNDARY_REGEX

public static final Pattern LENIENT_ISSUE_KEY_BOUNDARY_REGEX

PROJECT_ISSUE_NUMBER_SEPARATOR

public static final String PROJECT_ISSUE_NUMBER_SEPARATOR

See Also:

Constant Field Values

RENDERED_JIRA_KEY

public static final String RENDERED_JIRA_KEY

See Also:

Constant Field Values

RENDERED_JIRA_KEY_NO_SERVER

public static final String RENDERED_JIRA_KEY_NO_SERVER

See Also:

Constant Field Values

Constructor Detail

JiraIssueUtils

public JiraIssueUtils(JiraApplinksService jiraApplinksService,
                      ResultsSummaryManager resultsSummaryManager,
                      com.atlassian.event.api.EventPublisher eventPublisher,
                      AdministrationConfigurationAccessor administrationConfigurationAccessor)

Method Detail

getFreemarkerInstance

public static JiraIssueUtils getFreemarkerInstance()

findAndSaveJiraIssueKeys

public void findAndSaveJiraIssueKeys(@NotNull
                                     String string,
                                     @NotNull
                                     ResultsSummary buildResultsSummary)

Finds any jira issue keys in the given input string, and saves them against the given build result summary.

Parameters:

string -

buildResultsSummary -

isValidIssueKey

public boolean isValidIssueKey(@NotNull
                               String string)

Description copied from interface: JiraIssueHelper

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

Specified by:

isValidIssueKey in interface JiraIssueHelper

getFixedJiraIssues

@NotNull
public Set<LinkedJiraIssue> getFixedJiraIssues(@NotNull
                                                        Iterable<LinkedJiraIssue> allIssues)

returns a set of all jira issues with link type 'fixed'

Parameters:

allIssues -

Returns:

getRelatedJiraIssues

@NotNull
public Set<LinkedJiraIssue> getRelatedJiraIssues(@NotNull
                                                          Iterable<LinkedJiraIssue> allIssues)

returns a set of all jira issues with link type 'related'

Parameters:

allIssues -

Returns:

findIssueKeysInText

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

Description copied from interface: JiraIssueHelper

Find the JIRA issue keys within the given string.

Specified by:

findIssueKeysInText in interface JiraIssueHelper

Parameters:

string - text to search

Returns:

JIRA issue keys in order of appearance in the string

findIssueKeysInText

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

Description copied from interface: JiraIssueHelper

Find the JIRA issue keys within the given string.

Specified by:

findIssueKeysInText in interface JiraIssueHelper

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

findIssueKeys

@NotNull
 @Deprecated
public LinkedHashSet<String> findIssueKeys(String string,
                                                                 boolean ignoreIfInUrl,
                                                                 Pattern issueKeyBoundaryRegex)

Deprecated. since 6.5 use findPotentialIssueKeys(String, boolean, Pattern, Pattern) instead

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

Parameters:

string -

ignoreIfInUrl -

Returns:

An ordered set of JIRA Issue Keys

findPotentialIssueKeys

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

Description copied from interface: JiraIssueHelper

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

Specified by:

findPotentialIssueKeys in interface JiraIssueHelper

findIssueKeysInTextAsList

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

Description copied from interface: JiraIssueHelper

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

Specified by:

findIssueKeysInTextAsList in interface JiraIssueHelper

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
public List<String> findIssueKeysInTextAsList(@NotNull
                                                       String string,
                                                       boolean ignoreIfInUrl,
                                                       @NotNull
                                                       Pattern issueKeyBoundaryRegex)

Description copied from interface: JiraIssueHelper

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).

Specified by:

findIssueKeysInTextAsList in interface JiraIssueHelper

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

getRenderedString

@Nullable
public String getRenderedString(@Nullable
                                          String inputString,
                                          @NotNull
                                          String buildKey,
                                          @NotNull
                                          Integer buildNumber)

Renders valid jira issues in the input string, valid issues are determined by what is stored in the BuildResultSummary

Parameters:

inputString -

buildKey -

buildNumber -

Returns:

getRenderedString

@Nullable
public String getRenderedString(@Nullable
                                          String inputString,
                                          @NotNull
                                          ImmutableResultsSummary resultsSummary)

Renders valid jira issues in the input string, valid issues are determined by what is stored in the BuildResultSummary

Parameters:

inputString -

resultsSummary -

Returns:

getRenderedString

@Nullable
public String getRenderedString(@Nullable
                                          String inputString,
                                          @NotNull
                                          DeploymentVersion deploymentVersion)

Renders valid jira issues in the input string, valid issues are determined by what is stored in the DeploymentVersion

Parameters:

inputString -

Returns:

getRenderedString

@Nullable
public String getRenderedString(@Nullable
                                          String inputString)

Renders any jira links within the input string

Parameters:

inputString -

Returns:

getJiraUrl

@Nullable
public static String getJiraUrl(@NotNull
                                          com.atlassian.applinks.api.ApplicationLink applicationLink,
                                          @NotNull
                                          String issueKey)

getJiraDisplayUrl

@Nullable
public static String getJiraDisplayUrl(@NotNull
                                                 com.atlassian.applinks.api.ApplicationLink applicationLink,
                                                 @NotNull
                                                 String issueKey)

getJiraIssueUrl

@NotNull
public static String getJiraIssueUrl(@NotNull
                                              String host,
                                              @NotNull
                                              JiraIssueKey issueKey,
                                              @Nullable
                                              JiraIssueUtils.JiraPanel panel)

getJiraIssueTitleText

protected String getJiraIssueTitleText()

getFilteredJiraIssues

@NotNull
public List<LinkedJiraIssue> getFilteredJiraIssues(@Nullable
                                                            Collection<LinkedJiraIssue> possibleIssues,
                                                            int numberNeeded)

Returns a required length list of jira issues and controls logic behind which are shown * Fixed issues are given preference This is needed so that only the required number of JIRA Issues will be retrieved from the jira server

Parameters:

possibleIssues -

numberNeeded -

Returns:

getFilteredFixedJiraIssues

@NotNull
public List<LinkedJiraIssue> getFilteredFixedJiraIssues(@Nullable
                                                                 Collection<LinkedJiraIssue> possibleIssues,
                                                                 int numberNeeded)

getFilteredRelatedJiraIssues

@NotNull
public List<LinkedJiraIssue> getFilteredRelatedJiraIssues(@Nullable
                                                                   Collection<LinkedJiraIssue> possibleIssues,
                                                                   int numberNeeded)

isJiraServerSetup

public boolean isJiraServerSetup()

Description copied from interface: JiraIssueHelper

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

Specified by:

isJiraServerSetup in interface JiraIssueHelper

buildJiraIssueDetailsFromSearchResultFunction

public static com.google.common.base.Function<JiraXmlSearchResultItemEntity,JiraIssueDetails> buildJiraIssueDetailsFromSearchResultFunction(@NotNull
                                                                                                                                            com.atlassian.applinks.api.ApplicationLink applicationLink,
                                                                                                                                            JiraIssueDetailsBuilderFactory jiraIssueDetailsBuilderFactory)

Returns function which builds JiraIssueDetails from JIRA XML search result

Returns:

Function

transformJiraIssueToJiraIssueKey

public static com.google.common.base.Function<InternalLinkedJiraIssue,String> transformJiraIssueToJiraIssueKey()

setAdministrationConfigurationAccessor

public void setAdministrationConfigurationAccessor(AdministrationConfigurationAccessor administrationConfigurationAccessor)