使用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 -->
<!-- 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
四、总结
来自:http://my.oschina.net/fengshuzi/blog/305031