qgscredentials.h

Go to the documentation of this file.

/***************************************************************************
    qgscredentials.h  -  interface for requesting credentials
    ----------------------
    begin                : Feburary 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 <QString>
#include <QObject>
#include <QPair>
#include <QMap>
#include <QMutex>

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

    bool get( const QString& realm, QString &username, QString &password, const QString& message = QString::null );
    void put( const QString& realm, const QString& username, const QString& password );

    bool getMasterPassword( QString &password, bool stored = false );

    static QgsCredentials *instance();

    void lock();

    void unlock();

    QMutex *mutex() { return &mMutex; }

  protected:
    QgsCredentials();

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

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

    void setInstance( QgsCredentials *theInstance );

  private:
    Q_DISABLE_COPY( QgsCredentials )

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

    static QgsCredentials *smInstance;

    QMutex mMutex;
};


class CORE_EXPORT QgsCredentialsConsole : public QObject, public QgsCredentials
{
    Q_OBJECT

  public:
    QgsCredentialsConsole();

  signals:
    void destroyed();

  protected:
    virtual bool request( const QString& realm, QString &username, QString &password, const QString& message = QString::null ) override;
    virtual bool requestMasterPassword( QString &password, bool stored = false ) override;
};

#endif