qhttp.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:9k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtNetwork module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QHTTP_H
  38. #define QHTTP_H
  39. #include <QtCore/qobject.h>
  40. #include <QtCore/qstringlist.h>
  41. #include <QtCore/qmap.h>
  42. #include <QtCore/qpair.h>
  43. QT_BEGIN_HEADER
  44. QT_BEGIN_NAMESPACE
  45. QT_MODULE(Network)
  46. #ifndef QT_NO_HTTP
  47. class QTcpSocket;
  48. class QTimerEvent;
  49. class QIODevice;
  50. class QAuthenticator;
  51. class QNetworkProxy;
  52. class QSslError;
  53. class QHttpPrivate;
  54. class QHttpHeaderPrivate;
  55. class Q_NETWORK_EXPORT QHttpHeader
  56. {
  57. public:
  58.     QHttpHeader();
  59.     QHttpHeader(const QHttpHeader &header);
  60.     QHttpHeader(const QString &str);
  61.     virtual ~QHttpHeader();
  62.     QHttpHeader &operator=(const QHttpHeader &h);
  63.     void setValue(const QString &key, const QString &value);
  64.     void setValues(const QList<QPair<QString, QString> > &values);
  65.     void addValue(const QString &key, const QString &value);
  66.     QList<QPair<QString, QString> > values() const;
  67.     bool hasKey(const QString &key) const;
  68.     QStringList keys() const;
  69.     QString value(const QString &key) const;
  70.     QStringList allValues(const QString &key) const;
  71.     void removeValue(const QString &key);
  72.     void removeAllValues(const QString &key);
  73.     // ### Qt 5: change to qint64
  74.     bool hasContentLength() const;
  75.     uint contentLength() const;
  76.     void setContentLength(int len);
  77.     bool hasContentType() const;
  78.     QString contentType() const;
  79.     void setContentType(const QString &type);
  80.     virtual QString toString() const;
  81.     bool isValid() const;
  82.     virtual int majorVersion() const = 0;
  83.     virtual int minorVersion() const = 0;
  84. protected:
  85.     virtual bool parseLine(const QString &line, int number);
  86.     bool parse(const QString &str);
  87.     void setValid(bool);
  88.     QHttpHeader(QHttpHeaderPrivate &dd, const QString &str = QString());
  89.     QHttpHeader(QHttpHeaderPrivate &dd, const QHttpHeader &header);
  90.     QHttpHeaderPrivate *d_ptr;
  91. private:
  92.     Q_DECLARE_PRIVATE(QHttpHeader)
  93. };
  94. class QHttpResponseHeaderPrivate;
  95. class Q_NETWORK_EXPORT QHttpResponseHeader : public QHttpHeader
  96. {
  97. public:
  98.     QHttpResponseHeader();
  99.     QHttpResponseHeader(const QHttpResponseHeader &header);
  100.     QHttpResponseHeader(const QString &str);
  101.     QHttpResponseHeader(int code, const QString &text = QString(), int majorVer = 1, int minorVer = 1);
  102.     QHttpResponseHeader &operator=(const QHttpResponseHeader &header);
  103.     void setStatusLine(int code, const QString &text = QString(), int majorVer = 1, int minorVer = 1);
  104.     int statusCode() const;
  105.     QString reasonPhrase() const;
  106.     int majorVersion() const;
  107.     int minorVersion() const;
  108.     QString toString() const;
  109. protected:
  110.     bool parseLine(const QString &line, int number);
  111. private:
  112.     Q_DECLARE_PRIVATE(QHttpResponseHeader)
  113.     friend class QHttpPrivate;
  114. };
  115. class QHttpRequestHeaderPrivate;
  116. class Q_NETWORK_EXPORT QHttpRequestHeader : public QHttpHeader
  117. {
  118. public:
  119.     QHttpRequestHeader();
  120.     QHttpRequestHeader(const QString &method, const QString &path, int majorVer = 1, int minorVer = 1);
  121.     QHttpRequestHeader(const QHttpRequestHeader &header);
  122.     QHttpRequestHeader(const QString &str);
  123.     QHttpRequestHeader &operator=(const QHttpRequestHeader &header);
  124.     void setRequest(const QString &method, const QString &path, int majorVer = 1, int minorVer = 1);
  125.     QString method() const;
  126.     QString path() const;
  127.     int majorVersion() const;
  128.     int minorVersion() const;
  129.     QString toString() const;
  130. protected:
  131.     bool parseLine(const QString &line, int number);
  132. private:
  133.     Q_DECLARE_PRIVATE(QHttpRequestHeader)
  134. };
  135. class Q_NETWORK_EXPORT QHttp : public QObject
  136. {
  137.     Q_OBJECT
  138. public:
  139.     enum ConnectionMode {
  140.         ConnectionModeHttp,
  141.         ConnectionModeHttps
  142.     };
  143.     
  144.     explicit QHttp(QObject *parent = 0);
  145.     QHttp(const QString &hostname, quint16 port = 80, QObject *parent = 0);
  146.     QHttp(const QString &hostname, ConnectionMode mode, quint16 port = 0, QObject *parent = 0);
  147.     virtual ~QHttp();
  148.     enum State {
  149.         Unconnected,
  150.         HostLookup,
  151.         Connecting,
  152.         Sending,
  153.         Reading,
  154.         Connected,
  155.         Closing
  156.     };
  157.     enum Error {
  158.         NoError,
  159.         UnknownError,
  160.         HostNotFound,
  161.         ConnectionRefused,
  162.         UnexpectedClose,
  163.         InvalidResponseHeader,
  164.         WrongContentLength,
  165.         Aborted, 
  166.         AuthenticationRequiredError,
  167.         ProxyAuthenticationRequiredError
  168.     };
  169.     int setHost(const QString &hostname, quint16 port = 80);
  170.     int setHost(const QString &hostname, ConnectionMode mode, quint16 port = 0);
  171.     
  172.     int setSocket(QTcpSocket *socket);
  173.     int setUser(const QString &username, const QString &password = QString());
  174. #ifndef QT_NO_NETWORKPROXY
  175.     int setProxy(const QString &host, int port,
  176.                  const QString &username = QString(),
  177.                  const QString &password = QString());
  178.     int setProxy(const QNetworkProxy &proxy);
  179. #endif
  180.     int get(const QString &path, QIODevice *to=0);
  181.     int post(const QString &path, QIODevice *data, QIODevice *to=0 );
  182.     int post(const QString &path, const QByteArray &data, QIODevice *to=0);
  183.     int head(const QString &path);
  184.     int request(const QHttpRequestHeader &header, QIODevice *device=0, QIODevice *to=0);
  185.     int request(const QHttpRequestHeader &header, const QByteArray &data, QIODevice *to=0);
  186.     int closeConnection();
  187.     int close();
  188.     qint64 bytesAvailable() const;
  189.     qint64 read(char *data, qint64 maxlen);
  190. #ifdef QT3_SUPPORT
  191.     inline QT3_SUPPORT qint64 readBlock(char *data, quint64 maxlen)
  192.     { return read(data, qint64(maxlen)); }
  193. #endif
  194.     QByteArray readAll();
  195.     int currentId() const;
  196.     QIODevice *currentSourceDevice() const;
  197.     QIODevice *currentDestinationDevice() const;
  198.     QHttpRequestHeader currentRequest() const;
  199.     QHttpResponseHeader lastResponse() const;
  200.     bool hasPendingRequests() const;
  201.     void clearPendingRequests();
  202.     State state() const;
  203.     Error error() const;
  204.     QString errorString() const;
  205. public Q_SLOTS:
  206.     void abort();
  207. #ifndef QT_NO_OPENSSL
  208.     void ignoreSslErrors();
  209. #endif
  210. Q_SIGNALS:
  211.     void stateChanged(int);
  212.     void responseHeaderReceived(const QHttpResponseHeader &resp);
  213.     void readyRead(const QHttpResponseHeader &resp);
  214.     // ### Qt 5: change to qint64
  215.     void dataSendProgress(int, int);
  216.     void dataReadProgress(int, int);
  217.     void requestStarted(int);
  218.     void requestFinished(int, bool);
  219.     void done(bool);
  220. #ifndef QT_NO_NETWORKPROXY
  221.     void proxyAuthenticationRequired(const QNetworkProxy &proxy, QAuthenticator *);
  222. #endif
  223.     void authenticationRequired(const QString &hostname, quint16 port, QAuthenticator *);
  224. #ifndef QT_NO_OPENSSL
  225.     void sslErrors(const QList<QSslError> &errors);
  226. #endif
  227. private:
  228.     Q_DISABLE_COPY(QHttp)
  229.     Q_DECLARE_PRIVATE(QHttp)
  230.     Q_PRIVATE_SLOT(d_func(), void _q_startNextRequest())
  231.     Q_PRIVATE_SLOT(d_func(), void _q_slotReadyRead())
  232.     Q_PRIVATE_SLOT(d_func(), void _q_slotConnected())
  233.     Q_PRIVATE_SLOT(d_func(), void _q_slotError(QAbstractSocket::SocketError))
  234.     Q_PRIVATE_SLOT(d_func(), void _q_slotClosed())
  235.     Q_PRIVATE_SLOT(d_func(), void _q_slotBytesWritten(qint64 numBytes))
  236.     Q_PRIVATE_SLOT(d_func(), void _q_slotDoFinished())
  237.     Q_PRIVATE_SLOT(d_func(), void _q_slotSendRequest())
  238.     friend class QHttpNormalRequest;
  239.     friend class QHttpSetHostRequest;
  240.     friend class QHttpSetSocketRequest;
  241.     friend class QHttpSetUserRequest;
  242.     friend class QHttpSetProxyRequest;
  243.     friend class QHttpCloseRequest;
  244.     friend class QHttpPGHRequest;
  245. };
  246. #endif // QT_NO_HTTP
  247. QT_END_NAMESPACE
  248. QT_END_HEADER
  249. #endif // QHTTP_H