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 ja...@apache.org on 2005/06/29 14:41:19 UTC
svn commit: r202360 [1/2] - in
/webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc:
./ holders/ security/ soap/
Author: jayachandra
Date: Wed Jun 29 05:41:18 2005
New Revision: 202360
URL: http://svn.apache.org/viewcvs?rev=202360&view=rev
Log: (empty)
Modified:
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/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/SecurityConfiguration.java
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
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/AsyncHandler.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/AsyncHandler.java Wed Jun 29 05:41:18 2005
@@ -18,7 +18,9 @@
/**
* 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.
+ * 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
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Binding.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Binding.java Wed Jun 29 05:41:18 2005
@@ -27,7 +27,8 @@
/**
* Method getHandlerChain
- * Gets the handler chain for protocol binding instance. The returned List is used to configure the handler chain.
+ * Gets the handler chain for protocol binding instance. The returned
+ * List is used to configure the handler chain.
*
* @return java.util.List Handler chain
*/
@@ -38,18 +39,24 @@
* 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.
+ * @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;
+ 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.
+ * @throws java.lang.UnsupportedOperationException - if the Binding class
+ * does not support the configuration of SecurityConfiguration.
*/
- SecurityConfiguration getSecurityConfiguration() throws java.lang.UnsupportedOperationException;
+ SecurityConfiguration getSecurityConfiguration() throws
+ java.lang.UnsupportedOperationException;
}
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/BindingProvider.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/BindingProvider.java Wed Jun 29 05:41:18 2005
@@ -18,7 +18,9 @@
/**
* Interface BindingProvider
- * The javax.xml.rpc.BindingProvider interface provides access to the protocol binding and associated JAXRPCContext objects for request and response message processing.
+ * 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
@@ -30,7 +32,8 @@
* 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";
+ 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
@@ -40,36 +43,42 @@
* 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";
+ 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";
+ 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";
+ 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";
+ 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";
+ 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";
+ static final java.lang.String JAXB_CONTEXT_PROPERTY =
+ "javax.xml.rpc.binding.context";
/**
* Method getRequestContext
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Call.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Call.java Wed Jun 29 05:41:18 2005
@@ -18,8 +18,11 @@
/**
* 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.
+ * 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
@@ -31,14 +34,16 @@
* 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";
+ 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";
+ static final java.lang.String ENCODINGSTYLE_URI_PROPERTY =
+ "javax.xml.rpc.encodingstyle.namespace.uri";
/**
* Method isParameterAndReturnSpecRequired
@@ -52,7 +57,9 @@
* @throws java.lang.IllegalArgumentException - If invalid operation name
* is specified
*/
- boolean isParameterAndReturnSpecRequired(javax.xml.namespace.QName operationName) throws java.lang.IllegalArgumentException;
+ boolean isParameterAndReturnSpecRequired(
+ javax.xml.namespace.QName operationName)
+ throws java.lang.IllegalArgumentException;
/**
* Method addParameter
@@ -66,7 +73,8 @@
* @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.
+ * the method isParameterAndReturnSpecRequired returns false for this
+ * operation.
* @throws java.lang.IllegalArgumentException If any illegal parameter
* name or XML type is specified
*/
@@ -89,14 +97,18 @@
* @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.
+ * 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;
+ ParameterMode parameterMode) throws
+ java.lang.IllegalArgumentException,
+ java.lang.UnsupportedOperationException,
+ javax.xml.rpc.JAXRPCException;
/**
* Method getParameterTypeByName
@@ -104,7 +116,8 @@
* @param paramName Name of the parameter
* @return Returns XML type for the specified parameter
*/
- javax.xml.namespace.QName getParameterTypeByName(java.lang.String paramName);
+ javax.xml.namespace.QName getParameterTypeByName(
+ java.lang.String paramName);
/**
* Method setReturnType
@@ -113,24 +126,32 @@
* @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
+ * @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;
+ 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 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
+ * 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.Class javaType) throws
+ java.lang.UnsupportedOperationException,
java.lang.IllegalArgumentException,
javax.xml.rpc.JAXRPCException;
@@ -143,8 +164,12 @@
/**
* 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.
+ * 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;
@@ -158,7 +183,8 @@
/**
* 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
+ * @param operationName QName of the operation to be invoked using the
+ * Call instance
*/
void setOperationName(javax.xml.namespace.QName operationName);
@@ -178,8 +204,11 @@
/**
* 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
+ * 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);
@@ -192,12 +221,17 @@
/**
* 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.
+ * 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.
+ * 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,
@@ -208,7 +242,8 @@
* 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.
+ * @throws javax.xml.rpc.JAXRPCException if an invalid or unsupported
+ * property name is passed.
*/
java.lang.Object getProperty(java.lang.String name);
@@ -216,7 +251,8 @@
* 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.
+ * @throws javax.xml.rpc.JAXRPCException if an invalid or unsupported
+ * property name is passed.
*/
void removeProperty(java.lang.String name);
@@ -229,30 +265,39 @@
/**
* 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
+ * 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 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)
+ * 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;
+ 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.
+ * 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.
+ * @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 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)
+ * 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,
@@ -261,24 +306,36 @@
/**
* 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
+ * @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;
+ 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.
+ * 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.
+ * 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;
}
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Dispatch.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Dispatch.java Wed Jun 29 05:41:18 2005
@@ -18,7 +18,9 @@
/**
* 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.
+ * 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
@@ -27,43 +29,76 @@
/**
* 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.
+ * 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.
+ * @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.
+ * 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.
+ * @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.
+ * 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
+ * @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.
+ * 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.
+ * @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;
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCContext.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCContext.java Wed Jun 29 05:41:18 2005
@@ -18,54 +18,66 @@
/**
* 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.
+ * 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.
+ * 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";
+ 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";
+ 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";
+ 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";
+ 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";
+ 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";
+ 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.
+ * 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
+ * @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;
@@ -74,18 +86,22 @@
* 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
+ * @throws java.lang.IllegalArgumentException if an illegal property name
+ * is specified
*/
- void removeProperty(java.lang.String name) throws java.lang.IllegalArgumentException;
+ 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
+ * @throws java.lang.IllegalArgumentException if an illegal property name
+ * is specified
*/
- java.lang.Object getProperty(java.lang.String name) throws java.lang.IllegalArgumentException;
+ java.lang.Object getProperty(java.lang.String name) throws
+ java.lang.IllegalArgumentException;
/**
* Method getPropertyNames
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCException.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/JAXRPCException.java Wed Jun 29 05:41:18 2005
@@ -18,12 +18,14 @@
/**
* 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.
+ * 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 {
+public class JAXRPCException extends RuntimeException implements
+java.io.Serializable {
/**
* Empty Constructor
@@ -36,7 +38,8 @@
/**
* Constructor
* Constructs a new exception with the specified detail message.
- * @param message - The detail message which is later retrieved using the getMessage method
+ * @param message - The detail message which is later retrieved using the
+ * getMessage method
*/
public JAXRPCException(java.lang.String message) {
super(message);
@@ -45,8 +48,10 @@
/**
* 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
+ * @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) {
@@ -58,7 +63,9 @@
* 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.)
+ * @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);
@@ -69,7 +76,8 @@
* 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
+ * @return The cause of this Exception or null if the cause is noexistent
+ * or unknown
*/
public java.lang.Throwable getLinkedCause() {
return getCause();
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/LogicalMessage.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/LogicalMessage.java Wed Jun 29 05:41:18 2005
@@ -28,26 +28,41 @@
/**
* 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.
+ * 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.
+ * 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;
+ 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.
+ * @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;
@@ -55,9 +70,13 @@
* 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.
+ * @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;
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/NamespaceConstants.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/NamespaceConstants.java Wed Jun 29 05:41:18 2005
@@ -48,27 +48,32 @@
/**
* Nameapace URI for SOAP 1.1 Envelope
*/
- public static final java.lang.String NSURI_SOAP_ENVELOPE = "http://schemas.xmlsoap.org/soap/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/";
+ 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";
+ 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";
+ 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";
+ public static final java.lang.String NSURI_SCHEMA_XSI =
+ "http://www.w3.org/2001/XMLSchema-instance";
/**
* Empty Constructor
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ParameterMode.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ParameterMode.java Wed Jun 29 05:41:18 2005
@@ -18,7 +18,8 @@
/**
* 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.
+ * 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
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ProtocolException.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ProtocolException.java Wed Jun 29 05:41:18 2005
@@ -20,12 +20,16 @@
/**
* 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.
+ * 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 {
+public class ProtocolException extends RuntimeException implements
+Serializable {
/**
* Empty Constructor
@@ -38,7 +42,8 @@
/**
* 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.
+ * @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);
@@ -48,8 +53,11 @@
* 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.)
+ * @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) {
@@ -61,7 +69,9 @@
* 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.)
+ * @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);
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Provider.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Provider.java Wed Jun 29 05:41:18 2005
@@ -18,7 +18,11 @@
/**
* 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.
+ * 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
@@ -30,9 +34,16 @@
* 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.
+ * @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;
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Response.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Response.java Wed Jun 29 05:41:18 2005
@@ -30,7 +30,8 @@
* Method getContext
* Gets the contained response context.
*
- * @return The contained response context. May be null if a response is not yet available.
+ * @return The contained response context. May be null if a response is
+ * not yet available.
*/
JAXRPCContext getContext();
}
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Service.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/Service.java Wed Jun 29 05:41:18 2005
@@ -23,8 +23,10 @@
/**
* 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.
+ * 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.
*
@@ -45,7 +47,9 @@
/**
* 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:
+ * 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);
@@ -58,12 +62,17 @@
*/
/**
* 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.)
+ * 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
+ * @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 {
+/* public static Service.Mode valueOf(java.lang.String name) throws
+ * java.lang.IllegalArgumentException {
return null;
}
*/
@@ -71,14 +80,24 @@
/**
* 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
+ * 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
+ * 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,
@@ -87,11 +106,21 @@
/**
* 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.
+ * 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
+ * @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
*/
@@ -100,7 +129,9 @@
/**
* 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.
+ * 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
@@ -118,10 +149,17 @@
* 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.
+ * @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
+ * @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,
@@ -135,25 +173,39 @@
* 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.
+ * @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
+ * @throws ServiceException - If any error in the creation of the Dispatch
+ * object
* @see JAXBContext
*/
- Dispatch<java.lang.Object> createDispatch(javax.xml.namespace.QName portName,
+ 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.
+ * 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.
+ * @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;
@@ -172,7 +224,8 @@
* 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.
+ * @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
*/
@@ -184,9 +237,11 @@
* 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.
+ * @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
+ * @throws ServiceException If any error in the creation of the Call
+ * object
*/
Call createCall(javax.xml.namespace.QName portName,
java.lang.String operationName)
@@ -194,7 +249,9 @@
/**
* 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.
+ * 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
*/
@@ -209,9 +266,12 @@
/**
* 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
+ * 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;
@@ -224,26 +284,39 @@
/**
* 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.
+ * 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.
+ * @throws java.lang.UnsupportedOperationException if the Service class
+ * does not support the configuration of TypeMappingRegistry.
*/
- TypeMappingRegistry getTypeMappingRegistry() throws java.lang.UnsupportedOperationException;
+ 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.
+ * 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.
+ * @throws java.lang.UnsupportedOperationException if the Service class
+ * does not support the configuration of SecurityConfiguration.
*/
- SecurityConfiguration getSecurityConfiguration() throws java.lang.UnsupportedOperationException;
+ SecurityConfiguration getSecurityConfiguration() throws
+ java.lang.UnsupportedOperationException;
/**
* Method getHandlerRegistry
- * Returns the configured HandlerRegistry instance for this Service instance.
+ * 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
+ * @throws java.lang.UnsupportedOperationException if the Service class
+ * does not support the configuration of a HandlerRegistry
*/
- HandlerRegistry getHandlerRegistry() throws java.lang.UnsupportedOperationException;
+ HandlerRegistry getHandlerRegistry() throws
+ java.lang.UnsupportedOperationException;
}
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceException.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceException.java Wed Jun 29 05:41:18 2005
@@ -20,7 +20,8 @@
/**
* Class ServiceException
- * The javax.xml.rpc.ServiceException is thrown from the methods in the javax.xml.rpc.Service interface and ServiceFactory class.
+ * 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
@@ -38,7 +39,8 @@
/**
* Constructor
* Constructs a new exception with the specified detail message.
- * @param message - The detail message which is later retrieved using the getMessage method
+ * @param message - The detail message which is later retrieved using the
+ * getMessage method
*/
public ServiceException(java.lang.String message) {
super(message);
@@ -47,8 +49,10 @@
/**
* 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
+ * @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) {
@@ -60,7 +64,9 @@
* 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.)
+ * @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);
@@ -69,7 +75,8 @@
/**
* Method getLinkedCause
* Gets the Linked cause
- * @return The cause of this Exception or null if the cause is noexistent or unknown
+ * @return The cause of this Exception or null if the cause is noexistent
+ * or unknown
*/
public java.lang.Throwable getLinkedCause() {
return getCause();
Modified: 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=202360&r1=202359&r2=202360&view=diff
==============================================================================
--- webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceFactory.java (original)
+++ webservices/axis/trunk/archive/java/scratch/ashu_jaya_venkat/jaxws/src/javax/xml/rpc/ServiceFactory.java Wed Jun 29 05:41:18 2005
@@ -18,8 +18,13 @@
/**
* 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.
+ * 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
@@ -27,9 +32,11 @@
public abstract class ServiceFactory {
/**
- * A constant representing the property used to lookup the name of a ServiceFactory implementation class.
+ * 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";
+ public static final java.lang.String SERVICEFACTORY_PROPERTY =
+ "javax.xml.rpc.ServiceFactory";
private static ServiceFactory serviceFactoryImpl = null;
@@ -40,8 +47,10 @@
/**
* 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.
+ * 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
*/
@@ -78,7 +87,8 @@
/**
* Method createService
* Create a Service instance.
- * @param wsdlDocumentLocation URL for the WSDL document location for the service
+ * @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
@@ -88,22 +98,33 @@
/**
* Method loadService
- * Create an instance of the generated service implementation class for a given service interface, if available.
+ * 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
+ * @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
+ * 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
+ * @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
+ * @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,
@@ -111,12 +132,20 @@
/**
* 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
+ * 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
+ * @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
+ * @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,