webservice系统学习笔记7-使用handler实现过滤器/拦截器效果
handler可以作用于客户端，也可以作用了服务端
handler分为：1、LogicalHandler:只能获取到soap消息的body。
2、SOAPHandler:可以获取SOAPMessage的信息（我们通常用这种）。
客户端--》服务端的请求中通过handler的顺序：
假如客户端和服务端的handler-chain.xml中定义的顺序都是：LogicalHandler1/SOAPHandler1/LogicalHandler2/SOAPHandler2
那么请求的顺序将是：
client-->LogicalHandler1-->LogicalHandler2-->SOAPHandler1-->SOAPHandler2-->|服务器容器|-->SOAPHandler1-->SOAPHandler2-->LogicalHandler1-->LogicalHandler2-->service
一、在客户端加handler
服务端service
@Override public void testException() throws MyException{ throw new MyException("this is my exception"); }
在classpath目录下添加handler文件：handler-chain.xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <javaee:handler-chains xmlns:javaee="http://java.sun.com/xml/ns/javaee" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <javaee:handler-chain> <javaee:handler> <javaee:handler-class>com.ws03.MySoapHandler</javaee:handler-class> </javaee:handler> <!--还可以加入其它的handler <javaee:handler> <javaee:handler-class>com.ws03.MySoapHandler</javaee:handler-class> </javaee:handler> --> </javaee:handler-chain> </javaee:handler-chains>
MySoapHandler.java
package com.ws03; import java.io.IOException; import java.util.Set; import javax.xml.namespace.QName; import javax.xml.soap.SOAPEnvelope; import javax.xml.soap.SOAPException; import javax.xml.soap.SOAPHeader; import javax.xml.soap.SOAPMessage; import javax.xml.ws.handler.MessageContext; import javax.xml.ws.handler.soap.SOAPHandler; import javax.xml.ws.handler.soap.SOAPMessageContext; public class MySoapHandler implements SOAPHandler<SOAPMessageContext> { @Override public boolean handleFault(SOAPMessageContext context) { System.out.println("run handleFault method!"); return false; } /** * 先判断是否是发出去的消息，然后再在soapheader中添加消息userpassword */ @Override public boolean handleMessage(SOAPMessageContext context) { System.out.println("run handleMessage method!"); Boolean out = (Boolean)context.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY); if(out){ SOAPMessage message = context.getMessage(); try { SOAPEnvelope senv = message.getSOAPPart().getEnvelope(); SOAPHeader header = senv.getHeader(); if(header==null){ header = senv.addHeader(); } QName qname = new QName("http://ws01.com/", "userpassword","lic"); header.addChildElement(qname).setValue("123456"); message.writeTo(System.out); System.out.println(); } catch (SOAPException e) { e.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } }
//返回true表示继续执行之后的业务代码，否则停止运行业务代码 return true; } @Override public void close(MessageContext context) { System.out.println("run close method!"); } @Override public Set<QName> getHeaders() { return null; } }
使用wsimport命令或者myeclipse生成客户端代码：
修改生成的IServiceImpService.java文件,在类定义上加上下面注解：
@HandlerChain(file="handler-chain.xml")
测试类：
@Test public void test01(){ IServiceImpService service = new IServiceImpService(); IService iService = service.getIServiceImpPort(); try { iService.testException(); } catch (MyException_Exception e) { e.printStackTrace(); } }
运行结果：
run handleMessage method! <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Header><lic:userpassword xmlns:lic="http://ws01.com/">123456</lic:userpassword></S:Header><S:Body><ns2:testException xmlns:ns2="http://ws01.com/"/></S:Body></S:Envelope> run handleFault method! run close method! com.ws03.MyException_Exception: test exception
.....................
二、服务器端获取soapheader消息
编写服务端handler的java文件，并配置。
ServiceSoapHandler.java
package com.ws01; import java.util.Set; import javax.xml.namespace.QName; import javax.xml.soap.SOAPException; import javax.xml.soap.SOAPHeader; import javax.xml.soap.SOAPMessage; import javax.xml.ws.handler.MessageContext; import javax.xml.ws.handler.soap.SOAPHandler; import javax.xml.ws.handler.soap.SOAPMessageContext; import org.w3c.dom.Node; public class ServiceSoapHandler implements SOAPHandler<SOAPMessageContext> { /** * 如果客户端的saopheader为空或者密码不能123456则直接停止运行业务代码 */ @Override public boolean handleMessage(SOAPMessageContext context) { Boolean out = (Boolean)context.get(SOAPMessageContext.MESSAGE_OUTBOUND_PROPERTY); if(!out){ SOAPMessage message = context.getMessage(); try { SOAPHeader header = message.getSOAPPart().getEnvelope().getHeader(); if(header != null){ Node node = header.getElementsByTagName("lic:userpassword").item(0); String password = node.getTextContent(); System.out.println("client send password:"+password); if(!"123456".equals(password)) return false; }else{ return false; } } catch (SOAPException e) { e.printStackTrace(); } } return true; } @Override public Set<QName> getHeaders() { // TODO Auto-generated method stub return null; } @Override public void close(MessageContext context) { // TODO Auto-generated method stub } @Override public boolean handleFault(SOAPMessageContext context) { // TODO Auto-generated method stub return false; } }
IServiceImp.java
package com.ws01; import javax.jws.HandlerChain; import javax.jws.WebService; @WebService(endpointInterface="com.ws01.IService") @HandlerChain(file="service-handler-chain.xml") public class IServiceImp implements IService { @Override public void testException() throws MyException { throw new MyException("test exception"); //throw new RuntimeException("service runtime Exception"); } }
service-handler-chain.xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <javaee:handler-chains xmlns:javaee="http://java.sun.com/xml/ns/javaee" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <javaee:handler-chain> <javaee:handler> <javaee:handler-class>com.ws01.ServiceSoapHandler</javaee:handler-class> </javaee:handler> </javaee:handler-chain> </javaee:handler-chains>
