golang微服務框架go-zero系列-4:go-zero文件服務
go-zero本身支持文件服務,但是我們需要寫相關的handler文件,本文目的在於
- 不寫任何一個和文件相關的handler
- 如果有新的文件,直接把文件模板到某個特定目錄就好,不要動任何go代碼
需求在這裏,開擼吧
在代碼開始前,你可能需要閱讀
golang微服務框架go-zero系列-1:在go-zero中使用XormV2 golang微服務框架go-zero系列-2:在go-zero中使用jwt-token鑑權實踐 golang微服務框架go-zero系列-3:擴展go-zero,使之支持html模板解析自動化
注意
微服務講究資源分離,實際生產過程中儘量使用專業的文件服務器或者OSS等第三方存儲平臺
file服務實現思路
在gin中有專門的static file服務封裝,go-zero目前並沒有提供。目前go-zero提供非常嚴格的路徑匹配,如 訪問 /asset/l1.jpg 將映射到 /asset/:1對應的handlerlv1 /asset/l1/l2.jpg 將映射到 /asset/:1/:2對應的handlerlv2 這有如下倆種情況
映射指定路徑到單個文件
比如我們需要訪問favourite.ico,系統指向./www/favourite.ico文件,代碼如下
//處理函數,傳入文件地址
func filehandler(filepath string) http.HandlerFunc {
return func(w http.ResponseWriter, req *http.Request) {
http.ServeFile(w, req, filepath)
}
}
在router裏面直接調用AddRoute方法添加單個路由
func RegisterHandlers(engine *rest.Server, serverCtx *svc.ServiceContext) {
//這裏直接添加單個
engine.AddRoute(
rest.Route{
Method: http.MethodGet,
Path: "/favourite.ico",
Handler: filehandler("./www/favourite.ico"),
})
}
映射指定目錄並提供服務
實際過程中我們需要對外暴露某一個目錄,比如/assets/目錄,該目錄下存放一些資源文件如css,js,img等
tree /f
+---assets
| +---css
| +---fonts
| +---images
| +---js
| \---plugins
| +---font-awesome
| | +---css
| | \---fonts
| +---fontawesome
| | +---css
| | \---fonts
| +---ionicons
| | +---css
| | \---fonts
| +---jquery.contextmenu
| | \---images
| +---jquery.pin
| | +---css
| | \---images
| +---jqueryui-1.12.1
| | +---external
| | | \---jquery
| | \---images
| \---swiper-4.5.3
| +---css
| \---js
如果使用單個文件的方式來實現,肯定不合理,因爲router會非常大,怎麼解決這個問題?我們可以使用如下方法實現文件夾服務
//
func dirhandler(patern, filedir string) http.HandlerFunc {
return func(w http.ResponseWriter, req *http.Request) {
handler := http.StripPrefix(patern, http.FileServer(http.Dir(filedir)))
handler.ServeHTTP(w, req)
}
}
如上函數的核心是http.StripPrefix(patern, http.FileServer(http.Dir(filedir)))函數,這個函數的核心功能是將映patern格式映射到某一個目錄filedir
- patern:請求路徑格式
/assets/:1,/assets/:1/:2這種 - filedir:映射對應的文件夾
./assets/這種
那麼我們只需要構建多級文件訪問格式和dirhandler的映射關係即可
func RegisterHandlers(engine *rest.Server, serverCtx *svc.ServiceContext) {
//這裏註冊
dirlevel := []string{":1", ":2", ":3", ":4", ":5", ":6", ":7", ":8"}
patern := "/asset/"
dirpath := "./assets/"
for i := 1; i < len(dirlevel); i++ {
path := prefix + strings.Join(dirlevel[:i], "/")
//最後生成 /asset
engine.AddRoute(
rest.Route{
Method: http.MethodGet,
Path: path,
Handler: dirhandler(patern,dirpath),
})
logx.Infof("register dir %s %s", path,dirpath)
}
}
404
404可以在main函數中配置
rt := router.NewPatRouter()
rt.SetNotFoundHandler(http.HandlerFunc(func(w http.ResponseWriter, req *http.Request) {
//這裏內容可以定製
w.Write([]byte("服務器開小差了,這裏可定製"))
}))
server := rest.MustNewServer(c.RestConf, rest.WithRouter(rt))
此時請求http://127.0.0.1:8888/hello,系統響應 服務器開小差了,這裏可定製
測試
啓動系統後運行
E:\workspace@go\gozero\file>go run file.go
2020/09/05 20:18:24 {"@timestamp":"2020-09-05T20:18:24.682+08","level":"info","content":"{{{file-api { console logs info false 0 100} pro { 0 }} 0.0.0.0 8081 false 10000 1048576 3000 900 {false 0s []}} [/asset/=./assets]}"}
{"@timestamp":"2020-09-05T20:18:24.682+08","level":"info","content":"register dir /asset/:1 ./assets"}
{"@timestamp":"2020-09-05T20:18:24.683+08","level":"info","content":"register dir /asset/:1/:2 ./assets"}
{"@timestamp":"2020-09-05T20:18:24.683+08","level":"info","content":"register dir /asset/:1/:2/:3 ./assets"}
{"@timestamp":"2020-09-05T20:18:24.683+08","level":"info","content":"register dir /asset/:1/:2/:3/:4 ./assets"}
{"@timestamp":"2020-09-05T20:18:24.697+08","level":"info","content":"register dir /asset/:1/:2/:3/:4/:5 ./assets"}
{"@timestamp":"2020-09-05T20:18:24.697+08","level":"info","content":"register dir /asset/:1/:2/:3/:4/:5/:6 ./assets"}
{"@timestamp":"2020-09-05T20:18:24.698+08","level":"info","content":"register dir /asset/:1/:2/:3/:4/:5/:6/:7 ./assets"}
訪問系統都能正常響應
http://127.0.0.1:8888/asset/images/avatar.jpg http://127.0.0.1:8888/asset/js/test.js http://127.0.0.1:8888/asset/js/lv2/test.js
注意,請求的是
/asset/**不是/assets/**
思考一下
我們可以在NotFoundHandler中根據req.URL.path來實現文件服務,如何實現呢?
下章預告
單體應用需要的基本梳理完,明天開始微服務
本文代碼獲取
關注公衆號betaidea 輸入file即可獲得本文相關代碼 關注公衆號betaidea 輸入html即可獲得html解析相關代碼 關注公衆號betaidea 輸入jwt即可獲得gozero集成jwt-token相關代碼 關注公衆號betaidea 輸入gozero即可gozero入門代碼
廣而告之
送福利了uniapp用戶福音來啦！ 歷經數十萬用戶考驗,我們的客服系統終於對外提供服務了。 你還在爲商城接入客服煩惱嗎?只需一行代碼,即可接入啦!! 只需一行代碼!!!!
/*kefu.vue*/
<template>
<view>
<IdeaKefu :siteid="siteId" ></IdeaKefu>
</view>
</template>
<script>
import IdeaKefu from "@/components/idea-kefu/idea-kefu.vue"
export default {
components:{
IdeaKefu
},
data() {
return {
siteId:2
}
}
}
效果槓槓的 