< prev index next >

jaxws/src/java.xml.ws/share/classes/javax/xml/soap/SOAPFactory.java

Print this page


   1 /*
   2  * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any


 133      * @exception SOAPException if there is an error in creating the
 134      *            {@code SOAPElement} object
 135      */
 136     public abstract SOAPElement createElement(String localName)
 137         throws SOAPException;
 138 
 139 
 140     /**
 141      * Creates a new {@code SOAPElement} object with the given
 142      * local name, prefix and uri. The concrete type of the return value
 143      * will depend on the name given to the new {@code SOAPElement}. For
 144      * instance, a new {@code SOAPElement} with the name
 145      * "{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a
 146      * {@code SOAPEnvelope} that supports SOAP 1.2 behavior to be created.
 147      *
 148      * @param localName a {@code String} giving the local name
 149      *                  for the new element
 150      * @param prefix the prefix for this {@code SOAPElement}
 151      * @param uri a {@code String} giving the URI of the
 152      *            namespace to which the new element belongs


 153      *
 154      * @exception SOAPException if there is an error in creating the
 155      *            {@code SOAPElement} object
 156      */
 157     public abstract SOAPElement createElement(
 158         String localName,
 159         String prefix,
 160         String uri)
 161         throws SOAPException;
 162 
 163     /**
 164      * Creates a new {@code Detail} object which serves as a container
 165      * for {@code DetailEntry} objects.
 166      * <P>
 167      * This factory method creates {@code Detail} objects for use in
 168      * situations where it is not practical to use the {@code SOAPFault}
 169      * abstraction.
 170      *
 171      * @return a {@code Detail} object
 172      * @throws SOAPException if there is a SOAP error


   1 /*
   2  * Copyright (c) 2004, 2017, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any


 133      * @exception SOAPException if there is an error in creating the
 134      *            {@code SOAPElement} object
 135      */
 136     public abstract SOAPElement createElement(String localName)
 137         throws SOAPException;
 138 
 139 
 140     /**
 141      * Creates a new {@code SOAPElement} object with the given
 142      * local name, prefix and uri. The concrete type of the return value
 143      * will depend on the name given to the new {@code SOAPElement}. For
 144      * instance, a new {@code SOAPElement} with the name
 145      * "{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a
 146      * {@code SOAPEnvelope} that supports SOAP 1.2 behavior to be created.
 147      *
 148      * @param localName a {@code String} giving the local name
 149      *                  for the new element
 150      * @param prefix the prefix for this {@code SOAPElement}
 151      * @param uri a {@code String} giving the URI of the
 152      *            namespace to which the new element belongs
 153      * @return the new {@code SOAPElement} object that was
 154      *         created
 155      *
 156      * @exception SOAPException if there is an error in creating the
 157      *            {@code SOAPElement} object
 158      */
 159     public abstract SOAPElement createElement(
 160         String localName,
 161         String prefix,
 162         String uri)
 163         throws SOAPException;
 164 
 165     /**
 166      * Creates a new {@code Detail} object which serves as a container
 167      * for {@code DetailEntry} objects.
 168      * <P>
 169      * This factory method creates {@code Detail} objects for use in
 170      * situations where it is not practical to use the {@code SOAPFault}
 171      * abstraction.
 172      *
 173      * @return a {@code Detail} object
 174      * @throws SOAPException if there is a SOAP error


< prev index next >