Name
HandlerRegistry
Synopsis
public interface HandlerRegistry extends java.io.Serializable { // Public Instance Methods public abstract java.util.List getHandlerChain( javax.xml.namespace.QNameportName
); public abstract void setHandlerChain(javax.xml.namespace.QNameportName
, java.util.Listchain
); }
HandlerRegistry
is a container that holds the
information necessary to build a handler chain. Handler chains are
defined for a port within a service endpoint interface. Each
HandlerRegistry
is therefore associated with a
service and contains one or more entries that are keyed on the
javax.xml.namespace.QName
of a port within the
service, as defined in the service’s WSDL document.
The getHandlerChain( )
method can be used to
retrieve the handler chain definition for a port given its
QName
, while setHandlerChain( )
is used to install a chain definition. Both of these methods
represent a handler chain as a java.util.List
containing a HandlerInfo
object for each handler
in the chain.
On the client side, the HandlerRegistry
for an
endpoint is associated with its Service
object and
can be retrieved using the getHandlerRegistry( )
method. When the Service
object is generated from
a WSDL file or a Java interface definition, the code required to
initialize the HandlerRegistry
is generated from
the configuration information passed to wscompile
.
However, in the case of a Service
object obtained
from a ServiceFactory
, the
HandlerRegistry
is not initialized. A client application that needs to use ...
Get Java Web Services in a Nutshell now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.