com.atlassian.jira.util
Class JiraKeyUtils

java.lang.Object
  com.atlassian.jira.util.JiraKeyUtils

public class JiraKeyUtils
extends Object

Nested Class Summary

static interface

JiraKeyUtils.KeyMatcher

Field Summary

static String

STRIKE_THROUGH_CLOSED_KEYS

Constructor Summary

JiraKeyUtils()

Method Summary

static long	getCountFromKey(String key)
static long	getFastCountFromKey(String key) Same as getCountFromKey(String) except that is does not check for key validity
static String	getFastProjectKeyFromIssueKey(String key) Same as getProjectKeyFromIssueKey(String) except that it does not check key validity
static String	getIssueKeyRegex()
static List<String>	getIssueKeysFromString(String body)
static String	getProjectKeyFromIssueKey(String key) Returns a project key of the project given issue belongs to.
static boolean	isKeyInString(String s) Determines whether any JIRA issue key is in the given string
static boolean	isKeyInString(String issueKey, String body) Determines whether the provided key is part of the provided string
static boolean	isPartOfUrl(String body, int start)
static boolean	isReservedKeyword(String key) Check if the Project Key matches a list of reserved keywords - JRA-8051.
static String	linkBugKeys(String body)
static void	resetKeyMatcher() Resets the configuration of the key matcher so that it will re-read the ApplicationProperty that specifies how to find an issue key in a string.
static boolean	validIssueKey(String key) Validates the given issue key.
static boolean	validProjectKey(String key) Validates the given project key and returns true if valid, false otherwise.

Methods inherited from class java.lang.Object

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

Field Detail

STRIKE_THROUGH_CLOSED_KEYS

public static final String STRIKE_THROUGH_CLOSED_KEYS

See Also:

Constant Field Values

Constructor Detail

JiraKeyUtils

public JiraKeyUtils()

Method Detail

resetKeyMatcher

public static void resetKeyMatcher()

Resets the configuration of the key matcher so that it will re-read the ApplicationProperty that specifies how to find an issue key in a string. This must be called if the property for representing the key matching regular expression is changed during runtime.

validProjectKey

public static boolean validProjectKey(String key)

Validates the given project key and returns true if valid, false otherwise.

Parameters:

key - project key to validate

Returns:

True if the supplied project key is valid

isReservedKeyword

public static boolean isReservedKeyword(String key)

Check if the Project Key matches a list of reserved keywords - JRA-8051. For example, a folder named 'CON' cannot be created in WINDOWS as it is a reserved word.

This check is only enabled for WINDOWS machines at present as this issue has only been reported in the WINDOWS environment.

Parameters:

key - project key

Returns:

true if reserved word, false otherwise

getProjectKeyFromIssueKey

public static String getProjectKeyFromIssueKey(String key)

Returns a project key of the project given issue belongs to.

Parameters:

key - issue key

Returns:

The project key from an issue key, or null if the key is invalid

getFastProjectKeyFromIssueKey

public static String getFastProjectKeyFromIssueKey(String key)

Same as getProjectKeyFromIssueKey(String) except that it does not check key validity

Parameters:

key - issue key

Returns:

The project key from an issue key, or null if the key is invalid

getFastCountFromKey

public static long getFastCountFromKey(String key)

Same as getCountFromKey(String) except that is does not check for key validity

Parameters:

key - issue key

Returns:

The issue count from an issue key, or -1 if the key is invalid

getCountFromKey

public static long getCountFromKey(String key)

Parameters:

key - issue key

Returns:

The issue count from an issue key, or -1 if the key is invalid

validIssueKey

public static boolean validIssueKey(String key)

Validates the given issue key.

Parameters:

key - issue key

Returns:

True if the supplied issue key starts with a valid project key, and ends with a number

isKeyInString

public static boolean isKeyInString(String issueKey,
                                    String body)

Determines whether the provided key is part of the provided string

Parameters:

issueKey - issue key

body - string to check

Returns:

true if the given key is in the body, false otherwise

isKeyInString

public static boolean isKeyInString(String s)

Determines whether any JIRA issue key is in the given string

Parameters:

s - string to check

Returns:

true if a key was found, false otherwise

linkBugKeys

public static String linkBugKeys(String body)

getIssueKeysFromString

public static List<String> getIssueKeysFromString(String body)

isPartOfUrl

public static boolean isPartOfUrl(String body,
                                  int start)

getIssueKeyRegex

public static String getIssueKeyRegex()