GO-NETTY
Introduction (介绍)
go-netty is heavily inspired by netty
go-netty 大量参考了netty的设计并融合Golang本身的协程特性而开发的一款高性能网络库
Feature (特性)
- Extensible multi-transport protocol support, default support TCP, KCP, Websocket
- 可扩展多种传输协议，并且默认实现了 TCP, KCP, Websocket
- Extensible multi-codec support
- 可扩展多种解码器，默认实现了常见的编解码器
- Based on responsibility chain model
- 基于责任链模型的流程控制
TODO (待完成)
- test case
- docs
- examples
Examples (例子)
Usage (使用)
var bootstrap = netty.NewBootstrap()
bootstrap.ChildInitializer(func(channel netty.Channel) {
channel.Pipeline().
// 按照自定义协议解码帧（2字节的长度字段）
AddLast(frame.LengthFieldCodec(binary.LittleEndian, 1024, 0, 2, 0, 0)).
// 消息内容为文本格式(可自定义为 json，protobuf 等编解码器)
AddLast(format.TextCodec()).
// 处理消息
AddLast(LogHandler{"Server"})
})
bootstrap.Transport(tcp.New())
bootstrap.Listen("tcp://0.0.0.0:6565").RunForever(os.Kill, os.Interrupt)
type LogHandler struct {
role string
}
func (l LogHandler) HandleActive(ctx netty.ActiveContext) {
fmt.Println(l.role, "->", "active:", ctx.Channel().RemoteAddr())
// 给对端发送一条消息，将进入如下流程（视编解码配置）
// Text -> TextCodec -> LengthFieldCodec -> Channel.Write
// 文本 文本编码 组装协议格式（长度字段） 网络发送
ctx.Write("Hello I'm " + l.role)
// 向后续的handler传递控制权
// 如果是最后一个handler或者需要中断请求可以不用调用
ctx.HandleActive()
}
func (l LogHandler) HandleRead(ctx netty.InboundContext, message netty.Message) {
fmt.Println(l.role, "->", "handle read:", message)
// 向后续的handler传递控制权
// 如果是最后一个handler或者需要中断请求可以不用调用
ctx.HandleRead(message)
}
func (l LogHandler) HandleInactive(ctx netty.InactiveContext, ex netty.Exception) {
fmt.Println(l.role, "->", "inactive:", ctx.Channel().RemoteAddr(), ex)
// 向后续的handler传递控制权
// 如果是最后一个handler或者需要中断请求可以不用调用
ctx.HandleInactive(ex)
}