@PublicApi public class

ServiceUtils

extends Object
java.lang.Object
   ↳ com.atlassian.jira.service.util.ServiceUtils

@PublicApi

This class is designed for plugins to consume (call its methods).

Clients of @PublicApi can expect that programs compiled against a given version will remain binary compatible with later versions of the @PublicApi as per each product's API policy as long as the client does not implement/extend @PublicApi interfaces or classes (refer to each product's API policy for the exact guarantee---usually binary compatibility is guaranteed at least across minor versions).

Note: since @PublicApi interfaces and classes are not designed to be implemented or extended by clients, we may perform certain types of binary-incompatible changes to these classes and interfaces, but these will not affect well-behaved clients that do not extend/implement these types (in general, only classes and interfaces annotated with @PublicSpi are safe to extend/implement).

Summary

Public Methods
@Deprecated @Nullable static GenericValue findIssueInString(String searchString)
This method is deprecated. use findIssueObjectInString(String) instead
@Nullable static Issue findIssueObjectInString(String searchString)
Loops through the string and returns the issue that is found within, or null if there is no issue matching.
static Iterable<Issue> findIssueObjectsInString(String searchString)
@Deprecated static GenericValue[] findIssuesInString(String searchString)
This method is deprecated. use findIssueObjectsInString(String) instead
@Nullable @Deprecated static GenericValue getIssue(String key)
This method is deprecated. use getIssueObject(String) instead
@Nullable @Deprecated static Issue getIssueObject(String key)
This method is deprecated. Use getIssueObject(String) instead. Since v6.1.
static Map<StringString> getParameterMap(String parameterString)
This method creates a map of parameters from a string.
static String toParameterString(Map<StringString> params)
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

@Deprecated @Nullable public static GenericValue findIssueInString (String searchString)

This method is deprecated.
use findIssueObjectInString(String) instead

Loops through the string and returns the issue that is found within, or null if there is no issue matching.

It finds any string matching XXX-### and then looks it up to see if it is a valid issue. It will return the first valid issue that exists.

Parameters
searchString the string to search through for issues
Returns
  • the issue that has been found, or null of one is not found.

@Nullable public static Issue findIssueObjectInString (String searchString)

Loops through the string and returns the issue that is found within, or null if there is no issue matching.

It finds any string matching XXX-### and then looks it up to see if it is a valid issue. It will return the first valid issue that exists.

Parameters
searchString the string to search through for issues
Returns
  • the issue that has been found, or null of one is not found.

public static Iterable<Issue> findIssueObjectsInString (String searchString)

@Deprecated public static GenericValue[] findIssuesInString (String searchString)

This method is deprecated.
use findIssueObjectsInString(String) instead

@Nullable @Deprecated public static GenericValue getIssue (String key)

This method is deprecated.
use getIssueObject(String) instead

Given an actual key - return the issue that matches that key, or null if no issues match that key.

@Nullable @Deprecated public static Issue getIssueObject (String key)

This method is deprecated.
Use getIssueObject(String) instead. Since v6.1.

Given an actual key - return the issue that matches that key, or null if no issues match that key.

public static Map<StringString> getParameterMap (String parameterString)

This method creates a map of parameters from a string.

The format of the string is key=value, key=value, key=value.

At the moment this is really only used for Handler parameters, but that whole area needs to be rewritten for JIRA 2.0.

public static String toParameterString (Map<StringString> params)