QGIS API Documentation  2.18.21-Las Palmas (9fba24a)
Public Slots | Signals | Public Member Functions | Static Public Member Functions | List of all members
QgsHttpTransaction Class Reference

HTTP request/response manager that is redirect-aware. More...

#include <qgshttptransaction.h>

Inheritance diagram for QgsHttpTransaction:
Inheritance graph
[legend]

Public Slots

void abort ()
 Aborts the current transaction. More...
 
void dataFinished (int id, bool error)
 
void dataHeaderReceived (const QHttpResponseHeader &resp)
 
void dataProgress (int done, int total)
 
void dataReceived (const QHttpResponseHeader &resp)
 
void dataStarted (int id)
 
void dataStateChanged (int state)
 
void networkTimedOut ()
 
void transactionFinished (bool error)
 

Signals

void dataReadProgress (int theProgress)
 Signal for progress update. More...
 
void setProgress (int done, int total)
 Legacy code. More...
 
void statusChanged (const QString &theStatusQString)
 emit a signal to be caught by qgisapp and display a msg on status bar More...
 
void totalSteps (int theTotalSteps)
 Signal for adjusted number of steps. More...
 

Public Member Functions

 QgsHttpTransaction (const QString &uri, const QString &proxyHost=QString(), int proxyPort=80, const QString &proxyUser=QString(), const QString &proxyPass=QString(), QNetworkProxy::ProxyType proxyType=QNetworkProxy::NoProxy, const QString &userName=QString(), const QString &password=QString())
 Constructor. More...
 
virtual ~QgsHttpTransaction ()
 Destructor. More...
 
QString errorString ()
 If an operation returns 0 (e.g. More...
 
void getAsynchronously ()
 
bool getSynchronously (QByteArray &respondedContent, int redirections=0, const QByteArray *postData=nullptr)
 Gets the response synchronously. More...
 
int networkTimeout () const
 Returns the network timeout in msec. More...
 
QString responseContentType ()
 
void setCredentials (const QString &username, const QString &password)
 Set the credentials (username and password) More...
 
void setNetworkTimeout (int msec)
 Sets the network timeout in milliseconds. More...
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
 QObject (QObject *parent, const char *name)
 
virtual ~QObject ()
 
bool blockSignals (bool block)
 
QObjectchild (const char *objName, const char *inheritsClass, bool recursiveSearch) const
 
const QObjectList & children () const
 
const char * className () const
 
bool connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
 
void deleteLater ()
 
void destroyed (QObject *obj)
 
bool disconnect (const QObject *receiver, const char *method)
 
bool disconnect (const char *signal, const QObject *receiver, const char *method)
 
void dumpObjectInfo ()
 
void dumpObjectTree ()
 
QList< QByteArraydynamicPropertyNames () const
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
findChild (const QString &name) const
 
QList< T > findChildren (const QRegExp &regExp) const
 
QList< T > findChildren (const QString &name) const
 
bool inherits (const char *className) const
 
void insertChild (QObject *object)
 
void installEventFilter (QObject *filterObj)
 
bool isA (const char *className) const
 
bool isWidgetType () const
 
void killTimer (int id)
 
virtual const QMetaObjectmetaObject () const
 
void moveToThread (QThread *targetThread)
 
const char * name () const
 
const char * name (const char *defaultName) const
 
QString objectName () const
 
QObjectparent () const
 
QVariant property (const char *name) const
 
void removeChild (QObject *object)
 
void removeEventFilter (QObject *obj)
 
void setName (const char *name)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const char *name, const QVariant &value)
 
bool signalsBlocked () const
 
int startTimer (int interval)
 
QThreadthread () const
 

Static Public Member Functions

static bool applyProxySettings (QHttp &http, const QString &url)
 Apply proxy settings from QSettings to a http object. More...
 
- Static Public Member Functions inherited from QObject
bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 

Additional Inherited Members

- Protected Member Functions inherited from QObject
bool checkConnectArgs (const char *signal, const QObject *object, const char *method)
 
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const char *signal)
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const char *signal)
 
int receivers (const char *signal) const
 
QObjectsender () const
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *event)
 
- Static Protected Member Functions inherited from QObject
QByteArray normalizeSignalSlot (const char *signalSlot)
 
- Properties inherited from QObject
 objectName
 

Detailed Description

HTTP request/response manager that is redirect-aware.

This class extends the Qt QHttp concept by being able to recognise and respond to redirection responses (e.g. HTTP code 302)

Definition at line 36 of file qgshttptransaction.h.

Constructor & Destructor Documentation

◆ QgsHttpTransaction()

QgsHttpTransaction::QgsHttpTransaction ( const QString uri,
const QString proxyHost = QString(),
int  proxyPort = 80,
const QString proxyUser = QString(),
const QString proxyPass = QString(),
QNetworkProxy::ProxyType  proxyType = QNetworkProxy::NoProxy,
const QString userName = QString(),
const QString password = QString() 
)

Constructor.

Definition at line 38 of file qgshttptransaction.cpp.

◆ ~QgsHttpTransaction()

QgsHttpTransaction::~QgsHttpTransaction ( )
virtual

Destructor.

Definition at line 75 of file qgshttptransaction.cpp.

Member Function Documentation

◆ abort

void QgsHttpTransaction::abort ( )
slot

Aborts the current transaction.

Definition at line 563 of file qgshttptransaction.cpp.

◆ applyProxySettings()

bool QgsHttpTransaction::applyProxySettings ( QHttp http,
const QString url 
)
static

Apply proxy settings from QSettings to a http object.

Returns
true if proxy settings was applied, false else

Definition at line 506 of file qgshttptransaction.cpp.

◆ dataFinished

void QgsHttpTransaction::dataFinished ( int  id,
bool  error 
)
slot

Definition at line 343 of file qgshttptransaction.cpp.

◆ dataHeaderReceived

void QgsHttpTransaction::dataHeaderReceived ( const QHttpResponseHeader resp)
slot

Definition at line 268 of file qgshttptransaction.cpp.

◆ dataProgress

void QgsHttpTransaction::dataProgress ( int  done,
int  total 
)
slot

Definition at line 318 of file qgshttptransaction.cpp.

◆ dataReadProgress

void QgsHttpTransaction::dataReadProgress ( int  theProgress)
signal

Signal for progress update.

◆ dataReceived

void QgsHttpTransaction::dataReceived ( const QHttpResponseHeader resp)
slot

Definition at line 299 of file qgshttptransaction.cpp.

◆ dataStarted

void QgsHttpTransaction::dataStarted ( int  id)
slot

Definition at line 261 of file qgshttptransaction.cpp.

◆ dataStateChanged

void QgsHttpTransaction::dataStateChanged ( int  state)
slot

Definition at line 436 of file qgshttptransaction.cpp.

◆ errorString()

QString QgsHttpTransaction::errorString ( )

If an operation returns 0 (e.g.

getSynchronously()), this function returns the text of the error associated with the failure. Interactive users of this provider can then, for example, call a QMessageBox to display the contents.

Definition at line 501 of file qgshttptransaction.cpp.

◆ getAsynchronously()

void QgsHttpTransaction::getAsynchronously ( )

Definition at line 86 of file qgshttptransaction.cpp.

◆ getSynchronously()

bool QgsHttpTransaction::getSynchronously ( QByteArray respondedContent,
int  redirections = 0,
const QByteArray postData = nullptr 
)

Gets the response synchronously.

Note that signals will still be emitted while in this function.

The function returns false if there is an error while getting the response.

Parameters
[out]respondedContentis replaced with the new content.
[in]redirectionsis used to measure how many http redirections we've been through. Clients typically don't need to set this.
postDatadata to send with the http message. This is only used for HTTP POST. If 0 then the request is done with HTTP GET.
Returns
true in case of success

Definition at line 93 of file qgshttptransaction.cpp.

◆ networkTimedOut

void QgsHttpTransaction::networkTimedOut ( )
slot

Definition at line 489 of file qgshttptransaction.cpp.

◆ networkTimeout()

int QgsHttpTransaction::networkTimeout ( ) const
inline

Returns the network timeout in msec.

Definition at line 94 of file qgshttptransaction.h.

◆ responseContentType()

QString QgsHttpTransaction::responseContentType ( )

Definition at line 255 of file qgshttptransaction.cpp.

◆ setCredentials()

void QgsHttpTransaction::setCredentials ( const QString username,
const QString password 
)

Set the credentials (username and password)

Definition at line 81 of file qgshttptransaction.cpp.

◆ setNetworkTimeout()

void QgsHttpTransaction::setNetworkTimeout ( int  msec)
inline

Sets the network timeout in milliseconds.

Definition at line 96 of file qgshttptransaction.h.

◆ setProgress

void QgsHttpTransaction::setProgress ( int  done,
int  total 
)
signal

Legacy code.

This signal is currently not emitted and only kept for API compatibility

◆ statusChanged

void QgsHttpTransaction::statusChanged ( const QString theStatusQString)
signal

emit a signal to be caught by qgisapp and display a msg on status bar

◆ totalSteps

void QgsHttpTransaction::totalSteps ( int  theTotalSteps)
signal

Signal for adjusted number of steps.

◆ transactionFinished

void QgsHttpTransaction::transactionFinished ( bool  error)
slot

Definition at line 392 of file qgshttptransaction.cpp.


The documentation for this class was generated from the following files: