Interface ConversionHandler


  • @Deprecated
    public interface ConversionHandler
    Deprecated.
    A conversion handler adds admissible conversions between Java types whenever Velocity introspection has to map VTL methods and property accessors to Java methods. Both methods must be consistent: getNeededConverter must not return null whenever isExplicitlyConvertible returned true with the same arguments.
    Since:
    2.0
    Version:
    $Id: ConversionHandler.java $
    Author:
    Claude Brisson
    See Also:
    TypeConversionHandler
    • Method Detail

      • isExplicitlyConvertible

        boolean isExplicitlyConvertible​(Class<?> formal,
                                        Class<?> actual,
                                        boolean possibleVarArg)
        Deprecated.
        Check to see if the conversion can be done using an explicit conversion
        Parameters:
        formal - expected formal type
        actual - provided argument type
        possibleVarArg - whether var arg is possible here
        Returns:
        null if no conversion is needed, or the appropriate Converter object
        Since:
        2.0
      • getNeededConverter

        Converter getNeededConverter​(Class<?> formal,
                                     Class<?> actual)
        Deprecated.
        Returns the appropriate Converter object needed for an explicit conversion Returns null if no conversion is needed.
        Parameters:
        formal - expected formal type
        actual - provided argument type
        Returns:
        null if no conversion is needed, or the appropriate Converter object
        Since:
        2.0
      • addConverter

        void addConverter​(Class<?> formal,
                          Class<?> actual,
                          Converter converter)
        Deprecated.
        Add the given converter to the handler. Implementation should be thread-safe.
        Parameters:
        formal - expected formal type
        actual - provided argument type
        converter - converter
        Since:
        2.0