websockets

Documentation

Overview

Package websockets implements a WebSocket server by executing a command and piping its input and output through the WebSocket connection.

Index

• Variables
• type Config
• type WebSocket
  • func (ws WebSocket) Handle(conn *websocket.Conn)
• type WebSockets
  • func (ws WebSockets) ServeHTTP(w http.ResponseWriter, r *http.Request) (int, error)

Variables

var (
	// GatewayInterface is the dialect of CGI being used by the server
	// to communicate with the script.  See CGI spec, 4.1.4
	GatewayInterface string

	// ServerSoftware is the name and version of the information server
	// software making the CGI request.  See CGI spec, 4.1.17
	ServerSoftware string
)

Types

type Config

type Config struct {
	Path      string
	Command   string
	Arguments []string
	Respawn   bool // TODO: Not used, but parser supports it until we decide on it
}

Config holds the configuration for a single websocket endpoint which may serve multiple websocket connections.

type WebSocket

type WebSocket struct {
	Config
	*http.Request
}

WebSocket represents a web socket server instance. A WebSocket is instantiated for each new websocket request/connection.

func (WebSocket) Handle

func (ws WebSocket) Handle(conn *websocket.Conn)

Handle handles a WebSocket connection. It launches the specified command and streams input and output through the command's stdin and stdout.

type WebSockets

type WebSockets struct {
	// Next is the next HTTP handler in the chain for when the path doesn't match
	Next middleware.Handler

	// Sockets holds all the web socket endpoint configurations
	Sockets []Config
}

WebSockets is a type that holds configuration for the websocket middleware generally, like a list of all the websocket endpoints.

func (WebSockets) ServeHTTP

func (ws WebSockets) ServeHTTP(w http.ResponseWriter, r *http.Request) (int, error)

ServeHTTP converts the HTTP request to a WebSocket connection and serves it up.