qhttp.h Include File

Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions |

# qhttp.h

This is the verbatim text of the qhttp.h include file. It is provided only for illustration; the copyright remains with Trolltech.

    /****************************************************************************
    ** $Id: qt/qhttp.h   3.3.8   edited Jan 11 14:46 $
    **
    ** Definition of QHttp and related classes.
    **
    ** Created : 970521
    **
    ** Copyright (C) 1997-2007 Trolltech ASA.  All rights reserved.
    **
    ** This file is part of the network module of the Qt GUI Toolkit.
    **
    ** This file may be used under the terms of the GNU General Public
    ** License versions 2.0 or 3.0 as published by the Free Software
    ** Foundation and appearing in the file LICENSE.GPL included in the
    ** packaging of this file. Alternatively you may (at your option) use any
    ** later version of the GNU General Public License if such license has
    ** been publicly approved by Trolltech ASA (or its successors, if any)
    ** and the KDE Free Qt Foundation.
    **
    ** Please review the following information to ensure GNU General
    ** Public Licensing requirements will be met:
    ** http://trolltech.com/products/qt/licenses/licensing/opensource/.
    ** If you are unsure which license is appropriate for your use, please
    ** review the following information:
    ** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
    ** or contact the sales department at sales@trolltech.com.
    **
    ** This file may be used under the terms of the Q Public License as
    ** defined by Trolltech ASA and appearing in the file LICENSE.QPL
    ** included in the packaging of this file.  Licensees holding valid Qt
    ** Commercial licenses may use this file in accordance with the Qt
    ** Commercial License Agreement provided with the Software.
    **
    ** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
    ** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
    ** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
    ** herein.
    **
    **********************************************************************/

    #ifndef QHTTP_H
    #define QHTTP_H

    #ifndef QT_H
    #include "qobject.h"
    #include "qnetworkprotocol.h"
    #include "qstringlist.h"
    #endif // QT_H

    #if !defined( QT_MODULE_NETWORK ) || defined( QT_LICENSE_PROFESSIONAL ) || defined( QT_INTERNAL_NETWORK )
    #define QM_EXPORT_HTTP
    #define QM_TEMPLATE_EXTERN_HTTP
    #else
    #define QM_EXPORT_HTTP Q_EXPORT
    #define QM_TEMPLATE_EXTERN_HTTP Q_TEMPLATE_EXTERN
    #endif

    #ifndef QT_NO_NETWORKPROTOCOL_HTTP

    class QSocket;
    class QTimerEvent;
    class QTextStream;
    class QIODevice;

    class QHttpPrivate;
    class QHttpRequest;

    class QM_EXPORT_HTTP QHttpHeader
    {
    public:
        QHttpHeader();
        QHttpHeader( const QHttpHeader& header );
        QHttpHeader( const QString& str );
        virtual ~QHttpHeader();

        QHttpHeader& operator=( const QHttpHeader& h );

        QString value( const QString& key ) const;
        void setValue( const QString& key, const QString& value );
        void removeValue( const QString& key );

        QStringList keys() const;
        bool hasKey( const QString& key ) const;

        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 );

    private:
        QMap<QString,QString> values;
        bool valid;
    };

    class QM_EXPORT_HTTP QHttpResponseHeader : public QHttpHeader
    {
    private:
        QHttpResponseHeader( int code, const QString& text = QString::null, int majorVer = 1, int minorVer = 1 );
        QHttpResponseHeader( const QString& str );

        void setStatusLine( int code, const QString& text = QString::null, int majorVer = 1, int minorVer = 1 );

    public:
        QHttpResponseHeader();
        QHttpResponseHeader( const QHttpResponseHeader& header );

        int statusCode() const;
        QString reasonPhrase() const;

        int majorVersion() const;
        int minorVersion() const;

        QString toString() const;

    protected:
        bool parseLine( const QString& line, int number );

    private:
        int statCode;
        QString reasonPhr;
        int majVer;
        int minVer;

        friend class QHttp;
    };

    class QM_EXPORT_HTTP 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 );

        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:
        QString m;
        QString p;
        int majVer;
        int minVer;
    };

    class QM_EXPORT_HTTP QHttp : public QNetworkProtocol
    {
        Q_OBJECT

    public:
        QHttp();
        QHttp( QObject* parent, const char* name = 0 ); // ### Qt 4.0: make parent=0 and get rid of the QHttp() constructor
        QHttp( const QString &hostname, Q_UINT16 port=80, QObject* parent=0, const char* name = 0 );
        virtual ~QHttp();

        int supportedOperations() const;

        enum State { Unconnected, HostLookup, Connecting, Sending, Reading, Connected, Closing };
        enum Error {
    	NoError,
    	UnknownError,
    	HostNotFound,
    	ConnectionRefused,
    	UnexpectedClose,
    	InvalidResponseHeader,
    	WrongContentLength,
    	Aborted
        };

        int setHost(const QString &hostname, Q_UINT16 port=80 );

        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();

        Q_ULONG bytesAvailable() const;
        Q_LONG readBlock( char *data, Q_ULONG maxlen );
        QByteArray readAll();

        int currentId() const;
        QIODevice* currentSourceDevice() const;
        QIODevice* currentDestinationDevice() const;
        QHttpRequestHeader currentRequest() const;
        bool hasPendingRequests() const;
        void clearPendingRequests();

        State state() const;

        Error error() const;
        QString errorString() const;

    public slots:
        void abort();

    signals:
        void stateChanged( int );
        void responseHeaderReceived( const QHttpResponseHeader& resp );
        void readyRead( const QHttpResponseHeader& resp );
        void dataSendProgress( int, int );
        void dataReadProgress( int, int );

        void requestStarted( int );
        void requestFinished( int, bool );
        void done( bool );

    protected:
        void operationGet( QNetworkOperation *op );
        void operationPut( QNetworkOperation *op );

        void timerEvent( QTimerEvent * );

    private slots:
        void clientReply( const QHttpResponseHeader &rep );
        void clientDone( bool );
        void clientStateChanged( int );

        void startNextRequest();
        void slotReadyRead();
        void slotConnected();
        void slotError( int );
        void slotClosed();
        void slotBytesWritten( int );

    private:
        QHttpPrivate *d;
        void *unused; // ### Qt 4.0: remove this (in for binary compatibility)
        int bytesRead;

        int addRequest( QHttpRequest * );
        void sendRequest();
        void finishedWithSuccess();
        void finishedWithError( const QString& detail, int errorCode );

        void killIdleTimer();

        void init();
        void setState( int );
        void close();

        friend class QHttpNormalRequest;
        friend class QHttpSetHostRequest;
        friend class QHttpCloseRequest;
        friend class QHttpPGHRequest;
    };

    #define Q_DEFINED_QHTTP
    #include "qwinexport.h"
    #endif
    #endif