這篇博文詳細(xì)介紹了構(gòu)建新 API 的初始步驟，重點(diǎn)是設(shè)置項(xiàng)目結(jié)構(gòu)和生成初始代碼。 目標(biāo)是使用各種現(xiàn)代工具創(chuàng)建強(qiáng)大且可測試的 API。
技術(shù)堆棧包括：用于規(guī)范的 OpenAPI、用于服務(wù)器生成的 oapi-codegen、用于測試的 Testify、用于覆蓋率報(bào)告的 Codecov、用于容器化的 Docker、用于數(shù)據(jù)庫的 PostgreSQL、用于 ORM 的 GORM、用于數(shù)據(jù)庫遷移的 Flyway、用于編排的 Kubernetes ，Terraform 用于基礎(chǔ)設(shè)施即代碼，Caddy 作為潛在的 Web 服務(wù)器。
API 規(guī)范：
該項(xiàng)目從一個(gè) User 資源的簡單 OpenAPI 規(guī)范開始。 User 架構(gòu)包括 id、email 和 name。 id 是只讀的，email 是只寫的。
<code>components:
schemas:
User:
type: object
properties:
id:
type: string
example: 123
readOnly: true
email:
type: string
example: me@example.com
writeOnly: true
name:
type: string
example: Alice</code>
此架構(gòu)將用于在 /users 定義 POST 端點(diǎn)，成功時(shí)返回 201（已創(chuàng)建）狀態(tài)代碼，400（錯(cuò)誤請求）錯(cuò)誤時(shí)返回問題詳細(xì)信息 JSON 對象。
代碼生成：
oapi-codegen 用于根據(jù) OpenAPI 規(guī)范生成服務(wù)器代碼。 配置文件（server.config.yaml 和 types.config.yaml）用于自定義生成的代碼。 tools.go 文件利用 go generate 來自動(dòng)化此過程。
處理程序?qū)崿F(xiàn)和測試：
創(chuàng)建了一個(gè)基本的服務(wù)器結(jié)構(gòu)，實(shí)現(xiàn)了生成的服務(wù)器接口。 實(shí)現(xiàn)了 PostUser 處理程序，最初返回 nil 值。 使用 Testify 同時(shí)編寫單元測試來定義預(yù)期行為。 由于數(shù)據(jù)庫尚未集成，測試響應(yīng)目前是硬編碼的。
未來的步驟將涉及創(chuàng)建 main.go 文件、Dockerfile、集成 Codecov 進(jìn)行持續(xù)測試，以及將 API 連接到 PostgreSQL 數(shù)據(jù)庫。 項(xiàng)目存儲庫可獲取更多詳細(xì)信息：http://m.miracleart.cn/link/f72a23858b9865a40479a3ce3f16649e
以上是構(gòu)建和部署新 API（第 1 部分）的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！
熱AI工具
Undress AI Tool
免費(fèi)脫衣服圖片
Undresser.AI Undress
人工智能驅(qū)動(dòng)的應(yīng)用程序，用于創(chuàng)建逼真的裸體照片
AI Clothes Remover
用于從照片中去除衣服的在線人工智能工具。
Clothoff.io
AI脫衣機(jī)
Video Face Swap
使用我們完全免費(fèi)的人工智能換臉工具輕松在任何視頻中換臉！
熱門文章
熱工具
記事本++7.3.1
好用且免費(fèi)的代碼編輯器
SublimeText3漢化版
中文版，非常好用
禪工作室 13.0.1
功能強(qiáng)大的PHP集成開發(fā)環(huán)境
Dreamweaver CS6
視覺化網(wǎng)頁開發(fā)工具
SublimeText3 Mac版
神級代碼編輯軟件(SublimeText3)
默認(rèn)情況下，GO靜態(tài)鏈接的含義是什么？
Jun 19, 2025 am 01:08 AM
Go默認(rèn)將程序編譯為獨(dú)立二進(jìn)制文件，主要原因是靜態(tài)鏈接。1.部署更簡單：無需額外安裝依賴庫，可直接跨Linux發(fā)行版運(yùn)行；2.二進(jìn)制體積更大：包含所有依賴導(dǎo)致文件尺寸增加，但可通過構(gòu)建標(biāo)志或壓縮工具優(yōu)化；3.更高的可預(yù)測性與安全性：避免外部庫版本變化帶來的風(fēng)險(xiǎn)，增強(qiáng)穩(wěn)定性；4.運(yùn)行靈活性受限：無法熱更新共享庫，需重新編譯部署以修復(fù)依賴漏洞。這些特性使Go適用于CLI工具、微服務(wù)等場景，但在存儲受限或依賴集中管理的環(huán)境中需權(quán)衡取舍。
如何在GO中創(chuàng)建緩沖頻道？ （例如，make（chan int，10））
Jun 20, 2025 am 01:07 AM
在Go中創(chuàng)建緩沖通道只需在make函數(shù)中指定容量參數(shù)即可。緩沖通道允許發(fā)送操作在沒有接收者時(shí)暫存數(shù)據(jù)，只要未超過指定容量，例如ch:=make(chanint,10)創(chuàng)建了一個(gè)可存儲最多10個(gè)整型值的緩沖通道；與無緩沖通道不同，發(fā)送數(shù)據(jù)時(shí)不會(huì)立即阻塞，而是將數(shù)據(jù)暫存于緩沖區(qū)中，直到被接收者取走；使用時(shí)需注意：1.容量設(shè)置應(yīng)合理以避免內(nèi)存浪費(fèi)或頻繁阻塞；2.需防止緩沖區(qū)無限堆積數(shù)據(jù)導(dǎo)致內(nèi)存問題；3.可用chanstruct{}類型傳遞信號以節(jié)省資源；常見場景包括控制并發(fā)數(shù)量、生產(chǎn)者-消費(fèi)者模型及異
在沒有C中的手動(dòng)內(nèi)存管理的情況下，如何確保內(nèi)存安全性？
Jun 19, 2025 am 01:11 AM
Goensuresmemorysafetywithoutmanualmanagementthroughautomaticgarbagecollection,nopointerarithmetic,safeconcurrency,andruntimechecks.First,Go’sgarbagecollectorautomaticallyreclaimsunusedmemory,preventingleaksanddanglingpointers.Second,itdisallowspointe
如何使用GO進(jìn)行系統(tǒng)編程任務(wù)？
Jun 19, 2025 am 01:10 AM
Go是系統(tǒng)編程的理想選擇，因?yàn)樗Y(jié)合了C等編譯型語言的性能與現(xiàn)代語言的易用性和安全性。1.文件與目錄操作方面，Go的os包支持創(chuàng)建、刪除、重命名及檢查文件和目錄是否存在，使用os.ReadFile可一行代碼讀取整個(gè)文件，適用于編寫備份腳本或日志處理工具；2.進(jìn)程管理方面，通過os/exec包的exec.Command函數(shù)可執(zhí)行外部命令、捕獲輸出、設(shè)置環(huán)境變量、重定向輸入輸出流以及控制進(jìn)程生命周期，適合用于自動(dòng)化工具和部署腳本；3.網(wǎng)絡(luò)與并發(fā)方面，net包支持TCP/UDP編程、DNS查詢及原始套
如何在GO中的結(jié)構(gòu)實(shí)例上調(diào)用方法？
Jun 24, 2025 pm 03:17 PM
在Go語言中，調(diào)用結(jié)構(gòu)體方法需先定義結(jié)構(gòu)體和綁定接收者的方法，使用點(diǎn)號訪問。定義結(jié)構(gòu)體Rectangle后，可通過值接收者或指針接收者聲明方法；1.使用值接收者如func(rRectangle)Area()int，通過rect.Area()直接調(diào)用；2.若需修改結(jié)構(gòu)體，應(yīng)使用指針接收者如func(r*Rectangle)SetWidth(...)，Go會(huì)自動(dòng)處理指針與值的轉(zhuǎn)換；3.嵌入結(jié)構(gòu)體時(shí)，內(nèi)嵌結(jié)構(gòu)體的方法會(huì)被提升，可直接通過外層結(jié)構(gòu)體調(diào)用；4.Go無需強(qiáng)制使用getter/setter，字
GO中的接口是什么？如何定義它們？
Jun 22, 2025 pm 03:41 PM
在Go語言中，接口是一種定義行為而不指定實(shí)現(xiàn)方式的類型。接口由方法簽名組成，任何實(shí)現(xiàn)這些方法的類型都自動(dòng)滿足該接口。例如，定義一個(gè)Speaker接口包含Speak()方法，則所有實(shí)現(xiàn)該方法的類型均可視為Speaker。接口適用于編寫通用函數(shù)、抽象實(shí)現(xiàn)細(xì)節(jié)和測試中使用mock對象。定義接口使用interface關(guān)鍵字并列出方法簽名，無需顯式聲明類型實(shí)現(xiàn)了接口。常見用例包括日志、格式化、不同數(shù)據(jù)庫或服務(wù)的抽象，以及通知系統(tǒng)等。例如，Dog和Robot類型均可實(shí)現(xiàn)Speak方法，并傳遞給同一個(gè)Anno
如何使用IO軟件包在GO中使用輸入和輸出流？
Jun 20, 2025 am 11:25 AM
TheGoiopackageprovidesinterfaceslikeReaderandWritertohandleI/Ooperationsuniformlyacrosssources.1.io.Reader'sReadmethodenablesreadingfromvarioussourcessuchasfilesorHTTPresponses.2.io.Writer'sWritemethodfacilitateswritingtodestinationslikestandardoutpu
如何在GO中使用字符串軟件包中的字符串函數(shù)？ （例如len（），strings.contains（），strings.index（），strings.replaceall（））
Jun 20, 2025 am 01:06 AM
在Go語言中，字符串操作主要通過strings包和內(nèi)置函數(shù)實(shí)現(xiàn)。1.strings.Contains()用于判斷字符串是否包含子串，返回布爾值；2.strings.Index()可查找子串首次出現(xiàn)的位置，若不存在則返回-1；3.strings.ReplaceAll()能替換所有匹配的子串，還可通過strings.Replace()控制替換次數(shù)；4.len()函數(shù)用于獲取字符串字節(jié)數(shù)長度，但處理Unicode時(shí)需注意字符與字節(jié)的區(qū)別。這些功能常用于數(shù)據(jù)過濾、文本解析及字符串處理等場景。
