SOAPFactory JDK 1.6)

publicabstract 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.
Returns: a Detail object
Throws:
- SOAPException - if there is a SOAP error
- UnsupportedOperationException - if the protocol specified for the SOAPFactory was DYNAMIC_SOAP_PROTOCOL

public SOAPElement createElement (Element domElement) throws SOAPException

Creates a SOAPElement object from an existing DOM Element.

Creates a SOAPElement object from an existing DOM
Element. If the DOM Element that is passed in
as an argument is already a SOAPElement then this method
must return it unmodified without any further work. Otherwise, a new
SOAPElement is created and a deep copy is made of the
domElement argument. The concrete type of the return value
will depend on the name of the domElement argument. If any
part of the tree rooted in domElement violates SOAP rules, a
SOAPException will be thrown.
Returns: a new SOAPElement that is a copy of domElement.
Parameters:
- domElement - - the Element to be copied.
Throws:
- SOAPException - if there is an error in creating the SOAPElement object
Since: SAAJ 1.3

publicabstract SOAPElement createElement (Name name) throws SOAPException

Creates a SOAPElement object initialized with the given Name object.

Creates a SOAPElement object initialized with the
given Name object. The concrete type of the return value
will depend on the name given to the new SOAPElement. For
instance, a new SOAPElement with the name
"{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a
SOAPEnvelope that supports SOAP 1.2 behavior to be created.
Returns: the new SOAPElement object that was created
Parameters:
- name - a Name object with the XML name for the new element
Throws:
- SOAPException - if there is an error in creating the SOAPElement object
See Also: SOAPFactory.createElement(javax.xml.namespace.QName),

public SOAPElement createElement (QName qname) throws SOAPException

Creates a SOAPElement object initialized with the given QName object.

Creates a SOAPElement object initialized with the
given QName object. The concrete type of the return value
will depend on the name given to the new SOAPElement. For
instance, a new SOAPElement with the name
"{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a
SOAPEnvelope that supports SOAP 1.2 behavior to be created.
Returns: the new SOAPElement object that was created
Parameters:
- qname - a QName object with the XML name for the new element
Throws:
- SOAPException - if there is an error in creating the SOAPElement object
Since: SAAJ 1.3
See Also: SOAPFactory.createElement(Name),

publicabstract SOAPElement createElement (String localName) throws SOAPException

Creates a SOAPElement object initialized with the given local name.

Creates a SOAPElement object initialized with the
given local name.
Returns: the new SOAPElement object that was created
Parameters:
- localName - a String giving the local name for the new element
Throws:
- SOAPException - if there is an error in creating the SOAPElement object

publicabstract SOAPElement createElement (String localName, String prefix, String uri) throws SOAPException

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

Creates a new SOAPElement object with the given
local name, prefix and uri. The concrete type of the return value
will depend on the name given to the new SOAPElement. For
instance, a new SOAPElement with the name
"{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a
SOAPEnvelope that supports SOAP 1.2 behavior to be created.
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

publicabstract SOAPFault createFault () throws SOAPException

Creates a new default SOAPFault object

Creates a new default SOAPFault object
Returns: a SOAPFault object
Throws:
- SOAPException - if there is a SOAP error
Since: SAAJ 1.3

publicabstract SOAPFault createFault (String reasonText, QName faultCode) throws SOAPException

Creates a new SOAPFault object initialized with the given reasonText and faultCode

Creates a new SOAPFault object initialized with the given reasonText
and faultCode
Returns: a SOAPFault object
Parameters:
- reasonText - the ReasonText/FaultString for the fault
- faultCode - the FaultCode for the fault
Throws:
- SOAPException - if there is a SOAP error
Since: SAAJ 1.3

publicabstract 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.
Returns: a Name object initialized with the given local name
Parameters:
- localName - a String giving the local name
Throws:
- SOAPException - if there is a SOAP error

publicabstract 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.
Returns: a Name object initialized with the given local name, namespace prefix, and namespace URI
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
Throws:
- SOAPException - if there is a SOAP error

publicstatic SOAPFactory newInstance () throws SOAPException

Creates a new SOAPFactory object that is an instance of the default implementation (SOAP 1.1), This method uses the following ordered lookup procedure to determine the SOAPFactory implementation class to load: Use the javax.xml.soap.SOAPFactory system property.

Creates a new SOAPFactory object that is an instance of
the default implementation (SOAP 1.1),

This method uses the following ordered lookup procedure to determine the SOAPFactory implementation class to load:

Use the javax.xml.soap.SOAPFactory system property.
Use the properties file "lib/jaxm.properties" in the JRE directory. This configuration file is in standard
java.util.Properties format and contains the fully qualified name of the implementation class with the key being the
system property defined above.
Use the Services API (as detailed in the JAR specification), if available, to determine the classname. The Services API
will look for a classname in the file META-INF/services/javax.xml.soap.SOAPFactory in jars available to the runtime.
Use the SAAJMetaFactory instance to locate the SOAPFactory implementation class.

Returns: a new instance of a SOAPFactory
Throws:
- SOAPException - if there was an error creating the default SOAPFactory
See Also: SAAJMetaFactory,

publicstatic SOAPFactory newInstance (String protocol) throws SOAPException

Creates a new SOAPFactory object that is an instance of the specified implementation, this method uses the SAAJMetaFactory to locate the implementation class and create the SOAPFactory instance.

Creates a new SOAPFactory object that is an instance of
the specified implementation, this method uses the SAAJMetaFactory to
locate the implementation class and create the SOAPFactory instance.
Returns: a new instance of a SOAPFactory
Parameters:
- protocol - a string constant representing the protocol of the specified SOAP factory implementation. May be either DYNAMIC_SOAP_PROTOCOL, DEFAULT_SOAP_PROTOCOL (which is the same as) SOAP_1_1_PROTOCOL, or SOAP_1_2_PROTOCOL.
Throws:
- SOAPException - if there was an error creating the specified SOAPFactory
Since: SAAJ 1.3
See Also: SAAJMetaFactory,