我已經(jīng)構(gòu)建了一個(gè) RESTful 服務(wù)，使用 OpenApi 3.0 公開(kāi)端點(diǎn)yaml當(dāng)我構(gòu)建這個(gè)時(shí)，它會(huì)自動(dòng)生成一個(gè)client目錄和一個(gè)server目錄。我成功地利用服務(wù)器 API 作為消耗請(qǐng)求的端點(diǎn)。然而，客戶端 API 是由完全相同的生成的yaml......接受相同的參數(shù)類型并返回與服務(wù)器相同的類型。我的理解是客戶端向外部服務(wù)發(fā)出請(qǐng)求，而服務(wù)器則消費(fèi)來(lái)自外部服務(wù)的請(qǐng)求。如果這是正確的，為什么 OpenApi 相同地定義客戶端和服務(wù)器，并且不提供單獨(dú)配置它們的方法？
1 回答
慕森王
TA貢獻(xiàn)1777條經(jīng)驗(yàn) 獲得超3個(gè)贊
你是對(duì)的：
我的理解是客戶端向外部服務(wù)發(fā)出請(qǐng)求，而服務(wù)器則消費(fèi)來(lái)自外部服務(wù)的請(qǐng)求。
這些基本上是您規(guī)范的示例實(shí)現(xiàn)。
它們都是根據(jù)相同的 OpenAPI 合約構(gòu)建的，客戶端可以調(diào)用服務(wù)器，服務(wù)器將按照規(guī)范中描述的各種 API 和數(shù)據(jù)模式達(dá)成一致。
這client是一個(gè)可以在使用 API 的應(yīng)用程序中使用的庫(kù)，因?yàn)槟梢园丛瓨邮褂盟?，?OpenAPI 定義描述的 API 發(fā)出請(qǐng)求。
這server只是一個(gè)示例服務(wù)器應(yīng)用程序，提供 OpenAPI 中描述的 HTTP 接口。
兩者本身都不是非常有用，因?yàn)榭蛻舳酥恍枰哉_的方式調(diào)用 API，服務(wù)器將簡(jiǎn)單地公開(kāi)端點(diǎn)并執(zhí)行諸如序列化/反序列化任何請(qǐng)求或響應(yīng)數(shù)據(jù)之類的操作。API 的實(shí)現(xiàn)由您決定。
通常，我從生成的規(guī)范中使用的有用位是類model，因?yàn)檫@有助于確保我的應(yīng)用程序代碼（無(wú)論是客戶端還是服務(wù)器）基于正確的架構(gòu)。
添加回答
舉報(bào)
0/150
提交
取消