WebService入门之CXF教程

共计 2955 个字符，预计需要花费 8 分钟才能阅读完成。

1.CXF 简介

Apache CXF 是一个开源的 Service 框架，可以用于简化用户的 service 开发，基于 CXF 开发的应用可提供 SOAP、XML/HTTP、RESTFUL HTTP 或 CORBA 等服务。CXF 底层页可以使用不同的传输协议，包括 HTTP、JMS 或 JBI 等。

根据 CXF 官方的说明，CXF 包含以下特性：

支持大量的 Web Service 标准，包括 SOAP、WS-I Basic Profile、WSDL、WS-Addressing、WS-Policy、WS-ReliableMessaging 和 WS-Security。

CXF 支持大量的前端 (frontend) 编程模型。CXF 实现了标准的 JAX-WS API，它也包括一种被称为简单前端（simple frontend）的模型，这种模型无需 annotation 支持。CXF 支持 web service 的两种开发模式：①规则 (contract) 优先的开发模式，即通过编写 WSDL 来开发 web service;②代码优先的开发模式，即通过编写 java 代码来开发 webservice.    说了这么多，下面来看看如何使用 CXF。

2.CXF 下载和安装

下载并安装 CXF 步骤如下：

（1）登陆 CXF 官方站点：http://cxf.apache.org/, 下载 CXF 最新版。笔者下载的为 3.0.1 版。

（2）将下载得到的压缩包解压得到 apache-cxf-3.0.1 文件夹，进入该文件夹可以看到文件夹中包含如下所示的目录结构。

bin: 该目录下保存了 CXF 提供的一些小工具，这些工具的主要作用是完成根据 WSDL 代码生成 java 代码，以及根据 WSDL 代码生成 javascript 代码等代码生成任务。

docs: 该目录下有一个 api 子目录，其中保存了 CXF 的 API 文档。

etc: 该目录主要存放了 CXF 框架的一些杂项。

lib: 该目录存放了 CXF 的核心类库以及编译和运行所依赖的第三方类库。

licenses: 该目录下存放 CXF 以及第三方框架的授权文件。

modules: 该目录下存放 CXF 按模块打包的 jar 包。

samples: 该目录下存放了 CXF 的大量示例应用。这些应用是学习 CXF 极好的资料。

license 和 readme 等文档

（3）将解压路径下的 bin 目录添加到系统的 path 环境变量，以便操作系统能找到 bin 目录下的命令，方便以后使用 CXF 提供的小工具。

（4）为了在项目中使用 CXF 框架，需要将 lib 文件夹下的 jar 包添加到项目中。

3. 使用 CXF 开发 web service

由于是初学，这里先写一个最简单的 hello world。

（1）eclipse 下创建一个新的 java 项目 CXFTest

（2）把 CXF 解压缩目录下 bin 文件夹中的 jar 包添加到项目中

（3）在 src 目录下新建一个 package 包，命名为 test，然后新建一个接口 HelloWorld.java, 源码为：

package test;

import javax.jws.WebService;

@WebService
public interface HelloWorld
{
 public String sayHello(String name);
}

（4）在 test 包中创建 HelloWorld 接口的实现类 HelloWorldImpl, 代码为：

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);
 
 }

}

（5）创建主类 MainServer, 用来发布 webservice

package test;

import javax.xml.ws.Endpoint;

import org.apache.cxf.endpoint.Server;
import org.apache.cxf.jaxws.JaxWsServerFactoryBean;

public class MainServer
{

 public static void main(String[] args)
 {
//  // 第一种发布方式：通过 CXF 提供的 JaxWsServerFactoryBean 来发布 webservice
//  JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean();
//  factory.setServiceClass(HelloWorldImpl.class);
//  factory.setAddress(“http://localhost:8080/HelloWorld”);
// 
//  Server server = factory.create();
//  server.start();
 
  // 第二种方式，通过 JAX-WS 提供的 Endpoint 来发布 webservice
  // 首先创建 webservice 服务提供类的实例
  HelloWorldImpl implementor = new HelloWorldImpl();
  String address = “http://localhost:8080/HelloWorld”;
  Endpoint.publish(address, implementor);

 }

}

执行服务端代码，可以看到 eclipse 输出如下，说明 webservice 成功发布

在浏览器输入如下地址 http://localhost:8080/HelloWorld?wsdl，可以访问该 webservice 服务的 WSDL

（6）创建调用 webservice 的客户端代码

package test;

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;

public class HelloWorldClient
{

 public static void main(String[] args)
 {
  JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
  factory.setAddress(“http://localhost:8080/HelloWorld”);
  factory.setServiceClass(HelloWorld.class);
  HelloWorld helloWorld = (HelloWorld) factory.create();
  System.out.println(helloWorld.sayHello(“zhuwei”));

 }

}

就可以通过客户端访问 webservice 服务了。

Apache CXF 快速入门基础教程 http://www.linuxidc.com/Linux/2014-05/101383.htm

Apache CXF 实战 http://www.linuxidc.com/Linux/2012-05/59887.htm

Apache CXF 的详细介绍：请点这里
Apache CXF 的下载地址：请点这里