背景

　　基于現(xiàn)在微服務(wù)或者服務(wù)化的思想，我們大部分的業(yè)務(wù)邏輯處理函數(shù)都是長這樣的：

　　比如grpc服務(wù)端：

　　grpc客戶端：

　　有些服務(wù)我們需要把它包裝為RESTful形式的接口，一般需要經(jīng)歷以下步驟：

　　指定HTTP方法、URL

　　鑒權(quán)

　　參數(shù)綁定

　　處理請求

　　處理響應(yīng)

　　可以發(fā)現(xiàn)，參數(shù)綁定、處理響應(yīng)幾乎都是一樣模板代碼，鑒權(quán)也基本上是模板代碼(當(dāng)然有些鑒權(quán)可能比較復(fù)雜)。

　　而Ginrest庫就是為了消除這些模板代碼，它不是一個復(fù)雜的框架，只是一個簡單的庫，輔助處理這些重復(fù)的事情，為了實現(xiàn)這個能力使用了Go1.18的泛型。

　　特性

　　這個庫提供以下特性：

　　封裝RESTful請求響應(yīng)

　　封裝RESTful請求為標(biāo)準(zhǔn)格式服務(wù)

　　封裝標(biāo)準(zhǔn)格式服務(wù)處理結(jié)果為標(biāo)準(zhǔn)RESTful響應(yīng)格式：Rsp{code, msg, data}

　　默認(rèn)使用統(tǒng)一數(shù)字錯誤碼格式：[0, 4XXXX, 5XXXX]

　　默認(rèn)使用標(biāo)準(zhǔn)錯誤格式：Error{code, msg}

　　默認(rèn)統(tǒng)一狀態(tài)碼[200, 400, 500]

　　提供Recovery中間件，統(tǒng)一panic時的響應(yīng)格式

　　提供SetKey()、GetKey()方法，用于存儲請求上下文(泛型)

　　提供ReqFunc()，用于設(shè)置Req(泛型)

　　使用例子

　　首先我們實現(xiàn)兩個簡單的服務(wù)：

　　然后使用Gin+Ginrest包裝為RESTful接口：

　　可以看到Register()里面每個接口都只需要一行代碼!

　　運行上面代碼，然后嘗試訪問接口，可以看到返回結(jié)果：

　　實現(xiàn)原理

　　Do()和DoOpt()都會轉(zhuǎn)發(fā)到do()，它其實是一個模板函數(shù)，把臟活累活給處理了：

　　功能列表

　　處理請求

　　用于把一個標(biāo)準(zhǔn)服務(wù)封裝為一個RESTfulgin.HandlerFunc，對應(yīng)Do()、DoOpt()函數(shù)。

　　DoOpt()相比于Do()多了一個opts參數(shù)，因為很多rpc框架客戶端都有一個opts參數(shù)作為結(jié)尾。

　　還有一個BindJSON()，用于把請求體包裝為一個Req結(jié)構(gòu)體：

　　如果無法使用Do()和DoOpt()則可以使用此方法。

　　處理響應(yīng)

　　用于把rsp、error、errcode、errmsg等數(shù)據(jù)封裝為一個JSON格式響應(yīng)體，對應(yīng)ProcessRsp()、Success()、Failure()、FailureCodeMsg()函數(shù)。

　　比如ProcessRsp()需要帶上rsp和error，這樣業(yè)務(wù)里面就不需要再寫如下模板代碼了：

　　響應(yīng)格式統(tǒng)一為：

　　Success()用于處理成功情況：

　　其余同理。

　　如果無法使用Do()和DoOpt()則可以使用這些方法。

　　處理錯誤

　　一般我們都需要在出錯時帶上一個業(yè)務(wù)錯誤碼，方便客戶端處理。因此我們需要提供一個合適的error類型：

　　我們提供了一些函數(shù)方便使用Error，對應(yīng)NewError()、ToError()、ErrCode()、ErrMsg()、ErrEqual()函數(shù)。

　　比如NewError()生成一個Error類型error：

　　請求上下文操作

　　Gin的請求是鏈?zhǔn)教幚淼模簿褪嵌鄠€handler順序的處理一個請求，比如：

　　這個接口經(jīng)歷了Verify和ginrest.Do兩個handler，其中我們在Verify的時候通過認(rèn)證知道了用戶的身份信息(比如uid)，我們希望把這個uid存起來，這樣可以在業(yè)務(wù)邏輯里使用。

　　因此我們提供了SetKey()、GetKey()兩個函數(shù)，用于存儲請求上下文：

　　比如認(rèn)證通過后我們可以設(shè)置UID到上下文，然后在reqFunc()里讀取設(shè)置到req里面(下面介紹)。

　　請求結(jié)構(gòu)體處理

　　上面我們設(shè)置了請求上下文，比如UID，但是其實我們并不知道具體這個UID是需要設(shè)置到req里的哪個字段，因此我們提供了一個回調(diào)函數(shù)ReqFunc()，用于設(shè)置Req：

　　注

　　如果這個庫的設(shè)計不符合具體的業(yè)務(wù)，也可以按照這種思路去封裝一個類似的庫，只要盡可能的統(tǒng)一請求、響應(yīng)的格式，就可以減少很多重復(fù)的模板代碼。