certmanager Library API Documentation

qgpgmejob.h

00001 /*
00002     qgpgmejob.h
00003 
00004     This file is part of libkleopatra, the KDE keymanagement library
00005     Copyright (c) 2004 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  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_QGPGMEJOB_H__
00034 #define __KLEO_QGPGMEJOB_H__
00035 
00036 #include <gpgmepp/interfaces/progressprovider.h>
00037 #include <gpgmepp/interfaces/passphraseprovider.h>
00038 
00039 #include <gpgmepp/key.h>
00040 
00041 #include <qcstring.h>
00042 
00043 #include <vector>
00044 
00045 namespace GpgME {
00046   class Error;
00047   class Context;
00048   class Data;
00049 }
00050 
00051 namespace Kleo {
00052   class Job;
00053 }
00054 
00055 namespace QGpgME {
00056   class QByteArrayDataProvider;
00057 }
00058 
00059 class QString;
00060 class QStringList;
00061 
00062 namespace Kleo {
00063 
00077   class QGpgMEJob : public GpgME::ProgressProvider, public GpgME::PassphraseProvider {
00078   public:
00079     QGpgMEJob( Kleo::Job * _this, GpgME::Context * context );
00080     ~QGpgMEJob();
00081 
00082   protected:
00085     virtual void doOperationDoneEvent( const GpgME::Error & e ) = 0;
00087     void hookupContextToEventLoopInteractor();
00089     void setPatterns( const QStringList & sl, bool allowEmpty=false );
00091     unsigned int numPatterns() const { return mNumPatterns; }
00093     const char* * nextChunk();
00095     const char* * patterns() const;
00097     void setChunkSize( unsigned int size );
00099     unsigned int chunkSize() const { return mChunkSize; }
00101     void createOutData();
00104     void createInData( const QByteArray & in );
00106     GpgME::Error setSigningKeys( const std::vector<GpgME::Key> & signers );
00108     void doSlotOperationDoneEvent( GpgME::Context * context, const GpgME::Error & e );
00109 
00110     //
00111     // only boring stuff below this line...
00112     //
00113 
00114   protected:
00115     virtual void doEmitProgressSignal( const QString & what, int current, int total ) = 0;
00116     virtual void doEmitDoneSignal() = 0;
00117     void doSlotCancel();
00118 
00119   private:
00121     void showProgress( const char * what, int type, int current, int total );
00122     char * getPassphrase( const char * useridHint, const char * description,
00123               bool previousWasBad, bool & canceled );
00124     void deleteAllPatterns();
00125 
00126   public:
00127     void checkInvariants() const;
00128 
00129   protected:
00130     Kleo::Job * mThis;
00131     GpgME::Context * mCtx;
00132     GpgME::Data * mInData;
00133     QGpgME::QByteArrayDataProvider * mInDataDataProvider;
00134     GpgME::Data * mOutData;
00135     QGpgME::QByteArrayDataProvider * mOutDataDataProvider;
00136   private:
00137     const char* * mPatterns;
00138     // holds the entry - if any - in mPattern that was replaced with
00139     // NULL to create a temporary end-of-array marker for gpgme:
00140     const char * mReplacedPattern;
00141     unsigned int mNumPatterns;
00142     unsigned int mChunkSize;
00143     unsigned int mPatternStartIndex, mPatternEndIndex;
00144   };
00145 
00146 }
00147 
00148 #define make_slot_cancel private: void slotCancel() { QGpgMEJob::doSlotCancel(); }
00149 #define make_progress_emitter private: void doEmitProgressSignal( const QString & what, int cur, int tot ) { emit progress( what, cur, tot ); }
00150 #define make_done_emitter private: void doEmitDoneSignal() { emit done(); }
00151 #define QGPGME_JOB make_slot_cancel make_progress_emitter make_done_emitter
00152 
00153 #endif // __KLEO_QGPGMEJOB_H__
KDE Logo
This file is part of the documentation for certmanager Library Version 3.3.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Fri Dec 21 14:22:39 2007 by doxygen 1.4.2 written by Dimitri van Heesch, © 1997-2003