理解JAX-WS中Handlers

     JAX-WS提供插件式框架,通过handlers去加强运行的处理能力。Handlers是一个消息拦截器，能够在你的
web service前后进行处理。JAX-WS定义了两种类型的handlers,分别为logical handlers and protocol handlers.
Protocol handlers are specific to a protocol and may access or change the protocol specific aspects of a message.
Logical handlers are protocol-agnostic and act only on the payload of the message.
     在这篇文章中"A little about Handlers in JAX-WS", rama pulavarthi 解释了logical和SOAP handlers的区别。
下面这个图显示了这两个handlers能够访问到message context：

下面这个图显示了这两个handlers在JAX-WS server and client的运行顺序：

 

Logical  Handler实例：

public class LogicalLoggingHandler implements LogicalHandler<LogicalMessageContext> {
    private static final PrintStream out = System.out;

    public boolean handleMessage(LogicalMessageContext context) {
        return processMessage(context);
    }

    public boolean handleFault(LogicalMessageContext context) {
        return processMessage(context);
    }

    public void close(MessageContext context) {
    }

    private boolean processMessage(LogicalMessageContext context) {
        Boolean outboundProperty = (Boolean)
                context.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);

        if (outboundProperty) {
            out.println("\nOutbound message:");
        } else {
            out.println("\nInbound message:");
        }
        LogicalMessage lm = context.getMessage();
        Source payload = lm.getPayload();

        printSource(payload);
        // Without it, behavior may vary on the kind of source returned in lm.getPayload().
        // lm.setPayload(modifiedPayload);
        return true;

    }

    private static void printSource(Source payload) {
        try {
            TransformerFactory factory = TransformerFactory.newInstance();
            Transformer transformer = factory.newTransformer();
            transformer.setOutputProperty(OutputKeys.OMIT_XML_DECLARATION, "yes");
            transformer.setOutputProperty(OutputKeys.METHOD, "xml");
            transformer.setOutputProperty(OutputKeys.INDENT, "yes");
            Result result = new StreamResult(out);
            transformer.transform(payload, result);
        } catch (TransformerException e) {
            e.printStackTrace();
        }
    }

}

SOAP Handler实例：

public class SOAPLoggingHandler implements SOAPHandler<SOAPMessageContext> {
    
    private static PrintStream out = System.out;
    
    public Set<QName> getHeaders() {
        return null;
    }
    
    public boolean handleMessage(SOAPMessageContext smc) {
        logToSystemOut(smc);
        return true;
    }
    
    public boolean handleFault(SOAPMessageContext smc) {
        logToSystemOut(smc);
        return true;
    }
    
    public void close(MessageContext messageContext) {
    }
    
    private void logToSystemOut(SOAPMessageContext smc) {
        Boolean outboundProperty = (Boolean)
            smc.get (MessageContext.MESSAGE_OUTBOUND_PROPERTY);
        
        if (outboundProperty.booleanValue()) {
            out.println("\nOutbound message:");
        } else {
            out.println("\nInbound message:");
        }
        
        SOAPMessage message = smc.getMessage();
        try {
            message.writeTo(out);
            out.println("");   
        } catch (Exception e) {
            out.println("Exception in handler: " + e);
        }
    }
}