RESTful架構思想

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>  







發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章