org.apache.soap.encoding
Class SOAPMappingRegistry

java.lang.Object
  |
  +--org.apache.soap.util.xml.XMLJavaMappingRegistry
        |
        +--org.apache.soap.encoding.SOAPMappingRegistry

public class SOAPMappingRegistry

extends XMLJavaMappingRegistry

A SOAPMappingRegistry object is an XMLJavaMappingRegistry with pre-registered serializers and deserializers to support SOAP.

partSer

public static MimePartSerializer partSer

SOAPMappingRegistry

public SOAPMappingRegistry()

Create a new SMR. The resulting registry is aware of all pre-defined type mappings.

SOAPMappingRegistry

public SOAPMappingRegistry(SOAPMappingRegistry parent)

This constructor takes a "parent" registry as a base registry. Lookup requests cascade up to the parent while registration requests stay here.

SOAPMappingRegistry

public SOAPMappingRegistry(SOAPMappingRegistry parent,
                           java.lang.String schemaURI)

This constructor is the base constructor. If parent is null, then this is viewed as a base registry and the registry is initialized with all the default mappings etc.. If it is not-null, the no init is done and the parent is assumed to have the stuff in it already.

Parameters:

parent - the "parent" SMR to delegate lookups to if I can't find the stuff in my tables. If parent is null, then I get pre-loaded with all the default type mappings etc. (some of which are based on the schema URI). If parent is not null, the default stuff is not put in - the idea is that in that case the parent already contains the defaults.

schemaURI - the namespace URI of XSD to be used for serializers. Deserializers for all 3 XSD URIs are always registered.

getBaseRegistry

public static SOAPMappingRegistry getBaseRegistry(java.lang.String schemaURI)

Return the singleton registry instance configured for the indicated schema URI. If the schemaURI is unrecognized, the 2001 base registry is returned.

setDefaultEncodingStyle

public void setDefaultEncodingStyle(java.lang.String defEncStyle)

Set the default encoding style. If the query*() calls are invoked with a null encodingStyleURI parameter, we'll use this instead.

Overrides:

setDefaultEncodingStyle in class XMLJavaMappingRegistry

getSchemaURI

public java.lang.String getSchemaURI()

Return the schemaURI that was used to create this registry instance.

getParent

public SOAPMappingRegistry getParent()

Returns the "parent" registry, if there is one. Otherwise, returns null.

queryElementType_

protected QName queryElementType_(java.lang.Class javaType,
                                  java.lang.String encodingStyleURI)

This function overrides the one in XMLJavaMappingRegistry for the sole purpose of returning SOAP-ENC:Array when javaType represents an array. The XMLJavaMappingRegistry will be consulted first, and if no mapping is found, SOAP-ENC:Array is returned. Obviously, this only applies when the encoding style is soap encoding.

Overrides:

queryElementType_ in class XMLJavaMappingRegistry

querySerializer_

protected Serializer querySerializer_(java.lang.Class javaType,
                                      java.lang.String encodingStyleURI)

This function overrides the one in XMLJavaMappingRegistry for the sole purpose of returning an ArraySerializer when javaType represents an array. The XMLJavaMappingRegistry will be consulted first, and if no serializer is found for javaType, ArraySerailizer is returned. Obviously, this only applies when the encoding style is soap encoding.

Overrides:

querySerializer_ in class XMLJavaMappingRegistry

queryDeserializer_

protected Deserializer queryDeserializer_(QName elementType,
                                          java.lang.String encodingStyleURI)

Override the query deserializer to look at the parent too before saying that a deserializer is not available.

Overrides:

queryDeserializer_ in class XMLJavaMappingRegistry

queryJavaType_

protected java.lang.Class queryJavaType_(QName elementType,
                                         java.lang.String encodingStyleURI)

Overide the query Javatype to look at the parent too before saying that a Java type is not available.

Overrides:

queryJavaType_ in class XMLJavaMappingRegistry