[HarmonyOS] 字节跳动开源 Go HTTP 框架 Hertz 设计实践

type HandlerFunc func(c context.Context, ctx *app.RequestContext)

type ServerFactory interface {
   New(core Core) (server protocol.Server, err error)
}
type Server interface {
   Serve(c context.Context, conn network.Conn) error
}

// Tracer is executed at the start and finish of an HTTP.
type Tracer interface {
    Start(ctx context.Context, c *app.RequestContext) context.Context
    Finish(ctx context.Context, c *app.RequestContext)
}

  

• 首先，定义 IDL，这里使用 Thrift 作为 IDL 的定义（也支持使用 Protobuf 定义的 IDL），编写一个名为 Demo 的 service。这个服务有一个 API: Hello，它的请求参数是一个 query，响应是一个包含一个 RespBody 字段的 Json。
  
  

// idl/hello.thrift
namespace go hello.example
struct HelloReq {
  1: string Name (api.query="name");
}
struct HelloResp {
  1: string RespBody;
}
service HelloService {
  HelloResp Hello(1: HelloReq request) (api.get="/hello");
}

  

• 接下来我们使用 hz 生成代码，并整理和拉取依赖
  
  

$ hz new -idl idl/hello.thrift -mod Demo
$ go mod tidy && go mod verify

  

• 填充业务逻辑，比如我们返回 hello， ${Name}，那我们在biz/handler/example/hello_service.go 中添加以下代码即可
  
  

// Hello .
// @router /hello [GET]
func Hello(ctx context.Context, c *app.RequestContext) {
  var err error
  var req example.HelloReq
  err = c.BindAndValidate(&req)
  if err != nil {
    c.String(400, err.Error())
    return
  }
  resp := new(example.HelloResp)
  resp.RespBody = "hello, " + req.Name
  c.JSON(200, resp)
}

  

• 编译并运行项目
  
  

$ go build
$ ./Demo

$ curl http://localhost:8888/hello\?name\=Xiaoming
// 如果看到以下返回说明服务已经正常启动起来啦
$ {"RespBody":"hello, Xiaoming"}

  

• Hertz: https://github.com/cloudwego/hertz
    
  
• Hertz Doc: Hertz | CloudWeGo
    
  
• 字节跳动在 Go 网络库上的实践: 字节跳动在 Go 网络库上的实践 | CloudWeGo
    
  
• CloudWeGo：CloudWeGo (github.com)
    
  
• CloudWeGo 官网：CloudWeGo