javax.xml.soap
Class SOAPFactory
java.lang.Object
javax.xml.soap.SOAPFactory
public abstract class SOAPFactory
extends java.lang.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.
Detail | createDetail() - Creates a new
Detail object which serves as a container
for DetailEntry objects.
|
SOAPElement | createElement(String localName) - Create a
SOAPElement object initialized with the
given local name.
|
SOAPElement | createElement(String localName, String prefix, String uri) - Create a new
SOAPElement object with the given
local name, prefix and uri.
|
SOAPElement | createElement(Name name) - Create a
SOAPElement object initialized with the
given Name object.
|
Name | createName(String localName) - Creates a new
Name object initialized with the
given local name.
|
Name | createName(String localName, String prefix, String uri) - Creates a new
Name object initialized with the
given local name, namespace prefix, and namespace URI.
|
static SOAPFactory | newInstance() - Creates a new instance of
SOAPFactory .
|
SOAPFactory
public SOAPFactory()
createDetail
public Detail createDetail()
throws SOAPException
Creates a new
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.
- a
Detail
object
SOAPException
- if there is a SOAP error
createElement
public SOAPElement createElement(String localName)
throws SOAPException
Create a SOAPElement
object initialized with the
given local name.
localName
- a String
giving the local name for
the new element
- the new
SOAPElement
object that was
created
SOAPException
- if there is an error in creating the
SOAPElement
object
createElement
public SOAPElement createElement(String localName,
String prefix,
String uri)
throws SOAPException
Create a new SOAPElement
object with the given
local name, prefix and uri.
localName
- a String
giving the local name
for the new elementprefix
- the prefix for this SOAPElement
uri
- a String
giving the URI of the
namespace to which the new element belongs
- the new
SOAPElement
object that was
created
SOAPException
- if there is an error in creating the
SOAPElement
object
createElement
public SOAPElement createElement(Name name)
throws SOAPException
Create a SOAPElement
object initialized with the
given Name
object.
name
- a Name
object with the XML name for
the new element
- the new
SOAPElement
object that was
created
SOAPException
- if there is an error in creating the
SOAPElement
object
createName
public Name createName(String localName)
throws SOAPException
Creates a new
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.
localName
- a String
giving the local name
- a
Name
object initialized with the given
local name
SOAPException
- if there is a SOAP error
createName
public Name createName(String localName,
String prefix,
String uri)
throws SOAPException
Creates a new
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.
localName
- a String
giving the local nameprefix
- a String
giving the prefix of the namespaceuri
- a String
giving the URI of the namespace
- a
Name
object initialized with the given
local name, namespace prefix, and namespace URI
SOAPException
- if there is a SOAP error
newInstance
public static SOAPFactory newInstance()
throws SOAPException
Creates a new instance of SOAPFactory
.
- a new instance of a
SOAPFactory
SOAPException
- if there was an error creating the
default SOAPFactory
Copyright B) 2005 Apache Web Services Project. All Rights Reserved.