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();
- }
- }
- }
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);
- }
- }
- }
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);
}
}
}
评论
原文出自 http://weblogs.java.net/blog/ramapulavarthi