Novell exteNd Web Services SDK API

javax.xml.messaging
Class JAXMServlet

java.lang.Object
  extended byjavax.servlet.GenericServlet
      extended byjavax.servlet.http.HttpServlet
          extended byjavax.xml.messaging.JAXMServlet
All Implemented Interfaces:
Serializable, Servlet, ServletConfig

public abstract class JAXMServlet
extends HttpServlet

The superclass for components that live in a servlet container that receives JAXM messages. A JAXMServlet object is notified of a message's arrival using the HTTP-SOAP binding.

The JAXMServlet class is a support/utility class and is provided purely as a convenience. It is not a mandatory component, and there is no requirement that it be implemented or extended.

Note that when a component that receives messages extends JAXMServlet, it also needs to implement either a ReqRespListener object or a OnewayListener object, depending on whether the component is written for a request-response style of interaction or for a one-way (asynchronous) style of interaction.

See Also:
Serialized Form

Constructor Summary
JAXMServlet()
           
 
Method Summary
 void doPost(HttpServletRequest req, HttpServletResponse resp)
          Internalizes the given HttpServletRequest object and writes the reply to the given HttpServletResponse object.
 void init(ServletConfig servletConfig)
          Initializes this JAXMServlet object using the given ServletConfig object and initializing the msgFactory field with a default MessageFactory object.
 void setMessageFactory(MessageFactory msgFactory)
          Sets this JAXMServlet object's msgFactory field with the given MessageFactory object.
 
Methods inherited from class javax.servlet.http.HttpServlet
service
 
Methods inherited from class javax.servlet.GenericServlet
destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, log, log
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

JAXMServlet

public JAXMServlet()
Method Detail

init

public void init(ServletConfig servletConfig)
          throws ServletException
Initializes this JAXMServlet object using the given ServletConfig object and initializing the msgFactory field with a default MessageFactory object.

Parameters:
servletConfig - the ServletConfig object to be used in initializing this JAXMServlet object
Throws:
ServletException

setMessageFactory

public void setMessageFactory(MessageFactory msgFactory)
Sets this JAXMServlet object's msgFactory field with the given MessageFactory object. A MessageFactory object for a particular profile needs to be set before a message is received in order for the message to be successfully internalized.

Parameters:
msgFactory - the MessageFactory object that will be used to create the SOAPMessage object that will be used to internalize the message that was posted to the servlet

doPost

public void doPost(HttpServletRequest req,
                   HttpServletResponse resp)
            throws ServletException,
                   IOException
Internalizes the given HttpServletRequest object and writes the reply to the given HttpServletResponse object.

Note that the value for the msgFactory field will be used to internalize the message. This ensures that the message factory for the correct profile is used.

Parameters:
req - the HttpServletRequest object containing the message that was sent to the servlet
resp - the HttpServletResponse object to which the response to the message will be written
Throws:
ServletException - if there is a servlet error
IOException - if there is an input or output error

Novell exteNd Web Services SDK API

exteNd is a registered trademark of Novell, Inc.
Copyright 1998-2003 Novell, Inc. All Rights Reserved.