后端: 1.阶段 5 course 服务边界落地 - 新增 cmd/course 独立进程入口,落地 services/course dao/rpc/sv - 新增 gateway/client/course、shared/contracts/course 和 shared/ports course port - 将 /api/v1/course/* HTTP 门面切到 course zrpc,gateway 只保留鉴权、限流、幂等、文件读取和响应透传 - 保留 course 迁移期直写 schedule_events / schedules 权限,维持课程导入两个表同事务写入语义 - 为 course parse-image 补 bytes RPC 契约和 gRPC 消息大小配置,兼容课表图片上传 - 补充 course.rpc 示例配置与阶段 5 文档基线、切流点、残留依赖和 smoke 记录
78 lines
2.0 KiB
Go
78 lines
2.0 KiB
Go
package rpc
|
|
|
|
import (
|
|
"errors"
|
|
"strings"
|
|
"time"
|
|
|
|
"github.com/LoveLosita/smartflow/backend/services/course/rpc/pb"
|
|
coursesv "github.com/LoveLosita/smartflow/backend/services/course/sv"
|
|
"github.com/zeromicro/go-zero/core/service"
|
|
"github.com/zeromicro/go-zero/zrpc"
|
|
"google.golang.org/grpc"
|
|
)
|
|
|
|
const (
|
|
defaultListenOn = "0.0.0.0:9087"
|
|
defaultTimeout = 10 * time.Second
|
|
defaultMaxRPCMessageSize = 8 * 1024 * 1024
|
|
rpcMessageSizePadding = 1024 * 1024
|
|
)
|
|
|
|
type ServerOptions struct {
|
|
ListenOn string
|
|
Timeout time.Duration
|
|
MaxImageBytes int64
|
|
Service *coursesv.CourseService
|
|
}
|
|
|
|
// NewServer 创建 course zrpc 服务端。
|
|
//
|
|
// 职责边界:
|
|
// 1. 只负责 zrpc server 配置与 gRPC handler 注册;
|
|
// 2. 不创建数据库、模型客户端或业务服务,它们由 cmd/course 管理;
|
|
// 3. 图片解析走 bytes 请求,需按 maxImageBytes 抬高 gRPC 消息上限。
|
|
func NewServer(opts ServerOptions) (*zrpc.RpcServer, string, error) {
|
|
if opts.Service == nil {
|
|
return nil, "", errors.New("course service dependency not initialized")
|
|
}
|
|
|
|
listenOn := strings.TrimSpace(opts.ListenOn)
|
|
if listenOn == "" {
|
|
listenOn = defaultListenOn
|
|
}
|
|
timeout := opts.Timeout
|
|
if timeout <= 0 {
|
|
timeout = defaultTimeout
|
|
}
|
|
|
|
server, err := zrpc.NewServer(zrpc.RpcServerConf{
|
|
ServiceConf: service.ServiceConf{
|
|
Name: "course.rpc",
|
|
Mode: service.DevMode,
|
|
},
|
|
ListenOn: listenOn,
|
|
Timeout: int64(timeout / time.Millisecond),
|
|
}, func(grpcServer *grpc.Server) {
|
|
pb.RegisterCourseServer(grpcServer, NewHandler(opts.Service))
|
|
})
|
|
if err != nil {
|
|
return nil, "", err
|
|
}
|
|
|
|
maxMessageSize := normalizeMaxRPCMessageSize(opts.MaxImageBytes)
|
|
server.AddOptions(grpc.MaxRecvMsgSize(maxMessageSize), grpc.MaxSendMsgSize(maxMessageSize))
|
|
return server, listenOn, nil
|
|
}
|
|
|
|
func normalizeMaxRPCMessageSize(maxImageBytes int64) int {
|
|
if maxImageBytes <= 0 {
|
|
return defaultMaxRPCMessageSize
|
|
}
|
|
size := maxImageBytes + rpcMessageSizePadding
|
|
if size < defaultMaxRPCMessageSize {
|
|
return defaultMaxRPCMessageSize
|
|
}
|
|
return int(size)
|
|
}
|