org.apache.axis.transport.http

Class QSWSDLHandler

Implemented Interfaces:
QSHandler

public class QSWSDLHandler
extends AbstractQueryStringHandler

The QSWSDLHandler class is a handler which provides an AXIS service's WSDL document when the query string "wsdl" (ignoring case) is encountered in an AXIS servlet invocation.
Authors:
Curtiss Howard (code mostly from AxisServlet class)
Doug Davis (dug@us.ibm.com)
Steve Loughran
Ian P. Springer, Sal Campana

Field Summary

Fields inherited from class org.apache.axis.transport.http.AbstractQueryStringHandler

exceptionLog, log

Method Summary

protected String
getEndpointURL(MessageContext msgContext)
Returns the endpoint URL that should be used in the returned WSDL.
void
invoke(MessageContext msgContext)
Performs the action associated with this particular query string handler.
void
reportNoWSDL(HttpServletResponse res, PrintWriter writer, String moreDetailCode, AxisFault axisFault)
Report that we have no WSDL.
void
reportWSDL(Document doc, PrintWriter writer)
Report WSDL.
protected void
updateSoapAddressLocationURLs(Document wsdlDoc, MessageContext msgContext)
Updates the soap:address locations for all ports in the WSDL using the URL from the request as the base portion for the updated locations, ensuring the WSDL returned to the client contains the correct location URL.

Methods inherited from class org.apache.axis.transport.http.AbstractQueryStringHandler

configureFromContext, configureResponseFromAxisFault, convertExceptionToAxisFault, isDevelopment, processAxisFault, writeFault

Method Details

getEndpointURL

protected String getEndpointURL(MessageContext msgContext)
            throws AxisFault
Returns the endpoint URL that should be used in the returned WSDL.
Parameters:
msgContext - the current Axis JAX-RPC message context
Returns:
the endpoint URL that should be used in the returned WSDL
Throws:
AxisFault - if we fail to obtain the ServiceDesc for this service

invoke

public void invoke(MessageContext msgContext)
            throws AxisFault
Performs the action associated with this particular query string handler.
Specified by:
invoke in interface QSHandler
Parameters:
msgContext - a MessageContext object containing message context information for this query string handler.
Throws:
AxisFault - if an error occurs

reportNoWSDL

public void reportNoWSDL(HttpServletResponse res,
                         PrintWriter writer,
                         String moreDetailCode,
                         AxisFault axisFault)
Report that we have no WSDL.
Parameters:
res -
writer -
moreDetailCode - optional name of a message to provide more detail
axisFault - optional fault string, for extra info at debug time only

reportWSDL

public void reportWSDL(Document doc,
                       PrintWriter writer)
Report WSDL.
Parameters:
doc -
writer -

updateSoapAddressLocationURLs

protected void updateSoapAddressLocationURLs(Document wsdlDoc,
                                             MessageContext msgContext)
            throws AxisFault
Updates the soap:address locations for all ports in the WSDL using the URL from the request as the base portion for the updated locations, ensuring the WSDL returned to the client contains the correct location URL.
Parameters:
wsdlDoc - the WSDL as a DOM document
msgContext - the current Axis JAX-RPC message context
Throws:
AxisFault - if we fail to obtain the list of deployed service names from the server config

Copyright B) 2005 Apache Web Services Project. All Rights Reserved.