webservice学习之使用Apache CXF和spring搭建webservice

1. websrvice概述：

（1）webservice的出现可以解决不同平台、不同语言所编写的应用之间相互调用的问题。

（2）webservice不是框架，甚至不是一种技术，而是一种跨平台、跨语言的规范。

2.webservice解决三个问题：

   (1)远程调用

   (2)跨平台调用

   (3)跨语言调用

3.实际用途

  (1)同一个公司新旧系统整合

  (2)不同公司的业务整合。比如不同电商调用快递公司的订单查询系统

  (3)内容聚合 。比如一个应用需要提供天气预报、股票查询、黄金行情等等，需要内容聚合，调用到两不同平台、不同语言开发的应用方法。

4.CXF。apache基金会的一个开源项目，可以说是SOA框架。

5.webservice的开发：

(1)引入spring与cxf需要的jar包：

(2) 每个webservice组件需要两个部分：接口和实现类.所以建立 一个webservice业务接口，使用@WebService注解。

package demo.spring.service;

import javax.jws.WebService;


@WebService
public interface HelloWorld {
	String sayHi(String text);
}

(3) 定义一个webservice的实现类，实现第二步中定义的接口，也是使用@WebService修饰，但需要指定属性，一般是两个：

endpointInterface:当前实现类实现的接口，

serviceName:业务名称，可以自行定义

package demo.spring.service;

import javax.jws.WebService;

import org.springframework.stereotype.Component;

@Component("hello")
@WebService(endpointInterface = "demo.spring.service.HelloWorld")
public class HelloWorldImpl implements HelloWorld {

	public String sayHi(String text) {
		System.out.println("sayHi called");
		return "Hello " + text;
	}
}

(4）配置spring与cxf的配置文件

这里定义两个，一个用于server，一个用于client：

cxf-servlet.xml:红色部分的配置一定要添加，用于server配置

<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jaxws="http://cxf.apache.org/jaxws"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
						http://www.springframework.org/schema/beans/spring-beans.xsd
						http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd
			           http://www.springframework.org/schema/context
			    	   http://www.springframework.org/schema/context/spring-context.xsd">


	<import resource="classpath:META-INF/cxf/cxf.xml" />
	<import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
	<context:annotation-config />
	<context:component-scan base-package="demo.spring" />

	<jaxws:endpoint id="helloWorld" implementor="#hello"
		address="/HelloWorld" />

</beans>

id:webservice的endpoint的id。

implementor:服务接口实现类，需要带“#”号，“#”号后面的字符串就是实现类的spring组件名，相当于spring的xml配置方式的bean的id。

address: 客户端配置jaxws的时候，有个addrress，其最后一个/后面的字符串就是这个address

cxf-client.xml：用于client的spring配置：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       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.xsd
							http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">

    <jaxws:client id="helloClient" serviceClass="demo.spring.service.HelloWorld" address="http://192.168.1.133:8088/CXFUseCase/services/HelloWorld" />
</beans>

serviceClass:提供service服务的接口类的全名。

address:客户端访问服务端的地址.IP地址与端口须与服务器的IP地址与端口相同

(5)将工程发布到tomcat中，启动tomcat，在浏览器中输入：

http://192.168.1.133:8088/CXFUseCase/services

看到如下界面，表示webservice发布成功：

点击图中的WSDL链接，就可以看到发布的WSDL文件了：

至此webservice服务端编写完成。

(6)webservice客户端的编写

    1. 使用工具将WSDL文件编译为java代码，编译方式有两种，一种可以操作用java的jdk自带的工具命令：wsimport:    

       wsimport -keep -p com.demo.client http://localhost:8080/Demo/services/MyService?wsdl

　　命令参数说明：

　　-d:生成客户端执行类的class文件的存放目录

　　-s:生成客户端执行类的源文件的存放目录

　　-p:定义生成类的包名

       将包名和网址替换为实际的包名和WSDL地址就能生成客户端代码，目录如下：

       

        使用apache CXF自带的wsdl2java命令也可以进行转化，前提是把cxf的bin命令的路径配置到path中才能在命令窗口中执行。如果出现转换后的

Service中有 Service(URL, QName, WebServiceFeature[]) is undefined这样的错误，原因是CXF自带的 javax.xml.service版本高过 jdk的javax.xml.service,1.6的JAX-WS版本是2.0，而CXF版本是2.2。   此时可以再wsdl2java命令后面加上参数 -frontend jaxws21，即wsdl2java -frontend jaxws21 wsdl文档路径，这样便可解决。

       2.编写测试代码：

public static void main(String []args){
        HelloWorldImplService service = new HelloWorldImplService();
        HelloWorld hw = service.getHelloWorldImplPort();
        String result = hw.sayHi("hello");
        System.out.println("result: " + result);
    }

      结果如下：

2013-4-3 15:08:13 org.apache.cxf.service.factory.ReflectionServiceFactoryBean buildServiceFromWSDL
信息: Creating Service {http://service.spring.demo/}HelloWorldImplService from WSDL: http://192.168.1.133:8088/CXFUseCase/services/HelloWorld?wsdl
result: Hello hello

自此，webservice客户端与服务端就可以使用了。