de.dfki.util.xmlrpc.conversion
Class ParameterConverterRegistry

java.lang.Object
  extended by de.dfki.util.xmlrpc.conversion.ParameterConverterRegistry

public class ParameterConverterRegistry
extends java.lang.Object


Constructor Summary
ParameterConverterRegistry()
           
 
Method Summary
static void clearMappings()
          Removes all mappings from the registry.
static ParameterConverter<?,?> getParameterConverterForClass(java.lang.Class<?> clsToConvert)
          Gets a converter to convert instances of the given class.
static ParameterConverter<?,?> getParameterConverterInstance(java.lang.Class<? extends ParameterConverter<?,?>> converterCls, java.lang.Class<?> paramClass)
           
static java.util.logging.Logger log()
           
static void readParameterConverterMappingsFromApiClass(java.lang.Class<?> apiClass)
          Looks whether the class defines any parameter converter mappings through ConverterMappings annoations.
static void setDefaultConverterClass(java.lang.Class<? extends ParameterConverter<?,?>> converterCls)
          Sets a default converter to be used for unknown types (i.e., types with no other conversion mapping defined).
static void setParameterConverter(java.lang.Class<? extends ParameterConverter<?,?>> converterCls, java.lang.Class<?> parameterCls, ParameterConverter<?,?> converterInstance)
          Registers a converter instance.
static void setParameterConverterForClass(java.lang.Class<?> paramClsToConvert, java.lang.Class<? extends ParameterConverter<?,?>> converterCls)
          Registers a mapping between a class to convert and a converter instance (belonging to converterCls).
static void setParameterConverterForClass(java.lang.Class<?> paramClsToConvert, ParameterConverter<?,?> converter)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ParameterConverterRegistry

public ParameterConverterRegistry()
Method Detail

log

public static java.util.logging.Logger log()

setDefaultConverterClass

public static void setDefaultConverterClass(java.lang.Class<? extends ParameterConverter<?,?>> converterCls)
Sets a default converter to be used for unknown types (i.e., types with no other conversion mapping defined).

Parameters:
converterCls -

getParameterConverterForClass

public static ParameterConverter<?,?> getParameterConverterForClass(java.lang.Class<?> clsToConvert)
Gets a converter to convert instances of the given class.

Parameters:
clsToConvert - Class to convert.
Returns:
A converter which is registered for the class.

getParameterConverterInstance

public static ParameterConverter<?,?> getParameterConverterInstance(java.lang.Class<? extends ParameterConverter<?,?>> converterCls,
                                                                    java.lang.Class<?> paramClass)
Parameters:
converterCls - Class of the parameter converter
paramClass - (optional) the class of the parameter to be converted. The more generic converters may need this information.
Returns:
Converter instance for the requested class. The registry stores a converter instance for each converter class. If no instance is available yet, one is created using the public noarg constructor.

setParameterConverter

public static void setParameterConverter(java.lang.Class<? extends ParameterConverter<?,?>> converterCls,
                                         java.lang.Class<?> parameterCls,
                                         ParameterConverter<?,?> converterInstance)
Registers a converter instance.


setParameterConverterForClass

public static void setParameterConverterForClass(java.lang.Class<?> paramClsToConvert,
                                                 java.lang.Class<? extends ParameterConverter<?,?>> converterCls)
Registers a mapping between a class to convert and a converter instance (belonging to converterCls). If the class to convert already has a mapping, nothing will be added.

Throws:
java.lang.RuntimeException - When mapping a converter to a standard XML-RPC type.
See Also:
#getParameterConverterInstance(Class)

setParameterConverterForClass

public static void setParameterConverterForClass(java.lang.Class<?> paramClsToConvert,
                                                 ParameterConverter<?,?> converter)

readParameterConverterMappingsFromApiClass

public static void readParameterConverterMappingsFromApiClass(java.lang.Class<?> apiClass)
Looks whether the class defines any parameter converter mappings through ConverterMappings annoations. If so, the mapping will be stored in the registry.

Parameters:
apiClass - The class to check.
Throws:
java.lang.RuntimeException - Denote problems while reading/registering the converters.

clearMappings

public static void clearMappings()
Removes all mappings from the registry.



Copyright © 2012. All Rights Reserved.