websockets

package
v1.14.5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 15, 2025 License: Apache-2.0 Imports: 14 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	WebsocketConnOptionErr                                 WebsocketConnOption
	SyncMessageTimeoutErr                                  SyncMessageTimeout
	WebsocketOfflineErr                                    WebsocketOffline
	AsyncMessageCallbackEmptyErr                           AsyncMessageCallbackEmpty
	AsyncMessageTimeoutErr                                 AsyncMessageTimeout
	WebsocketClientExistErr                                WebsocketClientExist
	WebsocketClientNotExistErr                             WebsocketClientNotExist
	WebsocketServerConnConditionFuncEmptyErr               WebsocketServerConnConditionFuncEmpty
	WebsocketServerConnTagEmptyErr                         WebsocketServerConnTagEmpty
	WebsocketServerConnTagExistErr                         WebsocketServerConnTagExist
	WebsocketServerOnReceiveMessageSuccessCallbackEmptyErr WebsocketServerOnReceiveMessageSuccessCallbackEmpty
)

Functions

This section is empty.

Types

type AsyncMessageCallbackEmpty added in v1.9.24

type AsyncMessageCallbackEmpty struct{ myError.MyError }

func (*AsyncMessageCallbackEmpty) Error added in v1.9.24

func (my *AsyncMessageCallbackEmpty) Error() string

func (*AsyncMessageCallbackEmpty) Is added in v1.9.24

func (*AsyncMessageCallbackEmpty) Is(target error) bool

func (*AsyncMessageCallbackEmpty) New added in v1.9.24

func (*AsyncMessageCallbackEmpty) Panic added in v1.10.24

func (*AsyncMessageCallbackEmpty) Wrap added in v1.9.24

type AsyncMessageTimeout added in v1.9.24

type AsyncMessageTimeout struct{ myError.MyError }

func (*AsyncMessageTimeout) Error added in v1.9.24

func (my *AsyncMessageTimeout) Error() string

func (*AsyncMessageTimeout) Is added in v1.9.24

func (*AsyncMessageTimeout) Is(target error) bool

func (*AsyncMessageTimeout) New added in v1.9.24

func (*AsyncMessageTimeout) Panic added in v1.10.24

func (*AsyncMessageTimeout) Wrap added in v1.9.24

type Client

type Client struct {
	// contains filtered or unexported fields
}
var ClientApp Client

func NewClient

func NewClient(
	groupName, name, addr string,
	clientCallbackConfig ClientCallbackConfig,
	options ...any,
) (client *Client, err error)

NewClient 实例化:链接

func (*Client) AppendReqHdr added in v1.9.11

func (my *Client) AppendReqHdr(hdr http.Header) *Client

AppendReqHdr 新增请求头

func (*Client) AppendRequestHeader added in v1.5.1

func (my *Client) AppendRequestHeader(header http.Header) *Client

AppendRequestHeader 新增请求头

func (*Client) AsyncMessage

func (my *Client) AsyncMessage(message []byte, fn clientCallbackFn, timeout time.Duration) *Client

AsyncMessage 发送消息:异步

func (*Client) AsyncMsg added in v1.9.11

func (my *Client) AsyncMsg(msg []byte, fn clientCallbackFn, to time.Duration) *Client

AsyncMsg 发送消息:异步

func (*Client) Boot added in v1.5.0

func (my *Client) Boot() *Client

Boot 启动链接,并打开监听

func (*Client) Close

func (my *Client) Close() *Client

Close 关闭链接

func (*Client) Cls added in v1.9.11

func (my *Client) Cls() *Client

Cls 关闭链接

func (*Client) Err added in v1.9.11

func (my *Client) Err() error

Err 获取错误

func (*Client) Error

func (my *Client) Error() error

Error 获取错误

func (*Client) GetAddr added in v1.5.0

func (my *Client) GetAddr() string

GetAddr 获取链接地址

func (*Client) GetAddress added in v1.9.11

func (my *Client) GetAddress() string

GetAddress 获取链接地址

func (*Client) GetConn

func (my *Client) GetConn() *websocket.Conn

GetConn 获取链接本体

func (*Client) GetConnection added in v1.9.11

func (my *Client) GetConnection() *websocket.Conn

GetConnection 获取链接本体

func (*Client) GetName

func (my *Client) GetName() string

GetName 获取链接名称

func (*Client) GetReqHdr added in v1.9.11

func (my *Client) GetReqHdr() http.Header

GetReqHdr 获取请求头

func (*Client) GetRequestHeaders added in v1.5.1

func (my *Client) GetRequestHeaders() http.Header

GetRequestHeaders 获取请求头

func (*Client) GetStatus

func (my *Client) GetStatus() WebsocketConnStatus

GetStatus 获取链接状态

func (*Client) Heart

func (my *Client) Heart(interval time.Duration, fn clientHeartFn) *Client

Heart 设置或重置心跳

func (*Client) New added in v1.9.10

func (*Client) New(
	groupName, name, addr string,
	clientCallbackConfig ClientCallbackConfig,
	options ...any,
) (*Client, error)

New 实例化:链接

func (*Client) Once added in v1.9.10

func (*Client) Once() *ClientInstancePool

func (*Client) Ping

func (my *Client) Ping(fn pingFn) *Client

Ping 发送ping

func (*Client) ReBoot added in v1.5.0

func (my *Client) ReBoot() error

ReBoot 重连

func (*Client) SetReqHdr added in v1.9.11

func (my *Client) SetReqHdr(hdr http.Header) *Client

SetReqHdr 设置请求头

func (*Client) SetRequestHeaders added in v1.5.1

func (my *Client) SetRequestHeaders(header http.Header) *Client

SetRequestHeaders 设置请求头

func (*Client) SyncMessage

func (my *Client) SyncMessage(message []byte, options ...any) ([]byte, error)

SyncMessage 发送消息:同步

func (*Client) SyncMsg added in v1.9.11

func (my *Client) SyncMsg(msg []byte, options ...any) ([]byte, error)

SyncMsg 发送消息:同步

type ClientCallbackConfig

type ClientCallbackConfig struct {
	OnConnSuccessCallback           clientStandardSuccessFn
	OnConnFailCallback              clientStandardFailFn
	OnCloseSuccessCallback          clientStandardSuccessFn
	OnCloseFailCallback             clientStandardFailFn
	OnReceiveMessageSuccessCallback clientReceiveMessageSuccessFn
	OnReceiveMessageFailCallback    clientStandardFailFn
	OnSendMessageFailCallback       clientStandardFailFn
}

ClientCallbackConfig 客户端回调

type ClientInstance

type ClientInstance struct {
	// contains filtered or unexported fields
}
var ClientInstanceApp ClientInstance

func NewClientInstance added in v1.5.0

func NewClientInstance(name string) *ClientInstance

NewClientInstance 实例化:websocket客户端实例

func (*ClientInstance) Append

func (my *ClientInstance) Append(client *Client) error

Append 增加客户端

func (*ClientInstance) Clean

func (my *ClientInstance) Clean() []error

Clean 清空客户端

func (*ClientInstance) Close

func (my *ClientInstance) Close(name string) error

Close 关闭客户端

func (*ClientInstance) Get

func (my *ClientInstance) Get(name string) (*Client, error)

Get 获取客户端

func (*ClientInstance) Has

func (my *ClientInstance) Has(name string) bool

Has 检查客户端是否存在

func (*ClientInstance) New added in v1.9.10

func (*ClientInstance) New(name string) *ClientInstance

New 实例化:websocket客户端实例

func (*ClientInstance) Remove

func (my *ClientInstance) Remove(name string) error

Remove 删除客户端

type ClientInstancePool

type ClientInstancePool struct {
	// contains filtered or unexported fields
}
var (
	ClientInstancePoolApp ClientInstancePool
)

func OnceClientInstancePool

func OnceClientInstancePool() *ClientInstancePool

OnceClientInstancePool 单例化:websocket客户端实例池

func (*ClientInstancePool) Append

func (*ClientInstancePool) Append(clientInstance *ClientInstance) error

Append 增加客户端

func (*ClientInstancePool) Clean

func (*ClientInstancePool) Clean() []error

Clean 清空客户端实例

func (*ClientInstancePool) Close

func (*ClientInstancePool) Close(name string) error

Close 关闭客户端

func (*ClientInstancePool) Get

Get 获取客户端

func (*ClientInstancePool) Has

func (*ClientInstancePool) Has(name string) bool

Has 检查客户端是否存在

func (*ClientInstancePool) Remove

func (*ClientInstancePool) Remove(name string) error

Remove 删除客户端

type Message

type Message struct {
	// contains filtered or unexported fields
}
var MessageApp Message

func NewMessage

func NewMessage(async bool, message []byte) Message

NewMessage 新建消息

func ParseMessage

func ParseMessage(prototypeMessage []byte) Message

ParseMessage 解析消息

func (*Message) GetAsync

func (my *Message) GetAsync() bool

GetAsync 获取同步类型

func (*Message) GetMessage

func (my *Message) GetMessage() []byte

GetMessage 获取消息

func (*Message) GetMessageId

func (my *Message) GetMessageId() string

GetMessageId 获取消息编号

func (*Message) GetPrototypeMessage

func (my *Message) GetPrototypeMessage() []byte

GetPrototypeMessage 获取原始消息

func (*Message) New added in v1.9.10

func (*Message) New(async bool, message []byte) Message

New 新建消息

func (*Message) Parse added in v1.9.10

func (*Message) Parse(prototypeMessage []byte) Message

Parse 解析消息

type Server added in v1.5.0

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

func NewServer added in v1.5.0

func NewServer(conn *websocket.Conn) *Server

NewServer 实例话:websocket服务端

func (*Server) AsyncMessage added in v1.5.0

func (my *Server) AsyncMessage(prototypeMessage []byte, onSuccess serverSendMessageSuccessFn, onFail serverSendMessageFailFn)

AsyncMessage 发送消息:异步

func (*Server) Boot added in v1.5.0

func (my *Server) Boot(
	onReceiveMessageSuccess serverReceiveMessageSuccessFn,
	onReceiveMessageFail serverReceiveMessageFailFn,
	onSendMessageFail serverSendMessageFailFn,
	onCloseCallback serverCloseCallbackFn,
) error

Boot 启动

func (*Server) Close added in v1.5.0

func (my *Server) Close() *Server

Close 关闭

func (*Server) Conn added in v1.5.0

func (my *Server) Conn() *websocket.Conn

Conn 获取链接

func (*Server) IsOffline added in v1.5.0

func (my *Server) IsOffline() bool

IsOffline 是否离线

func (*Server) IsOnline added in v1.5.0

func (my *Server) IsOnline() bool

IsOnline 是否在线

func (*Server) New added in v1.9.10

func (*Server) New(conn *websocket.Conn) *Server

func (*Server) SyncMessage added in v1.5.0

func (my *Server) SyncMessage(prototypeMessage []byte, onSuccess serverSendMessageSuccessFn, onFail serverSendMessageFailFn)

SyncMessage 发送消息:同步

type ServerCallbackConfig added in v1.3.1

type ServerCallbackConfig struct {
	OnConnectionFail        serverConnectionFailFn
	OnConnectionSuccess     serverConnectionSuccessFn
	OnSendMessageSuccess    serverSendMessageSuccessFn
	OnSendMessageFail       serverSendMessageFailFn
	OnReceiveMessageFail    serverReceiveMessageFailFn
	OnReceiveMessageSuccess serverReceiveMessageSuccessFn
	OnCloseCallback         serverCloseCallbackFn
}

type ServerPool added in v1.5.0

type ServerPool struct {
	// contains filtered or unexported fields
}
var (
	ServerPoolApp ServerPool
)

func OnceServer added in v1.5.0

func OnceServer(serverCallbackConfig ServerCallbackConfig) *ServerPool

OnceServer 单例化:websocket服务端

func (*ServerPool) Handle added in v1.5.0

func (*ServerPool) Handle(
	writer http.ResponseWriter,
	req *http.Request,
	header http.Header,
	condition serverConnectionCheckFn,
) *ServerPool

Handle 消息处理

func (*ServerPool) Once added in v1.9.10

func (*ServerPool) Once(serverCallbackConfig ServerCallbackConfig) *ServerPool

Once 单例化:websocket服务端

func (*ServerPool) SendMessageByAddr added in v1.5.0

func (*ServerPool) SendMessageByAddr(addr *string, prototypeMessage []byte)

SendMessageByAddr 发送消息:通过地址

func (*ServerPool) SendMessageByAuthId added in v1.5.0

func (*ServerPool) SendMessageByAuthId(authId *string, prototypeMessage []byte)

SendMessageByAuthId 发送消息:通过认证ID

func (*ServerPool) SendMsgByAddr added in v1.9.11

func (my *ServerPool) SendMsgByAddr(addr *string, propMsg []byte)

SendMsgByAddr 发送消息:通过地址

func (*ServerPool) SendMsgByAuthId added in v1.9.11

func (my *ServerPool) SendMsgByAuthId(authId *string, propMsg []byte)

SendMsgByAuthId 发送消息:通过认证ID

func (*ServerPool) SetOnCloseCallback added in v1.5.0

func (*ServerPool) SetOnCloseCallback(onCloseCallback serverCloseCallbackFn) *ServerPool

SetOnCloseCallback 设置回调:关闭时回调

func (*ServerPool) SetOnClsCb added in v1.9.11

func (my *ServerPool) SetOnClsCb(fn serverCloseCallbackFn) *ServerPool

SetOnClsCb 设置回调:关闭时回调

func (*ServerPool) SetOnConnFail added in v1.9.11

func (my *ServerPool) SetOnConnFail(fn serverConnectionFailFn) *ServerPool

SetOnConnFail 设置回调:当连接失败

func (*ServerPool) SetOnConnSuc added in v1.9.11

func (my *ServerPool) SetOnConnSuc(fn serverConnectionSuccessFn) *ServerPool

func (*ServerPool) SetOnConnectionFail added in v1.5.0

func (*ServerPool) SetOnConnectionFail(onConnectionFail serverConnectionFailFn) *ServerPool

SetOnConnectionFail 设置回调:当连接失败

func (*ServerPool) SetOnConnectionSuccess added in v1.5.0

func (*ServerPool) SetOnConnectionSuccess(onConnectionSuccess serverConnectionSuccessFn) *ServerPool

SetOnConnectionSuccess 设置回调:当连接成功

func (*ServerPool) SetOnRecMsgFail added in v1.9.11

func (my *ServerPool) SetOnRecMsgFail(fn serverReceiveMessageFailFn) *ServerPool

SetOnRecMsgFail 设置回调:当接收消息失败

func (*ServerPool) SetOnRecMsgSuc added in v1.9.11

func (my *ServerPool) SetOnRecMsgSuc(fn serverReceiveMessageSuccessFn) *ServerPool

SetOnRecMsgSuc 设置回调:当接收消息成功

func (*ServerPool) SetOnReceiveMessageFail added in v1.5.0

func (*ServerPool) SetOnReceiveMessageFail(onReceiveMessageFail serverReceiveMessageFailFn) *ServerPool

SetOnReceiveMessageFail 设置回调:当接收消息失败

func (*ServerPool) SetOnReceiveMessageSuccess added in v1.5.0

func (*ServerPool) SetOnReceiveMessageSuccess(onReceiveMessageSuccess serverReceiveMessageSuccessFn) *ServerPool

SetOnReceiveMessageSuccess 设置回调:当接收消息成功

func (*ServerPool) SetOnSendMessageFail added in v1.5.0

func (*ServerPool) SetOnSendMessageFail(onSendMessageFail serverSendMessageFailFn) *ServerPool

SetOnSendMessageFail 设置回调:当发送消息失败

func (*ServerPool) SetOnSendMessageSuccess added in v1.5.0

func (*ServerPool) SetOnSendMessageSuccess(onSendMessageSuccess serverSendMessageSuccessFn) *ServerPool

SetOnSendMessageSuccess 设置回调:当发送消息成功

func (*ServerPool) SetOnSendMsgFail added in v1.9.11

func (my *ServerPool) SetOnSendMsgFail(fn serverSendMessageFailFn) *ServerPool

SetOnSendMsgFail 设置回调:当发送消息失败

func (*ServerPool) SetOnSendMsgSuc added in v1.9.11

func (my *ServerPool) SetOnSendMsgSuc(fn serverSendMessageSuccessFn) *ServerPool

SetOnSendMsgSuc 设置回调:当发送消息成功

type ServerReceiveMessage added in v1.5.0

type ServerReceiveMessage struct {
	Target string `json:"target"`
}

type SyncMessageTimeout added in v1.9.24

type SyncMessageTimeout struct{ myError.MyError }

func (*SyncMessageTimeout) Error added in v1.9.24

func (my *SyncMessageTimeout) Error() string

func (*SyncMessageTimeout) Is added in v1.9.24

func (*SyncMessageTimeout) Is(target error) bool

func (*SyncMessageTimeout) New added in v1.9.24

func (*SyncMessageTimeout) Panic added in v1.10.24

func (*SyncMessageTimeout) Wrap added in v1.9.24

type WebsocketClientExist added in v1.9.24

type WebsocketClientExist struct{ myError.MyError }

func (*WebsocketClientExist) Error added in v1.9.24

func (my *WebsocketClientExist) Error() string

func (*WebsocketClientExist) Is added in v1.9.24

func (*WebsocketClientExist) Is(target error) bool

func (*WebsocketClientExist) New added in v1.9.24

func (*WebsocketClientExist) Panic added in v1.10.24

func (*WebsocketClientExist) Wrap added in v1.9.24

type WebsocketClientNotExist added in v1.9.24

type WebsocketClientNotExist struct{ myError.MyError }

func (*WebsocketClientNotExist) Error added in v1.9.24

func (my *WebsocketClientNotExist) Error() string

func (*WebsocketClientNotExist) Is added in v1.9.24

func (*WebsocketClientNotExist) Is(target error) bool

func (*WebsocketClientNotExist) New added in v1.9.24

func (*WebsocketClientNotExist) Panic added in v1.10.24

func (*WebsocketClientNotExist) Wrap added in v1.9.24

type WebsocketConnOption added in v1.9.24

type WebsocketConnOption struct{ myError.MyError }

func (*WebsocketConnOption) Error added in v1.9.24

func (my *WebsocketConnOption) Error() string

func (*WebsocketConnOption) Is added in v1.9.24

func (*WebsocketConnOption) Is(target error) bool

func (*WebsocketConnOption) New added in v1.9.24

func (*WebsocketConnOption) Panic added in v1.10.24

func (*WebsocketConnOption) Wrap added in v1.9.24

type WebsocketConnStatus

type WebsocketConnStatus string
var (
	Online  WebsocketConnStatus = "ON-LINE"
	Offline WebsocketConnStatus = "OFF-LINE"
)

type WebsocketOffline added in v1.9.24

type WebsocketOffline struct{ myError.MyError }

func (*WebsocketOffline) Error added in v1.9.24

func (my *WebsocketOffline) Error() string

func (*WebsocketOffline) Is added in v1.9.24

func (*WebsocketOffline) Is(target error) bool

func (*WebsocketOffline) New added in v1.9.24

func (*WebsocketOffline) Panic added in v1.10.24

func (*WebsocketOffline) Wrap added in v1.9.24

type WebsocketServerConnConditionFuncEmpty added in v1.9.24

type WebsocketServerConnConditionFuncEmpty struct{ myError.MyError }

func (*WebsocketServerConnConditionFuncEmpty) Error added in v1.9.24

func (*WebsocketServerConnConditionFuncEmpty) Is added in v1.9.24

func (*WebsocketServerConnConditionFuncEmpty) New added in v1.9.24

func (*WebsocketServerConnConditionFuncEmpty) Panic added in v1.10.24

func (*WebsocketServerConnConditionFuncEmpty) Wrap added in v1.9.24

type WebsocketServerConnTagEmpty added in v1.9.24

type WebsocketServerConnTagEmpty struct{ myError.MyError }

func (*WebsocketServerConnTagEmpty) Error added in v1.9.24

func (my *WebsocketServerConnTagEmpty) Error() string

func (*WebsocketServerConnTagEmpty) Is added in v1.9.24

func (*WebsocketServerConnTagEmpty) New added in v1.9.24

func (*WebsocketServerConnTagEmpty) Panic added in v1.10.24

func (*WebsocketServerConnTagEmpty) Wrap added in v1.9.24

type WebsocketServerConnTagExist added in v1.9.24

type WebsocketServerConnTagExist struct{ myError.MyError }

func (*WebsocketServerConnTagExist) Error added in v1.9.24

func (my *WebsocketServerConnTagExist) Error() string

func (*WebsocketServerConnTagExist) Is added in v1.9.24

func (*WebsocketServerConnTagExist) New added in v1.9.24

func (*WebsocketServerConnTagExist) Panic added in v1.10.24

func (*WebsocketServerConnTagExist) Wrap added in v1.9.24

type WebsocketServerOnReceiveMessageSuccessCallbackEmpty added in v1.9.24

type WebsocketServerOnReceiveMessageSuccessCallbackEmpty struct{ myError.MyError }

func (*WebsocketServerOnReceiveMessageSuccessCallbackEmpty) Error added in v1.9.24

func (*WebsocketServerOnReceiveMessageSuccessCallbackEmpty) Is added in v1.9.24

func (*WebsocketServerOnReceiveMessageSuccessCallbackEmpty) New added in v1.9.24

func (*WebsocketServerOnReceiveMessageSuccessCallbackEmpty) Panic added in v1.10.24

func (*WebsocketServerOnReceiveMessageSuccessCallbackEmpty) Wrap added in v1.9.24

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL