org.apache.commons.lang.enum
Class EnumUtils

java.lang.Object
  |
  +--org.apache.commons.lang.enum.EnumUtils

All Implemented Interfaces:

Comparable, Serializable

public abstract class EnumUtils

extends Object

implements Comparable, Serializable

Utility class for accessing and manipulating Enums.

Version:

$Id: EnumUtils.java,v 1.3 2002/09/28 10:49:59 scolebourne Exp $

Author:

Stephen Colebourne

See Also:

Enum, ValuedEnum, Serialized Form

Constructor Summary

private

EnumUtils() Restricted constructor

Method Summary

static ValuedEnum	getEnum(Class enumClass, int value) Gets a ValuedEnum object by class and value.
static Enum	getEnum(Class enumClass, String name) Gets an Enum object by class and name.
static List	getEnumList(Class enumClass) Gets the List of Enum objects using the Enum class.
static Map	getEnumMap(Class enumClass) Gets the Map of Enum objects by name using the Enum class.
static Iterator	iterator(Class enumClass) Gets an iterator over the Enum objects in an Enum class.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Comparable

compareTo

Constructor Detail

EnumUtils

private EnumUtils()

Restricted constructor

Method Detail

getEnum

public static Enum getEnum(Class enumClass,
                           String name)

Gets an Enum object by class and name.

Parameters:

enumClass - the class of the Enum to get

name - the name of the Enum to get, may be null

Returns:

the enum object

Throws:

IllegalArgumentException - if the enum class is null

getEnum

public static ValuedEnum getEnum(Class enumClass,
                                 int value)

Gets a ValuedEnum object by class and value.

Parameters:

enumClass - the class of the Enum to get

value - the value of the Enum to get

Returns:

the enum object, or null if the enum does not exist

Throws:

IllegalArgumentException - if the enum class is null

getEnumMap

public static Map getEnumMap(Class enumClass)

Gets the Map of Enum objects by name using the Enum class. If the requested class has no enum objects an empty Map is returned. The Map is unmodifiable.

Parameters:

enumClass - the class of the Enum to get

Returns:

the enum object Map

Throws:

IllegalArgumentException - if the enum class is null

IllegalArgumentException - if the enum class is not a subclass of Enum

getEnumList

public static List getEnumList(Class enumClass)

Gets the List of Enum objects using the Enum class. The list is in the order that the objects were created (source code order). If the requested class has no enum objects an empty List is returned. The List is unmodifiable.

Parameters:

enumClass - the class of the Enum to get

Returns:

the enum object Map

Throws:

IllegalArgumentException - if the enum class is null

IllegalArgumentException - if the enum class is not a subclass of Enum

iterator

public static Iterator iterator(Class enumClass)

Gets an iterator over the Enum objects in an Enum class. The iterator is in the order that the objects were created (source code order). If the requested class has no enum objects an empty Iterator is returned. The Iterator is unmodifiable.

Parameters:

enumClass - the class of the Enum to get

Returns:

an iterator of the Enum objects

Throws:

IllegalArgumentException - if the enum class is null

IllegalArgumentException - if the enum class is not a subclass of Enum