jaxws/src/share/jaxws_classes/com/sun/xml/internal/ws/api/databinding/Databinding.java
changeset 12009 4abb694f273a
child 16791 fe5141eabb0e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/jaxws/src/share/jaxws_classes/com/sun/xml/internal/ws/api/databinding/Databinding.java	Tue Mar 06 16:09:35 2012 -0800
@@ -0,0 +1,147 @@
+/*
+ * Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+package com.sun.xml.internal.ws.api.databinding;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.lang.reflect.Method;
+
+import javax.xml.ws.WebServiceFeature;
+import com.sun.xml.internal.ws.api.message.Packet;
+import com.sun.xml.internal.ws.api.pipe.ContentType;
+import com.sun.xml.internal.ws.wsdl.DispatchException;
+
+/**
+ * {@code Databinding} is the entry point for all the WebService databinding
+ * runtime functionality. Primarily, a Databinding is to serialize/deserialize an
+ * XML(SOAP) message to/from a JAVA method invocation and return value which
+ * are represented as <code>JavaCallInfo</code> instances.
+ * <p>
+ * </p>
+ * Each Databinding is associated with a <code>MessageFactory</code> instance
+ * which can be used to create <code>Message</code> instances that can be
+ * deserialized by the Databinding. The <code>MessageFactory</code> also supports
+ * the conversion of Oracle Fabric Normalized messages.
+ * <p>
+ * </p>
+ * <blockquote> Following is an example that creates a {@code Databinding} which
+ * provides the operations to serialize/deserialize a JavaCallInfo to/from a
+ * SOAP message:<br />
+ *
+ * <pre>
+ * DatabindingFactory wsfac = DatabindingFactory();
+ * Databinding rt = wsfac.createDatabinding(DatabindingConfig);
+ * </pre>
+ *
+ * </blockquote>
+ *
+ * @author shih-chang.chen@oracle.com
+ */
+public interface Databinding extends com.sun.xml.internal.org.jvnet.ws.databinding.Databinding {
+
+        /**
+         * Gets the MessageFactory instance associated with this WsRuntime
+         *
+         * @return the MessageFactory instance associated with this WsRuntime
+         */
+//      MessageFactory getMessageFactory();
+
+        /**
+         * Deserializes a request XML(SOAP) message to a JavaCallInfo instance
+         * representing a JAVA method call.
+         *
+         * @param soap
+         *            the request message
+         *
+         * @return the JavaCallInfo representing a method call
+         */
+//      JavaCallInfo deserializeRequest(Packet req);
+
+        EndpointCallBridge getEndpointBridge(Packet soap) throws DispatchException;
+
+        ClientCallBridge getClientBridge(Method method);
+
+        /**
+         * Serializes a JavaCallInfo instance representing a JAVA method call to a
+         * request XML(SOAP) message.
+         *
+         * @param call
+         *            the JavaCallInfo representing a method call
+         *
+         * @return the request XML(SOAP) message
+         */
+//      Packet serializeRequest(JavaCallInfo call);
+
+        /**
+         * Serializes a JavaCallInfo instance representing the return value or
+         * exception of a JAVA method call to a response XML(SOAP) message.
+         *
+         * @param call
+         *            the JavaCallInfo representing the return value or exception of
+         *            a JAVA method call
+         *
+         * @return the response XML(SOAP) message
+         */
+//      Packet serializeResponse(JavaCallInfo call);
+
+        /**
+         * Deserializes a response XML(SOAP) message to a JavaCallInfo instance
+         * representing the return value or exception of a JAVA method call.
+         *
+         * @param soap
+         *            the response message
+         *
+         * @param call
+         *            the JavaCallInfo instance to be updated
+         *
+         * @return the JavaCallInfo updated with the return value or exception of a
+         *         JAVA method call
+         */
+//      JavaCallInfo deserializeResponse(Packet res, JavaCallInfo call);
+
+        /**
+         * Gets the WSDL operation metadata of the specified JAVA method.
+         *
+         * @param method
+         *            the JAVA method
+         * @return the operationMetadata
+         */
+//      OperationMetadata getOperationMetadata(java.lang.reflect.Method method);
+
+        /**
+         * Gets the WebServiceFeatures of this webservice endpoint.
+         *
+         * @return the features
+         */
+//      WebServiceFeature[] getFeatures();
+
+        void generateWSDL(WSDLGenInfo info);
+
+        public ContentType encode( Packet packet, OutputStream out ) throws IOException ;
+
+        public void decode( InputStream in, String ct, Packet packet ) throws IOException;
+}