org.apache.xmlbeans.impl.soap.SOAPElementFactory Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of commons-xmlbeans Show documentation
Show all versions of commons-xmlbeans Show documentation
The Apache Commons Codec package contains simple encoder and decoders for
various formats such as Base64 and Hexadecimal. In addition to these
widely used encoders and decoders, the codec package also maintains a
collection of phonetic encoding utilities.
The newest version!
/* Copyright 2004 The Apache Software Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.xmlbeans.impl.soap;
/**
* SOAPElementFactory is a factory for XML
* fragments that will eventually end up in the SOAP part. These
* fragments can be inserted as children of the
* SOAPHeader or SOAPBody or
* SOAPEnvelope.
*
* Elements created using this factory do not have the
* properties of an element that lives inside a SOAP header
* document. These elements are copied into the XML document tree
* when they are inserted.
* @deprecated - Use javax.xml.soap.SOAPFactory for creating SOAPElements.
* @see SOAPFactory SOAPFactory
*/
public class SOAPElementFactory {
/**
* Create a new SOAPElementFactory from a SOAPFactory.
*
* @param soapfactory the SOAPFactory to use
*/
private SOAPElementFactory(SOAPFactory soapfactory) {
sf = soapfactory;
}
/**
* Create a SOAPElement object initialized with
* the given Name object.
* @param name a Name object with
* the XML name for the new element
* @return the new SOAPElement object that was
* created
* @throws SOAPException if there is an error in
* creating the SOAPElement object
* @deprecated Use javax.xml.soap.SOAPFactory.createElement(javax.xml.soap.Name) instead
* @see SOAPFactory#createElement(javax.xml.soap.Name) SOAPFactory.createElement(javax.xml.soap.Name)
*/
public SOAPElement create(Name name) throws SOAPException {
return sf.createElement(name);
}
/**
* Create a SOAPElement object initialized with
* the given local name.
* @param localName a String giving
* the local name for the new element
* @return the new SOAPElement object that was
* created
* @throws SOAPException if there is an error in
* creating the SOAPElement object
* @deprecated Use javax.xml.soap.SOAPFactory.createElement(String localName) instead
* @see SOAPFactory#createElement(java.lang.String) SOAPFactory.createElement(java.lang.String)
*/
public SOAPElement create(String localName) throws SOAPException {
return sf.createElement(localName);
}
/**
* Create a new SOAPElement object with the
* given local name, prefix and uri.
* @param localName a String giving
* the local name for the new element
* @param prefix the prefix for this
* SOAPElement
* @param uri a String giving the
* URI of the namespace to which the new element
* belongs
* @return the new SOAPElement object that was
* created
* @throws SOAPException if there is an error in
* creating the SOAPElement object
* @deprecated Use javax.xml.soap.SOAPFactory.createElement(String localName, String prefix, String uri) instead
* @see SOAPFactory#createElement(java.lang.String, java.lang.String, java.lang.String) SOAPFactory.createElement(java.lang.String, java.lang.String, java.lang.String)
*/
public SOAPElement create(String localName, String prefix, String uri)
throws SOAPException {
return sf.createElement(localName, prefix, uri);
}
/**
* Creates a new instance of SOAPElementFactory.
*
* @return a new instance of a
* SOAPElementFactory
* @throws SOAPException if there was an error creating
* the default SOAPElementFactory
* @deprecated
*/
public static SOAPElementFactory newInstance() throws SOAPException {
try {
return new SOAPElementFactory(SOAPFactory.newInstance());
} catch (Exception exception) {
throw new SOAPException("Unable to create SOAP Element Factory: "
+ exception.getMessage());
}
}
private SOAPFactory sf;
}