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.
8    * 
9    * @author <a href="mailto:dan@envoisolutions.com">Dan Diephouse</a>
10   * @since Sep 18, 2004
11   */
12  public interface DOMHandler
13  {
14      String ROLE = DOMHandler.class.getName();
15  
16      /***
17       * @return null or an empty array if there are no headers.
18       */
19      QName[] getUnderstoodHeaders();
20      
21      /***
22       * Invoke a handler. If a fault occurs it will be handled
23       * via the <code>handleFault</code> method.
24       * 
25       * @param message The message context.
26       */
27      void invoke( MessageContext context,
28                   Message request,
29                   Message response ) throws Exception;
30  }