oracle.webservices.databinding
Interface SOAPElementSerializer

public interface SOAPElementSerializer

The SOAPElementSerializer interface defines the base interface for pluggable custom serializers in the Oracle JAX-RPC implementation. A Serializer converts a Java object to an XML representation of SAAJ SOAPElement. An instance of SOAPElementSerializer serializes a JAVA object to a SOAPElement and deserializes a SOAPElement to a JAVA object.

Method Summary

Object	deserialize(SOAPElement element) The deserialize method is implemented to unmarshall a XML fragment of SAAJ SOAPElement instance to JAVA Object.
void	init(Map initParams) The init method allows the SOAPElementSerializer instance to initialize itself.
SOAPElement	serialize(QName tagName, Object object) The serialize method is implemented to marshall a JAVA Object to a XML fragment of SAAJ SOAPElement instance.

Method Detail

init

public void init(Map initParams)

The init method allows the SOAPElementSerializer instance to initialize itself. The init method passes the SOAPElementSerializer initParams as a java.util.Map instance. The initParams instance is created from the optional init-param elements of the custom serializer configuration.

Parameters:

initParams - the map of init-param elements.

serialize

public SOAPElement serialize(QName tagName,
                             Object object)

The serialize method is implemented to marshall a JAVA Object to a XML fragment of SAAJ SOAPElement instance. Implementation of this method should use the value of tagName parameter to be the top level element tag name of the returned SOAPElement instance in order for this Serializer implementation to be reusable, because a XML schema complexType may be used for different element definitions.

Parameters:

tagName - The top level element tag QName of the serialized XML fragment.

object - The JAVA Object to be serialized

Returns:

The serialized XML fragment

deserialize

public Object deserialize(SOAPElement element)

The deserialize method is implemented to unmarshall a XML fragment of SAAJ SOAPElement instance to JAVA Object.

Parameters:

element - The instance of SOAPElement to be deserialzied

Returns:

The deserialzied JAVA Object of the element