基于RESTful类型的webService

RESTful是基于jax-rs的WebService.它即支持XML也支持JSON.
JAX-RS是JAVA EE6 引入的一个新技术。 JAX-RS即Java API for RESTful Web Services的简写，是一个Java 编程语言的应用程序接口，支持按照表述性状态转移（REST）架构风格创建Web服务。JAX-RS使用了Java SE5引入的Java标注来简化Web服务的客户端和服务端的开发和部署。
JAX-RS提供了一些标注将一个资源类，一个POJOJava类，封装为Web资源。标注包括：

	@Path，标注资源类或者方法的相对路径 
	@GET，@PUT，@POST，@DELETE，标注方法是HTTP请求的类型。 
	@Produces，标注返回的MIME媒体类型  xml,json
	@Consumes，标注可接受请求的MIME媒体类型 
	@PathParam，@QueryParam，@HeaderParam，@CookieParam，@MatrixParam，@FormParam,分别标注方法的参数来自于HTTP请求的不同位置，例如@PathParam来自于URL的路径，@QueryParam来自于URL的查询参数，@HeaderParam来自于HTTP请求的头信息，@CookieParam来自于HTTP请求的Cookie。

RESTful的webService包括以下步骤：
第一步：添加jsr311.jar(支持JSR)文件 和jettison-1.3.jar（解析JSON）。此文件是jdk1.6提供的新支持包。支持json格式的WebService. 必须。
第二步：必须 － 创建一个JavaBean.并添加@XmlRootElement注解。
第三步：必须 － 创建一个服务类，并使用@Path等注解进行标注。
第四步：使用JaxRsServerFactoryBean发布WebService. 必须。
可以给JaxRsServerFactoryBean添加消息拦截器 – 可选。
发布成功以后，可以输入以下地址访问XML描述文件，注意此描述文件不能生成本地代码。
http://localhost:9005/users?_wadl&_type=xml
注意上面的参数是：_wadl 而不是wsdl
第五步：客户端使用HttpClient进行调用。
第六步：或是客户端使用Ajax调用。

代码示例：

package com.cxf.my;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;

import org.apache.cxf.jaxrs.JAXRSServerFactoryBean;

import com.cxf.bean.User;

@Path(value="/rs")
@Produces(value={"application/xml","application/json"})
public class Restful {
	
	@GET
	@Path(value="/say/{name}")  //http://http://127.0.0.1:8080/rs/say/hello
	public User say(@PathParam("name")String nm){
		System.err.println("Hello...."+nm);
		User u = new User();
		u.setName("你好:"+nm);
		u.setAge(99);
		return u;
	}
	
	public static void main(String[] args) {
		//RESTful的请求
		JAXRSServerFactoryBean bean = new JAXRSServerFactoryBean();
		bean.setAddress("http://127.0.0.1:8080");
		bean.setServiceBean(new Restful());
		bean.create();
	}
	

}

如果需要返回值，必须是一个JavaBean，且必须是添加了@XmlRootElement注解的，否则不能正常解析

package com.cxf.bean;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name="user")
public class User {
	private String name;
	private Integer age;
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public Integer getAge() {
		return age;
	}
	public void setAge(Integer age) {
		this.age = age;
	}
	@Override
	public String toString() {
		return "User [name=" + name + ", age=" + age + "]";
	}
}

运行结果：
查看wsdl

发送请求：