|
Spring Web Services Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.springframework.xml.transform.TransformerObjectSupport
org.springframework.ws.transport.http.WsdlDefinitionHandlerAdapter
public class WsdlDefinitionHandlerAdapter
Adapter to use the WsdlDefinition
interface with the generic DispatcherServlet
.
WsdlDefinition
implementation, and writes that as the result to the
HttpServletResponse
.
If the property transformLocations
is set to true
, this adapter will change
location
attributes in the WSDL definition to reflect the URL of the incoming request. If the location
field in the original WSDL is an absolute path, the scheme, hostname, and port will be changed. If the location is a
relative path, the scheme, hostname, port, and context path will be prepended. This behavior can be customized by
overriding the transformLocation()
method.
For instance, if the location attribute defined in the WSDL is http://localhost:8080/context/services/myService
,
and the request URI for the WSDL is http://example.com/context/myService.wsdl
, the location will be
changed to http://example.com/context/services/myService
.
If the location attribute defined in the WSDL is /services/myService
, and the request URI for the WSDL
is http://example.com:8080/context/myService.wsdl
, the location will be changed to
http://example.com:8080/context/services/myService
.
When transformLocations
is enabled, all location
attributes found in the WSDL definition
are changed by default. This behavior can be customized by changing the locationExpression
property,
which is an XPath expression that matches the attributes to change.
WsdlDefinition
,
setTransformLocations(boolean)
,
setLocationExpression(String)
,
transformLocation(String,javax.servlet.http.HttpServletRequest)
Field Summary | |
---|---|
static String |
DEFAULT_LOCATION_EXPRESSION
Default XPath expression used for extracting all location attributes from the WSDL definition. |
Constructor Summary | |
---|---|
WsdlDefinitionHandlerAdapter()
|
Method Summary | |
---|---|
void |
afterPropertiesSet()
|
long |
getLastModified(HttpServletRequest request,
Object handler)
|
ModelAndView |
handle(HttpServletRequest request,
HttpServletResponse response,
Object handler)
|
void |
setLocationExpression(String locationExpression)
Sets the XPath expression used for extracting the location attributes from the WSDL 1.1 definition. |
void |
setTransformLocations(boolean transformLocations)
Sets whether relative address locations in the WSDL are to be transformed using the request URI of the incoming HttpServletRequest . |
boolean |
supports(Object handler)
|
protected String |
transformLocation(String location,
HttpServletRequest request)
Transform the given location string to reflect the given request. |
protected void |
transformLocations(Document definitionDocument,
HttpServletRequest request)
Transforms all location attributes to reflect the server name given HttpServletRequest . |
Methods inherited from class org.springframework.xml.transform.TransformerObjectSupport |
---|
createTransformer, getTransformerFactory, transform |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String DEFAULT_LOCATION_EXPRESSION
location
attributes from the WSDL definition.
Constructor Detail |
---|
public WsdlDefinitionHandlerAdapter()
Method Detail |
---|
public void setLocationExpression(String locationExpression)
location
attributes from the WSDL 1.1 definition.
Defaults to DEFAULT_LOCATION_EXPRESSION
.
DEFAULT_LOCATION_EXPRESSION
public void setTransformLocations(boolean transformLocations)
HttpServletRequest
. Defaults to false
.
public long getLastModified(HttpServletRequest request, Object handler)
getLastModified
in interface HandlerAdapter
public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception
handle
in interface HandlerAdapter
Exception
public boolean supports(Object handler)
supports
in interface HandlerAdapter
public void afterPropertiesSet() throws Exception
afterPropertiesSet
in interface InitializingBean
Exception
protected String transformLocation(String location, HttpServletRequest request)
http://localhost:8080/context/services/myService
,
and the request URI for the WSDL is http://example.com:8080/context/myService.wsdl
, the location
will be changed to http://example.com:8080/context/services/myService
.
If the location attribute defined in the WSDL is /services/myService
, and the request URI for the
WSDL is http://example.com:8080/context/myService.wsdl
, the location will be changed to
http://example.com:8080/context/services/myService
.
This method is only called when the transformLocations
property is true.
protected void transformLocations(Document definitionDocument, HttpServletRequest request) throws Exception
location
attributes to reflect the server name given HttpServletRequest
.
Determines the suitable attributes by evaluating the defined XPath expression, and delegates to
transformLocation
to do the transformation for all attributes that match.
This method is only called when the transformLocations
property is true.
Exception
setLocationExpression(String)
,
setTransformLocations(boolean)
,
transformLocation(String,javax.servlet.http.HttpServletRequest)
|
Spring Web Services Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |