这里放出一些调用的例子：

1.get请求获得Category xml 数据。

$("#btncall").click(function (){
    $.ajax({
        url:"/restblog/services/category",
        type:"GET",
        dataType:'xml',
        success :function (data){
            var tablehtml="<table class='tableresult' border='1' bordercolor='#ccc'><tr><th>编号</th><th>名称</th></tr>";
            $("category",data).each(function (i,category){
                var id=$("id",category).text();
                var name=$("name",category).text();
                tablehtml+=("<tr><td>"+id+"</td><td>"+name+"</td></tr>");
            });
            tablehtml+="</table>";
        $(tablehtml).appendTo("#result");
        },error:function (){
            alert("get category list failed!");
    }});
});

jquery的ajax调用有一个参数dataType是期望得到的数据格式，目前版本的可选值为xml,json,html,jsonp.默认的是html。指定了该属性，jquery会自动解析数据格式。

上面的例子接受到的数据形如：

<?xml version="1.0" encoding="UTF-8"?>
   <Categories>
       <category>
           <id>1</id>
           <name>第一个分类</name>
       </category>
       <category>
           <id>2</id>
           <name>第二个分类</name>
       </category>
   </Categories>

data是一个xml对象，在没有jquery的情况下解析xml是一件很麻烦的事情。但是使用jquery，xml解析起来和html一样。

$("category",data)是查找标签名(tagName)为category节点，返回jquery对象。注意获得节点值用的是text()方法。

还得注意的地方就是url 这里的路径和请求jsp的规则是一样。

2.发送json的例子。

$("#btnAddbyjson").click(function (){
    $.ajax({
        url:"/restblog/services/category/add",
        type:"PUT",
        data:"{\"id\":1,\"name\":\"category1\"}",
        contentType:'application/json',
        success :function (result){
            alert(result);
        },error:function (){
            alert("add category failed!");
    }});
});

注意type: 通常的ajax调用都只是GET POST 这里用的是PUT，要回过神来。

contentType:与服务方法上的Consume 标注属性一样。在ajax调用的时候会在请求的Header添加{"contentType","application/json"}的键/值标明发送的数据格式是json。

即便发送的数据格式是json,但是真正的数据是以字符串的形式在网络传输的，所以data属性只是json的字符串，由服务器端解析成Category对象。这里的json字符串格式比较严格，不能适用单引号' ,这里要注意。

data属性即可以是字符串又可以是json,jquery会根据contentType解析成需要发送的格式。

下面的截图是在FireBug下看到的数据发送情况：

这张图旨在说明发送的数据不是一个键/值类型。区别与下面的例子。

3.POST的表单提交。

$("#btnAdd").click(function (){
    $.ajax({
        url:"/restblog/services/category/addbyname",
        type:"POST",
        data:{'categoryname':$("#txtName").val()},
        success :function (result){
            alert(result);
        },error:function (){
            alert("add category failed!");
    }});
});

addbyname方法的categoryname标识为@FormParam 所以用POST提交的数据被当做Form提交的数据。下面的截图说明浏览器发送的是一个标准的键/值数据

4.调用带@Context标识参数的方法

$("#btncommonProcess").click(function (){
    $.ajax({
        url:"/restblog/services/category/commonProcess",
        type:"GET",
        data:"a=b&a=e&c=d",
        success :function (result){
            alert(result);
        },error:function (){
            alert("commonProcess failed!");
    }});
});

服务端的代码见上一篇文章。

控制台上打印：

c : [d]
a : [b, e]

总结

REST Web service 不但提供了标准的调用方法，同时拥有非常简便的ajax调用。由于请求的纯数据，所以他更适合于ajax调用。而且的客户端可以跨平台，跨应用。他的优势是无可比拟的，我相信他的未来不可估量。

File=>New=>Web Service Project。

project name: restblog,选择REST(JAX-RS) 下一步。

勾选core,jaxb,client,json然后下一步。

之所以创建servlet是因为会请求一些物理不存在的URI，事实上就是这个servlet在处理这些resource。

jaxb(Java Architecture for XML Binding)可以将java class序列号成xml，请参考http://java.sun.com/developer/technicalArticles/WebServices/jaxb/

json就不多说了，这个包可以实现java class 转化成json。

点击finish完成工程创建。

这样创建的工程与通常的web工程的区别就是添加了servlet在web.xml，这里贴出servlet代码：后续的文章中也会提到他。

<servlet>
<display-name>JAX-RS REST Servlet</display-name>
<servlet-name>JAX-RS REST Servlet</servlet-name>
<servlet-class>
com.sun.jersey.spi.container.servlet.ServletContainer
</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>JAX-RS REST Servlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>

在工程的classpath下会引用下列包：

这些包可以从http://download.java.net/maven/2/com/sun/jersey/ 下载(使用maven2)

首先创建一个简单的类Category

使用@XmlRootElement标注该类

点击 图标创建webservice,选择restblog工程，Framework选择REST(JAX-RS)

Java class : CategoryService

URL path: 资源路径 填写category ,这样所有与category相关的资源都使用http://yourpath/services/category访问

LIfecycle: Pre-request(JAX-RS default)每次请求时生成一个服务类实例(这里指CategoryService),singleton:单例，只存在一个实例

Consumes: 接受的contentType 包括application/xml ,application/json 通俗来说就是接受提交数据的格式。

Produces: 产生的数据格式选项同样为applicatin/xml,application/json 等。
注意这里的Consumes/Produces是指请求http://yourpath/services/category的数据格式。

点击 Add 按钮添加服务方法，界面如下：

这是一个构造服务方法的界面，下面有代码预览。在添加参数的时候，选择Param Type选项的意义：

Context: 这是一个标识该参数为请求上下文。可以直接获得request的参数。

QueryParam:uri?之后的参数

PathParam:uri中的参数如：/category/{id}中的id就是PathParam

FormParam:使用post提交的参数。

CookieParam: Cookie参数。

HeaderParam: 请求的头部信息。

也许你已经注意到没有session参数，是的，所谓的"无状态stateless"多少就体现在这里，web服务不保存请求相关的信息。

综合上面的用法，下面的例子涵盖了常用的服务方法的写法，之中的处理过程暂时用硬编码。后面的文章会介绍HIbernate,Spring的应用。

你可以在CategoryService.java编辑中 右键菜单=>MyEclipse=>Add REST Method添加服务方法。

右键工程根目录restblog选择MyEclipse=>Test with RESTful WebServices Explorer 将会打开测试窗口。

浏览中的地址为:http://localhost:8080/restblog/services/application.wadl 首先/services是由servlet拦截。

如果在浏览器中浏览该地址，将得到一个xml文件。这个文件叫web service application description language。顾名思义他是一个服务描述文件。

需要说明的是当调用方法的参数为Category类型，调用时传递的是xml同时contentType设置为application/xml这样jersey会将xml转化为Category类型的对象。如果转化出错则服务调用失败，会返回错误信息。

总结

本节主要介绍在Myeclipse中创建RESTful web service project 以及测试。到目前为止，只写了两个类就轻松的实现了RESTful Web service。

参考资料：

介绍rest:http://java.sun.com/developer/technicalArticles/WebServices/restful/

介绍使用myeclipse rest 支持http://www.myeclipseide.com/documentation/quickstarts/webservices_rest/

RESTful Web Services Developer's Guidehttp://docs.sun.com/app/docs/doc/820-4867?l=zh

netbeans的restful webservice 支持：http://www.netbeans.org/kb/60/websvc/rest_zh_CN.html

什么是RESTful Web Services？

RESTful web services是表象状态传输的web服务。REST的基础是适用http创建一个简单的web服务体系架构。它为http数据传输提供了统一的接口。rest有五个关键性原则：

• 所有资源都有唯一的URI：所有的数据都在唯一的URI标识。
• 将所有的事物链接在一起：由于是URI，在任何的可能的情况下，适用链接指向被标识的事物。
• 适用标准方法：同一个资源适用不同的verb可以获得不同的结果，在接下来的例子中可以得到验证。这里的verb除了常用的GET和POST，还有PUT,DELETE。每一个动词刚好对应着数据库的基本操作：GET对应获取数据，就是查询；POST对应的更新数据UPDATE；PUT对应着insert；DELETE就对应这数据库删除。这样的定义不仅能更语义化动词，更重要的是他定义的一种标准，有了这个标准，可以跨应用，跨域，跨系统的调用。
• 资源的多重表述：资源的获取会随着请求的head而不同。
• 无状态通信：REST要求状态要么被放入资源状态中，要么保存在客户端上。换句话说，服务端不能保持除了单词请求之外的，任何与其通信的客户端的通信状态。这样做的理由一是可伸缩性，他可以使服务端的变化对客户端是不可见的。

jersey介绍

jersey是sun的RESTful web service实现。他使用jdk5的新特征anotation。其参考站点是https://jersey.dev.java.net/其他的参考资料：

rest介绍：http://www.infoq.com/cn/articles/rest-introduction

下面几个家伙就是jersey的开发者

■ Earthly Powers, by Paul Sandoz, at http://blogs.sun.com/sandoz/category/REST.
■ MarcHadley's Blog, at http://weblogs.java.net/blog/mhadley/
■ Japod's Blog, by Jakub Podlesak, at http://blogs.sun.com/japod/category/REST.

本系列索引：

使用eclipse创建restful webservice 工程。