FileDocCategorySizeDatePackage
GenericHandler.javaAPI DocApache Axis 1.44213Sat Apr 22 18:57:26 BST 2006javax.xml.rpc.handler

GenericHandler

public abstract class GenericHandler extends Object implements Handler
The javax.xml.rpc.handler.GenericHandler class implements the Handler interface. SOAP Message Handler developers should typically subclass GenericHandler class unless the Handler class needs another class as a superclass.

The GenericHandler class is a convenience abstract class that makes writing Handlers easy. This class provides default implementations of the lifecycle methods init and destroy and also different handle methods. A Handler developer should only override methods that it needs to specialize as part of the derived Handler implementation class.

version
1.0

Fields Summary
Constructors Summary
protected GenericHandler()
Default constructor.

Methods Summary
public voiddestroy()
The destroy method indicates the end of lifecycle for a Handler instance. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

public abstract javax.xml.namespace.QName[]getHeaders()
Gets the header blocks processed by this Handler instance.

return
Array of QNames of header blocks processed by this handler instance. QName is the qualified name of the outermost element of the Header block.

public booleanhandleFault(MessageContext context)
The handleFault method processes the SOAP faults based on the SOAP message processing model. The default implementation of this method returns true. This indicates that the handler chain should continue processing of the SOAP fault. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

param
context the message context
return
true/false

        return true;
    
public booleanhandleRequest(MessageContext context)
The handleRequest method processes the request SOAP message. The default implementation of this method returns true. This indicates that the handler chain should continue processing of the request SOAP message. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

param
context the message context
return
true/false

        return true;
    
public booleanhandleResponse(MessageContext context)
The handleResponse method processes the response message. The default implementation of this method returns true. This indicates that the handler chain should continue processing of the response SOAP message. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

param
context the message context
return
true/false

        return true;
    
public voidinit(HandlerInfo config)
The init method to enable the Handler instance to initialize itself. This method should be overridden if the derived Handler class needs to specialize implementation of this method.

param
config handler configuration