帶你十天輕鬆搞定 Go 微服務系列(六)
序言
我們通過一個系列文章跟大家詳細展示一個 go-zero 微服務示例,整個系列分十篇文章,目錄結構如下:
- 環境搭建
- 服務拆分
- 使用者服務
- 產品服務
- 訂單服務
- 支付服務(本文)
- RPC 服務 Auth 驗證
- 服務監控
- 鏈路追蹤
- 分散式事務
期望通過本系列帶你在本機利用 Docker 環境利用 go-zero 快速開發一個商城系統,讓你快速上手微服務。
完整示例程式碼:http://github.com/nivin-studio/go-zero-mall
首先,我們來看一下整體的服務拆分圖:
6 支付服務(pay)
- 進入服務工作區
$ cd mall/service/pay
6.1 生成 pay model 模型
- 建立 sql 檔案
$ vim model/pay.sql
- 編寫 sql 檔案
CREATE TABLE `pay` (
`id` bigint unsigned NOT NULL AUTO_INCREMENT,
`uid` bigint unsigned NOT NULL DEFAULT '0' COMMENT '使用者ID',
`oid` bigint unsigned NOT NULL DEFAULT '0' COMMENT '訂單ID',
`amount` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '產品金額',
`source` tinyint(3) unsigned NOT NULL DEFAULT '0' COMMENT '支付方式',
`status` tinyint(3) unsigned NOT NULL DEFAULT '0' COMMENT '支付狀態',
`create_time` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
`update_time` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
KEY `idx_uid` (`uid`),
KEY `idx_oid` (`oid`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
- 執行模板生成命令
$ goctl model mysql ddl -src ./model/pay.sql -dir ./model -c
6.2 生成 pay api 服務
- 建立 api 檔案
$ vim api/pay.api
- 編寫 api 檔案
type (
// 支付建立
CreateRequest {
Uid int64 `json:"uid"`
Oid int64 `json:"oid"`
Amount int64 `json:"amount"`
}
CreateResponse {
Id int64 `json:"id"`
}
// 支付建立
// 支付詳情
DetailRequest {
Id int64 `json:"id"`
}
DetailResponse {
Id int64 `json:"id"`
Uid int64 `json:"uid"`
Oid int64 `json:"oid"`
Amount int64 `json:"amount"`
Source int64 `json:"source"`
Status int64 `json:"status"`
}
// 支付詳情
// 支付回撥
CallbackRequest {
Id int64 `json:"id"`
Uid int64 `json:"uid"`
Oid int64 `json:"oid"`
Amount int64 `json:"amount"`
Source int64 `json:"source"`
Status int64 `json:"status"`
}
CallbackResponse {
}
// 支付回撥
)
@server(
jwt: Auth
)
service Pay {
@handler Create
post /api/pay/create(CreateRequest) returns (CreateResponse)
@handler Detail
post /api/pay/detail(DetailRequest) returns (DetailResponse)
@handler Callback
post /api/pay/callback(CallbackRequest) returns (CallbackResponse)
}
- 執行模板生成命令
$ goctl api go -api ./api/pay.api -dir ./api
6.3 生成 pay rpc 服務
- 建立 proto 檔案
$ vim rpc/pay.proto
- 編寫 proto 檔案
syntax = "proto3";
package payclient;
option go_package = "pay";
// 支付建立
message CreateRequest {
int64 Uid = 1;
int64 Oid = 2;
int64 Amount = 3;
}
message CreateResponse {
int64 id = 1;
}
// 支付建立
// 支付詳情
message DetailRequest {
int64 id = 1;
}
message DetailResponse {
int64 id = 1;
int64 Uid = 2;
int64 Oid = 3;
int64 Amount = 4;
int64 Source = 5;
int64 Status = 6;
}
// 支付詳情
// 支付詳情
message CallbackRequest {
int64 id = 1;
int64 Uid = 2;
int64 Oid = 3;
int64 Amount = 4;
int64 Source = 5;
int64 Status = 6;
}
message CallbackResponse {
}
// 支付詳情
service Pay {
rpc Create(CreateRequest) returns(CreateResponse);
rpc Detail(DetailRequest) returns(DetailResponse);
rpc Callback(CallbackRequest) returns(CallbackResponse);
}
- 執行模板生成命令
$ goctl rpc proto -src ./rpc/pay.proto -dir ./rpc
6.4 編寫 pay rpc 服務
6.4.1 修改配置檔案
- 修改 pay.yaml 配置檔案
$ vim rpc/etc/pay.yaml
- 修改服務監聽地址,埠號為0.0.0.0:9003,
Etcd
服務配置,Mysql
服務配置,CacheRedis
服務配置
Name: pay.rpc
ListenOn: 0.0.0.0:9003
Etcd:
Hosts:
- etcd:2379
Key: pay.rpc
Mysql:
DataSource: root:[email protected](mysql:3306)/mall?charset=utf8mb4&parseTime=true&loc=Asia%2FShanghai
CacheRedis:
- Host: redis:6379
Type: node
Pass:
6.4.2 新增 pay model 依賴
- 新增
Mysql
服務配置,CacheRedis
服務配置的例項化
$ vim rpc/internal/config/config.go
package config
import (
"github.com/tal-tech/go-zero/core/stores/cache"
"github.com/tal-tech/go-zero/zrpc"
)
type Config struct {
zrpc.RpcServerConf
Mysql struct {
DataSource string
}
CacheRedis cache.CacheConf
}
- 註冊服務上下文
pay model
的依賴
$ vim rpc/internal/svc/servicecontext.go
package svc
import (
"mall/service/pay/model"
"mall/service/pay/rpc/internal/config"
"github.com/tal-tech/go-zero/core/stores/sqlx"
)
type ServiceContext struct {
Config config.Config
PayModel model.PayModel
}
func NewServiceContext(c config.Config) *ServiceContext {
conn := sqlx.NewMysql(c.Mysql.DataSource)
return &ServiceContext{
Config: c,
PayModel: model.NewPayModel(conn, c.CacheRedis),
}
}
6.4.3 新增 user rpc,order rpc 依賴
- 新增
user rpc, order rpc
服務配置
$ vim rpc/etc/pay.yaml
Name: pay.rpc
ListenOn: 0.0.0.0:9003
Etcd:
Hosts:
- etcd:2379
Key: pay.rpc
...
UserRpc:
Etcd:
Hosts:
- etcd:2379
Key: user.rpc
OrderRpc:
Etcd:
Hosts:
- etcd:2379
Key: order.rpc
- 新增
user rpc, order rpc
服務配置的例項化
$ vim rpc/internal/config/config.go
package config
import (
"github.com/tal-tech/go-zero/core/stores/cache"
"github.com/tal-tech/go-zero/zrpc"
)
type Config struct {
zrpc.RpcServerConf
Mysql struct {
DataSource string
}
CacheRedis cache.CacheConf
UserRpc zrpc.RpcClientConf
OrderRpc zrpc.RpcClientConf
}
- 註冊服務上下文
user rpc, order rpc
的依賴
$ vim rpc/internal/svc/servicecontext.go
package svc
import (
"mall/service/order/rpc/orderclient"
"mall/service/pay/model"
"mall/service/pay/rpc/internal/config"
"mall/service/user/rpc/userclient"
"github.com/tal-tech/go-zero/core/stores/sqlx"
"github.com/tal-tech/go-zero/zrpc"
)
type ServiceContext struct {
Config config.Config
PayModel model.PayModel
UserRpc userclient.User
OrderRpc orderclient.Order
}
func NewServiceContext(c config.Config) *ServiceContext {
conn := sqlx.NewMysql(c.Mysql.DataSource)
return &ServiceContext{
Config: c,
PayModel: model.NewPayModel(conn, c.CacheRedis),
UserRpc: userclient.NewUser(zrpc.MustNewClient(c.UserRpc)),
OrderRpc: orderclient.NewOrder(zrpc.MustNewClient(c.OrderRpc)),
}
}
6.4.4 新增支付建立邏輯 Create
- 新增根據
oid
查詢訂單支付記錄PayModel
方法FindOneByOid
$ vim model/paymodel.go
package model
...
var (
...
cachePayIdPrefix = "cache:pay:id:"
cachePayOidPrefix = "cache:pay:oid:"
)
type (
PayModel interface {
Insert(data *Pay) (sql.Result, error)
FindOne(id int64) (*Pay, error)
FindOneByOid(oid int64) (*Pay, error)
Update(data *Pay) error
Delete(id int64) error
}
...
)
...
func (m *defaultPayModel) FindOneByOid(oid int64) (*Pay, error) {
payOidKey := fmt.Sprintf("%s%v", cachePayOidPrefix, oid)
var resp Pay
err := m.QueryRow(&resp, payOidKey, func(conn sqlx.SqlConn, v interface{}) error {
query := fmt.Sprintf("select %s from %s where `oid` = ? limit 1", payRows, m.table)
return conn.QueryRow(v, query, oid)
})
switch err {
case nil:
return &resp, nil
case sqlc.ErrNotFound:
return nil, ErrNotFound
default:
return nil, err
}
}
......
-
新增支付建立邏輯
支付流水建立流程,通過呼叫
user rpc
服務查詢驗證使用者是否存在,再通過呼叫order rpc
服務查詢驗證訂單是否存在,然後通過查詢庫判斷此訂單是否已經建立過支付流水,最後建立落庫。
$ vim rpc/internal/logic/createlogic.go
package logic
import (
"context"
"mall/service/order/rpc/order"
"mall/service/pay/model"
"mall/service/pay/rpc/internal/svc"
"mall/service/pay/rpc/pay"
"mall/service/user/rpc/user"
"github.com/tal-tech/go-zero/core/logx"
"google.golang.org/grpc/status"
)
type CreateLogic struct {
ctx context.Context
svcCtx *svc.ServiceContext
logx.Logger
}
func NewCreateLogic(ctx context.Context, svcCtx *svc.ServiceContext) *CreateLogic {
return &CreateLogic{
ctx: ctx,
svcCtx: svcCtx,
Logger: logx.WithContext(ctx),
}
}
func (l *CreateLogic) Create(in *pay.CreateRequest) (*pay.CreateResponse, error) {
// 查詢使用者是否存在
_, err := l.svcCtx.UserRpc.UserInfo(l.ctx, &user.UserInfoRequest{
Id: in.Uid,
})
if err != nil {
return nil, err
}
// 查詢訂單是否存在
_, err = l.svcCtx.OrderRpc.Detail(l.ctx, &order.DetailRequest{
Id: in.Oid,
})
if err != nil {
return nil, err
}
// 查詢訂單是否已經建立支付
_, err = l.svcCtx.PayModel.FindOneByOid(in.Oid)
if err == nil {
return nil, status.Error(100, "訂單已建立支付")
}
newPay := model.Pay{
Uid: in.Uid,
Oid: in.Oid,
Amount: in.Amount,
Source: 0,
Status: 0,
}
res, err := l.svcCtx.PayModel.Insert(&newPay)
if err != nil {
return nil, status.Error(500, err.Error())
}
newPay.Id, err = res.LastInsertId()
if err != nil {
return nil, status.Error(500, err.Error())
}
return &pay.CreateResponse{
Id: newPay.Id,
}, nil
}
6.4.5 新增支付詳情邏輯 Detail
$ vim rpc/internal/logic/detaillogic.go
package logic
import (
"context"
"mall/service/pay/model"
"mall/service/pay/rpc/internal/svc"
"mall/service/pay/rpc/pay"
"github.com/tal-tech/go-zero/core/logx"
"google.golang.org/grpc/status"
)
type DetailLogic struct {
ctx context.Context
svcCtx *svc.ServiceContext
logx.Logger
}
func NewDetailLogic(ctx context.Context, svcCtx *svc.ServiceContext) *DetailLogic {
return &DetailLogic{
ctx: ctx,
svcCtx: svcCtx,
Logger: logx.WithContext(ctx),
}
}
func (l *DetailLogic) Detail(in *pay.DetailRequest) (*pay.DetailResponse, error) {
// 查詢支付是否存在
res, err := l.svcCtx.PayModel.FindOne(in.Id)
if err != nil {
if err == model.ErrNotFound {
return nil, status.Error(100, "支付不存在")
}
return nil, status.Error(500, err.Error())
}
return &pay.DetailResponse{
Id: res.Id,
Uid: res.Uid,
Oid: res.Oid,
Amount: res.Amount,
Source: res.Source,
Status: res.Status,
}, nil
}
6.4.6 新增支付回撥邏輯 Callback
支付流水回撥流程,通過呼叫 user rpc
服務查詢驗證使用者是否存在,再通過呼叫 order rpc
服務查詢驗證訂單是否存在,然後通過查詢庫判斷此訂單支付流水是否存在,以及回撥支付金額和庫中流水支付金額是否一致,最後更新支付流水狀態和通過呼叫 order rpc
服務更新訂單狀態。
$ vim rpc/internal/logic/callbacklogic.go
package logic
import (
"context"
"mall/service/order/rpc/order"
"mall/service/pay/model"
"mall/service/pay/rpc/internal/svc"
"mall/service/pay/rpc/pay"
"mall/service/user/rpc/user"
"github.com/tal-tech/go-zero/core/logx"
"google.golang.org/grpc/status"
)
type CallbackLogic struct {
ctx context.Context
svcCtx *svc.ServiceContext
logx.Logger
}
func NewCallbackLogic(ctx context.Context, svcCtx *svc.ServiceContext) *CallbackLogic {
return &CallbackLogic{
ctx: ctx,
svcCtx: svcCtx,
Logger: logx.WithContext(ctx),
}
}
func (l *CallbackLogic) Callback(in *pay.CallbackRequest) (*pay.CallbackResponse, error) {
// 查詢使用者是否存在
_, err := l.svcCtx.UserRpc.UserInfo(l.ctx, &user.UserInfoRequest{
Id: in.Uid,
})
if err != nil {
return nil, err
}
// 查詢訂單是否存在
_, err = l.svcCtx.OrderRpc.Detail(l.ctx, &order.DetailRequest{
Id: in.Oid,
})
if err != nil {
return nil, err
}
// 查詢支付是否存在
res, err := l.svcCtx.PayModel.FindOne(in.Id)
if err != nil {
if err == model.ErrNotFound {
return nil, status.Error(100, "支付不存在")
}
return nil, status.Error(500, err.Error())
}
// 支付金額與訂單金額不符
if in.Amount != res.Amount {
return nil, status.Error(100, "支付金額與訂單金額不符")
}
res.Source = in.Source
res.Status = in.Status
err = l.svcCtx.PayModel.Update(res)
if err != nil {
return nil, status.Error(500, err.Error())
}
// 更新訂單支付狀態
_, err = l.svcCtx.OrderRpc.Paid(l.ctx, &order.PaidRequest{
Id: in.Oid,
})
if err != nil {
return nil, status.Error(500, err.Error())
}
return &pay.CallbackResponse{}, nil
}
6.5 編寫 pay api 服務
6.5.1 修改配置檔案
- 修改 pay.yaml 配置檔案
$ vim api/etc/pay.yaml
- 修改服務地址,埠號為0.0.0.0:8003,
Mysql
服務配置,CacheRedis
服務配置,Auth
驗證配置
Name: Pay
Host: 0.0.0.0
Port: 8003
Mysql:
DataSource: root:[email protected](mysql:3306)/mall?charset=utf8mb4&parseTime=true&loc=Asia%2FShanghai
CacheRedis:
- Host: redis:6379
Type: node
Pass:
Auth:
AccessSecret: uOvKLmVfztaXGpNYd4Z0I1SiT7MweJhl
AccessExpire: 86400
6.5.2 新增 pay rpc 依賴
- 新增
pay rpc
服務配置
$ vim api/etc/pay.yaml
Name: Pay
Host: 0.0.0.0
Port: 8003
......
PayRpc:
Etcd:
Hosts:
- etcd:2379
Key: pay.rpc
- 新增
pay rpc
服務配置的例項化
$ vim api/internal/config/config.go
package config
import (
"github.com/tal-tech/go-zero/rest"
"github.com/tal-tech/go-zero/zrpc"
)
type Config struct {
rest.RestConf
Auth struct {
AccessSecret string
AccessExpire int64
}
PayRpc zrpc.RpcClientConf
}
- 註冊服務上下文
pay rpc
的依賴
$ vim api/internal/svc/servicecontext.go
package svc
import (
"mall/service/pay/api/internal/config"
"mall/service/pay/rpc/payclient"
"github.com/tal-tech/go-zero/zrpc"
)
type ServiceContext struct {
Config config.Config
PayRpc payclient.Pay
}
func NewServiceContext(c config.Config) *ServiceContext {
return &ServiceContext{
Config: c,
PayRpc: payclient.NewPay(zrpc.MustNewClient(c.PayRpc)),
}
}
6.5.3 新增支付建立邏輯 Create
$ vim api/internal/logic/createlogic.go
package logic
import (
"context"
"mall/service/pay/api/internal/svc"
"mall/service/pay/api/internal/types"
"mall/service/pay/rpc/pay"
"github.com/tal-tech/go-zero/core/logx"
)
type CreateLogic struct {
logx.Logger
ctx context.Context
svcCtx *svc.ServiceContext
}
func NewCreateLogic(ctx context.Context, svcCtx *svc.ServiceContext) CreateLogic {
return CreateLogic{
Logger: logx.WithContext(ctx),
ctx: ctx,
svcCtx: svcCtx,
}
}
func (l *CreateLogic) Create(req types.CreateRequest) (resp *types.CreateResponse, err error) {
res, err := l.svcCtx.PayRpc.Create(l.ctx, &pay.CreateRequest{
Uid: req.Uid,
Oid: req.Oid,
Amount: req.Amount,
})
if err != nil {
return nil, err
}
return &types.CreateResponse{
Id: res.Id,
}, nil
}
6.5.4 新增支付詳情邏輯 Detail
$ vim api/internal/logic/detaillogic.go
package logic
import (
"context"
"mall/service/pay/api/internal/svc"
"mall/service/pay/api/internal/types"
"mall/service/pay/rpc/pay"
"github.com/tal-tech/go-zero/core/logx"
)
type DetailLogic struct {
logx.Logger
ctx context.Context
svcCtx *svc.ServiceContext
}
func NewDetailLogic(ctx context.Context, svcCtx *svc.ServiceContext) DetailLogic {
return DetailLogic{
Logger: logx.WithContext(ctx),
ctx: ctx,
svcCtx: svcCtx,
}
}
func (l *DetailLogic) Detail(req types.DetailRequest) (resp *types.DetailResponse, err error) {
res, err := l.svcCtx.PayRpc.Detail(l.ctx, &pay.DetailRequest{
Id: req.Id,
})
if err != nil {
return nil, err
}
return &types.DetailResponse{
Id: req.Id,
Uid: res.Uid,
Oid: res.Oid,
Amount: res.Amount,
Source: res.Source,
Status: res.Status,
}, nil
}
6.5.5 新增支付回撥邏輯 Callback
$ vim api/internal/logic/callbacklogic.go
package logic
import (
"context"
"mall/service/pay/api/internal/svc"
"mall/service/pay/api/internal/types"
"mall/service/pay/rpc/pay"
"github.com/tal-tech/go-zero/core/logx"
)
type CallbackLogic struct {
logx.Logger
ctx context.Context
svcCtx *svc.ServiceContext
}
func NewCallbackLogic(ctx context.Context, svcCtx *svc.ServiceContext) CallbackLogic {
return CallbackLogic{
Logger: logx.WithContext(ctx),
ctx: ctx,
svcCtx: svcCtx,
}
}
func (l *CallbackLogic) Callback(req types.CallbackRequest) (resp *types.CallbackResponse, err error) {
_, err = l.svcCtx.PayRpc.Callback(l.ctx, &pay.CallbackRequest{
Id: req.Id,
Uid: req.Uid,
Oid: req.Oid,
Amount: req.Amount,
Source: req.Source,
Status: req.Status,
})
if err != nil {
return nil, err
}
return &types.CallbackResponse{}, nil
}
6.6 啟動 pay rpc 服務
提示:啟動服務需要在
golang
容器中啟動
$ cd mall/service/pay/rpc
$ go run pay.go -f etc/pay.yaml
Starting rpc server at 127.0.0.1:9003...
6.7 啟動 pay api 服務
提示:啟動服務需要在
golang
容器中啟動
$ cd mall/service/pay/api
$ go run pay.go -f etc/pay.yaml
Starting server at 0.0.0.0:8003...
專案地址
http://github.com/zeromicro/go-zero
http://gitee.com/kevwan/go-zero
歡迎使用 go-zero
並 star 支援我們!
微信交流群
關注『微服務實踐』公眾號並點選 交流群 獲取社群群二維碼。
「其他文章」
- 型別安全的 Go HTTP 請求
- 用 Go 快速開發一個 RESTful API 服務
- Go 專案配置檔案的定義和讀取
- 簡單易懂的 Go 泛型使用和實現原理介紹
- Go單體服務開發最佳實踐
- 通過 SingleFlight 模式學習 Go 併發程式設計
- 程序內優雅管理多個服務
- 構建 Go 應用 docker 映象的十八種姿勢
- 史上最強程式碼自測方法,沒有之一!
- 微服務從程式碼到k8s部署應有盡有大結局(k8s部署)
- 微服務從程式碼到k8s部署應有盡有系列(十四、部署環境搭建)
- 微服務從程式碼到k8s部署應有盡有系列(十三、服務監控)
- 微服務從程式碼到k8s部署應有盡有系列(十二、鏈路追蹤)
- 微服務從程式碼到k8s部署應有盡有系列(十一、日誌收集)
- 微服務從程式碼到k8s部署應有盡有系列(十、錯誤處理)
- 微服務從程式碼到k8s部署應有盡有系列(九、事務精講)
- 微服務從程式碼到k8s部署應有盡有系列(八、各種佇列)
- 微服務從程式碼到k8s部署應有盡有系列(七、支付服務)
- 微服務從程式碼到k8s部署應有盡有系列(五、民宿服務)
- 微服務從程式碼到k8s部署應有盡有系列(四、使用者中心)