• Skip to content
  • Skip to link menu
Trinity API Reference
  • Trinity API Reference
  • tdeabc
 

tdeabc

  • tdeabc
stdaddressbook.cpp
1 /*
2  This file is part of libtdeabc.
3  Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org>
4 
5  This library is free software; you can redistribute it and/or
6  modify it under the terms of the GNU Library General Public
7  License as published by the Free Software Foundation; either
8  version 2 of the License, or (at your option) any later version.
9 
10  This library is distributed in the hope that it will be useful,
11  but WITHOUT ANY WARRANTY; without even the implied warranty of
12  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  Library General Public License for more details.
14 
15  You should have received a copy of the GNU Library General Public License
16  along with this library; see the file COPYING.LIB. If not, write to
17  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18  Boston, MA 02110-1301, USA.
19 */
20 
21 #include <stdlib.h>
22 
23 #include <tdeapplication.h>
24 #include <tdecrash.h>
25 #include <kdebug.h>
26 #include <tdelocale.h>
27 #include <tderesources/manager.h>
28 #include <ksimpleconfig.h>
29 #include <kstandarddirs.h>
30 #include <kstaticdeleter.h>
31 
32 #include "resource.h"
33 
34 #include "stdaddressbook.h"
35 
36 using namespace TDEABC;
37 
38 StdAddressBook *StdAddressBook::mSelf = 0;
39 bool StdAddressBook::mAutomaticSave = true;
40 
41 static KStaticDeleter<StdAddressBook> addressBookDeleter;
42 
43 TQString StdAddressBook::fileName()
44 {
45  return locateLocal( "data", "tdeabc/std.vcf" );
46 }
47 
48 TQString StdAddressBook::directoryName()
49 {
50  return locateLocal( "data", "tdeabc/stdvcf" );
51 }
52 
53 void StdAddressBook::handleCrash()
54 {
55 }
56 
57 StdAddressBook *StdAddressBook::self()
58 {
59  if ( !mSelf )
60  addressBookDeleter.setObject( mSelf, new StdAddressBook );
61 
62  return mSelf;
63 }
64 
65 StdAddressBook *StdAddressBook::self( bool asynchronous )
66 {
67  if ( !mSelf )
68  addressBookDeleter.setObject( mSelf, new StdAddressBook( asynchronous ) );
69 
70  return mSelf;
71 }
72 
73 StdAddressBook::StdAddressBook()
74  : AddressBook( "" )
75 {
76  kdDebug(5700) << "StdAddressBook::StdAddressBook()" << endl;
77 
78  init( false );
79 }
80 
81 StdAddressBook::StdAddressBook( bool asynchronous )
82  : AddressBook( "" )
83 {
84  kdDebug(5700) << "StdAddressBook::StdAddressBook( bool )" << endl;
85 
86  init( asynchronous );
87 }
88 
89 StdAddressBook::~StdAddressBook()
90 {
91  if ( mAutomaticSave )
92  saveAll();
93 }
94 
95 void StdAddressBook::init( bool asynchronous )
96 {
97  KRES::Manager<Resource> *manager = resourceManager();
98 
99  KRES::Manager<Resource>::ActiveIterator it;
100  for ( it = manager->activeBegin(); it != manager->activeEnd(); ++it ) {
101  (*it)->setAddressBook( this );
102  if ( !(*it)->open() ) {
103  error( TQString( "Unable to open resource '%1'!" ).arg( (*it)->resourceName() ) );
104  continue;
105  }
106  connect( *it, TQ_SIGNAL( loadingFinished( Resource* ) ),
107  this, TQ_SLOT( resourceLoadingFinished( Resource* ) ) );
108  connect( *it, TQ_SIGNAL( savingFinished( Resource* ) ),
109  this, TQ_SLOT( resourceSavingFinished( Resource* ) ) );
110 
111  connect( *it, TQ_SIGNAL( loadingError( Resource*, const TQString& ) ),
112  this, TQ_SLOT( resourceLoadingError( Resource*, const TQString& ) ) );
113  connect( *it, TQ_SIGNAL( savingError( Resource*, const TQString& ) ),
114  this, TQ_SLOT( resourceSavingError( Resource*, const TQString& ) ) );
115  }
116 
117  Resource *res = standardResource();
118  if ( !res ) {
119  res = manager->createResource( "file" );
120  if ( res )
121  addResource( res );
122  else
123  kdDebug(5700) << "No resource available!!!" << endl;
124  }
125 
126  setStandardResource( res );
127  manager->writeConfig();
128 
129  if ( asynchronous )
130  asyncLoad();
131  else
132  load();
133 }
134 
135 bool StdAddressBook::saveAll()
136 {
137  kdDebug(5700) << "StdAddressBook::saveAll()" << endl;
138  bool ok = true;
139 
140  deleteRemovedAddressees();
141 
142  KRES::Manager<Resource>::ActiveIterator it;
143  KRES::Manager<Resource> *manager = resourceManager();
144  for ( it = manager->activeBegin(); it != manager->activeEnd(); ++it ) {
145  if ( !(*it)->readOnly() && (*it)->isOpen() ) {
146  Ticket *ticket = requestSaveTicket( *it );
147  if ( !ticket ) {
148  error( i18n( "Unable to save to resource '%1'. It is locked." )
149  .arg( (*it)->resourceName() ) );
150  return false;
151  }
152 
153  if ( !AddressBook::save( ticket ) ) {
154  ok = false;
155  releaseSaveTicket( ticket );
156  }
157  }
158  }
159 
160  return ok;
161 }
162 
163 bool StdAddressBook::save()
164 {
165  kdDebug(5700) << "StdAddressBook::save()" << endl;
166 
167  if ( mSelf )
168  return mSelf->saveAll();
169  else
170  return true;
171 }
172 
173 void StdAddressBook::close()
174 {
175  addressBookDeleter.destructObject();
176 }
177 
178 void StdAddressBook::setAutomaticSave( bool enable )
179 {
180  mAutomaticSave = enable;
181 }
182 
183 bool StdAddressBook::automaticSave()
184 {
185  return mAutomaticSave;
186 }
187 
188 // should get const for 4.X
189 Addressee StdAddressBook::whoAmI()
190 {
191  TDEConfig config( "tdeabcrc" );
192  config.setGroup( "General" );
193 
194  return findByUid( config.readEntry( "WhoAmI" ) );
195 }
196 
197 void StdAddressBook::setWhoAmI( const Addressee &addr )
198 {
199  TDEConfig config( "tdeabcrc" );
200  config.setGroup( "General" );
201 
202  config.writeEntry( "WhoAmI", addr.uid() );
203 }
KStaticDeleter
TDEABC::AddressBook
Address Book.
Definition: addressbook.h:44
TDEABC::AddressBook::load
bool load()
Loads all addressees synchronously.
Definition: addressbook.cpp:336
TDEABC::AddressBook::error
void error(const TQString &msg)
Shows GUI independent error messages.
Definition: addressbook.cpp:772
TDEABC::AddressBook::loadingFinished
void loadingFinished(Resource *resource)
Emitted when the asynchronous loading of one resource has finished after calling asyncLoad().
TDEABC::AddressBook::addResource
bool addResource(Resource *resource)
Adds a resource to the address book.
Definition: addressbook.cpp:704
TDEABC::AddressBook::releaseSaveTicket
void releaseSaveTicket(Ticket *ticket)
Releases the ticket requested previously with requestSaveTicket().
Definition: addressbook.cpp:508
TDEABC::AddressBook::savingFinished
void savingFinished(Resource *resource)
Emitted when the asynchronous saving of one resource has finished after calling asyncSave().
TDEABC::AddressBook::requestSaveTicket
Ticket * requestSaveTicket(Resource *resource=0)
Requests a ticket for saving the addressbook.
Definition: addressbook.cpp:488
TDEABC::AddressBook::asyncLoad
bool asyncLoad()
Loads all addressees asynchronously.
Definition: addressbook.cpp:354
TDEABC::AddressBook::save
bool save(Ticket *ticket)
Saves all addressees of one resource synchronously.
Definition: addressbook.cpp:373
TDEABC::AddressBook::findByUid
Addressee findByUid(const TQString &uid)
Searches an addressee with the specified unique identifier.
Definition: addressbook.cpp:569
TDEABC::Addressee
address book entry
Definition: addressee.src.h:75
TDEABC::Addressee::uid
TQString uid() const
Return unique identifier.
Definition: addressee.src.cpp:174
TDEABC::StdAddressBook
Standard KDE address book.
Definition: stdaddressbook.h:57
TDEABC::StdAddressBook::~StdAddressBook
~StdAddressBook()
Destructor.
Definition: stdaddressbook.cpp:89
TDEABC::StdAddressBook::automaticSave
static bool automaticSave()
Returns whether the address book is saved at destruction time.
Definition: stdaddressbook.cpp:183
TDEABC::StdAddressBook::setAutomaticSave
static void setAutomaticSave(bool state)
Sets the automatic save property of the address book.
Definition: stdaddressbook.cpp:178
TDEABC::StdAddressBook::save
static bool save() TDE_DEPRECATED
Saves the standard address book to disk.
Definition: stdaddressbook.cpp:163
TDEABC::StdAddressBook::fileName
static TQString fileName()
Returns the default file name for vcard-based addressbook.
Definition: stdaddressbook.cpp:43
TDEABC::StdAddressBook::setWhoAmI
void setWhoAmI(const Addressee &addr)
Sets the users contact.
Definition: stdaddressbook.cpp:197
TDEABC::StdAddressBook::handleCrash
static void handleCrash() TDE_DEPRECATED
Definition: stdaddressbook.cpp:53
TDEABC::StdAddressBook::close
static void close()
Closes the address book.
Definition: stdaddressbook.cpp:173
TDEABC::StdAddressBook::whoAmI
Addressee whoAmI()
Returns the contact, that is associated with the owner of the address book.
Definition: stdaddressbook.cpp:189
TDEABC::StdAddressBook::self
static StdAddressBook * self()
Returns the standard addressbook object.
Definition: stdaddressbook.cpp:57
TDEABC::StdAddressBook::directoryName
static TQString directoryName()
Returns the default directory name for vcard-based addressbook.
Definition: stdaddressbook.cpp:48
TDEABC::Ticket
Helper class for handling coordinated save of address books.
Definition: resource.h:38
TDEConfigBase::readEntry
TQString readEntry(const TQString &pKey, const TQString &aDefault=TQString::null) const
TDEConfigBase::writeEntry
void writeEntry(const TQString &pKey, const TQString &pValue, bool bPersistent=true, bool bGlobal=false, bool bNLS=false)
TDEConfigBase::setGroup
void setGroup(const TQString &group)
TDEConfig
endl
kndbgstream & endl(kndbgstream &s)
kdDebug
kdbgstream kdDebug(int area=0)
locateLocal
TQString locateLocal(const char *type, const TQString &filename, const TDEInstance *instance=TDEGlobal::instance())
TDEABC
static data, shared by ALL addressee objects
Definition: address.h:48
tdelocale.h

tdeabc

Skip menu "tdeabc"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

tdeabc

Skip menu "tdeabc"
  • arts
  • dcop
  • dnssd
  • interfaces
  •   kspeech
  •     interface
  •     library
  •   tdetexteditor
  • kate
  • kded
  • kdoctools
  • kimgio
  • kjs
  • libtdemid
  • libtdescreensaver
  • tdeabc
  • tdecmshell
  • tdecore
  • tdefx
  • tdehtml
  • tdeinit
  • tdeio
  •   bookmarks
  •   httpfilter
  •   kpasswdserver
  •   kssl
  •   tdefile
  •   tdeio
  •   tdeioexec
  • tdeioslave
  •   http
  • tdemdi
  •   tdemdi
  • tdenewstuff
  • tdeparts
  • tdeprint
  • tderandr
  • tderesources
  • tdespell2
  • tdesu
  • tdeui
  • tdeunittest
  • tdeutils
  • tdewallet
Generated for tdeabc by doxygen 1.9.1
This website is maintained by Timothy Pearson.