/** API session. * * @file * @author Steffen Vogel * @copyright 2014-2022, Institute for Automation of Complex Power Systems, EONERC * @license Apache 2.0 *********************************************************************************/ #pragma once #include #include #include #include namespace villas { namespace node { /* Forward declarations */ class SuperNode; class Api; class Web; namespace api { /* Forward declarations */ class Request; class Response; class StatusRequest; class RequestFactory; /** A connection via HTTP REST or WebSockets to issue API requests. */ class Session { public: friend Request; /**< Requires access to wsi for getting URL args and headers */ friend StatusRequest; /**< Requires access to wsi for context status */ friend RequestFactory; enum State { ESTABLISHED, SHUTDOWN }; enum Version { UNKNOWN_VERSION = 0, VERSION_1 = 1, VERSION_2 = 2 }; enum Method { UNKNOWN, GET, POST, DELETE, OPTIONS, PUT, PATCH }; protected: enum State state; enum Version version; lws *wsi; Web *web; Api *api; Logger logger; std::unique_ptr request; std::unique_ptr response; bool headersSent; public: Session(struct lws *w); ~Session(); std::string getName() const; SuperNode * getSuperNode() const { return api->getSuperNode(); } void open(void *in, size_t len); int writeable(); void body(void *in, size_t len); void bodyComplete(); void execute(); void shutdown(); static int protocolCallback(struct lws *wsi, enum lws_callback_reasons reason, void *user, void *in, size_t len); Method getRequestMethod() const; static std::string methodToString(Method meth); }; } // namespace api } // namespace node } // namespace villas