/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; fill-column: 100 -*- */ /* * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ #pragma once #include #include #include #include #include #include #include #include #include #include #include "Protocol.hpp" #include "Log.hpp" #include "MessageQueue.hpp" #include "Message.hpp" #include "TileCache.hpp" #include "WebSocketHandler.hpp" class Session; template class SessionMap : public std::map > { std::map _canonicalIds; public: SessionMap() { static_assert(std::is_base_of::value, "sessions must have base of Session"); } /// Generate a unique key for this set of view properties, only used by WSD int createCanonicalId(const std::string &viewProps) { if (viewProps.empty()) return 0; for (const auto& it : _canonicalIds) { if (it.first == viewProps) return it.second; } const std::size_t id = _canonicalIds.size() + 1; _canonicalIds[viewProps] = id; return id; } /// Lookup one session in the map that matches this canonical view id, only used by Kit std::shared_ptr findByCanonicalId(int id) { for (const auto &it : *this) { if (it.second->getCanonicalViewId() == id) return it.second; } return std::shared_ptr(); } void dumpState(std::ostream& oss) { for (const auto &it : *this) { oss << "\tsession '" << it.first << "'\n"; it.second->dumpState(oss); } } }; /// Base class of a WebSocket session. class Session : public MessageHandlerInterface { public: const std::string& getId() const { return _id; } const std::string& getName() const { return _name; } bool isDisconnected() const { return _disconnected; } virtual void setReadOnly(bool bValue = true) { _isReadOnly = bValue; } bool isReadOnly() const { return _isReadOnly; } void setAllowChangeComments(bool bValue = true) { _isAllowChangeComments = bValue; } bool isAllowChangeComments() const { return _isAllowChangeComments; } /// overridden to prepend client ids on messages by the Kit virtual bool sendBinaryFrame(const char* buffer, int length); virtual bool sendTextFrame(const char* buffer, const int length); /// Get notified that the underlying transports disconnected void onDisconnect() override { /* ignore */ } bool hasQueuedMessages() const override { // queued in Socket output buffer return false; } // By default rely on the socket buffer. void writeQueuedMessages() override { assert(false); } /// Sends a WebSocket Text message. int sendMessage(const std::string& msg) { return sendTextFrame(msg.data(), msg.size()); } // FIXME: remove synonym - and clean from WebSocketHandler too ... (?) bool sendTextFrame(const std::string& text) { return sendTextFrame(text.data(), text.size()); } template bool sendTextFrame(const char (&buffer)[N]) { return (buffer != nullptr && N > 0 ? sendTextFrame(buffer, N) : false); } bool sendTextFrame(const char* buffer) { return (buffer != nullptr ? sendTextFrame(buffer, std::strlen(buffer)) : false); } bool sendTextFrameAndLogError(const std::string& text) { LOG_ERR(text); return sendTextFrame(text.data(), text.size()); } bool sendTextFrameAndLogError(const char* buffer) { LOG_ERR(buffer); return (buffer != nullptr ? sendTextFrame(buffer, std::strlen(buffer)) : false); } virtual void handleMessage(const std::vector &data) override; /// Invoked when we want to disconnect a session. virtual void disconnect(); /// clean & normal shutdown void shutdownNormal(const std::string& statusMessage = "") { shutdown(false, statusMessage); } /// abnormal / hash shutdown end-point going away void shutdownGoingAway(const std::string& statusMessage = "") { shutdown(true, statusMessage); } bool isActive() const { return _isActive; } void setIsActive(bool active) { _isActive = active; } /// Returns the inactivity time of the client in milliseconds. double getInactivityMS() const { const auto duration = (std::chrono::steady_clock::now() - _lastActivityTime); return std::chrono::duration_cast(duration).count(); } void closeFrame() { _isCloseFrame = true; }; bool isCloseFrame() const { return _isCloseFrame; } void getIOStats(uint64_t &sent, uint64_t &recv); void setUserId(const std::string& userId) { _userId = userId; } const std::string& getUserId() const { return _userId; } void setWatermarkText(const std::string& watermarkText) { _watermarkText = watermarkText; } void setUserExtraInfo(const std::string& userExtraInfo) { _userExtraInfo = userExtraInfo; } void setUserName(const std::string& userName) { _userName = userName; } const std::string& getUserName() const {return _userName; } const std::string& getUserNameAnonym() const { return _userNameAnonym; } bool isDocPasswordProtected() const { return _isDocPasswordProtected; } const std::string& getDocOptions() const { return _docOptions; } bool hasWatermark() const { return !_watermarkText.empty() && _watermarkOpacity > 0.0; } const std::string& getWatermarkText() const { return _watermarkText; } double getWatermarkOpacity() const { return _watermarkOpacity; } const std::string& getLang() const { return _lang; } bool getHaveDocPassword() const { return _haveDocPassword; } void setHaveDocPassword(const bool val) { _haveDocPassword = val; } void setDocPassword(const std::string& password) { _docPassword = password; } const std::string& getDocPassword() const { return _docPassword; } const std::string& getUserExtraInfo() const { return _userExtraInfo; } const std::string& getDocURL() const { return _docURL; } const std::string& getJailedFilePath() const { return _jailedFilePath; } const std::string& getJailedFilePathAnonym() const { return _jailedFilePathAnonym; } int getCanonicalViewId() { return _canonicalViewId; } // Only called by kit. void setCanonicalViewId(int viewId) { _canonicalViewId = viewId; } // Only called by wsd. template void createCanonicalViewId(SessionMap &map) { _canonicalViewId = map.createCanonicalId(_watermarkText); } const std::string& getDeviceFormFactor() const { return _deviceFormFactor; } const std::string& getSpellOnline() const { return _spellOnline; } protected: Session(const std::shared_ptr &handler, const std::string& name, const std::string& id, bool readonly); virtual ~Session(); /// Parses the options of the "load" command, /// shared between MasterProcessSession::loadDocument() and ChildProcessSession::loadDocument(). void parseDocOptions(const StringVector& tokens, int& part, std::string& timestamp, std::string& doctemplate); void updateLastActivityTime() { _lastActivityTime = std::chrono::steady_clock::now(); } void dumpState(std::ostream& os) override; private: void shutdown(bool goingAway = false, const std::string& statusMessage = std::string()); virtual bool _handleInput(const char* buffer, int length) = 0; /// A session ID specific to an end-to-end connection (from user to lokit). const std::string _id; /// A readable name that identifies our peer and ID. const std::string _name; /// True if we have been disconnected. std::atomic _disconnected; /// True if the user is active, otherwise false (switched tabs). std::atomic _isActive; /// Time of the last interactive event being received std::chrono::steady_clock::time_point _lastActivityTime; // Whether websocket received close frame. Closing Handshake std::atomic _isCloseFrame; std::mutex _mutex; /// Whether the session is opened as readonly bool _isReadOnly; /// If the session is read-only, are comments allowed bool _isAllowChangeComments; /// The actual URL, also in the child, even if the child never accesses that. std::string _docURL; /// The Jailed document path. std::string _jailedFilePath; /// The Jailed document path, anonymized for logging. std::string _jailedFilePathAnonym; /// Password provided, if any, to open the document std::string _docPassword; /// If password is provided or not bool _haveDocPassword; /// Whether document is password protected bool _isDocPasswordProtected; /// Document options: a JSON string, containing options (rendering, also possibly load in the future). std::string _docOptions; /// Id of the user to whom the session belongs to. std::string _userId; /// Id of the user to whom the session belongs to, anonymized for logging. std::string _userIdAnonym; /// Name of the user to whom the session belongs to. std::string _userName; /// Name of the user to whom the session belongs to, anonymized for logging. std::string _userNameAnonym; /// Extra info per user, mostly mail, avatar, links, etc. std::string _userExtraInfo; /// In case a watermark has to be rendered on each tile. std::string _watermarkText; /// Opacity in case a watermark has to be rendered on each tile. double _watermarkOpacity; /// Language for the document based on what the user has in the UI. std::string _lang; /// the canonical id unique to the set of rendering properties of this session int _canonicalViewId; /// The form factor of the device where the client is running: desktop, tablet, mobile. std::string _deviceFormFactor; /// The start value of Auto Spell Checking wheter it is enabled or disabled on start. std::string _spellOnline; }; /* vim:set shiftwidth=4 softtabstop=4 expandtab: */