javax.xml.soap
public abstract class SOAPFactory extends Object
SOAPFactory
is a factory for creating various objects
that exist in the SOAP XML tree.
SOAPFactory
can be
used to create XML fragments that will eventually end up in the
SOAP part. These fragments can be inserted as children of the
SOAPHeaderElement
or SOAPBodyElement
or
SOAPEnvelope
.
SOAPFactory
also has methods to create
javax.xml.soap.Detail
objects as well as
java.xml.soap.Name
objects.
Constructor Summary | |
---|---|
SOAPFactory() |
Method Summary | |
---|---|
abstract Detail | createDetail()
Creates a new Detail object which serves as a container
for DetailEntry objects.
|
abstract SOAPElement | createElement(Name name)
Create a SOAPElement object initialized with the
given Name object.
|
abstract SOAPElement | createElement(String localName)
Create a SOAPElement object initialized with the
given local name.
|
abstract SOAPElement | createElement(String localName, String prefix, String uri)
Create a new SOAPElement object with the given
local name, prefix and uri.
|
abstract Name | createName(String localName, String prefix, String uri)
Creates a new Name object initialized with the
given local name, namespace prefix, and namespace URI.
|
abstract Name | createName(String localName)
Creates a new Name object initialized with the
given local name.
|
static SOAPFactory | newInstance()
Creates a new instance of SOAPFactory .
|
Detail
object which serves as a container
for DetailEntry
objects.
This factory method creates Detail
objects for use in
situations where it is not practical to use the SOAPFault
abstraction.
Returns: a Detail
object
Throws: SOAPException if there is a SOAP error
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
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
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
Returns: the new SOAPElement
object that was
created
Throws: SOAPException if there is an error in creating the
SOAPElement
object
Name
object initialized with the
given local name, namespace prefix, and namespace URI.
This factory method creates Name
objects for use in
situations where it is not practical to use the SOAPEnvelope
abstraction.
Parameters: localName a String
giving the local name prefix a String
giving the prefix of the namespace uri a String
giving the URI of the namespace
Returns: a Name
object initialized with the given
local name, namespace prefix, and namespace URI
Throws: SOAPException if there is a SOAP error
Name
object initialized with the
given local name.
This factory method creates Name
objects for use in
situations where it is not practical to use the SOAPEnvelope
abstraction.
Parameters: localName a String
giving the local name
Returns: a Name
object initialized with the given
local name
Throws: SOAPException if there is a SOAP error
SOAPFactory
.
Returns: a new instance of a SOAPFactory
Throws: SOAPException if there was an error creating the
default SOAPFactory