Package com.oracle.webservices.api.databinding

Interface Databinding

All Known Subinterfaces:

Databinding

All Known Implementing Classes:

DatabindingImpl

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

Nested Classes

Modifier and Type	Interface	Description
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.

Method Summary

Modifier and Type	Method	Description
JavaCallInfo	createJavaCallInfo(Method method, 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(Method method,
                                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:

message - 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