记录apache-cxf-3.0.4编写web服务的过程

本篇也算现学现卖，但是网上很多文章都所述不详，所以有了本篇

1、下载并解压apache-cxf-3.0.4.zip；

2、建立动态web项目CXFWebService，引入jar包如下：（除了log4j和commons-logging，其它都在解压后的apache-cxf-3.0.4\lib目录中可以找到）

commons-logging-1.1.3.jar
cxf-core-3.0.4.jar
log4j-1.2.13.jar
neethi-3.0.3.jar
spring-aop-3.2.6.RELEASE.jar
spring-beans-3.2.6.RELEASE.jar
spring-context-3.2.6.RELEASE.jar
spring-core-3.2.6.RELEASE.jar
spring-expression-3.2.6.RELEASE.jar
spring-web-3.2.6.RELEASE.jar
wsdl4j-1.6.3.jar
xmlschema-core-2.2.1.jar
aopalliance-1.0.jar
asm-3.3.1.jar
cxf-rt-bindings-soap-3.0.4.jar
cxf-rt-bindings-xml-3.0.4.jar
cxf-rt-databinding-jaxb-3.0.4.jar
cxf-rt-frontend-jaxws-3.0.4.jar
cxf-rt-frontend-simple-3.0.4.jar
cxf-rt-transports-http-3.0.4.jar
cxf-rt-ws-addr-3.0.4.jar
cxf-rt-ws-policy-3.0.4.jar
cxf-rt-wsdl-3.0.4.jar
geronimo-jaxws_2.2_spec-1.2.jar
jaxb-api-2.2.11.jar
jaxb-core-2.2.11.jar
jaxb-impl-2.2.11.jar
jcl-over-slf4j-1.7.9.jar
slf4j-api-1.7.9.jar
slf4j-jdk14-1.7.9.jar
stax2-api-3.1.4.jar
woodstox-core-asl-4.4.1.jar

这里走了不少弯路，网上各种低版本的文章和奇怪的配置，最终在apache-cxf-3.0.4\lib目录下找到了WHICH_JARS（官方正解）

引用要点：

The following jars are required for all CXF usage:
- cxf-core.jar
- geronimo-javamail.jar (Or the Sun equivalent) [6]
(MAY be able to remove javamail if you don't use any MIME/MTOM/SAAJ type things)
- jaxb-api.jar  [6]
- jaxb-core.jar  [6]
- jaxb-impl.jar (this is a [6] for normal runtime, but is required for
tooling and the dynamic clients)
- xmlschema-core.jar
- woodstox-core-asl.jar
- stax2-api.jar
- slf4j-*.jar
- jcl-over-slf4j.jar

For JAX-WS support:
- neethi.jar
- wsdl4j.jar
- geronimo-jaxws_2.2_spec-1.0.jar (Or the Sun equivalent) [6]
- saaj-api.jar [6]
- saaj-impl.jar [6]
- asm.jar (semi-optional, helps with performance of wrapper types and is
required when adding JAXB annotations onto the SEI methods and
parameters.)
- cxf-rt-ws-addr.jar
- cxf-rt-ws-policy.jar
- cxf-rt-frontend-simple.jar
- cxf-rt-frontend-jaxws.jar
- cxf-rt-bindings-xml.jar
- cxf-rt-bindings-soap.jar
- cxf-rt-databinding-jaxb.jar
- cxf-rt-wsdl.jar
- cxf-rt-transports-http.jar (or other transport jar)

For XML Configuration support:
- aopalliance.jar
- spring-beans.jar
- spring-context.jar
- spring-core.jar

For hosting web services within WARs while using Spring-based CXFServlet:
- spring-web.jar

3、新建包、类、配置文件如下结构



web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">

<!-- 加载Spring容器配置 -->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!-- 设置Spring容器加载配置文件路径 -->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath*:applicationContext-server.xml</param-value>
</context-param>

<listener>
<listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
</listener>

<servlet>
<servlet-name>CXFService</servlet-name>
<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>CXFService</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
</web-app>

applicationContext-server.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:jaxws="http://cxf.apache.org/jaxws" 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-3.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd"> <import resource="classpath:META-INF/cxf/cxf.xml" />
<!--
<import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
-->
<import resource="classpath:META-INF/cxf/cxf-servlet.xml" />

<bean id="inMessageInterceptor" class="org.apache.cxf.interceptor.LoggingInInterceptor"/>
<bean id="outLoggingInterceptor" class="org.apache.cxf.interceptor.LoggingOutInterceptor" />

<bean id="userServiceBean" class="com.java.service.impl.UserServiceImpl" />
<jaxws:server id="userService" serviceClass="com.java.service.IUserService" address="/Users">
<jaxws:serviceBean>
<ref bean="userServiceBean" />
</jaxws:serviceBean>
<jaxws:inInterceptors>
<ref bean="inMessageInterceptor" />
</jaxws:inInterceptors>
<jaxws:outInterceptors>
<ref bean="outLoggingInterceptor" />
</jaxws:outInterceptors>
</jaxws:server>
</beans>

这个地方的要点就是cxf3以后似乎cxf-extension-soap.xml这个配置就没有包含在jar包里了，所以也没必要配置。

log4j.properties

### set log levels ###
log4j.rootLogger = debug,D

### \u8F93\u51FA\u5230\u63A7\u5236\u53F0 ###
log4j.appender.D = org.apache.log4j.ConsoleAppender
log4j.appender.D.Target = System.out
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern =  %d{ABSOLUTE} %5p %c:%L - %m%n

User.java

package com.java.entity;

public class User {
private long id;
private String name;
private String address;
private String email;

public long getId() {
return id;
}

public void setId(long id) {
this.id = id;
}

public String getName() {
return name;
}

public void setName(String name) {
this.name = name;
}

public String getAddress() {
return address;
}

public void setAddress(String address) {
this.address = address;
}

public String getEmail() {
return email;
}

public void setEmail(String email) {
this.email = email;
}
}

IUserService.java

package com.java.service;

import javax.jws.WebParam;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;

import com.java.entity.User;

/**
* <b>function:</b>定制客户端请求WebService所需要的接口
*/
@WebService
@SOAPBinding(style = Style.RPC)
public interface IUserService {
public User getUserByName(@WebParam(name = "name") String name);

public void setUser(User user);
}

UserServiceImpl.java

package com.java.service.impl;

import java.util.Date;

import javax.jws.WebParam;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;

import com.java.entity.User;
import com.java.service.IUserService;

/**
* <b>function:</b> WebService传递复杂对象，如JavaBean、Array、List、Map等
*/
@WebService
@SOAPBinding(style = Style.RPC)
public class UserServiceImpl implements IUserService {
public User getUserByName(@WebParam(name = "name") String name) {
User user = new User();
user.setId(new Date().getTime());
user.setName(name);
user.setAddress("china");
user.setEmail(name + "@test.com");
return user;
}

public void setUser(User user) {
System.out.println("############Server setUser###########");
System.out.println("setUser:" + user);
}
}

至此服务端基本编写完毕，可以在tomcat中运行，

url中输入http://localhost:8080/CXFWebService/Users?wsdl可以看到下图即可证明服务端正常。



客户端

SpringUsersWsClient.java

package com.java.client;

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;

import com.java.entity.User;
import com.java.service.IUserService;

public class SpringUsersWsClient {

public static void main(String[] args) {
// 调用WebService
JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
factory.setServiceClass(IUserService.class);
factory.setAddress("http://localhost:8080/CXFWebService/Users");

IUserService service = (IUserService) factory.create();

System.out.println("#############Client getUserByName##############");
User user = service.getUserByName("hoojo");
System.out.println(user.getName());

user.setAddress("China-Guangzhou");
service.setUser(user);
}
}

基于soap的服务基本就是这样，比起原生的jax-ws如何呢？貌似原生的更简单一些= =|||

后续会介绍restfull服务的例子。