com.sun.msv.datatype
Interface DatabindableDatatype

All Known Subinterfaces:
XSDatatype
All Known Implementing Classes:
XSDatatypeImpl

public interface DatabindableDatatype

Datatype interface that supports Java databinding. This interface can be used to do java/xml databinding.

Author:
Kohsuke Kawaguchi

Method Summary
 Object createJavaObject(String literal, ValidationContext context)
          converts lexcial value to a corresponding Java-friendly object by using the given context information.
 Class getJavaObjectType()
          gets the type of the objects that are created by the createJavaObject method.
 String serializeJavaObject(Object value, SerializationContext context)
          converts a value object back to the lexical representation.
 

Method Detail

createJavaObject

public Object createJavaObject(String literal,
                               ValidationContext context)
converts lexcial value to a corresponding Java-friendly object by using the given context information.

For the actual types returned by each type, see here.

Note that due to the difference between those Java friendly types and actual XML Schema specification, the returned object sometimes loses accuracy. For example, the "time" type allows "0.0000000000001 sec" which cannot be represented in java.util.Calendar class.

Returns:
null when the given lexical value is not a valid lexical value for this type.

serializeJavaObject

public String serializeJavaObject(Object value,
                                  SerializationContext context)
                           throws IllegalArgumentException
converts a value object back to the lexical representation.

This method is a kind of the "reverse" function of the createJavaObject method.

Parameters:
context - The context object is used to obtain information necessary to serialize the value object. For example, QName type uses the context to encode the URI into a prefix.
Returns:
null if the given object is invalid with respect to this datatype.
Throws:
IllegalArgumentException - If the type of the specified value object is not recognized, this exception is thrown. For example, if you pass a String object to the serializeJavaObject method of the "positiveInteger" type, this exception is thrown.

getJavaObjectType

public Class getJavaObjectType()
gets the type of the objects that are created by the createJavaObject method.