使用CXF发布WebService服务简单实例

一、说明：

前面介绍了使用axis2来发布Webservice服务，现在介绍一种更popular，更高效的Webservice服务发布技术：CXF

Apache CXF = Celtix + XFire，Apache CXF 的前身叫 Apache CeltiXfire，现在已经正式更名为 Apache CXF 了，以下简称为 CXF。CXF 继承了 Celtix 和 XFire 两大开源项目的精华，提供了对 JAX-WS 全面的支持，并且提供了多种 Binding 、DataBinding、Transport 以及各种 Format 的支持，并且可以根据实际项目的需要，采用代码优先（Code First）或者 WSDL 优先（WSDL First）来轻松地实现 Web Services 的发布和使用。目前它仍只是 Apache 的一个孵化项目。

Apache CXF 是一个开源的 Services 框架，CXF 帮助您利用 Frontend 编程 API 来构建和开发 Services ，像 JAX-WS 。这些 Services 可以支持多种协议，比如：SOAP、XML/HTTP、RESTful HTTP 或者 CORBA ，并且可以在多种传输协议上运行，比如：HTTP、JMS 或者 JBI，CXF 大大简化了 Services 的创建，同时它继承了 XFire 传统，一样可以天然地和 Spring 进行无缝集成。

CXF 框架是一种基于 Servlet 技术的 SOA 应用开发框架，要正常运行基于 CXF 应用框架开发的企业应用，除了 CXF 框架本身之外，还需要 JDK 和 Servlet 容器的支持。

二、利用CXF进行简单webservice服务的发布与调用

①.  新建一个Java Project  ，CXFDemo ，并在工程下新建lib文件夹，加入CXF的jar包：

cxf-core-3.1.4.jar
jaxb-core-2.2.11.jar
jaxb-impl-2.2.11.jar
neethi-3.0.3.jar
wsdl4j-1.6.3.jar
xmlschema-core-2.2.1.jar

然后build path ，将架包加入到类路径下。

②.  在src下，新建3个package ，并分别在各个包下创建对应的相关接口和类：

com.elgin.cxf.entities
com.elgin.cxf.service
com.elgin.cxf.service.impl

❶、在service包下新建接口  HelloService

package com.elgin.cxf.service;

import javax.jws.WebParam;
import javax.jws.WebService;

import com.elgin.cxf.entities.User;

@WebService
public interface HelloService {

	public String sayHello(@WebParam(name="text")String text);

	public String sayHellloToUser(User user);
}

❷、在service.impl 包下新建接口的实现类 HelloServiceImpl

package com.elgin.cxf.service.impl;

import javax.jws.WebService;

import com.elgin.cxf.entities.User;
import com.elgin.cxf.service.HelloService;

@WebService(endpointInterface="com.elgin.cxf.service.HelloService",serviceName="HelloService")
public class HelloServiceImpl implements HelloService {

	@Override
	public String sayHello(String text) {
		System.out.println("param text is :" + text);
		return "hello " + text;
	}

	@Override
	public String sayHellloToUser(User user) {
		System.out.println("param user is :" +user);
		return "hello " + user.getName();
	}

}

❸、entities包下新建用到的User类：

package com.elgin.cxf.entities;

public class User {
    private String name;

	public String getName() {
		return name;
	}

	public void setName(String name) {
		this.name = name;
	}

	public User(){}

	public User(String name) {
		super();
		this.name = name;
	}

	@Override
	public String toString() {
		return "User [name=" + name + "]";
	}

}

③.  新建package  ：com.elgin.cxf.publish

并在此包下新建类： Server  用来发布webservice服务：

package com.elgin.cxf.publish;

import javax.xml.ws.Endpoint;

import com.elgin.cxf.service.impl.HelloServiceImpl;

public class Server {
	   public static void main(String[] args) {
		System.out.println("cxf service start..");
		HelloServiceImpl serviceImpl=new HelloServiceImpl();
		String address="http://localhost:8080/service/hello";
		Endpoint.publish(address, serviceImpl);
	   }
}

④  运行查看发布情况：

在浏览器输入：http://localhost:8080/service/hello?wsdl ，出现下图所示数据，表示发布webservice服务成功

⑤ 服务调用代码以及结果：

package com.elgin.cxf.client;

import java.net.URL;

import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import javax.xml.ws.soap.SOAPBinding;

import com.elgin.cxf.entities.User;
import com.elgin.cxf.service.HelloService;

public class Client {
	private static final QName SERVICE_NAME
    = new QName("http://impl.service.cxf.elgin.com/", "HelloService");
    private static final QName PORT_NAME
    = new QName("http://impl.service.cxf.elgin.com/", "HelloServicePort");

	private Client() {} 

	public static void main(String args[]) throws Exception {
	     rightInvoker();
	     exceptionInvoker();
	}

   /*
	* @Title: rightInvoker
	* @Description: 可成功调用，返回正确的结果
	* @throws Exception    参数
	*/
	public static void rightInvoker() throws Exception  {
		// Endpoint Address
	    String endpointAddress = "http://localhost:8080/service/hello";
	    URL url=new URL(endpointAddress);
	    Service service = Service.create(url,SERVICE_NAME);

	    HelloService hs = service.getPort(HelloService.class);
	    System.out.println(hs.sayHello("World"));

	    User user = new User("Jack");
	    System.out.println(hs.sayHellloToUser(user));
	}

   /*
	* @Title: exceptionInvoker
	* @Description: 调用时出现异常错误信息：
	*
	* Exception in thread "main" javax.xml.ws.WebServiceException:
	* WSDL Metadata not available to create the proxy,
	* either Service instance or ServiceEndpointInterface com.elgin.cxf.service.HelloService should have WSDL information
	*
	* 对于造成上述异常的具体原因尚不明确，很有可能是缺少CXF某个jar包引起
	*/
	public static void exceptionInvoker(){
		// Endpoint Address
		Service service = Service.create(SERVICE_NAME);
	    String endpointAddress = "http://localhost:8080/service/hello";
	    service.addPort(PORT_NAME, SOAPBinding.SOAP11HTTP_BINDING, endpointAddress);
	    HelloService hs = service.getPort(HelloService.class);
	    System.out.println(hs.sayHello("World"));

	    User user = new User("Jack");
	    System.out.println(hs.sayHellloToUser(user));
	}
}

正确运行结果：

hello World
hello Jack