Interface Transform<T>
-
- All Known Implementing Classes:
ArrayTransform
,AtomicIntegerTransform
,AtomicLongTransform
,BigDecimalTransform
,BigIntegerTransform
,BooleanTransform
,ByteTransform
,CharacterArrayTransform
,CharacterTransform
,ClassTransform
,CurrencyTransform
,DateTransform
,DoubleTransform
,EnumTransform
,FileTransform
,FloatTransform
,GregorianCalendarTransform
,IntegerTransform
,LocaleTransform
,LongTransform
,ShortTransform
,StringArrayTransform
,StringTransform
,TimeZoneTransform
,URLTransform
public interface Transform<T>
ATransform
represents a an object used to transform an object to and from a string value. This is typically used when either anAttribute
orElement
annotation is used to mark the field of a type that does not contain any of the XML annotations, and so does not represent an XML structure. For example take the following annotation.@Text private Date date;
The above annotation marks an object from the Java class libraries which does not contain any XML annotations. During serialization and deserialization of such types a transform is used to process the object such that it can be written and read to and from XML.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description T
read(java.lang.String value)
This method is used to convert the string value given to an appropriate representation.java.lang.String
write(T value)
This method is used to convert the provided value into an XML usable format.
-
-
-
Method Detail
-
read
T read(java.lang.String value) throws java.lang.Exception
This method is used to convert the string value given to an appropriate representation. This is used when an object is being deserialized from the XML document and the value for the string representation is required.- Parameters:
value
- this is the string representation of the value- Returns:
- this returns an appropriate instanced to be used
- Throws:
java.lang.Exception
-
write
java.lang.String write(T value) throws java.lang.Exception
This method is used to convert the provided value into an XML usable format. This is used in the serialization process when there is a need to convert a field value in to a string so that that value can be written as a valid XML entity.- Parameters:
value
- this is the value to be converted to a string- Returns:
- this is the string representation of the given value
- Throws:
java.lang.Exception
-
-