README.md

主題：Fast and Efficient Microservices with gRPC

• 活動資訊：Fast and Efficient Microservices with gRPC
• gRPC 官方資源
  • Quick Start :: Java
  • github :: grpc-java

前言

這份素材是活動 Fast and Efficient Microservices with gRPC 的初階材料，若聽眾已經能完成下列事項，那可以略過此份素材：

• 將撰寫好的 protobuf idl (.proto) 檔編譯為 java source code，並產生 grpc stubs
• 使用 maven 或 gradle 編譯 grpc 專案

gRPC 簡易上手篇

在初開始學習用 gRPC 時，看了網官的 Quick Start :: Java 但還是不知道如何下手，特別是想要建立 gradle 專案時，看了一堆眼花撩亂的 DSL 想著該由哪開始好呢？這也是為什麼試著提供『又』一篇的簡易上手文件。

在這份素材打算的編寫方式是將修改方式透過 git commit 保留下來，讓讀者能透過 git log (透過 github 的 history 回顧)，我們最先做的事情為：

gradle init --type java-application

建立一個新的 java application 專案 (此為 gradle 4.x 後的新功能，終於對廣大懷念 maven archetype 的使用者最出回應了）。

Hello gRPC

我們的目標在示範怎麼建構出一個 gRPC 專案的 流程，而非 gRPC 本身該怎麼使用 (這就請活動當天聽講者替我們好好分享囉)，所以我們直接採用 grpc-java repo 內的 examples 檔案，，我們將使用 v1.16.1 版的 release 把 Hello World 專案建出來。

需要的檔案有：

• idl 檔 src/main/proto/helloworld.proto
• examples/helloworld 下的 Client 與 Server
  • HelloWorldClient.java
  • HelloWorldServer.java

接著得做：

• 複製 helloworld.proto 回來，並設定好 gradle (因為 grpc stub 還沒生出來，放 Client 與 Server 會缺 class 不能用呦)
  • gradle
    • 設定 com.google.protobuf
    • 設定 grpc code generator 參數
    • 設定 generated code 加入 source set 讓 IDE 能知道它的位置
• 執行 gradle build 產生 grpc stub
• 用 gradle 產生 IDE 對應的 metadata (就看你想用哪個了)
• 複製 Client 與 Server 回來，就能在 IDE 內玩囉

注意事項

• 若改了 .proto 檔（在沒 IDE plugin 輔助下) 應該重跑 gradle build 產生新的 grpc stub
• 因為 grpc stub 是在 gradle build 時生出來的，若檔案改太多，建議先跑 clean 讓它把舊的都刪掉比較好些。

給趕時間的人

請直接 clone 專案，此目錄的程式是能直接使用的。

Eclipse

產生 eclipse 專資料

./gradlew  clean build eclipse

IntelliJ

使用 IntelliJ 開啟

./gradlew clean build openIdea