javax.xml.rpc.handler

Interface HandlerChain

Contents
  • All Superinterfaces:
    Collection, Iterable, List

    public interface HandlerChain
extends List
    The javax.xml.rpc.handler.HandlerChain represents a list of handlers. All elements in the HandlerChain are of the type javax.xml.rpc.handler.Handler.

    An implementation class for the HandlerChain interface abstracts the policy and mechanism for the invocation of the registered handlers.

    Version:
    1.0
    Author:
    Rahul Sharma
    See Also:
    HandlerChain

    • Method Detail

      • handleRequest

        boolean handleRequest(MessageContext context)
        The handleRequest method initiates the request processing for this handler chain.
        Parameters:
        context - MessageContext parameter provides access to the request SOAP message.
        Returns:
        boolean Returns true if all handlers in chain have been processed. Returns false if a handler in the chain returned false from its handleRequest method.
        Throws:
        JAXRPCException - if any processing error happens
        See Also:
        Handler.handleRequest(javax.xml.rpc.handler.MessageContext)

      • handleResponse

        boolean handleResponse(MessageContext context)
        The handleResponse method initiates the response processing for this handler chain.
        Parameters:
        context - MessageContext parameter provides access to the response SOAP message.
        Returns:
        boolean Returns true if all handlers in chain have been processed. Returns false if a handler in the chain returned false from its handleResponse method.
        Throws:
        JAXRPCException - if any processing error happens
        See Also:
        Handler.handleResponse(javax.xml.rpc.handler.MessageContext)

      • handleFault

        boolean handleFault(MessageContext context)
        The handleFault method initiates the SOAP fault processing for this handler chain.
        Parameters:
        context - MessageContext parameter provides access to the SOAP message.
        Returns:
        boolean Returns true if all handlers in chain have been processed. Returns false if a handler in the chain returned false from its handleFault method.
        Throws:
        JAXRPCException - if any processing error happens
        See Also:
        Handler.handleFault(javax.xml.rpc.handler.MessageContext)

      • init

        void init(Map config)
        Initializes the configuration for a HandlerChain.
        Parameters:
        config - Configuration for the initialization of this handler chain
        Throws:
        JAXRPCException - If any error during initialization

      • destroy

        void destroy()
        Indicates the end of lifecycle for a HandlerChain.
        Throws:
        JAXRPCException - If any error during destroy

      • setRoles

        void setRoles(String[] soapActorNames)
        Sets SOAP Actor roles for this HandlerChain. This specifies the set of roles in which this HandlerChain is to act for the SOAP message processing at this SOAP node. These roles assumed by a HandlerChain must be invariant during the processing of an individual SOAP message through the HandlerChain.

        A HandlerChain always acts in the role of the special SOAP actor next. Refer to the SOAP specification for the URI name for this special SOAP actor. There is no need to set this special role using this method.

        Parameters:
        soapActorNames - URIs for SOAP actor name
        See Also:
        NamespaceConstants

      • getRoles

        String[] getRoles()
        Gets SOAP actor roles registered for this HandlerChain at this SOAP node. The returned array includes the special SOAP actor next.
        Returns:
        String[] SOAP Actor roles as URIs
        See Also:
        NamespaceConstants

Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/xml/rpc/handler/HandlerChain.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com, HandlerChain (Java(TM) EE 7 Specification APIs)

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.