net.sf.mmm.util.version.api

Enum DevelopmentPhase

java.lang.Object

java.lang.Enum<DevelopmentPhase>

net.sf.mmm.util.version.api.DevelopmentPhase

All Implemented Interfaces:

Serializable, Comparable<DevelopmentPhase>, AttributeReadValue<String>, Datatype, SimpleDatatype<String>

public enum DevelopmentPhase
extends Enum<DevelopmentPhase>
implements SimpleDatatype<String>

A DevelopmentPhase represents the state of development of an artifact.

Since:

3.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

See Also:

VersionIdentifier.getPhase()

Enum Constant Summary

Enum Constants

Enum Constant and Description
ALPHA This DevelopmentPhase aims to given an early preview of the product and to allow first testings (by "friendly users").
BETA This DevelopmentPhase already gives a good impression of the final release but is still containing bugs and may not be fully complete while all major features should be included.
PRE_ALPHA This is the earliest DevelopmentPhase in the development cycle.
RELEASE This DevelopmentPhase is feature complete and has passed acceptance tests.
RELEASE_CANDIDATE This DevelopmentPhase is feature complete but may contain some last bugs while known bugs should already be fixed.
UPDATE This DevelopmentPhase is like RELEASE but may be used for bugfixes or tiny improvements of the released product version.

Field Summary

Fields

Modifier and Type	Field and Description
private String[]	alternatives
private String	stringRepresentation
private String	value

Method Summary

Modifier and Type	Method and Description
static DevelopmentPhase	fromValue(String value) This method gets the DevelopmentPhase with the given value.
String[]	getAlternatives() This method gets the alternatives.
String	getValue() This method returns the raw value of this datatype.
boolean	isAfter(DevelopmentPhase phase) This method determines if this DevelopmentPhase is after the given phase.
boolean	isBefore(DevelopmentPhase phase) This method determines if this DevelopmentPhase is before the given phase.
String	toString() Returns the official String representation of this Datatype.
static DevelopmentPhase	valueOf(String name) Returns the enum constant of this type with the specified name.
static DevelopmentPhase[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

PRE_ALPHA

public static final DevelopmentPhase PRE_ALPHA

This is the earliest DevelopmentPhase in the development cycle. In this DevelopmentPhase the software is typically very unstable, experimental, and the focus is on creating new functionality.
This DevelopmentPhase is sometimes also just called development but this is quite ambiguous as development happens in all DevelopmentPhases.

ALPHA

public static final DevelopmentPhase ALPHA

This DevelopmentPhase aims to given an early preview of the product and to allow first testings (by "friendly users"). Therefore this DevelopmentPhase has focus on gathering feedback.
This DevelopmentPhase is sometimes also called developer preview (DP) .

BETA

public static final DevelopmentPhase BETA

This DevelopmentPhase already gives a good impression of the final release but is still containing bugs and may not be fully complete while all major features should be included. Therefore this DevelopmentPhase has focus on stabilization of the product.
This DevelopmentPhase is sometimes also called early access (EA).

RELEASE_CANDIDATE

public static final DevelopmentPhase RELEASE_CANDIDATE

This DevelopmentPhase is feature complete but may contain some last bugs while known bugs should already be fixed. If all acceptance tests are passed, the RELEASE is reached. Therefore this DevelopmentPhase has focus on finalization of the product.
This DevelopmentPhase is sometimes also just called pre-release or gamma (while gamma may be somewhere in between of BETA and RELEASE_CANDIDATE).

RELEASE

public static final DevelopmentPhase RELEASE

This DevelopmentPhase is feature complete and has passed acceptance tests. For productive usage only product releases in this phase or after are officially intended. Please note that also a release can obviously still have bugs.
This DevelopmentPhase is sometimes also just called final, stable, gold, release to manufacturing (RTM) or general availability (GA).

UPDATE

public static final DevelopmentPhase UPDATE

This DevelopmentPhase is like RELEASE but may be used for bugfixes or tiny improvements of the released product version.
This is sometimes called service release (SR) or service pack (SP).

Field Detail

stringRepresentation

private final String stringRepresentation

value

private final String value

alternatives

private final String[] alternatives

Method Detail

values

public static DevelopmentPhase[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (DevelopmentPhase c : DevelopmentPhase.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static DevelopmentPhase valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getValue

public String getValue()

Description copied from interface: SimpleDatatype

This method returns the raw value of this datatype. This will typically be a standard datatype (like String , Character, Boolean, any type of Number, any type of java.time.LocalDate, etc.).

Specified by:

getValue in interface AttributeReadValue<String>

Specified by:

getValue in interface SimpleDatatype<String>

Returns:

the value of this datatype.

getAlternatives

public String[] getAlternatives()

This method gets the alternatives. On each call of this method a copy of the internal array is created.

Returns:

an array with string representations alternative to string representation and value. May be empty.

isBefore

public boolean isBefore(DevelopmentPhase phase)

This method determines if this DevelopmentPhase is before the given phase. Here before means that it is earlier and typically less stable.

Parameters:

phase - is the DevelopmentPhase to compare with.

Returns:

true if this phase is before the given phase, false otherwise (also if phase is null).

isAfter

public boolean isAfter(DevelopmentPhase phase)

This method determines if this DevelopmentPhase is after the given phase. Here after means that it is later and typically more stable.

Parameters:

phase - is the DevelopmentPhase to compare with.

Returns:

true if this phase is after the given phase, false otherwise (also if phase is null).

fromValue

public static DevelopmentPhase fromValue(String value)

This method gets the DevelopmentPhase with the given value.

Parameters:

value - is the value of the requested DevelopmentPhase.

Returns:

the requested DevelopmentPhase or null if it does not exists.

toString

public String toString()

Description copied from interface: Datatype

Returns the official String representation of this Datatype. While the general contract of Object.toString() is very weak and mainly used for debugging, the contract here is very strong. The returned String has to be suitable for end-users and official output to any kind of sink.
ATTENTION:
This method is not supposed to do internationalization (I18N). See NlsMessage for this purpose and implement NlsObject if you want to support I18N/L10N.

Specified by:

toString in interface Datatype

Overrides:

toString in class Enum<DevelopmentPhase>

Returns:

the official String representation to display the value of this Datatype.