org.jboss.axis.encoding.ser
Class BeanDeserializer

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.BeanDeserializer

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:

MetaDataBeanDeserializer (src)

public class BeanDeserializer

extends DeserializerImpl (src)

General purpose deserializer for an arbitrary java bean.

See Also:

Serialized Form

propertyMap

protected java.util.Map propertyMap

prevQName

protected QName (src)  prevQName

typeDesc

protected TypeDesc (src)  typeDesc

Type metadata about this class for XML deserialization

collectionIndex

protected int collectionIndex

cacheStringDSer

protected SimpleDeserializer (src)  cacheStringDSer

cacheXMLType

protected QName (src)  cacheXMLType

lastFieldName

protected java.lang.String lastFieldName

deferedConstruction

protected DeferedBeanConstruction (src)  deferedConstruction

BeanDeserializer

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

BeanDeserializer

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

BeanDeserializer

public BeanDeserializer(java.lang.Class javaType,
                        QName (src)  xmlType,
                        TypeDesc (src)  typeDesc,
                        java.util.Map propertyMap)

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

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

Deserializer interface called on each child element encountered in the XML stream.

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

onEndElement

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

Check that we have a valid bean instance

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

getAnyPropertyDesc

public BeanPropertyDescriptor (src)  getAnyPropertyDesc()

Get a BeanPropertyDescriptor which indicates where we should put extensibility elements (i.e. XML which falls under the auspices of an <xsd:any> declaration in the schema)

Returns:

an appropriate BeanPropertyDescriptor, or null

getDeserializer

protected Deserializer (src)  getDeserializer(QName (src)  xmlType,
                                       java.lang.Class javaType,
                                       java.lang.String href,
                                       DeserializationContext (src)  context)

Get the Deserializer for the attribute or child element.

Parameters:

xmlType - QName of the attribute/child element or null if not known.

javaType - Class of the corresponding property

href - String is the value of the href attribute, which is used to determine whether the child element is complete or an href to another element.

context - DeserializationContext

Returns:

Deserializer or null if not found.

characters

public void characters(char[] p1,
                       int p2,
                       int p3)
                throws org.xml.sax.SAXException

This will assign text content to the bean property that is an element with the asContent flag set to true. There can only be one, or is there a way to know which? TDI 22-June-2004

Throws:

org.xml.sax.SAXException