/** API session. * * @file * @author Steffen Vogel * @copyright 2014-2020, Institute for Automation of Complex Power Systems, EONERC * @license GNU General Public License (version 3) * * VILLASnode * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . *********************************************************************************/ #pragma once #include #include #include #include #include namespace villas { namespace node { /* Forward declarations */ class SuperNode; class Api; class Web; namespace api { /* Forward declarations */ class Request; class Response; /** A connection via HTTP REST or WebSockets to issue API requests. */ class Session { public: enum State { ESTABLISHED, SHUTDOWN }; enum Version { UNKNOWN_VERSION = 0, VERSION_1 = 1, VERSION_2 = 2 }; protected: enum State state; enum Version version; lws *wsi; Web *web; Api *api; Logger logger; JsonBuffer requestBuffer; JsonBuffer responseBuffer; std::atomic request; std::atomic 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); int getRequestMethod(struct lws *wsi); static std::string methodToString(int meth); }; } /* namespace api */ } /* namespace node */ } /* namespace villas */