xviz/docs/api-reference/server/xviz-provider-request-handler.md
Timothy Wojtaszek 6a85f68a72 @xviz/server module (#453)
Proper module to replace our adhoc server script with a structured middleware-based implementation.

Key documents are:
 - RFC ./dev-docs/004-server-module-rfc.md
 - User Docs ./docs/api-reference/server
 - Module Readme ./modules/server/README.md
2019-05-23 16:34:18 -07:00

1.5 KiB

XVIZProviderRequestHandler

XVIZProviderRequestHandler is a middleware component for an XVIZProvider that will respond to XVIZ messages handle state management and event transitions based on the specific XVIZ requestevent transitions based on the specific XVIZ request.

Example

this.middleware = new XVIZServerMiddlewareStack();

const stack = [
  new XVIZProviderRequestHandler(this.context, this.provider, this.middleware, this.options),
  new XVIZWebsocketSender(this.context, this.socket, this.options)
];
this.middleware.set(stack);

Constructor

XVIZProviderRequestHandler(context, provider, middleware, options)

Parameters:

  • context (XVIZSessionContext) - Shared session context to store data
  • provider (XVIZProvider) - An XVIZProvider instance
  • middleware (XVIZServerMiddlewareStack) - Middleware instance to route messages
  • options (Object) - Options for the Server
    • delay (Number) - Millisecond delay between sending response messages
    • logger (Object) - Logger object passed through the system
      • log (Function) - Function that will always display the message
      • error (Function) - Function for error level messages
      • warn (Function) - Function for warning level messages
      • info (Function) - Function for info level messages
      • verbose (Function) - Function for verbose level messages