src/common/transfer.h

   1 /***************************************************************************
   2  *   Copyright (C) 2005-2015 by the Quassel Project                        *
   3  *   devel@quassel-irc.org                                                 *
   4  *                                                                         *
   5  *   This program is free software; you can redistribute it and/or modify  *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation; either version 2 of the License, or     *
   8  *   (at your option) version 3.                                           *
   9  *                                                                         *
  10  *   This program is distributed in the hope that it will be useful,       *
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  13  *   GNU General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with this program; if not, write to the                         *
  17  *   Free Software Foundation, Inc.,                                       *
  18  *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.         *
  19  ***************************************************************************/
  20
  21 #ifndef TRANSFER_H
  22 #define TRANSFER_H
  23
  24 #include <QHostAddress>
  25 #include <QUuid>
  26
  27 #include "peer.h"
  28 #include "syncableobject.h"
  29
  30 class Transfer : public SyncableObject
  31 {
  32     Q_OBJECT
  33     SYNCABLE_OBJECT
  34
  35     Q_PROPERTY(QUuid uuid READ uuid);
  36     Q_PROPERTY(Transfer::Status status READ status WRITE setStatus NOTIFY statusChanged);
  37     Q_PROPERTY(Transfer::Direction direction READ direction WRITE setDirection NOTIFY directionChanged);
  38     Q_PROPERTY(QHostAddress address READ address WRITE setAddress NOTIFY addressChanged);
  39     Q_PROPERTY(quint16 port READ port WRITE setPort NOTIFY portChanged);
  40     Q_PROPERTY(QString fileName READ fileName WRITE setFileName NOTIFY fileNameChanged);
  41     Q_PROPERTY(quint64 fileSize READ fileSize WRITE setFileSize NOTIFY fileSizeChanged);
  42     Q_PROPERTY(QString nick READ nick WRITE setNick NOTIFY nickChanged);
  43
  44 public:
  45     enum class Status {
  46         New,
  47         Pending,
  48         Connecting,
  49         Transferring,
  50         Paused,
  51         Completed,
  52         Failed,
  53         Rejected
  54     };
  55     Q_ENUMS(State)
  56
  57     enum class Direction {
  58         Send,
  59         Receive
  60     };
  61     Q_ENUMS(Direction)
  62
  63     Transfer(const QUuid &uuid, QObject *parent = 0); // for creating a syncable object client-side
  64     Transfer(Direction direction, const QString &nick, const QString &fileName, const QHostAddress &address, quint16 port, quint64 size = 0, QObject *parent = 0);
  65     inline virtual const QMetaObject *syncMetaObject() const { return &staticMetaObject; }
  66
  67     QUuid uuid() const;
  68     Status status() const;
  69     QString prettyStatus() const;
  70     Direction direction() const;
  71     QString fileName() const;
  72     QHostAddress address() const;
  73     quint16 port() const;
  74     quint64 fileSize() const;
  75     QString nick() const;
  76
  77 public slots:
  78     // called on the client side
  79     virtual void accept(const QString &savePath) const { Q_UNUSED(savePath); }
  80     virtual void reject() const {}
  81
  82     // called on the core side through sync calls
  83     virtual void requestAccepted(PeerPtr peer) { Q_UNUSED(peer); }
  84     virtual void requestRejected(PeerPtr peer) { Q_UNUSED(peer); }
  85
  86 signals:
  87     void statusChanged (Transfer::Status state);
  88     void directionChanged(Transfer::Direction direction);
  89     void addressChanged(const QHostAddress &address);
  90     void portChanged(quint16 port);
  91     void fileNameChanged(const QString &fileName);
  92     void fileSizeChanged(quint64 fileSize);
  93     void nickChanged(const QString &nick);
  94
  95     void error(const QString &errorString);
  96
  97     void accepted(PeerPtr peer = 0) const;
  98     void rejected(PeerPtr peer = 0) const;
  99
 100 protected slots:
 101     void setStatus(Transfer::Status status);
 102     void setError(const QString &errorString);
 103
 104     // called on the client side through sync calls
 105     virtual void dataReceived(PeerPtr, const QByteArray &data) { Q_UNUSED(data); }
 106
 107     virtual void cleanUp() = 0;
 108
 109 private:
 110     void init();
 111
 112     void setDirection(Direction direction);
 113     void setAddress(const QHostAddress &address);
 114     void setPort(quint16 port);
 115     void setFileName(const QString &fileName);
 116     void setFileSize(quint64 fileSize);
 117     void setNick(const QString &nick);
 118
 119
 120     Status _status;
 121     Direction _direction;
 122     QString _fileName;
 123     QHostAddress _address;
 124     quint16 _port;
 125     quint64 _fileSize;
 126     QString _nick;
 127     QUuid _uuid;
 128 };
 129
 130 Q_DECLARE_METATYPE(Transfer::Status)
 131 Q_DECLARE_METATYPE(Transfer::Direction)
 132
 133 QDataStream &operator<<(QDataStream &out, Transfer::Status state);
 134 QDataStream &operator>>(QDataStream &in, Transfer::Status &state);
 135 QDataStream &operator<<(QDataStream &out, Transfer::Direction direction);
 136 QDataStream &operator>>(QDataStream &in, Transfer::Direction &direction);
 137
 138 #endif