CXF使用笔记
第一次用CXF的服务端,写个简单的笔记。
●一、引用的包
直接上maven的pom,里面嵌套引用了好多jar,看起来不是那么爽。
<dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-frontend-jaxws</artifactId> <version>2.6.0</version></dependency><dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-transports-http</artifactId> <version>2.6.0</version></dependency>
●二、写个简单的服务类(不写接口,懒。。)。没什么特别的,只有一个@WebService注解。
@WebServicepublic class TestService{ public String doSomething(String msg){ System.out.println("有人来访问了,消息:" + msg); return "谢谢惠顾,您的消息是:" + msg; }}●三、在Spring中配置服务(习惯使用spring了,这里不包括spring的其它配置)
<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p" xmlns:jaxws="http://cxf.apache.org/jaxws" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd"> <description>WebService配置</description> <jaxws:endpoint implementor="TestService" address="/test"/></beans>
●四、在web.xml中配置CXF的Servlet。(这里不包括spring的配置)
这里把servlet的路径配置成http://host:port/app/ws
<servlet> <servlet-name>CXFServlet</servlet-name> <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>CXFServlet</servlet-name> <url-pattern>/ws/*</url-pattern> </servlet-mapping>
服务端完成。简单吧。
启动tomcat,访问http://host:port/app/ws,应该看到一个“Available SOAP services”的列表。如果不行,自己看看异常找找原因。。。
●五、用客户端来访问刚才的服务。还是用CXF,其它的不会用。先用CXF提供的wsdl2java工具(在CXF的bin目录下)生成客户端的代码。假设这些代码放在包test中,暂时存放于d:盘中。
CXF主目录/bin/wsdl2java -p test -d d: http://host:port/app/ws/test?wsdl
回车,稍等,在d:盘中生成了一个test目录,里面有几个类,有用的是以下四个:
TestService.javaDoSomething.javaDoSomethingResponse.javaObjectFactory.java
将这些类复制到客户端工程的test包下。
●六、在客户端配置spring(还是spring...)。
这个配置文件叫client-beans.xml。里面的内容应该能猜懂。
<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd"> <bean id="client" factory-method="create"/> <bean id="clientFactory" value="test.TestService"/> <!-- 这个类是刚才生成的 --> <property name="address" value="http://host:port/app/ws/test"/> <!-- 这个路径是服务器端配置的 --></bean></beans>
●七、编写客户端代码。在这之前应该像服务端那样引入了spring和cxf相关的包。
这些代码很明了,解释是多余的。难怪会喜欢用sping。
public class ClientTest {public static void main(String args[]) throws Exception { ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(new String[] {"client-beans.xml"}); TestService client = context.getBean(TestService.class); String res = client.doSomething("Hi, boy. I come!"); System.out.println(res); System.exit(0); }}分别看看服务端和客户端的输出,体验一下两者大概是怎样交互的。
●八、以上已告一段落。下面要添加一点安全性,用最简单的“用户名-密码”方式。当然要先处理服务端。首先要引用两组新的依赖库:
<!-- WSS4J --><dependency> <groupId>org.apache.ws.security</groupId> <artifactId>wss4j</artifactId> <version>1.6.5</version> <scope>runtime</scope></dependency><dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-ws-security</artifactId> <version>2.6.0</version></dependency>
●九、写一个验证用户名和密码的类
写最简单的,能表现出原理就行。类起名为PasswordCallback。假定提供的用户名是"user123",密码是"pwd123"。
import javax.security.auth.callback.Callback;import javax.security.auth.callback.CallbackHandler;public class PasswordCallback implements CallbackHandler {@Overridepublic void handle(Callback[] callbacks) throws Exception{for (Callback cb : callbacks){WSPasswordCallback pc = (WSPasswordCallback)cb; if ("user123".equals(pc.getIdentifier())){ pc.setPassword("pwd123"); }}}}●十、修改spring中的配置,加入拦截器
原本是这样的
<jaxws:endpoint implementor="TestService" address="/test"/>
修改后是
<jaxws:endpoint implementor="TestService" address="/test"><jaxws:inInterceptors><ref bean="wss4JInInterceptor"/></jaxws:inInterceptors></jaxws:endpoint><bean id="wss4JInInterceptor" value="UsernameToken"/><entry key="passwordType" value="PasswordDigest"/><entry key="passwordCallbackRef"><bean name="code">public class ClientPasswordCallback implements CallbackHandler {@Overridepublic void handle(Callback[] callbacks) throws Exception{for (Callback cb : callbacks){WSPasswordCallback pc = (WSPasswordCallback)cb; pc.setPassword("pwd123");}}}很简单,就直接将密码设置为pwd123而已。当然只是演示时才这样。至于用户名,是在配置文件中设置。
●十二、修改客户端的spring配置文件
定义一个拦截器,当然与服务端的WSS4JInInterceptor不同,客户端的拦截器是WSS4JOutInterceptor。
<bean id="wss4JOutInterceptor" value="UsernameToken" /> <!-- 要和服务端的配置一致 --><entry key="passwordType" value="PasswordDigest" /> <!-- 要和服务端的配置一致 --><entry key="user" value="user123" /> <!-- 用户名在这里设置 --><entry key="passwordCallbackRef"><bean name="code"><bean id="clientFactory" value="test.TestService"/><property name="address" value="http://host:port/app/ws/test"/><property name="outInterceptors"><list><ref bean="wss4JOutInterceptor"/></list></property></bean>
OK,配置完毕。看起来有点麻烦,其实也不算太复杂,对吧。
●十三、再次运行客户端代码,应该又可以看到正常的结果了。如果不行,自己看看异常找找原因。。。
有一个问题,如果客户端不用CXF,而是用Axis或其它,应该怎样通过安全验证呢,没试过。