CXF发布WebService总结

一、概念

1、什么是webservice

Web service是一个平台独立的，低耦合的，自包含的、基于可编程的web的应用程序，可使用开放的XML标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序。

2、wsdl

网络服务描述语言是一个用来描述Web服务和说明如何与Web服务通信的XML（标准通用标记语言的子集）语言。为用户提供详细的接口说明书。

3、soap

简单对象访问协议是交换数据的一种协议规范，是一种轻量的、简单的、基于XML（标准通用标记语言下的一个子集）的协议，它被设计成在WEB上交换结构化的和固化的信息。

4、JAX-WS

一种 Java 规范，名为 JAX-WS（JSR-224），全称 Java API for XML-Based Web Services，可以将规范理解为官方定义的一系列接口。

5、JAX-RS

为了让 WS 的开发与使用变得更加简单、更加轻量级，于是出现了另一种风格的 WS，名为 JAX-RS（JSR-339），全称 Java API for RESTful Web Services，同样也是一种规范，同样也有若干实现，cxf是其中比较著名的一种。

二、使用cxf发布基于soap的webservice

1、cxf与webservice的关系

刚入行的时候一直把cxf当做webservice，其实cxf只是发布调用webservice的工具而已。

2、最低maven配置

由于webservice有基于soap的实现和rest的实现，这使得cxf的maven配置比较混乱。

<!-- cxf config begin -->
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-frontend-jaxws</artifactId>
<version>2.7.3</version>
</dependency>
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-transports-http-jetty</artifactId>
<version>2.7.3</version>
</dependency>
<!-- cxf config end -->

从某种程度上说webservice发布与调用只需要添加以上两个依赖即可，但为了实现json转换我们还需要jackson相关依赖。

<!-- JSON begin -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>${jackson.version}</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>${jackson.version}</version>
</dependency>

<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>${jackson.version}</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.module</groupId>
<artifactId>jackson-module-jaxb-annotations</artifactId>
<version>${jackson.version}</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.jaxrs</groupId>
<artifactId>jackson-jaxrs-json-provider</artifactId>
<version>${jackson.version}</version>
<!-- Jackson2.2.0 版本对于 CXF2.7.3 不支持 -->
<!-- http://www.marshut.com/krrqx/fasterxml-jackson-2-2-provider-no-longer-works-with-cxf-jax-rs.pdf -->
<!-- http://cxf.547215.n5.nabble.com/Creating-input-values-on-WADL-td5728910.html -->
</dependency>

<!-- Spring WebMVC 3.1.2 用到 -->
<dependency>
<groupId>org.codehaus.jackson</groupId>
<artifactId>jackson-mapper-asl</artifactId>
<version>1.9.0</version>
</dependency>
<dependency>
<groupId>org.codehaus.jackson</groupId>
<artifactId>jackson-core-asl</artifactId>
<version>1.9.0</version>
</dependency>

<!-- JSON end -->

后面两个依赖视你的spring版本情况而定。

3、webservice接口

package com.winssage.winssagebpm.application;

import javax.jws.WebService;

import com.winssage.winssagebpm.baseapplication.IBaseApplication;
import com.winsssage.winssagebpm.domain.User;

@WebService
public interface UserApplication extends IBaseApplication<User> {
public String sayHello( String name);
}

4、接口实现

package com.winssage.winssagebpm.applicationImpl;

import javax.inject.Named;
import javax.jws.WebService;

import org.springframework.transaction.annotation.Transactional;

import com.winssage.winssagebpm.application.UserApplication;
import com.winssage.winssagebpm.baseapplicationImpl.BaseApplicationImpl;
import com.winsssage.winssagebpm.domain.User;

@WebService(endpointInterface = "com.winssage.winssagebpm.application.UserApplication")
@Named("userApplication")
@Transactional
public class UserApplicationImpl extends BaseApplicationImpl<User> implements
UserApplication {

public String sayHello(String name) {
name = "hello" + name;
return name;
}

}

5、spring整合cxf 

#userApplication为实现中注解进来的bean.

<?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:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx" xmlns:jee="http://www.springframework.org/schema/jee"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-2.5.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.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-servlet.xml" />
<jaxws:endpoint id="security" implementor="#userApplication"
address="/user" />
</beans>

6、客户端调用已发布的webservice

<bean id="userServiceClient" class="com.winssage.winssagebpm.application.UserApplication"
factory-bean="userServiceClientFactory" factory-method="create"/>

<bean id="userServiceClientFactory" class="org.apache.cxf.jaxws.JaxWsProxyFactoryBean">
<property name="serviceClass" value="com.winssage.winssagebpm.application.UserApplication"/>
<property name="address">
<value>http://localhost:9080/winssagebpm-web/api/user</value>
</property>
</bean>

7、查看已发布的webservice

三、使用cxf发布基于REST的webservice

详见http://my.oschina.net/fengshuzi/blog/280408

四、总结