/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; fill-column: 100 -*- */ /* * This file is part of the LibreOffice project. * * 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/. */ #ifndef INCLUDED_CHILDSESSION_HPP #define INCLUDED_CHILDSESSION_HPP #include #include #include #define LOK_USE_UNSTABLE_API #include #include #include #include "Common.hpp" #include "Kit.hpp" #include "Session.hpp" class ChildSession; enum class LokEventTargetEnum { Document, Window }; // An abstract interface. class DocumentManagerInterface { public: /// Reqest loading a document, or a new view, if one exists. virtual bool onLoad(const std::string& sessionId, const std::string& jailedFilePath, const std::string& jailedFilePathAnonym, const std::string& userName, const std::string& userNameAnonym, const std::string& docPassword, const std::string& renderOpts, const bool haveDocPassword, const std::string& lang, const std::string& watermarkText) = 0; /// Unload a client session, which unloads the document /// if it is the last and only. virtual void onUnload(const ChildSession& session) = 0; /// Access to the document instance. virtual std::shared_ptr getLOKitDocument() = 0; /// Access to the office instance. virtual std::shared_ptr getLOKit() = 0; /// Send updated view info to all active sessions. virtual void notifyViewInfo() = 0; virtual void updateEditorSpeeds(int id, int speed) = 0; virtual int getEditorId() = 0; /// Get a view ID <-> UserInfo map. virtual std::map getViewInfo() = 0; virtual std::mutex& getMutex() = 0; /// Mutex guarding the document - so that we can lock operations like /// setting a view followed by a tile render, etc. virtual std::mutex& getDocumentMutex() = 0; virtual std::string getObfuscatedFileId() = 0; virtual std::shared_ptr& getTileQueue() = 0; virtual bool sendFrame(const char* buffer, int length, WSOpCode opCode = WSOpCode::Text) = 0; }; struct RecordedEvent { private: int _type = 0; std::string _payload; public: RecordedEvent() { } RecordedEvent(int type, const std::string& payload) : _type(type), _payload(payload) { } void setType(int type) { _type = type; } int getType() const { return _type; } void setPayload(const std::string& payload) { _payload = payload; } const std::string& getPayload() const { return _payload; } }; /// When the session is inactive, we need to record its state for a replay. class StateRecorder { private: bool _invalidate; std::unordered_map _recordedStates; std::unordered_map> _recordedViewEvents; std::unordered_map _recordedEvents; std::vector _recordedEventsVector; public: StateRecorder() : _invalidate(false) {} // TODO Remember the maximal area we need to invalidate - grow it step by step. void recordInvalidate() { _invalidate = true; } bool isInvalidate() const { return _invalidate; } const std::unordered_map& getRecordedStates() const { return _recordedStates; } const std::unordered_map>& getRecordedViewEvents() const { return _recordedViewEvents; } const std::unordered_map& getRecordedEvents() const { return _recordedEvents; } const std::vector& getRecordedEventsVector() const { return _recordedEventsVector; } void recordEvent(const int type, const std::string& payload) { _recordedEvents[type] = RecordedEvent(type, payload); } void recordViewEvent(const int viewId, const int type, const std::string& payload) { _recordedViewEvents[viewId][type] = {type, payload}; } void recordState(const std::string& name, const std::string& value) { _recordedStates[name] = value; } /// In the case we need to rememeber all the events that come, not just /// the final state. void recordEventSequence(const int type, const std::string& payload) { _recordedEventsVector.emplace_back(type, payload); } void clear() { _invalidate = false; _recordedEvents.clear(); _recordedViewEvents.clear(); _recordedStates.clear(); _recordedEventsVector.clear(); } }; /// Represents a session to the WSD process, in a Kit process. Note that this is not a singleton. class ChildSession final : public Session { public: /// Create a new ChildSession /// ws The socket between master and kit (jailed). /// loKit The LOKit instance. /// loKitDocument The instance to an existing document (when opening /// a new view) or nullptr (when first view). /// jailId The JailID of the jail root directory, // used by downloadas to construct jailed path. ChildSession(const std::string& id, const std::string& jailId, DocumentManagerInterface& docManager); virtual ~ChildSession(); bool getStatus(const char* buffer, int length); int getViewId() const { return _viewId; } void setViewId(const int viewId) { _viewId = viewId; } const std::string& getViewUserId() const { return getUserId(); } const std::string& getViewUserName() const { return getUserName(); } const std::string& getViewUserExtraInfo() const { return getUserExtraInfo(); } void updateSpeed(); int getSpeed(); void loKitCallback(const int type, const std::string& payload); bool sendTextFrame(const char* buffer, int length) override { const auto msg = "client-" + getId() + ' ' + std::string(buffer, length); const std::unique_lock lock = getLock(); return _docManager.sendFrame(msg.data(), msg.size(), WSOpCode::Text); } bool sendBinaryFrame(const char* buffer, int length) override { const auto msg = "client-" + getId() + ' ' + std::string(buffer, length); const std::unique_lock lock = getLock(); return _docManager.sendFrame(msg.data(), msg.size(), WSOpCode::Binary); } using Session::sendTextFrame; private: bool loadDocument(const char* buffer, int length, const std::vector& tokens); bool sendFontRendering(const char* buffer, int length, const std::vector& tokens); bool getCommandValues(const char* buffer, int length, const std::vector& tokens); bool clientZoom(const char* buffer, int length, const std::vector& tokens); bool clientVisibleArea(const char* buffer, int length, const std::vector& tokens); bool outlineState(const char* buffer, int length, const std::vector& tokens); bool downloadAs(const char* buffer, int length, const std::vector& tokens); bool getChildId(); bool getTextSelection(const char* buffer, int length, const std::vector& tokens); std::string getTextSelectionInternal(const std::string& mimeType); bool paste(const char* buffer, int length, const std::vector& tokens); bool insertFile(const char* buffer, int length, const std::vector& tokens); bool keyEvent(const char* buffer, int length, const std::vector& tokens, const LokEventTargetEnum target); bool extTextInputEvent(const char* /*buffer*/, int /*length*/, const std::vector& tokens); bool dialogKeyEvent(const char* buffer, int length, const std::vector& tokens); bool mouseEvent(const char* buffer, int length, const std::vector& tokens, const LokEventTargetEnum target); bool gestureEvent(const char* buffer, int length, const std::vector& tokens); bool unoCommand(const char* buffer, int length, const std::vector& tokens); bool selectText(const char* buffer, int length, const std::vector& tokens); bool selectGraphic(const char* buffer, int length, const std::vector& tokens); bool renderWindow(const char* buffer, int length, const std::vector& tokens); bool resetSelection(const char* buffer, int length, const std::vector& tokens); bool saveAs(const char* buffer, int length, const std::vector& tokens); bool setClientPart(const char* buffer, int length, const std::vector& tokens); bool setPage(const char* buffer, int length, const std::vector& tokens); bool sendWindowCommand(const char* buffer, int length, const std::vector& tokens); bool signDocumentContent(const char* buffer, int length, const std::vector& tokens); bool askSignatureStatus(const char* buffer, int length, const std::vector& tokens); bool uploadSignedDocument(const char* buffer, int length, const std::vector& tokens); bool exportSignAndUploadDocument(const char* buffer, int length, const std::vector& tokens); bool renderShapeSelection(const char* buffer, int length, const std::vector& tokens); void rememberEventsForInactiveUser(const int type, const std::string& payload); virtual void disconnect() override; virtual bool _handleInput(const char* buffer, int length) override; std::shared_ptr getLOKitDocument() { return _docManager.getLOKitDocument(); } private: const std::string _jailId; DocumentManagerInterface& _docManager; std::queue _cursorInvalidatedEvent; const unsigned _eventStorageIntervalMs = 15*1000; /// View ID, returned by createView() or 0 by default. int _viewId; /// Whether document has been opened succesfuly bool _isDocLoaded; std::string _docType; StateRecorder _stateRecorder; /// If we are copying to clipboard. bool _copyToClipboard; /// Synchronize _loKitDocument access. /// This should be owned by Document. static std::recursive_mutex Mutex; }; #endif /* vim:set shiftwidth=4 softtabstop=4 expandtab: */