javax.xml.soap
Class SOAPElementFactory

java.lang.Object
  |
  +--javax.xml.soap.SOAPElementFactory

public abstract class SOAPElementFactory

extends java.lang.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.

Constructor Summary

SOAPElementFactory()

Method Summary

abstract SOAPElement	create(Name name) Create a SOAPElement object initialized with the given Name object.
abstract SOAPElement	create(java.lang.String localName) Create a SOAPElement object initialized with the given local name.
abstract SOAPElement	create(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.
static SOAPElementFactory	newInstance() Creates a new instance of SOAPElementFactory.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SOAPElementFactory

public SOAPElementFactory()

Method Detail

create

public abstract SOAPElement create(Name name)
                            throws SOAPException

Create a SOAPElement object initialized with the given Name object.

Parameters:

name - a Name object with the XML name for the new element

Returns:

the new SOAPElement object that was created

Throws:

SOAPException - if there is an error in creating the SOAPElement object

create

public abstract SOAPElement create(java.lang.String localName)
                            throws SOAPException

Create a SOAPElement object initialized with the given local name.

Parameters:

localName - a String giving the local name for the new element

Returns:

the new SOAPElement object that was created

Throws:

SOAPException - if there is an error in creating the SOAPElement object

create

public abstract SOAPElement create(java.lang.String localName,
                                   java.lang.String prefix,
                                   java.lang.String uri)
                            throws SOAPException

Create a new SOAPElement object with the given local name, prefix and uri.

Parameters:

localName - a String giving the local name for the new element

prefix - the prefix for this SOAPElement

uri - a String giving the URI of the namespace to which the new element belongs

Throws:

SOAPException - if there is an error in creating the SOAPElement object

newInstance

public static SOAPElementFactory newInstance()
                                      throws SOAPException

Creates a new instance of SOAPElementFactory.

Returns:

a new instance of a SOAPElementFactory

Throws:

SOAPException - if there was an error creating the default SOAPElementFactory