src/common/network.h

   1 /***************************************************************************
   2  *   Copyright (C) 2005-09 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  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  19  ***************************************************************************/
  20
  21 #ifndef NETWORK_H
  22 #define NETWORK_H
  23
  24 #include <QString>
  25 #include <QStringList>
  26 #include <QList>
  27 #include <QNetworkProxy>
  28 #include <QHash>
  29 #include <QVariantMap>
  30 #include <QPointer>
  31 #include <QMutex>
  32 #include <QByteArray>
  33
  34 #include "types.h"
  35 #include "util.h"
  36 #include "syncableobject.h"
  37
  38 #include "signalproxy.h"
  39 #include "ircuser.h"
  40 #include "ircchannel.h"
  41
  42 // defined below!
  43 struct NetworkInfo;
  44
  45 // TODO: ConnectionInfo to propagate and sync the current state of NetworkConnection, encodings etcpp
  46
  47 class Network : public SyncableObject {
  48   SYNCABLE_OBJECT
  49   Q_OBJECT
  50   Q_ENUMS(ConnectionState Network::ConnectionState)
  51
  52   Q_PROPERTY(QString networkName READ networkName WRITE setNetworkName STORED false)
  53   Q_PROPERTY(QString currentServer READ currentServer WRITE setCurrentServer STORED false)
  54   Q_PROPERTY(QString myNick READ myNick WRITE setMyNick STORED false)
  55   Q_PROPERTY(int latency READ latency WRITE setLatency STORED false)
  56   Q_PROPERTY(QByteArray codecForServer READ codecForServer WRITE setCodecForServer STORED false)
  57   Q_PROPERTY(QByteArray codecForEncoding READ codecForEncoding WRITE setCodecForEncoding STORED false)
  58   Q_PROPERTY(QByteArray codecForDecoding READ codecForDecoding WRITE setCodecForDecoding STORED false)
  59   Q_PROPERTY(IdentityId identityId READ identity WRITE setIdentity STORED false)
  60   Q_PROPERTY(bool isConnected READ isConnected WRITE setConnected STORED false)
  61   //Q_PROPERTY(Network::ConnectionState connectionState READ connectionState WRITE setConnectionState STORED false)
  62   Q_PROPERTY(int connectionState READ connectionState WRITE setConnectionState STORED false)
  63   Q_PROPERTY(bool useRandomServer READ useRandomServer WRITE setUseRandomServer STORED false)
  64   Q_PROPERTY(QStringList perform READ perform WRITE setPerform STORED false)
  65   Q_PROPERTY(bool useAutoIdentify READ useAutoIdentify WRITE setUseAutoIdentify STORED false)
  66   Q_PROPERTY(QString autoIdentifyService READ autoIdentifyService WRITE setAutoIdentifyService STORED false)
  67   Q_PROPERTY(QString autoIdentifyPassword READ autoIdentifyPassword WRITE setAutoIdentifyPassword STORED false)
  68   Q_PROPERTY(bool useSasl READ useSasl WRITE setUseSasl STORED false)
  69   Q_PROPERTY(QString saslAccount READ saslAccount WRITE setSaslAccount STORED false)
  70   Q_PROPERTY(QString saslPassword READ saslPassword WRITE setSaslPassword STORED false)
  71   Q_PROPERTY(bool useAutoReconnect READ useAutoReconnect WRITE setUseAutoReconnect STORED false)
  72   Q_PROPERTY(quint32 autoReconnectInterval READ autoReconnectInterval WRITE setAutoReconnectInterval STORED false)
  73   Q_PROPERTY(quint16 autoReconnectRetries READ autoReconnectRetries WRITE setAutoReconnectRetries STORED false)
  74   Q_PROPERTY(bool unlimitedReconnectRetries READ unlimitedReconnectRetries WRITE setUnlimitedReconnectRetries STORED false)
  75   Q_PROPERTY(bool rejoinChannels READ rejoinChannels WRITE setRejoinChannels STORED false)
  76
  77 public:
  78   enum ConnectionState {
  79     Disconnected,
  80     Connecting,
  81     Initializing,
  82     Initialized,
  83     Reconnecting,
  84     Disconnecting
  85   };
  86
  87   // see:
  88   //  http://www.irc.org/tech_docs/005.html
  89   //  http://www.irc.org/tech_docs/draft-brocklesby-irc-isupport-03.txt
  90   enum ChannelModeType {
  91     NOT_A_CHANMODE = 0x00,
  92     A_CHANMODE = 0x01,
  93     B_CHANMODE = 0x02,
  94     C_CHANMODE = 0x04,
  95     D_CHANMODE = 0x08
  96   };
  97
  98   struct Server {
  99     QString host;
 100     uint port;
 101     QString password;
 102     bool useSsl;
 103     int sslVersion;
 104
 105     bool useProxy;
 106     int proxyType;
 107     QString proxyHost;
 108     uint proxyPort;
 109     QString proxyUser;
 110     QString proxyPass;
 111
 112     Server() : port(6667), useSsl(false), sslVersion(0), useProxy(false), proxyType(QNetworkProxy::Socks5Proxy), proxyHost("localhost"), proxyPort(8080) {}
 113     Server(const QString &host, uint port, const QString &password, bool useSsl)
 114       : host(host), port(port), password(password), useSsl(useSsl), sslVersion(0),
 115         useProxy(false), proxyType(QNetworkProxy::Socks5Proxy), proxyHost("localhost"), proxyPort(8080) {}
 116     bool operator==(const Server &other) const;
 117     bool operator!=(const Server &other) const;
 118   };
 119   typedef QList<Server> ServerList;
 120
 121   Network(const NetworkId &networkid, QObject *parent = 0);
 122   ~Network();
 123
 124   inline NetworkId networkId() const { return _networkId; }
 125
 126   inline SignalProxy *proxy() const { return _proxy; }
 127   inline void setProxy(SignalProxy *proxy) { _proxy = proxy; }
 128
 129   inline bool isMyNick(const QString &nick) const { return (myNick().toLower() == nick.toLower()); }
 130   inline bool isMe(IrcUser *ircuser) const { return (ircuser->nick().toLower() == myNick().toLower()); }
 131
 132   bool isChannelName(const QString &channelname) const;
 133
 134   inline bool isConnected() const { return _connected; }
 135   //Network::ConnectionState connectionState() const;
 136   inline int connectionState() const { return _connectionState; }
 137
 138   QString prefixToMode(const QString &prefix);
 139   inline QString prefixToMode(const QCharRef &prefix) { return prefixToMode(QString(prefix)); }
 140   QString modeToPrefix(const QString &mode);
 141   inline QString modeToPrefix(const QCharRef &mode) { return modeToPrefix(QString(mode)); }
 142
 143   ChannelModeType channelModeType(const QString &mode);
 144   inline ChannelModeType channelModeType(const QCharRef &mode) { return channelModeType(QString(mode)); }
 145
 146   inline const QString &networkName() const { return _networkName; }
 147   inline const QString &currentServer() const { return _currentServer; }
 148   inline const QString &myNick() const { return _myNick; }
 149   inline int latency() const { return _latency; }
 150   inline IrcUser *me() const { return ircUser(myNick()); }
 151   inline IdentityId identity() const { return _identity; }
 152   QStringList nicks() const;
 153   inline QStringList channels() const { return _ircChannels.keys(); }
 154   inline const ServerList &serverList() const { return _serverList; }
 155   inline bool useRandomServer() const { return _useRandomServer; }
 156   inline const QStringList &perform() const { return _perform; }
 157   inline bool useAutoIdentify() const { return _useAutoIdentify; }
 158   inline const QString &autoIdentifyService() const { return _autoIdentifyService; }
 159   inline const QString &autoIdentifyPassword() const { return _autoIdentifyPassword; }
 160   inline bool useSasl() const { return _useSasl; }
 161   inline const QString &saslAccount() const { return _saslAccount; }
 162   inline const QString &saslPassword() const { return _saslPassword; }
 163   inline bool useAutoReconnect() const { return _useAutoReconnect; }
 164   inline quint32 autoReconnectInterval() const { return _autoReconnectInterval; }
 165   inline quint16 autoReconnectRetries() const { return _autoReconnectRetries; }
 166   inline bool unlimitedReconnectRetries() const { return _unlimitedReconnectRetries; }
 167   inline bool rejoinChannels() const { return _rejoinChannels; }
 168
 169   NetworkInfo networkInfo() const;
 170   void setNetworkInfo(const NetworkInfo &);
 171
 172   QString prefixes();
 173   QString prefixModes();
 174
 175   bool supports(const QString &param) const { return _supports.contains(param); }
 176   QString support(const QString &param) const;
 177
 178   IrcUser *newIrcUser(const QString &hostmask, const QVariantMap &initData = QVariantMap());
 179   inline IrcUser *newIrcUser(const QByteArray &hostmask) { return newIrcUser(decodeServerString(hostmask)); }
 180   IrcUser *ircUser(QString nickname) const;
 181   inline IrcUser *ircUser(const QByteArray &nickname) const { return ircUser(decodeServerString(nickname)); }
 182   inline QList<IrcUser *> ircUsers() const { return _ircUsers.values(); }
 183   inline quint32 ircUserCount() const { return _ircUsers.count(); }
 184
 185   IrcChannel *newIrcChannel(const QString &channelname, const QVariantMap &initData = QVariantMap());
 186   inline IrcChannel *newIrcChannel(const QByteArray &channelname) { return newIrcChannel(decodeServerString(channelname)); }
 187   IrcChannel *ircChannel(QString channelname) const;
 188   inline IrcChannel *ircChannel(const QByteArray &channelname) const { return ircChannel(decodeServerString(channelname)); }
 189   inline QList<IrcChannel *> ircChannels() const { return _ircChannels.values(); }
 190   inline quint32 ircChannelCount() const { return _ircChannels.count(); }
 191
 192   QByteArray codecForServer() const;
 193   QByteArray codecForEncoding() const;
 194   QByteArray codecForDecoding() const;
 195   void setCodecForServer(QTextCodec *codec);
 196   void setCodecForEncoding(QTextCodec *codec);
 197   void setCodecForDecoding(QTextCodec *codec);
 198
 199   QString decodeString(const QByteArray &text) const;
 200   QByteArray encodeString(const QString &string) const;
 201   QString decodeServerString(const QByteArray &text) const;
 202   QByteArray encodeServerString(const QString &string) const;
 203
 204   static QByteArray defaultCodecForServer();
 205   static QByteArray defaultCodecForEncoding();
 206   static QByteArray defaultCodecForDecoding();
 207   static void setDefaultCodecForServer(const QByteArray &name);
 208   static void setDefaultCodecForEncoding(const QByteArray &name);
 209   static void setDefaultCodecForDecoding(const QByteArray &name);
 210
 211   inline bool autoAwayActive() const { return _autoAwayActive; }
 212   inline void setAutoAwayActive(bool active) { _autoAwayActive = active; }
 213
 214   static QStringList presetNetworks(bool onlyDefault = false);
 215   static QStringList presetDefaultChannels(const QString &networkName);
 216   static NetworkInfo networkInfoFromPreset(const QString &networkName);
 217
 218   // Blowfish stuff
 219   QByteArray bufferKey(const QString &recipient) const;
 220   void setBufferKey(const QString &recipient, const QByteArray &key);
 221
 222 public slots:
 223   void setNetworkName(const QString &networkName);
 224   void setCurrentServer(const QString &currentServer);
 225   void setConnected(bool isConnected);
 226   void setConnectionState(int state);
 227   virtual void setMyNick(const QString &mynick);
 228   void setLatency(int latency);
 229   void setIdentity(IdentityId);
 230
 231   void setServerList(const QVariantList &serverList);
 232   void setUseRandomServer(bool);
 233   void setPerform(const QStringList &);
 234   void setUseAutoIdentify(bool);
 235   void setAutoIdentifyService(const QString &);
 236   void setAutoIdentifyPassword(const QString &);
 237   void setUseSasl(bool);
 238   void setSaslAccount(const QString &);
 239   void setSaslPassword(const QString &);
 240   virtual void setUseAutoReconnect(bool);
 241   virtual void setAutoReconnectInterval(quint32);
 242   virtual void setAutoReconnectRetries(quint16);
 243   void setUnlimitedReconnectRetries(bool);
 244   void setRejoinChannels(bool);
 245
 246   void setCodecForServer(const QByteArray &codecName);
 247   void setCodecForEncoding(const QByteArray &codecName);
 248   void setCodecForDecoding(const QByteArray &codecName);
 249
 250   void addSupport(const QString &param, const QString &value = QString());
 251   void removeSupport(const QString &param);
 252
 253   inline void addIrcUser(const QString &hostmask) { newIrcUser(hostmask); }
 254   inline void addIrcChannel(const QString &channel) { newIrcChannel(channel); }
 255
 256   //init geters
 257   QVariantMap initSupports() const;
 258   inline QVariantList initServerList() const { return toVariantList(serverList()); }
 259   virtual QVariantMap initIrcUsersAndChannels() const;
 260
 261   //init seters
 262   void initSetSupports(const QVariantMap &supports);
 263   inline void initSetServerList(const QVariantList &serverList) { _serverList = fromVariantList<Server>(serverList); }
 264   virtual void initSetIrcUsersAndChannels(const QVariantMap &usersAndChannels);
 265
 266   IrcUser *updateNickFromMask(const QString &mask);
 267
 268   // these slots are to keep the hashlists of all users and the
 269   // channel lists up to date
 270   void ircUserNickChanged(QString newnick);
 271
 272   virtual inline void requestConnect() const { REQUEST(NO_ARG) }
 273   virtual inline void requestDisconnect() const { REQUEST(NO_ARG) }
 274   virtual inline void requestSetNetworkInfo(const NetworkInfo &info) { REQUEST(ARG(info)) }
 275
 276   void emitConnectionError(const QString &);
 277
 278 private slots:
 279   void removeIrcUser(IrcUser *ircuser);
 280   void removeIrcChannel(IrcChannel *ircChannel);
 281   void removeChansAndUsers();
 282
 283 signals:
 284   void aboutToBeDestroyed();
 285   void networkNameSet(const QString &networkName);
 286   void currentServerSet(const QString &currentServer);
 287   void connectedSet(bool isConnected);
 288   void connectionStateSet(Network::ConnectionState);
 289 //   void connectionStateSet(int);
 290   void connectionError(const QString &errorMsg);
 291   void myNickSet(const QString &mynick);
 292 //   void latencySet(int latency);
 293   void identitySet(IdentityId);
 294
 295   void configChanged();
 296
 297   //   void serverListSet(QVariantList serverList);
 298 //   void useRandomServerSet(bool);
 299 //   void performSet(const QStringList &);
 300 //   void useAutoIdentifySet(bool);
 301 //   void autoIdentifyServiceSet(const QString &);
 302 //   void autoIdentifyPasswordSet(const QString &);
 303 //   void useAutoReconnectSet(bool);
 304 //   void autoReconnectIntervalSet(quint32);
 305 //   void autoReconnectRetriesSet(quint16);
 306 //   void unlimitedReconnectRetriesSet(bool);
 307 //   void rejoinChannelsSet(bool);
 308
 309 //   void codecForServerSet(const QByteArray &codecName);
 310 //   void codecForEncodingSet(const QByteArray &codecName);
 311 //   void codecForDecodingSet(const QByteArray &codecName);
 312
 313 //   void supportAdded(const QString &param, const QString &value);
 314 //   void supportRemoved(const QString &param);
 315
 316 //   void ircUserAdded(const QString &hostmask);
 317   void ircUserAdded(IrcUser *);
 318 //   void ircChannelAdded(const QString &channelname);
 319   void ircChannelAdded(IrcChannel *);
 320
 321 //   void connectRequested() const;
 322 //   void disconnectRequested() const;
 323 //   void setNetworkInfoRequested(const NetworkInfo &) const;
 324
 325 protected:
 326   inline virtual IrcChannel *ircChannelFactory(const QString &channelname) { return new IrcChannel(channelname, this); }
 327
 328 private:
 329   QPointer<SignalProxy> _proxy;
 330
 331   NetworkId _networkId;
 332   IdentityId _identity;
 333
 334   QString _myNick;
 335   int _latency;
 336   QString _networkName;
 337   QString _currentServer;
 338   bool _connected;
 339   ConnectionState _connectionState;
 340
 341   QString _prefixes;
 342   QString _prefixModes;
 343
 344   QHash<QString, IrcUser *> _ircUsers;  // stores all known nicks for the server
 345   QHash<QString, IrcChannel *> _ircChannels; // stores all known channels
 346   QHash<QString, QString> _supports;  // stores results from RPL_ISUPPORT
 347
 348   // Blowfish key map
 349   QHash<QString, QByteArray> _keyHash;
 350
 351   ServerList _serverList;
 352   bool _useRandomServer;
 353   QStringList _perform;
 354
 355   bool _useAutoIdentify;
 356   QString _autoIdentifyService;
 357   QString _autoIdentifyPassword;
 358
 359   bool _useSasl;
 360   QString _saslAccount;
 361   QString _saslPassword;
 362
 363   bool _useAutoReconnect;
 364   quint32 _autoReconnectInterval;
 365   quint16 _autoReconnectRetries;
 366   bool _unlimitedReconnectRetries;
 367   bool _rejoinChannels;
 368
 369   void determinePrefixes();
 370
 371   QTextCodec *_codecForServer;
 372   QTextCodec *_codecForEncoding;
 373   QTextCodec *_codecForDecoding;
 374
 375   static QTextCodec *_defaultCodecForServer;
 376   static QTextCodec *_defaultCodecForEncoding;
 377   static QTextCodec *_defaultCodecForDecoding;
 378
 379   bool _autoAwayActive; // when this is active handle305 and handle306 don't trigger any output
 380
 381   static QString _networksIniPath;
 382
 383   friend class IrcUser;
 384   friend class IrcChannel;
 385 };
 386
 387 //! Stores all editable information about a network (as opposed to runtime state).
 388 struct NetworkInfo {
 389   // set some default values, note that this does not initialize e.g. name and id
 390   NetworkInfo();
 391
 392   NetworkId networkId;
 393   QString networkName;
 394   IdentityId identity;
 395
 396   bool useCustomEncodings; // not used!
 397   QByteArray codecForServer;
 398   QByteArray codecForEncoding;
 399   QByteArray codecForDecoding;
 400
 401   Network::ServerList serverList;
 402   bool useRandomServer;
 403
 404   QStringList perform;
 405
 406   bool useAutoIdentify;
 407   QString autoIdentifyService;
 408   QString autoIdentifyPassword;
 409
 410   bool useSasl;
 411   QString saslAccount;
 412   QString saslPassword;
 413
 414   bool useAutoReconnect;
 415   quint32 autoReconnectInterval;
 416   quint16 autoReconnectRetries;
 417   bool unlimitedReconnectRetries;
 418   bool rejoinChannels;
 419
 420   bool operator==(const NetworkInfo &other) const;
 421   bool operator!=(const NetworkInfo &other) const;
 422 };
 423
 424 QDataStream &operator<<(QDataStream &out, const NetworkInfo &info);
 425 QDataStream &operator>>(QDataStream &in, NetworkInfo &info);
 426 QDebug operator<<(QDebug dbg, const NetworkInfo &i);
 427 Q_DECLARE_METATYPE(NetworkInfo)
 428
 429 QDataStream &operator<<(QDataStream &out, const Network::Server &server);
 430 QDataStream &operator>>(QDataStream &in, Network::Server &server);
 431 QDebug operator<<(QDebug dbg, const Network::Server &server);
 432 Q_DECLARE_METATYPE(Network::Server)
 433
 434 #endif