connection

Documentation

Index

• Variables
• type TCP4Connection
  • func NewTCPConnection(dialer net.Dialer) *TCP4Connection
  • func (tc *TCP4Connection) Close() error
  • func (tc *TCP4Connection) Connect(addr net.Addr) error
  • func (tc *TCP4Connection) LocalAddr() net.Addr
  • func (tc *TCP4Connection) Read(b []byte) (n int, err error)
  • func (tc *TCP4Connection) RemoteAddr() net.Addr
  • func (tc *TCP4Connection) SetDeadline(t time.Time) error
  • func (tc *TCP4Connection) SetReadDeadline(t time.Time) error
  • func (tc *TCP4Connection) SetWriteDeadline(t time.Time) error
  • func (tc *TCP4Connection) Write(b []byte) (n int, err error)
• type TCP4Listener
  • func NewTCP4Listener(l net.Listener) *TCP4Listener
  • func (tl *TCP4Listener) Accept() (watermillnet.Connection, error)
  • func (tl *TCP4Listener) Addr() net.Addr
  • func (tl *TCP4Listener) Close() error

Variables

var ErrNotConnected = errors.New("not connected")

Types

type TCP4Connection

type TCP4Connection struct {
	Closed bool
	// contains filtered or unexported fields
}

func NewTCPConnection

func NewTCPConnection(dialer net.Dialer) *TCP4Connection

func (*TCP4Connection) Close

func (tc *TCP4Connection) Close() error

Close closes the connection. Any blocked Read or Write operations will be unblocked and return errors.

func (*TCP4Connection) Connect

func (tc *TCP4Connection) Connect(addr net.Addr) error

Establish connection with remote side. LocalAddr get local addr.

func (*TCP4Connection) LocalAddr

func (tc *TCP4Connection) LocalAddr() net.Addr

LocalAddr returns the local network address, if known.

func (*TCP4Connection) Read

func (tc *TCP4Connection) Read(b []byte) (n int, err error)

Read reads data from the connection. Read can be made to time out and return an error after a fixed time limit; see SetDeadline and SetReadDeadline.

func (*TCP4Connection) RemoteAddr

func (tc *TCP4Connection) RemoteAddr() net.Addr

RemoteAddr returns the remote network address, if known.

func (*TCP4Connection) SetDeadline

func (tc *TCP4Connection) SetDeadline(t time.Time) error

SetDeadline sets the read and write deadlines associated with the connection. It is equivalent to calling both SetReadDeadline and SetWriteDeadline.

A deadline is an absolute time after which I/O operations fail instead of blocking. The deadline applies to all future and pending I/O, not just the immediately following call to Read or Write. After a deadline has been exceeded, the connection can be refreshed by setting a deadline in the future.

If the deadline is exceeded a call to Read or Write or to other I/O methods will return an error that wraps os.ErrDeadlineExceeded. This can be tested using errors.Is(err, os.ErrDeadlineExceeded). The error's Timeout method will return true, but note that there are other possible errors for which the Timeout method will return true even if the deadline has not been exceeded.

An idle timeout can be implemented by repeatedly extending the deadline after successful Read or Write calls.

A zero value for t means I/O operations will not time out.

func (*TCP4Connection) SetReadDeadline

func (tc *TCP4Connection) SetReadDeadline(t time.Time) error

SetReadDeadline sets the deadline for future Read calls and any currently-blocked Read call. A zero value for t means Read will not time out.

func (*TCP4Connection) SetWriteDeadline

func (tc *TCP4Connection) SetWriteDeadline(t time.Time) error

SetWriteDeadline sets the deadline for future Write calls and any currently-blocked Write call. Even if write times out, it may return n > 0, indicating that some of the data was successfully written. A zero value for t means Write will not time out.

func (*TCP4Connection) Write

func (tc *TCP4Connection) Write(b []byte) (n int, err error)

Write writes data to the connection. Write can be made to time out and return an error after a fixed time limit; see SetDeadline and SetWriteDeadline.

type TCP4Listener

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

func NewTCP4Listener

func NewTCP4Listener(l net.Listener) *TCP4Listener

func (*TCP4Listener) Accept

func (tl *TCP4Listener) Accept() (watermillnet.Connection, error)

Accept waits for and returns the next connection to the listener.

func (*TCP4Listener) Addr

func (tl *TCP4Listener) Addr() net.Addr

Addr returns the listener's network address.

func (*TCP4Listener) Close

func (tl *TCP4Listener) Close() error

Close closes the listener. Any blocked Accept operations will be unblocked and return errors.