Field Detail

• BOXED_TO_UNBOXED_TYPES

  public static final java.util.Map<java.lang.Class,java.lang.Class> BOXED_TO_UNBOXED_TYPES

• UNBOXED_TO_BOXED_TYPES

  public static final java.util.Map<java.lang.Class,java.lang.Class> UNBOXED_TO_BOXED_TYPES

Method Detail

• coerce

  public static <T> T coerce(java.lang.Object value,
             java.lang.Class<T> targetType)

  Attempts to coerce value to targetType.

  Maintains a registry of adapter functions for type pairs in a Table which is searched after checking various strategies, including the following:

  • value.asTargetType()
  • TargetType.fromType(value) (if value instanceof Type)
  • value.targetTypeValue() (handy for primitives)
  • TargetType.valueOf(value) (for enums)

  A default set of adapters will handle most common Java-type coercions as well as String coercion to:

  • Set, List, Map and similar -- parses as YAML
  • Date -- parses using Time.parseDate(String)
  • Duration -- parses using Duration.parse(String)

• tryCoerce

  public static <T> Maybe<T> tryCoerce(java.lang.Object value,
                       com.google.common.reflect.TypeToken<T> targetTypeToken)

  See Also:

  coerce(Object, Class)

• coerce

  public static <T> T coerce(java.lang.Object value,
             com.google.common.reflect.TypeToken<T> targetTypeToken)

  See Also:

  coerce(Object, Class)

• stringToEnum

  public static <E extends java.lang.Enum<E>> com.google.common.base.Function<java.lang.String,E> stringToEnum(java.lang.Class<E> type,
                                                                                               @Nullable
                                                                                               E defaultValue)

  Type coercion function for enums.

  Tries to convert the string to CaseFormat.UPPER_UNDERSCORE first, handling all of the different format possibilites. Failing that, it tries a case-insensitive comparison with the valid enum values.

  Returns defaultValue if the string cannot be converted.

  See Also:

  coerce(Object, Class), Enum.valueOf(Class, String)

• castPrimitive

  public static <T> T castPrimitive(java.lang.Object value,
                    java.lang.Class<T> targetType)

  Sometimes need to explicitly cast primitives, rather than relying on Java casting. For example, when using generics then type-erasure means it doesn't actually cast, which causes tests to fail with 0 != 0.0

• isPrimitiveOrBoxer

  public static boolean isPrimitiveOrBoxer(java.lang.Class<?> type)

• stringToPrimitive

  public static <T> T stringToPrimitive(java.lang.String value,
                        java.lang.Class<T> targetType)

• getVerySimpleName

  public static java.lang.String getVerySimpleName(java.lang.Class c)

  returns the simple class name, and for any inner class the portion after the $

• getMatchingConstructor

  public static java.lang.Object getMatchingConstructor(java.lang.Class target,
                                        java.lang.Object... arguments)

  for automatic conversion

• registerAdapter

  public static <A,B> com.google.common.base.Function registerAdapter(java.lang.Class<A> sourceType,
                                                      java.lang.Class<B> targetType,
                                                      com.google.common.base.Function<? super A,B> fn)

  Registers an adapter for use with type coercion. Returns any old adapter.

• initStandardAdapters

  public static void initStandardAdapters()