ldapclient.h

/* kldapclient.h - LDAP access
 *      Copyright (C) 2002 Klarälvdalens Datakonsult AB
 *
 *      Author: Steffen Hansen <hansen@kde.org>
 *
 * This file 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.
 *
 * This file is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
 */
 
 
#ifndef KPIM_LDAPCLIENT_H
#define KPIM_LDAPCLIENT_H
 
 
#include <tqobject.h>
#include <tqstring.h>
#include <tqcstring.h>
#include <tqstringlist.h>
#include <tqmemarray.h>
#include <tqguardedptr.h>
#include <tqtimer.h>
 
#include <tdeio/job.h>
#include <tdeabc/ldif.h>
#include <tdeconfig.h>
 
#include <tdemacros.h>
 
namespace KPIM {
 
class LdapClient;
typedef TQValueList<TQByteArray> LdapAttrValue;
typedef TQMap<TQString,LdapAttrValue > LdapAttrMap;
 
class LdapServer
{
  public:
    LdapServer()
    : mPort( 389 ),
      mTimeLimit(0),
      mSizeLimit(0),
      mVersion(2),
      mSecurity(Sec_None),
      mAuth( LdapServer::Anonymous )
    {}
 
    enum Security{ Sec_None, TLS, SSL };
    enum Auth{ Anonymous, Simple, SASL };
    TQString host() const { return mHost; }
    int port() const { return mPort; }
    const TQString &baseDN() const { return mBaseDN; }
    const TQString &user() const { return mUser; }
    const TQString &bindDN() const { return mBindDN; }
    const TQString &pwdBindDN() const { return mPwdBindDN; }
    int timeLimit() const { return mTimeLimit; }
    int sizeLimit() const { return mSizeLimit; }
    int version() const { return mVersion; }
    int security() const { return mSecurity; }
    int auth() const { return mAuth; }
    const TQString &mech() const { return mMech; }
 
    void setHost( const TQString &host ) { mHost = host; }
    void setPort( int port ) { mPort = port; }
    void setBaseDN( const TQString &baseDN ) {  mBaseDN = baseDN; }
    void setUser( const TQString &user ) { mUser = user; }
    void setBindDN( const TQString &bindDN ) {  mBindDN = bindDN; }
    void setPwdBindDN( const TQString &pwdBindDN ) {  mPwdBindDN = pwdBindDN; }
    void setTimeLimit( int timelimit ) { mTimeLimit = timelimit; }
    void setSizeLimit( int sizelimit ) { mSizeLimit = sizelimit; }
    void setVersion( int version ) { mVersion = version; }
    void setSecurity( int security ) { mSecurity = security; } //0-No, 1-TLS, 2-SSL - KDE4: add an enum to Lda
    void setAuth( int auth ) { mAuth = auth; } //0-Anonymous, 1-simple, 2-SASL - KDE4: add an enum to LdapCon
    void setMech( const TQString &mech ) { mMech = mech; }
 
  private:
    TQString mHost;
    int mPort;
    TQString mBaseDN;
    TQString mUser;
    TQString mBindDN;
    TQString mPwdBindDN;
    TQString mMech;
    int mTimeLimit, mSizeLimit, mVersion, mSecurity, mAuth;
};
 
 
class LdapObject
{
  public:
    LdapObject()
      : dn( TQString() ), client( 0 ) {}
    explicit LdapObject( const TQString& _dn, LdapClient* _cl ) : dn( _dn ), client( _cl ) {}
    LdapObject( const LdapObject& that ) { assign( that ); }
 
    LdapObject& operator=( const LdapObject& that )
    {
      assign( that );
      return *this;
    }
 
    TQString toString() const;
 
    void clear();
 
    TQString dn;
    TQString objectClass;
    LdapAttrMap attrs;
    LdapClient* client;
 
  protected:
    void assign( const LdapObject& that );
 
  private:
    //class LdapObjectPrivate* d;
};
 
class TDE_EXPORT LdapClient : public TQObject
{
  TQ_OBJECT
  
 
  public:
    LdapClient( int clientNumber, TQObject* parent = 0, const char* name = 0 );
    virtual ~LdapClient();
 
    bool isActive() const { return mActive; }
 
    int clientNumber() const;
    int completionWeight() const;
    void setCompletionWeight( int );
 
    const LdapServer& server() { return mServer; }
    void setServer( const LdapServer &server ) { mServer = server; }
    TQStringList attrs() const { return mAttrs; }
 
  signals:
    void done();
 
    void error( const TQString& );
 
    void result( const KPIM::LdapObject& );
 
  public slots: // why are those slots?
    void setAttrs( const TQStringList& attrs );
 
    void setScope( const TQString scope ) { mScope = scope; }
 
    void startQuery( const TQString& filter );
 
    void cancelQuery();
 
  protected slots:
    void slotData( TDEIO::Job*, const TQByteArray &data );
    void slotInfoMessage( TDEIO::Job*, const TQString &info );
    void slotDone();
 
  protected:
    void startParseLDIF();
    void parseLDIF( const TQByteArray& data );
    void endParseLDIF();
    void finishCurrentObject();
 
    LdapServer mServer;
    TQString mScope;
    TQStringList mAttrs;
 
    TQGuardedPtr<TDEIO::SimpleJob> mJob;
    bool mActive;
    bool mReportObjectClass;
 
    LdapObject mCurrentObject;
 
  private:
    TDEABC::LDIF mLdif;
    int mClientNumber;
    int mCompletionWeight;
 
//    class LdapClientPrivate;
//    LdapClientPrivate* d;
};
 
struct LdapResult {
  TQString name;     
  TQStringList email;    
  int clientNumber; 
  int completionWeight; 
};
typedef TQValueList<LdapResult> LdapResultList;
 
 
class TDE_EXPORT LdapSearch : public TQObject
{
  TQ_OBJECT
  
 
  public:
    LdapSearch();
 
    static TDEConfig *config();
    static void readConfig( LdapServer &server, TDEConfig *config, int num, bool active );
    static void writeConfig( const LdapServer &server, TDEConfig *config, int j, bool active );
 
    void startSearch( const TQString& txt );
    void cancelSearch();
    bool isAvailable() const;
    void updateCompletionWeights();
 
    TQValueList< LdapClient* > clients() const { return mClients; }
 
  signals:
    void searchData( const TQStringList& );
    void searchData( const KPIM::LdapResultList& );
    void searchDone();
 
  private slots:
    void slotLDAPResult( const KPIM::LdapObject& );
    void slotLDAPError( const TQString& );
    void slotLDAPDone();
    void slotDataTimer();
    void slotFileChanged( const TQString& );
 
  private:
    void readWeighForClient( LdapClient *client, TDEConfig *config, int clientNumber );
    void readConfig();
    void finish();
    void makeSearchData( TQStringList& ret, LdapResultList& resList );
    TQValueList< LdapClient* > mClients;
    TQString mSearchText;
    TQTimer mDataTimer;
    int mActiveClients;
    bool mNoLDAPLookup;
    TQValueList< LdapObject > mResults;
    TQString mConfigFile;
 
  private:
    static TDEConfig *s_config;
    class LdapSearchPrivate* d;
};
 
}
#endif // KPIM_LDAPCLIENT_H