Código de um Handler

package example.ws.handler;

import java.util.Set;
import javax.xml.namespace.QName;
import javax.xml.ws.handler.MessageContext;
import javax.xml.ws.handler.soap.SOAPHandler;
import javax.xml.ws.handler.soap.SOAPMessageContext;

public class EmptyHandler implements SOAPHandler {

    /**
     * Gets the names of the header blocks that can be processed by this Handler instance.
     * If null, processes all.
     */
    public Set getHeaders() {
        return null;
    }

    /**
     * The handleMessage method is invoked for normal processing of inbound and
     * outbound messages.
     */
     public boolean handleMessage(SOAPMessageContext smc) {
        return true;
    }

    /** The handleFault method is invoked for fault message processing. */
    public boolean handleFault(SOAPMessageContext smc) {
        return true;
    }

    /**
     * Called at the conclusion of a message exchange pattern just prior to the
     * JAX-WS runtime dispatching a message, fault or exception.
     */
    public void close(MessageContext messageContext) {

    }

}

Processamento da mensagem

O retorno do método handleMessage() determina de que forma prossegue o processamento da mensagem.
Se for 'true' o processamento deve prosseguir; se for 'false' bloqueia o processamento da mensagem, mudando-lhe o sentido e fazendo-a voltar para o cliente.

A utilização de exceções permite modificar o normal processamento das mensagens SOAP:

• Se um handler atirar uma exceção java.lang.RuntimeException (ou um sub-tipo desta classe), tal indica que o processamento normal da mensagem deve parar. O método close() é invocado nos handlers que entretanto já tinham sido chamados, o sentido da mensagem é invertido e a excepção é despachada. Se a mensagem tinha o sentido de saída (outbound), é gerada uma mensagem SOAP automaticamente preenchida com uma SOAP Fault.
• Se um handler atirar uma exceção javax.xml.ws.soap.SOAPFaultException (que é um sub-tipo de javax.xml.ws.ProtocolException), indica que o processamento normal da mensagem deve parar e que se deve iniciar o processamento de mensagem de erro. O sentido da mensagem é invertido, se a mensagem não é ainda uma mensagem de Fault é substituída por uma mensagem de Fault, e o método handleFault() é invocado para o próximo Handler caso exista, para que seja preenchida manualmente a informação da Fault.