/**************************************************************************** ** ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). ** All rights reserved. ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** This file is part of the QtNetwork module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** No Commercial Usage ** This file contains pre-release code and may not be distributed. ** You may use this file in accordance with the terms and conditions ** contained in the Technology Preview License Agreement accompanying ** this package. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** ** ** ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QHTTP_H #define QHTTP_H #include #include #include #include QT_BEGIN_HEADER QT_BEGIN_NAMESPACE QT_MODULE(Network) #ifndef QT_NO_HTTP class QTcpSocket; class QTimerEvent; class QIODevice; class QAuthenticator; class QNetworkProxy; class QSslError; class QHttpPrivate; class QHttpHeaderPrivate; class Q_NETWORK_EXPORT QHttpHeader { public: QHttpHeader(); QHttpHeader(const QHttpHeader &header); QHttpHeader(const QString &str); virtual ~QHttpHeader(); QHttpHeader &operator=(const QHttpHeader &h); void setValue(const QString &key, const QString &value); void setValues(const QList > &values); void addValue(const QString &key, const QString &value); QList > values() const; bool hasKey(const QString &key) const; QStringList keys() const; QString value(const QString &key) const; QStringList allValues(const QString &key) const; void removeValue(const QString &key); void removeAllValues(const QString &key); // ### Qt 5: change to qint64 bool hasContentLength() const; uint contentLength() const; void setContentLength(int len); bool hasContentType() const; QString contentType() const; void setContentType(const QString &type); virtual QString toString() const; bool isValid() const; virtual int majorVersion() const = 0; virtual int minorVersion() const = 0; protected: virtual bool parseLine(const QString &line, int number); bool parse(const QString &str); void setValid(bool); QHttpHeader(QHttpHeaderPrivate &dd, const QString &str = QString()); QHttpHeader(QHttpHeaderPrivate &dd, const QHttpHeader &header); QHttpHeaderPrivate *d_ptr; private: Q_DECLARE_PRIVATE(QHttpHeader) }; class QHttpResponseHeaderPrivate; class Q_NETWORK_EXPORT QHttpResponseHeader : public QHttpHeader { public: QHttpResponseHeader(); QHttpResponseHeader(const QHttpResponseHeader &header); QHttpResponseHeader(const QString &str); QHttpResponseHeader(int code, const QString &text = QString(), int majorVer = 1, int minorVer = 1); QHttpResponseHeader &operator=(const QHttpResponseHeader &header); void setStatusLine(int code, const QString &text = QString(), int majorVer = 1, int minorVer = 1); int statusCode() const; QString reasonPhrase() const; int majorVersion() const; int minorVersion() const; QString toString() const; protected: bool parseLine(const QString &line, int number); private: Q_DECLARE_PRIVATE(QHttpResponseHeader) friend class QHttpPrivate; }; class QHttpRequestHeaderPrivate; class Q_NETWORK_EXPORT QHttpRequestHeader : public QHttpHeader { public: QHttpRequestHeader(); QHttpRequestHeader(const QString &method, const QString &path, int majorVer = 1, int minorVer = 1); QHttpRequestHeader(const QHttpRequestHeader &header); QHttpRequestHeader(const QString &str); QHttpRequestHeader &operator=(const QHttpRequestHeader &header); void setRequest(const QString &method, const QString &path, int majorVer = 1, int minorVer = 1); QString method() const; QString path() const; int majorVersion() const; int minorVersion() const; QString toString() const; protected: bool parseLine(const QString &line, int number); private: Q_DECLARE_PRIVATE(QHttpRequestHeader) }; class Q_NETWORK_EXPORT QHttp : public QObject { Q_OBJECT public: enum ConnectionMode { ConnectionModeHttp, ConnectionModeHttps }; explicit QHttp(QObject *parent = 0); QHttp(const QString &hostname, quint16 port = 80, QObject *parent = 0); QHttp(const QString &hostname, ConnectionMode mode, quint16 port = 0, QObject *parent = 0); virtual ~QHttp(); enum State { Unconnected, HostLookup, Connecting, Sending, Reading, Connected, Closing }; enum Error { NoError, UnknownError, HostNotFound, ConnectionRefused, UnexpectedClose, InvalidResponseHeader, WrongContentLength, Aborted, AuthenticationRequiredError, ProxyAuthenticationRequiredError }; int setHost(const QString &hostname, quint16 port = 80); int setHost(const QString &hostname, ConnectionMode mode, quint16 port = 0); int setSocket(QTcpSocket *socket); int setUser(const QString &username, const QString &password = QString()); #ifndef QT_NO_NETWORKPROXY int setProxy(const QString &host, int port, const QString &username = QString(), const QString &password = QString()); int setProxy(const QNetworkProxy &proxy); #endif int get(const QString &path, QIODevice *to=0); int post(const QString &path, QIODevice *data, QIODevice *to=0 ); int post(const QString &path, const QByteArray &data, QIODevice *to=0); int head(const QString &path); int request(const QHttpRequestHeader &header, QIODevice *device=0, QIODevice *to=0); int request(const QHttpRequestHeader &header, const QByteArray &data, QIODevice *to=0); int closeConnection(); int close(); qint64 bytesAvailable() const; qint64 read(char *data, qint64 maxlen); #ifdef QT3_SUPPORT inline QT3_SUPPORT qint64 readBlock(char *data, quint64 maxlen) { return read(data, qint64(maxlen)); } #endif QByteArray readAll(); int currentId() const; QIODevice *currentSourceDevice() const; QIODevice *currentDestinationDevice() const; QHttpRequestHeader currentRequest() const; QHttpResponseHeader lastResponse() const; bool hasPendingRequests() const; void clearPendingRequests(); State state() const; Error error() const; QString errorString() const; public Q_SLOTS: void abort(); #ifndef QT_NO_OPENSSL void ignoreSslErrors(); #endif Q_SIGNALS: void stateChanged(int); void responseHeaderReceived(const QHttpResponseHeader &resp); void readyRead(const QHttpResponseHeader &resp); // ### Qt 5: change to qint64 void dataSendProgress(int, int); void dataReadProgress(int, int); void requestStarted(int); void requestFinished(int, bool); void done(bool); #ifndef QT_NO_NETWORKPROXY void proxyAuthenticationRequired(const QNetworkProxy &proxy, QAuthenticator *); #endif void authenticationRequired(const QString &hostname, quint16 port, QAuthenticator *); #ifndef QT_NO_OPENSSL void sslErrors(const QList &errors); #endif private: Q_DISABLE_COPY(QHttp) Q_DECLARE_PRIVATE(QHttp) Q_PRIVATE_SLOT(d_func(), void _q_startNextRequest()) Q_PRIVATE_SLOT(d_func(), void _q_slotReadyRead()) Q_PRIVATE_SLOT(d_func(), void _q_slotConnected()) Q_PRIVATE_SLOT(d_func(), void _q_slotError(QAbstractSocket::SocketError)) Q_PRIVATE_SLOT(d_func(), void _q_slotClosed()) Q_PRIVATE_SLOT(d_func(), void _q_slotBytesWritten(qint64 numBytes)) Q_PRIVATE_SLOT(d_func(), void _q_slotDoFinished()) Q_PRIVATE_SLOT(d_func(), void _q_slotSendRequest()) Q_PRIVATE_SLOT(d_func(), void _q_continuePost()) friend class QHttpNormalRequest; friend class QHttpSetHostRequest; friend class QHttpSetSocketRequest; friend class QHttpSetUserRequest; friend class QHttpSetProxyRequest; friend class QHttpCloseRequest; friend class QHttpPGHRequest; }; #endif // QT_NO_HTTP QT_END_NAMESPACE QT_END_HEADER #endif // QHTTP_H