View Javadoc

1   package org.codehaus.xfire.handler.dom;
2   
3   import javax.xml.namespace.QName;
4   import org.codehaus.xfire.MessageContext;
5   
6   /***
7    * A handler in a DOM processed pipeline. This does not
8    * inherit from the <code>Handler</code> class.
9    * 
10   * @author <a href="mailto:dan@envoisolutions.com">Dan Diephouse</a>
11   * @since Sep 18, 2004
12   */
13  public interface DOMHandler
14  {
15      String ROLE = DOMHandler.class.getName();
16  
17      /***
18       * @return null or an empty array if there are no headers.
19       */
20      QName[] getUnderstoodHeaders();
21      
22      /***
23       * Invoke a handler. If a fault occurs it will be handled
24       * via the <code>handleFault</code> method.
25       * 
26       * @param message The message context.
27       */
28      void invoke( MessageContext context,
29                   Message request,
30                   Message response ) throws Exception;
31  }