FileDocCategorySizeDatePackage
SOAPElementFactory.javaAPI DocJava SE 6 API5049Tue Jun 10 00:27:10 BST 2008javax.xml.soap

SOAPElementFactory

public class SOAPElementFactory extends Object
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
javax.xml.soap.SOAPFactory

Fields Summary
private SOAPFactory
soapFactory
Constructors Summary
private SOAPElementFactory(SOAPFactory soapFactory)

        this.soapFactory = soapFactory;
Methods Summary
public javax.xml.soap.SOAPElementcreate(javax.xml.soap.Name name)
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
exception
SOAPException if there is an error in creating the SOAPElement object
deprecated
Use javax.xml.soap.SOAPFactory.createElement(javax.xml.soap.Name) instead
see
javax.xml.soap.SOAPFactory#createElement(javax.xml.soap.Name)
see
javax.xml.soap.SOAPFactory#createElement(javax.xml.namespace.QName)

        return soapFactory.createElement(name);
public javax.xml.soap.SOAPElementcreate(java.lang.String localName)
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
exception
SOAPException if there is an error in creating the SOAPElement object
deprecated
Use javax.xml.soap.SOAPFactory.createElement(String localName) instead
see
javax.xml.soap.SOAPFactory#createElement(java.lang.String)

        return soapFactory.createElement(localName);
public javax.xml.soap.SOAPElementcreate(java.lang.String localName, java.lang.String prefix, java.lang.String uri)
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
exception
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
javax.xml.soap.SOAPFactory#createElement(java.lang.String, java.lang.String, java.lang.String)

        return soapFactory.createElement(localName, prefix, uri);
public static javax.xml.soap.SOAPElementFactorynewInstance()
Creates a new instance of SOAPElementFactory.

return
a new instance of a SOAPElementFactory
exception
SOAPException if there was an error creating the default SOAPElementFactory

        try {
            return new SOAPElementFactory(SOAPFactory.newInstance());
        } catch (Exception ex) {
            throw new SOAPException(
                "Unable to create SOAP Element Factory: " + ex.getMessage());
        }