com.atlassian.jira.upgrade

Interface BuildVersionRegistry

All Known Implementing Classes:

DefaultBuildVersionRegistry

public interface BuildVersionRegistry

Resolves build numbers to versions of JIRA.

Since:

v4.1

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	BuildVersionRegistry.BuildVersion Simple result object for representing the build number and version together.

Method Summary

Modifier and Type	Method and Description
BuildVersionRegistry.BuildVersion	getBuildNumberForVersion(String version) Takes a version string and attempts to resolve it to a released (or unreleased during development) build number of JIRA.
BuildVersionRegistry.BuildVersion	getVersionForBuildNumber(int buildNumber) Takes a build number and attempts to resolve it to a released (or unreleased during development) version of JIRA.
BuildVersionRegistry.BuildVersion	getVersionForBuildNumber(String buildNumber) Deprecated. Use getVersionForBuildNumber(int) instead

Method Detail

getVersionForBuildNumber

BuildVersionRegistry.BuildVersion getVersionForBuildNumber(int buildNumber)

Takes a build number and attempts to resolve it to a released (or unreleased during development) version of JIRA. If the build number does not directly correspond to a released version of JIRA, we attempt to infer the version by searching for the next known build number above the input.

For example, if the build number is 207, the version returned would be 3.8, as it has a build number of 209. In this case, the resulting BuildVersionRegistry.BuildVersion object will have a build number corresponding to the target build number and not the input build number, as the target build number is the official number against that version.

If the input build number is higher than any known build number, we return the currently running version of JIRA.

Parameters:

buildNumber - the build number to look up

Returns:

the version that corresponds to this build number.

getVersionForBuildNumber

@Deprecated
BuildVersionRegistry.BuildVersion getVersionForBuildNumber(String buildNumber)

Deprecated. Use getVersionForBuildNumber(int) instead

Takes a build number and attempts to resolve it to a released (or unreleased during development) version of JIRA. If the build number does not directly correspond to a released version of JIRA, we attempt to infer the version by searching for the next known build number above the input.

For example, if the build number is 207, the version returned would be 3.8, as it has a build number of 209. In this case, the resulting BuildVersionRegistry.BuildVersion object will have a build number corresponding to the target build number and not the input build number, as the target build number is the official number against that version.

If the input build number is higher than any known build number, we return the currently running version of JIRA.

Parameters:

buildNumber - the build number to look up; must be not null and parseable to an integer.

Returns:

the version that corresponds to this build number.

getBuildNumberForVersion

BuildVersionRegistry.BuildVersion getBuildNumberForVersion(String version)

Takes a version string and attempts to resolve it to a released (or unreleased during development) build number of JIRA. If the version string does not directly correspond to a released build number, return MAX_INT

Parameters:

version - the version string to look up (e.g. 6.0.5); must be not null.

Returns:

the build number that corresponds to this version.