Package org.apache.velocity.util.introspection

Class TypeConversionHandlerImpl

  • All Implemented Interfaces:
    TypeConversionHandler
    public class TypeConversionHandlerImpl
extends java.lang.Object
implements TypeConversionHandler
    A conversion handler adds admissible conversions between Java types whenever Velocity introspection has to map VTL methods and property accessors to Java methods. This implementation is the default Conversion Handler for Velocity.
    Since:
    2.0
    Version:
    $Id: TypeConversionHandlerImpl.java $

    • Field Summary

      Fields 
      Modifier and Type Field Description
      (package private) static java.lang.String BIG_DECIMAL_CLASS  
      (package private) static java.lang.String BIG_INTEGER_CLASS  
      (package private) static java.lang.String BOOLEAN_CLASS  
      (package private) static java.lang.String BOOLEAN_TYPE  
      (package private) static java.lang.String BYTE_CLASS  
      (package private) static java.lang.String BYTE_TYPE  
      (package private) static Converter<?> cacheMiss
      cache miss converter
      (package private) static java.lang.String CHARACTER_CLASS  
      (package private) static java.lang.String CHARACTER_TYPE  
      (package private) java.util.Map<org.apache.commons.lang3.tuple.Pair<java.lang.String,​java.lang.String>,​Converter<?>> converterCacheMap
      a converters cache map, initialized with the standard narrowing and string parsing conversions.
      (package private) static java.lang.String DOUBLE_CLASS  
      (package private) static java.lang.String DOUBLE_TYPE  
      (package private) static java.lang.String FLOAT_CLASS  
      (package private) static java.lang.String FLOAT_TYPE  
      (package private) static java.lang.String INTEGER_CLASS  
      (package private) static java.lang.String INTEGER_TYPE  
      (package private) static java.lang.String LOCALE_CLASS  
      (package private) static java.lang.String LONG_CLASS  
      (package private) static java.lang.String LONG_TYPE  
      (package private) static java.lang.String NUMBER_CLASS  
      (package private) static java.lang.String SHORT_CLASS  
      (package private) static java.lang.String SHORT_TYPE  
      (package private) static java.util.Map<org.apache.commons.lang3.tuple.Pair<java.lang.String,​java.lang.String>,​Converter<?>> standardConverterMap
      standard narrowing and string parsing conversions.
      (package private) static java.lang.String STRING_CLASS  
      (package private) static Converter<?> toString
      basic toString converter

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void addConverter​(java.lang.reflect.Type formal, java.lang.Class<?> actual, Converter<?> converter)
      Add the given converter to the handler.
      (package private) static boolean checkBounds​(java.lang.Number n, double min, double max)  
      Converter<?> getNeededConverter​(java.lang.reflect.Type formal, java.lang.Class<?> actual)
      Returns the appropriate Converter object needed for an explicit conversion Returns null if no conversion is needed.
      boolean isExplicitlyConvertible​(java.lang.reflect.Type formal, java.lang.Class<?> actual, boolean possibleVarArg)
      Check to see if the conversion can be done using an explicit conversion

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • TypeConversionHandlerImpl

        public TypeConversionHandlerImpl()
        Constructor

    • Method Detail

      • checkBounds

        static boolean checkBounds​(java.lang.Number n,
                           double min,
                           double max)

      • isExplicitlyConvertible

        public boolean isExplicitlyConvertible​(java.lang.reflect.Type formal,
                                       java.lang.Class<?> actual,
                                       boolean possibleVarArg)
        Check to see if the conversion can be done using an explicit conversion
        Specified by:
        isExplicitlyConvertible in interface TypeConversionHandler
        Parameters:
        actual - found argument type
        formal - expected formal type
        possibleVarArg - whether var arg is possible
        Returns:
        true if actual class can be explicitely converted to expected formal type
        Since:
        2.1

      • getNeededConverter

        public Converter<?> getNeededConverter​(java.lang.reflect.Type formal,
                                       java.lang.Class<?> actual)
        Returns the appropriate Converter object needed for an explicit conversion Returns null if no conversion is needed.
        Specified by:
        getNeededConverter in interface TypeConversionHandler
        Parameters:
        actual - found argument type
        formal - expected formal type
        Returns:
        null if no conversion is needed, or the appropriate Converter object
        Since:
        2.1

      • addConverter

        public void addConverter​(java.lang.reflect.Type formal,
                         java.lang.Class<?> actual,
                         Converter<?> converter)
        Add the given converter to the handler.
        Specified by:
        addConverter in interface TypeConversionHandler
        Parameters:
        formal - expected formal type
        actual - provided argument type
        converter - converter
        Since:
        2.1