com.atlassian.bamboo.jira.jiraissues

Class JiraIssueUtils

java.lang.Object

com.atlassian.bamboo.jira.jiraissues.JiraIssueUtils

public class JiraIssueUtils
extends Object

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 String	PROJECT_ISSUE_NUMBER_SEPARATOR
static String	RENDERED_JIRA_KEY
static String	RENDERED_JIRA_KEY_NO_SERVER

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) Find the JIRA issue keys within the given string.
Collection<String>	findIssueKeysInText(String string) Find the and JIRA issue keys within the given string.
Set<String>	findIssueKeysInText(String string, boolean ignoreIfInUrl) Find the and JIRA issue keys within the given string.
List<String>	findIssueKeysInTextAsList(String string, boolean ignoreIfInUrl) 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()
boolean	isValidIssueKey(String string) Checks whether a given string is 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

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)

Checks whether a given string is a valid issue key

Parameters:

string -

Returns:

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 Collection<String> findIssueKeysInText(@NotNull
                                                       String string)

Find the and JIRA issue keys within the given string.

Parameters:

string -

Returns:

A Collection of JIRA Issue Keys

findIssueKeysInText

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

Find the and JIRA issue keys within the given string.

Parameters:

string -

ignoreIfInUrl -

Returns:

A Collection of JIRA Issue Keys

findIssueKeys

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

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

findIssueKeysInTextAsList

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

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

Parameters:

string -

ignoreIfInUrl -

Returns:

An ordered set 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()

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)