qgscredentials.h

Go to the documentation of this file.

/***************************************************************************
    qgscredentials.h  -  interface for requesting credentials
    ----------------------
    begin                : February 2010
    copyright            : (C) 2010 by Juergen E. Fischer
    email                : jef at norbit dot de
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
 
#ifndef QGSCREDENTIALS_H
#define QGSCREDENTIALS_H
 
#include "qgis_core.h"
#include "qgis_sip.h"
 
#include <QMap>
#include <QMutex>
#include <QObject>
#include <QPair>
#include <QString>

class CORE_EXPORT QgsCredentials
{
  public:
    virtual ~QgsCredentials() = default;

    bool get( const QString &realm, QString &username SIP_INOUT, QString &password SIP_INOUT, const QString &message = QString(), bool requestCredentials = true );

    void put( const QString &realm, const QString &username, const QString &password );
 
    bool getMasterPassword( QString &password SIP_INOUT, bool stored = false );

    static QgsCredentials *instance();

    void lock();

    void unlock();

    QMutex *mutex() { return &mAuthMutex; }
 
  protected:
    QgsCredentials() = default;

    virtual bool request( const QString &realm, QString &username SIP_INOUT, QString &password SIP_INOUT, const QString &message = QString() ) = 0;

    virtual bool requestMasterPassword( QString &password SIP_INOUT, bool stored = false ) = 0;

    void setInstance( QgsCredentials *instance );
 
  private:
    Q_DISABLE_COPY( QgsCredentials )
 
#ifdef SIP_RUN
    QgsCredentials( const QgsCredentials & );
#endif

    QMap< QString, QPair<QString, QString> > mCredentialCache;

    static QgsCredentials *sInstance;

    QMutex mAuthMutex;

    QMutex mCacheMutex;
};
 

class CORE_EXPORT QgsCredentialsNone : public QObject, public QgsCredentials
{
    Q_OBJECT
 
  public:
    QgsCredentialsNone();
 
  signals:
    void destroyed();
 
  protected:
    bool request( const QString &realm, QString &username SIP_INOUT, QString &password SIP_INOUT, const QString &message = QString() ) override;
    bool requestMasterPassword( QString &password SIP_INOUT, bool stored = false ) override;
};
 

class CORE_EXPORT QgsCredentialsConsole : public QObject, public QgsCredentials
{
    Q_OBJECT
 
  public:
    QgsCredentialsConsole();
 
  signals:
    void destroyed();
 
  protected:
    bool request( const QString &realm, QString &username SIP_INOUT, QString &password SIP_INOUT, const QString &message = QString() ) override;
    bool requestMasterPassword( QString &password SIP_INOUT, bool stored = false ) override;
};
 
#endif