RESTful 的總結

来源:https://www.cnblogs.com/z-inon/archive/2018/01/12/8276645.html
-Advertisement-
Play Games

1.什麼是RESTful? REST,即Representational State Transfer的縮寫。"(資源的)表現層狀態轉化"。 2.什麼是表現層? "資源"具體呈現出來的形式,叫做它的"表現層"(Representation)。比如,文本可以用txt格式表現,也可以用HTML格式、XM ...


1.什麼是RESTful?

  REST,即Representational State Transfer的縮寫。"(資源的)表現層狀態轉化"。

2.什麼是表現層?

  "資源"具體呈現出來的形式,叫做它的"表現層"(Representation)。比如,文本可以用txt格式表現,也可以用HTML格式、XML格式、JSON格式表現,甚至可以採用二進位格式;圖片可以用JPG格式表現,也可以用PNG格式表現。

  URI(統一資源定位符)只代表資源的實體,不代表它的形式。嚴格地說,有些網址最後的".html"尾碼名是不必要的,因為這個尾碼名錶示格式,屬於"表現層"範疇,而URI應該只代表"資源"的位置。它的具體表現形式,應該在HTTP請求的頭信息中用Accept和Content-Type欄位指定,這兩個欄位才是對"表現層"的描述。

3.狀態轉換什麼意思?

  訪問一個網站,就代表了客戶端和伺服器的一個互動過程。在這個過程中,勢必涉及到數據和狀態的變化。

   互聯網通信協議HTTP協議,是一個無狀態協議。這意味著,所有的狀態都保存在伺服器端。因此,如果客戶端想要操作伺服器,必須通過某種手段,讓伺服器端發生"狀態轉化"(State Transfer)。而這種轉化是建立在表現層之上的,所以就是"表現層狀態轉化"。

  客戶端用到的手段,只能是HTTP協議。具體來說,就是HTTP協議裡面,四個表示操作方式的動詞:GET、POST、PUT、DELETE。它們分別對應四種基本操作:GET用來獲取資源,POST用來新建資源(也可以用於更新資源),PUT用來更新資源,DELETE用來刪除資源。

  還有幾個不常見的基本操作:PATCH(UPDATE):在伺服器更新資源(客戶端提供改變的屬性)、HEAD:獲取資源的元數據、OPTIONS:獲取信息,關於資源的哪些屬性是客戶端可以改變的。

  舉例:

  • GET /zoos:列出所有動物園
  • POST /zoos:新建一個動物園
  • GET /zoos/ID:獲取某個指定動物園的信息
  • PUT /zoos/ID:更新某個指定動物園的信息(提供該動物園的全部信息)
  • PATCH /zoos/ID:更新某個指定動物園的信息(提供該動物園的部分信息)
  • DELETE /zoos/ID:刪除某個動物園
  • GET /zoos/ID/animals:列出某個指定動物園的所有動物
  • DELETE /zoos/ID/animals/ID:刪除某個指定動物園的指定動物

4.總結

 

  (1)每一個URI代表一種資源;

 

  (2)客戶端和伺服器之間,傳遞這種資源的某種表現層;

 

  (3)客戶端通過四個主要的HTTP動詞,對伺服器端資源進行操作,實現"表現層狀態轉化"。

5.設計中註意事項

  URI中不要包含動詞。因為"資源"表示一種實體,所以應該是名詞,URI不應該有動詞,動詞應該放在HTTP協議中。

  狀態碼:

  • 200 OK - [GET]:伺服器成功返回用戶請求的數據,該操作是冪等的(Idempotent)。
  • 201 CREATED - [POST/PUT/PATCH]:用戶新建或修改數據成功。
  • 202 Accepted - [*]:表示一個請求已經進入後臺排隊(非同步任務)
  • 204 NO CONTENT - [DELETE]:用戶刪除數據成功。
  • 400 INVALID REQUEST - [POST/PUT/PATCH]:用戶發出的請求有錯誤,伺服器沒有進行新建或修改數據的操作,該操作是冪等的。
  • 401 Unauthorized - [*]:表示用戶沒有許可權(令牌、用戶名、密碼錯誤)。
  • 403 Forbidden - [*] 表示用戶得到授權(與401錯誤相對),但是訪問是被禁止的。
  • 404 NOT FOUND - [*]:用戶發出的請求針對的是不存在的記錄,伺服器沒有進行操作,該操作是冪等的。
  • 406 Not Acceptable - [GET]:用戶請求的格式不可得(比如用戶請求JSON格式,但是只有XML格式)。
  • 410 Gone -[GET]:用戶請求的資源被永久刪除,且不會再得到的。
  • 422 Unprocesable entity - [POST/PUT/PATCH] 當創建一個對象時,發生一個驗證錯誤。
  • 500 INTERNAL SERVER ERROR - [*]:伺服器發生錯誤,用戶將無法判斷發出的請求是否成功。

  

 


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 上面是繼承Thread的方法 這種方法較為簡單,只要繼承後覆寫run方法即可,缺點是已經繼承別的類就不能在繼承了,有局限性。對單一對象中成員進行操作的多線程需要靜態static關鍵字 下麵是實現implements Runnable方法 鎖可以在方法上,也可以用同步代碼塊,同步代碼塊較好,可以局部鎖 ...
  • Infi-chu: http://www.cnblogs.com/Infi-chu/ NoSQL(NoSQL=Not Only SQL),中文意思是非關係型資料庫。 隨著互聯網Web2.0網站的興起,傳統的關係型資料庫在應付web2.0網站,特別是超大規模和高併發的SNS類型的web2.0純動態網站 ...
  • 上傳文件 Browse for a file to upload: 1、使用webdriver的send_keys方法上傳文件 #!usr/bin/env python #-*- coding:utf-8 -*- """ @author: sleeping_cat... ...
  • 1.常用的Web事件監聽器介面: 1.ServletContextListener:用於監聽Web應用的啟動和關閉。 2.ServletContextAttributeListener:用於監聽ServletContext(application)範圍內屬性的改變。 3.ServletRequest ...
  • "洛谷題目傳送門" 題目 題目描述 曾經有一款流行的游戲,叫做 Infinity Loop,先來簡單的介紹一下這個游戲: 游戲在一個 n ∗ m 的網格狀棋盤上進行,其中有些小方格中會有水管,水管可能在格子某些方向的邊界的中點有介面,所有水管的粗細都相同,所以如果兩個相鄰方格的共邊界的中點都有接頭, ...
  • 本篇文章雖不談架構,但是Cache又是架構中不可或缺的部分,因此,在講解Cache的同時,將會提及到部分架構知識,關於架構部分,讀者可以不用理解,或者直接跳過, 你只需關心Cache即可,具體的架構,會在後續文章中與大家分享。 一 為什麼要在ASP.NET 項目中引入緩存 1. 我們先來考慮一個問題 ...
  • 此系列文章圍繞著拼多多賣家工具來介紹ABPZero的使用,內容包括手機登錄、手機註冊、拼團提醒、微信公眾號綁定帳號、有拼團發送消息到微信公眾號(只要關註過微信公眾號並已綁定系統帳號)。 學習此系列必備: 手機驗證碼:使用阿裡雲簡訊,可註冊阿裡雲帳號訂購(後續會介紹) 微信公眾號:我所使用的是認證過的 ...
  • 第一種: string[] myArray = new string[10]; for(int i = 0; i<10;i++){ myArray[i] = i+1; } 第二種: string[] myArray2 = {"1","2","3","4","5","6","7","8","9","1 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...