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
