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.
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 |
SOAPElementFactory
public SOAPElementFactory()
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 elementprefix
- 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
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
Copyright © 2001 Apache XML Project. All Rights Reserved.