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( QString realm, QString &username, QString &password, QString message = QString::null );
    void put( QString realm, QString username, QString password );

    static QgsCredentials *instance();

    void lock();

    void unlock();

    QMutex *mutex() { return &mMutex; }

  protected:
    QgsCredentials();

    virtual bool request( QString realm, QString &username, QString &password, QString message = QString::null ) = 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( QString realm, QString &username, QString &password, QString message = QString::null );
};

#endif