org.glassfish.deployment.versioning
Class VersioningUtils

java.lang.Object
  org.glassfish.deployment.versioning.VersioningUtils

public class VersioningUtils
extends java.lang.Object

This class provides utility methods to handle application names in the versioning context

Author:

Romain GRECOURT - SERLI (romain.grecourt@serli.com)

Field Summary

static java.lang.String	EXPRESSION_SEPARATOR
static java.lang.String	EXPRESSION_WILDCARD
static LocalStringManagerImpl	LOCALSTRINGS
static java.lang.String	REPOSITORY_DASH

Constructor Summary

VersioningUtils()

Method Summary

static void	checkIdentifier(java.lang.String appName) Check a versionned application name.
static java.lang.String	getExpression(java.lang.String appName) Extract the version identifier / expression for a given application name that complies with versioning rules.
static java.lang.String	getRepositoryName(java.lang.String appName) Replaces colons with dashs in the given application name.
static java.lang.String	getUntaggedName(java.lang.String appName) Extract the untagged name for a given application name that complies with versioning rules (version identifier / expression) or not.
static java.util.List<java.lang.String>	getVersions(java.lang.String untaggedName, java.util.List<Application> allApplications) Extract the set of version(s) of the given application from a set of applications.
static java.lang.Boolean	isUntagged(java.lang.String appName) Test if the given application name is an untagged name
static java.lang.Boolean	isVersionExpression(java.lang.String appName) Test if the given application name is a version expression
static java.lang.Boolean	isVersionExpressionWithWildCard(java.lang.String appName) Test if the given application name is a version expression containing any wildcard character.
static java.lang.Boolean	isVersionIdentifier(java.lang.String appName) Test if the given application name is a version identifier.
static java.util.List<java.lang.String>	matchExpression(java.util.List<java.lang.String> listVersion, java.lang.String appName) Search for the version(s) matched by the expression contained in the given application name.

Methods inherited from class java.lang.Object

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

Field Detail

LOCALSTRINGS

public static final LocalStringManagerImpl LOCALSTRINGS

EXPRESSION_SEPARATOR

public static final java.lang.String EXPRESSION_SEPARATOR

See Also:

Constant Field Values

EXPRESSION_WILDCARD

public static final java.lang.String EXPRESSION_WILDCARD

See Also:

Constant Field Values

REPOSITORY_DASH

public static final java.lang.String REPOSITORY_DASH

See Also:

Constant Field Values

Constructor Detail

VersioningUtils

public VersioningUtils()

Method Detail

getUntaggedName

public static final java.lang.String getUntaggedName(java.lang.String appName)
                                              throws VersioningSyntaxException

Extract the untagged name for a given application name that complies with versioning rules (version identifier / expression) or not. If the application name is using versioning rules, the method will split the application names with the colon character and retrieve the untagged name from the first token. Else the given application name is an untagged name.

Parameters:

appName - the application name

Returns:

the untagged version name

Throws:

VersioningSyntaxException - if the given application name had some critical patterns.

getExpression

public static final java.lang.String getExpression(java.lang.String appName)
                                            throws VersioningSyntaxException

Extract the version identifier / expression for a given application name that complies with versioning rules. The method splits the application name with the colon character and retrieve the 2nd token.

Parameters:

appName - the application name

Returns:

the version identifier / expression extracted from application name

Throws:

VersioningSyntaxException - if the given application name had some critical patterns.

checkIdentifier

public static final void checkIdentifier(java.lang.String appName)
                                  throws VersioningException

Check a versionned application name. This method is used to provide consistant error messages for identifier aware operations.

Parameters:

appName - the application name

Throws:

VersioningSyntaxException - if the given application name had some critical patterns.

VersioningException - if the given application name had some wildcard character(s) in its identifier part.

getVersions

public static final java.util.List<java.lang.String> getVersions(java.lang.String untaggedName,
                                                                 java.util.List<Application> allApplications)

Extract the set of version(s) of the given application from a set of applications. This method is used by unit tests.

Parameters:

untaggedName - the application name as an untagged version : an application name without version identifier

allApplications - the set of applications

Returns:

all the version(s) of the given application in the given set of applications

matchExpression

public static final java.util.List<java.lang.String> matchExpression(java.util.List<java.lang.String> listVersion,
                                                                     java.lang.String appName)
                                                              throws VersioningException

Search for the version(s) matched by the expression contained in the given application name. This method is used by unit tests.

Parameters:

listVersion - the set of all versions of the application

appName - the application name containing the expression

Returns:

the expression matched list

Throws:

VersioningException - if the expression is an identifier matching a version not registered, or if getExpression throws an exception

getRepositoryName

public static final java.lang.String getRepositoryName(java.lang.String appName)

Replaces colons with dashs in the given application name.

Parameters:

appName - the application name

Returns:

a valid repository name

isUntagged

public static final java.lang.Boolean isUntagged(java.lang.String appName)
                                          throws VersioningSyntaxException

Test if the given application name is an untagged name

Parameters:

appName - the application name

Returns:

true is the given application name is not versioned

Throws:

VersioningSyntaxException - if getUntaggedName throws exception

isVersionExpression

public static final java.lang.Boolean isVersionExpression(java.lang.String appName)
                                                   throws VersioningSyntaxException

Test if the given application name is a version expression

Parameters:

appName - the application name

Returns:

true if the appName is a version expression

Throws:

VersioningSyntaxException - if isUntaggedName throws exception

isVersionExpressionWithWildCard

public static final java.lang.Boolean isVersionExpressionWithWildCard(java.lang.String appName)
                                                               throws VersioningSyntaxException

Test if the given application name is a version expression containing any wildcard character. That is to say the version expression is matching more than one version.

Parameters:

appName - the application name

Returns:

true if the appName is a version expression matching more than one version.

Throws:

VersioningSyntaxException - if isVersionExpression throws exception

isVersionIdentifier

public static final java.lang.Boolean isVersionIdentifier(java.lang.String appName)
                                                   throws VersioningSyntaxException

Test if the given application name is a version identifier.

Parameters:

appName - the application name

Returns:

true if the appName is a version identifier

Throws:

VersioningSyntaxException - if isVersionExpression throws exception