- java.lang.Object
-
- javax.xml.transform.dom.DOMResult
-
- javax.xml.soap.SAAJResult
-
- All Implemented Interfaces:
- Result
public class SAAJResult extends DOMResult
Acts as a holder for the results of a JAXP transformation or a JAXB marshalling, in the form of a SAAJ tree. These results should be accessed by using thegetResult()
method. TheDOMResult.getNode()
method should be avoided in almost all cases.- Since:
- SAAJ 1.3
-
-
Field Summary
-
Fields inherited from class javax.xml.transform.dom.DOMResult
FEATURE
-
Fields inherited from interface javax.xml.transform.Result
PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING
-
-
Constructor Summary
Constructors Constructor and Description SAAJResult()
Creates aSAAJResult
that will present results in the form of a SAAJ tree that supports the default (SOAP 1.1) protocol.SAAJResult(SOAPElement rootNode)
Creates aSAAJResult
that will write the results as a child node of theSOAPElement
specified.SAAJResult(SOAPMessage message)
Creates aSAAJResult
that will write the results into theSOAPPart
of the suppliedSOAPMessage
.SAAJResult(String protocol)
Creates aSAAJResult
that will present results in the form of a SAAJ tree that supports the specified protocol.
-
Method Summary
Methods Modifier and Type Method and Description Node
getResult()
-
Methods inherited from class javax.xml.transform.dom.DOMResult
getNextSibling, getNode, getSystemId, setNextSibling, setNode, setSystemId
-
-
-
-
Constructor Detail
-
SAAJResult
public SAAJResult() throws SOAPException
Creates aSAAJResult
that will present results in the form of a SAAJ tree that supports the default (SOAP 1.1) protocol.This kind of
SAAJResult
is meant for use in situations where the results will be used as a parameter to a method that takes a parameter whose type, such asSOAPElement
, is drawn from the SAAJ API. When used in a transformation, the results are populated into theSOAPPart
of aSOAPMessage
that is created internally. TheSOAPPart
returned byDOMResult.getNode()
is not guaranteed to be well-formed.- Throws:
SOAPException
- if there is a problem creating aSOAPMessage
- Since:
- SAAJ 1.3
-
SAAJResult
public SAAJResult(String protocol) throws SOAPException
Creates aSAAJResult
that will present results in the form of a SAAJ tree that supports the specified protocol. TheDYNAMIC_SOAP_PROTOCOL
is ambiguous in this context and will cause this constructor to throw anUnsupportedOperationException
.This kind of
SAAJResult
is meant for use in situations where the results will be used as a parameter to a method that takes a parameter whose type, such asSOAPElement
, is drawn from the SAAJ API. When used in a transformation the results are populated into theSOAPPart
of aSOAPMessage
that is created internally. TheSOAPPart
returned byDOMResult.getNode()
is not guaranteed to be well-formed.- Parameters:
protocol
- - the name of the SOAP protocol that the resulting SAAJ tree should support- Throws:
SOAPException
- if aSOAPMessage
supporting the specified protocol cannot be created- Since:
- SAAJ 1.3
-
SAAJResult
public SAAJResult(SOAPMessage message)
Creates aSAAJResult
that will write the results into theSOAPPart
of the suppliedSOAPMessage
. In the normal case these results will be written using DOM APIs and, as a result, the finishedSOAPPart
will not be guaranteed to be well-formed unless the data used to create it is also well formed. When used in a transformation the validity of theSOAPMessage
after the transformation can be guaranteed only by means outside SAAJ specification.- Parameters:
message
- - the message whoseSOAPPart
will be populated as a result of some transformation or marshalling operation- Since:
- SAAJ 1.3
-
SAAJResult
public SAAJResult(SOAPElement rootNode)
Creates aSAAJResult
that will write the results as a child node of theSOAPElement
specified. In the normal case these results will be written using DOM APIs and as a result may invalidate the structure of the SAAJ tree. This kind ofSAAJResult
should only be used when the validity of the incoming data can be guaranteed by means outside of the SAAJ specification.- Parameters:
rootNode
- - the root to which the results will be appended- Since:
- SAAJ 1.3
-
-
Method Detail
-
getResult
public Node getResult()
- Returns:
- the resulting Tree that was created under the specified root Node.
- Since:
- SAAJ 1.3
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
22/12/2024 15:47:15 Cette version de la page est en cache (à la date du 22/12/2024 15:47:15) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 11/06/2005, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/xml/soap/SAAJResult.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.