tcp

Documentation

Index

• Variables
• type Config
• type Conn
  • func (c *Conn) AsyncWritePacket(p Packet, timeout time.Duration) (err error)
  • func (c *Conn) Close()
  • func (c *Conn) Do()
  • func (c *Conn) GetExtraData() interface{}
  • func (c *Conn) GetRawConn() *net.TCPConn
  • func (c *Conn) IsClosed() bool
  • func (c *Conn) PutExtraData(data interface{})
• type ConnCallback
• type EchoPacket
  • func NewEchoPacket(buff []byte, hasLengthField bool) *EchoPacket
  • func (this *EchoPacket) GetBody() []byte
  • func (this *EchoPacket) GetLength() uint32
  • func (this *EchoPacket) Serialize() []byte
• type EchoProtocol
  • func (this *EchoProtocol) ReadPacket(conn *net.TCPConn) (Packet, error)
• type Packet
• type Protocol
• type Server
  • func NewServer(config *Config, callback ConnCallback, protocol Protocol) *Server
  • func (s *Server) Start(listener *net.TCPListener, acceptTimeout time.Duration)
  • func (s *Server) Stop()

Variables

var (
	ErrConnClosing   = errors.New("use of closed network connection")
	ErrWriteBlocking = errors.New("write packet was blocking")
	ErrReadBlocking  = errors.New("read packet was blocking")
)

Error type

Types

type Config

type Config struct {
	PacketSendChanLimit    uint32 // the limit of packet send channel
	PacketReceiveChanLimit uint32 // the limit of packet receive channel
}

type Conn

type Conn struct {
	// contains filtered or unexported fields
}

Conn exposes a set of callbacks for the various events that occur on a connection

func (*Conn) AsyncWritePacket

func (c *Conn) AsyncWritePacket(p Packet, timeout time.Duration) (err error)

AsyncWritePacket async writes a packet, this method will never block

func (*Conn) Close

func (c *Conn) Close()

Close closes the connection

func (*Conn) Do

func (c *Conn) Do()

Do it

func (*Conn) GetExtraData

func (c *Conn) GetExtraData() interface{}

GetExtraData gets the extra data from the Conn

func (*Conn) GetRawConn

func (c *Conn) GetRawConn() *net.TCPConn

GetRawConn returns the raw net.TCPConn from the Conn

func (*Conn) IsClosed

func (c *Conn) IsClosed() bool

IsClosed indicates whether or not the connection is closed

func (*Conn) PutExtraData

func (c *Conn) PutExtraData(data interface{})

PutExtraData puts the extra data with the Conn

type ConnCallback

type ConnCallback interface {
	// OnConnect is called when the connection was accepted,
	// If the return value of false is closed
	OnConnect(*Conn) bool

	// OnMessage is called when the connection receives a packet,
	// If the return value of false is closed
	OnMessage(*Conn, Packet) bool

	// OnClose is called when the connection closed
	OnClose(*Conn)
}

ConnCallback is an interface of methods that are used as callbacks on a connection

type EchoPacket

type EchoPacket struct {
	// contains filtered or unexported fields
}

func NewEchoPacket

func NewEchoPacket(buff []byte, hasLengthField bool) *EchoPacket

func (*EchoPacket) GetBody

func (this *EchoPacket) GetBody() []byte

func (*EchoPacket) GetLength

func (this *EchoPacket) GetLength() uint32

func (*EchoPacket) Serialize

func (this *EchoPacket) Serialize() []byte

type EchoProtocol

type EchoProtocol struct {
}

func (*EchoProtocol) ReadPacket

func (this *EchoProtocol) ReadPacket(conn *net.TCPConn) (Packet, error)

type Packet

type Packet interface {
	Serialize() []byte
}

type Protocol

type Protocol interface {
	ReadPacket(conn *net.TCPConn) (Packet, error)
}

type Server

type Server struct {
	// contains filtered or unexported fields
}

func NewServer

func NewServer(config *Config, callback ConnCallback, protocol Protocol) *Server

NewServer creates a server

func (*Server) Start

func (s *Server) Start(listener *net.TCPListener, acceptTimeout time.Duration)

Start starts service

func (*Server) Stop

func (s *Server) Stop()

Stop stops service