com.sun.msv.datatype

Interface DatabindableDatatype

public interface DatabindableDatatype extends Datatype

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

Author: Kohsuke Kawaguchi

Method Summary
ObjectcreateJavaObject(String literal, ValidationContext context)
converts lexcial value to a corresponding Java-friendly object by using the given context information.
ClassgetJavaObjectType()
gets the type of the objects that are created by the createJavaObject method.
StringserializeJavaObject(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.

getJavaObjectType

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

serializeJavaObject

public String serializeJavaObject(Object value, SerializationContext context)
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.