org.jboss.axis.encoding.ser
Class SimpleDeserializer

java.lang.Object
  org.xml.sax.helpers.DefaultHandler
      org.jboss.axis.message.SOAPHandler (src) 
          org.jboss.axis.encoding.DeserializerImpl (src) 
              org.jboss.axis.encoding.ser.SimpleDeserializer

All Implemented Interfaces:

Callback (src) , org.xml.sax.ContentHandler, Deserializer (src) , Deserializer (src) , org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler, java.io.Serializable

Direct Known Subclasses:

CalendarDeserializer (src) , DateDeserializer (src) , EnumDeserializer (src) , ObjectNameDeser (src) , QNameDeserializer (src)

public class SimpleDeserializer

extends DeserializerImpl (src)

A deserializer for any simple type with a (String) constructor. Note: this class is designed so that subclasses need only override the makeValue method in order to construct objects of their own type.

See Also:

Serialized Form

xmlType

public QName (src)  xmlType

javaType

public java.lang.Class javaType

cacheStringDSer

protected SimpleDeserializer (src)  cacheStringDSer

cacheXMLType

protected QName (src)  cacheXMLType

SimpleDeserializer

public SimpleDeserializer(java.lang.Class javaType,
                          QName (src)  xmlType)

The Deserializer is constructed with the xmlType and javaType (which could be a java primitive like int.class)

SimpleDeserializer

public SimpleDeserializer(java.lang.Class javaType,
                          QName (src)  xmlType,
                          TypeDesc (src)  typeDesc)

reset

public void reset()

Reset deserializer for re-use

removeValueTargets

public void removeValueTargets()

Remove the Value Targets of the Deserializer. Simple deserializers may be re-used, so don't nullify the vector.

Specified by:

removeValueTargets in interface Deserializer (src)

Overrides:

removeValueTargets in class DeserializerImpl (src)

setConstructor

public void setConstructor(java.lang.reflect.Constructor c)

The Factory calls setConstructor.

onStartChild

public SOAPHandler (src)  onStartChild(java.lang.String namespace,
                                java.lang.String localName,
                                java.lang.String prefix,
                                org.xml.sax.Attributes attributes,
                                DeserializationContext (src)  context)
                         throws org.xml.sax.SAXException

There should not be nested elements, so thow and exception if this occurs.

Specified by:

onStartChild in interface Deserializer (src)

Overrides:

onStartChild in class DeserializerImpl (src)

Parameters:

namespace - is the namespace of the child element

localName - is the local name of the child element

prefix - is the prefix used on the name of the child element

attributes - are the attributes of the child element

context - is the deserialization context.

Returns:

is a Deserializer to use to deserialize a child (must be a derived class of SOAPHandler) or null if no deserialization should be performed.

Throws:

org.xml.sax.SAXException

characters

public void characters(char[] chars,
                       int start,
                       int end)
                throws org.xml.sax.SAXException

Append any characters received to the value. This method is defined by Deserializer.

Throws:

org.xml.sax.SAXException

onEndElement

public void onEndElement(java.lang.String namespace,
                         java.lang.String localName,
                         DeserializationContext (src)  context)
                  throws org.xml.sax.SAXException

Append any characters to the value. This method is defined by Deserializer.

Specified by:

onEndElement in interface Deserializer (src)

Overrides:

onEndElement in class DeserializerImpl (src)

Parameters:

namespace - is the namespace of the child element

localName - is the local name of the child element

context - is the deserialization context

Throws:

org.xml.sax.SAXException

makeValue

public java.lang.Object makeValue(java.lang.String source)
                           throws java.lang.Exception

Convert the string that has been accumulated into an Object. Subclasses may override this. Note that if the javaType is a primitive, the returned object is a wrapper class.

Parameters:

source - the serialized value to be deserialized

Throws:

java.lang.Exception - any exception thrown by this method will be wrapped

onStartElement

public void onStartElement(java.lang.String namespace,
                           java.lang.String localName,
                           java.lang.String prefix,
                           org.xml.sax.Attributes attributes,
                           DeserializationContext (src)  context)
                    throws org.xml.sax.SAXException

Set the bean properties that correspond to element attributes.

This method is invoked after startElement when the element requires deserialization (i.e. the element is not an href and the value is not nil.)

Specified by:

onStartElement in interface Deserializer (src)

Overrides:

onStartElement in class DeserializerImpl (src)

Parameters:

namespace - is the namespace of the element

localName - is the name of the element

prefix - is the prefix of the element

attributes - are the attributes on the element...used to get the type

context - is the DeserializationContext

Throws:

org.xml.sax.SAXException