|
Spring Web Services Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.xml.transform.TransformerObjectSupport org.springframework.ws.server.endpoint.AbstractDomPayloadEndpoint
@Deprecated public abstract class AbstractDomPayloadEndpoint
Abstract base class for endpoints that handle the message payload as DOM elements.
Offers the message payload as a DOMElement
, and allows subclasses to create a response by returning an
Element
.
An AbstractDomPayloadEndpoint
only accept one payload element. Multiple payload elements are
not in accordance with WS-I.
invokeInternal(org.w3c.dom.Element,org.w3c.dom.Document)
Field Summary |
---|
Fields inherited from class org.springframework.xml.transform.TransformerObjectSupport |
---|
logger |
Constructor Summary | |
---|---|
AbstractDomPayloadEndpoint()
Deprecated. |
Method Summary | |
---|---|
protected DocumentBuilder |
createDocumentBuilder(DocumentBuilderFactory factory)
Deprecated. Create a DocumentBuilder that this endpoint will use for parsing XML documents. |
protected DocumentBuilderFactory |
createDocumentBuilderFactory()
Deprecated. Create a DocumentBuilderFactory that this endpoint will use for constructing XML documents. |
protected Element |
getDocumentElement(Source source,
DocumentBuilder documentBuilder)
Deprecated. Returns the payload element of the given source. |
Source |
invoke(Source request)
Deprecated. Invokes the endpoint with the given request payload, and possibly returns a response. |
protected abstract Element |
invokeInternal(Element requestElement,
Document responseDocument)
Deprecated. Template method that subclasses must implement to process the request. |
void |
setAlwaysTransform(boolean alwaysTransform)
Deprecated. Set if the request Source should always be transformed into a new DOMResult . |
void |
setExpandEntityReferences(boolean expandEntityRef)
Deprecated. Set if the XML parser should expand entity reference nodes. |
void |
setNamespaceAware(boolean namespaceAware)
Deprecated. Set whether or not the XML parser should be XML namespace aware. |
void |
setValidating(boolean validating)
Deprecated. Set if the XML parser should validate the document. |
Methods inherited from class org.springframework.xml.transform.TransformerObjectSupport |
---|
createTransformer, getTransformerFactory, newTransformerFactory, setTransformerFactoryClass, transform |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public AbstractDomPayloadEndpoint()
Method Detail |
---|
public void setNamespaceAware(boolean namespaceAware)
true
.
public void setValidating(boolean validating)
false
.
public void setExpandEntityReferences(boolean expandEntityRef)
false
.
public void setAlwaysTransform(boolean alwaysTransform)
Source
should always be transformed into a new DOMResult
.
Default is false
, which is faster.
public final Source invoke(Source request) throws Exception
PayloadEndpoint
invoke
in interface PayloadEndpoint
request
- the payload of the request message, may be null
null
to indicate no response
Exception
- if an exception occursprotected DocumentBuilder createDocumentBuilder(DocumentBuilderFactory factory) throws ParserConfigurationException
DocumentBuilder
that this endpoint will use for parsing XML documents. Can be overridden in
subclasses, adding further initialization of the builder.
factory
- the DocumentBuilderFactory
that the DocumentBuilder should be created with
DocumentBuilder
ParserConfigurationException
- if thrown by JAXP methodsprotected DocumentBuilderFactory createDocumentBuilderFactory() throws ParserConfigurationException
DocumentBuilderFactory
that this endpoint will use for constructing XML documents. Can be
overridden in subclasses, adding further initialization of the factory. The resulting
DocumentBuilderFactory
is cached, so this method will only be called once.
ParserConfigurationException
- if thrown by JAXP methodsprotected Element getDocumentElement(Source source, DocumentBuilder documentBuilder) throws TransformerException
DOMSource
, and returns the node of that. In all other cases, or when alwaysTransform is true
, the source is transformed into a DOMResult
, which is more expensive. If
the passed source is null
, null
is returned.
source
- the source to return the root element of; can be null
documentBuilder
- the document builder to be used for transformations
TransformerException
- in case of errorsprotected abstract Element invokeInternal(Element requestElement, Document responseDocument) throws Exception
Offers the request payload as a DOM Element
, and allows subclasses to return a response
Element
.
The given DOM Document
is to be used for constructing Node
s, by using the various
create
methods.
requestElement
- the contents of the SOAP message as DOM elementsresponseDocument
- a DOM document to be used for constructing Node
s
null
to specify no response.
Exception
|
Spring Web Services Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |