rwsf::SOAPworXServlet

rwsf::SOAPworXServlet  rwsf::HttpServlet

• Local Index
• Header File
• Description
• Public Member Functions
• Protected Member Functions

Members

destroy() doGet()

doPost() init()

initContext() processContext()

#include <rw/rwsf/soapworx/server/SOAPworXServlet.h>

The class rwsf::SOAPworXServlet is the class from which all servlets in HydraExpress are derived. The servlet is automatically instantiated by the rwsf server when the server is started, and is based on the web.xml file generated by HydraExpress for your project. The servlet creates a rwsf::NamingContext context object for each service. This context contains all rwsf::NamedObject objects that are required by the service.

For more information on the servlet, see Section 8.3.11.2, "Servlet Configuration File: web.xml," in the HydraExpress Web Service Development Guide

We recommend using the servlet automatically instantiated by the rwsf server, but if you choose to create or customize your own servlet, be sure to change its name in the context's web.xml file.

void 
doPost(rwsf::HttpServletRequest& request, rwsf::HttpServletResponse& response);

Creates the rwsf::ServletContext context object for this service and generates a session ID, rwsf:SessionID. Iterates through the header to retrieve the request or response, and the transport data. Calls the method initContext() to initialize the context, and then calls invoke() on the service handler. Finally, calls processContext(), which is implemented in the generated derived class. This method is called by a listener managed by the rwsf server.

void 
doGet(rwsf::HttpServletRequest& request,
       rwsf::HttpServletResponse& response);

Locates and reads the WSDL file in the context directory, and sets the payload, or the contents, of the response. If the WSDL is not found, throws a rwsf::Exception. This method is called by a listener managed by the rwsf server.

virtual void 
initContext(rwsf::CallInfo& context, 
             rwsf::HttpServletRequest& request);

Virtual. Allows a derived class to add any additional initialization parameters or attributes to the rwsf::CallInfo object before calling the message handler.

virtual void 
processContext(rwsf::CallInfo& context,
               rwsf::HttpServletRequest& request,
               rwsf::HttpServletResponse& response);

Virtual. In derived classes, would provide a hook for accessing the rwsf::CallInfo, rwsf::HttpServletRequest and rwsf::HttpServletResponse parameters after the message handler has been called. Can be used to set additional information in the rwsf::HttpServletResponse.

virtual void 
init();

Initializes a generic servlet with no configuration parameters.

virtual void 
init(const rwsf::ServletConfig& config);

Initializes the servlet given the parameters in the config object. Uses rwsf::HandlerManager to locate all service handlers for this service, and reads the transports configuration file transports.xml to get the right transport. Initializes the related rwsf::NamedObject objects.

virtual void 
destroy();

Destroys all the rwsf::NamedObjects, including the listeners, related to this servlet.

©2004-2007 Copyright Quovadx, Inc. All Rights Reserved.
Quovadx and Rogue Wave are registered trademarks of Quovadx, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.