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 di...@apache.org on 2002/01/29 02:52:46 UTC

cvs commit: xml-axis/java/src/javax/xml/soap FactoryFinder.java MessageFactory.java SOAPElementFactory.java SOAPException.java SOAPFaultElement.java SOAPMessage.java SOAPPart.java

dims        02/01/28 17:52:46

  Modified:    java/src/javax/xml/soap FactoryFinder.java
                        MessageFactory.java SOAPElementFactory.java
                        SOAPException.java SOAPFaultElement.java
                        SOAPMessage.java SOAPPart.java
  Added:       java/src/javax/xml/rpc/handler Handler.java
                        HandlerChain.java HandlerInfo.java
                        HandlerRegistry.java MessageContext.java
               java/src/javax/xml/rpc/handler/soap SOAPMessageContext.java
  Log:
  More classes from JAX-RPC 0.6
  
  Revision  Changes    Path
  1.1                  xml-axis/java/src/javax/xml/rpc/handler/Handler.java
  
  Index: Handler.java
  ===================================================================
  /*
   * The Apache Software License, Version 1.1
   *
   *
   * Copyright (c) 2001 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Axis" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   */
  
  package javax.xml.rpc.handler;
  
  import java.util.Map;
  
  import javax.xml.rpc.JAXRPCException;
  import javax.xml.rpc.soap.SOAPFault;
  
  /**
   * A handler provides a mechanism for processing of service
   * context, plugging in additional RPC processing behavior and
   * enhancing functionality of a JAX-RPC runtime system.
   * <p>A JAX-RPC handler is required to implement the
   * <code>javax.xml.rpc.handler.Handler</code> interface.
   */
  public interface Handler {
  
      /**
       * The handle method performs the actual processing work for
       * a handler. An implementation class for the Handler interface
       * is required to provide a default constructor.
       *  @param   context MessageContext parameter provides access to
       *            the message context (for example: SOAP message
       *            that carries an RPC request) that is processed
       *            by a handler.
       *  @throws  JAXRPCException if any handler specific processing
       *            error happens
       *  @throws  SOAPFault if SOAP fault is generated by this handler
       */
      public abstract void handle(MessageContext context)
          throws JAXRPCException, SOAPFault;
  
      /**
       * The init method to enable the Handler instance to initialize
       * itself. The init method passes the handler configuration
       * properties as a Map instance. These configuration properties
       * are used to configure the Handler (for example: setup access
       * to an external resource or service) during initialization.
       *  @param   config Configuration parameters for initialization of
       *          handler
       *  @throws  JAXRPCException If initialization of the handler fails
       */
      public abstract void init(Map config) throws JAXRPCException;
  
      /**
       * The destroy method indicates the end of lifecycle for a Handler
       * instance. An Handler implementation class should release any
       * resources that it had acquired over its lifecycle. The JAX-RPC
       * runtime system invokes the destroy method, when the Handler
       * instance is no longer needed.
       * @throws  JAXRPCException  If any error during destroy
       */
      public abstract void destroy() throws JAXRPCException;
  }
  
  
  
  1.1                  xml-axis/java/src/javax/xml/rpc/handler/HandlerChain.java
  
  Index: HandlerChain.java
  ===================================================================
  /*
   * The Apache Software License, Version 1.1
   *
   *
   * Copyright (c) 2001 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Axis" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   */
  
  package javax.xml.rpc.handler;
  
  import java.util.List;
  
  /**
   * The <code>javax.xml.rpc.handler.HandlerChain</code> represents an
   * ordered list of handlers. All elements in the HandlerChain are of
   * the type javax.xml.rpc.handler.HandlerInfo.
   * <p>An implementation class for the HandlerChain interface abstracts
   * the policy and mechanism for the invocation of the registered
   * handlers.
   */
  public interface HandlerChain extends Handler, List {}
  
  
  
  1.1                  xml-axis/java/src/javax/xml/rpc/handler/HandlerInfo.java
  
  Index: HandlerInfo.java
  ===================================================================
  /*
   * The Apache Software License, Version 1.1
   *
   *
   * Copyright (c) 2001 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Axis" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   */
  
  package javax.xml.rpc.handler;
  
  import java.io.Serializable;
  
  import java.util.HashMap;
  import java.util.Map;
  
  /**
   * The <code>javax.xml.rpc.handler.HandlerInfo</code> represents
   * information about a handler in the HandlerChain. All elements
   * in the HandlerChain are of the type HandlerInfo.
   * @see HandlerChain
   */
  public class HandlerInfo implements Serializable {
  
      /** Default constructor */
      public HandlerInfo() {
          handlerClass = null;
          config = new HashMap();
      }
  
      /**
       *  Constructor for HandlerInfo
       *  <p>
       *  @param  handlerClass Class for the Handler
       *  @param  config Handler Configuration as a java.util.Map
       */
      public HandlerInfo(Class handlerClass, Map config) {
          this.handlerClass = handlerClass;
          this.config = config;
      }
  
      /**
       *  Sets the Handler class
       *  @param  handlerClass Class for the Handler
       */
      public void setHandlerClass(Class handlerClass) {
          this.handlerClass = handlerClass;
      }
  
      /**
       *  Gets the Handler class
       *  @return Returns null if no Handler class has been
       *    set; otherwise the set handler class
       */
      public Class getHandlerClass() {
          return handlerClass;
      }
  
      /**
       *  Sets the Handler configuration map
       *  @param  config Configuration map
       */
      public void setHandlerConfig(Map config) {
          this.config = config;
      }
  
      /**
       *  Gets the Handler configuration map
       *  @return  Returns empty Map if no configuration map
       *     has been set; otherwise returns the set configuration map
       */
      public Map getHandlerConfig() {
          return config;
      }
  
      /** Handler Class */
      private Class handlerClass;
  
      /** Configuration Map */
      private Map config;
  }
  
  
  
  1.1                  xml-axis/java/src/javax/xml/rpc/handler/HandlerRegistry.java
  
  Index: HandlerRegistry.java
  ===================================================================
  /*
   * The Apache Software License, Version 1.1
   *
   *
   * Copyright (c) 2001 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Axis" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   */
  
  package javax.xml.rpc.handler;
  
  import java.io.Serializable;
  
  import javax.xml.rpc.JAXRPCException;
  import javax.xml.rpc.namespace.QName;
  
  /**
   * The <code>javax.xml.rpc.handler.HandlerRegistry</code> provides
   * support for programmatic configuration of handlers in a
   * HandlerRegistry.
   */
  public interface HandlerRegistry extends Serializable {
  
      /**
       *  Gets the request HandlerChain for the specified service endpoint.
       *  @param   portName Qualified name of the target service
       *  @return  HandlerChain Returns the registered HandlerChain;
       *  @throws java.lang.IllegalArgumentException If an invalid portName is specified
       */
      public abstract HandlerChain getRequestHandlerChain(QName portName);
  
      /**
       *  Sets the request HandlerChain for the specified service endpoint.
       *  @param   portName Qualified name of the target service endpoint
       *  @param   chain Request HandlerChain instance
       *  @throws  JAXRPCException If any error in the setting of
       *             the HandlerChain
       *  @throws java.lang.UnsupportedOperationException If this
       *     set operation is not supported. This is done to
       *     avoid any overriding of a pre-configured handler
       *     chain.
       *  @throws java.lang.IllegalArgumentException If an invalid
       *     portName is specified
       */
      public abstract void setRequestHandlerChain(
          QName portName, HandlerChain chain) throws JAXRPCException;
  
      /**
       *  Gets the response HandlerChain for the specified service endpoint.
       *  @param   portName  Qualified name of the target service endpoint
       *  @return   HandlerChain Returns the registered HandlerChain;
       *  @throws java.lang.IllegalArgumentException If an invalid portName is specified
       */
      public abstract HandlerChain getResponseHandlerChain(QName portName);
  
      /**
       *  Sets the response HandlerChain for the specified service endpoint.
       *  @param   portName Qualified name of the target service endpoint
       *  @param   chain Response HandlerChain instance.
       *  @throws  JAXRPCException  If any error in the setting of
       *            the HandlerChain
       *  @throws java.lang.UnsupportedOperationException  If this
       *     set operation is not supported. This is done to
       *     avoid any overriding of a pre-configured handler
       *     chain.
       *  @throws java.lang.IllegalArgumentException If an invalid
       *    portName is specified
       */
      public abstract void setResponseHandlerChain(
          QName portName, HandlerChain chain) throws JAXRPCException;
  }
  
  
  
  1.1                  xml-axis/java/src/javax/xml/rpc/handler/MessageContext.java
  
  Index: MessageContext.java
  ===================================================================
  /*
   * The Apache Software License, Version 1.1
   *
   *
   * Copyright (c) 2001 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Axis" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   */
  
  package javax.xml.rpc.handler;
  
  import java.util.Iterator;
  
  /**
   * The interface MessageContext abstracts the message context that
   * is processed by a handler in the <code>handle</code> method.
   *
   * <p>The MessageContext interface provides methods to manage a
   * property set. MessageContext properties enable handlers in an
   * handler chain to share processing related state.
   */
  public interface MessageContext {
  
      /**
       * Sets the name and value of a property associated with the
       * MessageContext. If the MessageContext contains a value of
       * the same property, the old value is replaced.
       * @param  name Name of the property associated with the MessageContext
       * @param  value Value of the property
       * @throws java.lang.IllegalArgumentException If some aspect
       *         the property is prevents it from being stored
       *         in the context
       * @throws java.lang.UnsupportedOperationException If this method is
       *         not supported.
       */
      public abstract void setProperty(String name, Object value);
  
      /**
       *  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
       */
      public abstract Object getProperty(String name);
  
      /**
       *  Removes a property (name-value pair) from the message context
       *  @param  name Name of the property to be removed
       *  @throws java.lang.IllegalArgumentException if an illegal
       *        property name is specified
       */
      public abstract void removeProperty(String nae);
  
      /**
       *  Returns true if the MessageContext contains a property with the specified name.
       *  @param   name Name of the property whose presense is to be tested
       *  @return  Returns true if the MessageContext contains the
            property; otherwise false
       */
      public abstract boolean containsProperty(String name);
  
      /**
       *  Returns an Iterator view of the names of the properties in this MessageContext
       *  @return Iterator for the property names
       */
      public abstract Iterator getPropertyNames();
  }
  
  
  
  1.1                  xml-axis/java/src/javax/xml/rpc/handler/soap/SOAPMessageContext.java
  
  Index: SOAPMessageContext.java
  ===================================================================
  /*
   * The Apache Software License, Version 1.1
   *
   *
   * Copyright (c) 2001 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Axis" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation.  For more
   * information on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   */
  
  package javax.xml.rpc.handler.soap;
  
  import javax.xml.rpc.JAXRPCException;
  import javax.xml.rpc.handler.MessageContext;
  import javax.xml.soap.SOAPMessage;
  
  /**
   * The interface <code>javax.xml.rpc.soap.SOAPMessageContext</code>
   * provides access to the SOAP message for either RPC request or
   * response. The <code>javax.xml.soap.SOAPMessage</code> specifies
   * the standard Java API for the representation of a SOAP 1.1 message
   * with attachments.
   * @see javax.xml.soap.SOAPMessage
   */
  public interface SOAPMessageContext extends MessageContext {
  
      /**
       *  Gets the request SOAPMessage from this message context
       *  @return Returns the SOAPMessage; returns null if no request
       *          SOAPMessage is present in this SOAPMessageContext
       */
      public abstract SOAPMessage getRequestMessage();
  
      /**
       *  Sets the request SOAPMessage for this message context
       *  @param   message  Request SOAP message
       *  @throws  JAXRPCException  If any error during the setting
       *     of the request message or if invalid SOAPMessage
       *     is set
       *  @throws java.lang.UnsupportedOperationException If this
       *     operation is not supported
       */
      public abstract void setRequestMessage(SOAPMessage message)
          throws JAXRPCException;
  
      /**
       *  Gets the response SOAPMessage for this message context
       *  @return Returns the SOAPMessage; returns null if no response
       *     SOAPMessage is present in this SOAPMessageContext
       *  @throws  JAXRPCException
       */
      public abstract SOAPMessage getResponseMessage() throws JAXRPCException;
  
      /**
       *  Sets the response SOAPMessage for this message context
       *  @param   message Response SOAP message
       *  @throws  JAXRPCException  If any error during the setting
       *     of the response message or if invalid SOAPMessage
       *     is set
       *  @throws java.lang.UnsupportedOperationException If this
       *     operation is not supported
       */
      public abstract void setResponseMessage(SOAPMessage message)
          throws JAXRPCException;
  }
  
  
  
  1.2       +0 -22     xml-axis/java/src/javax/xml/soap/FactoryFinder.java
  
  Index: FactoryFinder.java
  ===================================================================
  RCS file: /home/cvs/xml-axis/java/src/javax/xml/soap/FactoryFinder.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- FactoryFinder.java	25 Jan 2002 16:30:07 -0000	1.1
  +++ FactoryFinder.java	29 Jan 2002 01:52:45 -0000	1.2
  @@ -61,24 +61,10 @@
   
   import java.util.Properties;
   
  -/**
  - * TODO: Put description here.
  - * <p>
  - * @author  name TODO: put author's name here.
  - */
   class FactoryFinder {
   
  -    /** TODO: Put description here. */
       FactoryFinder() {}
   
  -    /**
  -     * TODO: Put description here.
  -     * <p>
  -     * @param   s              String.
  -     * @param   classloader    ClassLoader.
  -     * @return                 Object.
  -     * @throws  SOAPException  TODO: Put exception class-name and description here.
  -     */
       private static Object newInstance(String s, ClassLoader classloader)
               throws SOAPException {
   
  @@ -102,14 +88,6 @@
           }
       }
   
  -    /**
  -     * TODO: Put description here.
  -     * <p>
  -     * @param   s              String.
  -     * @param   s1             String.
  -     * @return                 Object.
  -     * @throws  SOAPException  TODO: Put exception class-name and description here.
  -     */
       static Object find(String s, String s1) throws SOAPException {
   
           ClassLoader classloader;
  
  
  
  1.2       +1 -1      xml-axis/java/src/javax/xml/soap/MessageFactory.java
  
  Index: MessageFactory.java
  ===================================================================
  RCS file: /home/cvs/xml-axis/java/src/javax/xml/soap/MessageFactory.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- MessageFactory.java	25 Jan 2002 16:30:07 -0000	1.1
  +++ MessageFactory.java	29 Jan 2002 01:52:45 -0000	1.2
  @@ -182,7 +182,7 @@
       public abstract SOAPMessage createMessage() throws SOAPException;
   
       /**
  -     * TODO: Internalizes the contents of the given <CODE>
  +     * Internalizes the contents of the given <CODE>
        * InputStream</CODE> object into a new <CODE>SOAPMessage</CODE>
        * object and returns the <CODE>SOAPMessage</CODE> object.
        * @param   mimeheaders    the transport-specific headers
  
  
  
  1.2       +1 -1      xml-axis/java/src/javax/xml/soap/SOAPElementFactory.java
  
  Index: SOAPElementFactory.java
  ===================================================================
  RCS file: /home/cvs/xml-axis/java/src/javax/xml/soap/SOAPElementFactory.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- SOAPElementFactory.java	25 Jan 2002 16:30:07 -0000	1.1
  +++ SOAPElementFactory.java	29 Jan 2002 01:52:45 -0000	1.2
  @@ -96,7 +96,7 @@
       public abstract SOAPElement create(String localName) throws SOAPException;
   
       /**
  -     * TODO: Create a new <CODE>SOAPElement</CODE> object with the
  +     * Create a new <CODE>SOAPElement</CODE> object with the
        * given local name, prefix and uri.
        * @param   localName a <CODE>String</CODE> giving
        *     the local name for the new element
  
  
  
  1.2       +1 -1      xml-axis/java/src/javax/xml/soap/SOAPException.java
  
  Index: SOAPException.java
  ===================================================================
  RCS file: /home/cvs/xml-axis/java/src/javax/xml/soap/SOAPException.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- SOAPException.java	25 Jan 2002 16:30:07 -0000	1.1
  +++ SOAPException.java	29 Jan 2002 01:52:45 -0000	1.2
  @@ -212,6 +212,6 @@
           }
       }
   
  -    /** TODO: Put description here. */
  +    /** */
       private Throwable cause;
   }
  
  
  
  1.2       +1 -1      xml-axis/java/src/javax/xml/soap/SOAPFaultElement.java
  
  Index: SOAPFaultElement.java
  ===================================================================
  RCS file: /home/cvs/xml-axis/java/src/javax/xml/soap/SOAPFaultElement.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- SOAPFaultElement.java	25 Jan 2002 16:30:07 -0000	1.1
  +++ SOAPFaultElement.java	29 Jan 2002 01:52:45 -0000	1.2
  @@ -54,5 +54,5 @@
    */
   package javax.xml.soap;
   
  -/** TODO: Put description here. */
  +/** */
   public interface SOAPFaultElement extends SOAPElement {}
  
  
  
  1.2       +1 -1      xml-axis/java/src/javax/xml/soap/SOAPMessage.java
  
  Index: SOAPMessage.java
  ===================================================================
  RCS file: /home/cvs/xml-axis/java/src/javax/xml/soap/SOAPMessage.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- SOAPMessage.java	25 Jan 2002 16:30:07 -0000	1.1
  +++ SOAPMessage.java	29 Jan 2002 01:52:45 -0000	1.2
  @@ -323,7 +323,7 @@
       public abstract boolean saveRequired();
   
       /**
  -     * TODO: Writes this <CODE>SOAPMessage</CODE> object to the given
  +     * Writes this <CODE>SOAPMessage</CODE> object to the given
        *   output stream. The externalization format is as defined by
        *   the SOAP 1.1 with Attachments specification.
        *
  
  
  
  1.2       +1 -1      xml-axis/java/src/javax/xml/soap/SOAPPart.java
  
  Index: SOAPPart.java
  ===================================================================
  RCS file: /home/cvs/xml-axis/java/src/javax/xml/soap/SOAPPart.java,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- SOAPPart.java	25 Jan 2002 16:30:07 -0000	1.1
  +++ SOAPPart.java	29 Jan 2002 01:52:45 -0000	1.2
  @@ -266,7 +266,7 @@
       public abstract Iterator getMatchingMimeHeaders(String names[]);
   
       /**
  -     * TODO: Retrieves all <CODE>MimeHeader</CODE> objects whose name
  +     * Retrieves all <CODE>MimeHeader</CODE> objects whose name
        * does not match a name in the given array.
        * @param   names a <CODE>String</CODE> array with
        *     the name(s) of the MIME headers not to be returned