org.jadira.bindings.core.binder

Class BasicBinder

java.lang.Object

org.jadira.bindings.core.binder.BasicBinder

All Implemented Interfaces:

Binder, ConversionBinder, RegisterableBinder, SearchableBinder, StringBinder

@Typed(value={})
public class BasicBinder
extends Object
implements Binder, RegisterableBinder

Core binding capability. Typically you would obtain an instance of this class either by direct construction, or in JDK6 and above by using java.util.ServiceLoader. Default construction of this class registers bindings for core JDK classes, as well as any bindings specified using bindings.xml You can also register additional bindings programmatically.

See Also:

Binding is used to define a binding

Constructor Summary

Constructors

Constructor and Description
BasicBinder() Creates a new instance, initialised with standard, and registered bindings
BasicBinder(boolean includeBuiltInBindings) Creates a new instance

Method Summary

Modifier and Type	Method and Description
<T> T	convertFromString(Class<T> output, String object) * String Binder * *
<T> T	convertFromString(Class<T> output, String object, Class<? extends Annotation> qualifier) Convert a String to the given target class
<S,T> T	convertTo(Class<S> input, Class<T> output, Object object) Convert an object which is an instance of source class to the given target class
<S,T> T	convertTo(Class<S> input, Class<T> output, Object object, Class<? extends Annotation> qualifier) Convert an object which is an instance of source class to the given target class
<S,T> T	convertTo(Class<T> output, Object object) Convert an object to the given target class This method infers the source type for the conversion from the runtime type of object.
<S,T> T	convertTo(Class<T> output, Object object, Class<? extends Annotation> qualifier) Convert an object to the given target class This method infers the source type for the conversion from the runtime type of object.
<S,T> T	convertTo(ConverterKey<S,T> key, Object object) Convert an object which is an instance of source class to the given target class
<S> String	convertToString(Class<S> input, Object object) Convert an object which is an instance of source class to String
<S> String	convertToString(Class<S> input, Object object, Class<? extends Annotation> qualifier) Convert an object which is an instance of source class to String
String	convertToString(Object object) Convert an object to String This method infers the source type for the conversion from the runtime type of object.
String	convertToString(Object object, Class<? extends Annotation> qualifier) Convert an object to String This method infers the source type for the conversion from the runtime type of object.
<S,T> Binding<S,T>	findBinding(Class<S> source, Class<T> target) Resolve a Binding with the given source and target class.
<S,T> Binding<S,T>	findBinding(Class<S> source, Class<T> target, Class<? extends Annotation> qualifier) Resolve a Binding with the given source and target class.
<S,T> Binding<S,T>	findBinding(ConverterKey<S,T> key) Resolve a Binding with the given source and target class.
<S,T> Converter<S,T>	findConverter(Class<S> input, Class<T> output) Resolve a Converter with the given input and output classes.
<S,T> Converter<S,T>	findConverter(Class<S> source, Class<T> target, Class<? extends Annotation> qualifier) Resolve a Converter with the given input and output classes.
<S,T> Converter<S,T>	findConverter(ConverterKey<S,T> key) Resolve a Converter with the given input and output classes.
<S,T> ToMarshaller<S,T>	findMarshaller(Class<S> source, Class<T> target) Resolve a Marshaller with the given source and target class.
<S,T> ToMarshaller<S,T>	findMarshaller(Class<S> source, Class<T> target, Class<? extends Annotation> qualifier) Resolve a Marshaller with the given source and target class.
<S,T> ToMarshaller<S,T>	findMarshaller(ConverterKey<S,T> key) Resolve a Marshaller with the given source and target class.
<S,T> FromUnmarshaller<S,T>	findUnmarshaller(Class<S> source, Class<T> target) Resolve an UnMarshaller with the given source and target class.
<S,T> FromUnmarshaller<S,T>	findUnmarshaller(Class<S> source, Class<T> target, Class<? extends Annotation> qualifier) Resolve an UnMarshaller with the given source and target class.
<S,T> FromUnmarshaller<S,T>	findUnmarshaller(ConverterKey<S,T> key) Resolve an UnMarshaller with the given source and target class.
Iterable<ConverterKey<?,?>>	getConverterEntries() Return an iterable collection of ConverterKeys, one for each currently registered conversion
protected <I> I	getExtendedBinder(Class<I> cls) Retrieves an extended binder
void	registerAnnotatedClasses(Class<?>... classesToInspect) Inspect each of the supplied classes, processing any of the annotated methods found
<S,T> void	registerBinding(Class<S> source, Class<T> target, Binding<S,T> converter) Register a Binding with the given source and target class.
<S,T> void	registerBinding(Class<S> source, Class<T> target, Binding<S,T> converter, Class<? extends Annotation> qualifier) Register a Binding with the given source and target class.
<S,T> void	registerBinding(ConverterKey<S,T> key, Binding<S,T> converter) Register a Binding with the given source and target class.
protected void	registerBindingConfigurationEntries(Iterable<BindingConfigurationEntry> bindings) Registers a list of binding configuration entries.
protected <S,T> void	registerBindingConfigurationEntry(BindingConfigurationEntry theBinding) Register a particular binding configuration entry.
void	registerConfiguration(URL nextLocation) Register the configuration file (bindings.xml) at the given URL
protected <X> void	registerConfigurations(Enumeration<URL> bindingsConfiguration) Registers a set of configurations for the given list of URLs.
<S,T> void	registerConverter(Class<S> input, Class<T> output, Converter<S,T> converter) Register a Converter with the given input and output classes.
<S,T> void	registerConverter(Class<S> input, Class<T> output, Converter<S,T> converter, Class<? extends Annotation> qualifier) Register a Converter with the given input and output classes.
<S,T> void	registerConverter(ConverterKey<S,T> key, Converter<S,T> converter) Register a Converter with the given input and output classes.
void	registerConverterProvider(ConverterProvider provider) Register a single converter provider
void	registerConverterProviders(ConverterProvider... providers) Method used to register one or more converter providers.
protected <I,T extends I> void	registerExtendedBinder(Class<I> iface, T provider) Register a custom, typesafe binder implementation which can be retrieved later
<S,T> void	registerMarshaller(Class<S> source, Class<T> target, ToMarshaller<S,T> converter) Register a Marshaller with the given source and target class.
<S,T> void	registerMarshaller(Class<S> source, Class<T> target, ToMarshaller<S,T> converter, Class<? extends Annotation> qualifier) Register a Marshaller with the given source and target class.
<S,T> void	registerMarshaller(ConverterKey<S,T> key, ToMarshaller<S,T> converter) Register a Marshaller with the given source and target class.
<S,T> void	registerUnmarshaller(Class<S> source, Class<T> target, FromUnmarshaller<S,T> converter) Register an UnMarshaller with the given source and target class.
<S,T> void	registerUnmarshaller(Class<S> source, Class<T> target, FromUnmarshaller<S,T> converter, Class<? extends Annotation> qualifier) Register an UnMarshaller with the given source and target class.
<S,T> void	registerUnmarshaller(ConverterKey<S,T> key, FromUnmarshaller<S,T> converter) Register an UnMarshaller with the given source and target class.

Methods inherited from class java.lang.Object

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

Constructor Detail

BasicBinder

public BasicBinder()

Creates a new instance, initialised with standard, and registered bindings

BasicBinder

public BasicBinder(boolean includeBuiltInBindings)

Creates a new instance

Parameters:

includeBuiltInBindings - If true, initialise with standard, and registered bindings

Method Detail

registerConfigurations

protected <X> void registerConfigurations(Enumeration<URL> bindingsConfiguration)

Registers a set of configurations for the given list of URLs. This is typically used to process all the various bindings.xml files discovered in jars on the classpath. It is given protected scope to allow subclasses to register additional configurations

Type Parameters:

X - Internally used type argument

Parameters:

bindingsConfiguration - An enumeration of the URLs to process

registerConfiguration

public final void registerConfiguration(URL nextLocation)

Register the configuration file (bindings.xml) at the given URL

Specified by:

registerConfiguration in interface RegisterableBinder

Parameters:

nextLocation - The URL to register

registerConverterProviders

public void registerConverterProviders(ConverterProvider... providers)

Method used to register one or more converter providers. Converters extend the binding framework to provide additional mechanisms for discovering and registering bindings (e.g. using Joda Convert). This method is protected so that subclasses can register additional providers.

Parameters:

providers - A collection of providers

registerConverterProvider

public void registerConverterProvider(ConverterProvider provider)

Register a single converter provider

Parameters:

provider - The provider.

registerBindingConfigurationEntries

protected void registerBindingConfigurationEntries(Iterable<BindingConfigurationEntry> bindings)

Registers a list of binding configuration entries. A binding configuration entry described in a section of a bindings.xml file and describes the use of a particular method for databinding.

Parameters:

bindings - The entries to register

registerBindingConfigurationEntry

protected <S,T> void registerBindingConfigurationEntry(BindingConfigurationEntry theBinding)

Register a particular binding configuration entry.

Type Parameters:

S - The Source type for the binding

T - The Target type for the binding

Parameters:

theBinding - The entry to be registered

registerAnnotatedClasses

public void registerAnnotatedClasses(Class<?>... classesToInspect)

Inspect each of the supplied classes, processing any of the annotated methods found

Specified by:

registerAnnotatedClasses in interface RegisterableBinder

Parameters:

classesToInspect - The classes to inspect for annotations

registerExtendedBinder

protected <I,T extends I> void registerExtendedBinder(Class<I> iface,
                                                      T provider)

Register a custom, typesafe binder implementation which can be retrieved later

Type Parameters:

I - The class to be registered

T - Implementation of the binder type, I.

Parameters:

iface - The interface for the provider to be registered.

provider - The implementation.

getExtendedBinder

protected <I> I getExtendedBinder(Class<I> cls)

Retrieves an extended binder

Type Parameters:

I - Interface type for the extended binder

Parameters:

cls - The implementation.

Returns:

The found extended binder

registerBinding

public final <S,T> void registerBinding(Class<S> source,
                                        Class<T> target,
                                        Binding<S,T> converter)

Register a Binding with the given source and target class. A binding unifies a marshaller and an unmarshaller and both must be available to resolve a binding. The source class is considered the owning class of the binding. The source can be marshalled into the target class. Similarly, the target can be unmarshalled to produce an instance of the source type.

Specified by:

registerBinding in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

source - The source (owning) class

target - The target (foreign) class

converter - The binding to be registered

registerUnmarshaller

public final <S,T> void registerUnmarshaller(Class<S> source,
                                             Class<T> target,
                                             FromUnmarshaller<S,T> converter)

Register an UnMarshaller with the given source and target class. The unmarshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

registerUnmarshaller in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

source - The source (input) class

target - The target (output) class

converter - The FromUnmarshaller to be registered

registerMarshaller

public final <S,T> void registerMarshaller(Class<S> source,
                                           Class<T> target,
                                           ToMarshaller<S,T> converter)

Register a Marshaller with the given source and target class. The marshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

registerMarshaller in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

source - The source (input) class

target - The target (output) class

converter - The ToMarshaller to be registered

registerConverter

public final <S,T> void registerConverter(Class<S> input,
                                          Class<T> output,
                                          Converter<S,T> converter)

Register a Converter with the given input and output classes. Instances of the input class can be converted into instances of the output class

Specified by:

registerConverter in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

input - The input class

output - The output class

converter - The Converter to be registered

registerBinding

public final <S,T> void registerBinding(Class<S> source,
                                        Class<T> target,
                                        Binding<S,T> converter,
                                        Class<? extends Annotation> qualifier)

Register a Binding with the given source and target class. A binding unifies a marshaller and an unmarshaller and both must be available to resolve a binding. The source class is considered the owning class of the binding. The source can be marshalled into the target class. Similarly, the target can be unmarshalled to produce an instance of the source type.

Specified by:

registerBinding in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

source - The source (owning) class

target - The target (foreign) class

converter - The binding to be registered

qualifier - The qualifier for which the binding must be registered

registerBinding

public final <S,T> void registerBinding(ConverterKey<S,T> key,
                                        Binding<S,T> converter)

Register a Binding with the given source and target class. A binding unifies a marshaller and an unmarshaller and both must be available to resolve a binding. The source class is considered the owning class of the binding. The source can be marshalled into the target class. Similarly, the target can be unmarshalled to produce an instance of the source type.

Specified by:

registerBinding in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

key - Converter Key to use

converter - The binding to be registered

registerUnmarshaller

public final <S,T> void registerUnmarshaller(Class<S> source,
                                             Class<T> target,
                                             FromUnmarshaller<S,T> converter,
                                             Class<? extends Annotation> qualifier)

Register an UnMarshaller with the given source and target class. The unmarshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

registerUnmarshaller in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

source - The source (input) class

target - The target (output) class

converter - The FromUnmarshaller to be registered

qualifier - The qualifier for which the unmarshaller must be registered

registerUnmarshaller

public final <S,T> void registerUnmarshaller(ConverterKey<S,T> key,
                                             FromUnmarshaller<S,T> converter)

Register an UnMarshaller with the given source and target class. The unmarshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

registerUnmarshaller in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

key - Converter Key to use

converter - The FromUnmarshaller to be registered

registerMarshaller

public final <S,T> void registerMarshaller(Class<S> source,
                                           Class<T> target,
                                           ToMarshaller<S,T> converter,
                                           Class<? extends Annotation> qualifier)

Register a Marshaller with the given source and target class. The marshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

registerMarshaller in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

source - The source (input) class

target - The target (output) class

converter - The ToMarshaller to be registered

qualifier - The qualifier for which the marshaller must be registered

registerMarshaller

public final <S,T> void registerMarshaller(ConverterKey<S,T> key,
                                           ToMarshaller<S,T> converter)

Register a Marshaller with the given source and target class. The marshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

registerMarshaller in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

key - Converter Key to use

converter - The ToMarshaller to be registered

registerConverter

public final <S,T> void registerConverter(Class<S> input,
                                          Class<T> output,
                                          Converter<S,T> converter,
                                          Class<? extends Annotation> qualifier)

Register a Converter with the given input and output classes. Instances of the input class can be converted into instances of the output class

Specified by:

registerConverter in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

input - The input class

output - The output class

converter - The Converter to be registered

qualifier - The qualifier for which the converter must be registered

registerConverter

public final <S,T> void registerConverter(ConverterKey<S,T> key,
                                          Converter<S,T> converter)

Register a Converter with the given input and output classes. Instances of the input class can be converted into instances of the output class

Specified by:

registerConverter in interface RegisterableBinder

Type Parameters:

S - Source type

T - Target type

Parameters:

key - Converter Key to use

converter - The Converter to be registered

convertTo

public <S,T> T convertTo(Class<T> output,
                         Object object)

Convert an object to the given target class This method infers the source type for the conversion from the runtime type of object.

Specified by:

convertTo in interface ConversionBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

output - The target class to convert the object to

object - The object to be converted

Returns:

The result of the conversion

convertTo

public <S,T> T convertTo(Class<T> output,
                         Object object,
                         Class<? extends Annotation> qualifier)

Convert an object to the given target class This method infers the source type for the conversion from the runtime type of object.

Specified by:

convertTo in interface ConversionBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

output - The target class to convert the object to

object - The object to be converted

qualifier - The qualifier for which the binding must be registered

Returns:

The result of the conversion

convertTo

public <S,T> T convertTo(Class<S> input,
                         Class<T> output,
                         Object object)

Convert an object which is an instance of source class to the given target class

Specified by:

convertTo in interface ConversionBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

input - The class of the object to be converted

output - The target class to convert the object to

object - The object to be converted

Returns:

The result of the conversion

convertTo

public <S,T> T convertTo(Class<S> input,
                         Class<T> output,
                         Object object,
                         Class<? extends Annotation> qualifier)

Convert an object which is an instance of source class to the given target class

Specified by:

convertTo in interface ConversionBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

input - The class of the object to be converted

output - The target class to convert the object to

object - The object to be converted

qualifier - Match the converter with the given qualifier

Returns:

The result of the conversion

convertTo

public <S,T> T convertTo(ConverterKey<S,T> key,
                         Object object)

Convert an object which is an instance of source class to the given target class

Specified by:

convertTo in interface ConversionBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

key - The converter key to use

object - The object to be converted

Returns:

The result of the conversion

findBinding

public <S,T> Binding<S,T> findBinding(Class<S> source,
                                      Class<T> target)

Resolve a Binding with the given source and target class. A binding unifies a marshaller and an unmarshaller and both must be available to resolve a binding. The source class is considered the owning class of the binding. The source can be marshalled into the target class. Similarly, the target can be unmarshalled to produce an instance of the source type.

Specified by:

findBinding in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

source - The source (owning) class

target - The target (foreign) class

Returns:

The found Binding

findMarshaller

public <S,T> ToMarshaller<S,T> findMarshaller(Class<S> source,
                                              Class<T> target)

Resolve a Marshaller with the given source and target class. The marshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

findMarshaller in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

source - The source (input) class

target - The target (output) class

Returns:

The found Marshaller

findConverter

public <S,T> Converter<S,T> findConverter(Class<S> input,
                                          Class<T> output)

Resolve a Converter with the given input and output classes. Instances of the input class can be converted into instances of the output class

Specified by:

findConverter in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

input - The input class

output - The output class

Returns:

The found Converter

findUnmarshaller

public <S,T> FromUnmarshaller<S,T> findUnmarshaller(Class<S> source,
                                                    Class<T> target)

Resolve an UnMarshaller with the given source and target class. The unmarshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

findUnmarshaller in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

source - The source (input) class

target - The target (output) class

Returns:

The found Unmarshaller

findBinding

public <S,T> Binding<S,T> findBinding(Class<S> source,
                                      Class<T> target,
                                      Class<? extends Annotation> qualifier)

Resolve a Binding with the given source and target class. A binding unifies a marshaller and an unmarshaller and both must be available to resolve a binding. The source class is considered the owning class of the binding. The source can be marshalled into the target class. Similarly, the target can be unmarshalled to produce an instance of the source type.

Specified by:

findBinding in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

source - The source (owning) class

target - The target (foreign) class

qualifier - The qualifier for which the binding must be registered

Returns:

The found Binding

findBinding

public <S,T> Binding<S,T> findBinding(ConverterKey<S,T> key)

Resolve a Binding with the given source and target class. A binding unifies a marshaller and an unmarshaller and both must be available to resolve a binding. The source class is considered the owning class of the binding. The source can be marshalled into the target class. Similarly, the target can be unmarshalled to produce an instance of the source type.

Specified by:

findBinding in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

key - The key to look up

Returns:

The found Binding

findMarshaller

public <S,T> ToMarshaller<S,T> findMarshaller(Class<S> source,
                                              Class<T> target,
                                              Class<? extends Annotation> qualifier)

Resolve a Marshaller with the given source and target class. The marshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

findMarshaller in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

source - The source (input) class

target - The target (output) class

qualifier - The qualifier for which the marshaller must be registered

Returns:

The found Marshaller

findMarshaller

public <S,T> ToMarshaller<S,T> findMarshaller(ConverterKey<S,T> key)

Resolve a Marshaller with the given source and target class. The marshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

findMarshaller in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

key - The key to look up

Returns:

The found Marshaller

findConverter

public <S,T> Converter<S,T> findConverter(Class<S> source,
                                          Class<T> target,
                                          Class<? extends Annotation> qualifier)

Resolve a Converter with the given input and output classes. Instances of the input class can be converted into instances of the output class

Specified by:

findConverter in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

source - The source class

target - The target class

qualifier - The qualifier for which the marshaller must be registered

Returns:

The found Converter

findConverter

public <S,T> Converter<S,T> findConverter(ConverterKey<S,T> key)

Resolve a Converter with the given input and output classes. Instances of the input class can be converted into instances of the output class

Specified by:

findConverter in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

key - The key to look up

Returns:

The found Converter

findUnmarshaller

public <S,T> FromUnmarshaller<S,T> findUnmarshaller(Class<S> source,
                                                    Class<T> target,
                                                    Class<? extends Annotation> qualifier)

Resolve an UnMarshaller with the given source and target class. The unmarshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

findUnmarshaller in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

source - The source (input) class

target - The target (output) class

qualifier - The qualifier for which the unmarshaller must be registered

Returns:

The found Unmarshaller

findUnmarshaller

public <S,T> FromUnmarshaller<S,T> findUnmarshaller(ConverterKey<S,T> key)

Resolve an UnMarshaller with the given source and target class. The unmarshaller is used as follows: Instances of the source can be marshalled into the target class.

Specified by:

findUnmarshaller in interface SearchableBinder

Type Parameters:

S - The Source type

T - The Target type

Parameters:

key - The key to look up

Returns:

The found Unmarshaller

getConverterEntries

public Iterable<ConverterKey<?,?>> getConverterEntries()

Return an iterable collection of ConverterKeys, one for each currently registered conversion

Specified by:

getConverterEntries in interface RegisterableBinder

convertFromString

public <T> T convertFromString(Class<T> output,
                               String object)

* String Binder * *

Specified by:

convertFromString in interface StringBinder

Type Parameters:

T - The type of the target class

Parameters:

output - The target class to convert the object to

object - The String to be converted

Returns:

An instance of the target class

convertFromString

public <T> T convertFromString(Class<T> output,
                               String object,
                               Class<? extends Annotation> qualifier)

Description copied from interface: StringBinder

Convert a String to the given target class

Specified by:

convertFromString in interface StringBinder

Type Parameters:

T - The type of the target class

Parameters:

output - The target class to convert the object to

object - The String to be converted

qualifier - The qualifier for which the binding must be registered

Returns:

An instance of the target class

convertToString

public String convertToString(Object object)

Description copied from interface: StringBinder

Convert an object to String This method infers the source type for the conversion from the runtime type of object.

Specified by:

convertToString in interface StringBinder

Parameters:

object - The object to be converted

Returns:

A String

convertToString

public String convertToString(Object object,
                              Class<? extends Annotation> qualifier)

Description copied from interface: StringBinder

Convert an object to String This method infers the source type for the conversion from the runtime type of object.

Specified by:

convertToString in interface StringBinder

Parameters:

object - The object to be converted

qualifier - The qualifier for which the binding must be registered

Returns:

A String

convertToString

public <S> String convertToString(Class<S> input,
                                  Object object)

Description copied from interface: StringBinder

Convert an object which is an instance of source class to String

Specified by:

convertToString in interface StringBinder

Type Parameters:

S - The type of the input class

Parameters:

input - The class of the object to be converted

object - The object to be converted

Returns:

A String

convertToString

public <S> String convertToString(Class<S> input,
                                  Object object,
                                  Class<? extends Annotation> qualifier)

Description copied from interface: StringBinder

Convert an object which is an instance of source class to String

Specified by:

convertToString in interface StringBinder

Type Parameters:

S - The type of the input class

Parameters:

input - The class of the object to be converted

object - The object to be converted

qualifier - Match the converter with the given qualifier

Returns:

A String