在Micro (2)中讲到定义服务以及服务端和客户端的实现，并没有提到如何提供API接口，Micro框架通过micro api来提供API服务，micro api是micro微服务的API网关。
默认监听8080端口，动态独有请求到相应的后端service。内部使用了go-micro框架，我们也可以很方便把服务发现从consul切换到其他的服务发现，比如 kubernetes API 或者RPC for gRPC。
micro api有两种形式来访问服务中的http api:
/[service]/[method] # 通过http path来指定调用的service
/rpc # 在http body中提供service和method来指定调用的service
Http Handler
micro api提供下面4种方式来定义http api:
Endpoint Metadata
- 默认的Handler，如果找不到匹配的路由，将使用API Handler。
- Request/Response: 在proto中自行定义Request/Response类型
- 注册Handler方法调用需要提供Endpoint，如下:
RegisterExampleHandler(service.Server(), new(Example), api.WithEndpoint(&api.Endpoint{
// The RPC method
Name: "Example.Call",
// The HTTP paths. This can be a POSIX regex
Path: []string{"/example"},
// The HTTP Methods for this endpoint
Method: []string{"POST"},
// The API handler to use
Handler: api.Rpc,
}))
- 启动API Gateway命令, `micro api`
API Handler
- Request/Response: Service方法定义参数类型为api.Request/api.Response, 定义proto消息时使用，需在proto文件中导入定义，`import "github.com/micro/go-api/proto/api.proto";`
- http path用来解析service和method
- 请求处理的API Service参数使用的类型是api.Request和api.Response
- 请求和相应的content-type可以是任何类型
- 如果找不到匹配的service将返回404
- 启动API Gateway命令, `micro api --handler=api`
RPC Handler
- Request/Response: 在proto中自行定义Request/Response类型，
- 对默认的Handler的可选处理是使用go-micro Client转发请求体作为RPC请求
- 允许API Handler定义混用Golang的类型
- 除了提供API Service还可以提供Backend Service
- 支持的content-type: application/json和application/protobuf
- 启动API Gateway命令, `micro api --handler=rpc`
Reverse Proxy
- Request/Response: http, 即使用Golang方式定义Handler方法，参数类型http.Request/http.ResponseWriter。
- 根据http path中第一个来反向代理请求
- 允许API以REST风格来实现
- 启动API Gateway命令, `micro api --handler=proxy`
参考官方example/api
参考文章:
[1] https://micro.mu/blog/2016/03/20/micro.html
[2] https://micro.mu/blog/
