程序包 cn.taketoday.core

类 Constants

java.lang.Object
cn.taketoday.core.Constants
public class Constants extends Object
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 asNumber 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.

作者:
Rod Johnson, Juergen Hoeller

  • 字段详细资料

    • className

      private final String className
      The name of the introspected class

    • fieldCache

      private final HashMap<String,Object> fieldCache
      Map from String field name to object value

  • 构造器详细资料

    • Constants

      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.

      参数:
      clazz - the class to analyze
      抛出:
      IllegalArgumentException - if the supplied clazz is null

  • 方法详细资料

    • getClassName

      public final String getClassName()
      Return the name of the analyzed class.

    • getSize

      public final int getSize()
      Return the number of constants exposed.

    • getFieldCache

      public final Map<String,Object> getFieldCache()
      Exposes the field cache to subclasses: a Map from String field name to object value.

    • asNumber

      public Number asNumber(String code) throws Constants.ConstantException
      Return a constant value cast to a Number.
      参数:
      code - the name of the field (never null)
      返回:
      the Number value
      抛出:
      Constants.ConstantException - if the field name wasn't found or if the type wasn't compatible with Number
      另请参阅:

    • asString

      public String asString(String code) throws Constants.ConstantException
      Return a constant value as a String.
      参数:
      code - the name of the field (never null)
      返回:
      the String value Works even if it's not a string (invokes toString()).
      抛出:
      Constants.ConstantException - if the field name wasn't found
      另请参阅:

    • asObject

      public Object asObject(String code) throws Constants.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 that we're analysing.
      参数:
      code - the name of the field (never null)
      返回:
      the Object value
      抛出:
      Constants.ConstantException - if there's no such field

    • getNames

      public Set<String> getNames(@Nullable String namePrefix)
      Return all names of the given group of constants.

      Note that this method assumes that constants are named in accordance with the standard Java convention for constant values (i.e. all uppercase). The supplied namePrefix will be uppercased (in a locale-insensitive fashion) prior to the main logic of this method kicking in.

      参数:
      namePrefix - prefix of the constant names to search (may be null)
      返回:
      the set of constant names

    • getNamesForProperty

      public Set<String> getNamesForProperty(String propertyName)
      Return all names of the group of constants for the given bean property name.
      参数:
      propertyName - the name of the bean property
      返回:
      the set of values
      另请参阅:

    • getNamesForSuffix

      public Set<String> getNamesForSuffix(@Nullable String nameSuffix)
      Return all names of the given group of constants.

      Note that this method assumes that constants are named in accordance with the standard Java convention for constant values (i.e. all uppercase). The supplied nameSuffix will be uppercased (in a locale-insensitive fashion) prior to the main logic of this method kicking in.

      参数:
      nameSuffix - suffix of the constant names to search (may be null)
      返回:
      the set of constant names

    • getValues

      public Set<Object> getValues(@Nullable String namePrefix)
      Return all values of the given group of constants.

      Note that this method assumes that constants are named in accordance with the standard Java convention for constant values (i.e. all uppercase). The supplied namePrefix will be uppercased (in a locale-insensitive fashion) prior to the main logic of this method kicking in.

      参数:
      namePrefix - prefix of the constant names to search (may be null)
      返回:
      the set of values

    • getValuesForProperty

      public Set<Object> getValuesForProperty(String propertyName)
      Return all values of the group of constants for the given bean property name.
      参数:
      propertyName - the name of the bean property
      返回:
      the set of values
      另请参阅:

    • getValuesForSuffix

      public Set<Object> getValuesForSuffix(@Nullable String nameSuffix)
      Return all values of the given group of constants.

      Note that this method assumes that constants are named in accordance with the standard Java convention for constant values (i.e. all uppercase). The supplied nameSuffix will be uppercased (in a locale-insensitive fashion) prior to the main logic of this method kicking in.

      参数:
      nameSuffix - suffix of the constant names to search (may be null)
      返回:
      the set of values

    • toCode

      public String toCode(Object value, @Nullable String namePrefix) throws Constants.ConstantException
      Look up the given value within the given group of constants.

      Will return the first match.

      参数:
      value - constant value to look up
      namePrefix - prefix of the constant names to search (may be null)
      返回:
      the name of the constant field
      抛出:
      Constants.ConstantException - if the value wasn't found

    • getPrefixToUse

      private static String getPrefixToUse(@Nullable String namePrefix)

    • toCodeForProperty

      public String toCodeForProperty(Object value, String propertyName) throws Constants.ConstantException
      Look up the given value within the group of constants for the given bean property name. Will return the first match.
      参数:
      value - constant value to look up
      propertyName - the name of the bean property
      返回:
      the name of the constant field
      抛出:
      Constants.ConstantException - if the value wasn't found
      另请参阅:

    • toCodeForSuffix

      public String toCodeForSuffix(Object value, String nameSuffix) throws Constants.ConstantException
      Look up the given value within the given group of constants.

      Will return the first match.

      参数:
      value - constant value to look up
      nameSuffix - suffix of the constant names to search (may be null)
      返回:
      the name of the constant field
      抛出:
      Constants.ConstantException - if the value wasn't found

    • propertyToConstantNamePrefix

      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"
      Example: "imagesize" -> "IMAGESIZE".
      Example: "ImageSize" -> "_IMAGE_SIZE".
      Example: "IMAGESIZE" -> "_I_M_A_G_E_S_I_Z_E"

      参数:
      propertyName - the name of the bean property
      返回:
      the corresponding constant name prefix
      另请参阅: