1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package javax.xml.soap;
// $Id: SAAJResult.java 2897 2007-04-23 06:12:12Z thomas.diesler@jboss.com $
import javax.xml.transform.dom.DOMResult;
import org.w3c.dom.Element;
/**
* 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 the getResult() method. The DOMResult.getNode() method should be avoided in almost all cases.
*
* @author Thomas.Diesler@jboss.org
* @since SAAJ 1.3
*/
public class SAAJResult extends DOMResult
{
private SOAPElement rootElement;
/**
* Creates a SAAJResult 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 as SOAPElement, is drawn from the SAAJ API. When used in a transformation,
* the results are populated into the SOAPPart of a SOAPMessage that is created internally.
* The SOAPPart returned by DOMResult.getNode() is not guaranteed to be well-formed.
*
* @throws SOAPException if there is a problem creating a SOAPMessage
* @since SAAJ 1.3
*/
public SAAJResult() throws SOAPException
{
}
/**
* Creates a SAAJResult that will present results in the form of a SAAJ tree that supports the specified protocol.
* The DYNAMIC_SOAP_PROTOCOL is ambiguous in this context and will cause this constructor to throw an UnsupportedOperationException.
*
* 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 as SOAPElement, is drawn from the SAAJ API. When used in a transformation the results are populated into the SOAPPart of a SOAPMessage that is created internally. The SOAPPart returned by DOMResult.getNode() is not guaranteed to be well-formed.
*
* @param protocol the name of the SOAP protocol that the resulting SAAJ tree should support
* @throws SOAPException if a SOAPMessage supporting the specified protocol cannot be created
* @since SAAJ 1.3
*/
public SAAJResult(String protocol) throws SOAPException
{
}
/**
* Creates a SAAJResult that will write the results into the SOAPPart of the supplied SOAPMessage.
* In the normal case these results will be written using DOM APIs and, as a result, the finished SOAPPart
* 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 the SOAPMessage after the transformation can be guaranteed only by means outside SAAJ specification.
*
* @param message the message whose SOAPPart will be populated as a result of some transformation or marshalling operation
* @since SAAJ 1.3
*/
public SAAJResult(SOAPMessage message)
{
try
{
rootElement = message.getSOAPPart().getEnvelope();
}
catch (SOAPException ex)
{
throw new IllegalArgumentException("Cannot create SAAJ result", ex);
}
}
/**
* Creates a SAAJResult that will write the results as a child node of the SOAPElement 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 of SAAJResult should only be used when the validity of the incoming data can be guaranteed by means outside of the SAAJ specification.
*
* @param rootNode the root to which the results will be appended
* @since SAAJ 1.3
*/
public SAAJResult(SOAPElement rootNode)
{
rootElement = rootNode;
}
/**
* @return the resulting Tree that was created under the specified root Node.
* @since SAAJ 1.3
*/
public Node getResult()
{
return rootElement;
}
public void setNode(org.w3c.dom.Node node)
{
rootElement = null;
if (node instanceof Element)
{
try
{
SOAPFactory factory = SOAPFactory.newInstance();
rootElement = factory.createElement((Element)node);
}
catch (SOAPException ex)
{
throw new IllegalArgumentException("Cannot set node: " + node, ex);
}
}
}
}
|
