/****************************************************************************** * Copyright (C) 2015 Felix Rohrbach * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #ifndef QMATRIXCLIENT_CONNECTION_H #define QMATRIXCLIENT_CONNECTION_H #include #include namespace QMatrixClient { class Room; class User; class Event; class ConnectionPrivate; class ConnectionData; class SyncJob; class RoomMessagesJob; class PostReceiptJob; class MediaThumbnailJob; class Connection: public QObject { Q_OBJECT public: Connection(QUrl server, QObject* parent = nullptr); Connection(); virtual ~Connection(); QHash roomMap() const; Q_INVOKABLE virtual bool isConnected(); Q_INVOKABLE virtual void resolveServer( QString domain ); Q_INVOKABLE virtual void connectToServer( QString user, QString password ); Q_INVOKABLE virtual void connectWithToken( QString userId, QString token ); Q_INVOKABLE virtual void reconnect(); Q_INVOKABLE virtual void disconnectFromServer(); Q_INVOKABLE virtual void logout(); Q_INVOKABLE virtual void sync(int timeout=-1); Q_INVOKABLE virtual void postMessage( Room* room, QString type, QString message ); Q_INVOKABLE virtual PostReceiptJob* postReceipt( Room* room, Event* event ); Q_INVOKABLE virtual void joinRoom( QString roomAlias ); Q_INVOKABLE virtual void leaveRoom( Room* room ); Q_INVOKABLE virtual RoomMessagesJob* getMessages( Room* room, QString from ); virtual MediaThumbnailJob* getThumbnail( QUrl url, QSize requestedSize ); MediaThumbnailJob* getThumbnail( QUrl url, int requestedWidth, int requestedHeight ); Q_INVOKABLE QUrl homeserver() const; Q_INVOKABLE User* user(QString userId); Q_INVOKABLE User* user(); Q_INVOKABLE QString userId() const; /** @deprecated Use accessToken() instead. */ Q_INVOKABLE QString token() const; Q_INVOKABLE QString accessToken() const; signals: void resolved(); void connected(); void reconnected(); void loggedOut(); void syncDone(); void newRoom(Room* room); void joinedRoom(Room* room); void loginError(QString error); void connectionError(QString error); void resolveError(QString error); //void jobError(BaseJob* job); protected: /** * @brief Access the underlying ConnectionData class */ ConnectionData* connectionData(); /** * @brief Find a (possibly new) Room object for the specified id * Use this method whenever you need to find a Room object in * the local list of rooms. Note that this does not interact with * the server; in particular, does not automatically create rooms * on the server. * @return a pointer to a Room object with the specified id; nullptr * if roomId is empty if createRoom() failed to create a Room object. */ Room* provideRoom(QString roomId); /** * makes it possible for derived classes to have its own User class */ virtual User* createUser(QString userId); /** * makes it possible for derived classes to have its own Room class */ virtual Room* createRoom(QString roomId); private: class Private; Private* d; }; } #endif // QMATRIXCLIENT_CONNECTION_H