You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by ve...@apache.org on 2005/06/28 14:21:00 UTC
svn commit: r202164 [1/3] - in
/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax:
./ xml/ xml/rpc/ xml/rpc/encoding/ xml/rpc/handler/ xml/rpc/handler/soap/
xml/rpc/holders/ xml/rpc/security/ xml/rpc/server/ xml/rpc/soap/
Author: venkat
Date: Tue Jun 28 05:20:58 2005
New Revision: 202164
URL: http://svn.apache.org/viewcvs?rev=202164&view=rev
Log:
move sources into src folder.
Added:
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/AsyncHandler.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Binding.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/BindingProvider.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Call.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Dispatch.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCContext.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCException.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/LogicalMessage.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/NamespaceConstants.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ParameterMode.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ProtocolException.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Provider.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Response.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Service.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceException.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceFactory.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Stub.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/DeserializationContext.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/Deserializer.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/DeserializerFactory.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/SerializationContext.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/Serializer.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/SerializerFactory.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/TypeMapping.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/TypeMappingRegistry.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/encoding/XMLType.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/AbstractHandler.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/GenericHandler.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/Handler.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/HandlerChain.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/HandlerInfo.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/HandlerLifecycle.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/HandlerRegistry.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/LogicalHandler.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/LogicalMessageContext.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/MessageContext.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/handler/soap/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/BigDecimalHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/BigIntegerHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/BooleanHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/BooleanWrapperHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/ByteArrayHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/ByteHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/ByteWrapperHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/CalendarHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/DoubleHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/DoubleWrapperHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/FloatHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/FloatWrapperHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/GenericHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/Holder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/IntHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/IntegerWrapperHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/LongHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/LongWrapperHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/ObjectHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/QNameHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/ShortHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/ShortWrapperHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/holders/StringHolder.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/security/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/security/SecurityConfiguration.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/server/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/server/ServiceLifecycle.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/server/ServletEndpointContext.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/soap/
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/soap/SOAPBinding.java
webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/soap/SOAPFaultException.java
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/AsyncHandler.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/AsyncHandler.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/AsyncHandler.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/AsyncHandler.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,36 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Interface AsyncHandler<T>
+ * The javax.xml.rpc.AsyncHandler interface is implemented by clients that wish to receive callback notification of the completion of service endpoint operations invoked asynchronously.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public interface AsyncHandler<T> {
+
+ /**
+ * Method handleResponse
+ * Called when the response to an asynchronous operation is available.
+ *
+ * @param res - The response to the operation invocation.
+ */
+ void handleResponse(Response<T> res) ;
+
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Binding.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Binding.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Binding.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Binding.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,55 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+import java.util.List;
+import javax.xml.rpc.handler.HandlerInfo;
+import javax.xml.rpc.security.SecurityConfiguration;
+
+/**
+ * @author sunja07
+ */
+public interface Binding {
+
+ /**
+ * Method getHandlerChain
+ * Gets the handler chain for protocol binding instance. The returned List is used to configure the handler chain.
+ *
+ * @return java.util.List Handler chain
+ */
+ List<HandlerInfo> getHandlerChain();
+
+ /**
+ * Method setHandlerChain
+ * Sets the handler chain for the protocol binding instance.
+ *
+ * @param chain - A List of handler configuration entries
+ * @throws JAXRPCException - On an error in the configuration of the handler chain
+ java.lang.UnsupportedOperationException - If this operation is not supported. This may be done to avoid any overriding of a pre-configured handler chain.
+ */
+ void setHandlerChain(java.util.List<HandlerInfo> chain) throws JAXRPCException;
+
+ /**
+ * Method getSecurityConfiguration
+ * Gets the SecurityConfiguration for this Binding object.
+ *
+ * @return The SecurityConfiguration for this Binding object.
+ * @throws java.lang.UnsupportedOperationException - if the Binding class does not support the configuration of SecurityConfiguration.
+ */
+ SecurityConfiguration getSecurityConfiguration() throws java.lang.UnsupportedOperationException;
+
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/BindingProvider.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/BindingProvider.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/BindingProvider.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/BindingProvider.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,102 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Interface BindingProvider
+ * The javax.xml.rpc.BindingProvider interface provides access to the protocol binding and associated JAXRPCContext objects for request and response message processing.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public interface BindingProvider {
+
+ /**
+ * Standard property: Target service endpoint address. The URI scheme for
+ * the endpoint address specification must correspond to the
+ * protocol/transport binding for the binding in use.
+ */
+ static final java.lang.String ENDPOINT_ADDRESS_PROPERTY = "javax.xml.rpc.service.endpoint.address";
+
+ /**
+ * Standard property: This boolean property is used by a service client to
+ * indicate whether or not it wants to participate in a session with a
+ * service endpoint. If this property is set to true, the service client
+ * indicates that it wants the session to be maintained. If set to false,
+ * the session is not maintained. The default value for this property is
+ * false.
+ */
+ static final java.lang.String SESSION_MAINTAIN_PROPERTY = "javax.xml.rpc.session.maintain";
+
+ /**
+ * Standard property for SOAPAction. This boolean property indicates
+ * whether or not SOAPAction is to be used. The default value of this
+ * property is false indicating that the SOAPAction is not used.
+ */
+ static final java.lang.String SOAPACTION_USE_PROPERTY = "javax.xml.rpc.soap.http.soapaction.use";
+
+ /**
+ * Standard property for SOAPAction. Indicates the SOAPAction URI if the
+ * javax.xml.rpc.soap.http.soapaction.use property is set to true.
+ */
+ static final java.lang.String SOAPACTION_URI_PROPERTY = "javax.xml.rpc.soap.http.soapaction.uri";
+
+ /**
+ * Standard property: Password for authentication.
+ */
+ static final java.lang.String PASSWORD_PROPERTY = "javax.xml.rpc.security.auth.password";
+
+ /**
+ * Standard property: User name for authentication.
+ */
+ static final java.lang.String USERNAME_PROPERTY = "javax.xml.rpc.security.auth.username";
+
+ /**
+ * Standard property: JAXB context to use for marshalling arguments in
+ * dynamic APIs.
+ */
+ static final java.lang.String JAXB_CONTEXT_PROPERTY = "javax.xml.rpc.binding.context";
+
+ /**
+ * Method getRequestContext
+ * Get the JAXRPCContext that is used to initialize the message context
+ * for request messages. Modifications to the request context do not
+ * affect the message context of either synchronous or asynchronous
+ * operations that have already been started.
+ * @return The JAXRPCContext that is used in processing request messages.
+ */
+ JAXRPCContext getRequestContext();
+
+ /**
+ * Method getResponseContext
+ * Get the JAXRPCContext that resulted from processing a response message.
+ * The returned context is for the most recently completed synchronous
+ * operation. Subsequent synchronous operation invocations overwrite the
+ * response context. Asynchronous operations return their response context
+ * via the Response interface.
+ * @return The JAXRPCContext that resulted from processing the latest
+ * response messages.
+ */
+ JAXRPCContext getResponseContext();
+
+ /**
+ * Method getBinding
+ * Get the Binding for this binding provider.
+ * @return The Binding for this binding provider.
+ */
+ Binding getBinding();
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Call.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Call.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Call.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Call.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,284 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Interface Call
+ * The javax.xml.rpc.Call interface provides support for the dynamic invocation of a service endpoint. The javax.xml.rpc.Service interface acts as a factory for the creation of Call instances.
+ * Once a Call instance is created, various setter and getter methods may be used to configure this Call instance.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public interface Call extends BindingProvider{
+
+ /**
+ * Standard property for operation style. This property is set to "rpc"
+ * if the operation style is rpc; "document" if the operation style is
+ * document.
+ */
+ static final java.lang.String OPERATION_STYLE_PROPERTY = "javax.xml.rpc.soap.operation.style";
+
+ /**
+ * Standard property for encoding Style: Encoding style specified as a
+ * namespace URI. The default value is the SOAP 1.1 encoding
+ * http://schemas.xmlsoap.org/soap/encoding/
+ */
+ static final java.lang.String ENCODINGSTYLE_URI_PROPERTY = "javax.xml.rpc.encodingstyle.namespace.uri";
+
+ /**
+ * Method isParameterAndReturnSpecRequired
+ * Indicates whether addParameter and setReturnType methods are to be
+ * invoked to specify the parameter and return type specification for a
+ * specific operation.
+ * @param operationName Qualified name of the operation
+ * @return Returns true if the Call implementation class requires
+ * addParameter and setReturnType to be invoked in the client code for
+ * the specified operation. This method returns false otherwise.
+ * @throws java.lang.IllegalArgumentException - If invalid operation name
+ * is specified
+ */
+ boolean isParameterAndReturnSpecRequired(javax.xml.namespace.QName operationName) throws java.lang.IllegalArgumentException;
+
+ /**
+ * Method addParameter
+ * Adds a parameter type and mode for a specific operation. Note that the
+ * client code may not call any addParameter and setReturnType methods
+ * before calling the invoke method. In this case, the Call implementation
+ * class determines the parameter types by using reflection on parameters,
+ * using the WSDL description and configured type mapping registry.
+ * @param paramName Name of the parameter
+ * @param xmlType XML type of the parameter
+ * @param parameterMode Mode of the parameter-whether ParameterMode.IN,
+ * ParameterMode.OUT, or ParameterMode.INOUT
+ * @throws javax.xml.rpc.JAXRPCException This exception may be thrown if
+ * the method isParameterAndReturnSpecRequired returns false for this operation.
+ * @throws java.lang.IllegalArgumentException If any illegal parameter
+ * name or XML type is specified
+ */
+ void addParameter(java.lang.String paramName,
+ javax.xml.namespace.QName xmlType,
+ ParameterMode parameterMode) throws javax.xml.rpc.JAXRPCException,
+ java.lang.IllegalArgumentException;
+
+ /**
+ * Method addParameter
+ * Adds a parameter type and mode for a specific operation. This method is
+ * used to specify the Java type for either OUT or INOUT parameters.
+ * @param paramName Name of the parameter
+ * @param xmlType XML type of the parameter
+ * @param javaType Java class of the parameter
+ * @param parameterMode Mode of the parameter-whether ParameterMode.IN,
+ * OUT or INOUT
+ * @throws java.lang.IllegalArgumentException If any illegal parameter
+ * name or XML type is specified
+ * @throws java.lang.UnsupportedOperationException If this method is not
+ * supported
+ * @throws javax.xml.rpc.JAXRPCException
+ * 1.This exception may be thrown if this method is invoked when the method isParameterAndReturnSpecRequired returns false.
+ * 2.If specified XML type and Java type mapping is not valid. For example, TypeMappingRegistry has no serializers for this mapping.
+ */
+ void addParameter(java.lang.String paramName,
+ javax.xml.namespace.QName xmlType,
+ java.lang.Class javaType,
+ ParameterMode parameterMode) throws java.lang.IllegalArgumentException,
+ java.lang.UnsupportedOperationException, javax.xml.rpc.JAXRPCException;
+
+ /**
+ * Method getParameterTypeByName
+ * Gets the XML type of a parameter by name
+ * @param paramName Name of the parameter
+ * @return Returns XML type for the specified parameter
+ */
+ javax.xml.namespace.QName getParameterTypeByName(java.lang.String paramName);
+
+ /**
+ * Method setReturnType
+ * Sets the return type for a specific operation. Invoking
+ * setReturnType(null) removes the return type for this Call object.
+ * @param xmlType XML data type of the return value
+ * @throws javax.xml.rpc.JAXRPCException This exception may be thrown when
+ * the method isParameterAndReturnSpecRequired returns false.
+ * @throws java.lang.IllegalArgumentException If an illegal XML type is specified
+ */
+ void setReturnType(javax.xml.namespace.QName xmlType) throws javax.xml.rpc.JAXRPCException,
+ java.lang.IllegalArgumentException, java.lang.UnsupportedOperationException;
+
+ /**
+ * Method setReturnType
+ * Sets the return type for a specific operation.
+ * @param xmlType XML data type of the return value
+ * @param javaType Java Class of the return value
+ * @throws java.lang.UnsupportedOperationException If this method is not supported
+ * @throws java.lang.IllegalArgumentException If an illegal XML type is specified
+ * @throws javax.xml.rpc.JAXRPCException
+ * 1. This exception may be thrown if this method is invoked when the method isParameterAndReturnSpecRequired returns false.
+ * 2. If XML type and Java type cannot be mapped using the standard type mapping or TypeMapping registry
+ */
+ void setReturnType(javax.xml.namespace.QName xmlType,
+ java.lang.Class javaType) throws java.lang.UnsupportedOperationException,
+ java.lang.IllegalArgumentException,
+ javax.xml.rpc.JAXRPCException;
+
+ /**
+ * Method getReturnType
+ * Gets the return type for a specific operation
+ * @return Returns the XML type for the return value
+ */
+ javax.xml.namespace.QName getReturnType();
+
+ /**
+ * Method removeAllParameters
+ * Removes all specified parameters from this Call instance. Note that this method removes only the parameters and not the return type. The setReturnType(null) is used to remove the return type.
+ * @throws javax.xml.rpc.JAXRPCException This exception may be thrown If this method is called when the method isParameterAndReturnSpecRequired returns false for this Call's operation.
+ */
+ void removeAllParameters() throws javax.xml.rpc.JAXRPCException;
+
+ /**
+ * Method getOperationName
+ * Gets the name of the operation to be invoked using this Call instance.
+ * @return Qualified name of the operation
+ */
+ javax.xml.namespace.QName getOperationName();
+
+ /**
+ * Method setOperationName
+ * Sets the name of the operation to be invoked using this Call instance.
+ * @param operationName QName of the operation to be invoked using the Call instance
+ */
+ void setOperationName(javax.xml.namespace.QName operationName);
+
+ /**
+ * Method getPortTypeName
+ * Gets the qualified name of the port type.
+ * @return Qualified name of the port type
+ */
+ javax.xml.namespace.QName getPortTypeName();
+
+ /**
+ * Method setPortTypeName
+ * Sets the qualified name of the port type.
+ * @param portType Qualified name of the port type
+ */
+ void setPortTypeName(javax.xml.namespace.QName portType);
+
+ /**
+ * Method setTargetEndpointAddress
+ * Sets the address of the target service endpoint. This address must correspond to the transport specified in the binding for this Call instance.
+ * @param address Address of the target service endpoint; specified as an URI
+ */
+ void setTargetEndpointAddress(java.lang.String address);
+
+ /**
+ * Method getTargetEndpointAddress
+ * Gets the address of a target service endpoint.
+ * @return Address of the target service endpoint as an URI
+ */
+ java.lang.String getTargetEndpointAddress();
+
+ /**
+ * Method setProperty
+ * Sets the value for a named property. JAX-RPC specification specifies a standard set of properties that may be passed to the Call.setProperty method.
+ * @param name Name of the property
+ * @param value Value of the property
+ * @throws javax.xml.rpc.JAXRPCException
+ * 1. If an optional standard property name is specified, however this Call implementation class does not support the configuration of this property.
+ * 2. If an invalid (or unsupported) property name is specified or if a value of mismatched property type is passed.
+ * 3. If there is any error in the configuration of a valid property.
+ */
+ void setProperty(java.lang.String name,
+ java.lang.Object value) throws javax.xml.rpc.JAXRPCException;
+
+ /**
+ * Method getProperty
+ * Gets the value of a named property.
+ * @param name Name of the property
+ * @return Value of the named property
+ * @throws javax.xml.rpc.JAXRPCException if an invalid or unsupported property name is passed.
+ */
+ java.lang.Object getProperty(java.lang.String name);
+
+ /**
+ * Method removeProperty
+ * Removes a named property.
+ * @param name Name of the property
+ * @throws javax.xml.rpc.JAXRPCException if an invalid or unsupported property name is passed.
+ */
+ void removeProperty(java.lang.String name);
+
+ /**
+ * Method getPropertyNames
+ * Gets the names of configurable properties supported by this Call object.
+ * @return Iterator for the property names
+ */
+ java.util.Iterator getPropertyNames();
+
+ /**
+ * Method invoke
+ * Invokes a specific operation using a synchronous request-response interaction mode.
+ * @param inputParams Object[]--Parameters for this invocation. This includes only the input params
+ * @return Returns the return value or null
+ * @throws java.rmi.RemoteException if there is any error in the remote method invocation
+ * @throws javax.xml.rpc.soap.SOAPFaultException Indicates a SOAP fault
+ * @throws javax.xml.rpc.JAXRPCException
+ * 1. If there is an error in the configuration of the Call object
+ * 2. If inputParams do not match the required parameter set (as specified through the addParameter invocations or in the corresponding WSDL)
+ * 3. If parameters and return type are incorrectly specified
+ */
+ java.lang.Object invoke(java.lang.Object[] inputParams)
+ throws java.rmi.RemoteException, javax.xml.rpc.soap.SOAPFaultException, javax.xml.rpc.JAXRPCException;
+
+ /**
+ * Method invoke
+ * Invokes a specific operation using a synchronous request-response interaction mode.
+ * @param operationName QName of the operation
+ * @param inputParams Object[]--Parameters for this invocation. This includes only the input params.
+ * @return Returns the return value or null
+ * @throws java.rmi.RemoteException if there is any error in the remote method invocation
+ * @throws javax.xml.rpc.soap.SOAPFaultException Indicates a SOAP fault
+ * @throws javax.xml.rpc.JAXRPCException
+ * 1. If there is an error in the configuration of the Call object
+ * 2. If inputParams do not match the required parameter set (as specified through the addParameter invocations or in the corresponding WSDL)
+ * 3. If parameters and return type are incorrectly specified
+ */
+ java.lang.Object invoke(javax.xml.namespace.QName operationName,
+ java.lang.Object[] inputParams)
+ throws java.rmi.RemoteException;
+
+ /**
+ * Method invokeOneWay
+ * @param inputParams Object[]--Parameters for this invocation. This includes only the input params.
+ * @throws javax.xml.rpc.JAXRPCException if there is an error in the configuration of the Call object (example: a non-void return type has been incorrectly specified for the one-way call) or if there is any error during the invocation of the one-way remote call
+ */
+ void invokeOneWay(java.lang.Object[] inputParams) throws javax.xml.rpc.JAXRPCException;
+
+ /**
+ * Method getOutputParams
+ * Returns a Map of {name, value} for the output parameters of the last invoked operation. The parameter names in the returned Map are of type java.lang.String.
+ * @return Map Output parameters for the last Call.invoke(). Empty Map is returned if there are no output parameters.
+ * @throws JAXRPCException If this method is invoked for a one-way operation or is invoked before any invoke method has been called.
+ */
+ java.util.Map getOutputParams() throws JAXRPCException;
+
+ /**
+ * Method getOutputValues
+ * Returns a List values for the output parameters of the last invoked operation.
+ * @return java.util.List Values for the output parameters. An empty List is returned if there are no output values.
+ * @throws JAXRPCException If this method is invoked for a one-way operation or is invoked before any invoke method has been called.
+ */
+ java.util.List getOutputValues() throws JAXRPCException;
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Dispatch.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Dispatch.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Dispatch.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Dispatch.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,70 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Interface Dispatch<T>
+ * The javax.xml.rpc.Dispatch interface provides support for the dynamic invocation of a service endpoint operations. The javax.xml.rpc.Service interface acts as a factory for the creation of Dispatch instances.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public interface Dispatch<T> {
+
+ /**
+ * Method invoke
+ * Invoke a service operation synchronously. The client is responsible for ensuring that the msg object when marshalled is formed according to the requirements of the protocol binding in use.
+ *
+ * @param msg - An object that will form the message or payload of the message used to invoke the operation.
+ * @return The response message or message payload to the operation invocation.
+ * @throws java.rmi.RemoteException - If a fault occurs during communication with the service
+ * @throws JAXRPCException - If there is any error in the configuration of the Dispatch instance.
+ */
+ T invoke(T msg) throws java.rmi.RemoteException;
+
+ /**
+ * Method invokeAsync
+ * Invoke a service operation asynchronously. The method returns without waiting for the response to the operation invocation, the results of the operation are obtained by polling the returned Response. The client is responsible for ensuring that the msg object when marshalled is formed according to the requirements of the protocol binding in use.
+ *
+ * @param msg - An object that will form the message or payload of the message used to invoke the operation.
+ * @return The response message or message payload to the operation invocation.
+ * @throws JAXRPCException - If there is any error in the configuration of the Dispatch instance.
+ */
+ Response<T> invokeAsync(T msg) throws JAXRPCException;
+
+ /**
+ * Method invokeAsync
+ * Invoke a service operation asynchronously. The method returns without waiting for the response to the operation invocation, the results of the operation are communicated to the client via the passed in handler. The client is responsible for ensuring that the msg object when marshalled is formed according to the requirements of the protocol binding in use.
+ *
+ * @param msg - An object that will form the message or payload of the message used to invoke the operation.
+ * @param handler - The handler object that will receive the response to the operation invocation.
+ * @return A Future object that may be used to check the status of the operation invocation. This object must not be used to try to obtain the results of the operation - the object returned from Future.get() is implementation dependent and any use of it will result in non-portable behaviour.
+ * @throws JAXRPCException - If there is any error in the configuration of the Dispatch instance
+ */
+ java.util.concurrent.Future<?> invokeAsync(T msg,
+ AsyncHandler<T> handler) throws JAXRPCException;
+
+ /**
+ * Method invokeOneWay
+ * Invokes a service operation using the one-way interaction mode. The operation invocation is logically non-blocking, subject to the capabilities of the underlying protocol, no results are returned. When the protocol in use is SOAP/HTTP, this method must block until an HTTP response code has been received or an error occurs. The client is responsible for ensuring that the msg object when marshalled is formed according to the requirements of the protocol binding in use.
+ *
+ * @param msg - An object that will form the message or payload of the message used to invoke the operation.
+ * @throws JAXRPCException - If there is any error in the configuration of the Dispatch instance or if an error occurs during the invocation.
+ */
+ void invokeOneWay(T msg) throws JAXRPCException;
+
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCContext.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCContext.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCContext.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCContext.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,96 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Interface JAXRPCContext
+ * The JAXRPCContext interface provides an extensible property mechanism that may be used to configure BindingProvider instances and to pass imformation between applications and handlers.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public interface JAXRPCContext {
+ /**
+ * Standard property: Map of attachments to a message, key is the MIME Content-ID, value is a DataHandler.
+ * Type: java.util.Map
+ */
+ static final java.lang.String MESSAGE_ATTACHMENTS = "javx.xml.rpc.binding.attachments";
+
+ /**
+ * Standard property: input source for WSDL document.
+ * Type: org.xml.sax.InputSource
+ */
+ static final java.lang.String WSDL_DESCRIPTION = "javax.xml.rpc.wsdl.description";
+
+ /**
+ * Standard property: name of WSDL service.
+ * Type: javax.xml.namespace.QName
+ */
+ static final java.lang.String WSDL_SERVICE = "javax.xml.rpc.wsdl.service";
+
+ /**
+ * Standard property: name of WSDL port.
+ * Type: javax.xml.namespace.QName
+ */
+ static final java.lang.String WSDL_PORT = "javax.xml.rpc.wsdl.port";
+
+ /**
+ * Standard property: name of wsdl interface (2.0) or port type (1.1).
+ * Type: javax.xml.namespace.QName
+ */
+ static final java.lang.String WSDL_INTERFACE = "javax.xml.rpc.wsdl.interface";
+
+ /**
+ * Standard property: name of WSDL operation.
+ * Type: javax.xml.namespace.QName
+ */
+ static final java.lang.String WSDL_OPERATION = "javax.xml.rpc.wsdl.operation";
+
+ /**
+ * Method setProperty
+ * Sets the name and value of a property associated with the context. If the context contains a value of the same property, the old value is replaced.
+ * @param name Name of the property associated with the context
+ * @param value Value of the property
+ * @throws java.lang.IllegalArgumentException If some aspect of the property is prevents it from being stored in the context
+ */
+ void setProperty(java.lang.String name,
+ java.lang.Object value) throws java.lang.IllegalArgumentException;
+
+ /**
+ * Method removeProperty
+ * Removes a property (name-value pair) from the context
+ * @param name Name of the property to be removed
+ * @throws java.lang.IllegalArgumentException if an illegal property name is specified
+ */
+ void removeProperty(java.lang.String name) throws java.lang.IllegalArgumentException;
+
+ /**
+ * Method getProperty
+ * Gets the value of a specific property from the MessageContext
+ * @param name Name of the property whose value is to be retrieved
+ * @return Value of the property
+ * @throws java.lang.IllegalArgumentException if an illegal property name is specified
+ */
+ java.lang.Object getProperty(java.lang.String name) throws java.lang.IllegalArgumentException;
+
+ /**
+ * Method getPropertyNames
+ * Returns an Iterator view of the names of the properties in this context
+ * @return Iterator for the property names
+ */
+ java.util.Iterator getPropertyNames();
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCException.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCException.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCException.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCException.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,77 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * class JAXRPCException
+ * The javax.xml.rpc.JAXRPCException is thrown from the core JAX-RPC APIs to indicate an exception related to the JAX-RPC runtime mechanisms.
+ *
+ * @version 1.1
+ * @author sunja07
+ */
+public class JAXRPCException extends RuntimeException implements java.io.Serializable {
+
+ /**
+ * Empty Constructor
+ * Constructs a new exception with null as its detail message.
+ */
+ public JAXRPCException() {
+ super();
+ }
+
+ /**
+ * Constructor
+ * Constructs a new exception with the specified detail message.
+ * @param message - The detail message which is later retrieved using the getMessage method
+ */
+ public JAXRPCException(java.lang.String message) {
+ super(message);
+ }
+
+ /**
+ * Constructor
+ * Constructs a new exception with the specified detail message and cause.
+ * @param message - The detail message which is later retrieved using the getMessage method
+ * @param cause - The cause which is saved for the later retrieval throw by the getCause method
+ */
+ public JAXRPCException(java.lang.String message,
+ java.lang.Throwable cause) {
+ super(message, cause);
+ }
+
+ /**
+ * Constructor
+ * Constructs a new JAXRPCException with the specified cause and a detail
+ * message of (cause==null ? null : cause.toString()) (which typically
+ * contains the class and detail message of cause).
+ * @param cause - The cause which is saved for the later retrieval throw by the getCause method. (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
+ */
+ public JAXRPCException(java.lang.Throwable cause){
+ super(cause==null ? null : cause.toString(),cause);
+ }
+
+ /**
+ * Method getLinkedCause
+ * Gets the Linked cause
+ * @deprecated Retained for backwards compatility, new applications should
+ * use the standard cause mechanism.
+ * @return The cause of this Exception or null if the cause is noexistent or unknown
+ */
+ public java.lang.Throwable getLinkedCause() {
+ return getCause();
+ }
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/LogicalMessage.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/LogicalMessage.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/LogicalMessage.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/LogicalMessage.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,64 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Interface LogicalMessage
+ * The LogicalMessage interface represents a protocol agnostic XML message
+ * and contains methods that provide access to the payload of the message.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public interface LogicalMessage {
+
+ /**
+ * Method getPayload
+ * Gets the message payload as an XML source, may be called multiple times on the same LogicalMessage instance, always returns a new Source that may be used to retrieve the entire message payload.
+ * If the returned Source is an instance of DOMSource, then modifications to the encapsulated DOM tree change the message payload in-place, there is no need to susequently call setPayload. Other types of Source provide only read access to the message payload.
+ * @return The contained message payload; returns null if no payload is present in this message.
+ */
+ javax.xml.transform.Source getPayload();
+
+ /**
+ * Method getPayload
+ * Gets the message payload as a JAXB object. Note that there is no connection between the returned object and the message payload, changes to the payload require calling setPayload.
+ * @param context The JAXBContext that should be used to unmarshall the message payload
+ * @return The contained message payload; returns null if no payload is present in this message
+ * @throws JAXRPCException If an error occurs when using a supplied JAXBContext to unmarshall the payload. The cause of the JAXRPCException is the original JAXBException.
+ */
+ java.lang.Object getPayload(javax.xml.bind.JAXBContext context) throws JAXRPCException;
+
+ /**
+ * Method setPayload
+ * Sets the message payload
+ * @param payload message payload
+ * @throws JAXRPCException If any error during the setting of the payload in this message java.lang.UnsupportedOperationException - If this operation is not supported.
+ */
+ void setPayload(javax.xml.transform.Source payload) throws JAXRPCException;
+
+ /**
+ * Method setPayload
+ * Sets the message payload
+ * @param payload message payload
+ * @param context The JAXBContext that should be used to marshall the payload
+ * @throws java.lang.UnsupportedOperationException If this operation is not supported
+ * @throws JAXRPCException If an error occurs when using the supplied JAXBContext to marshall the payload. The cause of the JAXRPCException is the original JAXBException.
+ */
+ void setPayload(java.lang.Object payload,
+ javax.xml.bind.JAXBContext context) throws JAXRPCException;
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/NamespaceConstants.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/NamespaceConstants.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/NamespaceConstants.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/NamespaceConstants.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,77 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Class NamespaceConstants
+ * Constants used in JAX-RPC for namespace prefixes and URIs
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public class NamespaceConstants {
+
+ /**
+ * Namespace prefix for SOAP Envelope
+ */
+ public static final java.lang.String NSPREFIX_SOAP_ENVELOPE = "soapenv";
+
+ /**
+ * Namespace prefix for SOAP Encoding
+ */
+ public static final java.lang.String NSPREFIX_SOAP_ENCODING = "soapenc";
+
+ /**
+ * Namespace prefix for XML Schema XSD
+ */
+ public static final java.lang.String NSPREFIX_SCHEMA_XSD = "xsd";
+
+ /**
+ * Namespace prefix for XML Schema XSI
+ */
+ public static final java.lang.String NSPREFIX_SCHEMA_XSI = "xsi";
+
+ /**
+ * Nameapace URI for SOAP 1.1 Envelope
+ */
+ public static final java.lang.String NSURI_SOAP_ENVELOPE = "http://schemas.xmlsoap.org/soap/envelope/";
+
+ /**
+ * Nameapace URI for SOAP 1.1 Encoding
+ */
+ public static final java.lang.String NSURI_SOAP_ENCODING = "http://schemas.xmlsoap.org/soap/encoding/";
+
+ /**
+ * Nameapace URI for SOAP 1.1 next actor role
+ */
+ public static final java.lang.String NSURI_SOAP_NEXT_ACTOR = "http://schemas.xmlsoap.org/soap/actor/next";
+
+ /**
+ * Namespace URI for XML Schema XSD
+ */
+ public static final java.lang.String NSURI_SCHEMA_XSD = "http://www.w3.org/2001/XMLSchema";
+
+ /**
+ * Namespace URI for XML Schema XSI
+ */
+ public static final java.lang.String NSURI_SCHEMA_XSI = "http://www.w3.org/2001/XMLSchema-instance";
+
+ /**
+ * Empty Constructor
+ */
+ public NamespaceConstants() {}
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ParameterMode.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ParameterMode.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ParameterMode.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ParameterMode.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,53 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Class ParameterMode
+ * The javax.xml.rpc.ParameterMode is a type-safe enumeration for parameter mode. This class is used in the CallAPI to specify parameter passing modes.
+ *
+ * @version 1.0
+ * @author sunja07
+ * @see Call
+ */
+public class ParameterMode {
+
+ /**
+ * IN mode for parameter passing
+ */
+ public static final ParameterMode IN = null;
+
+ /**
+ * OUT mode for parameter passing
+ */
+ public static final ParameterMode OUT = null;
+
+ /**
+ * INOUT mode for parameter passing
+ */
+ public static final ParameterMode INOUT = null;
+
+ /**
+ * Method toString
+ * Returns a String describing this ParameterMode object.
+ * @overrides <code>toString</code> in class <code>java.lang.Object</code>
+ * @return A string representation of the object.
+ */
+ public java.lang.String toString() {
+ return null;
+ }
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ProtocolException.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ProtocolException.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ProtocolException.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ProtocolException.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,70 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+import java.io.Serializable;
+
+/**
+ * Class ProtocolException
+ * The javax.xml.rpc.ProtocolException interface is a marker base class for exceptions related to a specific protocol binding. Subclasses are used to communicate protocol level fault information to clients and may be used on the server to control the protocol specific fault representation.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public class ProtocolException extends RuntimeException implements Serializable {
+
+ /**
+ * Empty Constructor
+ * Constructs a new protocol exception with null as its detail message.
+ */
+ public ProtocolException() {
+ super();
+ }
+
+ /**
+ * Constructor
+ * Constructs a new protocol exception with the specified detail message.
+ * @param message - the detail message. The detail message is saved for later retrieval by the Throwable.getMessage() method.
+ */
+ public ProtocolException(java.lang.String message) {
+ super(message);
+ }
+
+ /**
+ * Constructor
+ * Constructs a new runtime exception with the specified detail message and
+ * cause.
+ * @param message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
+ * @param cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
+ */
+ public ProtocolException(java.lang.String message,
+ java.lang.Throwable cause) {
+ super(message, cause);
+ }
+
+ /**
+ * Constructor
+ * Constructs a new runtime exception with the specified cause and a detail
+ * message of (cause==null ? null : cause.toString()) (which typically
+ * contains the class and detail message of cause).
+ * @param cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
+ */
+ public ProtocolException(java.lang.Throwable cause) {
+ super(cause==null ? null : cause.toString(), cause);
+ }
+
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Provider.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Provider.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Provider.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Provider.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,40 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Interface Provider<T>
+ * Service endpoints may implement the Provider interface as a dynamic alternative to an SEI. Implementations are required to support Provider<Source> and Provider<SOAPMessage>. The ServiceMode annotation can be used to control whether the Provider instance will receive entire protocol messages or just message payloads.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public interface Provider<T> {
+
+ /**
+ * Method invoke
+ * Invokes an operation occording to the contents of the request message.
+ *
+ * @param request - The request message or message payload.
+ * @param context - The context of the request message. This provides access to the properties of the underlying handler MessageContext that have a scope of APPLICATION. The content of the context may be modified and will be reused as the context for any response message.
+ * @return The response message or message payload. May be null if there is no response.
+ * @throws java.rmi.RemoteException - if there is an error processing request. The cause of the RemoteException may be set to a subclass of ProtocolException to control the protocol level representation of the exception.
+ */
+ T invoke(T request, JAXRPCContext context)
+ throws java.rmi.RemoteException;
+
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Response.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Response.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Response.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Response.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,36 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+import java.util.concurrent.Future;
+
+//TODO: Needs a revisit, b'coz generics are involved.
+/**
+ * Interface Response<T>
+ *
+ * @author sunja07
+ */
+public interface Response<T> extends Future<T> {
+
+ /**
+ * Method getContext
+ * Gets the contained response context.
+ *
+ * @return The contained response context. May be null if a response is not yet available.
+ */
+ JAXRPCContext getContext();
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Service.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Service.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Service.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Service.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,249 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+import javax.xml.rpc.encoding.TypeMappingRegistry;
+import javax.xml.rpc.security.SecurityConfiguration;
+import javax.xml.rpc.handler.HandlerRegistry;
+
+/**
+ * Interface Service
+ * Service acts as a factory of the following:
+ * 1. Instance of javax.xml.rpc.Dispatch for dynamic message-oriented invocation of a remote operation.
+ * 2. Instance of javax.xml.rpc.Call for the dynamic invocation of a remote operation on the target service endpoint.
+ * 3. Instance of a generated stub class.
+ * 4. Dynamic proxy for the target service endpoint.
+ *
+ * @version 2.0
+ * @author sunja07
+ */
+public interface Service {
+
+ /**
+ * I've tried to create a nested class in here. Absolutely
+ * needs a revisit. Don't rely on this as it exists now.
+ */
+ public static enum Mode { //extends java.lang.Enum<Service.Mode> {
+
+ MESSAGE,
+
+ PAYLOAD;
+
+ /**
+ * Method values
+ * Returns an array containing the constants of this enum type, in the order they're declared. This method may be used to iterate over the constants as follows:
+ * <code>
+ * for(Service.Mode c : Service.Mode.values())
+ * System.out.println(c);
+ * </code>
+ * @return
+ */
+/* public static final Mode[] values() {
+ return null;
+ }
+*/
+ /**
+ * Method valueOf
+ * Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
+ * @param name the name of the enum constant to be returned.
+ * @return the enum constant with the specified name
+ * @throws java.lang.IllegalArgumentException if this enum type has no constant with the specified name
+ */
+/* public static Service.Mode valueOf(java.lang.String name) throws java.lang.IllegalArgumentException {
+ return null;
+ }
+*/
+ }
+
+ /**
+ * Method getPort
+ * The getPort method returns either an instance of a generated stub implementation class or a dynamic proxy. A service client uses this dynamic proxy to invoke operations on the target service endpoint. The serviceEndpointInterface specifies the service endpoint interface that is supported by the created dynamic proxy or stub instance.
+ * @param portName Qualified name of the service endpoint in the WSDL service description
+ * @param serviceEndpointInterface Service endpoint interface supported by the dynamic proxy or stub instance
+ * @return java.rmi.Remote Stub instance or dynamic proxy that supports the specified service endpoint interface
+ * @throws ServiceException This exception is thrown in the following cases:
+ * 1. If there is an error in creation of the dynamic proxy or stub instance
+ * 2. If there is any missing WSDL metadata as required by this method
+ * 3. Optionally, if an illegal serviceEndpointInterface or portName is specified
+ * @see java.lang.reflect.Proxy, java.lang.reflect.InvocationHandler
+ */
+ java.rmi.Remote getPort(javax.xml.namespace.QName portName,
+ java.lang.Class serviceEndpointInterface)
+ throws ServiceException;
+
+ /**
+ * Method getPort
+ * The getPort method returns either an instance of a generated stub implementation class or a dynamic proxy. The parameter serviceEndpointInterface specifies the service endpoint interface that is supported by the returned stub or proxy. In the implementation of this method, the JAX-RPC runtime system takes the responsibility of selecting a protocol binding (and a port) and configuring the stub accordingly. The returned Stub instance should not be reconfigured by the client.
+ * @param serviceEndpointInterface Service endpoint interface
+ * @return Stub instance or dynamic proxy that supports the specified service endpoint interface
+ * @throws ServiceException This exception is thrown in the following cases:
+ * 1. If there is an error during creation of stub instance or dynamic proxy
+ * 2. If there is any missing WSDL metadata as required by this method
+ * 3. Optionally, if an illegal serviceEndpointInterface is specified
+ */
+ java.rmi.Remote getPort(java.lang.Class serviceEndpointInterface)
+ throws ServiceException;
+
+ /**
+ * Method createPort
+ * Creates a new port for the service. Ports created in this way contain no WSDL port type information and can only be used for creating Dispatch and Call instances.
+ * @param portName Qualified name for the target service endpoint
+ * @param bindingId A URI identifier of a binding.
+ * @param endpointAddress Address of the target service endpoint as a URI
+ * @throws ServiceException If any error in the creation of the port
+ * @see javax.xml.rpc.soap.SOAPBinding.SOAP11HTTP_BINDING
+ */
+ void createPort(javax.xml.namespace.QName portName,
+ java.net.URI bindingId,
+ java.lang.String endpointAddress)
+ throws ServiceException;
+
+ // This involves generics, needs a revisit
+ /**
+ * Method createDispatch
+ * Creates a Dispatch instance for use with objects of the users choosing.
+ *
+ * @param - Qualified name for the target service endpoint
+ * @param - The class of object used to messages or message payloads. Implementations are required to support javax.xml.transform.Source and javax.xml.soap.SOAPMessage.
+ * @param - Controls whether the created dispatch instance is message or payload oriented, i.e. whether the user will work with complete protocol messages or message payloads. E.g. when using the SOAP protocol, this parameter controls whether the user will work with SOAP messages or the contents of a SOAP body. Mode must be MESSAGE when type is SOAPMessage.
+ * @return Dispatch instance
+ * @throws ServiceException - If any error in the creation of the Dispatch object
+ * @see javax.xml.transform.Source, javax.xml.soap.SOAPMessage
+ */
+ <T> Dispatch<T> createDispatch(javax.xml.namespace.QName portName,
+ java.lang.Class<T> type,
+ Service.Mode mode)
+ throws ServiceException;
+
+ // This involves generics, needs a revisit
+ /**
+ * Method createDispatch
+ * Creates a Dispatch instance for use with JAXB generated objects.
+ *
+ * @param portName - Qualified name for the target service endpoint
+ * @param context - The JAXB context used to marshall and unmarshall messages or message payloads.
+ * @param mode - Controls whether the created dispatch instance is message or payload oriented, i.e. whether the user will work with complete protocol messages or message payloads. E.g. when using the SOAP protocol, this parameter controls whether the user will work with SOAP messages or the contents of a SOAP body.
+ * @return Dispatch instance
+ * @throws ServiceException - If any error in the creation of the Dispatch object
+ * @see JAXBContext
+ */
+ Dispatch<java.lang.Object> createDispatch(javax.xml.namespace.QName portName,
+ javax.xml.bind.JAXBContext context,
+ Service.Mode mode)
+ throws ServiceException;
+
+ /**
+ * Method getCalls
+ * Gets an array of preconfigured Call objects for invoking operations on the specified port. There is one Call object per operation that can be invoked on the specified port. Each Call object is pre-configured and does not need to be configured using the setter methods on Call interface.
+ * Each invocation of the getCalls method returns a new array of preconfigured Call objects
+ * This method requires the Service implementation class to have access to the WSDL related metadata.
+ * @param portName Qualified name for the target service endpoint
+ * @return Call[] Array of pre-configured Call objects
+ * @throws ServiceException If this Service class does not have access to the required WSDL metadata or if an illegal portName is specified.
+ */
+ Call[] getCalls(javax.xml.namespace.QName portName)
+ throws ServiceException;
+
+ /**
+ * Method createCall
+ * Creates a Call instance.
+ * @param portName Qualified name for the target service endpoint
+ * @return Call instance
+ * @throws ServiceException If any error in the creation of the Call object
+ */
+ Call createCall(javax.xml.namespace.QName portName)
+ throws ServiceException;
+
+ /**
+ * Method createCall
+ * Creates a Call instance.
+ * @param portName Qualified name for the target service endpoint
+ * @param operationName Qualified Name of the operation for which this Call object is to be created.
+ * @return Call instance
+ * @throws ServiceException If any error in the creation of the Call object
+ */
+ Call createCall(javax.xml.namespace.QName portName,
+ javax.xml.namespace.QName operationName)
+ throws ServiceException;
+
+ /**
+ * Method createCall
+ * Creates a Call instance.
+ * @param portName Qualified name for the target service endpoint
+ * @param operationName Name of the operation for which this Call object is to be created.
+ * @return Call instance
+ * @throws ServiceException If any error in the creation of the Call object
+ */
+ Call createCall(javax.xml.namespace.QName portName,
+ java.lang.String operationName)
+ throws ServiceException;
+
+ /**
+ * Method createCall
+ * Creates a Call object not associated with specific operation or target service endpoint. This Call object needs to be configured using the setter methods on the Call interface.
+ * @return Call object
+ * @throws ServiceException If any error in the creation of the Call object
+ */
+ Call createCall() throws ServiceException;
+
+ /**
+ * Method getServiceName
+ * Gets the name of this service.
+ * @return Qualified name of this service
+ */
+ javax.xml.namespace.QName getServiceName();
+
+ /**
+ * Method getPorts
+ * Returns an Iterator for the list of QNames of service endpoints grouped by this service
+ * @return Returns java.util.Iterator with elements of type javax.xml.namespace.QName
+ * @throws ServiceException If this Service class does not have access to the required WSDL metadata
+ */
+ java.util.Iterator getPorts() throws ServiceException;
+
+ /**
+ * Method getWSDLDocumentLocation
+ * Gets the location of the WSDL document for this Service.
+ * @return URL for the location of the WSDL document for this service
+ */
+ java.net.URL getWSDLDocumentLocation();
+
+ /**
+ * Method getTypeMappingRegistry
+ * Gets the TypeMappingRegistry for this Service object. The returned TypeMappingRegistry instance is pre-configured to support the standard type mapping between XML and Java types types as required by the JAX-RPC specification.
+ * @return The TypeMappingRegistry for this Service object.
+ * @throws java.lang.UnsupportedOperationException if the Service class does not support the configuration of TypeMappingRegistry.
+ */
+ TypeMappingRegistry getTypeMappingRegistry() throws java.lang.UnsupportedOperationException;
+
+ /**
+ * Method getSecurityConfiguration
+ * Gets the SecurityConfiguration for this Service object. The returned SecurityConfiguration instance is used to initialize the security configuration of BindingProvider instance created using this Service object.
+ * @return The SecurityConfiguration for this Service object.
+ * @throws java.lang.UnsupportedOperationException if the Service class does not support the configuration of SecurityConfiguration.
+ */
+ SecurityConfiguration getSecurityConfiguration() throws java.lang.UnsupportedOperationException;
+
+ /**
+ * Method getHandlerRegistry
+ * Returns the configured HandlerRegistry instance for this Service instance.
+ * @return HandlerRegistry
+ * @throws java.lang.UnsupportedOperationException if the Service class does not support the configuration of a HandlerRegistry
+ */
+ HandlerRegistry getHandlerRegistry() throws java.lang.UnsupportedOperationException;
+
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceException.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceException.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceException.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceException.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,77 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+import java.io.Serializable;
+
+/**
+ * Class ServiceException
+ * The javax.xml.rpc.ServiceException is thrown from the methods in the javax.xml.rpc.Service interface and ServiceFactory class.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public class ServiceException extends Exception implements Serializable {
+
+ /**
+ * Empty Constructor
+ * Constructs a new exception with null as its detail message.
+ */
+ public ServiceException() {
+ super();
+ }
+
+ /**
+ * Constructor
+ * Constructs a new exception with the specified detail message.
+ * @param message - The detail message which is later retrieved using the getMessage method
+ */
+ public ServiceException(java.lang.String message) {
+ super(message);
+ }
+
+ /**
+ * Constructor
+ * Constructs a new exception with the specified detail message and cause.
+ * @param message - The detail message which is later retrieved using the getMessage method
+ * @param cause - The cause which is saved for the later retrieval throw by the getCause method
+ */
+ public ServiceException(java.lang.String message,
+ java.lang.Throwable cause) {
+ super(message, cause);
+ }
+
+ /**
+ * Constructor
+ * Constructs a new exception with the specified cause and a detail message
+ * of (cause==null ? null : cause.toString()) (which typically contains
+ * the class and detail message of cause).
+ * @param cause - The cause which is saved for the later retrieval throw by the getCause method. (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
+ */
+ public ServiceException(java.lang.Throwable cause) {
+ super(cause==null ? null : cause.toString(), cause);
+ }
+
+ /**
+ * Method getLinkedCause
+ * Gets the Linked cause
+ * @return The cause of this Exception or null if the cause is noexistent or unknown
+ */
+ public java.lang.Throwable getLinkedCause() {
+ return getCause();
+ }
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceFactory.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceFactory.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceFactory.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceFactory.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,124 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Class ServiceFactory
+ * The javax.xml.rpc.ServiceFactory is an abstract class that provides a factory for the creation of instances of the type javax.xml.rpc.Service. This abstract class follows the abstract static factory design pattern. This enables a J2SE based client to create a Service instance in a portable manner without using the constructor of the Service implementation class.
+ * The ServiceFactory implementation class is set using the system property SERVICEFACTORY_PROPERTY.
+ *
+ * @version 1.1
+ * @author sunja07
+ */
+public abstract class ServiceFactory {
+
+ /**
+ * A constant representing the property used to lookup the name of a ServiceFactory implementation class.
+ */
+ public static final java.lang.String SERVICEFACTORY_PROPERTY = "javax.xml.rpc.ServiceFactory";
+
+ private static ServiceFactory serviceFactoryImpl = null;
+
+ /**
+ * Empty constructor
+ */
+ protected ServiceFactory() {}
+
+ /**
+ * Gets an instance of the ServiceFactory
+ * Only one copy of a factory exists and is returned to the application each time this method is called.
+ * The implementation class to be used can be overridden by setting the javax.xml.rpc.ServiceFactory system property.
+ * @return static instance of ServiceFactory
+ * @throws ServiceException
+ */
+ public static ServiceFactory newInstance() throws ServiceException {
+
+ if (serviceFactoryImpl != null)
+ return serviceFactoryImpl;
+
+ //<TBR>: Comment to be removed
+ //I must be returning the implementation class set using the property
+ //SERVICEFACTORY_PROPERTY. This class will be set at the
+ //configuration time(?), using configuration data viz. system props
+ //or XML/properites config files or user and system preference data
+ //</TBR>
+ try {
+ String serviceFactoryImplName;
+ //<TBR>: Comment to be removed
+ // Here actually initialization of the name with the corresponding
+ // hashmap entry value of SERVICEFACTORY_PROPERTY key should happen
+ // Since we didn't finalize the hash map for config information
+ // we will use the default impl class
+ //</TBR>
+ serviceFactoryImplName = "org.apache.axis.jaxrpc.ServiceFactoryImpl";
+ Class loadedClass;
+
+ loadedClass = Thread.currentThread().getContextClassLoader().loadClass(serviceFactoryImplName);
+ serviceFactoryImpl = (ServiceFactory)loadedClass.newInstance();
+ } catch (Exception e) {
+ throw new ServiceException(e);
+ }
+ return serviceFactoryImpl;
+ }
+
+ /**
+ * Method createService
+ * Create a Service instance.
+ * @param wsdlDocumentLocation URL for the WSDL document location for the service
+ * @param serviceName QName for the service.
+ * @return a <code>Service</code> instance
+ * @throws ServiceException
+ */
+ public abstract Service createService(java.net.URL wsdlDocumentLocation,
+ javax.xml.namespace.QName serviceName) throws ServiceException;
+
+ /**
+ * Method loadService
+ * Create an instance of the generated service implementation class for a given service interface, if available.
+ * @param serviceInterface Service interface
+ * @return ??? read the spec once again
+ * @throws ServiceException If there is any error while creating the specified service, including the case where a generated service implementation class cannot be located
+ */
+ public abstract Service loadService(java.lang.Class serviceInterface)
+ throws ServiceException;
+
+ /**
+ * Method loadService
+ * Create an instance of the generated service implementation class for a given service interface, if available. An implementation may use the provided wsdlDocumentLocation and properties to help locate the generated implementation class. If no such class is present, a ServiceException will be thrown.
+ * @param wsdlDocumentLocation URL for the WSDL document location for the service or null
+ * @param serviceInterface Service interface
+ * @param properties A set of implementation-specific properties to help locate the generated service implementation class
+ * @return ??? read the spec once again
+ * @throws ServiceException If there is any error while creating the specified service, including the case where a generated service implementation class cannot be located
+ */
+ public abstract Service loadService(java.net.URL wsdlDocumentLocation,
+ java.lang.Class serviceInterface,
+ java.util.Properties properties) throws ServiceException;
+
+ /**
+ * Method loadService
+ * Create an instance of the generated service implementation class for a given service, if available. The service is uniquely identified by the wsdlDocumentLocation and serviceName arguments. An implementation may use the provided properties to help locate the generated implementation class. If no such class is present, a ServiceException will be thrown.
+ * @param wsdlDocumentLocation URL for the WSDL document location for the service or null
+ * @param serviceName Qualified name for the service
+ * @param properties A set of implementation-specific properties to help locate the generated service implementation class
+ * @return ??? read the spec once again
+ * @throws ServiceException If there is any error while creating the specified service, including the case where a generated service implementation class cannot be located
+ */
+ public abstract Service loadService(java.net.URL wsdlDocumentLocation,
+ javax.xml.namespace.QName serviceName,
+ java.util.Properties properties) throws ServiceException;
+}
Added: webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Stub.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Stub.java?rev=202164&view=auto
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Stub.java (added)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Stub.java Tue Jun 28 05:20:58 2005
@@ -0,0 +1,61 @@
+/*
+ * Copyright 2004,2005 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.xml.rpc;
+
+/**
+ * Interface Stub
+ * The interface javax.xml.rpc.Stub is the common base interface for the stub classes. All generated stub classes are required to implement the javax.xml.rpc.Stub interface. An instance of a stub class represents a client side proxy or stub instance for the target service endpoint.
+ * The javax.xml.rpc.Stub interface provides an extensible property mechanism for the dynamic configuration of a stub instance.
+ *
+ * @version 1.0
+ * @author sunja07
+ */
+public interface Stub extends BindingProvider{
+
+ /**
+ * Method _setProperty
+ * Sets the name and value of a configuration property for this Stub instance. This method is retained for backwards compatibility, new code should use getRequestContext().setProperty(...) instead. If the Stub instances contains a value of the same property, the old value is replaced.
+ * Note that the _setProperty method may not perform validity check on a configured property value. An example is the standard property for the target service endpoint address that is not checked for validity in the _setProperty method. In this case, stub configuration errors are detected at the remote method invocation.
+ *
+ * @param name - Name of the configuration property
+ * @param value - Value of the property
+ * @throws JAXRPCException -
+ * 1. If an optional standard property name is specified, however this Stub implementation class does not support the configuration of this property.
+ * 2. If an invalid or unsupported property name is specified or if a value of mismatched property type is passed.
+ * 3. If there is any error in the configuration of a valid property.
+ */
+ void _setProperty(java.lang.String name, java.lang.Object value) throws JAXRPCException;
+
+ /**
+ * Method _getProperty
+ * Gets the value of a specific configuration property. This method is retained for backwards compatibility, new code should use getRequestContext().getProperty(...) instead.
+ *
+ * @param name - Name of the property whose value is to be retrieved
+ * @return Value of the configuration property
+ * @throws JAXRPCException - if an invalid or unsupported property name is passed.
+ */
+ java.lang.Object _getProperty(java.lang.String name) throws JAXRPCException;
+
+ /**
+ * Method _getPropertyNames
+ * Returns an Iterator view of the names of the properties that can be configured on this stub instance. This method is retained for backwards compatibility, new code should use getRequestContext().getPropertyNames(...) instead.
+ *
+ * @return Iterator for the property names of the type java.lang.String
+ */
+ java.util.Iterator _getPropertyNames();
+
+}