ing
This commit is contained in:
parent
a9e720e7ab
commit
2f96f3bf23
1
websocket/channel.go
Normal file
1
websocket/channel.go
Normal file
@ -0,0 +1 @@
|
||||
package websocket
|
108
websocket/client.go
Normal file
108
websocket/client.go
Normal file
@ -0,0 +1,108 @@
|
||||
package websocket
|
||||
|
||||
import (
|
||||
"io"
|
||||
"net/http"
|
||||
"sync"
|
||||
"time"
|
||||
|
||||
"github.com/gorilla/websocket"
|
||||
)
|
||||
|
||||
type Client interface {
|
||||
ID() string
|
||||
RemoteAddr() string
|
||||
UserAgent() string
|
||||
SetWriteDeadline(t time.Time) error
|
||||
SetReadDeadline(t time.Time) error
|
||||
SetReadLimit(limit int64)
|
||||
SetPongHandler(h func(appData string) error)
|
||||
SetPingHandler(h func(appData string) error)
|
||||
WriteControl(messageType int, data []byte, deadline time.Time) error
|
||||
WriteMessage(messageType int, data []byte) error
|
||||
ReadMessage() (messageType int, p []byte, err error)
|
||||
NextWriter(messageType int) (io.WriteCloser, error)
|
||||
IsClosed() bool
|
||||
Close() error
|
||||
}
|
||||
|
||||
type client struct {
|
||||
id string
|
||||
server *server
|
||||
httpRequest *http.Request
|
||||
conn *websocket.Conn
|
||||
writeMTX sync.Mutex
|
||||
}
|
||||
|
||||
var _ Client = &client{}
|
||||
|
||||
func newClient(s *server, r *http.Request, conn *websocket.Conn, clientID string) Client {
|
||||
c := &client{
|
||||
id: clientID,
|
||||
server: s,
|
||||
httpRequest: r,
|
||||
conn: conn,
|
||||
}
|
||||
|
||||
return c
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) RemoteAddr() string {
|
||||
return c.httpRequest.RemoteAddr
|
||||
}
|
||||
|
||||
func (c *client) UserAgent() string {
|
||||
return c.httpRequest.UserAgent()
|
||||
}
|
||||
|
||||
func (c *client) SetWriteDeadline(t time.Time) error {
|
||||
return c.conn.SetWriteDeadline(t)
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
||||
|
||||
func (c *client) ID() string {
|
||||
return c.id
|
||||
}
|
@ -1,12 +0,0 @@
|
||||
package websocket
|
||||
|
||||
import (
|
||||
"net/http"
|
||||
"sync"
|
||||
)
|
||||
|
||||
type connection struct {
|
||||
id string
|
||||
httpRequest http.Request
|
||||
writeMTX sync.Mutex
|
||||
}
|
@ -33,20 +33,20 @@ type (
|
||||
// OptionSetter sets a configuration field to the websocket config
|
||||
// used to help developers to write less and configure only what they really want and nothing else
|
||||
OptionSetter interface {
|
||||
Set(c *Config)
|
||||
Set(o *Options)
|
||||
}
|
||||
|
||||
// OptionSet implements the OptionSetter
|
||||
OptionSet func(c *Config)
|
||||
OptionSet func(o *Options)
|
||||
)
|
||||
|
||||
// Set is the func which makes the OptionSet an OptionSetter, this is used mostly
|
||||
func (o OptionSet) Set(c *Config) {
|
||||
o(c)
|
||||
func (os OptionSet) Set(o *Options) {
|
||||
os(o)
|
||||
}
|
||||
|
||||
// Config is configuration of the websocket server
|
||||
type Config struct {
|
||||
// Options is configuration of the websocket server
|
||||
type Options struct {
|
||||
Error func(res http.ResponseWriter, req *http.Request, status int, reason error)
|
||||
CheckOrigin func(req *http.Request) bool
|
||||
WriteTimeout time.Duration
|
||||
@ -61,72 +61,72 @@ type Config struct {
|
||||
}
|
||||
|
||||
// Set is the func which makes the OptionSet an OptionSetter, this is used mostly
|
||||
func (c Config) Set(main *Config) {
|
||||
main.Error = c.Error
|
||||
main.CheckOrigin = c.CheckOrigin
|
||||
main.WriteTimeout = c.WriteTimeout
|
||||
main.ReadTimeout = c.ReadTimeout
|
||||
main.PongTimeout = c.PongTimeout
|
||||
main.PingPeriod = c.PingPeriod
|
||||
main.MaxMessageSize = c.MaxMessageSize
|
||||
main.BinaryMessages = c.BinaryMessages
|
||||
main.ReadBufferSize = c.ReadBufferSize
|
||||
main.WriteBufferSize = c.WriteBufferSize
|
||||
main.IDGenerator = c.IDGenerator
|
||||
func (o *Options) Set(main *Options) {
|
||||
main.Error = o.Error
|
||||
main.CheckOrigin = o.CheckOrigin
|
||||
main.WriteTimeout = o.WriteTimeout
|
||||
main.ReadTimeout = o.ReadTimeout
|
||||
main.PongTimeout = o.PongTimeout
|
||||
main.PingPeriod = o.PingPeriod
|
||||
main.MaxMessageSize = o.MaxMessageSize
|
||||
main.BinaryMessages = o.BinaryMessages
|
||||
main.ReadBufferSize = o.ReadBufferSize
|
||||
main.WriteBufferSize = o.WriteBufferSize
|
||||
main.IDGenerator = o.IDGenerator
|
||||
}
|
||||
|
||||
// Error sets the error handler
|
||||
func Error(val func(res http.ResponseWriter, req *http.Request, status int, reason error)) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.Error = val
|
||||
return func(o *Options) {
|
||||
o.Error = val
|
||||
}
|
||||
}
|
||||
|
||||
// CheckOrigin sets a handler which will check if different origin(domains) are allowed to contact with
|
||||
// the websocket server
|
||||
func CheckOrigin(val func(req *http.Request) bool) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.CheckOrigin = val
|
||||
return func(o *Options) {
|
||||
o.CheckOrigin = val
|
||||
}
|
||||
}
|
||||
|
||||
// WriteTimeout time allowed to write a message to the connection.
|
||||
// Default value is 15 * time.Second
|
||||
func WriteTimeout(val time.Duration) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.WriteTimeout = val
|
||||
return func(o *Options) {
|
||||
o.WriteTimeout = val
|
||||
}
|
||||
}
|
||||
|
||||
// ReadTimeout time allowed to read a message from the connection.
|
||||
// Default value is 15 * time.Second
|
||||
func ReadTimeout(val time.Duration) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.ReadTimeout = val
|
||||
return func(o *Options) {
|
||||
o.ReadTimeout = val
|
||||
}
|
||||
}
|
||||
|
||||
// PongTimeout allowed to read the next pong message from the connection
|
||||
// Default value is 60 * time.Second
|
||||
func PongTimeout(val time.Duration) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.PongTimeout = val
|
||||
return func(o *Options) {
|
||||
o.PongTimeout = val
|
||||
}
|
||||
}
|
||||
|
||||
// PingPeriod send ping messages to the connection with this period. Must be less than PongTimeout
|
||||
// Default value is (PongTimeout * 9) / 10
|
||||
func PingPeriod(val time.Duration) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.PingPeriod = val
|
||||
return func(o *Options) {
|
||||
o.PingPeriod = val
|
||||
}
|
||||
}
|
||||
|
||||
// MaxMessageSize max message size allowed from connection
|
||||
// Default value is 1024
|
||||
func MaxMessageSize(val int64) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.MaxMessageSize = val
|
||||
return func(o *Options) {
|
||||
o.MaxMessageSize = val
|
||||
}
|
||||
}
|
||||
|
||||
@ -135,22 +135,22 @@ func MaxMessageSize(val int64) OptionSet {
|
||||
// like a native server-client communication.
|
||||
// defaults to false
|
||||
func BinaryMessages(val bool) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.BinaryMessages = val
|
||||
return func(o *Options) {
|
||||
o.BinaryMessages = val
|
||||
}
|
||||
}
|
||||
|
||||
// ReadBufferSize is the buffer size for the underline reader
|
||||
func ReadBufferSize(val int) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.ReadBufferSize = val
|
||||
return func(o *Options) {
|
||||
o.ReadBufferSize = val
|
||||
}
|
||||
}
|
||||
|
||||
// WriteBufferSize is the buffer size for the underline writer
|
||||
func WriteBufferSize(val int) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.WriteBufferSize = val
|
||||
return func(o *Options) {
|
||||
o.WriteBufferSize = val
|
||||
}
|
||||
}
|
||||
|
||||
@ -159,56 +159,54 @@ func WriteBufferSize(val int) OptionSet {
|
||||
// The request is an argument which you can use to generate the ID (from headers for example).
|
||||
// If empty then the ID is generated by func: uuid.NewV4().String()
|
||||
func IDGenerator(val func(*http.Request) string) OptionSet {
|
||||
return func(c *Config) {
|
||||
c.IDGenerator = val
|
||||
return func(o *Options) {
|
||||
o.IDGenerator = val
|
||||
}
|
||||
}
|
||||
|
||||
// Validate validates the configuration
|
||||
func (c Config) Validate() Config {
|
||||
func (o *Options) Validate() {
|
||||
|
||||
if c.WriteTimeout < 0 {
|
||||
c.WriteTimeout = DefaultWriteTimeout
|
||||
if o.WriteTimeout < 0 {
|
||||
o.WriteTimeout = DefaultWriteTimeout
|
||||
}
|
||||
|
||||
if c.ReadTimeout < 0 {
|
||||
c.ReadTimeout = DefaultReadTimeout
|
||||
if o.ReadTimeout < 0 {
|
||||
o.ReadTimeout = DefaultReadTimeout
|
||||
}
|
||||
|
||||
if c.PongTimeout < 0 {
|
||||
c.PongTimeout = DefaultPongTimeout
|
||||
if o.PongTimeout < 0 {
|
||||
o.PongTimeout = DefaultPongTimeout
|
||||
}
|
||||
|
||||
if c.PingPeriod <= 0 {
|
||||
c.PingPeriod = DefaultPingPeriod
|
||||
if o.PingPeriod <= 0 {
|
||||
o.PingPeriod = DefaultPingPeriod
|
||||
}
|
||||
|
||||
if c.MaxMessageSize <= 0 {
|
||||
c.MaxMessageSize = DefaultMaxMessageSize
|
||||
if o.MaxMessageSize <= 0 {
|
||||
o.MaxMessageSize = DefaultMaxMessageSize
|
||||
}
|
||||
|
||||
if c.ReadBufferSize <= 0 {
|
||||
c.ReadBufferSize = DefaultReadBufferSize
|
||||
if o.ReadBufferSize <= 0 {
|
||||
o.ReadBufferSize = DefaultReadBufferSize
|
||||
}
|
||||
|
||||
if c.WriteBufferSize <= 0 {
|
||||
c.WriteBufferSize = DefaultWriteBufferSize
|
||||
if o.WriteBufferSize <= 0 {
|
||||
o.WriteBufferSize = DefaultWriteBufferSize
|
||||
}
|
||||
|
||||
if c.Error == nil {
|
||||
c.Error = func(res http.ResponseWriter, req *http.Request, status int, reason error) {
|
||||
if o.Error == nil {
|
||||
o.Error = func(res http.ResponseWriter, req *http.Request, status int, reason error) {
|
||||
}
|
||||
}
|
||||
|
||||
if c.CheckOrigin == nil {
|
||||
c.CheckOrigin = func(req *http.Request) bool {
|
||||
if o.CheckOrigin == nil {
|
||||
o.CheckOrigin = func(req *http.Request) bool {
|
||||
return true
|
||||
}
|
||||
}
|
||||
|
||||
if c.IDGenerator == nil {
|
||||
c.IDGenerator = DefaultIDGenerator
|
||||
if o.IDGenerator == nil {
|
||||
o.IDGenerator = DefaultIDGenerator
|
||||
}
|
||||
|
||||
return c
|
||||
}
|
@ -1,70 +1,126 @@
|
||||
package websocket
|
||||
|
||||
import "net/http"
|
||||
import (
|
||||
"fmt"
|
||||
"log"
|
||||
"net/http"
|
||||
"sync"
|
||||
|
||||
"github.com/gorilla/websocket"
|
||||
)
|
||||
|
||||
type (
|
||||
OnConnectionFunc func(websocket.Conn)
|
||||
)
|
||||
|
||||
// Server is the websocket server,
|
||||
// listens on the config's port, the critical part is the event OnConnection
|
||||
type Server interface {
|
||||
// Set sets an option aka configuration field to the websocket server
|
||||
Set(...OptionSetter)
|
||||
// Handler returns the http.Handler which is setted to the 'Websocket Endpoint path',
|
||||
// the client should target to this handler's developer's custom path
|
||||
// ex: http.Handle("/myendpoint", mywebsocket.Handler())
|
||||
// Handler calls the HandleConnection, so
|
||||
// Use Handler or HandleConnection manually, DO NOT USE both.
|
||||
// Note: you can always create your own upgrader which returns an UnderlineConnection and call only the HandleConnection manually (as Iris web framework does)
|
||||
Handler() http.Handler
|
||||
// HandleConnection creates & starts to listening to a new connection
|
||||
// DO NOT USE Handler() and HandleConnection at the sametime, see Handler for more
|
||||
// NOTE: You don't need this, this is needed only when we want to 'hijack' the upgrader
|
||||
// (used for Iris and fasthttp before Iris v6)
|
||||
HandleConnection(*http.Request, UnderlineConnection)
|
||||
// OnConnection this is the main event you, as developer, will work with each of the websocket connections
|
||||
OnConnection(cb ConnectionFunc)
|
||||
|
||||
/*
|
||||
connection actions, same as the connection's method,
|
||||
but these methods accept the connection ID,
|
||||
which is useful when the developer maps
|
||||
this id with a database field (using config.IDGenerator).
|
||||
*/
|
||||
|
||||
// IsConnected returns true if the connection with that ID is connected to the server
|
||||
// useful when you have defined a custom connection id generator (based on a database)
|
||||
// and you want to check if that connection is already connected (on multiple tabs)
|
||||
IsConnected(connID string) bool
|
||||
|
||||
// Join joins a websocket client to a room,
|
||||
// first parameter is the room name and the second the connection.ID()
|
||||
//
|
||||
// You can use connection.Join("room name") instead.
|
||||
Join(roomName string, connID string)
|
||||
|
||||
// LeaveAll kicks out a connection from ALL of its joined rooms
|
||||
LeaveAll(connID string)
|
||||
|
||||
// Leave leaves a websocket client from a room,
|
||||
// first parameter is the room name and the second the connection.ID()
|
||||
//
|
||||
// You can use connection.Leave("room name") instead.
|
||||
// Returns true if the connection has actually left from the particular room.
|
||||
Leave(roomName string, connID string) bool
|
||||
|
||||
// GetConnectionsByRoom returns a list of Connection
|
||||
// are joined to this room.
|
||||
GetConnectionsByRoom(roomName string) []Connection
|
||||
|
||||
// Disconnect force-disconnects a websocket connection
|
||||
// based on its connection.ID()
|
||||
// What it does?
|
||||
// 1. remove the connection from the list
|
||||
// 2. leave from all joined rooms
|
||||
// 3. fire the disconnect callbacks, if any
|
||||
// 4. close the underline connection and return its error, if any.
|
||||
//
|
||||
// You can use the connection.Disconnect() instead.
|
||||
Disconnect(connID string) error
|
||||
HandleConnection(*http.Request, *websocket.Conn)
|
||||
OnConnection(cb OnConnectionFunc)
|
||||
IsConnected(clientID string) bool
|
||||
GetClient(clientID string) *Client
|
||||
Disconnect(clientID string) error
|
||||
}
|
||||
|
||||
type server struct {
|
||||
options *Options
|
||||
clients map[string]*client
|
||||
clientMTX sync.Mutex
|
||||
onConnectionListeners []OnConnectionFunc
|
||||
}
|
||||
|
||||
var _ Server = &server{}
|
||||
|
||||
var defaultServer = newServer()
|
||||
|
||||
// server implementation
|
||||
|
||||
// New creates a websocket server and returns it
|
||||
func New(setters ...OptionSetter) Server {
|
||||
return newServer(setters...)
|
||||
}
|
||||
|
||||
// newServer creates a websocket server and returns it
|
||||
func newServer(setters ...OptionSetter) *server {
|
||||
|
||||
s := &server{
|
||||
clients: make(map[string]*client, 100),
|
||||
onConnectionListeners: make([]OnConnectionFunc, 0),
|
||||
}
|
||||
|
||||
s.Set(setters...)
|
||||
return s
|
||||
}
|
||||
|
||||
func (s *server) Set(setters ...OptionSetter) {
|
||||
for _, setter := range setters {
|
||||
setter.Set(s.options)
|
||||
}
|
||||
|
||||
s.options.Validate()
|
||||
}
|
||||
|
||||
func (s *server) Handler() http.Handler {
|
||||
o := s.options
|
||||
|
||||
upgrader := websocket.Upgrader{
|
||||
ReadBufferSize: o.ReadBufferSize,
|
||||
WriteBufferSize: o.WriteBufferSize,
|
||||
Error: o.Error,
|
||||
CheckOrigin: o.CheckOrigin}
|
||||
|
||||
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
||||
conn, err := upgrader.Upgrade(w, r, w.Header())
|
||||
if err != nil {
|
||||
http.Error(w, "Websocket Error: "+err.Error(), http.StatusServiceUnavailable)
|
||||
return
|
||||
}
|
||||
s.HandleConnection(r, conn)
|
||||
})
|
||||
}
|
||||
|
||||
func (s *server) HandleConnection(r *http.Request, conn *websocket.Conn) {
|
||||
clientID := s.options.IDGenerator(r)
|
||||
c := newClient(s, r, conn, clientID)
|
||||
err := s.addClient(clientID, c)
|
||||
if nil != err {
|
||||
log.Println(fmt.Errorf("%v", err))
|
||||
return
|
||||
}
|
||||
}
|
||||
|
||||
func (s *server) OnConnection(cb OnConnectionFunc) {
|
||||
s.onConnectionListeners = append(s.onConnectionListeners, cb)
|
||||
}
|
||||
|
||||
func (s *server) IsConnected(clientID string) bool {
|
||||
c := s.clients[clientID]
|
||||
return c != nil
|
||||
}
|
||||
|
||||
func (s *server) GetClient(clientID string) *Client {
|
||||
return s.clients[clientID]
|
||||
}
|
||||
|
||||
func (s *server) Disconnect(clientID string) error {
|
||||
c := s.clients[clientID]
|
||||
|
||||
if nil == c {
|
||||
return nil
|
||||
}
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
func (s *server) addClient(clientID string, c *client) error {
|
||||
s.clientMTX.Lock()
|
||||
if s.clients[clientID] != nil {
|
||||
return fmt.Errorf("Client[%s] is exist already", clientID)
|
||||
}
|
||||
s.clients[clientID] = c
|
||||
s.clientMTX.Unlock()
|
||||
return nil
|
||||
}
|
||||
|
Loading…
x
Reference in New Issue
Block a user