Package org.simpleframework.xml.convert
Class Registry
- java.lang.Object
-
- org.simpleframework.xml.convert.Registry
-
public class Registry extends java.lang.Object
TheRegistry
represents an object that is used to register bindings between a class and a converter implementation. Converter instances created by this registry are lazily created and cached so that they are instantiated only once. This ensures that the overhead of serialization is reduced.- See Also:
RegistryStrategy
-
-
Field Summary
Fields Modifier and Type Field Description private RegistryBinder
binder
This is used to bind converter types to serializable types.private Cache<Converter>
cache
This is used to cache the converters based on object types.
-
Constructor Summary
Constructors Constructor Description Registry()
Constructor for theRegistry
object.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Registry
bind(java.lang.Class type, java.lang.Class converter)
This is used to register a binding between a type and the converter used to serialize and deserialize it.Registry
bind(java.lang.Class type, Converter converter)
This is used to register a binding between a type and the converter used to serialize and deserialize it.private Converter
create(java.lang.Class type)
This is used to acquire aConverter
instance from the registry.Converter
lookup(java.lang.Class type)
This is used to acquire aConverter
instance from the registry.
-
-
-
Field Detail
-
cache
private final Cache<Converter> cache
This is used to cache the converters based on object types.
-
binder
private final RegistryBinder binder
This is used to bind converter types to serializable types.
-
-
Method Detail
-
lookup
public Converter lookup(java.lang.Class type) throws java.lang.Exception
This is used to acquire aConverter
instance from the registry. All instances are cache to reduce the overhead of lookups during the serialization process. Converters are lazily instantiated and so are only created if demanded.- Parameters:
type
- this is the type to find the converter for- Returns:
- this returns the converter instance for the type
- Throws:
java.lang.Exception
-
create
private Converter create(java.lang.Class type) throws java.lang.Exception
This is used to acquire aConverter
instance from the registry. All instances are cached to reduce the overhead of lookups during the serialization process. Converters are lazily instantiated and so are only created if demanded.- Parameters:
type
- this is the type to find the converter for- Returns:
- this returns the converter instance for the type
- Throws:
java.lang.Exception
-
bind
public Registry bind(java.lang.Class type, java.lang.Class converter) throws java.lang.Exception
This is used to register a binding between a type and the converter used to serialize and deserialize it. During the serialization process the converters are retrieved and used to convert the object members to XML.- Parameters:
type
- this is the object type to bind to a converterconverter
- this is the converter class to be used- Returns:
- this will return this registry instance to use
- Throws:
java.lang.Exception
-
bind
public Registry bind(java.lang.Class type, Converter converter) throws java.lang.Exception
This is used to register a binding between a type and the converter used to serialize and deserialize it. During the serialization process the converters are retrieved and used to convert the object properties to XML.- Parameters:
type
- this is the object type to bind to a converterconverter
- this is the converter instance to be used- Returns:
- this will return this registry instance to use
- Throws:
java.lang.Exception
-
-