QGIS API Documentation  3.0.2-Girona (307d082)
Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
QgsCredentials Class Referenceabstract

Interface for requesting credentials in QGIS in GUI independent way. More...

#include <qgscredentials.h>

Inheritance diagram for QgsCredentials:
Inheritance graph
[legend]

Public Member Functions

virtual ~QgsCredentials ()=default
 Destructor. More...
 
bool get (const QString &realm, QString &username, QString &password, const QString &message=QString())
 
bool getMasterPassword (QString &password, bool stored=false)
 
void lock ()
 Lock the instance against access from multiple threads. More...
 
QMutex * mutex ()
 Return pointer to mutex. More...
 
void put (const QString &realm, const QString &username, const QString &password)
 
void unlock ()
 Unlock the instance after being locked. More...
 

Static Public Member Functions

static QgsCredentialsinstance ()
 retrieves instance More...
 

Protected Member Functions

 QgsCredentials ()=default
 Constructor for QgsCredentials. More...
 
virtual bool request (const QString &realm, QString &username, QString &password, const QString &message=QString())=0
 request a password More...
 
virtual bool requestMasterPassword (QString &password, bool stored=false)=0
 request a master password More...
 
void setInstance (QgsCredentials *instance)
 register instance More...
 

Detailed Description

Interface for requesting credentials in QGIS in GUI independent way.

This class provides abstraction of a dialog for requesting credentials to the user. By default QgsCredentials will be used if not overridden with other credential creator function.

QGIS application uses QgsCredentialDialog class for displaying a dialog to the user.

Object deletes itself when it's not needed anymore. Children should use signal destroyed() to be notified of the deletion

Definition at line 41 of file qgscredentials.h.

Constructor & Destructor Documentation

◆ ~QgsCredentials()

virtual QgsCredentials::~QgsCredentials ( )
virtualdefault

Destructor.

◆ QgsCredentials()

QgsCredentials::QgsCredentials ( )
protecteddefault

Constructor for QgsCredentials.

Member Function Documentation

◆ get()

bool QgsCredentials::get ( const QString &  realm,
QString &  username,
QString &  password,
const QString &  message = QString() 
)

Definition at line 41 of file qgscredentials.cpp.

◆ getMasterPassword()

bool QgsCredentials::getMasterPassword ( QString &  password,
bool  stored = false 
)

Definition at line 72 of file qgscredentials.cpp.

◆ instance()

QgsCredentials * QgsCredentials::instance ( )
static

retrieves instance

Definition at line 33 of file qgscredentials.cpp.

◆ lock()

void QgsCredentials::lock ( )

Lock the instance against access from multiple threads.

This does not really lock access to get/put methds, it will just prevent other threads to lock the instance and continue the execution. When the class is used from non-GUI threads, they should call lock() before the get/put calls to avoid race conditions.

Since
QGIS 2.4

Definition at line 82 of file qgscredentials.cpp.

◆ mutex()

QMutex* QgsCredentials::mutex ( )
inline

Return pointer to mutex.

Since
QGIS 2.4

Definition at line 76 of file qgscredentials.h.

◆ put()

void QgsCredentials::put ( const QString &  realm,
const QString &  username,
const QString &  password 
)

Definition at line 66 of file qgscredentials.cpp.

◆ request()

virtual bool QgsCredentials::request ( const QString &  realm,
QString &  username,
QString &  password,
const QString &  message = QString() 
)
protectedpure virtual

request a password

Implemented in QgsCredentialsConsole, QgsCredentialsNone, and QgsCredentialDialog.

◆ requestMasterPassword()

virtual bool QgsCredentials::requestMasterPassword ( QString &  password,
bool  stored = false 
)
protectedpure virtual

request a master password

Implemented in QgsCredentialsConsole, QgsCredentialsNone, and QgsCredentialDialog.

◆ setInstance()

void QgsCredentials::setInstance ( QgsCredentials instance)
protected

register instance

Definition at line 23 of file qgscredentials.cpp.

◆ unlock()

void QgsCredentials::unlock ( )

Unlock the instance after being locked.

Since
QGIS 2.4

Definition at line 87 of file qgscredentials.cpp.


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