Java Web Services in a Nutshell

Name

HandlerInfo

Synopsis

public class HandlerInfo implements java.io.Serializable {
// Public Constructors
    public HandlerInfo(  ); 
    public HandlerInfo(Class handlerClass, Map config, 
        javax.xml.namespace.QName[ ] headers); 
// Property Accessor Methods (by property name)
    public Class getHandlerClass(  );
               // default:null
    public void setHandlerClass( Class handlerClass); 
    public Map getHandlerConfig(  );
               // default:HashMap
    public void setHandlerConfig( Map config); 
    public javax.xml.namespace.QName[ ] getHeaders(  );
               // default:null
    public void setHeaders(javax.xml.namespace.QName[ ] headers); 
}

The HandlerInfo class contains all of the information needed to describe and construct a Handler. HandlerInfo objects are stored in a HandlerRegistry and may be created by application code or, more commonly, by code generated by a tool such as wscompile, wsdeploy, or j2eec, based on the content of a configuration file.

A HandlerInfo object contains three attributes, all of which may be set at construction time or using setter methods:

Handler class

The fully qualified name of the Java class that contains the handler functionality. This class must have a no-argument constructor and must implement the Handler interface. This attribute may be read using the getHandlerClass( ) method and changed by calling setHandlerClass( ).

Header list

The set of headers that the handler processes, specified as an array of QName objects. If the handler does not operate on headers, then an empty array may be supplied. This attribute ...