JAX-WS中通过Handler操作SOAP消息

在JAVA实现的Web service的客户端和服务器端都可以通过handler来实现对SOAP消息的访问,典型的应用可以用来保存SOAP消息(作为Log,或者在流程失败的时候重新发消息,或者操作SOAP header设定security信息等).

Handler有两类,一种是用来访问整个SOAP消息的:SOAPHandler<SOAPMessageContext>.另一种是用来访问SOAP消息的payload:LogicalHandler<LogicalMessageContext>.

1,服务器端是通过注解@HandlerChain(file="handlersdef.xml")在porttype对应的类上来指定handler的.

handlersdef.xml:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<handler-chains xmlns="http://java.sun.com/xml/ns/javaee">
<handler-chain>
<handler>
<handler-name>WSLogicalHandler</handler-name>
<handler-class>com.cxfws.test.WSLogicalHandler</handler-class>
</handler>
</handler-chain>
<handler-chain>
<handler>
<handler-name>WSSOAPHandler</handler-name>
<handler-class>com.cxfws.test.WSSOAPHandler</handler-class>
</handler>
</handler-chain>
</handler-chains>

2,客户端需要通过service指定HandlerResolver,HandlerResolver里需要将用到的handler返回给service.

service.setHandlerResolver(new RequestOrderHandlerResolver());

例子:

handler:

public class PersistMessageHandler implements SOAPHandler<SOAPMessageContext> {

public static final String PERSISTENCE_DIR_PROP = "persistent.directory";

public Set<QName> getHeaders() {
System.out.println("Entered PersistMessageHandler.getHeaders");
QName serviceQName = new QName("http://test.cxf.bt.com/", "WSCXFProviderService");
QName portQName = new QName("http://test.cxf.bt.com/", "WSCXFProviderPort");
Set<QName> set = new HashSet<QName>();
set.add(serviceQName);
set.add(portQName);
return set;
}

public boolean handleMessage(SOAPMessageContext ctxt) {

System.out.println("Entered PersistMessageHandler.handleMessage");
// return if inbound message
if (!((Boolean) ctxt.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY)).booleanValue()) {
return true;
}
SOAPMessage msg = ctxt.getMessage();
String persistenceDir = (String)ctxt.get(PERSISTENCE_DIR_PROP);

try {
msg.writeTo(System.out);
} catch (SOAPException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}

return true;

}

public boolean handleFault(SOAPMessageContext ctxt) {
return false;
}

public void close(MessageContext ctxt) {
}

}

public class WSHandler implements LogicalHandler<LogicalMessageContext> {

public void close(MessageContext arg0) {
// TODO Auto-generated method stub
}

public boolean handleFault(LogicalMessageContext arg0) {
// TODO Auto-generated method stub
return false;
}

public boolean handleMessage(LogicalMessageContext arg0) {
System.out.println("WSHandler: handleMessage");
//arg0.getMessage().getPayload();
return true;
}

}

HandlerResolver:

public class RequestOrderHandlerResolver implements HandlerResolver {

public List<Handler> getHandlerChain(PortInfo arg) {

List<Handler> handlerChain = new ArrayList<Handler>();

handlerChain.add(new PersistMessageHandler());
handlerChain.add(new WSHandler());

return handlerChain;
}
}

在调用Web service的时候,将HandlerResolver指定给service:

URL wsdlURL = new URL("file:///D:/JAVAWorkspace/Repository/prjCXFWS/src/wsdl/prjCXFWS.wsdl");

QName serviceQName = new QName("http://test.cxfws.com/", "SimpleServiceService");

QName portQName = new QName("http://test.cxfws.com/", "SimpleServicePort");

Service service = Service.create(wsdlURL, serviceQName);
//set handler
service.setHandlerResolver(new RequestOrderHandlerResolver());

SimpleService port = (SimpleService) service.getPort(portQName, SimpleService.class);