net.ossindex.version

Class VersionFactory

java.lang.Object

net.ossindex.version.VersionFactory

public class VersionFactory
extends Object

This factory provides an appropriate version implementation for specified version strings.

Author:

Ken Duck

Method Summary

Modifier and Type	Method and Description
IVersionRange	getRange(Collection<String> versions) Join this set of ranges together.
IVersionRange	getRange(String vstring) Get a version range
IVersionRange	getRange(String[] versions) Join this set of ranges together.
static VersionFactory	getStrictVersionFactory() Get a strict version factory.
IVersion	getVersion(String vstring) Get a version implementation.
IVersion	getVersion(String hint, String version) Get a version implementation.
static VersionFactory	getVersionFactory() Version factory, which is really not needed since we have all static methods now.
boolean	isMavenRange(String vstring)
IVersionRange	merge(IVersionRange... ranges) Given two "or" ranges or "simple" ranges, merge them together.

Methods inherited from class java.lang.Object

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

Method Detail

getVersionFactory

public static VersionFactory getVersionFactory()

Version factory, which is really not needed since we have all static methods now.

Returns:

The instance of the version factory

getStrictVersionFactory

public static VersionFactory getStrictVersionFactory()

Get a strict version factory. Strict means no versions can fall through to a named version. Every version needs to cleanly parse.

getVersion

public IVersion getVersion(String vstring)
                    throws InvalidRangeException

Get a version implementation. Return the best match for the provided string.

Parameters:

vstring - A string version to be parsed

Returns:

A version implementation

Throws:

InvalidRangeException

getVersion

public IVersion getVersion(String hint,
                           String version)
                    throws InvalidRangeException

Get a version implementation. A hint may be provided to help choose the best implementation.

Parameters:

hint - Hint of the version style

version - A string version to be parsed

Returns:

A version implementation

Throws:

InvalidRangeException

getRange

public IVersionRange getRange(String vstring)
                       throws InvalidRangeException

Get a version range

Throws:

InvalidRangeException

getRange

public IVersionRange getRange(String[] versions)
                       throws InvalidRangeException

Join this set of ranges together. This could result in a set, or in a logical range.

Throws:

InvalidRangeException

getRange

public IVersionRange getRange(Collection<String> versions)
                       throws InvalidRangeException

Join this set of ranges together. This could result in a set, or in a logical range.

Throws:

InvalidRangeException

isMavenRange

public boolean isMavenRange(String vstring)
                     throws InvalidRangeException

Throws:

InvalidRangeException

merge

public IVersionRange merge(IVersionRange... ranges)

Given two "or" ranges or "simple" ranges, merge them together. We are assuming that the ranges are provided in order for now. For example: >1.0.0 merged with (<2.0.0 | >3.0.0) will become (>1.0.0 <2.0.0 | >3.0.0)