何謂RESTful開發

REST = RESTful = Representational State Transfer( 表現層狀態轉移)


RESTful API 主要由三種元件組成

Nouns:定義API位置的URL

Verb:定義對資源要做的動作(Get , Post ...)

ContentType:回傳資源呈現方式，如Json之類


通常使用的API會是如

/GetData

/EditData

/InsertData

/DeleteData/1

使用RESTful風格的話則會變成

Get        /data

Get        /data/1

Post       /data

Delete   /data/1


目前最常見的方法為下列五種

GET

POST

PUT

PATCH

DELETE

分別對應

取得資料或狀態(登入or員工資料) (safe & idempotent)

新增一筆資料 (新增)

利用更新方式於指定位置新增資料 (新增 並且結果不變) (idempotent)

在現有的資料上更新或者新增資料(編輯)

刪除資料(idempotent)


後面的(safe)或者(idempotent)則代表

safe 操作原本不會更改的資源狀態，可以直接從cache中抓取，省去時間

idempotent 操作不論做幾遍都得到同樣的結果


PUT的額外補充，同樣都跟POST一樣是新增的概念，也同樣可以用於PATCH的概念

但是又包含兩者 也就是說 PATCH的概念是 你新增了一筆資料後，你無法再新增一筆同樣的資料，接著可以對此資料修改

至少我的理解上應該是這樣。


因此使用了RESTful的風格設計，因此會有以下幾點優點跟限制:

1. 有一個唯一的URL表示位置。

2. 無狀態

通常一般的請求狀態為Server和Client端交互資訊，會存在於Server的Session中(如登入狀態)

在Client中發送請求後，Server透過保存在Server中的Session去執行Request。

而無狀態的意思就是由Client自行保存狀態Server不保留，再請求Server中一併交給Server。


比如說 我一次搜尋了一個資料，共有一百筆，但是此頁面一次只能Show50筆

那當我轉到第二頁時，不會再次撈取SQL，而是從Session中拿取


拿個比較直白的說法就是

我只要輸入某個URL 我就可以得到指定的目標資料

3.可以使用更快的效率得到回應(Cachable)

在Server-side，GET過的資源如沒有變更過可以使用Cache，減少Request。

在Client-side，透過Client端cache紀錄版本，若向Server要求資源則會比對Cache，若相同則取用本地

4.分層系統架構

5.客戶端服務器分離

6.充分利用HTTP protocal

7.可執行程式碼的設計，像是JavaScript


參考:https://medium.com/itsems-frontend/api-%E6%98%AF%E4%BB%80%E9%BA%BC-restful-api-%E5%8F%88%E6%98%AF%E4%BB%80%E9%BA%BC-a001a85ab638

https://blog.csdn.net/Jmilk/article/details/50461577





留言

張貼留言

這個網誌中的熱門文章

無法載入檔案或組件 'System.IO.Compression' 或其相依性的其中之一。

圖片
曾經在拿取檔案的時候發生過這個問題 我不清楚究竟是版本的問題還是(應該不是版本的問題，因為我從我的夥伴手中拿它可以跑的程式，修改Config後仍然有問題) 主要的問題可能是因為package的問題，時常因為package跟參考以及nuget和WebConfig有不同而出現版本問題 遇到上述問題的話可能都要檢查以上三個檔案 建議是直接複製查詢 然後把「你認為不該存在的」參考給移除。 我自己本人是只留下參考中的檔案，是會把package和WebConfig的依賴給註解後再使用nuget重新安裝。 題外話抱怨 package.Config貌似就是參考的引入，但是不知道為啥連那邊都會跟參考互相衝突，微軟真的不打算修一下逆? 補充說明: 比如說遇到這個錯誤 上面有寫明說 Newtonsoft.Json culture = neutral publicKeyToken = 30ad4fe6b2a6aeed version = 6.0.0.0 就可以在web.config中寫這段加入  <dependentAssembly>    <assemblyIdentity name="Newtonsoft.Json" culture="neutral" publicKeyToken="30ad4fe6b2a6aeed"/>    <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0"/>  </dependentAssembly> oldVersion - 那些版號要對應 - 可以用 - 來包含版號區間。 注意，newVersion不代表一定比oldVersion高。換句話說也有可能高版本全部要用低版本的dll（不過這種情景比較少 ，因為一般都是高版本會向下兼容） 不過這種方法不太建議，一律建議使用最上面的方法 參考 http://shaurong.blogspot.com/2020/02/systemiocompression.html
閱讀完整內容

MongoDB 入門

圖片
 MongoDB是一個NoSQL(非關聯性資料庫) 主要的儲存方式是 一個DB => 底下為一個Collection (類似Table) => 接著是文檔(docume) 存的資料型態為 BSON 是一種JSON的變體 如這樣 ID 自動生成 如SN 為唯一值 name sort之類的數值都是自己產生的 常用語法 通常都是以 db.CollectionName 開頭 find() 類似where 不輸入為全搜尋 insertOne({colname : data , colname2 :"data2"}) insert 用逗號分隔 insertMany([{colname : data} , {colname2 :"data2"}]) 如上 只是有中括號用來代表陣列 find().limit(N) 只回傳N筆 類似select() find().skip(N) 略過N筆後 類似skip() find().sort({colname : 1 , colname2 : -1}) 1是升冪 -1降冪 find()進階 => find({colname : 3} , {colname : 1 , colname2 : 0}) 這段的意思是 依照前面大括內的where 搜尋後 依照後面的select 條件選出 1是要輸出 0是不要輸出 假如只有0 則是 除了這些以外都要輸出  通常 1 跟 0 同時出現的時候是 _id這個字樣 因為這個是會自動返回的字樣 find(colname : {$gt : 3})  gt 大於 lt 小於 gte 大於等於 lte 小於等於 eq 等於 in => {$in :[ 1 , 3]} 一或三 nin => {$nin :[ 1 , 3]} 不等於1 或 3 都出 colname : { $exists : 1 } 代表這個colname存在的話則顯示 (nosql 因此型態可能不同) 0則是沒有的顯示 colname : {$regex :{/data/}} 正則表達式 找所有data  countDocuments() 總數 ex 找大於等於3小於等於5的 db.CollName.find(colname : {$gte : 3 , $let : 5}) 參考 : h...
閱讀完整內容

javascript 更改屬性及創建標籤

雖然應該是一些很基本的東西 但是我的前端其實蠻破的，所以筆記一下關於這個東西 //-----------------------------------1 如果要呈現某種屬性的話 就用 document.querySelector('id').setAttribute('readonly', true); 如果要刪除(隱藏)某種屬性的話就用 document.querySelector('id').removeAttribute('readonly'); //-----------------------------------2 $(document).ready(function () {         //取目標Tag為img者          //getElementsByTagName 不能使用forEach走訪 只好使用for走訪         var varTaglist = document.getElementsByTagName('img');         for (let i = 0; i < varTaglist.length; i++) {             //走訪建立id用於區分點選的目標             varTaglist[i].setAttribute('id', 'imgID' + i)             //走訪建立onclick屬性             varTaglist[i].setAttribute('onclick', 'imgclick(id)');         }     });     //設定屬性值 part2     var imgclick = function ...
閱讀完整內容