我用go-zero開發了第一個線上專案
阿新 • • 發佈:2020-12-18
作者:結冰
## 前言
說在最前面,我是一個外表謙讓,內心狂熱,外表斯文,內心貪玩的一個普通人。我的職業是程式設計師,是一個golang語言愛好者,一半是因為golang好用,一半是因為其他語言學不好。我是從phper轉為gopher的,寫php的時候我認識了網際網路軟體,寫go的時候感覺自己終於在程式設計。
## 初見golang
我大學專業是軟體。第一門程式語言是C++,知道了指標,知道了加減乘除,知道了程式設計去控制軟硬體。後來選修了java,被ssh框架戲耍了一個暑假。再後來進入了一個社團技術部,再被html/css/js打擊了自己信心。高中年級總能排名前幾的我,真的開始懷疑人生了。再再後來進入了一家遊戲平臺公司,開始了php的編寫之旅。“噢!”,終於,我知道了什麼是網際網路,折磨我的程式語言c++/java/html/css,原來還可以這樣子“變現”。
剛入門了網際網路的我,心裡是真的喜悅。不過,重複的東西做多了,總是少不了厭倦。每天都是寫php,都是那些增刪改查,都是修改資料表,增加欄位,增加臨時表。真的,開始膩了。“聽說最新公司在用新的程式語言golang”,我,想去試試。但,我不敢,心裡有對自己和對golang的懷疑,因此我不是第一個去拜師的。當golang在公司流行了兩個月,我的leader讓我去用一下golang。終於,我師出有名了。淺嘗了一週的golang之後,我!!發現!!
1. golang是有指標的,這不是大學熟悉的C++那樣的指標嗎
2. golang是編譯語言,原來客戶端的“打包、打包”,原來是這麼一回事
3. golang是可以做定時器的,換用php該怎麼搞啊?很麻煩的吧。
4. golang不用寫分號,不用寫括號,看起來很簡單啊,效能又很好啊!
5. golang原生支援web服務,原來不用nginx也可以起一個web服務啊
6. .......還有很多很多
## 喜歡golang
嘗試了golang之後,我發現我喜歡上了golang了。
### golang嚴謹
golang中不提倡多餘的變數。gopher都知道,golang變數不使用,直接會報編譯錯誤!這讓我刮目相看!在我看來,是把嚴謹提升了一個階段,只要你是gopher,就會強迫你變得嚴謹。golang變數這個屬性,秉承了golang的設計理念,嚴謹這個理念貫穿了golang的各處。
曾經有一個CTO跟我說,定義的每一個變數、每一個欄位,都應該有它的作用。多餘的程式碼,多餘的變數,多餘的欄位,除了誤導別人,弄髒程式碼,別無他用。我,表示絕對贊同!
### golang效能好
單單靠golang的簡單、嚴謹,當然上不了程式設計師的舞臺。可恨的是,golang效能還很好!比C++要差點,但是就web應用的併發、資源佔用來說,比java、python、php、nodejs都是要優秀的。具體資料大家上網一搜比比皆是。一個語法簡單、效能又好、入門只需一週的語言,反正我是入坑了。
有段時間,我太熱愛golang了導致認為golang可以做任何事情。不過慢慢,我理性了。做web應用,首選golang。做資料分析、爬蟲、圖片處理還是python吧。但要是有人說用java去寫web後臺,cms型別還好,要是面向市場使用者的,spring boot那套,spring cloud那套,我覺得,遠遠遠遠遠遠遠比不上用golang相關的框架,java還是去做那些單體應用吧。
### golang輕量
golang還有另外一個屬性,就是“輕”,有多輕?對比一下java的jvm那套容器,你就知道有多輕了。幾行程式碼就能實現一個原生web服務了,docker這個跨時代的產物就是golang寫的。etcd這個分散式基石也是golang寫的,雲原生這個跨時代的名詞,很多元件都是golang貢獻的。“微服務”這個面試必問的名詞,golang可以對它做最好的詮釋。
## go-zero一見如故
後來我進入了一家直播公司,剛好遇到了公司的波動,讓我有了停下來自省的時間。其間,喜歡逛逛github,稍有目的去逛一下golang的開源專案。比如gin,iris,go-micro,go-zero,sentinel-golang,gin-vue-admin等等等啦。一開始,go-zero並不是特別吸引我,可能是部落格/github佈局不夠亮眼吧。但是,當我哪天沉下來看go-zero的文件,開始敲起第一個goctl的命令,我好像,好像!已經停不下來。
go-zero,用起來,真的很舒服!
我剛在遊戲平臺公司實習轉正的時候,也是可以帶一兩個實習生的。當時我就有個想法,“如何讓員工都敲出規範、高效的程式碼”。當時想了下用go-template,但是因為學藝未精,推進不下去。時隔幾年,當我接觸到go-zero的goctl後,發現,居然有大佬實現了當年我的想法!雖然我技術不大行,但是夢想還是要有的,go-zero對我來說太親切了。搞!肝!!
一週時間,過完了go-zero的github文件以及語雀文件,中途也自己練手了幾個demo。可真是越敲越舒服。迫不及待地用想找個實際專案投入生產!果真不久有個機會來了,公司想做一個簡單的app做投放調研,允許重新搭建一個新的後臺web專案,我!go-zero!義不容辭,開幹。又花了兩週時間,寫完了一個後臺web服務,裡面有下面板塊
1. 使用者板塊
2. 諮詢板塊
3. 報告板塊
4. 支付板塊
5. 廣告板塊
截個圖看看我的專案結構,由於還是公司專案,暫時不會開源啦,不過凡是go-zeroer都能看懂
![go-zero目錄](https://img2020.cnblogs.com/other/14470/202012/14470-20201218070040733-416307473.jpg)
簡單說明一下:
1. api目錄,就是http1.1的web服務,跟前端對接
2. rpc目錄,rpc服務,基本和api一一對應
3. enum目錄,列舉目錄,裡面存放的是各種各樣的列舉值,我把它提到一等公民了
4. model目錄,資料庫model,目前都是用goctl根據mysql生成的model
5. utils目錄,這裡主要存放我的一些小工具包,例如int/string/time的一些操作,參考了下go-zero的命名方法,子目錄一般會以x結尾,例如intx,timex,stringx等等
6. worker目錄,主要是做一些消費者模型的消費者,例如kafka的消費者,google訂閱通知的消費者等等
7. ws目錄,存放websocket相關的服務,例如私聊
感謝下go-zero,讓我對專案的組織結構有了一個簡單的標準。worker、ws等服務,以前的專案結構都雜亂無章,目前都是參考go-zero生成api的目錄結構了:
1. main.go入口
2. etc存放配置,
3. internal內部目錄
1. config:配置
2. handler:處理器
3. logic:邏輯處理
4. types:中間型別
## go-zero理念
“工具大於約定和文件”,這,就是go-zero的理念。我,表示極度贊同!
go-zero的最大特點,就是goctl。goctl是什麼?就是能根據協議文件,生成程式碼的一個神器。例如
1. 定了a.proto檔案,goctl rpc proto a.proto -dir . 即可生成rpc服務
2. 定了b.sql檔案,goctl model mysql ddl -c -src b.sql -dir . 即可生成模板model檔案
3. 定了c.api檔案(go-zero出品),goctl api go -api ad-api.api -dir . 即可生成api檔案
再配合上golang的jb IDE,程式碼提醒,程式碼格式化,一個go-zero的生態,就出來了。一個字:舒服!!
## go-zero小工具
除了goctl神器,另外一個讓我拜服的點是,go-zero的一些小工具。
1. 流資料處理利器:fx。聽說java8的lambda很炫酷,go-zero也有了!fx.Filter().Sort().Head() ,讓陣列的複雜處理變得簡單
2. mapReduce降低服務相應時間:mr.Finish(), mr.Map().Reduce(), 跟併發處理waitGroup說拜拜!
3. etcd服務發現的整合:p2c的演算法發現服務,免卻了開發們點對點或nginx的轉發服務,安裝一個etcd就完事了
4. jwt整合api:輕鬆擁有一個jwt的後臺服務
5. 整合Prometheus:輕鬆擁有一個帶監控的golang後臺服務
6. 等等等
二次感謝go-zero,還有很多小工具,等待我去看原始碼,時間輪/排程器等等啦。go-zero有點像我學習的導師一樣。
## go-zero拓展
go-zero為小白如我的gopher們,提供了一個功能完備、效能可觀、開發迅速的web框架。然而,它不像其他框架那樣約束著我,我還是能裡面做很多發揮的。雖然不是大牛級別的發揮,但是,個性化操作還是支援的:
1. model層,完全可以接入gorm代替掉內建的sqlx,雖然就沒了大佬辛苦做的快取擊穿等防護的功能。當然也可以兩者並存。
2. rpc層,不必約定要api層去呼叫。例如我上面截圖的worker/ws層去呼叫完全沒問題。
3. api層自己生成的middleware,可以抽離出到公共目錄,那就可以多個api目錄使用同一個middlerware了。
4. 等等等啦
go-zero 很輕量、很便捷、很博學。裡面蘊藏的著很多知識以及理念。目前我只是用了皮毛,go-zero的k8s部署,目前我沒開始接入。繼續努力努力學習啦!
## 再次感謝
1. https://www.yuque.com/tal-tech/go-zero/yaoehb go-zero語雀文件
2. https://github.com/tal-tech/go-zero go-zero原始碼
> 專案地址:
> [https://github.com/tal-tech/go-zero](https://github.com/tal-tech/