Apache CXF 实现web Service服务 入门练习

以前工作中也用CXF,但都是用别人现成搭好的环境，这次自己重头搭建一遍环境。过程中也有遇到的问题，也做了简单的整理。

对于CXF是干什么用的，我不想多说，大家都知道这是我们在java编程中webService技术的一种实现工具。我们说说为什么用CXF来实现webService：

1.      Java的webService实现本身就是一个很耗性能的实现方案（xml与java对象之间在服务端以及客户端的互转比较消耗性能）

2.      目前java主流的webService应用以CXF、AXIS2为主；

3.      通过网络渠道的了解,目前CXF的效率要比AXIS2高出至少50%；

4.      另外有一个webService的工具metro的效率比CXF高出10%；

5.      CXF的实现资料网上可以随便找出一大堆，metro的资料相对少一些；

6.      CXF在java应用实现中已经很成熟，企业更倾向于用这样一个成熟的解决方案；

基于以上原因，我选择CXF来实现webService。

一、环境搭建

新建一个java web项目 然后下载Apache cxf的工具包，解压CXF之后，把cxf工具包lib下的jar包全部放到工程的lib下。

此处用到的cxf工具包版本为：apache-cxf-2.5.2

二、开始编程

（1）.创建实体类 User.java

package com.hsy.pojo;

import java.io.Serializable;

@SuppressWarnings("serial")  
public class User implements Serializable{
	private String id;  
    private String name;  
    private String age;  
    private String description;
	public String getId() {
		return id;
	}
	public void setId(String id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public String getAge() {
		return age;
	}
	public void setAge(String age) {
		this.age = age;
	}
	public String getDescription() {
		return description;
	}
	public void setDescription(String description) {
		this.description = description;
	}  
    
    
}

（2）.编写服务接口定义类 HelloWorld.java

package com.hsy.server;

import java.util.List;

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

import com.hsy.pojo.User;

/**
 * 定义服务接口 	
 * @author LiuWenwu
 */
@WebService 
public interface HelloWorld {
	String sayHi(@WebParam(name="text")String text);  
    String sayHiToUser(User user);  
    String[] SayHiToUserList(List<User> userList);  
    
}

（3）.编写服务实现类及具体业务类

package com.hsy.server;

import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;

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

import com.hsy.pojo.User;
/**
 * 定义服务接口的实现类及实际处理业务的类
 * @author LiuWenwu
 */
@WebService(endpointInterface="com.hsy.server.HelloWorld",serviceName="HelloWorld")  
public class HelloWorldImpl implements HelloWorld {
	Map<Integer, User> users = new LinkedHashMap<Integer, User>();
	
	
	//实现接口定义的方法
	
    public String sayHi(@WebParam(name = "text") String text) {  //注解意思是给参数取别名
        return "Hello,"+text;  
    }  

    public String sayHiToUser(User user) {  
        users.put(users.size()+1, user);  
        return "Hello,"+user.getName();  
    }  

    public String[] SayHiToUserList(List<User> userList) {  
        String[] result = new String[userList.size()];  
        int i = 0;  
        for(User u:userList){  
            result[i] = "Hello " + u.getName();  
            i++;  
        }  
        return result;  
    }
    
    /*
     * 
     */
    public static void main(String[] args) {  
        // TODO Auto-generated method stub  
  
    }  
}

（5）.发布完成的服务接口

package com.hsy.server;  
  
import javax.xml.ws.Endpoint;  
  
public class webServiceApp {  
  
    /** 
     * @param args 
     */  
    public static void main(String[] args) {  
         System.out.println("web service start");  
         HelloWorldImpl implementor = new HelloWorldImpl();  
         String address = "http://localhost:8080/helloWorld";  
         Endpoint.publish(address, implementor);  
         System.out.println("web service started");  
    }  
  
}  

到这里有些人在想什么是发布接口，其实就是把你开发好的服务器类（这里可以比作方法）放入web service 服务注册中心。

打个比方就是把做好的手机（服务类）产品放入商城（web service）里面去销售等待别人来调用。

右键 run as 选择java application发布服务；然后在浏览器输入地址：http://localhost:8080/helloWorld?wsdl

出现如图及访问成功

（6）  客户端访问服务

package com.hsy.client;  
  
import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;  
  
import com.hsy.pojo.User;  
import com.hsy.server.HelloWorld;  
  
public class HelloWorldClient {  
  
    /** 
     * @param args 
     */  
    public static void main(String[] args) {  
          
        //首先右键run as 运行com.hsy.server.webServiceApp类，然后再运行这段客户端代码  
        JaxWsProxyFactoryBean jwpfb = new JaxWsProxyFactoryBean();  
        jwpfb.setServiceClass(HelloWorld.class);  
        jwpfb.setAddress("http://localhost:8080/helloWorld");  
        HelloWorld hw = (HelloWorld) jwpfb.create();  
        User user = new User();  
        user.setName("马克思");  
        user.setDescription("怀念马克思");  
        System.out.println(hw.sayHiToUser(user));  
          
    }  
  
}  

右键 run as 选择java application，控制台打印如图：

这样客户端也访问成功了。这样就完成简单的cxf 实现web service项目！