用ASP.NET Core 2.0 建立規範的 REST API -- GET 和 POST

来源:https://www.cnblogs.com/cgzl/archive/2018/05/23/9047626.html
-Advertisement-
Play Games

本文所需的一些預備知識可以看這裡: http://www.cnblogs.com/cgzl/p/9010978.html 和 http://www.cnblogs.com/cgzl/p/9019314.html 本文介紹的是使用ASP.NET Core建立Richardson成熟度為2級的偽REST ...


本文所需的一些預備知識可以看這裡: http://www.cnblogs.com/cgzl/p/9010978.html 和 http://www.cnblogs.com/cgzl/p/9019314.html

本文介紹的是使用ASP.NET Core建立Richardson成熟度為2級的偽RESTful web API, 本文介紹的是GET和POST.

使用的項目是(右鍵另存為, 然後把尾碼名改為zip): https://images2018.cnblogs.com/blog/986268/201805/986268-20180516191053536-1701412182.jpg

RESTful API 資源 (Resource) 的命名指導規範

首先, 資源應該使用名詞, 它是個東西, 不是動作.

例如:

  • api/getusers 就是不正確的.
  • GET api/users 就是正確的
  • GET api/users/{userId}.

所以資源應該使用的是名詞.

如果是非分層結構的資源, 那麼它不應該這樣命名: api/xxx/xxx/users, 而應該使用 api/users.

如果是單個資源, 不應該這樣 api/id/users, 而應該是 api/users/{userId}.

(資源名是否複數還是根據個人習慣吧).

命名應該可以體現資源的結構

例如 api/department/{departmentId}/emoloyees, 這就表示了department (部門)和 員工(employee)之前是主從關係.

而 api/department/{departmentId}/emoloyees/{employeeId}, 就表示了該部門下的某個員工.

 

而過濾, 排序等不是資源, 所以這樣寫 api/users/orderby/username 是不正確的.

過濾排序這類的參數是可以作為查詢參數傳遞進來的, 正確的寫法應該是: api/users?orderby=username.

但是有時候, RPC風格的方法調用很難映射成規範的資源命名, 所以有時可以打破規範 例如 api/users/{userId}/totalsalaries.

 

應該使用什麼類型作為ID

如果使用int型作為ID的話, 大部分時候是沒有問題的, 但是如果您使用的資料庫的ID是自增整型的, 如果你替換資料庫了, 然後把原有數據遷移到新資料庫了, 那麼現有數據的ID就會發生變化, 那麼相當於所有的資源的地址發生了變化, 這就違反了這個:

資源的URI應該永遠都是一樣的.

所以GUID應該作為ID來使用. (但是我為了省事, 還是使用自增int作為ID吧

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

-Advertisement-
Play Games
更多相關文章
  • 通過列表生成式,我們可以直接創建一個列表。但是,受到記憶體限制,列表容量肯定是有限的。而且,如果創建一個包含100萬個元素的列表,不僅占用很大的存儲空間,如果我們僅僅需要訪問前面幾個元素,那後面絕大多數元素占用的空間都白白浪費了。 如果列表元素可以按照某種演算法推算出來,可以在迴圈的過程中不斷推算出後續 ...
  • 天氣有點陰晴不定~ (截圖來自 金角大王) 1.學習了電腦概論(CPU/Memory/Disk,memory的存在是為瞭解決信息傳輸產生的時延) 2.瞭解了操作系統(OS) 3.初步認識python 3.1 註:解釋型語言最大的優點是可以跨平臺(只要windows、linux等不同的OS安裝瞭解釋 ...
  • 1 def run_time(func): 2 def new_fun(*args,**kwargs): 3 t0 = time.time() 4 print('star time: %s' % (time.strftime('%x', time.localtime()))) 5 back = fu... ...
  • 在互聯網開發中,我們在傳輸數據中經常需要對數據通過演算法進行加密,來保證信息的安全。 1.消息摘要演算法(Hash函數) 1.無論輸入的消息有多長,計算出來的消息摘要的長度總是固定的。 2.只能進行正向的信息摘要,而無法從摘要中恢復出任何的消息,即單向、不可逆的 3.好的摘要演算法,很難找到碰撞 常見的h ...
  • 提前總結就是四招: 一、重覆的代碼提煉成函數 二、把過長的函數變小 三、參數列太長或變化太頻繁,參數對象化 四、大招:類的代碼行數太多,要考慮提煉子類。 ...
  • 列表生成式即List Comprehensions,是Python內置的非常簡單卻強大的可以用來創建list的生成式。 列表生成式可以用一行語句代替迴圈生成一個list: for迴圈其實可以同時使用兩個甚至多個變數,比如dict的items()可以同時迭代key和value: 列表生成式也可以使用兩 ...
  • 如果給定一個list或tuple,我們可以通過for迴圈來遍歷這個list或tuple,這種遍歷我們稱為迭代(Iteration)。 在Python中,迭代是通過for...in來完成的,而很多語言比如C語言,迭代list是通過下標完成的。 Python的for迴圈抽象程度要高於C的for迴圈,因為 ...
  • Github https://github.com/gongluck/Windows .git ...
一周排行
    -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.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...