Package org.simpleframework.xml.convert
Class RegistryStrategy
java.lang.Object
org.simpleframework.xml.convert.RegistryStrategy
- All Implemented Interfaces:
Strategy
The
RegistryStrategy
object is used to intercept
the serialization process and delegate to custom converters. The
custom converters are resolved from a Registry
object, which is provided to the constructor. If there is no
binding for a particular object then serialization is delegated
to an internal strategy. All converters resolved by this are
instantiated once and cached internally for performance.
By default the TreeStrategy
is used to perform the
normal serialization process should there be no class binding
specifying a converter to use. However, any implementation can
be used, including the CycleStrategy
, which handles
cycles in the object graph. To specify the internal strategy to
use it can be provided in the constructor.
- See Also:
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionRegistryStrategy
(Registry registry) Constructor for theRegistryStrategy
object.RegistryStrategy
(Registry registry, Strategy strategy) Constructor for theRegistryStrategy
object. -
Method Summary
Modifier and TypeMethodDescriptionprivate boolean
isReference
(Value value) This is used to determine if theValue
provided represents a reference.private Converter
This is used to acquire aConverter
instance for the provided object instance.private Converter
This is used to acquire aConverter
instance for the provided value object.This is used to read theValue
which will be used to represent the deserialized object.private Value
This is used to read theValue
which will be used to represent the deserialized object.private boolean
write
(Type type, Object value, NodeMap<OutputNode> node) This is used to serialize a representation of the object value provided.boolean
This is used to serialize a representation of the object value provided.
-
Field Details
-
registry
This is the registry that is used to resolve bindings. -
strategy
This is the strategy used if there is no bindings.
-
-
Constructor Details
-
RegistryStrategy
Constructor for theRegistryStrategy
object. This is used to create a strategy that will intercept the normal serialization process by searching for bindings within the providedRegistry
instance.- Parameters:
registry
- this is the registry instance with bindings
-
RegistryStrategy
Constructor for theRegistryStrategy
object. This is used to create a strategy that will intercept the normal serialization process by searching for bindings within the providedRegistry
instance.- Parameters:
registry
- this is the registry instance with bindingsstrategy
- this is the strategy to delegate to
-
-
Method Details
-
read
This is used to read theValue
which will be used to represent the deserialized object. If there is an binding present then the value will contain an object instance. If it does not then it is up to the internal strategy to determine what the returned value contains.- Specified by:
read
in interfaceStrategy
- Parameters:
type
- this is the type that represents a method or fieldnode
- this is the node representing the XML elementmap
- this is the session map that contain variables- Returns:
- the value representing the deserialized value
- Throws:
Exception
- thrown if the class cannot be resolved
-
read
This is used to read theValue
which will be used to represent the deserialized object. If there is an binding present then the value will contain an object instance. If it does not then it is up to the internal strategy to determine what the returned value contains.- Parameters:
type
- this is the type that represents a method or fieldnode
- this is the node representing the XML elementvalue
- this is the value from the internal strategy- Returns:
- the value representing the deserialized value
- Throws:
Exception
-
write
This is used to serialize a representation of the object value provided. If there is aRegistry
binding present for the provided type then this will use the converter specified to serialize a representation of the object. If however there is no binding present then this will delegate to the internal strategy. This returns true if the serialization has completed.- Specified by:
write
in interfaceStrategy
- Parameters:
type
- this is the type that represents the field or methodvalue
- this is the object instance to be serializednode
- this is the XML element to be serialized tomap
- this is the session map used by the serializer- Returns:
- this returns true if it was serialized, false otherwise
- Throws:
Exception
- thrown if the details cannot be set
-
write
This is used to serialize a representation of the object value provided. If there is aRegistry
binding present for the provided type then this will use the converter specified to serialize a representation of the object. If however there is no binding present then this will delegate to the internal strategy. This returns true if the serialization has completed.- Parameters:
type
- this is the type that represents the field or methodvalue
- this is the object instance to be serializednode
- this is the XML element to be serialized to- Returns:
- this returns true if it was serialized, false otherwise
- Throws:
Exception
-
lookup
This is used to acquire aConverter
instance for the provided value object. The value object is used to resolve the converter to use for the serialization process.- Parameters:
type
- this is the type representing the field or methodvalue
- this is the value that is to be serialized- Returns:
- this returns the converter instance that is matched
- Throws:
Exception
-
lookup
This is used to acquire aConverter
instance for the provided object instance. The instance class is used to resolve the converter to use for the serialization process.- Parameters:
type
- this is the type representing the field or methodvalue
- this is the value that is to be serialized- Returns:
- this returns the converter instance that is matched
- Throws:
Exception
-
isReference
This is used to determine if theValue
provided represents a reference. If it does represent a reference then this will return true, if it does not then this returns false.- Parameters:
value
- this is the value instance to be evaluated- Returns:
- this returns true if the value represents a reference
-