后端、go语言、使用Go语言和Gin框架快速上手项目

[**micro-cluster 中文示例**](https://www.bilibili.com/read/cv23255594) <br> By taking a simple e-commerce microservice cluster as an example, the product details page contains product information, inventory information, and product evaluation information. These data are scattered in different microservices. The RPC gateway service assembles the required data and returns it to the product details page, as shown in the following figure:  Four proto files have been prepared in advance. Each proto file generates corresponding service code: - The comment.proto file defines RPC methods to obtain comment data based on the product ID and is used to generate the comment RPC service code. - The inventory.proto file defines RPC methods to obtain inventory data based on the product ID and is used to generate the inventory RPC service code. - The product.proto file defines RPC methods to obtain product details based on the product ID and is used to generate the product RPC service code. - The shop_gw.proto file defines RPC methods to assemble the data required by the product details page based on the product ID and is used to generate the shop RPC gateway service code. <br> ### Quickly generate and start comment, inventory, and product microservices #### Generate comment, inventory, and product microservice code Enter the Sponge UI interface, click the left menu bar 【Protobuf】--> 【RPC type】-->【Create RPC project】, fill in the respective parameters of the comment, inventory, and product, and generate the comment, inventory, and product service code respectively. The microservice framework uses [grpc](https://github.com/grpc/grpc-go) and also contains common service governance function codes, build deployment scripts, etc. You can choose whatever database you want. Quickly create a comment service as shown below:  Quickly create an inventory service as shown below:  Quickly create a product service as shown below:  Open three terminals, one for each of the comment, inventory, and product services. <br> #### Start the comment service Switch to the comment directory and perform the following steps: (1) Generate pb.go code, generate template code, and generate test code ```shell make proto ``` (2) Open internal/service/comment.go, which is the generated template code. There is a line of panic code prompting you to fill in the business logic code. Fill in the business logic here, for example, fill in the return value: ```go return &commentV1.ListByProductIDReply{ Total: 11, ProductID: 1, CommentDetails: []*commentV1.CommentDetail{ { Id: 1, Username: "Mr Zhang", Content: "good", }, { Id: 2, Username: "Mr Li", Content: "good", }, { Id: 3, Username: "Mr Wang", Content: "not good", }, }, }, nil ``` (3) Open the configs/comment.yml configuration file, find grpc, and modify the port and httpPort values under it: ```yaml grpc: port: 18203 # listen port httpPort: 18213 # profile and metrics ports ``` (4) Compile and start the comment service ```shell make run ``` <br> #### Start the inventory service Switch to the inventory directory and perform the same steps as for the comment: (1) Generate pb.go code, generate template code, and generate test code ```shell make proto ``` (2) Open internal/service/inventory.go, which is the generated template code. There is a line of panic code prompting you to fill in the business logic code. Fill in the business logic here, for example, fill in the return value: ```go return &inventoryV1.GetByIDReply{ InventoryDetail: &inventoryV1.InventoryDetail{ Id: 1, Num: 999, SoldNum: 111, }, }, nil ``` (3) Open the configs/inventory.yml configuration file, find grpc, and modify the port and httpPort values under it: ```yaml grpc: port: 28203 # listen port httpPort: 28213 # profile and metrics ports ``` (4) Compile and start the inventory service ```shell make run ``` <br> #### Start the product service Switch to the product directory and perform the same steps as for the comment: (1) Generate pb.go code, generate template code, and generate test code ```shell make proto ``` (2) Open internal/service/product.go, which is the generated template code. There is a line of panic code prompting you to fill in the business logic code. Fill in the business logic here, for example, fill in the return value: ```go return &productV1.GetByIDReply{ ProductDetail: &productV1.ProductDetail{ Id: 1, Name: "Data cable", Price: 10, Description: "Android type c data cable", }, InventoryID: 1, }, nil ``` (3) Open the configs/product.yml configuration file, find grpc, and modify the port and httpPort values under it: ```yaml grpc: port: 38203 # listen port httpPort: 38213 # profile and metrics ports ``` (4) Compile and start the product service ```shell make run ``` After the comment, inventory, and product microservices have started successfully, you can now generate and start the gateway service. <br> ### Quickly generate and start the RPC gateway service Enter the Sponge UI interface, click the left menu bar 【Protobuf】--> 【Web type】-->【Create RPC gateway project】, fill in some parameters to generate the RPC gateway project code. The web framework uses [gin](https://github.com/gin-gonic/gin), which also contains swagger documentation, common service governance function codes, build deployment scripts, etc.  In order to connect to the comment, inventory, and product RPC services, you need to generate additional connection RPC service codes. Click the left menu bar 【Public】--> 【Generate connection RPC service code】, fill in the parameters to generate the code, and then move the generated connection RPC service code to the RPC gateway project code directory.  In order to call the methods of the RPC services in the RPC gateway service, you need to copy the proto files of the comment, inventory, and product RPC services to the api/shop_gw/v1 directory of the RPC gateway service. Switch to the shop_gw directory and perform the following steps: (1) Generate pb.go code, generate registered routing code, generate template code, and generate swagger documentation ```shell make proto ``` (2) Open internal/service/shop_gw_logic.go, which is the generated API interface code. Fill in the business logic code here, fill in the following simple business logic code: ```go package service import ( "context" commentV1 "shop_gw/api/comment/v1" inventoryV1 "shop_gw/api/inventory/v1" productV1 "shop_gw/api/product/v1" shop_gwV1 "shop_gw/api/shop_gw/v1" "shop_gw/internal/ecode" "shop_gw/internal/rpcclient" "github.com/zhufuyi/sponge/pkg/grpc/interceptor" "github.com/zhufuyi/sponge/pkg/logger" ) var _ shop_gwV1.ShopGwLogicer = (*shopGwClient)(nil) type shopGwClient struct { productCli productV1.ProductClient inventoryCli inventoryV1.InventoryClient commentCli commentV1.CommentClient } // NewShopGwClient create a client func NewShopGwClient() shop_gwV1.ShopGwLogicer { return &shopGwClient{ productCli: productV1.NewProdu