org.aoju.bus.core.utils

Class EnumUtils

java.lang.Object

org.aoju.bus.core.utils.EnumUtils

public class EnumUtils
extends Object

枚举工具类

Since:

JDK 1.8

Version:

3.0.0

Author:

Kimi Liu

Constructor Summary

Constructors

Constructor and Description
EnumUtils()

Method Summary

Modifier and Type	Method and Description
static <E extends Enum<E>> long	generateBitVector(Class<E> enumClass, E... values) Creates a long bit vector representation of the given array of Enum values.
static <E extends Enum<E>> long	generateBitVector(Class<E> enumClass, Iterable<? extends E> values) Creates a long bit vector representation of the given subset of an Enum.
static <E extends Enum<E>> long[]	generateBitVectors(Class<E> enumClass, E... values) Creates a bit vector representation of the given subset of an Enum using as many longs as needed.
static <E extends Enum<E>> long[]	generateBitVectors(Class<E> enumClass, Iterable<? extends E> values) Creates a bit vector representation of the given subset of an Enum using as many longs as needed.
static <E extends Enum<E>> E	getEnum(Class<E> enumClass, String enumName) Gets the enum for the class, returning null if not found.
static <E extends Enum<E>> E	getEnumIgnoreCase(Class<E> enumClass, String enumName) Gets the enum for the class, returning null if not found.
static <E extends Enum<E>> List<E>	getEnumList(Class<E> enumClass) Gets the List of enums.
static <E extends Enum<E>> LinkedHashMap<String,E>	getEnumMap(Class<E> enumClass) 获取枚举字符串值和枚举对象的Map对应，使用LinkedHashMap保证有序 结果中键为枚举名，值为枚举对象
static List<Object>	getFieldValues(Class<? extends Enum<?>> clazz, String fieldName) 获得枚举类中各枚举对象下指定字段的值
static Map<String,Object>	getNameFieldMap(Class<? extends Enum<?>> clazz, String fieldName) 获得枚举名对应指定字段值的Map 键为枚举名，值为字段值
static List<String>	getNames(Class<? extends Enum<?>> clazz) 枚举类中所有枚举对象的name列表
static <E extends Enum<E>> boolean	isValidEnum(Class<E> enumClass, String enumName) Checks if the specified name is a valid enum for the class.
static <E extends Enum<E>> boolean	isValidEnumIgnoreCase(Class<E> enumClass, String enumName) Checks if the specified name is a valid enum for the class.
static <E extends Enum<E>> EnumSet<E>	processBitVector(Class<E> enumClass, long value) Convert a long value created by generateBitVector(java.lang.Class<E>, java.lang.Iterable<? extends E>) into the set of enum values that it represents.
static <E extends Enum<E>> EnumSet<E>	processBitVectors(Class<E> enumClass, long... values) Convert a long[] created by generateBitVectors(java.lang.Class<E>, java.lang.Iterable<? extends E>) into the set of enum values that it represents.

Methods inherited from class java.lang.Object

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

Constructor Detail

EnumUtils

public EnumUtils()

Method Detail

getNames

public static List<String> getNames(Class<? extends Enum<?>> clazz)

枚举类中所有枚举对象的name列表

Parameters:

clazz - 枚举类

Returns:

name列表

getFieldValues

public static List<Object> getFieldValues(Class<? extends Enum<?>> clazz,
                                          String fieldName)

获得枚举类中各枚举对象下指定字段的值

Parameters:

clazz - 枚举类

fieldName - 字段名，最终调用getXXX方法

Returns:

字段值列表

getEnumMap

public static <E extends Enum<E>> LinkedHashMap<String,E> getEnumMap(Class<E> enumClass)

获取枚举字符串值和枚举对象的Map对应，使用LinkedHashMap保证有序
结果中键为枚举名，值为枚举对象

Type Parameters:

E - 对象

Parameters:

enumClass - 枚举类

Returns:

枚举字符串值和枚举对象的Map对应，使用LinkedHashMap保证有序

Since:

4.0.2

getNameFieldMap

public static Map<String,Object> getNameFieldMap(Class<? extends Enum<?>> clazz,
                                                 String fieldName)

获得枚举名对应指定字段值的Map
键为枚举名，值为字段值

Parameters:

clazz - 枚举类

fieldName - 字段名，最终调用getXXX方法

Returns:

枚举名对应指定字段值的Map

getEnumList

public static <E extends Enum<E>> List<E> getEnumList(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

isValidEnum

public static <E extends Enum<E>> boolean isValidEnum(Class<E> enumClass,
                                                      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 Enum<E>> boolean isValidEnumIgnoreCase(Class<E> enumClass,
                                                                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

getEnum

public static <E extends Enum<E>> E getEnum(Class<E> enumClass,
                                            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

getEnumIgnoreCase

public static <E extends Enum<E>> E getEnumIgnoreCase(Class<E> enumClass,
                                                      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

generateBitVector

public static <E extends Enum<E>> long generateBitVector(Class<E> enumClass,
                                                         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 processBitVector(java.lang.Class<E>, long).

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:

NullPointerException - if enumClass or values is null

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)

generateBitVectors

public static <E extends Enum<E>> long[] generateBitVectors(Class<E> enumClass,
                                                            Iterable<? extends E> values)

Creates a bit vector representation of the given subset of an Enum using as many longs as needed.

This generates a value that is usable by processBitVectors(java.lang.Class<E>, long...).

Use this method if you have more than 64 values in your Enum.

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 values provide a binary representation of the given set of enum values with least significant digits rightmost.

Throws:

NullPointerException - if enumClass or values is null

IllegalArgumentException - if enumClass is not an enum class, or if any values null

Since:

3.2

generateBitVector

public static <E extends Enum<E>> long generateBitVector(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 processBitVector(java.lang.Class<E>, long).

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:

NullPointerException - if enumClass or values is null

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

Since:

3.0.1

See Also:

generateBitVectors(Class, Iterable)

generateBitVectors

public static <E extends Enum<E>> long[] generateBitVectors(Class<E> enumClass,
                                                            E... values)

Creates a bit vector representation of the given subset of an Enum using as many longs as needed.

This generates a value that is usable by processBitVectors(java.lang.Class<E>, long...).

Use this method if you have more than 64 values in your Enum.

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 values provide a binary representation of the given set of enum values with least significant digits rightmost.

Throws:

NullPointerException - if enumClass or values is null

IllegalArgumentException - if enumClass is not an enum class, or if any values null

Since:

3.2

processBitVector

public static <E extends Enum<E>> EnumSet<E> processBitVector(Class<E> enumClass,
                                                              long value)

Convert a long value created by generateBitVector(java.lang.Class<E>, java.lang.Iterable<? extends E>) into the set of enum values that it represents.

If you store this value, beware any changes to the enum that would affect ordinal values.

Type Parameters:

E - the type of the enumeration

Parameters:

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

value - the long value representation of a set of enum values

Returns:

a set of enum values

Throws:

NullPointerException - if enumClass is null

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

Since:

3.0.1

processBitVectors

public static <E extends Enum<E>> EnumSet<E> processBitVectors(Class<E> enumClass,
                                                               long... values)

Convert a long[] created by generateBitVectors(java.lang.Class<E>, java.lang.Iterable<? extends E>) into the set of enum values that it represents.

If you store this value, beware any changes to the enum that would affect ordinal values.

Type Parameters:

E - the type of the enumeration

Parameters:

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

values - the long[] bearing the representation of a set of enum values, least significant digits rightmost, not null

Returns:

a set of enum values

Throws:

NullPointerException - if enumClass is null

IllegalArgumentException - if enumClass is not an enum class

Since:

3.2