RESTful架构思想




REST:Representational State Transfer。(资源)表现层状态转化。是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便,所以正得到越来越多网站的采用。


资源(Resources)

网络上的一个实体,或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的存在。可以用一个URI(统一资源定位符)指向它,每种资源对应一个特定的 URI 。要获取这个资源,访问它的URI就可以,因此 URI 即为每一个资源的独一无二的识别符。


表现层(Representation)

把资源具体呈现出来的形式,叫做它的表现层(Representation)。比如,文本可以用 txt 格式表现,也可以用 HTML 格式、XML 格式、JSON 格式表现,甚至可以采用二进制格式。


状态转化(State Transfer)

每发出一个请求,就代表了客户端和服务器的一次交互过程。HTTP协议,是一个无状态协议,即所有的状态都保存在服务器端。因此,如果客户端想要操作服务器,必须通过某种手段,让服务器端发生“状态转化”(State Transfer)。而这种转化是建立在表现层之上的,所以就是 “表现层状态转化”。


特点:

1.url更加简洁,将参数通过url传到服务端。

非REST的url:http://...../queryUserById?id=1

REST的url风格:http://..../queryUserById/1

2.有利于不同系统之间的资源共享,只需要遵守规范,不需要做其他的配置就能达到资源共享。


Restful具体来讲就是四种表现形式,HTTP协议中四个表示操作方式的动词:GET、POST、PUT、DELETE。


分别对应四种基本操作: 

GET用来获取资源,

POST用来新建资源,

PUT用来修改资源,

DELETE用来删除资源。


但是,form表单只支持 GET与 POST 请求,不支持DELETE、PUT,如何解决这一问题?

添加HiddenHttpMethodFilter过滤器,可以将POST请求转位PUT或DELETE。

过滤器的实现原理大致如下:检测请求参数中是否包含 _method这个参数,如果包含则获取其值,然后判断是哪种操作后继续传递。


具体步骤:

1.form表单添加隐藏域标签,name="_method",value="PUT/DELETE"。

      <form action="httpPut" method="post">
         <input type="hidden" name="_method" value="PUT"/>
         <input type="submit" value="修改"/>
     </form>      


      <form action="httpDelete" method="post">
         <input type="hidden" name="_method" value="DELETE"/>
         <input type="submit" value="修改"/>
     </form>


2.web.xml中配置HiddenHttpMethodFilter。


    <filter>
       <filter-name>HiddenHttpMethodFilter</filter-name>
       <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
   </filter>

   <filter-mapping>
       <filter-name>HiddenHttpMethodFilter</filter-name>
       <url-pattern>/*</url-pattern>
   </filter-mapping>


若使用AJAX则不需要这么复杂,下面我们通过AJAX以Restful的方式实现数据的增删改查。


1、jsp。


<%@ page language="java" contentType="text/html; charset=UTF-8"
   pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
<script type="text/javascript" src="js/jquery-1.8.3.min.js"></script>
<script type="text/javascript">
   $(function(){
       $("#get").click(function(){
           var id = $("#get_id").val();
           $.ajax({
               url:"httpGet/"+id,
               type:"get",
               dataType:"json",
               success:function(data){
                   if(data == null){
                       alert("该用户不存在");
                   }else{
                       alert(data.id+"---"+data.name+"---"+data.age);
                   }
               }
           })
       });

       $("#post").click(function(){
           var id = $("#post_id").val();
           var name = $("#post_name").val();
           var age = $("#post_age").val();
           $.ajax({
               url:"httpPost/"+id+"/"+name+"/"+age,
               type:"post",
               dataType:"json",
               success:function(data){
                   alert(data.id+"---"+data.name+"---"+data.age);
               }
           })
       });

       $("#put").click(function(){
           var id = $("#put_id").val();
           var name = $("#put_name").val();
           var age = $("#put_age").val();
           $.ajax({
               url:"httpPut/"+id+"/"+name+"/"+age,
               type:"put",
               dataType:"json",
               success:function(data){
                   alert(data.id+"---"+data.name+"---"+data.age);
               }
           })
       });

       $("#delete").click(function(){
           var id = $("#delete_id").val();
           $.ajax({
               url:"httpDelete/"+id,
               type:"delete",
               dataType:"text",
               success:function(data){
                   alert(data);
               }
           })
       });
   })
</script>
</head>
<body>
   POST:<br/>
   编号:<input type="text" id="post_id"/><br/>
   姓名:<input type="text" id="post_name"/><br/>
   年龄:<input type="text" id="post_age"/><br/>
   <input type="button" value="提交" id="post"/>
   <hr/>
   GET:<input type="text" id="get_id"/><br/>
   <input type="button" value="获取" id="get"/>
   <hr/>
   PUT:<br/>
     编号:<input type="text" id="put_id"/><br/>
   姓名:<input type="text" id="put_name"/><br/>
   年龄:<input type="text" id="put_age"/><br/>
   <input type="button" value="修改" id="put"/>
   <hr/>
   DELETE:
   <input type="text" id="delete_id"/><br/>
   <input type="button" value="删除" id="delete"/>
</body>
</html>


2、Student实体类。


public class Student {
   private int id;
   private String name;
   private int age;

   public int getAge() {
       return age;
   }
   public void setAge(int age) {
       this.age = age;
   }
   public int getId() {
       return id;
   }
   public void setId(int id) {
       this.id = id;
   }
   public String getName() {
       return name;
   }
   public void setName(String name) {
       this.name = name;
   }
   @Override
   public String toString() {
       return "Student [id=" + id + ", name=" + name + ", age=" + age + "]";
   }
   public Student(int id, String name, int age) {
       super();
       this.id = id;
       this.name = name;
       this.age = age;
   }
   public Student() {
       super();
   }

}


3、Handler。


@Controller
public class RestfulHandler {

   private static Map<Integer,Student> students;

   static{
       students = new HashMap<Integer,Student>();
       students.put(1, new Student(1,"zhangsan",22));
   }

   @RequestMapping(value="/httpGet/{id}",method=RequestMethod.GET)
   @ResponseBody
   public Student httpGet(@PathVariable(value="id")int id){
       return students.get(id);
   }

   @RequestMapping(value="/httpPost/{id}/{name}/{age}",method=RequestMethod.POST)
   @ResponseBody
   public Student httpPost(@PathVariable(value="id")int id,@PathVariable(value="name")String name,@PathVariable(value="age")int age){
       Student student = new Student(id,name,age);
       students.put(student.getId(), student);
       return student;
   }

   @RequestMapping(value="/httpDelete/{id}",method=RequestMethod.DELETE)
   @ResponseBody
   public String httpDelete(@PathVariable(value="id")int id){
       students.remove(id);
       return "delete-ok";
   }

   @RequestMapping(value="/httpPut/{id}/{name}/{age}",method=RequestMethod.PUT)
   @ResponseBody
   public Student httpPut(@PathVariable(value="id")int id,@PathVariable(value="name")String name,@PathVariable(value="age")int age){
       Student student = new Student(id,name,age);
       students.put(student.getId(), student);
       return student;
   }
}


4、后台返回json数据到前端,需要在springmvc.xml添加如下配置。


   <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">  
      <property name="messageConverters">  
          <list>  
           <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"></bean>
          </list>  
      </property>  
  </bean>