org.jvnet.ws.databinding
Interface Databinding

public interface Databinding

Databinding is the entry point for all the WebService Databinding functionality. Primarily, a Databinding is to serialize/deserialize an XML(SOAP) message to/from a JAVA method invocation and return which are represented as JavaCallInfo instances. A WSDLGenerator can be created from a Databinding object to genreate WSDL representation of a JAVA service endpoint interface.

The supported databinding modes(flavors) are:

• "toplink.jaxb"
• "glassfish.jaxb"

Following is an example that creates a Databinding which provides the operations to serialize/deserialize a JavaCallInfo to/from a SOAP message:

 DatabindingFactory factory = DatabindingFactory.newInstance();
 Databinding.Builder builder = factory.createBuilder(seiClass, endpointClass);
 Databinding databinding = builder.build(); 
 

Author:

shih-chang.chen@oracle.com

See Also:

DatabindingFactory

Nested Class Summary

static interface	Databinding.Builder Databinding.Builder, created from the DatabindingFactory, is used to configure how a Databinding instance is to be built from this builder.
static interface	Databinding.WSDLGenerator WSDLGenerator is used to generate the WSDL representation of the service endpoint interface of the parent Databinding object.

Method Summary

JavaCallInfo	createJavaCallInfo(java.lang.reflect.Method method, java.lang.Object[] args) Creates a new instance of a JavaCallInfo.
JavaCallInfo	deserializeRequest(MessageContext message) Deserializes a request XML(SOAP) message to a JavaCallInfo instance representing a JAVA method call.
JavaCallInfo	deserializeResponse(MessageContext message, JavaCallInfo call) Deserializes a response XML(SOAP) message to a JavaCallInfo instance representing the return value or exception of a JAVA method call.
MessageContext	serializeRequest(JavaCallInfo call) Serializes a JavaCallInfo instance representing a JAVA method call to a request XML(SOAP) message.
MessageContext	serializeResponse(JavaCallInfo call) Serializes a JavaCallInfo instance representing the return value or exception of a JAVA method call to a response XML(SOAP) message.

Method Detail

createJavaCallInfo

JavaCallInfo createJavaCallInfo(java.lang.reflect.Method method,
                                java.lang.Object[] args)

Creates a new instance of a JavaCallInfo.

Parameters:

method - The JAVA method

args - The parameter objects

Returns:

New instance of a JavaCallInfo

serializeRequest

MessageContext serializeRequest(JavaCallInfo call)

Serializes a JavaCallInfo instance representing a JAVA method call to a request XML(SOAP) message.

Parameters:

call - The JavaCallInfo representing a method call

Returns:

The request XML(SOAP) message

deserializeResponse

JavaCallInfo deserializeResponse(MessageContext message,
                                 JavaCallInfo call)

Deserializes a response XML(SOAP) message to a JavaCallInfo instance representing the return value or exception of a JAVA method call.

Parameters:

soap - The response message

call - The JavaCallInfo instance to be updated

Returns:

The JavaCallInfo updated with the return value or exception of a JAVA method call

deserializeRequest

JavaCallInfo deserializeRequest(MessageContext message)

Deserializes a request XML(SOAP) message to a JavaCallInfo instance representing a JAVA method call.

Parameters:

message - The request message

Returns:

The JavaCallInfo representing a method call

serializeResponse

MessageContext serializeResponse(JavaCallInfo call)

Serializes a JavaCallInfo instance representing the return value or exception of a JAVA method call to a response XML(SOAP) message.

Parameters:

call - The JavaCallInfo representing the return value or exception of a JAVA method call

Returns:

The response XML(SOAP) message