代码拉取完成，页面将自动刷新
基于proto文件可以快速生成bm框架对应的代码，提前需要准备以下工作：
kratos tool protoc工具，请看kratos工具
proto文件，示例可参考kratos-demo内proto文件
kratos tool protoc工具可以生成warden bm swagger对应的代码和文档，想要单独生成bm代码只需加上--bm如：
# generate BM HTTP
kratos tool protoc --bm api.proto
请注意想要生成bm代码，需要特别在proto的service内指定google.api.http配置，如下：
service Demo {
rpc SayHello (HelloReq) returns (.google.protobuf.Empty);
rpc SayHelloURL(HelloReq) returns (HelloResp) {
option (google.api.http) = { // 该配置指定SayHelloURL方法对应的url
get:"/kratos-demo/say_hello" // 指定url和请求方式为GET
};
};
}
建议在项目api目录下编写proto文件及生成对应的代码，可参考kratos-demo内的api目录。
执行命令后生成的api.bm.go代码，注意其中的type DemoBMServer interface和RegisterDemoBMServer，其中：
DemoBMServer接口，包含proto文件内配置了google.api.http选项的所有方法RegisterDemoBMServer方法提供注册DemoBMServer接口的实现对象，和bm的Engine用于注册路由DemoBMServer接口的实现，一般为internal/service内的业务逻辑代码，需要实现DemoBMServer接口使用RegisterDemoBMServer示例代码请参考kratos-demo内的http内的如下代码：
engine = bm.DefaultServer(hc.Server)
pb.RegisterDemoBMServer(engine, svc)
initRouter(engine)
internal/service内的Service结构实现了DemoBMServer接口可参考kratos-demo内的service内的如下代码：
// SayHelloURL bm demo func.
func (s *Service) SayHelloURL(ctx context.Context, req *pb.HelloReq) (reply *pb.HelloResp, err error) {
reply = &pb.HelloResp{
Content: "hello " + req.Name,
}
fmt.Printf("hello url %s", req.Name)
return
}
基于同一份proto文件还可以生成对应的swagger文档，运行命令如下：
# generate swagger
kratos tool protoc --swagger api.proto
该命令将生成对应的swagger.json文件，可用于swagger工具通过WEBUI的方式打开使用，可运行命令如下：
kratos tool swagger serve api/api.swagger.json
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
马建仓 AI 助手
