diff --git a/kabc/stdaddressbook.cpp b/kabc/stdaddressbook.cpp index 7ec347851..d9595b6e1 100644 --- a/kabc/stdaddressbook.cpp +++ b/kabc/stdaddressbook.cpp @@ -1,207 +1,220 @@ /* This file is part of libkabc. Copyright (c) 2001 Cornelius Schumacher 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. */ #include #include #include #include #include #include #include #include "stdaddressbook.h" #include "resourcefactory.h" #include "resourcefile.h" #include "vcardformatplugin.h" using namespace KABC; extern "C" { static void setSignalHandler( void (*handler)(int) ); // Crash recovery signal handler static void signalHandler( int sigId ) { setSignalHandler( SIG_DFL ); fprintf( stderr, "*** libkabc got signal %d (Exiting)\n", sigId ); // try to cleanup all lock files StdAddressBook::self()->cleanUp(); ::exit(-1); } // Crash recovery signal handler static void crashHandler( int sigId ) { setSignalHandler( SIG_DFL ); fprintf( stderr, "*** libkabc got signal %d (Crashing)\n", sigId ); // try to cleanup all lock files StdAddressBook::self()->cleanUp(); // Return to DrKonqi. } static void setSignalHandler( void (*handler)(int) ) { signal( SIGKILL, handler ); signal( SIGTERM, handler ); signal( SIGHUP, handler ); KCrash::setEmergencySaveFunction( crashHandler ); } } AddressBook *StdAddressBook::mSelf = 0; +bool StdAddressBook::mAutomaticSave = true; QString StdAddressBook::fileName() { return locateLocal( "data", "kabc/std.vcf" ); } QString StdAddressBook::directoryName() { return locateLocal( "data", "kabc/stdvcf" ); } AddressBook *StdAddressBook::self() { kdDebug(5700) << "StdAddressBook::self()" << endl; if ( !mSelf ) mSelf = new StdAddressBook; return mSelf; } AddressBook *StdAddressBook::self( bool onlyFastResources ) { kdDebug(5700) << "StdAddressBook::self()" << endl; if ( !mSelf ) mSelf = new StdAddressBook( onlyFastResources ); return mSelf; } bool StdAddressBook::save() { kdDebug(5700) << "StdAddressBook::save()" << endl; bool ok = true; Resource *resource = 0; AddressBook *ab = self(); ab->deleteRemovedAddressees(); QPtrList list = ab->resources(); for ( uint i = 0; i < list.count(); ++i ) { resource = list.at( i ); if ( !resource->readOnly() ) { Ticket *ticket = ab->requestSaveTicket( resource ); if ( !ticket ) { ab->error( i18n( "Unable to save to standard addressbook. It is locked." ) ); return false; } if ( !ab->save( ticket ) ) ok = false; } } return ok; } StdAddressBook::StdAddressBook() { kdDebug(5700) << "StdAddressBook::StdAddressBook()" << endl; init( false ); } StdAddressBook::StdAddressBook( bool onlyFastResources ) { kdDebug(5700) << "StdAddressBook::StdAddressBook( bool )" << endl; init( onlyFastResources ); } StdAddressBook::~StdAddressBook() { + if ( mAutomaticSave ) + save(); } void StdAddressBook::init( bool onlyFastResources ) { KSimpleConfig config( "kabcrc", true ); ResourceFactory *factory = ResourceFactory::self(); config.setGroup( "General" ); QStringList keys = config.readListEntry( "ResourceKeys" ); QString stdKey = config.readEntry( "Standard" ); for ( QStringList::Iterator it = keys.begin(); it != keys.end(); ++it ) { config.setGroup( "Resource_" + (*it) ); QString type = config.readEntry( "ResourceType" ); if ( onlyFastResources && !config.readBoolEntry( "ResourceIsFast" ) ) continue; Resource *resource = factory->resource( type, this, &config ); if ( !resource ) continue; resource->setReadOnly( config.readBoolEntry( "ResourceIsReadOnly" ) ); resource->setFastResource( config.readBoolEntry( "ResourceIsFast" ) ); resource->setName( config.readEntry( "ResourceName" ).latin1() ); if ( !addResource( resource ) ) { delete resource; continue; } if ( stdKey == (*it) ) setStandardResource( resource ); } QPtrList list = resources(); if ( list.count() == 0 ) { // default resource kdDebug(5700) << "StdAddressBook(): using default resource" << endl; Resource *resource = new ResourceFile( this, fileName(), new VCardFormatPlugin ); resource->setReadOnly( false ); resource->setFastResource( true ); if ( !addResource( resource ) ) delete resource; setStandardResource( resource ); } load(); setSignalHandler( signalHandler ); } void StdAddressBook::close() { delete mSelf; mSelf = 0; } + +void StdAddressBook::setAutomaticSave( bool enable ) +{ + mAutomaticSave = enable; +} + +bool StdAddressBook::automaticSave() +{ + return mAutomaticSave; +} diff --git a/kabc/stdaddressbook.h b/kabc/stdaddressbook.h index bc2dfffce..9c7efa06c 100644 --- a/kabc/stdaddressbook.h +++ b/kabc/stdaddressbook.h @@ -1,104 +1,120 @@ /* This file is part of libkabc. Copyright (c) 2001 Cornelius Schumacher 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. */ #ifndef KABC_STDADDRESSBOOK_H #define KABC_STDADDRESSBOOK_H #include "addressbook.h" namespace KABC { /** Standard KDE address book This class provides access to the standard KDE address book shared by all applications. It's implemented as a singleton. Use @ref self() to get the address book object. Example: 
   KABC::AddressBook *ab = KABC::StdAddressBook::self();
  
   if ( !ab->load() ) {
     // error
   }
  
   KABC::AddressBook::Iterator it;
   for ( it = ab->begin(); it != ab->end(); ++it ) {
     kdDebug() << "UID=" << (*it).uid() << endl;
  
     // do some other stuff
   }
  
   KABC::StdAddressBook::save();
*/ class StdAddressBook : public AddressBook { public: /** Return the standard addressbook object. */ static AddressBook *self(); /** This is the same as above, but with specified behaviour of resource loading. @param onlyFastResource Only resources marked as 'fast' should be loaded */ static AddressBook *self( bool onlyFastResources ); /** Save the standard address book to disk. */ static bool save(); /** Returns the default file name for vcard-based addressbook */ static QString fileName(); /** Returns the default directory name for vcard-based addressbook */ static QString directoryName(); /** - Close the Addressbook. It does not save it before + Set the automatic save property of the address book. + If @p enable is TRUE (default) the address book is saved at + destruction time otherwise you have to call @ref save() to + explicitely save it. + */ + static void setAutomaticSave( bool enable ); + + /** + Closes the address book. Depending on @ref automaticSave() it will + save the address book first. */ static void close(); + /** + Returns whether the address book is saved at destruction time. + See also @ref setAutomaticSave(). + */ + static bool automaticSave(); + protected: StdAddressBook(); StdAddressBook( bool onlyFastResources ); ~StdAddressBook(); void init( bool onlyFastResources ); private: static AddressBook *mSelf; + static bool mAutomaticSave; }; } #endif