com.phloc.commons.state

Enum ETriState

java.lang.Object

java.lang.Enum<ETriState>

com.phloc.commons.state.ETriState

All Implemented Interfaces:

IHasID<String>, ITriState, Serializable, Comparable<ETriState>

public enum ETriState
extends Enum<ETriState>
implements IHasID<String>, ITriState

Represents an object that has one of 3 different states compared to a boolean that has only 2 different states.

Author:

Philip Helger

Enum Constant Summary

Enum Constants

Enum Constant and Description
FALSE
TRUE
UNDEFINED

Method Summary

Methods

Modifier and Type	Method and Description
Boolean	getAsBooleanObj(boolean aUndefinedValue)
Boolean	getAsBooleanObj(Boolean aUndefinedValue) Convert the tri state value into a Boolean value, depending on what "undefined" means.
boolean	getAsBooleanValue(boolean bUndefinedValue) Convert the tri state value into a boolean value, depending on what "undefined" means.
static ETriState	getFromIDOrDefault(String sID, ETriState eDefault)
static ETriState	getFromIDOrNull(String sID)
static ETriState	getFromIDOrUndefined(String sID)
String	getID() Get the unique ID of this object.
boolean	isDefined()
boolean	isFalse()
boolean	isTrue()
boolean	isUndefined()
static ETriState	valueOf(boolean bValue)
static ETriState	valueOf(Boolean aValue)
static ETriState	valueOf(ITriState aTriState)
static ETriState	valueOf(String name) Returns the enum constant of this type with the specified name.
static ETriState[]	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, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

TRUE

public static final ETriState TRUE

FALSE

public static final ETriState FALSE

UNDEFINED

public static final ETriState UNDEFINED

Method Detail

values

public static ETriState[] 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 (ETriState c : ETriState.values())
    System.out.println(c);

Returns:

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

valueOf

public static ETriState 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

getID

@Nonnull
@Nonempty
public String getID()

Description copied from interface: IHasID

Get the unique ID of this object. If the type is String than the returned value must match an XML NMToken expression (so e.g. no ':' in the ID)!

Specified by:

getID in interface IHasID<String>

Returns:

The ID of this object. May not be null.

isTrue

public boolean isTrue()

Specified by:

isTrue in interface ITriState

Returns:

true if the value is true.

isFalse

public boolean isFalse()

Specified by:

isFalse in interface ITriState

Returns:

true if the value is false

isDefined

public boolean isDefined()

Specified by:

isDefined in interface ITriState

Returns:

true if the value is not undefined (if it is either true or false)

isUndefined

public boolean isUndefined()

Specified by:

isUndefined in interface ITriState

Returns:

true if the value is undefined (if it is neither true nor false)

getAsBooleanValue

public boolean getAsBooleanValue(boolean bUndefinedValue)

Description copied from interface: ITriState

Convert the tri state value into a boolean value, depending on what "undefined" means.

Specified by:

getAsBooleanValue in interface ITriState

Parameters:

bUndefinedValue - The boolean representation of undefined.

Returns:

true if ITriState.isTrue() is true, false if ITriState.isFalse() is true, or otherwise the passed parameter!

getAsBooleanObj

@Nullable
public Boolean getAsBooleanObj(boolean aUndefinedValue)

getAsBooleanObj

@Nullable
public Boolean getAsBooleanObj(@Nullable
                               Boolean aUndefinedValue)

Description copied from interface: ITriState

Convert the tri state value into a Boolean value, depending on what "undefined" means.

Specified by:

getAsBooleanObj in interface ITriState

Parameters:

aUndefinedValue - The Boolean representation of undefined.

Returns:

Boolean.TRUE if ITriState.isTrue() is true, Boolean.FALSE if ITriState.isFalse() is true, or otherwise the passed parameter!

valueOf

@Nonnull
public static ETriState valueOf(boolean bValue)

valueOf

@Nonnull
public static ETriState valueOf(@Nullable
                        Boolean aValue)

valueOf

@Nonnull
public static ETriState valueOf(@Nonnull
                        ITriState aTriState)

getFromIDOrNull

@Nullable
public static ETriState getFromIDOrNull(@Nullable
                                 String sID)

getFromIDOrUndefined

@Nonnull
public static ETriState getFromIDOrUndefined(@Nullable
                                     String sID)

getFromIDOrDefault

@Nullable
public static ETriState getFromIDOrDefault(@Nullable
                                    String sID,
                                    @Nullable
                                    ETriState eDefault)