com.helger.commons.lang

Class EnumHelper

java.lang.Object

com.helger.commons.lang.EnumHelper

@Immutable
public final class EnumHelper
extends Object

Some enum utility methods.

Author:

Philip Helger

Method Summary

Modifier and Type	Method and Description
static EChange	clearCache()
static String	getEnumID(Enum<?> aEnum) Get the unique name of the passed enum entry.
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasID<String>> ENUMTYPE	getFromIDCaseInsensitiveOrDefault(Class<ENUMTYPE> aClass, String sID, ENUMTYPE aDefault) Get the enum value with the passed string ID case insensitive
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasID<String>> ENUMTYPE	getFromIDCaseInsensitiveOrNull(Class<ENUMTYPE> aClass, String sID) Get the enum value with the passed string ID case insensitive
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasID<String>> ENUMTYPE	getFromIDCaseInsensitiveOrThrow(Class<ENUMTYPE> aClass, String sID) Get the enum value with the passed string ID (case insensitive).
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasIntID> ENUMTYPE	getFromIDOrDefault(Class<ENUMTYPE> aClass, int nID, ENUMTYPE aDefault) Get the enum value with the passed ID
static <KEYTYPE,ENUMTYPE extends Enum<ENUMTYPE> & IHasID<KEYTYPE>> ENUMTYPE	getFromIDOrDefault(Class<ENUMTYPE> aClass, KEYTYPE aID, ENUMTYPE aDefault) Get the enum value with the passed ID
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasIntID> ENUMTYPE	getFromIDOrNull(Class<ENUMTYPE> aClass, int nID) Get the enum value with the passed ID
static <KEYTYPE,ENUMTYPE extends Enum<ENUMTYPE> & IHasID<KEYTYPE>> ENUMTYPE	getFromIDOrNull(Class<ENUMTYPE> aClass, KEYTYPE aID) Get the enum value with the passed ID
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasIntID> ENUMTYPE	getFromIDOrThrow(Class<ENUMTYPE> aClass, int nID) Get the enum value with the passed ID.
static <KEYTYPE,ENUMTYPE extends Enum<ENUMTYPE> & IHasID<KEYTYPE>> ENUMTYPE	getFromIDOrThrow(Class<ENUMTYPE> aClass, KEYTYPE aID) Get the enum value with the passed ID.
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE	getFromNameCaseInsensitiveOrDefault(Class<ENUMTYPE> aClass, String sName, ENUMTYPE aDefault) Get the enum value with the passed name case insensitive
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE	getFromNameCaseInsensitiveOrNull(Class<ENUMTYPE> aClass, String sName) Get the enum value with the passed name case insensitive
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE	getFromNameCaseInsensitiveOrThrow(Class<ENUMTYPE> aClass, String sName) Get the enum value with the passed name (case insensitive).
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE	getFromNameOrDefault(Class<ENUMTYPE> aClass, String sName, ENUMTYPE aDefault) Get the enum value with the passed name
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE	getFromNameOrNull(Class<ENUMTYPE> aClass, String sName) Get the enum value with the passed name
static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE	getFromNameOrThrow(Class<ENUMTYPE> aClass, String sName) Get the enum value with the passed name.

Methods inherited from class java.lang.Object

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

Method Detail

getFromIDOrNull

@Nullable
public static <KEYTYPE,ENUMTYPE extends Enum<ENUMTYPE> & IHasID<KEYTYPE>> ENUMTYPE getFromIDOrNull(@Nonnull
                                                                                                              Class<ENUMTYPE> aClass,
                                                                                                              @Nullable
                                                                                                              KEYTYPE aID)

Get the enum value with the passed ID

Type Parameters:

KEYTYPE - The ID type

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

aID - The ID to search

Returns:

null if no enum item with the given ID is present.

getFromIDOrDefault

@Nullable
public static <KEYTYPE,ENUMTYPE extends Enum<ENUMTYPE> & IHasID<KEYTYPE>> ENUMTYPE getFromIDOrDefault(@Nonnull
                                                                                                                 Class<ENUMTYPE> aClass,
                                                                                                                 @Nullable
                                                                                                                 KEYTYPE aID,
                                                                                                                 @Nullable
                                                                                                                 ENUMTYPE aDefault)

Get the enum value with the passed ID

Type Parameters:

KEYTYPE - The ID type

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

aID - The ID to search

aDefault - The default value to be returned, if the ID was not found.

Returns:

The default parameter if no enum item with the given ID is present.

getFromIDOrThrow

@Nonnull
public static <KEYTYPE,ENUMTYPE extends Enum<ENUMTYPE> & IHasID<KEYTYPE>> ENUMTYPE getFromIDOrThrow(@Nonnull
                                                                                                              Class<ENUMTYPE> aClass,
                                                                                                              @Nullable
                                                                                                              KEYTYPE aID)

Get the enum value with the passed ID. If no such ID is present, an IllegalArgumentException is thrown.

Type Parameters:

KEYTYPE - The ID type

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

aID - The ID to search

Returns:

The enum item with the given ID. Never null.

Throws:

IllegalArgumentException - if no enum item with the given ID is present

getFromIDCaseInsensitiveOrNull

@Nullable
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasID<String>> ENUMTYPE getFromIDCaseInsensitiveOrNull(@Nonnull
                                                                                                                    Class<ENUMTYPE> aClass,
                                                                                                                    @Nullable
                                                                                                                    String sID)

Get the enum value with the passed string ID case insensitive

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

sID - The ID to search

Returns:

null if no enum item with the given ID is present.

getFromIDCaseInsensitiveOrDefault

@Nullable
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasID<String>> ENUMTYPE getFromIDCaseInsensitiveOrDefault(@Nonnull
                                                                                                                       Class<ENUMTYPE> aClass,
                                                                                                                       @Nullable
                                                                                                                       String sID,
                                                                                                                       @Nullable
                                                                                                                       ENUMTYPE aDefault)

Get the enum value with the passed string ID case insensitive

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

sID - The ID to search

aDefault - The default value to be returned, if the ID was not found.

Returns:

The default parameter if no enum item with the given ID is present.

getFromIDCaseInsensitiveOrThrow

@Nonnull
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasID<String>> ENUMTYPE getFromIDCaseInsensitiveOrThrow(@Nonnull
                                                                                                                    Class<ENUMTYPE> aClass,
                                                                                                                    @Nullable
                                                                                                                    String sID)

Get the enum value with the passed string ID (case insensitive). If no such ID is present, an IllegalArgumentException is thrown.

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

sID - The ID to search

Returns:

The enum item with the given ID. Never null.

Throws:

IllegalArgumentException - if no enum item with the given ID is present

getFromIDOrNull

@Nullable
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasIntID> ENUMTYPE getFromIDOrNull(@Nonnull
                                                                                                Class<ENUMTYPE> aClass,
                                                                                                int nID)

Get the enum value with the passed ID

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

nID - The ID to search

Returns:

null if no enum item with the given ID is present.

getFromIDOrDefault

@Nullable
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasIntID> ENUMTYPE getFromIDOrDefault(@Nonnull
                                                                                                   Class<ENUMTYPE> aClass,
                                                                                                   int nID,
                                                                                                   @Nullable
                                                                                                   ENUMTYPE aDefault)

Get the enum value with the passed ID

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

nID - The ID to search

aDefault - The default value to be returned, if the ID was not found.

Returns:

The default parameter if no enum item with the given ID is present.

getFromIDOrThrow

@Nonnull
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasIntID> ENUMTYPE getFromIDOrThrow(@Nonnull
                                                                                                Class<ENUMTYPE> aClass,
                                                                                                int nID)

Get the enum value with the passed ID. If no such ID is present, an IllegalArgumentException is thrown.

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

nID - The ID to search

Returns:

The enum item with the given ID. Never null.

Throws:

IllegalArgumentException - if no enum item with the given ID is present

getFromNameOrNull

@Nullable
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE getFromNameOrNull(@Nonnull
                                                                                                 Class<ENUMTYPE> aClass,
                                                                                                 @Nullable
                                                                                                 String sName)

Get the enum value with the passed name

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

sName - The name to search

Returns:

null if no enum item with the given name is present.

getFromNameOrDefault

@Nullable
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE getFromNameOrDefault(@Nonnull
                                                                                                    Class<ENUMTYPE> aClass,
                                                                                                    @Nullable
                                                                                                    String sName,
                                                                                                    @Nullable
                                                                                                    ENUMTYPE aDefault)

Get the enum value with the passed name

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

sName - The name to search

aDefault - The default value to be returned, if the name was not found.

Returns:

The default parameter if no enum item with the given name is present.

getFromNameOrThrow

@Nonnull
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE getFromNameOrThrow(@Nonnull
                                                                                                 Class<ENUMTYPE> aClass,
                                                                                                 @Nullable
                                                                                                 String sName)

Get the enum value with the passed name. If no such name is present, an IllegalArgumentException is thrown.

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

sName - The name to search

Returns:

The enum item with the given name. Never null.

Throws:

IllegalArgumentException - if no enum item with the given name is present

getFromNameCaseInsensitiveOrNull

@Nullable
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE getFromNameCaseInsensitiveOrNull(@Nonnull
                                                                                                                Class<ENUMTYPE> aClass,
                                                                                                                @Nullable
                                                                                                                String sName)

Get the enum value with the passed name case insensitive

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

sName - The name to search

Returns:

null if no enum item with the given ID is present.

getFromNameCaseInsensitiveOrDefault

@Nullable
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE getFromNameCaseInsensitiveOrDefault(@Nonnull
                                                                                                                   Class<ENUMTYPE> aClass,
                                                                                                                   @Nullable
                                                                                                                   String sName,
                                                                                                                   @Nullable
                                                                                                                   ENUMTYPE aDefault)

Get the enum value with the passed name case insensitive

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

sName - The name to search

aDefault - The default value to be returned, if the name was not found.

Returns:

The default parameter if no enum item with the given name is present.

getFromNameCaseInsensitiveOrThrow

@Nonnull
public static <ENUMTYPE extends Enum<ENUMTYPE> & IHasName> ENUMTYPE getFromNameCaseInsensitiveOrThrow(@Nonnull
                                                                                                                Class<ENUMTYPE> aClass,
                                                                                                                @Nullable
                                                                                                                String sName)

Get the enum value with the passed name (case insensitive). If no such name is present, an IllegalArgumentException is thrown.

Type Parameters:

ENUMTYPE - The enum type

Parameters:

aClass - The enum class

sName - The name to search

Returns:

The enum item with the given name. Never null.

Throws:

IllegalArgumentException - if no enum item with the given name is present

getEnumID

@Nonnull
public static String getEnumID(@Nonnull
                                         Enum<?> aEnum)

Get the unique name of the passed enum entry.

Parameters:

aEnum - The enum to use. May not be null.

Returns:

The unique ID as a combination of the class name and the enum entry name. Never null.

clearCache

@Nonnull
public static EChange clearCache()