Initial revision

1 files changed, 655 insertions, 0 deletions

diff --git a/kabc/addressbook.cpp b/kabc/addressbook.cpp
new file mode 100644
index 0000000..203efc2
--- a/dev/null
+++ b/kabc/addressbook.cpp
@@ -0,0 +1,655 @@
+/*
+    This file is part of libkabc.
+    Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org>
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Library General Public
+    License as published by the Free Software Foundation; either
+    version 2 of the License, or (at your option) any later version.
+
+    This library 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
+    Library General Public License for more details.
+
+    You should have received a copy of the GNU Library General Public License
+    along with this library; see the file COPYING.LIB.  If not, write to
+    the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+    Boston, MA 02111-1307, USA.
+*/
+
+/*
+Enhanced Version of the file for platform independent KDE tools.
+Copyright (c) 2004 Ulf Schenk
+
+$Id$
+*/
+
+#ifndef KAB_EMBEDDED
+
+#include <qfile.h>
+#include <qregexp.h>
+#include <qtimer.h>
+
+#include <kapplication.h>
+#include <kinstance.h>
+#include <kstandarddirs.h>
+
+#include "errorhandler.h"
+
+#else //KAB_EMBEDDED
+#include <qptrlist.h>
+#endif //KAB_EMBEDDED
+
+#include <kglobal.h>
+#include <klocale.h>
+#include <kdebug.h>
+#include "addressbook.h"
+#include "resource.h"
+
+#ifndef KAB_EMBEDDED
+#include "addressbook.moc"
+#endif //KAB_EMBEDDED
+
+using namespace KABC;
+
+struct AddressBook::AddressBookData
+{
+  Addressee::List mAddressees;
+  Addressee::List mRemovedAddressees;
+  Field::List mAllFields;
+  KConfig *mConfig;
+  KRES::Manager<Resource> *mManager;
+#ifndef KAB_EMBEDDED
+  ErrorHandler *mErrorHandler;
+#endif //KAB_EMBEDDED
+};
+
+struct AddressBook::Iterator::IteratorData
+{
+  Addressee::List::Iterator mIt;
+};
+
+struct AddressBook::ConstIterator::ConstIteratorData
+{
+  Addressee::List::ConstIterator mIt;
+};
+
+AddressBook::Iterator::Iterator()
+{
+  d = new IteratorData;
+}
+
+AddressBook::Iterator::Iterator( const AddressBook::Iterator &i )
+{
+  d = new IteratorData;
+  d->mIt = i.d->mIt;
+}
+
+AddressBook::Iterator &AddressBook::Iterator::operator=( const AddressBook::Iterator &i )
+{
+  if( this == &i ) return *this; // guard against self assignment
+  delete d; // delete the old data the Iterator was completely constructed before
+  d = new IteratorData;
+  d->mIt = i.d->mIt;
+  return *this;
+}
+
+AddressBook::Iterator::~Iterator()
+{
+  delete d;
+}
+
+const Addressee &AddressBook::Iterator::operator*() const
+{
+  return *(d->mIt);
+}
+
+Addressee &AddressBook::Iterator::operator*()
+{
+  return *(d->mIt);
+}
+
+Addressee *AddressBook::Iterator::operator->()
+{
+  return &(*(d->mIt));
+}
+
+AddressBook::Iterator &AddressBook::Iterator::operator++()
+{
+  (d->mIt)++;
+  return *this;
+}
+
+AddressBook::Iterator &AddressBook::Iterator::operator++(int)
+{
+  (d->mIt)++;
+  return *this;
+}
+
+AddressBook::Iterator &AddressBook::Iterator::operator--()
+{
+  (d->mIt)--;
+  return *this;
+}
+
+AddressBook::Iterator &AddressBook::Iterator::operator--(int)
+{
+  (d->mIt)--;
+  return *this;
+}
+
+bool AddressBook::Iterator::operator==( const Iterator &it )
+{
+  return ( d->mIt == it.d->mIt );
+}
+
+bool AddressBook::Iterator::operator!=( const Iterator &it )
+{
+  return ( d->mIt != it.d->mIt );
+}
+
+
+AddressBook::ConstIterator::ConstIterator()
+{
+  d = new ConstIteratorData;
+}
+
+AddressBook::ConstIterator::ConstIterator( const AddressBook::ConstIterator &i )
+{
+  d = new ConstIteratorData;
+  d->mIt = i.d->mIt;
+}
+
+AddressBook::ConstIterator &AddressBook::ConstIterator::operator=( const AddressBook::ConstIterator &i )
+{
+  if( this  == &i ) return *this; // guard for self assignment
+  delete d; // delete the old data because the Iterator was really constructed before
+  d = new ConstIteratorData;
+  d->mIt = i.d->mIt;
+  return *this;
+}
+
+AddressBook::ConstIterator::~ConstIterator()
+{
+  delete d;
+}
+
+const Addressee &AddressBook::ConstIterator::operator*() const
+{
+  return *(d->mIt);
+}
+
+const Addressee* AddressBook::ConstIterator::operator->() const
+{
+  return &(*(d->mIt));
+}
+
+AddressBook::ConstIterator &AddressBook::ConstIterator::operator++()
+{
+  (d->mIt)++;
+  return *this;
+}
+
+AddressBook::ConstIterator &AddressBook::ConstIterator::operator++(int)
+{
+  (d->mIt)++;
+  return *this;
+}
+
+AddressBook::ConstIterator &AddressBook::ConstIterator::operator--()
+{
+  (d->mIt)--;
+  return *this;
+}
+
+AddressBook::ConstIterator &AddressBook::ConstIterator::operator--(int)
+{
+  (d->mIt)--;
+  return *this;
+}
+
+bool AddressBook::ConstIterator::operator==( const ConstIterator &it )
+{
+  return ( d->mIt == it.d->mIt );
+}
+
+bool AddressBook::ConstIterator::operator!=( const ConstIterator &it )
+{
+  return ( d->mIt != it.d->mIt );
+}
+
+
+AddressBook::AddressBook()
+{
+  init(0);
+}
+
+AddressBook::AddressBook( const QString &config )
+{
+  init(config);
+}
+
+void AddressBook::init(const QString &config)
+{
+  d = new AddressBookData;
+  if (config != 0) {
+    d->mConfig = new KConfig( config );
+//    qDebug("AddressBook::init 1  config=%s",config.latin1() );
+  }
+  else {
+    d->mConfig = 0;
+//    qDebug("AddressBook::init 1  config=0");
+  }
+  
+#ifndef KAB_EMBEDDED
+  d->mErrorHandler = 0;
+#endif //KAB_EMBEDDED
+  d->mManager = new KRES::Manager<Resource>( "contact" );
+  d->mManager->readConfig( d->mConfig );
+}
+
+AddressBook::~AddressBook()
+{
+  delete d->mConfig; d->mConfig = 0;
+  delete d->mManager; d->mManager = 0;
+#ifndef KAB_EMBEDDED
+  delete d->mErrorHandler; d->mErrorHandler = 0;
+#endif //KAB_EMBEDDED
+  delete d; d = 0;
+}
+
+bool AddressBook::load()
+{
+  kdDebug(5700) << "AddressBook::load()" << endl;
+
+  clear();
+
+  KRES::Manager<Resource>::ActiveIterator it;
+  bool ok = true;
+  for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it )
+    if ( !(*it)->load() ) {
+      error( i18n("Unable to load resource '%1'").arg( (*it)->resourceName() ) );
+      ok = false;
+    }
+
+  // mark all addressees as unchanged
+  Addressee::List::Iterator addrIt;
+  for ( addrIt = d->mAddressees.begin(); addrIt != d->mAddressees.end(); ++addrIt )
+    (*addrIt).setChanged( false );
+
+  return ok;
+}
+
+bool AddressBook::save( Ticket *ticket )
+{
+  kdDebug(5700) << "AddressBook::save()"<< endl;
+
+  if ( ticket->resource() ) {
+    deleteRemovedAddressees();
+    
+    return ticket->resource()->save( ticket );
+  }
+
+  return false;
+}
+
+AddressBook::Iterator AddressBook::begin()
+{
+  Iterator it = Iterator();
+  it.d->mIt = d->mAddressees.begin();
+  return it;
+}
+
+AddressBook::ConstIterator AddressBook::begin() const
+{
+  ConstIterator it = ConstIterator();
+  it.d->mIt = d->mAddressees.begin();
+  return it;
+}
+
+AddressBook::Iterator AddressBook::end()
+{
+  Iterator it = Iterator();
+  it.d->mIt = d->mAddressees.end();
+  return it;
+}
+
+AddressBook::ConstIterator AddressBook::end() const
+{
+  ConstIterator it = ConstIterator();
+  it.d->mIt = d->mAddressees.end();
+  return it;
+}
+
+void AddressBook::clear()
+{
+  d->mAddressees.clear();
+}
+
+Ticket *AddressBook::requestSaveTicket( Resource *resource )
+{
+  kdDebug(5700) << "AddressBook::requestSaveTicket()" << endl;
+
+  if ( !resource )
+  {
+    qDebug("AddressBook::requestSaveTicket no resource" );
+    resource = standardResource();
+  }
+
+  KRES::Manager<Resource>::ActiveIterator it;
+  for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) {
+    if ( (*it) == resource ) {
+      if ( (*it)->readOnly() || !(*it)->isOpen() )
+        return 0;
+      else
+        return (*it)->requestSaveTicket();
+    }
+  }
+
+  return 0;
+}
+
+void AddressBook::insertAddressee( const Addressee &a )
+{
+  Addressee::List::Iterator it;
+  for ( it = d->mAddressees.begin(); it != d->mAddressees.end(); ++it ) {
+    if ( a.uid() == (*it).uid() ) {
+      bool changed = false;
+      Addressee addr = a;
+      if ( addr != (*it) )
+        changed = true;
+
+      (*it) = a;
+      if ( (*it).resource() == 0 )
+        (*it).setResource( standardResource() );
+
+      if ( changed ) {
+        (*it).setRevision( QDateTime::currentDateTime() );
+        (*it).setChanged( true ); 
+      }
+
+      return;
+    }
+  }
+  d->mAddressees.append( a );
+  Addressee& addr = d->mAddressees.last();
+  if ( addr.resource() == 0 )
+    addr.setResource( standardResource() );
+
+  addr.setChanged( true );
+}
+
+void AddressBook::removeAddressee( const Addressee &a )
+{
+  Iterator it;
+  for ( it = begin(); it != end(); ++it ) {
+    if ( a.uid() == (*it).uid() ) {
+      removeAddressee( it );
+      return;
+    }
+  }
+}
+
+void AddressBook::removeAddressee( const Iterator &it )
+{
+  d->mRemovedAddressees.append( (*it) );
+  d->mAddressees.remove( it.d->mIt );
+}
+
+AddressBook::Iterator AddressBook::find( const Addressee &a )
+{
+  Iterator it;
+  for ( it = begin(); it != end(); ++it ) {
+    if ( a.uid() == (*it).uid() ) {
+      return it;
+    }
+  }
+  return end();
+}
+
+Addressee AddressBook::findByUid( const QString &uid )
+{
+  Iterator it;
+  for ( it = begin(); it != end(); ++it ) {
+    if ( uid == (*it).uid() ) {
+      return *it;
+    }
+  }
+  return Addressee();
+}
+
+Addressee::List AddressBook::allAddressees()
+{
+  return d->mAddressees;
+}
+
+Addressee::List AddressBook::findByName( const QString &name )
+{
+  Addressee::List results;
+
+  Iterator it;
+  for ( it = begin(); it != end(); ++it ) {
+    if ( name == (*it).name() ) {
+      results.append( *it );
+    }
+  }
+
+  return results;
+}
+
+Addressee::List AddressBook::findByEmail( const QString &email )
+{
+  Addressee::List results;
+  QStringList mailList;
+
+  Iterator it;
+  for ( it = begin(); it != end(); ++it ) {
+    mailList = (*it).emails();    
+    for ( QStringList::Iterator ite = mailList.begin(); ite != mailList.end(); ++ite ) {
+      if ( email == (*ite) ) {
+        results.append( *it );
+      }
+    }
+  }
+
+  return results;
+}
+
+Addressee::List AddressBook::findByCategory( const QString &category )
+{
+  Addressee::List results;
+
+  Iterator it;
+  for ( it = begin(); it != end(); ++it ) {
+    if ( (*it).hasCategory( category) ) {
+      results.append( *it );
+    }
+  }
+
+  return results;
+}
+
+void AddressBook::dump() const
+{
+  kdDebug(5700) << "AddressBook::dump() --- begin ---" << endl;
+
+  ConstIterator it;
+  for( it = begin(); it != end(); ++it ) {
+    (*it).dump();
+  }
+
+  kdDebug(5700) << "AddressBook::dump() ---  end  ---" << endl;
+}
+
+QString AddressBook::identifier()
+{
+  QStringList identifier;
+
+
+  KRES::Manager<Resource>::ActiveIterator it;
+  for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) {
+    if ( !(*it)->identifier().isEmpty() )
+      identifier.append( (*it)->identifier() );
+  }
+
+  return identifier.join( ":" );
+}
+
+Field::List AddressBook::fields( int category )
+{
+  if ( d->mAllFields.isEmpty() ) {
+    d->mAllFields = Field::allFields();
+  }
+  
+  if ( category == Field::All ) return d->mAllFields;
+  
+  Field::List result;
+  Field::List::ConstIterator it;
+  for( it = d->mAllFields.begin(); it != d->mAllFields.end(); ++it ) {
+    if ( (*it)->category() & category ) result.append( *it );
+  }
+  
+  return result;
+}
+
+bool AddressBook::addCustomField( const QString &label, int category,
+                                  const QString &key, const QString &app )
+{
+  if ( d->mAllFields.isEmpty() ) {
+    d->mAllFields = Field::allFields();
+  }
+#ifndef KAB_EMBEDDED
+  QString a = app.isNull() ? KGlobal::instance()->instanceName() : app;
+#else //KAB_EMBEDDED
+  QString a = app.isNull() ? KGlobal::getAppName() : app;
+#endif //KAB_EMBEDDED
+
+  QString k = key.isNull() ? label : key;
+
+  Field *field = Field::createCustomField( label, category, k, a );
+
+  if ( !field ) return false;
+
+  d->mAllFields.append( field );
+
+  return true;
+}
+
+QDataStream &KABC::operator<<( QDataStream &s, const AddressBook &ab )
+{
+  if (!ab.d) return s;
+
+  return s << ab.d->mAddressees;
+}
+
+QDataStream &KABC::operator>>( QDataStream &s, AddressBook &ab )
+{
+  if (!ab.d) return s;
+
+  s >> ab.d->mAddressees;
+
+  return s;
+}
+
+bool AddressBook::addResource( Resource *resource )
+{
+  qDebug("AddressBook::addResource 1");
+  
+  if ( !resource->open() ) {
+    kdDebug(5700) << "AddressBook::addResource(): can't add resource" << endl;
+    return false;
+  }
+
+  resource->setAddressBook( this );
+
+  d->mManager->add( resource );
+  return true;
+}
+
+bool AddressBook::removeResource( Resource *resource )
+{
+  resource->close();
+
+  if ( resource == standardResource() )
+    d->mManager->setStandardResource( 0 );
+
+  resource->setAddressBook( 0 );
+
+  d->mManager->remove( resource );
+  return true;
+}
+
+QPtrList<Resource> AddressBook::resources()
+{
+  QPtrList<Resource> list;
+
+//  qDebug("AddressBook::resources() 1");
+  
+  KRES::Manager<Resource>::ActiveIterator it;
+  for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it )
+    list.append( *it );
+
+  return list;
+}
+
+#ifndef KAB_EMBEDDED
+void AddressBook::setErrorHandler( ErrorHandler *handler )
+{
+  delete d->mErrorHandler;
+  d->mErrorHandler = handler;
+}
+#endif //KAB_EMBEDDED
+
+void AddressBook::error( const QString& msg )
+{
+#ifndef KAB_EMBEDDED
+  if ( !d->mErrorHandler ) // create default error handler
+    d->mErrorHandler = new ConsoleErrorHandler;
+
+  if ( d->mErrorHandler )
+    d->mErrorHandler->error( msg );
+  else
+    kdError(5700) << "no error handler defined" << endl;
+#else //KAB_EMBEDDED
+    kdDebug(5700) << "msg" << endl;
+    qDebug(msg);
+#endif //KAB_EMBEDDED
+}
+
+void AddressBook::deleteRemovedAddressees()
+{
+  Addressee::List::Iterator it;
+  for ( it = d->mRemovedAddressees.begin(); it != d->mRemovedAddressees.end(); ++it ) {
+    Resource *resource = (*it).resource();
+    if ( resource && !resource->readOnly() && resource->isOpen() )
+      resource->removeAddressee( *it );
+  }
+
+  d->mRemovedAddressees.clear();
+}
+
+void AddressBook::setStandardResource( Resource *resource )
+{
+//  qDebug("AddressBook::setStandardResource 1");
+  d->mManager->setStandardResource( resource );
+}
+
+Resource *AddressBook::standardResource()
+{
+  return d->mManager->standardResource();
+}
+
+KRES::Manager<Resource> *AddressBook::resourceManager()
+{
+  return d->mManager;
+}
+
+void AddressBook::cleanUp()
+{
+  KRES::Manager<Resource>::ActiveIterator it;
+  for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) {
+    if ( !(*it)->readOnly() && (*it)->isOpen() )
+      (*it)->cleanUp();
+  }
+}