cmdserver

Diatheke Command Server

This package provides a simple http server that may be used for Diatheke command fulfillment. Such a server should be deployed with Diatheke, Cubic, Luna, etc. so that the Diatheke server can access the command server.

Security

Note that this server only supports http at the present. It does not allow secure connections (https), so any data sent to this server will not be encrypted. As such, it is not recommended to use this server for production.

Usage

Import the package using the go tool:

go get -u github.com/cobaltspeech/examples-go/cmdserver

To use the command server, create a new server, register command handlers and run.

type SomeHandler struct {
	// Contains some data fields
}

func (h *SomeHandler) fooCmd(input cmdserver.Params) (cmdserver.Params, error) {
	// Do something interesting with the command input.
	return nil, nil
}

func (h *SomeHandler) barCmd(input cmdserver.Params) (cmdserver.Params, error) {
	// Do something interesting with the command input.

	// Create the output parameters
	outParams := make(cmdserver.Params)
	outParams["expectedKey"] = "expectedVal"

	return outParams, nil
}

func main() {
	// Create the server (with an optional logger if desired)
	svr := cmdserver.NewServer(nil)

	// Set handlers for command IDs
	handler := SomeHandler{}
	svr.SetHandler("foo", handler.fooCmd)
	svr.SetHandler("bar", handler.barCmd)

	// Run the server
	if err := svr.Run(":24601"); err != nil {
		os.Exit(1)
	}
}