Merge pull request #37 from divebomb/master

Add: listen on random local port
tree: 73195c61ca9f2dccb0f1bef33e0d564680461a0a
  1. .github/
  2. demo/
  3. .gitignore
  4. .gitmodules
  5. .travis.yml
  6. client.go
  7. client_test.go
  8. connection.go
  9. const.go
  10. getty.go
  11. go.mod
  12. go.sum
  13. LICENSE
  14. logger.go
  15. options.go
  16. options_test.go
  17. README.md
  18. server.go
  19. server_test.go
  20. session.go
README.md

getty

a netty like asynchronous network I/O library

Build Status codecov go.dev reference Go Report Card license

INTRO

Getty is a asynchronous network I/O library in golang. Getty works on tcp/udp/websocket network protocol and supplies a uniform interface.

In getty there are two goroutines in one connection(session), one reads tcp stream/udp packet/websocket package, the other handles logic process and writes response into network write buffer. If your logic process may take a long time, you should start a new logic process goroutine by yourself in codec.go:(Codec)OnMessage.

You can also handle heartbeat logic in codec.go:(Codec):OnCron. If you use tcp/udp, you should send hearbeat package by yourself, and then invoke session.go:(Session)UpdateActive to update its active time. Please check whether the tcp session has been timeout or not in codec.go:(Codec)OnCron by session.go:(Session)GetActive.

Whatever if you use websocket, you do not need to care about hearbeat request/response because Getty do this task in session.go:(Session)handleLoop by sending/received websocket ping/pong frames. You just need to check whether the websocket session has been timeout or not in codec.go:(Codec)OnCron by session.go:(Session)GetActive.

LICENCE

Apache License 2.0