com.solidfire.core.client

Class VersioningUtils

java.lang.Object

com.solidfire.core.client.VersioningUtils

public class VersioningUtils
extends java.lang.Object

Helper methods for determining if the version of a connection is compatible with a constructor, service method, or parameters.

Constructor Summary

Constructors

Constructor and Description
VersioningUtils()

Method Summary

Modifier and Type	Method and Description
static <T> java.util.List<java.lang.reflect.Method>	getMethodsOfGreaterVersion(T object, java.lang.String baseVersion) Creates a list of version annotated methods, greater than a base version, for a given object.
static <T> java.util.Map<java.lang.reflect.Method,java.lang.Object>	getValuesOfMethodsWithGreaterVersion(T object, java.lang.String baseVersion) Creates a map of version annotated methods, greater than a base version, for a given object, and the values returned by each method
static java.lang.String	getVersionFromEndpoint(java.net.URL endpoint) Extracts the Element OS version from a URL endpoint
static boolean	isVersionGreater(java.lang.String baseVersion, java.lang.String checkedVersion) Confirms a version string is greater than a base version string
static boolean	isVersionGreaterOrEqual(java.lang.String baseVersion, java.lang.String checkedVersion) Confirms a version string is greater than or equal to a base version string
static boolean	isVersionLess(java.lang.String baseVersion, java.lang.String checkedVersion) Confirms a version string is less than a base version string
static boolean	isVersionLessOrEqual(java.lang.String baseVersion, java.lang.String checkedVersion) Confirms a version string is less than or equal to a base version string
static boolean	isVersionString(java.lang.String possibleVersion) Checks the format of the version.
static <T> java.util.Map<java.lang.String,java.lang.reflect.Constructor<T>>	mapConstructorVersions(T object) Creates a map of version annotated constructors for a given object.
static <T> java.util.Map<java.lang.String,java.lang.reflect.Constructor<T>>	mapConstructorVersionsLargerThan(T object, java.lang.String baseVersion) Creates a map of version annotated constructors, greater than a base version, for a given object.
static java.lang.String	methodParametersToString(java.util.Collection<java.lang.reflect.Method> methods) Creates a concatenated string of parameter names, from a collection of methods
static java.util.List<java.lang.String>	transformMethodsToParameterNames(java.util.List<java.lang.reflect.Method> methods) Creates a list of parameter names from a list of methods

Methods inherited from class java.lang.Object

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

Constructor Detail

VersioningUtils

public VersioningUtils()

Method Detail

getVersionFromEndpoint

public static java.lang.String getVersionFromEndpoint(java.net.URL endpoint)

Extracts the Element OS version from a URL endpoint

Parameters:

endpoint - an Element OS connection endpoint

Returns:

the version of the connection endpoint

isVersionString

public static boolean isVersionString(java.lang.String possibleVersion)

Checks the format of the version. Format: XXX.XX

Parameters:

possibleVersion - a possible Version string

Returns:

true if the string matches the version format, otherwise false

isVersionGreater

public static boolean isVersionGreater(java.lang.String baseVersion,
                                       java.lang.String checkedVersion)

Confirms a version string is greater than a base version string

Parameters:

baseVersion - the base version for comparison

checkedVersion - the version of comparison

Returns:

true if the checked version is greater than the base version, otherwise false

isVersionGreaterOrEqual

public static boolean isVersionGreaterOrEqual(java.lang.String baseVersion,
                                              java.lang.String checkedVersion)

Confirms a version string is greater than or equal to a base version string

Parameters:

baseVersion - the base version for comparison

checkedVersion - the version of comparison

Returns:

true if the checked version is greater than or equal to the base version, otherwise false

isVersionLess

public static boolean isVersionLess(java.lang.String baseVersion,
                                    java.lang.String checkedVersion)

Confirms a version string is less than a base version string

Parameters:

baseVersion - the base version for comparison

checkedVersion - the version of comparison

Returns:

true if the checked version is less than the base version, otherwise false

isVersionLessOrEqual

public static boolean isVersionLessOrEqual(java.lang.String baseVersion,
                                           java.lang.String checkedVersion)

Confirms a version string is less than or equal to a base version string

Parameters:

baseVersion - the base version for comparison

checkedVersion - the version of comparison

Returns:

true if the checked version is less than or equal to the base version, otherwise false

mapConstructorVersions

public static <T> java.util.Map<java.lang.String,java.lang.reflect.Constructor<T>> mapConstructorVersions(T object)

Creates a map of version annotated constructors for a given object.

Parameters:

object - an object with one or more constructors annotated with the @Since annotation

Returns:

the map of constructor versions (key), and constructors (value)

mapConstructorVersionsLargerThan

public static <T> java.util.Map<java.lang.String,java.lang.reflect.Constructor<T>> mapConstructorVersionsLargerThan(T object,
                                                                                                                    java.lang.String baseVersion)

Creates a map of version annotated constructors, greater than a base version, for a given object.

Parameters:

object - an object with one or more constructors annotated with the @Since annotation

baseVersion - the base version for comparison

Returns:

the map of constructor versions greater than the base version (key), and constructors (value)

getMethodsOfGreaterVersion

public static <T> java.util.List<java.lang.reflect.Method> getMethodsOfGreaterVersion(T object,
                                                                                      java.lang.String baseVersion)

Creates a list of version annotated methods, greater than a base version, for a given object.

Parameters:

object - an object with one or more methods annotated with the @Since annotation

baseVersion - the base version for comparison

Returns:

the list of methods with versions greater than the base version

getValuesOfMethodsWithGreaterVersion

public static <T> java.util.Map<java.lang.reflect.Method,java.lang.Object> getValuesOfMethodsWithGreaterVersion(T object,
                                                                                                                java.lang.String baseVersion)

Creates a map of version annotated methods, greater than a base version, for a given object, and the values returned by each method

Parameters:

object - an object with one or more methods annotated with the @Since annotation

baseVersion - the base version for comparison

Returns:

the map of methods with versions greater than the base version (key), and the value returned by each method (value)

transformMethodsToParameterNames

public static java.util.List<java.lang.String> transformMethodsToParameterNames(java.util.List<java.lang.reflect.Method> methods)

Creates a list of parameter names from a list of methods

Parameters:

methods - a list of methods

Returns:

a list of parameter names

methodParametersToString

public static java.lang.String methodParametersToString(java.util.Collection<java.lang.reflect.Method> methods)

Creates a concatenated string of parameter names, from a collection of methods

Parameters:

methods - a collection of methods

Returns:

a single string containing all corresponding parameter names