QGIS API Documentation  3.37.0-Master (a5b4d9743e8)
Signals | Public Member Functions | List of all members
QgsNetworkContentFetcher Class Reference

HTTP network content fetcher. More...

#include <qgsnetworkcontentfetcher.h>

Inheritance diagram for QgsNetworkContentFetcher:
Inheritance graph
[legend]

Signals

void downloadProgress (qint64 bytesReceived, qint64 bytesTotal)
 Emitted when data is received. More...
 
void errorOccurred (QNetworkReply::NetworkError code, const QString &errorMsg)
 Emitted when an error with code error occurred while processing the request errorMsg is a textual description of the error. More...
 
void finished ()
 Emitted when content has loaded. More...
 

Public Member Functions

 QgsNetworkContentFetcher ()=default
 Constructor for QgsNetworkContentFetcher. More...
 
 ~QgsNetworkContentFetcher () override
 
void cancel ()
 Cancels any ongoing request. More...
 
QString contentAsString () const
 Returns the fetched content as a string. More...
 
QString contentDispositionFilename () const
 Returns the associated filename from the reply's content disposition header, if present. More...
 
void fetchContent (const QNetworkRequest &request, const QString &authcfg=QString())
 Fetches content using a network request and handles redirects. More...
 
void fetchContent (const QUrl &url, const QString &authcfg=QString())
 Fetches content from a remote URL and handles redirects. More...
 
QNetworkReply * reply ()
 Returns a reference to the network reply. More...
 
bool wasCanceled () const
 Returns true if the fetching was canceled. More...
 

Detailed Description

HTTP network content fetcher.

A simple method for fetching remote HTTP content and converting the content to standard formats. Url redirects are automatically handled.

See also
QgsNetworkContentFetcherTask

Definition at line 38 of file qgsnetworkcontentfetcher.h.

Constructor & Destructor Documentation

◆ QgsNetworkContentFetcher()

QgsNetworkContentFetcher::QgsNetworkContentFetcher ( )
default

Constructor for QgsNetworkContentFetcher.

◆ ~QgsNetworkContentFetcher()

QgsNetworkContentFetcher::~QgsNetworkContentFetcher ( )
override

Definition at line 29 of file qgsnetworkcontentfetcher.cpp.

Member Function Documentation

◆ cancel()

void QgsNetworkContentFetcher::cancel ( )

Cancels any ongoing request.

Since
QGIS 3.2

Definition at line 116 of file qgsnetworkcontentfetcher.cpp.

◆ contentAsString()

QString QgsNetworkContentFetcher::contentAsString ( ) const

Returns the fetched content as a string.

Returns
string containing network content

Definition at line 102 of file qgsnetworkcontentfetcher.cpp.

◆ contentDispositionFilename()

QString QgsNetworkContentFetcher::contentDispositionFilename ( ) const

Returns the associated filename from the reply's content disposition header, if present.

Since
QGIS 3.28

Definition at line 97 of file qgsnetworkcontentfetcher.cpp.

◆ downloadProgress

void QgsNetworkContentFetcher::downloadProgress ( qint64  bytesReceived,
qint64  bytesTotal 
)
signal

Emitted when data is received.

Since
QGIS 3.2

◆ errorOccurred

void QgsNetworkContentFetcher::errorOccurred ( QNetworkReply::NetworkError  code,
const QString &  errorMsg 
)
signal

Emitted when an error with code error occurred while processing the request errorMsg is a textual description of the error.

Since
QGIS 3.22

◆ fetchContent() [1/2]

void QgsNetworkContentFetcher::fetchContent ( const QNetworkRequest &  request,
const QString &  authcfg = QString() 
)

Fetches content using a network request and handles redirects.

The finished() signal will be emitted when content has been fetched.

Optionally, authentication configuration can be set via the authcfg argument.

Since
QGIS 3.2

Definition at line 47 of file qgsnetworkcontentfetcher.cpp.

◆ fetchContent() [2/2]

void QgsNetworkContentFetcher::fetchContent ( const QUrl &  url,
const QString &  authcfg = QString() 
)

Fetches content from a remote URL and handles redirects.

The finished() signal will be emitted when content has been fetched.

Parameters
urlURL to fetch
authcfgoptional authentication configuration

Definition at line 39 of file qgsnetworkcontentfetcher.cpp.

◆ finished

void QgsNetworkContentFetcher::finished ( )
signal

Emitted when content has loaded.

◆ reply()

QNetworkReply * QgsNetworkContentFetcher::reply ( )

Returns a reference to the network reply.

Returns
QNetworkReply for fetched URL content

Definition at line 87 of file qgsnetworkcontentfetcher.cpp.

◆ wasCanceled()

bool QgsNetworkContentFetcher::wasCanceled ( ) const

Returns true if the fetching was canceled.

Since
QGIS 3.10

Definition at line 129 of file qgsnetworkcontentfetcher.cpp.


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