org.codehaus.xfire.handler
Interface Handler

All Known Subinterfaces:
EndpointHandler
All Known Implementing Classes:
AbstractHandler, HandlerPipeline, ObjectServiceHandler, SoapHandler

public interface Handler

A handler is just something that processes an XML message.

If an exception occurrs in the invoke method, the entity which started the invocation, is responsible for turning the exception into a fault.

Since:
Feb 18, 2004
Author:
Dan Diephouse

Field Summary
static java.lang.String ROLE
           
 
Method Summary
 java.lang.String[] getRoles()
          The roles which this service applies to.
 javax.xml.namespace.QName[] getUnderstoodHeaders()
           
 void handleFault(XFireFault fault, MessageContext context)
          Handles faults that occur in this handler.
 void invoke(MessageContext context)
          Invoke a handler.
 

Field Detail

ROLE

static final java.lang.String ROLE
Method Detail

getUnderstoodHeaders

javax.xml.namespace.QName[] getUnderstoodHeaders()
Returns:
null or an empty array if there are no headers.

getRoles

java.lang.String[] getRoles()
The roles which this service applies to.

Returns:
null or an empty if this endpoint handles no roles.

invoke

void invoke(MessageContext context)
            throws java.lang.Exception
Invoke a handler. If a fault occurs it will be handled via the handleFault method.

Parameters:
message - The message context.
Throws:
java.lang.Exception

handleFault

void handleFault(XFireFault fault,
                 MessageContext context)
Handles faults that occur in this handler. This is not responsible for actually writing the fault response message.

Parameters:
context -