org.springframework.core
Class Constants

public class Constants

This class can be used to parse other classes containing constant definitions in public static final members. The asXXXX() methods of this class allow these constant values to be accessed via their string names.

Consider class Foo containing public final static int CONSTANT1 = 66; An instance of this class wrapping Foo.class will return the constant value of 66 from its asInt() method given the argument "CONSTANT1".

This class is ideal for use in PropertyEditors, enabling them to recognize the same names as the constants themselves, and freeing them from maintaining their own mapping.

Author:

Rod Johnson, Juergen Hoeller

Version: $Id: Constants.java,v 1.1 2004/02/02 11:24:51 jhoeller Exp $

Since: 16-Mar-2003

public Constants(Class clazz)

Create a new Constants converter class wrapping the given class. All public static final variables will be exposed, whatever their type.

Parameters:

clazz - class to analyze.

public Number asNumber(String code)
                 throws ConstantException

Return a constant value cast to a Number.

Parameters:

code - name of the field

Returns: long value if successful

Throws:

org.springframework.core.ConstantException - if the field name wasn't found or if the type wasn't compatible with Number

See Also:

asObject(java.lang.String)

public Object asObject(String code)
                 throws ConstantException

Parse the given string (upper or lower case accepted) and return the appropriate value if it's the name of a constant field in the class we're analysing.

Throws:

org.springframework.core.ConstantException - if there's no such field

public String asString(String code)
                 throws ConstantException

Return a constant value as a String.

Parameters:

code - name of the field

Returns: String string value if successful. Works even if it's not a string (invokes toString()).

Throws:

org.springframework.core.ConstantException - if the field name wasn't found

See Also:

asObject(java.lang.String)

public int getSize()

Return the number of constants exposed.

Returns: int the number of constants exposed

public Set getValues(String namePrefix)

Return all values of the given group of constants.

Parameters:

namePrefix - prefix of the constant names to search

Returns: the set of values

public Set getValuesForProperty(String propertyName)

Return all values of the group of constants for the given bean property name.

Parameters:

propertyName - the name of the bean property

Returns: the set of values

See Also:

propertyToConstantNamePrefix(java.lang.String)

public String propertyToConstantNamePrefix(String propertyName)

Convert the given bean property name to a constant name prefix. Uses a common naming idiom: turning all lower case characters to upper case, and prepending upper case characters with an underscore.

Example: "imageSize" -> "IMAGE_SIZE".

Parameters:

propertyName - the name of the bean property

Returns: the corresponding constant name prefix

See Also:

getValuesForProperty(java.lang.String), toCodeForProperty(java.lang.Object,java.lang.String)

public String toCode(Object value, String namePrefix)
               throws ConstantException

Look up the given value within the given group of constants. Will return the first match.

Parameters:

value - constant value to look up

namePrefix - prefix of the constant names to search

Returns: the name of the constant field

Throws:

org.springframework.core.ConstantException - if the value wasn't found

public String toCodeForProperty(Object value, String propertyName)
                          throws ConstantException

Look up the given value within the group of constants for the given bean property name. Will return the first match.

Parameters:

value - constant value to look up

propertyName - the name of the bean property

Returns: the name of the constant field

Throws:

org.springframework.core.ConstantException - if the value wasn't found

See Also:

propertyToConstantNamePrefix(java.lang.String)

Association Links

to Class java.util.Map

Map from String field name to object value

to Class java.lang.Class

Class analyzed