• 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 <tdestandarddirs.h>
30#include <kstaticdeleter.h>
31
32#include "resource.h"
33
34#include "stdaddressbook.h"
35
36using namespace TDEABC;
37
38StdAddressBook *StdAddressBook::mSelf = 0;
39bool StdAddressBook::mAutomaticSave = true;
40
41static KStaticDeleter<StdAddressBook> addressBookDeleter;
42
43TQString StdAddressBook::fileName()
44{
45 return locateLocal( "data", "tdeabc/std.vcf" );
46}
47
48TQString StdAddressBook::directoryName()
49{
50 return locateLocal( "data", "tdeabc/stdvcf" );
51}
52
53void StdAddressBook::handleCrash()
54{
55}
56
57StdAddressBook *StdAddressBook::self()
58{
59 if ( !mSelf )
60 addressBookDeleter.setObject( mSelf, new StdAddressBook );
61
62 return mSelf;
63}
64
65StdAddressBook *StdAddressBook::self( bool asynchronous )
66{
67 if ( !mSelf )
68 addressBookDeleter.setObject( mSelf, new StdAddressBook( asynchronous ) );
69
70 return mSelf;
71}
72
73StdAddressBook::StdAddressBook()
74 : AddressBook( "" )
75{
76 kdDebug(5700) << "StdAddressBook::StdAddressBook()" << endl;
77
78 init( false );
79}
80
81StdAddressBook::StdAddressBook( bool asynchronous )
82 : AddressBook( "" )
83{
84 kdDebug(5700) << "StdAddressBook::StdAddressBook( bool )" << endl;
85
86 init( asynchronous );
87}
88
89StdAddressBook::~StdAddressBook()
90{
91 if ( mAutomaticSave )
92 saveAll();
93}
94
95void 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
135bool 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
163bool StdAddressBook::save()
164{
165 kdDebug(5700) << "StdAddressBook::save()" << endl;
166
167 if ( mSelf )
168 return mSelf->saveAll();
169 else
170 return true;
171}
172
173void StdAddressBook::close()
174{
175 addressBookDeleter.destructObject();
176}
177
178void StdAddressBook::setAutomaticSave( bool enable )
179{
180 mAutomaticSave = enable;
181}
182
183bool StdAddressBook::automaticSave()
184{
185 return mAutomaticSave;
186}
187
188// should get const for 4.X
189Addressee StdAddressBook::whoAmI()
190{
191 TDEConfig config( "tdeabcrc" );
192 config.setGroup( "General" );
193
194 return findByUid( config.readEntry( "WhoAmI" ) );
195}
196
197void 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::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.4
This website is maintained by Timothy Pearson.