certmanager/lib

cryptobackendfactory.h

00001 /*
00002     kleo/cryptobackendfactory.h
00003 
00004     This file is part of libkleopatra, the KDE keymanagement library
00005     Copyright (c) 2004,2005 Klarälvdalens Datakonsult AB
00006 
00007     Libkleopatra is free software; you can redistribute it and/or
00008     modify it under the terms of the GNU General Public License as
00009     published by the Free Software Foundation; either version 2 of the
00010     License, or (at your option) any later version.
00011 
00012     Libkleopatra is distributed in the hope that it will be useful,
00013     but WITHOUT ANY WARRANTY; without even the implied warranty of
00014     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00015     General Public License for more details.
00016 
00017     You should have received a copy of the GNU General Public License
00018     along with this program; if not, write to the Free Software
00019     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
00020 
00021     In addition, as a special exception, the copyright holders give
00022     permission to link the code of this program with any edition of
00023     the Qt library by Trolltech AS, Norway (or with modified versions
00024     of Qt that use the same license as Qt), and distribute linked
00025     combinations including the two.  You must obey the GNU General
00026     Public License in all respects for all of the code used other than
00027     Qt.  If you modify this file, you may extend this exception to
00028     your version of the file, but you are not obligated to do so.  If
00029     you do not wish to do so, delete this exception statement from
00030     your version.
00031 */
00032 
00033 #ifndef __KLEO_CRYPTOBACKENDFACTORY_H__
00034 #define __KLEO_CRYPTOBACKENDFACTORY_H__
00035 
00036 #include <qobject.h>
00037 
00038 #include "cryptobackend.h"
00039 #include <kdepimmacros.h>
00040 
00041 #include <vector>
00042 #include <map>
00043 
00044 namespace Kleo {
00045   class BackendConfigWidget;
00046 }
00047 
00048 class QString;
00049 class KConfig;
00050 
00051 namespace Kleo {
00052 
00053   struct lt_i_str {
00054     bool operator()( const char * one, const char * two ) const {
00055       return qstricmp( one, two ) < 0;
00056     }
00057   };
00058 
00059   class KDE_EXPORT CryptoBackendFactory : public QObject {
00060     Q_OBJECT
00061   protected:
00062     CryptoBackendFactory();
00063     ~CryptoBackendFactory();
00064   public:
00065     static CryptoBackendFactory * instance();
00066 
00067     const CryptoBackend::Protocol * smime() const;
00068     const CryptoBackend::Protocol * openpgp() const;
00069     const CryptoBackend::Protocol * protocol( const char * name ) const;
00070     CryptoConfig * config() const;
00071 
00072     const CryptoBackend * backend( unsigned int idx ) const;
00073 
00074     bool hasBackends() const;
00075 
00076     Kleo::BackendConfigWidget * configWidget( QWidget * parent=0, const char * name=0 ) const;
00077 
00078     KConfig* configObject() const;
00079 
00080     // The preferred backend for smime (can be 0) - currently unused
00081     //const CryptoBackend* smimeBackend() const;
00082     // The preferred backend for openpgp (can be 0) - currently unused
00083     //const CryptoBackend* openpgpBackend() const;
00084 
00085     // For BackendConfigWidget to save the configuration
00086     // 0 means no backend selected.
00087     void setSMIMEBackend( const CryptoBackend* backend );
00088     void setOpenPGPBackend( const CryptoBackend* backend );
00089     void setProtocolBackend( const char * name, const CryptoBackend * backend );
00090 
00091     void scanForBackends( QStringList * reasons=0 );
00092 
00093     const char * enumerateProtocols( int i ) const;
00094 
00095     bool knowsAboutProtocol( const char * name ) const;
00096 
00097   protected:
00098     std::vector<CryptoBackend*> mBackendList;
00099     mutable KConfig* mConfigObject;
00100     typedef std::map<const char *, const CryptoBackend*, lt_i_str> BackendMap;
00101     BackendMap mBackends;
00102     typedef std::vector<const char *> ProtocolSet;
00103     ProtocolSet mAvailableProtocols;
00104 
00105   private:
00106     const CryptoBackend * backendByName( const QString& name ) const;
00107     void readConfig();
00108     CryptoBackendFactory( const CryptoBackendFactory & );
00109     void operator=( const CryptoBackendFactory & );
00110 
00111     static CryptoBackendFactory * mSelf;
00112   };
00113 
00114 
00115 }
00116 
00117 #endif // __KLEO_CRYPTOBACKENDFACTORY_H__
KDE Home | KDE Accessibility Home | Description of Access Keys