CXF框架实现webservice教程

1 使用 CXF 实现一个简单的 WEB SERVICE

首先介绍如何用 CXF 实现一个基本的 hello world

首先到 apache 官网去下载 CXF 的开发 jar 包

创建 cxf webservice 服务器端普通 java 项目，叫做 HelloCxfServer，把必须用到的 jar 文件通过构建路径引入，为了省事，可以直接把所有的 jar 引入

此处注意：如果是 jdk1.6 启动服务器会发生如下错误

JAXB 2.1 API is being loaded from the bootstrap classloader, but this RI (from

jar:file:/E:/javaLib/cxf_all_jar/jaxb‐impl‐2.2.1.1.jar!/com/sun/xml/bind/v2/model/impl/ModelBuilder.class)

needs 2.2 API. Use the endorsed directory mechanism to place jaxb‐api.jar in the bootstrap classloader.

这是由于 jdk1.6 的 jar 包和 cxf 的 jar 包冲突造成的，需要把 cxf lib 中的 endorsed 目录拷入到 D:\Program Files\Java\jdk1.6.0\jre\lib 目录下创建一个接口 HelloWorld 和一个实现类 HelloWorldImpl，只提供一个成员方法，叫做 sayHello，给接口和实现类添加注解@WebService，这是最基本的注解

/test/HellWorld.java 源码
package test;
import javax.jws.WebService;
@WebService
public interface HelloWorld {
String sayHello(String name);
}
/test/HelloWorldImpl.java 源码
package test;
import javax.jws.WebService;
@WebService
public class HelloWorldImpl implements HelloWorld {
@Override
public String sayHello(String name) {
System.out.println("sayHello方法被调用...");
return "hello," + name;
} 
} 

CXF 自带了一个 Web Service 容器 Jetty，这是一个 WEB 容器，类似于 tomcat，能够直接发布 web service，下面创建一个发布服务类 MainServer，执行这个类就会运行服务器，看到控制台输出日志信息，表示启动服务成功

/test/MainServier.java 源码
package test;
import org.apache.cxf.endpoint.Server;
import org.apache.cxf.jaxws.JaxWsServerFactoryBean;
public class MainServer {
public static void main(String[] args) {
//创建一个JaxWs服务器工厂
JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean();
//设置发布类
factory.setServiceClass(HelloWorldImpl.class);
//设置服务发布的地址
factory.setAddress("http://localhost:6666/MyCxfService");
//根据设置创建一个服务器
Server server = factory.create();
//启动服务器
server.start();
} 
}

发布成功以后，可以通过浏览器去查看生成的 WSDL，在浏览器地址栏输入 http://localhost:6666/MyCxfService?wsdl ，效果如下：

下面创建访问 WebService 的客户端，可以重新创建一个项目，也可以就在这个项目里实现，我下面在同一个项目中创建一个类 HelloWorldCient

/test/HelloWorldClient.java 源码
package test;
import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;
import org.springframework.remoting.jaxws.JaxWsPortProxyFactoryBean;
public class HelloWorldClient {
public static void main(String[] args) {
//创建一个JaxWs的代理工厂
JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
//设置访问地址
factory.setAddress("http://localhost:6666/MyCxfService");
//设置接口类型
factory.setServiceClass(HelloWorld.class);
//获得代理类实例
HelloWorld helloWorld = (HelloWorld) factory.create();
//调用方法
String str = helloWorld.sayHello("张三");
System.out.println(str);
} 
}

运行客户端，会看到控制台，输出:hello,张三

2 WSDL 结构分析

主要通过上一章生成的 WSDL，来对 WSDL 语言的标签进行解释Web Services Description Language 的缩写，是一个用来描述 Web 服务和说明如何与 Web 服务通信的 XML语言。为用户提供详细的接口说明书。查看刚才生成的 WSDL，可以分析出以下的知识点：

wsdl:definitions：根标签

属性 name="HelloWorldImplService"：服务名称设置，HelloWorldImplService 系统自动按照类名生成的，

当然这个名字可以通过注解设置进行自定义

属性 targetNamespace="http://test/" ：名称空间设置，默认会用反写包名作为名称空间，例如，包名是

com.icss.test，那么名称空间就是 http://test.icss.com/，通过注解设置也可以自定义

wsdl:types 元素: 使用某种语法（如 XML 模式）的数据类型定义（string、int），描述了接口中方法的参

数（输入参数）和返回值（输出参数）名称和类型

可以通过注解来给输入参数的名字和输出参数的名字进行自定义，默认是输出参数是 return 和第一个输

入参数是 arg0，被修改为 sayHelloResult 和 name

@WebService

public interface HelloWorld {

@WebResult(name="sayHelloResult")String sayHello(@WebParam(name="name")String name);

}

wsdl:message 元素：描述要传递的数据，web service 是把请求和响应都包装成一个 message 来传递，客户端把请求封装成 message 传递给服务器，而服务器把响应封装成 message 发送回客户端part 元素：消息参数

wsdl:portType/ Interface 元素：一个或多个端点支持的操作的抽象集。此名称已更改，因此可能会遇到两者中的任何一个。这个元素其实就是对应我们的接口。接口中的每一个方法被映射为一个 Operation元素

wsdl:binding 元素：特定端口类型的具体协议和数据格式规范，设置协议，一般都是 soap 协议

wsdl:service 元素：一个接口就是一个 portType，如果我们有很多接口，那么就组成一个 service，包含很多访问地址

【下载地址】

百度网盘链接：https://pan.baidu.com/s/1fXCkqeO8kMr1kbeewfh_EA

提取码：eb25