qgsauthmethod.h

Go to the documentation of this file.

/***************************************************************************
    qgsauthmethod.h
    ---------------------
    begin                : September 1, 2015
    copyright            : (C) 2015 by Boundless Spatial, Inc. USA
    author               : Larry Shaffer
    email                : lshaffer at boundlessgeo dot com
 ***************************************************************************
 *                                                                         *
 *   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 QGSAUTHMETHOD_H
#define QGSAUTHMETHOD_H
 
#include "qgsconfig.h"
 
#include "qgis_core.h"
#include "qgis_sip.h"
 
#include <QFlags>
#include <QNetworkReply>
#include <QNetworkRequest>
#include <QObject>
#include <QRecursiveMutex>
#include <QStringList>
#include <QUrl>
 
class QgsAuthMethodConfig;

class CORE_EXPORT QgsAuthMethod : public QObject
{
    Q_OBJECT
 
  public:

    enum Expansion SIP_ENUM_BASETYPE( IntFlag )
    {
      // TODO: Figure out all different authentication expansions current layer providers use
      NetworkRequest       = 0x1,
      NetworkReply         = 0x2,
      DataSourceUri        = 0x4,
      GenericDataSourceUri = 0x8,
      NetworkProxy                = 0x16,
      All = NetworkRequest | NetworkReply | DataSourceUri | GenericDataSourceUri | NetworkProxy
    };
    Q_DECLARE_FLAGS( Expansions, Expansion )
 
    
    virtual QString key() const = 0;

    virtual QString description() const = 0;

    virtual QString displayDescription() const = 0;

    int version() const { return mVersion; }
 
 
#ifdef HAVE_GUI
    SIP_IF_FEATURE( HAVE_GUI )
 
    
    virtual QWidget *editWidget( QWidget *parent ) const;
    SIP_END
#endif

    QgsAuthMethod::Expansions supportedExpansions() const { return mExpansions; }

    QStringList supportedDataProviders() const { return mDataProviders; }

    virtual bool updateNetworkRequest( QNetworkRequest &request, const QString &authcfg,
                                       const QString &dataprovider = QString() )
    {
      Q_UNUSED( request )
      Q_UNUSED( authcfg )
      Q_UNUSED( dataprovider )
      return true; // noop
    }

    virtual bool updateNetworkReply( QNetworkReply *reply, const QString &authcfg,
                                     const QString &dataprovider = QString() )
    {
      Q_UNUSED( reply )
      Q_UNUSED( authcfg )
      Q_UNUSED( dataprovider )
      return true; // noop
    }

    virtual bool updateDataSourceUriItems( QStringList &connectionItems, const QString &authcfg,
                                           const QString &dataprovider = QString() )
    {
      Q_UNUSED( connectionItems )
      Q_UNUSED( authcfg )
      Q_UNUSED( dataprovider )
      return true; // noop
    }

    virtual bool updateNetworkProxy( QNetworkProxy &proxy, const QString &authcfg,
                                     const QString &dataprovider = QString() )
    {
      Q_UNUSED( proxy )
      Q_UNUSED( authcfg )
      Q_UNUSED( dataprovider )
      return true; // noop
    }

    virtual void clearCachedConfig( const QString &authcfg ) = 0;

    virtual void updateMethodConfig( QgsAuthMethodConfig &mconfig ) = 0;
 
  protected:

    explicit QgsAuthMethod();

    static QString authMethodTag() { return QObject::tr( "Authentication method" ); }

    void setVersion( int version ) { mVersion = version; }

    void setExpansions( QgsAuthMethod::Expansions expansions ) { mExpansions = expansions; }
    void setDataProviders( const QStringList &dataproviders ) { mDataProviders = dataproviders; }
 
    QgsAuthMethod::Expansions mExpansions = QgsAuthMethod::Expansions();
    QStringList mDataProviders;
    int mVersion = 0;
    QRecursiveMutex mMutex;
};
Q_DECLARE_OPERATORS_FOR_FLAGS( QgsAuthMethod::Expansions )
 
typedef QHash<QString, QgsAuthMethod *> QgsAuthMethodsMap;
 
#endif // QGSAUTHMETHOD_H