/*************************************************************************** * Copyright (C) 2009 Cyril Soler * * * * 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 2 of the License, or * * (at your option) 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, write to the * * Free Software Foundation, Inc., * * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * ***************************************************************************/ #ifndef RETROSHARE_LINK_ANALYZER #define RETROSHARE_LINK_ANALYZER // This class implements a RS link. // // The link is done in a way that if valid()==true, then the link can be used. // // The following combinations have been tested: // copy paste-> Transfers (DL) | Message compose (forums) | Private msg | Public chat | private Chat // -------------+----------------+--------------------------+------------------+-------------+------------- // search | Y | Y | Y (send RS link) | Paste menu? | Paste menu? // -------------+----------------+--------------------------+------------------+-------------+------------- // shared | Y | Y | Y (send RS link) | Paste menu? | Paste menu? // -------------+----------------+--------------------------+------------------+-------------+------------- // #include #include #include #include #define RSLINK_PROCESS_NOTIFY_SUCCESS 1 // notify on success #define RSLINK_PROCESS_NOTIFY_ERROR 2 // notify on error #define RSLINK_PROCESS_NOTIFY_ASK 4 // ask for add the links #define RSLINK_PROCESS_NOTIFY_ALL -1 #define RSLINK_SCHEME "retroshare" class RetroShareLink { public: enum enumType { TYPE_UNKNOWN, TYPE_FILE, TYPE_PERSON, TYPE_FORUM, TYPE_CHANNEL, TYPE_SEARCH, TYPE_MESSAGE }; public: RetroShareLink(); RetroShareLink(const QUrl& url); RetroShareLink(const QString& url); bool createFile(const QString& name, uint64_t size, const QString& hash); bool createPerson(const std::string& id); bool createForum(const std::string& id, const std::string& msgId); bool createChannel(const std::string& id, const std::string& msgId); bool createSearch(const QString& keywords); bool createMessage(const std::string& peerId, const QString& subject); enumType type() const {return _type; } uint64_t size() const { return _size ; } const QString& name() const { return _name ; } const QString& hash() const { return _hash ; } const QString& id() const { return _hash ; } const QString& msgId() const { return _msgId ; } const QString& subject() const { return _subject ; } QString title() const; // get nice name for anchor QString niceName() const; /// returns the string retroshare://file?name=&size=&hash= /// retroshare://person?name=&hash= QString toString(bool encoded = true) const ; /// returns the string name /// name@hash QString toHtml() const ; /// returns the string retroshare://file?name=&size=&hash= /// retroshare://person?name=&hash= QString toHtmlFull() const ; QString toHtmlSize() const ; QUrl toUrl() const ; bool valid() const { return _valid; } bool operator==(const RetroShareLink& l) const { return _type == l._type && _hash == l._hash ; } static int process(QStringList &urls, RetroShareLink::enumType type = RetroShareLink::TYPE_UNKNOWN, uint flag = RSLINK_PROCESS_NOTIFY_ALL); static int process(QList &links, uint flag = RSLINK_PROCESS_NOTIFY_ALL); private: void fromString(const QString &url); void fromUrl(const QUrl &url); void clear(); void check(); static bool checkHash(const QString& hash); static bool checkName(const QString& name); bool _valid; enumType _type; QString _name; uint64_t _size; QString _hash; // or id (forum, channel, message) QString _msgId; // id of the message (forum, channel) QString _subject; }; /// This class handles the copy/paste of links. Every member is static to ensure unicity. /// I put no mutex, because all calls supposely com from the GUI thread. /// /// All links are stored in html format into the clipboard. Why? Because this allows to import /// links from both the clipboard and the RS application, e.g. paste links from an internet forum. /// This requires many clipboard parsing operations, but this is not a problem because this code is /// not performances-critical. // class RSLinkClipboard { public: // Copy these links to the RS clipboard. Also copy them to the system clipboard // static void copyLinks(const QList& links) ; // Get the liste of pasted links, either from the internal RS links, or by default // from the clipboard. // static void pasteLinks(QList &links) ; // Produces a list of links with no html structure. static QString toString() ; // produces a list of html links that displays with the file names only // static QString toHtml(); // produces a list of html links that displays the full links // static QString toHtmlFull(); // produces a list of html links that displays with the file name + filesize // static QString toHtmlSize(); // Returns true is no links are found to paste. // Useful for menus. // static bool empty(RetroShareLink::enumType type = RetroShareLink::TYPE_UNKNOWN); // Returns the count of processed links // Useful for menus. // static int process(RetroShareLink::enumType type = RetroShareLink::TYPE_UNKNOWN, uint flag = RSLINK_PROCESS_NOTIFY_ALL); private: static void parseClipboard(QList &links) ; }; #endif