Package org.apache.commons.lang3

Class EnumUtils

java.lang.Object

org.apache.commons.lang3.EnumUtils

public class EnumUtils
extends java.lang.Object

Utility library to provide helper methods for Java enums.

#ThreadSafe#

Since:

3.0

Constructor Summary

Constructors

Constructor	Description
EnumUtils()	This constructor is public to permit tools that require a JavaBean instance to operate.

Method Summary

Modifier and Type	Method	Description
static <E extends java.lang.Enum<E>> long	generateBitVector(java.lang.Class<E> enumClass, E... values)	Creates a long bit vector representation of the given array of Enum values.
static <E extends java.lang.Enum<E>> long	generateBitVector(java.lang.Class<E> enumClass, java.lang.Iterable<? extends E> values)	Creates a long bit vector representation of the given subset of an Enum.
static <E extends java.lang.Enum<E>> E	getEnum(java.lang.Class<E> enumClass, java.lang.String enumName)	Gets the enum for the class, returning null if not found.
static <E extends java.lang.Enum<E>> E	getEnum(java.lang.Class<E> enumClass, java.lang.String enumName, E defaultEnum)	Gets the enum for the class, returning defaultEnum if not found.
static <E extends java.lang.Enum<E>> E	getEnumIgnoreCase(java.lang.Class<E> enumClass, java.lang.String enumName)	Gets the enum for the class, returning null if not found.
static <E extends java.lang.Enum<E>> E	getEnumIgnoreCase(java.lang.Class<E> enumClass, java.lang.String enumName, E defaultEnum)	Gets the enum for the class, returning defaultEnum if not found.
static <E extends java.lang.Enum<E>> java.util.List<E>	getEnumList(java.lang.Class<E> enumClass)	Gets the List of enums.
static <E extends java.lang.Enum<E>> java.util.Map<java.lang.String,E>	getEnumMap(java.lang.Class<E> enumClass)	Gets the Map of enums by name.
static <E extends java.lang.Enum<E>> boolean	isValidEnum(java.lang.Class<E> enumClass, java.lang.String enumName)	Checks if the specified name is a valid enum for the class.
static <E extends java.lang.Enum<E>> boolean	isValidEnumIgnoreCase(java.lang.Class<E> enumClass, java.lang.String enumName)	Checks if the specified name is a valid enum for the class.

Methods inherited from class java.lang.Object

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

Constructor Detail

EnumUtils

public EnumUtils()

This constructor is public to permit tools that require a JavaBean instance to operate.

Method Detail

generateBitVector

@SafeVarargs
public static <E extends java.lang.Enum<E>> long generateBitVector(java.lang.Class<E> enumClass,
                                                                   E... values)

Creates a long bit vector representation of the given array of Enum values.

This generates a value that is usable by EnumUtils#processBitVector.

Do not use this method if you have more than 64 values in your Enum, as this would create a value greater than a long can hold.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum we are working with, not null

values - the values we want to convert, not null

Returns:

a long whose value provides a binary representation of the given set of enum values.

Throws:

java.lang.NullPointerException - if enumClass or values is null

java.lang.IllegalArgumentException - if enumClass is not an enum class or has more than 64 values

Since:

3.0.1

See Also:

#generateBitVectors(Class, Iterable)

generateBitVector

public static <E extends java.lang.Enum<E>> long generateBitVector(java.lang.Class<E> enumClass,
                                                                   java.lang.Iterable<? extends E> values)

Creates a long bit vector representation of the given subset of an Enum.

This generates a value that is usable by EnumUtils#processBitVector.

Do not use this method if you have more than 64 values in your Enum, as this would create a value greater than a long can hold.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum we are working with, not null

values - the values we want to convert, not null, neither containing null

Returns:

a long whose value provides a binary representation of the given set of enum values.

Throws:

java.lang.NullPointerException - if enumClass or values is null

java.lang.IllegalArgumentException - if enumClass is not an enum class or has more than 64 values, or if any values null

Since:

3.0.1

See Also:

#generateBitVectors(Class, Iterable)

getEnum

public static <E extends java.lang.Enum<E>> E getEnum(java.lang.Class<E> enumClass,
                                                      java.lang.String enumName)

Gets the enum for the class, returning null if not found.

This method differs from Enum.valueOf(java.lang.Class<T>, java.lang.String) in that it does not throw an exception for an invalid enum name.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum to query, not null

enumName - the enum name, null returns null

Returns:

the enum, null if not found

getEnum

public static <E extends java.lang.Enum<E>> E getEnum(java.lang.Class<E> enumClass,
                                                      java.lang.String enumName,
                                                      E defaultEnum)

Gets the enum for the class, returning defaultEnum if not found.

This method differs from Enum.valueOf(java.lang.Class<T>, java.lang.String) in that it does not throw an exception for an invalid enum name.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum to query, not null

enumName - the enum name, null returns default enum

defaultEnum - the default enum

Returns:

the enum, default enum if not found

Since:

3.10

getEnumIgnoreCase

public static <E extends java.lang.Enum<E>> E getEnumIgnoreCase(java.lang.Class<E> enumClass,
                                                                java.lang.String enumName)

Gets the enum for the class, returning null if not found.

This method differs from Enum.valueOf(java.lang.Class<T>, java.lang.String) in that it does not throw an exception for an invalid enum name and performs case insensitive matching of the name.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum to query, not null

enumName - the enum name, null returns null

Returns:

the enum, null if not found

Since:

3.8

getEnumIgnoreCase

public static <E extends java.lang.Enum<E>> E getEnumIgnoreCase(java.lang.Class<E> enumClass,
                                                                java.lang.String enumName,
                                                                E defaultEnum)

Gets the enum for the class, returning defaultEnum if not found.

This method differs from Enum.valueOf(java.lang.Class<T>, java.lang.String) in that it does not throw an exception for an invalid enum name and performs case insensitive matching of the name.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum to query, not null

enumName - the enum name, null returns default enum

defaultEnum - the default enum

Returns:

the enum, default enum if not found

Since:

3.10

getEnumList

public static <E extends java.lang.Enum<E>> java.util.List<E> getEnumList(java.lang.Class<E> enumClass)

Gets the List of enums.

This method is useful when you need a list of enums rather than an array.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum to query, not null

Returns:

the modifiable list of enums, never null

getEnumMap

public static <E extends java.lang.Enum<E>> java.util.Map<java.lang.String,E> getEnumMap(java.lang.Class<E> enumClass)

Gets the Map of enums by name.

This method is useful when you need a map of enums by name.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum to query, not null

Returns:

the modifiable map of enum names to enums, never null

isValidEnum

public static <E extends java.lang.Enum<E>> boolean isValidEnum(java.lang.Class<E> enumClass,
                                                                java.lang.String enumName)

Checks if the specified name is a valid enum for the class.

This method differs from Enum.valueOf(java.lang.Class<T>, java.lang.String) in that checks if the name is a valid enum without needing to catch the exception.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum to query, not null

enumName - the enum name, null returns false

Returns:

true if the enum name is valid, otherwise false

isValidEnumIgnoreCase

public static <E extends java.lang.Enum<E>> boolean isValidEnumIgnoreCase(java.lang.Class<E> enumClass,
                                                                          java.lang.String enumName)

Checks if the specified name is a valid enum for the class.

This method differs from Enum.valueOf(java.lang.Class<T>, java.lang.String) in that checks if the name is a valid enum without needing to catch the exception and performs case insensitive matching of the name.

Type Parameters:

E - the type of the enumeration

Parameters:

enumClass - the class of the enum to query, not null

enumName - the enum name, null returns false

Returns:

true if the enum name is valid, otherwise false

Since:

3.8