读gRPC Microservices in Go第三章

syntax = "proto3";               // 协议版本
message CreateOrderRequest {
  int64 user_id = 1;
  repeated Item items = 2;
  float amount = 3;
}

message CreateOrderRequest {
  reserved 1, 2, 3 to 7;      // 通过单个或范围数字如3至7预留
  reserved "customer_id";     // 因为引入了user_id而保留customer_id。
  int64 user_id = 7;
  repeated Item items = 8;
  float amount = 9;
}

// order.proto
message CreateOrderRequest {
    int64 user_id = 1;
}
 
// main.go
request := CreateOrderRequest{
    UserId: 65
}

protoc -I ./proto \                         // 导入包将在此位置搜索
   --go_out ./golang \                      // 消息的生成源代码位置
   --go_opt paths=source_relative \         // 输出文件放置在与输入文件相同的相对目录中
   --go-grpc_out ./golang \                 // 服务函数的生成源代码位置
   --go-grpc_opt paths=source_relative \    // 输出文件放置在与输入文件相同的相对目录中
   ./proto/order.proto                      // 输入文件的位置

// 在同一个项目中的另一个模块内
import "GitHub/huseyinbabal/microservices/order"
...
client := order.NewOrderClient(...)
client.Create(ctx, &CreateOrderRequest{
    UserId: 123
})

├── golang                     // Go语言的生成代码位置
│   ├── order
│   │   ├── go.mod             // order服务的依赖文件
│   │   ├── go.sum             // go.mod文件的校验和定义
│   │   ├── order.pb.go        // 消息的生成Go代码
│   │   └── order_grpc.pb.go   // 服务函数的生成Go代码
│   ├── payment
│   │   ├── go.mod
│   │   ├── go.sum
│   │   ├── payment.pb.go
│   │   └── payment_grpc.pb.go
│   └── shipping
│       ├── go.mod
│       ├── go.sum
│       ├── shipping.pb.go
│       └── shipping_grpc.pb.go
├── order
│   └── order.proto
├── payment
│   └── payment.proto
└── shipping
    └── shipping.proto

#!/bin/bash
SERVICE_NAME=$1
RELEASE_VERSION=$2
 
sudo apt-get install -y protobuf-compiler golang-goprotobuf-dev    # 安装所需的编译工具
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
protoc --go_out=./golang --go_opt=paths=source_relative \          # Go源代码生成
  --go-grpc_out=./golang --go-grpc_opt=paths=source_relative \
 ./${SERVICE_NAME}/*.proto
cd golang/${SERVICE_NAME}
go mod init \                                                      # 初始化Go模块
  github.com/huseyinbabal/microservices-proto/golang/${SERVICE_NAME} ||true
go mod tidy                                                        # 刷新依赖
cd ../../
git config --global user.email "huseyinbabal88@gmail.com"
git config --global user.name "Huseyin BABAL"
git add . && git commit -am "proto update" || true
git tag -fa golang/${SERVICE_NAME}/${RELEASE_VERSION} \
  -m "golang/${SERVICE_NAME}/${RELEASE_VERSION}"
git push origin refs/tags/golang/${SERVICE_NAME}/${RELEASE_VERSION}

name: "Protocol Buffer Go Stubs Generation"
on:
  push:
    tags:
      - v**                                                                # 触发工作流的标签（例如，v1.2.3）
jobs:
  protoc:
    name: "Generate"
    runs-on: ubuntu-latest
    strategy:
      matrix:
        service: ["order", "payment", "shipping"]                          # 要生成的服务列表
    steps:
      - name: Install Go
        uses: actions/setup-go@v2
        with:
          go-version: 1.17
      - uses: actions/checkout@v2
      - name: Extract Release Version
        run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV   # 提取版本
      - name: "Generate for Golang"
        shell: bash
        run: |
          chmod +x "${GITHUB_WORKSPACE}/run.sh"                            # 使Bash脚本可执行
          ./run.sh ${{ matrix.service }} ${{ env.RELEASE_VERSION }}        # 为每个服务生成Go源代码

Func (p *Payment) Create(ctx, req *pb.CreatePaymentRequest) (*pb.CreatePaymentResponse, error) {
    vat := VAT
    if req.Vat > 0 {
        vat = req.Vat
    }
    return &CreatePaymentResponse{
        TotalPrice: vat + req.Price
    }, nil
}

message CreatePaymentRequest {
    oneof payment_method  {
        CreditCard credit_card = 1;
        PromoCode promo_code = 2;
    }
}