312 lines
10 KiB
Python
312 lines
10 KiB
Python
# Websocket Request/Response Handler
|
|
#
|
|
# Copyright (C) 2020 Eric Callahan <arksine.code@gmail.com>
|
|
#
|
|
# This file may be distributed under the terms of the GNU GPLv3 license
|
|
|
|
import logging
|
|
import tornado
|
|
import json
|
|
from tornado.ioloop import IOLoop
|
|
from tornado.websocket import WebSocketHandler, WebSocketClosedError
|
|
from utils import ServerError
|
|
|
|
class Sentinel:
|
|
pass
|
|
|
|
class WebRequest:
|
|
def __init__(self, endpoint, args, action="", conn=None):
|
|
self.endpoint = endpoint
|
|
self.action = action
|
|
self.args = args
|
|
self.conn = conn
|
|
|
|
def get_endpoint(self):
|
|
return self.endpoint
|
|
|
|
def get_action(self):
|
|
return self.action
|
|
|
|
def get_args(self):
|
|
return self.args
|
|
|
|
def get_connection(self):
|
|
return self.conn
|
|
|
|
def _get_converted_arg(self, key, default=Sentinel, dtype=str):
|
|
if key not in self.args:
|
|
if default == Sentinel:
|
|
raise ServerError(f"No data for argument: {key}")
|
|
return default
|
|
val = self.args[key]
|
|
try:
|
|
if dtype != bool:
|
|
return dtype(val)
|
|
else:
|
|
if isinstance(val, str):
|
|
val = val.lower()
|
|
if val in ["true", "false"]:
|
|
return True if val == "true" else False
|
|
elif isinstance(val, bool):
|
|
return val
|
|
raise TypeError
|
|
except Exception:
|
|
raise ServerError(
|
|
f"Unable to convert argument [{key}] to {dtype}: "
|
|
f"value recieved: {val}")
|
|
|
|
def get(self, key, default=Sentinel):
|
|
val = self.args.get(key, default)
|
|
if val == Sentinel:
|
|
raise ServerError(f"No data for argument: {key}")
|
|
return val
|
|
|
|
def get_str(self, key, default=Sentinel):
|
|
return self._get_converted_arg(key, default)
|
|
|
|
def get_int(self, key, default=Sentinel):
|
|
return self._get_converted_arg(key, default, int)
|
|
|
|
def get_float(self, key, default=Sentinel):
|
|
return self._get_converted_arg(key, default, float)
|
|
|
|
def get_boolean(self, key, default=Sentinel):
|
|
return self._get_converted_arg(key, default, bool)
|
|
|
|
class JsonRPC:
|
|
def __init__(self):
|
|
self.methods = {}
|
|
|
|
def register_method(self, name, method):
|
|
self.methods[name] = method
|
|
|
|
def remove_method(self, name):
|
|
self.methods.pop(name, None)
|
|
|
|
async def dispatch(self, data, ws):
|
|
response = None
|
|
try:
|
|
request = json.loads(data)
|
|
except Exception:
|
|
msg = f"Websocket data not json: {data}"
|
|
logging.exception(msg)
|
|
response = self.build_error(-32700, "Parse error")
|
|
return json.dumps(response)
|
|
logging.debug("Websocket Request::" + data)
|
|
if isinstance(request, list):
|
|
response = []
|
|
for req in request:
|
|
resp = await self.process_request(req, ws)
|
|
if resp is not None:
|
|
response.append(resp)
|
|
if not response:
|
|
response = None
|
|
else:
|
|
response = await self.process_request(request, ws)
|
|
if response is not None:
|
|
response = json.dumps(response)
|
|
logging.debug("Websocket Response::" + response)
|
|
return response
|
|
|
|
async def process_request(self, request, ws):
|
|
req_id = request.get('id', None)
|
|
rpc_version = request.get('jsonrpc', "")
|
|
method_name = request.get('method', None)
|
|
if rpc_version != "2.0" or not isinstance(method_name, str):
|
|
return self.build_error(-32600, "Invalid Request", req_id)
|
|
method = self.methods.get(method_name, None)
|
|
if method is None:
|
|
return self.build_error(-32601, "Method not found", req_id)
|
|
if 'params' in request:
|
|
params = request['params']
|
|
if isinstance(params, list):
|
|
response = await self.execute_method(
|
|
method, req_id, ws, *params)
|
|
elif isinstance(params, dict):
|
|
response = await self.execute_method(
|
|
method, req_id, ws, **params)
|
|
else:
|
|
return self.build_error(-32600, "Invalid Request", req_id)
|
|
else:
|
|
response = await self.execute_method(method, req_id, ws)
|
|
return response
|
|
|
|
async def execute_method(self, method, req_id, ws, *args, **kwargs):
|
|
try:
|
|
result = await method(ws, *args, **kwargs)
|
|
except TypeError as e:
|
|
return self.build_error(
|
|
-32603, f"Invalid params:\n{e}", req_id, True)
|
|
except ServerError as e:
|
|
return self.build_error(e.status_code, str(e), req_id, True)
|
|
except Exception as e:
|
|
return self.build_error(-31000, str(e), req_id, True)
|
|
|
|
if req_id is None:
|
|
return None
|
|
else:
|
|
return self.build_result(result, req_id)
|
|
|
|
def build_result(self, result, req_id):
|
|
return {
|
|
'jsonrpc': "2.0",
|
|
'result': result,
|
|
'id': req_id
|
|
}
|
|
|
|
def build_error(self, code, msg, req_id=None, is_exc=False):
|
|
log_msg = f"JSON-RPC Request Error: {code}\n{msg}"
|
|
if is_exc:
|
|
logging.exception(log_msg)
|
|
else:
|
|
logging.info(log_msg)
|
|
return {
|
|
'jsonrpc': "2.0",
|
|
'error': {'code': code, 'message': msg},
|
|
'id': req_id
|
|
}
|
|
|
|
class WebsocketManager:
|
|
def __init__(self, server):
|
|
self.server = server
|
|
self.websockets = {}
|
|
self.ws_lock = tornado.locks.Lock()
|
|
self.rpc = JsonRPC()
|
|
|
|
self.rpc.register_method("server.websocket.id", self._handle_id_request)
|
|
|
|
def register_notification(self, event_name, notify_name=None):
|
|
if notify_name is None:
|
|
notify_name = event_name.split(':')[-1]
|
|
|
|
async def notify_handler(*args):
|
|
await self.notify_websockets(notify_name, *args)
|
|
self.server.register_event_handler(
|
|
event_name, notify_handler)
|
|
|
|
def register_local_handler(self, api_def, callback):
|
|
for ws_method, req_method in \
|
|
zip(api_def.ws_methods, api_def.request_methods):
|
|
rpc_cb = self._generate_local_callback(
|
|
api_def.endpoint, req_method, callback)
|
|
self.rpc.register_method(ws_method, rpc_cb)
|
|
|
|
def register_remote_handler(self, api_def):
|
|
ws_method = api_def.ws_methods[0]
|
|
rpc_cb = self._generate_callback(api_def.endpoint)
|
|
self.rpc.register_method(ws_method, rpc_cb)
|
|
|
|
def remove_handler(self, ws_method):
|
|
self.rpc.remove_method(ws_method)
|
|
|
|
def _generate_callback(self, endpoint):
|
|
async def func(ws, **kwargs):
|
|
result = await self.server.make_request(
|
|
WebRequest(endpoint, kwargs, conn=ws))
|
|
return result
|
|
return func
|
|
|
|
def _generate_local_callback(self, endpoint, request_method, callback):
|
|
async def func(ws, **kwargs):
|
|
result = await callback(
|
|
WebRequest(endpoint, kwargs, request_method, ws))
|
|
return result
|
|
return func
|
|
|
|
async def _handle_id_request(self, ws, **kwargs):
|
|
return {'websocket_id': ws.uid}
|
|
|
|
def has_websocket(self, ws_id):
|
|
return ws_id in self.websockets
|
|
|
|
def get_websocket(self, ws_id):
|
|
return self.websockets.get(ws_id, None)
|
|
|
|
async def add_websocket(self, ws):
|
|
async with self.ws_lock:
|
|
self.websockets[ws.uid] = ws
|
|
logging.info(f"New Websocket Added: {ws.uid}")
|
|
|
|
async def remove_websocket(self, ws):
|
|
async with self.ws_lock:
|
|
old_ws = self.websockets.pop(ws.uid, None)
|
|
if old_ws is not None:
|
|
self.server.remove_subscription(old_ws)
|
|
logging.info(f"Websocket Removed: {ws.uid}")
|
|
|
|
async def notify_websockets(self, name, data=Sentinel):
|
|
msg = {'jsonrpc': "2.0", 'method': "notify_" + name}
|
|
if data != Sentinel:
|
|
msg['params'] = [data]
|
|
async with self.ws_lock:
|
|
for ws in list(self.websockets.values()):
|
|
try:
|
|
ws.write_message(msg)
|
|
except WebSocketClosedError:
|
|
self.websockets.pop(ws.uid, None)
|
|
self.server.remove_subscription(ws)
|
|
logging.info(f"Websocket Removed: {ws.uid}")
|
|
except Exception:
|
|
logging.exception(
|
|
f"Error sending data over websocket: {ws.uid}")
|
|
|
|
async def close(self):
|
|
async with self.ws_lock:
|
|
for ws in list(self.websockets.values()):
|
|
ws.close()
|
|
self.websockets = {}
|
|
|
|
class WebSocket(WebSocketHandler):
|
|
def initialize(self):
|
|
app = self.settings['parent']
|
|
self.auth = app.get_auth()
|
|
self.wsm = app.get_websocket_manager()
|
|
self.rpc = self.wsm.rpc
|
|
self.uid = id(self)
|
|
self.is_closed = False
|
|
|
|
async def open(self):
|
|
await self.wsm.add_websocket(self)
|
|
|
|
def on_message(self, message):
|
|
io_loop = IOLoop.current()
|
|
io_loop.spawn_callback(self._process_message, message)
|
|
|
|
async def _process_message(self, message):
|
|
try:
|
|
response = await self.rpc.dispatch(message, self)
|
|
if response is not None:
|
|
self.write_message(response)
|
|
except Exception:
|
|
logging.exception("Websocket Command Error")
|
|
|
|
def send_status(self, status):
|
|
if not status or self.is_closed:
|
|
return
|
|
try:
|
|
self.write_message({
|
|
'jsonrpc': "2.0",
|
|
'method': "notify_status_update",
|
|
'params': [status]})
|
|
except WebSocketClosedError:
|
|
self.is_closed = True
|
|
logging.info(
|
|
f"Websocket Closed During Status Update: {self.uid}")
|
|
except Exception:
|
|
logging.exception(
|
|
f"Error sending data over websocket: {self.uid}")
|
|
|
|
def on_close(self):
|
|
self.is_closed = True
|
|
io_loop = IOLoop.current()
|
|
io_loop.spawn_callback(self.wsm.remove_websocket, self)
|
|
|
|
def check_origin(self, origin):
|
|
if not super(WebSocket, self).check_origin(origin):
|
|
return self.auth.check_cors(origin)
|
|
return True
|
|
# Check Authorized User
|
|
def prepare(self):
|
|
if not self.auth.check_authorized(self.request):
|
|
raise tornado.web.HTTPError(401, "Unauthorized")
|