author | zautrix <zautrix> | 2004-09-18 14:22:10 (UTC) |
---|---|---|
committer | zautrix <zautrix> | 2004-09-18 14:22:10 (UTC) |
commit | ca8fcf3fd4dc068747d8f31e2189145b22853d55 (patch) (unidiff) | |
tree | 29417ffd55d1c4186922a64ed0cdf1c6a1cc69a3 /kabc | |
parent | bb16660f29fc709791aa0ee4cb63a40710a994a8 (diff) | |
download | kdepimpi-ca8fcf3fd4dc068747d8f31e2189145b22853d55.zip kdepimpi-ca8fcf3fd4dc068747d8f31e2189145b22853d55.tar.gz kdepimpi-ca8fcf3fd4dc068747d8f31e2189145b22853d55.tar.bz2 |
more AB sync
-rw-r--r-- | kabc/addressbook.cpp | 15 | ||||
-rw-r--r-- | kabc/addressbook.h | 3 |
2 files changed, 13 insertions, 5 deletions
diff --git a/kabc/addressbook.cpp b/kabc/addressbook.cpp index 9332e21..6e8d027 100644 --- a/kabc/addressbook.cpp +++ b/kabc/addressbook.cpp | |||
@@ -148,623 +148,630 @@ bool AddressBook::Iterator::operator!=( const Iterator &it ) | |||
148 | AddressBook::ConstIterator::ConstIterator() | 148 | AddressBook::ConstIterator::ConstIterator() |
149 | { | 149 | { |
150 | d = new ConstIteratorData; | 150 | d = new ConstIteratorData; |
151 | } | 151 | } |
152 | 152 | ||
153 | AddressBook::ConstIterator::ConstIterator( const AddressBook::ConstIterator &i ) | 153 | AddressBook::ConstIterator::ConstIterator( const AddressBook::ConstIterator &i ) |
154 | { | 154 | { |
155 | d = new ConstIteratorData; | 155 | d = new ConstIteratorData; |
156 | d->mIt = i.d->mIt; | 156 | d->mIt = i.d->mIt; |
157 | } | 157 | } |
158 | 158 | ||
159 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator=( const AddressBook::ConstIterator &i ) | 159 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator=( const AddressBook::ConstIterator &i ) |
160 | { | 160 | { |
161 | if( this == &i ) return *this; // guard for self assignment | 161 | if( this == &i ) return *this; // guard for self assignment |
162 | delete d; // delete the old data because the Iterator was really constructed before | 162 | delete d; // delete the old data because the Iterator was really constructed before |
163 | d = new ConstIteratorData; | 163 | d = new ConstIteratorData; |
164 | d->mIt = i.d->mIt; | 164 | d->mIt = i.d->mIt; |
165 | return *this; | 165 | return *this; |
166 | } | 166 | } |
167 | 167 | ||
168 | AddressBook::ConstIterator::~ConstIterator() | 168 | AddressBook::ConstIterator::~ConstIterator() |
169 | { | 169 | { |
170 | delete d; | 170 | delete d; |
171 | } | 171 | } |
172 | 172 | ||
173 | const Addressee &AddressBook::ConstIterator::operator*() const | 173 | const Addressee &AddressBook::ConstIterator::operator*() const |
174 | { | 174 | { |
175 | return *(d->mIt); | 175 | return *(d->mIt); |
176 | } | 176 | } |
177 | 177 | ||
178 | const Addressee* AddressBook::ConstIterator::operator->() const | 178 | const Addressee* AddressBook::ConstIterator::operator->() const |
179 | { | 179 | { |
180 | return &(*(d->mIt)); | 180 | return &(*(d->mIt)); |
181 | } | 181 | } |
182 | 182 | ||
183 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator++() | 183 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator++() |
184 | { | 184 | { |
185 | (d->mIt)++; | 185 | (d->mIt)++; |
186 | return *this; | 186 | return *this; |
187 | } | 187 | } |
188 | 188 | ||
189 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator++(int) | 189 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator++(int) |
190 | { | 190 | { |
191 | (d->mIt)++; | 191 | (d->mIt)++; |
192 | return *this; | 192 | return *this; |
193 | } | 193 | } |
194 | 194 | ||
195 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator--() | 195 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator--() |
196 | { | 196 | { |
197 | (d->mIt)--; | 197 | (d->mIt)--; |
198 | return *this; | 198 | return *this; |
199 | } | 199 | } |
200 | 200 | ||
201 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator--(int) | 201 | AddressBook::ConstIterator &AddressBook::ConstIterator::operator--(int) |
202 | { | 202 | { |
203 | (d->mIt)--; | 203 | (d->mIt)--; |
204 | return *this; | 204 | return *this; |
205 | } | 205 | } |
206 | 206 | ||
207 | bool AddressBook::ConstIterator::operator==( const ConstIterator &it ) | 207 | bool AddressBook::ConstIterator::operator==( const ConstIterator &it ) |
208 | { | 208 | { |
209 | return ( d->mIt == it.d->mIt ); | 209 | return ( d->mIt == it.d->mIt ); |
210 | } | 210 | } |
211 | 211 | ||
212 | bool AddressBook::ConstIterator::operator!=( const ConstIterator &it ) | 212 | bool AddressBook::ConstIterator::operator!=( const ConstIterator &it ) |
213 | { | 213 | { |
214 | return ( d->mIt != it.d->mIt ); | 214 | return ( d->mIt != it.d->mIt ); |
215 | } | 215 | } |
216 | 216 | ||
217 | 217 | ||
218 | AddressBook::AddressBook() | 218 | AddressBook::AddressBook() |
219 | { | 219 | { |
220 | init(0, "contact"); | 220 | init(0, "contact"); |
221 | } | 221 | } |
222 | 222 | ||
223 | AddressBook::AddressBook( const QString &config ) | 223 | AddressBook::AddressBook( const QString &config ) |
224 | { | 224 | { |
225 | init(config, "contact"); | 225 | init(config, "contact"); |
226 | } | 226 | } |
227 | 227 | ||
228 | AddressBook::AddressBook( const QString &config, const QString &family ) | 228 | AddressBook::AddressBook( const QString &config, const QString &family ) |
229 | { | 229 | { |
230 | init(config, family); | 230 | init(config, family); |
231 | 231 | ||
232 | } | 232 | } |
233 | 233 | ||
234 | // the default family is "contact" | 234 | // the default family is "contact" |
235 | void AddressBook::init(const QString &config, const QString &family ) | 235 | void AddressBook::init(const QString &config, const QString &family ) |
236 | { | 236 | { |
237 | d = new AddressBookData; | 237 | d = new AddressBookData; |
238 | QString fami = family; | 238 | QString fami = family; |
239 | qDebug("new ab "); | 239 | qDebug("new ab "); |
240 | if (config != 0) { | 240 | if (config != 0) { |
241 | qDebug("config != 0 "); | 241 | qDebug("config != 0 "); |
242 | if ( family == "syncContact" ) { | 242 | if ( family == "syncContact" ) { |
243 | qDebug("creating sync config "); | 243 | qDebug("creating sync config "); |
244 | fami = "contact"; | 244 | fami = "contact"; |
245 | KConfig* con = new KConfig( locateLocal("config", "syncContactrc") ); | 245 | KConfig* con = new KConfig( locateLocal("config", "syncContactrc") ); |
246 | con->setGroup( "General" ); | 246 | con->setGroup( "General" ); |
247 | con->writeEntry( "ResourceKeys", QString("sync") ); | 247 | con->writeEntry( "ResourceKeys", QString("sync") ); |
248 | con->writeEntry( "Standard", QString("sync") ); | 248 | con->writeEntry( "Standard", QString("sync") ); |
249 | con->setGroup( "Resource_sync" ); | 249 | con->setGroup( "Resource_sync" ); |
250 | con->writeEntry( "FileFormat", QString("vcard") ); | 250 | con->writeEntry( "FileFormat", QString("vcard") ); |
251 | con->writeEntry( "FileName", config ); | 251 | con->writeEntry( "FileName", config ); |
252 | con->writeEntry( "ResourceIdentifier", QString("sync") ); | 252 | con->writeEntry( "ResourceIdentifier", QString("sync") ); |
253 | con->writeEntry( "ResourceName", QString("sync_res") ); | 253 | con->writeEntry( "ResourceName", QString("sync_res") ); |
254 | con->writeEntry( "ResourceType", QString("file") ); | 254 | con->writeEntry( "ResourceType", QString("file") ); |
255 | //con->sync(); | 255 | //con->sync(); |
256 | d->mConfig = con; | 256 | d->mConfig = con; |
257 | } | 257 | } |
258 | else | 258 | else |
259 | d->mConfig = new KConfig( locateLocal("config", config) ); | 259 | d->mConfig = new KConfig( locateLocal("config", config) ); |
260 | // qDebug("AddressBook::init 1 config=%s",config.latin1() ); | 260 | // qDebug("AddressBook::init 1 config=%s",config.latin1() ); |
261 | } | 261 | } |
262 | else { | 262 | else { |
263 | d->mConfig = 0; | 263 | d->mConfig = 0; |
264 | // qDebug("AddressBook::init 1 config=0"); | 264 | // qDebug("AddressBook::init 1 config=0"); |
265 | } | 265 | } |
266 | 266 | ||
267 | //US d->mErrorHandler = 0; | 267 | //US d->mErrorHandler = 0; |
268 | d->mManager = new KRES::Manager<Resource>( fami, false ); | 268 | d->mManager = new KRES::Manager<Resource>( fami, false ); |
269 | d->mManager->readConfig( d->mConfig ); | 269 | d->mManager->readConfig( d->mConfig ); |
270 | if ( family == "syncContact" ) { | 270 | if ( family == "syncContact" ) { |
271 | KRES::Manager<Resource> *manager = d->mManager; | 271 | KRES::Manager<Resource> *manager = d->mManager; |
272 | KRES::Manager<Resource>::ActiveIterator it; | 272 | KRES::Manager<Resource>::ActiveIterator it; |
273 | for ( it = manager->activeBegin(); it != manager->activeEnd(); ++it ) { | 273 | for ( it = manager->activeBegin(); it != manager->activeEnd(); ++it ) { |
274 | (*it)->setAddressBook( this ); | 274 | (*it)->setAddressBook( this ); |
275 | if ( !(*it)->open() ) | 275 | if ( !(*it)->open() ) |
276 | error( QString( "Unable to open resource '%1'!" ).arg( (*it)->resourceName() ) ); | 276 | error( QString( "Unable to open resource '%1'!" ).arg( (*it)->resourceName() ) ); |
277 | } | 277 | } |
278 | Resource *res = standardResource(); | 278 | Resource *res = standardResource(); |
279 | if ( !res ) { | 279 | if ( !res ) { |
280 | qDebug("ERROR: no standard resource"); | 280 | qDebug("ERROR: no standard resource"); |
281 | res = manager->createResource( "file" ); | 281 | res = manager->createResource( "file" ); |
282 | if ( res ) | 282 | if ( res ) |
283 | { | 283 | { |
284 | addResource( res ); | 284 | addResource( res ); |
285 | } | 285 | } |
286 | else | 286 | else |
287 | qDebug(" No resource available!!!"); | 287 | qDebug(" No resource available!!!"); |
288 | } | 288 | } |
289 | setStandardResource( res ); | 289 | setStandardResource( res ); |
290 | manager->writeConfig(); | 290 | manager->writeConfig(); |
291 | } | 291 | } |
292 | addCustomField( i18n( "Department" ), KABC::Field::Organization, | 292 | addCustomField( i18n( "Department" ), KABC::Field::Organization, |
293 | "X-Department", "KADDRESSBOOK" ); | 293 | "X-Department", "KADDRESSBOOK" ); |
294 | addCustomField( i18n( "Profession" ), KABC::Field::Organization, | 294 | addCustomField( i18n( "Profession" ), KABC::Field::Organization, |
295 | "X-Profession", "KADDRESSBOOK" ); | 295 | "X-Profession", "KADDRESSBOOK" ); |
296 | addCustomField( i18n( "Assistant's Name" ), KABC::Field::Organization, | 296 | addCustomField( i18n( "Assistant's Name" ), KABC::Field::Organization, |
297 | "X-AssistantsName", "KADDRESSBOOK" ); | 297 | "X-AssistantsName", "KADDRESSBOOK" ); |
298 | addCustomField( i18n( "Manager's Name" ), KABC::Field::Organization, | 298 | addCustomField( i18n( "Manager's Name" ), KABC::Field::Organization, |
299 | "X-ManagersName", "KADDRESSBOOK" ); | 299 | "X-ManagersName", "KADDRESSBOOK" ); |
300 | addCustomField( i18n( "Spouse's Name" ), KABC::Field::Personal, | 300 | addCustomField( i18n( "Spouse's Name" ), KABC::Field::Personal, |
301 | "X-SpousesName", "KADDRESSBOOK" ); | 301 | "X-SpousesName", "KADDRESSBOOK" ); |
302 | addCustomField( i18n( "Office" ), KABC::Field::Personal, | 302 | addCustomField( i18n( "Office" ), KABC::Field::Personal, |
303 | "X-Office", "KADDRESSBOOK" ); | 303 | "X-Office", "KADDRESSBOOK" ); |
304 | addCustomField( i18n( "IM Address" ), KABC::Field::Personal, | 304 | addCustomField( i18n( "IM Address" ), KABC::Field::Personal, |
305 | "X-IMAddress", "KADDRESSBOOK" ); | 305 | "X-IMAddress", "KADDRESSBOOK" ); |
306 | addCustomField( i18n( "Anniversary" ), KABC::Field::Personal, | 306 | addCustomField( i18n( "Anniversary" ), KABC::Field::Personal, |
307 | "X-Anniversary", "KADDRESSBOOK" ); | 307 | "X-Anniversary", "KADDRESSBOOK" ); |
308 | 308 | ||
309 | //US added this field to become compatible with Opie/qtopia addressbook | 309 | //US added this field to become compatible with Opie/qtopia addressbook |
310 | // values can be "female" or "male" or "". An empty field represents undefined. | 310 | // values can be "female" or "male" or "". An empty field represents undefined. |
311 | addCustomField( i18n( "Gender" ), KABC::Field::Personal, | 311 | addCustomField( i18n( "Gender" ), KABC::Field::Personal, |
312 | "X-Gender", "KADDRESSBOOK" ); | 312 | "X-Gender", "KADDRESSBOOK" ); |
313 | addCustomField( i18n( "Children" ), KABC::Field::Personal, | 313 | addCustomField( i18n( "Children" ), KABC::Field::Personal, |
314 | "X-Children", "KADDRESSBOOK" ); | 314 | "X-Children", "KADDRESSBOOK" ); |
315 | addCustomField( i18n( "FreeBusyUrl" ), KABC::Field::Personal, | 315 | addCustomField( i18n( "FreeBusyUrl" ), KABC::Field::Personal, |
316 | "X-FreeBusyUrl", "KADDRESSBOOK" ); | 316 | "X-FreeBusyUrl", "KADDRESSBOOK" ); |
317 | addCustomField( i18n( "ExternalID" ), KABC::Field::Personal, | 317 | addCustomField( i18n( "ExternalID" ), KABC::Field::Personal, |
318 | "X-ExternalID", "KADDRESSBOOK" ); | 318 | "X-ExternalID", "KADDRESSBOOK" ); |
319 | } | 319 | } |
320 | 320 | ||
321 | AddressBook::~AddressBook() | 321 | AddressBook::~AddressBook() |
322 | { | 322 | { |
323 | delete d->mConfig; d->mConfig = 0; | 323 | delete d->mConfig; d->mConfig = 0; |
324 | delete d->mManager; d->mManager = 0; | 324 | delete d->mManager; d->mManager = 0; |
325 | //US delete d->mErrorHandler; d->mErrorHandler = 0; | 325 | //US delete d->mErrorHandler; d->mErrorHandler = 0; |
326 | delete d; d = 0; | 326 | delete d; d = 0; |
327 | } | 327 | } |
328 | 328 | ||
329 | bool AddressBook::load() | 329 | bool AddressBook::load() |
330 | { | 330 | { |
331 | 331 | ||
332 | 332 | ||
333 | clear(); | 333 | clear(); |
334 | 334 | ||
335 | KRES::Manager<Resource>::ActiveIterator it; | 335 | KRES::Manager<Resource>::ActiveIterator it; |
336 | bool ok = true; | 336 | bool ok = true; |
337 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) | 337 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) |
338 | if ( !(*it)->load() ) { | 338 | if ( !(*it)->load() ) { |
339 | error( i18n("Unable to load resource '%1'").arg( (*it)->resourceName() ) ); | 339 | error( i18n("Unable to load resource '%1'").arg( (*it)->resourceName() ) ); |
340 | ok = false; | 340 | ok = false; |
341 | } | 341 | } |
342 | 342 | ||
343 | // mark all addressees as unchanged | 343 | // mark all addressees as unchanged |
344 | Addressee::List::Iterator addrIt; | 344 | Addressee::List::Iterator addrIt; |
345 | for ( addrIt = d->mAddressees.begin(); addrIt != d->mAddressees.end(); ++addrIt ) | 345 | for ( addrIt = d->mAddressees.begin(); addrIt != d->mAddressees.end(); ++addrIt ) |
346 | (*addrIt).setChanged( false ); | 346 | (*addrIt).setChanged( false ); |
347 | 347 | ||
348 | return ok; | 348 | return ok; |
349 | } | 349 | } |
350 | 350 | ||
351 | bool AddressBook::save( Ticket *ticket ) | 351 | bool AddressBook::save( Ticket *ticket ) |
352 | { | 352 | { |
353 | kdDebug(5700) << "AddressBook::save()"<< endl; | 353 | kdDebug(5700) << "AddressBook::save()"<< endl; |
354 | 354 | ||
355 | if ( ticket->resource() ) { | 355 | if ( ticket->resource() ) { |
356 | deleteRemovedAddressees(); | 356 | deleteRemovedAddressees(); |
357 | return ticket->resource()->save( ticket ); | 357 | return ticket->resource()->save( ticket ); |
358 | } | 358 | } |
359 | 359 | ||
360 | return false; | 360 | return false; |
361 | } | 361 | } |
362 | bool AddressBook::saveAB() | 362 | bool AddressBook::saveAB() |
363 | { | 363 | { |
364 | bool ok = true; | 364 | bool ok = true; |
365 | 365 | ||
366 | deleteRemovedAddressees(); | 366 | deleteRemovedAddressees(); |
367 | 367 | ||
368 | KRES::Manager<Resource>::ActiveIterator it; | 368 | KRES::Manager<Resource>::ActiveIterator it; |
369 | KRES::Manager<Resource> *manager = d->mManager; | 369 | KRES::Manager<Resource> *manager = d->mManager; |
370 | for ( it = manager->activeBegin(); it != manager->activeEnd(); ++it ) { | 370 | for ( it = manager->activeBegin(); it != manager->activeEnd(); ++it ) { |
371 | if ( !(*it)->readOnly() && (*it)->isOpen() ) { | 371 | if ( !(*it)->readOnly() && (*it)->isOpen() ) { |
372 | Ticket *ticket = requestSaveTicket( *it ); | 372 | Ticket *ticket = requestSaveTicket( *it ); |
373 | // qDebug("StdAddressBook::save '%s'", (*it)->resourceName().latin1() ); | 373 | // qDebug("StdAddressBook::save '%s'", (*it)->resourceName().latin1() ); |
374 | if ( !ticket ) { | 374 | if ( !ticket ) { |
375 | error( i18n( "Unable to save to resource '%1'. It is locked." ) | 375 | error( i18n( "Unable to save to resource '%1'. It is locked." ) |
376 | .arg( (*it)->resourceName() ) ); | 376 | .arg( (*it)->resourceName() ) ); |
377 | return false; | 377 | return false; |
378 | } | 378 | } |
379 | 379 | ||
380 | //if ( !save( ticket ) ) | 380 | //if ( !save( ticket ) ) |
381 | if ( ticket->resource() ) { | 381 | if ( ticket->resource() ) { |
382 | if ( ! ticket->resource()->save( ticket ) ) | 382 | if ( ! ticket->resource()->save( ticket ) ) |
383 | ok = false; | 383 | ok = false; |
384 | } else | 384 | } else |
385 | ok = false; | 385 | ok = false; |
386 | 386 | ||
387 | } | 387 | } |
388 | } | 388 | } |
389 | return ok; | 389 | return ok; |
390 | } | 390 | } |
391 | 391 | ||
392 | AddressBook::Iterator AddressBook::begin() | 392 | AddressBook::Iterator AddressBook::begin() |
393 | { | 393 | { |
394 | Iterator it = Iterator(); | 394 | Iterator it = Iterator(); |
395 | it.d->mIt = d->mAddressees.begin(); | 395 | it.d->mIt = d->mAddressees.begin(); |
396 | return it; | 396 | return it; |
397 | } | 397 | } |
398 | 398 | ||
399 | AddressBook::ConstIterator AddressBook::begin() const | 399 | AddressBook::ConstIterator AddressBook::begin() const |
400 | { | 400 | { |
401 | ConstIterator it = ConstIterator(); | 401 | ConstIterator it = ConstIterator(); |
402 | it.d->mIt = d->mAddressees.begin(); | 402 | it.d->mIt = d->mAddressees.begin(); |
403 | return it; | 403 | return it; |
404 | } | 404 | } |
405 | 405 | ||
406 | AddressBook::Iterator AddressBook::end() | 406 | AddressBook::Iterator AddressBook::end() |
407 | { | 407 | { |
408 | Iterator it = Iterator(); | 408 | Iterator it = Iterator(); |
409 | it.d->mIt = d->mAddressees.end(); | 409 | it.d->mIt = d->mAddressees.end(); |
410 | return it; | 410 | return it; |
411 | } | 411 | } |
412 | 412 | ||
413 | AddressBook::ConstIterator AddressBook::end() const | 413 | AddressBook::ConstIterator AddressBook::end() const |
414 | { | 414 | { |
415 | ConstIterator it = ConstIterator(); | 415 | ConstIterator it = ConstIterator(); |
416 | it.d->mIt = d->mAddressees.end(); | 416 | it.d->mIt = d->mAddressees.end(); |
417 | return it; | 417 | return it; |
418 | } | 418 | } |
419 | 419 | ||
420 | void AddressBook::clear() | 420 | void AddressBook::clear() |
421 | { | 421 | { |
422 | d->mAddressees.clear(); | 422 | d->mAddressees.clear(); |
423 | } | 423 | } |
424 | 424 | ||
425 | Ticket *AddressBook::requestSaveTicket( Resource *resource ) | 425 | Ticket *AddressBook::requestSaveTicket( Resource *resource ) |
426 | { | 426 | { |
427 | kdDebug(5700) << "AddressBook::requestSaveTicket()" << endl; | 427 | kdDebug(5700) << "AddressBook::requestSaveTicket()" << endl; |
428 | 428 | ||
429 | if ( !resource ) | 429 | if ( !resource ) |
430 | { | 430 | { |
431 | qDebug("AddressBook::requestSaveTicket no resource" ); | 431 | qDebug("AddressBook::requestSaveTicket no resource" ); |
432 | resource = standardResource(); | 432 | resource = standardResource(); |
433 | } | 433 | } |
434 | 434 | ||
435 | KRES::Manager<Resource>::ActiveIterator it; | 435 | KRES::Manager<Resource>::ActiveIterator it; |
436 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) { | 436 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) { |
437 | if ( (*it) == resource ) { | 437 | if ( (*it) == resource ) { |
438 | if ( (*it)->readOnly() || !(*it)->isOpen() ) | 438 | if ( (*it)->readOnly() || !(*it)->isOpen() ) |
439 | return 0; | 439 | return 0; |
440 | else | 440 | else |
441 | return (*it)->requestSaveTicket(); | 441 | return (*it)->requestSaveTicket(); |
442 | } | 442 | } |
443 | } | 443 | } |
444 | 444 | ||
445 | return 0; | 445 | return 0; |
446 | } | 446 | } |
447 | 447 | ||
448 | void AddressBook::insertAddressee( const Addressee &a ) | 448 | void AddressBook::insertAddressee( const Addressee &a ) |
449 | { | 449 | { |
450 | Addressee::List::Iterator it; | 450 | Addressee::List::Iterator it; |
451 | for ( it = d->mAddressees.begin(); it != d->mAddressees.end(); ++it ) { | 451 | for ( it = d->mAddressees.begin(); it != d->mAddressees.end(); ++it ) { |
452 | if ( a.uid() == (*it).uid() ) { | 452 | if ( a.uid() == (*it).uid() ) { |
453 | bool changed = false; | 453 | bool changed = false; |
454 | Addressee addr = a; | 454 | Addressee addr = a; |
455 | if ( addr != (*it) ) | 455 | if ( addr != (*it) ) |
456 | changed = true; | 456 | changed = true; |
457 | 457 | ||
458 | (*it) = a; | 458 | (*it) = a; |
459 | if ( (*it).resource() == 0 ) | 459 | if ( (*it).resource() == 0 ) |
460 | (*it).setResource( standardResource() ); | 460 | (*it).setResource( standardResource() ); |
461 | 461 | ||
462 | if ( changed ) { | 462 | if ( changed ) { |
463 | (*it).setRevision( QDateTime::currentDateTime() ); | 463 | (*it).setRevision( QDateTime::currentDateTime() ); |
464 | (*it).setChanged( true ); | 464 | (*it).setChanged( true ); |
465 | } | 465 | } |
466 | 466 | ||
467 | return; | 467 | return; |
468 | } | 468 | } |
469 | } | 469 | } |
470 | d->mAddressees.append( a ); | 470 | d->mAddressees.append( a ); |
471 | Addressee& addr = d->mAddressees.last(); | 471 | Addressee& addr = d->mAddressees.last(); |
472 | if ( addr.resource() == 0 ) | 472 | if ( addr.resource() == 0 ) |
473 | addr.setResource( standardResource() ); | 473 | addr.setResource( standardResource() ); |
474 | 474 | ||
475 | addr.setChanged( true ); | 475 | addr.setChanged( true ); |
476 | } | 476 | } |
477 | 477 | ||
478 | void AddressBook::removeAddressee( const Addressee &a ) | 478 | void AddressBook::removeAddressee( const Addressee &a ) |
479 | { | 479 | { |
480 | Iterator it; | 480 | Iterator it; |
481 | for ( it = begin(); it != end(); ++it ) { | 481 | for ( it = begin(); it != end(); ++it ) { |
482 | if ( a.uid() == (*it).uid() ) { | 482 | if ( a.uid() == (*it).uid() ) { |
483 | removeAddressee( it ); | 483 | removeAddressee( it ); |
484 | return; | 484 | return; |
485 | } | 485 | } |
486 | } | 486 | } |
487 | } | 487 | } |
488 | 488 | ||
489 | void AddressBook::removeAddressee( const Iterator &it ) | 489 | void AddressBook::removeAddressee( const Iterator &it ) |
490 | { | 490 | { |
491 | d->mRemovedAddressees.append( (*it) ); | 491 | d->mRemovedAddressees.append( (*it) ); |
492 | d->mAddressees.remove( it.d->mIt ); | 492 | d->mAddressees.remove( it.d->mIt ); |
493 | } | 493 | } |
494 | 494 | ||
495 | AddressBook::Iterator AddressBook::find( const Addressee &a ) | 495 | AddressBook::Iterator AddressBook::find( const Addressee &a ) |
496 | { | 496 | { |
497 | Iterator it; | 497 | Iterator it; |
498 | for ( it = begin(); it != end(); ++it ) { | 498 | for ( it = begin(); it != end(); ++it ) { |
499 | if ( a.uid() == (*it).uid() ) { | 499 | if ( a.uid() == (*it).uid() ) { |
500 | return it; | 500 | return it; |
501 | } | 501 | } |
502 | } | 502 | } |
503 | return end(); | 503 | return end(); |
504 | } | 504 | } |
505 | 505 | ||
506 | Addressee AddressBook::findByUid( const QString &uid ) | 506 | Addressee AddressBook::findByUid( const QString &uid ) |
507 | { | 507 | { |
508 | Iterator it; | 508 | Iterator it; |
509 | for ( it = begin(); it != end(); ++it ) { | 509 | for ( it = begin(); it != end(); ++it ) { |
510 | if ( uid == (*it).uid() ) { | 510 | if ( uid == (*it).uid() ) { |
511 | return *it; | 511 | return *it; |
512 | } | 512 | } |
513 | } | 513 | } |
514 | return Addressee(); | 514 | return Addressee(); |
515 | } | 515 | } |
516 | Addressee::List AddressBook::getExternLastSyncAddressees() | 516 | Addressee::List AddressBook::getExternLastSyncAddressees() |
517 | { | 517 | { |
518 | Addressee::List results; | 518 | Addressee::List results; |
519 | 519 | ||
520 | Iterator it; | 520 | Iterator it; |
521 | for ( it = begin(); it != end(); ++it ) { | 521 | for ( it = begin(); it != end(); ++it ) { |
522 | if ( (*it).uid().left( 20 ) == "last-syncAddressee-" ) { | 522 | if ( (*it).uid().left( 20 ) == "last-syncAddressee-" ) { |
523 | if ( (*it).familyName().left(3) == "E: " ) | 523 | if ( (*it).familyName().left(3) == "E: " ) |
524 | results.append( *it ); | 524 | results.append( *it ); |
525 | } | 525 | } |
526 | } | 526 | } |
527 | 527 | ||
528 | return results; | 528 | return results; |
529 | } | 529 | } |
530 | void AddressBook::resetTempSyncStat() | 530 | void AddressBook::resetTempSyncStat() |
531 | { | 531 | { |
532 | 532 | Iterator it; | |
533 | |||
534 | Iterator it; | ||
535 | for ( it = begin(); it != end(); ++it ) { | 533 | for ( it = begin(); it != end(); ++it ) { |
536 | (*it).setTempSyncStat ( SYNC_TEMPSTATE_INITIAL ); | 534 | (*it).setTempSyncStat ( SYNC_TEMPSTATE_INITIAL ); |
537 | } | 535 | } |
538 | 536 | ||
539 | } | 537 | } |
540 | 538 | ||
539 | QStringList AddressBook:: uidList() | ||
540 | { | ||
541 | QStringList results; | ||
542 | Iterator it; | ||
543 | for ( it = begin(); it != end(); ++it ) { | ||
544 | results.append( (*it).uid() ); | ||
545 | } | ||
546 | return results; | ||
547 | } | ||
541 | 548 | ||
542 | 549 | ||
543 | Addressee::List AddressBook::allAddressees() | 550 | Addressee::List AddressBook::allAddressees() |
544 | { | 551 | { |
545 | return d->mAddressees; | 552 | return d->mAddressees; |
546 | } | 553 | } |
547 | 554 | ||
548 | Addressee::List AddressBook::findByName( const QString &name ) | 555 | Addressee::List AddressBook::findByName( const QString &name ) |
549 | { | 556 | { |
550 | Addressee::List results; | 557 | Addressee::List results; |
551 | 558 | ||
552 | Iterator it; | 559 | Iterator it; |
553 | for ( it = begin(); it != end(); ++it ) { | 560 | for ( it = begin(); it != end(); ++it ) { |
554 | if ( name == (*it).realName() ) { | 561 | if ( name == (*it).realName() ) { |
555 | results.append( *it ); | 562 | results.append( *it ); |
556 | } | 563 | } |
557 | } | 564 | } |
558 | 565 | ||
559 | return results; | 566 | return results; |
560 | } | 567 | } |
561 | 568 | ||
562 | Addressee::List AddressBook::findByEmail( const QString &email ) | 569 | Addressee::List AddressBook::findByEmail( const QString &email ) |
563 | { | 570 | { |
564 | Addressee::List results; | 571 | Addressee::List results; |
565 | QStringList mailList; | 572 | QStringList mailList; |
566 | 573 | ||
567 | Iterator it; | 574 | Iterator it; |
568 | for ( it = begin(); it != end(); ++it ) { | 575 | for ( it = begin(); it != end(); ++it ) { |
569 | mailList = (*it).emails(); | 576 | mailList = (*it).emails(); |
570 | for ( QStringList::Iterator ite = mailList.begin(); ite != mailList.end(); ++ite ) { | 577 | for ( QStringList::Iterator ite = mailList.begin(); ite != mailList.end(); ++ite ) { |
571 | if ( email == (*ite) ) { | 578 | if ( email == (*ite) ) { |
572 | results.append( *it ); | 579 | results.append( *it ); |
573 | } | 580 | } |
574 | } | 581 | } |
575 | } | 582 | } |
576 | 583 | ||
577 | return results; | 584 | return results; |
578 | } | 585 | } |
579 | 586 | ||
580 | Addressee::List AddressBook::findByCategory( const QString &category ) | 587 | Addressee::List AddressBook::findByCategory( const QString &category ) |
581 | { | 588 | { |
582 | Addressee::List results; | 589 | Addressee::List results; |
583 | 590 | ||
584 | Iterator it; | 591 | Iterator it; |
585 | for ( it = begin(); it != end(); ++it ) { | 592 | for ( it = begin(); it != end(); ++it ) { |
586 | if ( (*it).hasCategory( category) ) { | 593 | if ( (*it).hasCategory( category) ) { |
587 | results.append( *it ); | 594 | results.append( *it ); |
588 | } | 595 | } |
589 | } | 596 | } |
590 | 597 | ||
591 | return results; | 598 | return results; |
592 | } | 599 | } |
593 | 600 | ||
594 | void AddressBook::dump() const | 601 | void AddressBook::dump() const |
595 | { | 602 | { |
596 | kdDebug(5700) << "AddressBook::dump() --- begin ---" << endl; | 603 | kdDebug(5700) << "AddressBook::dump() --- begin ---" << endl; |
597 | 604 | ||
598 | ConstIterator it; | 605 | ConstIterator it; |
599 | for( it = begin(); it != end(); ++it ) { | 606 | for( it = begin(); it != end(); ++it ) { |
600 | (*it).dump(); | 607 | (*it).dump(); |
601 | } | 608 | } |
602 | 609 | ||
603 | kdDebug(5700) << "AddressBook::dump() --- end ---" << endl; | 610 | kdDebug(5700) << "AddressBook::dump() --- end ---" << endl; |
604 | } | 611 | } |
605 | 612 | ||
606 | QString AddressBook::identifier() | 613 | QString AddressBook::identifier() |
607 | { | 614 | { |
608 | QStringList identifier; | 615 | QStringList identifier; |
609 | 616 | ||
610 | 617 | ||
611 | KRES::Manager<Resource>::ActiveIterator it; | 618 | KRES::Manager<Resource>::ActiveIterator it; |
612 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) { | 619 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) { |
613 | if ( !(*it)->identifier().isEmpty() ) | 620 | if ( !(*it)->identifier().isEmpty() ) |
614 | identifier.append( (*it)->identifier() ); | 621 | identifier.append( (*it)->identifier() ); |
615 | } | 622 | } |
616 | 623 | ||
617 | return identifier.join( ":" ); | 624 | return identifier.join( ":" ); |
618 | } | 625 | } |
619 | 626 | ||
620 | Field::List AddressBook::fields( int category ) | 627 | Field::List AddressBook::fields( int category ) |
621 | { | 628 | { |
622 | if ( d->mAllFields.isEmpty() ) { | 629 | if ( d->mAllFields.isEmpty() ) { |
623 | d->mAllFields = Field::allFields(); | 630 | d->mAllFields = Field::allFields(); |
624 | } | 631 | } |
625 | 632 | ||
626 | if ( category == Field::All ) return d->mAllFields; | 633 | if ( category == Field::All ) return d->mAllFields; |
627 | 634 | ||
628 | Field::List result; | 635 | Field::List result; |
629 | Field::List::ConstIterator it; | 636 | Field::List::ConstIterator it; |
630 | for( it = d->mAllFields.begin(); it != d->mAllFields.end(); ++it ) { | 637 | for( it = d->mAllFields.begin(); it != d->mAllFields.end(); ++it ) { |
631 | if ( (*it)->category() & category ) result.append( *it ); | 638 | if ( (*it)->category() & category ) result.append( *it ); |
632 | } | 639 | } |
633 | 640 | ||
634 | return result; | 641 | return result; |
635 | } | 642 | } |
636 | 643 | ||
637 | bool AddressBook::addCustomField( const QString &label, int category, | 644 | bool AddressBook::addCustomField( const QString &label, int category, |
638 | const QString &key, const QString &app ) | 645 | const QString &key, const QString &app ) |
639 | { | 646 | { |
640 | if ( d->mAllFields.isEmpty() ) { | 647 | if ( d->mAllFields.isEmpty() ) { |
641 | d->mAllFields = Field::allFields(); | 648 | d->mAllFields = Field::allFields(); |
642 | } | 649 | } |
643 | //US QString a = app.isNull() ? KGlobal::instance()->instanceName() : app; | 650 | //US QString a = app.isNull() ? KGlobal::instance()->instanceName() : app; |
644 | QString a = app.isNull() ? KGlobal::getAppName() : app; | 651 | QString a = app.isNull() ? KGlobal::getAppName() : app; |
645 | 652 | ||
646 | QString k = key.isNull() ? label : key; | 653 | QString k = key.isNull() ? label : key; |
647 | 654 | ||
648 | Field *field = Field::createCustomField( label, category, k, a ); | 655 | Field *field = Field::createCustomField( label, category, k, a ); |
649 | 656 | ||
650 | if ( !field ) return false; | 657 | if ( !field ) return false; |
651 | 658 | ||
652 | d->mAllFields.append( field ); | 659 | d->mAllFields.append( field ); |
653 | 660 | ||
654 | return true; | 661 | return true; |
655 | } | 662 | } |
656 | 663 | ||
657 | QDataStream &KABC::operator<<( QDataStream &s, const AddressBook &ab ) | 664 | QDataStream &KABC::operator<<( QDataStream &s, const AddressBook &ab ) |
658 | { | 665 | { |
659 | if (!ab.d) return s; | 666 | if (!ab.d) return s; |
660 | 667 | ||
661 | return s << ab.d->mAddressees; | 668 | return s << ab.d->mAddressees; |
662 | } | 669 | } |
663 | 670 | ||
664 | QDataStream &KABC::operator>>( QDataStream &s, AddressBook &ab ) | 671 | QDataStream &KABC::operator>>( QDataStream &s, AddressBook &ab ) |
665 | { | 672 | { |
666 | if (!ab.d) return s; | 673 | if (!ab.d) return s; |
667 | 674 | ||
668 | s >> ab.d->mAddressees; | 675 | s >> ab.d->mAddressees; |
669 | 676 | ||
670 | return s; | 677 | return s; |
671 | } | 678 | } |
672 | 679 | ||
673 | bool AddressBook::addResource( Resource *resource ) | 680 | bool AddressBook::addResource( Resource *resource ) |
674 | { | 681 | { |
675 | if ( !resource->open() ) { | 682 | if ( !resource->open() ) { |
676 | kdDebug(5700) << "AddressBook::addResource(): can't add resource" << endl; | 683 | kdDebug(5700) << "AddressBook::addResource(): can't add resource" << endl; |
677 | return false; | 684 | return false; |
678 | } | 685 | } |
679 | 686 | ||
680 | resource->setAddressBook( this ); | 687 | resource->setAddressBook( this ); |
681 | 688 | ||
682 | d->mManager->add( resource ); | 689 | d->mManager->add( resource ); |
683 | return true; | 690 | return true; |
684 | } | 691 | } |
685 | 692 | ||
686 | bool AddressBook::removeResource( Resource *resource ) | 693 | bool AddressBook::removeResource( Resource *resource ) |
687 | { | 694 | { |
688 | resource->close(); | 695 | resource->close(); |
689 | 696 | ||
690 | if ( resource == standardResource() ) | 697 | if ( resource == standardResource() ) |
691 | d->mManager->setStandardResource( 0 ); | 698 | d->mManager->setStandardResource( 0 ); |
692 | 699 | ||
693 | resource->setAddressBook( 0 ); | 700 | resource->setAddressBook( 0 ); |
694 | 701 | ||
695 | d->mManager->remove( resource ); | 702 | d->mManager->remove( resource ); |
696 | return true; | 703 | return true; |
697 | } | 704 | } |
698 | 705 | ||
699 | QPtrList<Resource> AddressBook::resources() | 706 | QPtrList<Resource> AddressBook::resources() |
700 | { | 707 | { |
701 | QPtrList<Resource> list; | 708 | QPtrList<Resource> list; |
702 | 709 | ||
703 | // qDebug("AddressBook::resources() 1"); | 710 | // qDebug("AddressBook::resources() 1"); |
704 | 711 | ||
705 | KRES::Manager<Resource>::ActiveIterator it; | 712 | KRES::Manager<Resource>::ActiveIterator it; |
706 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) | 713 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) |
707 | list.append( *it ); | 714 | list.append( *it ); |
708 | 715 | ||
709 | return list; | 716 | return list; |
710 | } | 717 | } |
711 | 718 | ||
712 | /*US | 719 | /*US |
713 | void AddressBook::setErrorHandler( ErrorHandler *handler ) | 720 | void AddressBook::setErrorHandler( ErrorHandler *handler ) |
714 | { | 721 | { |
715 | delete d->mErrorHandler; | 722 | delete d->mErrorHandler; |
716 | d->mErrorHandler = handler; | 723 | d->mErrorHandler = handler; |
717 | } | 724 | } |
718 | */ | 725 | */ |
719 | 726 | ||
720 | void AddressBook::error( const QString& msg ) | 727 | void AddressBook::error( const QString& msg ) |
721 | { | 728 | { |
722 | /*US | 729 | /*US |
723 | if ( !d->mErrorHandler ) // create default error handler | 730 | if ( !d->mErrorHandler ) // create default error handler |
724 | d->mErrorHandler = new ConsoleErrorHandler; | 731 | d->mErrorHandler = new ConsoleErrorHandler; |
725 | 732 | ||
726 | if ( d->mErrorHandler ) | 733 | if ( d->mErrorHandler ) |
727 | d->mErrorHandler->error( msg ); | 734 | d->mErrorHandler->error( msg ); |
728 | else | 735 | else |
729 | kdError(5700) << "no error handler defined" << endl; | 736 | kdError(5700) << "no error handler defined" << endl; |
730 | */ | 737 | */ |
731 | kdDebug(5700) << "msg" << endl; | 738 | kdDebug(5700) << "msg" << endl; |
732 | qDebug(msg); | 739 | qDebug(msg); |
733 | } | 740 | } |
734 | 741 | ||
735 | void AddressBook::deleteRemovedAddressees() | 742 | void AddressBook::deleteRemovedAddressees() |
736 | { | 743 | { |
737 | Addressee::List::Iterator it; | 744 | Addressee::List::Iterator it; |
738 | for ( it = d->mRemovedAddressees.begin(); it != d->mRemovedAddressees.end(); ++it ) { | 745 | for ( it = d->mRemovedAddressees.begin(); it != d->mRemovedAddressees.end(); ++it ) { |
739 | Resource *resource = (*it).resource(); | 746 | Resource *resource = (*it).resource(); |
740 | if ( resource && !resource->readOnly() && resource->isOpen() ) | 747 | if ( resource && !resource->readOnly() && resource->isOpen() ) |
741 | resource->removeAddressee( *it ); | 748 | resource->removeAddressee( *it ); |
742 | } | 749 | } |
743 | 750 | ||
744 | d->mRemovedAddressees.clear(); | 751 | d->mRemovedAddressees.clear(); |
745 | } | 752 | } |
746 | 753 | ||
747 | void AddressBook::setStandardResource( Resource *resource ) | 754 | void AddressBook::setStandardResource( Resource *resource ) |
748 | { | 755 | { |
749 | // qDebug("AddressBook::setStandardResource 1"); | 756 | // qDebug("AddressBook::setStandardResource 1"); |
750 | d->mManager->setStandardResource( resource ); | 757 | d->mManager->setStandardResource( resource ); |
751 | } | 758 | } |
752 | 759 | ||
753 | Resource *AddressBook::standardResource() | 760 | Resource *AddressBook::standardResource() |
754 | { | 761 | { |
755 | return d->mManager->standardResource(); | 762 | return d->mManager->standardResource(); |
756 | } | 763 | } |
757 | 764 | ||
758 | KRES::Manager<Resource> *AddressBook::resourceManager() | 765 | KRES::Manager<Resource> *AddressBook::resourceManager() |
759 | { | 766 | { |
760 | return d->mManager; | 767 | return d->mManager; |
761 | } | 768 | } |
762 | 769 | ||
763 | void AddressBook::cleanUp() | 770 | void AddressBook::cleanUp() |
764 | { | 771 | { |
765 | KRES::Manager<Resource>::ActiveIterator it; | 772 | KRES::Manager<Resource>::ActiveIterator it; |
766 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) { | 773 | for ( it = d->mManager->activeBegin(); it != d->mManager->activeEnd(); ++it ) { |
767 | if ( !(*it)->readOnly() && (*it)->isOpen() ) | 774 | if ( !(*it)->readOnly() && (*it)->isOpen() ) |
768 | (*it)->cleanUp(); | 775 | (*it)->cleanUp(); |
769 | } | 776 | } |
770 | } | 777 | } |
diff --git a/kabc/addressbook.h b/kabc/addressbook.h index 05225f9..650a638 100644 --- a/kabc/addressbook.h +++ b/kabc/addressbook.h | |||
@@ -1,333 +1,334 @@ | |||
1 | /* | 1 | /* |
2 | This file is part of libkabc. | 2 | This file is part of libkabc. |
3 | Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org> | 3 | Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org> |
4 | 4 | ||
5 | This library is free software; you can redistribute it and/or | 5 | This library is free software; you can redistribute it and/or |
6 | modify it under the terms of the GNU Library General Public | 6 | modify it under the terms of the GNU Library General Public |
7 | License as published by the Free Software Foundation; either | 7 | License as published by the Free Software Foundation; either |
8 | version 2 of the License, or (at your option) any later version. | 8 | version 2 of the License, or (at your option) any later version. |
9 | 9 | ||
10 | This library is distributed in the hope that it will be useful, | 10 | This library is distributed in the hope that it will be useful, |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 11 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | 12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
13 | Library General Public License for more details. | 13 | Library General Public License for more details. |
14 | 14 | ||
15 | You should have received a copy of the GNU Library General Public License | 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 | 16 | along with this library; see the file COPYING.LIB. If not, write to |
17 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | 17 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330, |
18 | Boston, MA 02111-1307, USA. | 18 | Boston, MA 02111-1307, USA. |
19 | */ | 19 | */ |
20 | 20 | ||
21 | /* | 21 | /* |
22 | Enhanced Version of the file for platform independent KDE tools. | 22 | Enhanced Version of the file for platform independent KDE tools. |
23 | Copyright (c) 2004 Ulf Schenk | 23 | Copyright (c) 2004 Ulf Schenk |
24 | 24 | ||
25 | $Id$ | 25 | $Id$ |
26 | */ | 26 | */ |
27 | 27 | ||
28 | #ifndef KABC_ADDRESSBOOK_H | 28 | #ifndef KABC_ADDRESSBOOK_H |
29 | #define KABC_ADDRESSBOOK_H | 29 | #define KABC_ADDRESSBOOK_H |
30 | 30 | ||
31 | #include <qobject.h> | 31 | #include <qobject.h> |
32 | 32 | ||
33 | #include <kresources/manager.h> | 33 | #include <kresources/manager.h> |
34 | #include <qptrlist.h> | 34 | #include <qptrlist.h> |
35 | 35 | ||
36 | #include "addressee.h" | 36 | #include "addressee.h" |
37 | #include "field.h" | 37 | #include "field.h" |
38 | 38 | ||
39 | namespace KABC { | 39 | namespace KABC { |
40 | 40 | ||
41 | class ErrorHandler; | 41 | class ErrorHandler; |
42 | class Resource; | 42 | class Resource; |
43 | class Ticket; | 43 | class Ticket; |
44 | 44 | ||
45 | /** | 45 | /** |
46 | @short Address Book | 46 | @short Address Book |
47 | 47 | ||
48 | This class provides access to a collection of address book entries. | 48 | This class provides access to a collection of address book entries. |
49 | */ | 49 | */ |
50 | class AddressBook : public QObject | 50 | class AddressBook : public QObject |
51 | { | 51 | { |
52 | Q_OBJECT | 52 | Q_OBJECT |
53 | 53 | ||
54 | friend QDataStream &operator<<( QDataStream &, const AddressBook & ); | 54 | friend QDataStream &operator<<( QDataStream &, const AddressBook & ); |
55 | friend QDataStream &operator>>( QDataStream &, AddressBook & ); | 55 | friend QDataStream &operator>>( QDataStream &, AddressBook & ); |
56 | friend class StdAddressBook; | 56 | friend class StdAddressBook; |
57 | 57 | ||
58 | public: | 58 | public: |
59 | /** | 59 | /** |
60 | @short Address Book Iterator | 60 | @short Address Book Iterator |
61 | 61 | ||
62 | This class provides an iterator for address book entries. | 62 | This class provides an iterator for address book entries. |
63 | */ | 63 | */ |
64 | class Iterator | 64 | class Iterator |
65 | { | 65 | { |
66 | public: | 66 | public: |
67 | Iterator(); | 67 | Iterator(); |
68 | Iterator( const Iterator & ); | 68 | Iterator( const Iterator & ); |
69 | ~Iterator(); | 69 | ~Iterator(); |
70 | 70 | ||
71 | Iterator &operator=( const Iterator & ); | 71 | Iterator &operator=( const Iterator & ); |
72 | const Addressee &operator*() const; | 72 | const Addressee &operator*() const; |
73 | Addressee &operator*(); | 73 | Addressee &operator*(); |
74 | Addressee* operator->(); | 74 | Addressee* operator->(); |
75 | Iterator &operator++(); | 75 | Iterator &operator++(); |
76 | Iterator &operator++(int); | 76 | Iterator &operator++(int); |
77 | Iterator &operator--(); | 77 | Iterator &operator--(); |
78 | Iterator &operator--(int); | 78 | Iterator &operator--(int); |
79 | bool operator==( const Iterator &it ); | 79 | bool operator==( const Iterator &it ); |
80 | bool operator!=( const Iterator &it ); | 80 | bool operator!=( const Iterator &it ); |
81 | 81 | ||
82 | struct IteratorData; | 82 | struct IteratorData; |
83 | IteratorData *d; | 83 | IteratorData *d; |
84 | }; | 84 | }; |
85 | 85 | ||
86 | /** | 86 | /** |
87 | @short Address Book Const Iterator | 87 | @short Address Book Const Iterator |
88 | 88 | ||
89 | This class provides a const iterator for address book entries. | 89 | This class provides a const iterator for address book entries. |
90 | */ | 90 | */ |
91 | class ConstIterator | 91 | class ConstIterator |
92 | { | 92 | { |
93 | public: | 93 | public: |
94 | ConstIterator(); | 94 | ConstIterator(); |
95 | ConstIterator( const ConstIterator & ); | 95 | ConstIterator( const ConstIterator & ); |
96 | ~ConstIterator(); | 96 | ~ConstIterator(); |
97 | 97 | ||
98 | ConstIterator &operator=( const ConstIterator & ); | 98 | ConstIterator &operator=( const ConstIterator & ); |
99 | const Addressee &operator*() const; | 99 | const Addressee &operator*() const; |
100 | const Addressee* operator->() const; | 100 | const Addressee* operator->() const; |
101 | ConstIterator &operator++(); | 101 | ConstIterator &operator++(); |
102 | ConstIterator &operator++(int); | 102 | ConstIterator &operator++(int); |
103 | ConstIterator &operator--(); | 103 | ConstIterator &operator--(); |
104 | ConstIterator &operator--(int); | 104 | ConstIterator &operator--(int); |
105 | bool operator==( const ConstIterator &it ); | 105 | bool operator==( const ConstIterator &it ); |
106 | bool operator!=( const ConstIterator &it ); | 106 | bool operator!=( const ConstIterator &it ); |
107 | 107 | ||
108 | struct ConstIteratorData; | 108 | struct ConstIteratorData; |
109 | ConstIteratorData *d; | 109 | ConstIteratorData *d; |
110 | }; | 110 | }; |
111 | 111 | ||
112 | /** | 112 | /** |
113 | Constructs a address book object. | 113 | Constructs a address book object. |
114 | 114 | ||
115 | @param format File format class. | 115 | @param format File format class. |
116 | */ | 116 | */ |
117 | AddressBook(); | 117 | AddressBook(); |
118 | AddressBook( const QString &config ); | 118 | AddressBook( const QString &config ); |
119 | AddressBook( const QString &config, const QString &family ); | 119 | AddressBook( const QString &config, const QString &family ); |
120 | virtual ~AddressBook(); | 120 | virtual ~AddressBook(); |
121 | 121 | ||
122 | /** | 122 | /** |
123 | Requests a ticket for saving the addressbook. Calling this function locks | 123 | Requests a ticket for saving the addressbook. Calling this function locks |
124 | the addressbook for all other processes. If the address book is already | 124 | the addressbook for all other processes. If the address book is already |
125 | locked the function returns 0. You need the returned @ref Ticket object | 125 | locked the function returns 0. You need the returned @ref Ticket object |
126 | for calling the @ref save() function. | 126 | for calling the @ref save() function. |
127 | 127 | ||
128 | @see save() | 128 | @see save() |
129 | */ | 129 | */ |
130 | Ticket *requestSaveTicket( Resource *resource=0 ); | 130 | Ticket *requestSaveTicket( Resource *resource=0 ); |
131 | 131 | ||
132 | /** | 132 | /** |
133 | Load address book from file. | 133 | Load address book from file. |
134 | */ | 134 | */ |
135 | bool load(); | 135 | bool load(); |
136 | 136 | ||
137 | /** | 137 | /** |
138 | Save address book. The address book is saved to the file, the Ticket | 138 | Save address book. The address book is saved to the file, the Ticket |
139 | object has been requested for by @ref requestSaveTicket(). | 139 | object has been requested for by @ref requestSaveTicket(). |
140 | 140 | ||
141 | @param ticket a ticket object returned by @ref requestSaveTicket() | 141 | @param ticket a ticket object returned by @ref requestSaveTicket() |
142 | */ | 142 | */ |
143 | bool save( Ticket *ticket ); | 143 | bool save( Ticket *ticket ); |
144 | bool saveAB( ); | 144 | bool saveAB( ); |
145 | 145 | ||
146 | /** | 146 | /** |
147 | Returns a iterator for first entry of address book. | 147 | Returns a iterator for first entry of address book. |
148 | */ | 148 | */ |
149 | Iterator begin(); | 149 | Iterator begin(); |
150 | 150 | ||
151 | /** | 151 | /** |
152 | Returns a const iterator for first entry of address book. | 152 | Returns a const iterator for first entry of address book. |
153 | */ | 153 | */ |
154 | ConstIterator begin() const; | 154 | ConstIterator begin() const; |
155 | 155 | ||
156 | /** | 156 | /** |
157 | Returns a iterator for first entry of address book. | 157 | Returns a iterator for first entry of address book. |
158 | */ | 158 | */ |
159 | Iterator end(); | 159 | Iterator end(); |
160 | 160 | ||
161 | /** | 161 | /** |
162 | Returns a const iterator for first entry of address book. | 162 | Returns a const iterator for first entry of address book. |
163 | */ | 163 | */ |
164 | ConstIterator end() const; | 164 | ConstIterator end() const; |
165 | 165 | ||
166 | /** | 166 | /** |
167 | Removes all entries from address book. | 167 | Removes all entries from address book. |
168 | */ | 168 | */ |
169 | void clear(); | 169 | void clear(); |
170 | 170 | ||
171 | /** | 171 | /** |
172 | Insert an Addressee object into address book. If an object with the same | 172 | Insert an Addressee object into address book. If an object with the same |
173 | unique id already exists in the address book it it replaced by the new | 173 | unique id already exists in the address book it it replaced by the new |
174 | one. If not the new object is appended to the address book. | 174 | one. If not the new object is appended to the address book. |
175 | */ | 175 | */ |
176 | void insertAddressee( const Addressee & ); | 176 | void insertAddressee( const Addressee & ); |
177 | 177 | ||
178 | /** | 178 | /** |
179 | Removes entry from the address book. | 179 | Removes entry from the address book. |
180 | */ | 180 | */ |
181 | void removeAddressee( const Addressee & ); | 181 | void removeAddressee( const Addressee & ); |
182 | 182 | ||
183 | /** | 183 | /** |
184 | This is like @ref removeAddressee() just above, with the difference that | 184 | This is like @ref removeAddressee() just above, with the difference that |
185 | the first element is a iterator, returned by @ref begin(). | 185 | the first element is a iterator, returned by @ref begin(). |
186 | */ | 186 | */ |
187 | void removeAddressee( const Iterator & ); | 187 | void removeAddressee( const Iterator & ); |
188 | 188 | ||
189 | /** | 189 | /** |
190 | Find the specified entry in address book. Returns end(), if the entry | 190 | Find the specified entry in address book. Returns end(), if the entry |
191 | couldn't be found. | 191 | couldn't be found. |
192 | */ | 192 | */ |
193 | Iterator find( const Addressee & ); | 193 | Iterator find( const Addressee & ); |
194 | 194 | ||
195 | /** | 195 | /** |
196 | Find the entry specified by an unique id. Returns an empty Addressee | 196 | Find the entry specified by an unique id. Returns an empty Addressee |
197 | object, if the address book does not contain an entry with this id. | 197 | object, if the address book does not contain an entry with this id. |
198 | */ | 198 | */ |
199 | Addressee findByUid( const QString & ); | 199 | Addressee findByUid( const QString & ); |
200 | 200 | ||
201 | 201 | ||
202 | /** | 202 | /** |
203 | Returns a list of all addressees in the address book. This list can | 203 | Returns a list of all addressees in the address book. This list can |
204 | be sorted with @ref KABC::AddresseeList for example. | 204 | be sorted with @ref KABC::AddresseeList for example. |
205 | */ | 205 | */ |
206 | Addressee::List allAddressees(); | 206 | Addressee::List allAddressees(); |
207 | 207 | ||
208 | /** | 208 | /** |
209 | Find all entries with the specified name in the address book. Returns | 209 | Find all entries with the specified name in the address book. Returns |
210 | an empty list, if no entries could be found. | 210 | an empty list, if no entries could be found. |
211 | */ | 211 | */ |
212 | Addressee::List findByName( const QString & ); | 212 | Addressee::List findByName( const QString & ); |
213 | 213 | ||
214 | /** | 214 | /** |
215 | Find all entries with the specified email address in the address book. | 215 | Find all entries with the specified email address in the address book. |
216 | Returns an empty list, if no entries could be found. | 216 | Returns an empty list, if no entries could be found. |
217 | */ | 217 | */ |
218 | Addressee::List findByEmail( const QString & ); | 218 | Addressee::List findByEmail( const QString & ); |
219 | 219 | ||
220 | /** | 220 | /** |
221 | Find all entries wich have the specified category in the address book. | 221 | Find all entries wich have the specified category in the address book. |
222 | Returns an empty list, if no entries could be found. | 222 | Returns an empty list, if no entries could be found. |
223 | */ | 223 | */ |
224 | Addressee::List findByCategory( const QString & ); | 224 | Addressee::List findByCategory( const QString & ); |
225 | 225 | ||
226 | /** | 226 | /** |
227 | Return a string identifying this addressbook. | 227 | Return a string identifying this addressbook. |
228 | */ | 228 | */ |
229 | virtual QString identifier(); | 229 | virtual QString identifier(); |
230 | 230 | ||
231 | /** | 231 | /** |
232 | Used for debug output. | 232 | Used for debug output. |
233 | */ | 233 | */ |
234 | void dump() const; | 234 | void dump() const; |
235 | 235 | ||
236 | void emitAddressBookLocked() { emit addressBookLocked( this ); } | 236 | void emitAddressBookLocked() { emit addressBookLocked( this ); } |
237 | void emitAddressBookUnlocked() { emit addressBookUnlocked( this ); } | 237 | void emitAddressBookUnlocked() { emit addressBookUnlocked( this ); } |
238 | void emitAddressBookChanged() { emit addressBookChanged( this ); } | 238 | void emitAddressBookChanged() { emit addressBookChanged( this ); } |
239 | 239 | ||
240 | /** | 240 | /** |
241 | Return list of all Fields known to the address book which are associated | 241 | Return list of all Fields known to the address book which are associated |
242 | with the given field category. | 242 | with the given field category. |
243 | */ | 243 | */ |
244 | Field::List fields( int category = Field::All ); | 244 | Field::List fields( int category = Field::All ); |
245 | 245 | ||
246 | /** | 246 | /** |
247 | Add custom field to address book. | 247 | Add custom field to address book. |
248 | 248 | ||
249 | @param label User visible label of the field. | 249 | @param label User visible label of the field. |
250 | @param category Ored list of field categories. | 250 | @param category Ored list of field categories. |
251 | @param key Identifier used as key for reading and writing the field. | 251 | @param key Identifier used as key for reading and writing the field. |
252 | @param app String used as application key for reading and writing | 252 | @param app String used as application key for reading and writing |
253 | the field. | 253 | the field. |
254 | */ | 254 | */ |
255 | bool addCustomField( const QString &label, int category = Field::All, | 255 | bool addCustomField( const QString &label, int category = Field::All, |
256 | const QString &key = QString::null, | 256 | const QString &key = QString::null, |
257 | const QString &app = QString::null ); | 257 | const QString &app = QString::null ); |
258 | 258 | ||
259 | 259 | ||
260 | /** | 260 | /** |
261 | Add address book resource. | 261 | Add address book resource. |
262 | */ | 262 | */ |
263 | bool addResource( Resource * ); | 263 | bool addResource( Resource * ); |
264 | 264 | ||
265 | /** | 265 | /** |
266 | Remove address book resource. | 266 | Remove address book resource. |
267 | */ | 267 | */ |
268 | bool removeResource( Resource * ); | 268 | bool removeResource( Resource * ); |
269 | 269 | ||
270 | /** | 270 | /** |
271 | Return pointer list of all resources. | 271 | Return pointer list of all resources. |
272 | */ | 272 | */ |
273 | QPtrList<Resource> resources(); | 273 | QPtrList<Resource> resources(); |
274 | 274 | ||
275 | /** | 275 | /** |
276 | Set the @p ErrorHandler, that is used by @ref error() to | 276 | Set the @p ErrorHandler, that is used by @ref error() to |
277 | provide gui-independend error messages. | 277 | provide gui-independend error messages. |
278 | */ | 278 | */ |
279 | void setErrorHandler( ErrorHandler * ); | 279 | void setErrorHandler( ErrorHandler * ); |
280 | 280 | ||
281 | /** | 281 | /** |
282 | Shows gui independend error messages. | 282 | Shows gui independend error messages. |
283 | */ | 283 | */ |
284 | void error( const QString& ); | 284 | void error( const QString& ); |
285 | 285 | ||
286 | /** | 286 | /** |
287 | Query all resources to clean up their lock files | 287 | Query all resources to clean up their lock files |
288 | */ | 288 | */ |
289 | void cleanUp(); | 289 | void cleanUp(); |
290 | 290 | ||
291 | // sync stuff | 291 | // sync stuff |
292 | Addressee::List getExternLastSyncAddressees(); | 292 | Addressee::List getExternLastSyncAddressees(); |
293 | void resetTempSyncStat(); | 293 | void resetTempSyncStat(); |
294 | QStringList uidList(); | ||
294 | 295 | ||
295 | 296 | ||
296 | signals: | 297 | signals: |
297 | /** | 298 | /** |
298 | Emitted, when the address book has changed on disk. | 299 | Emitted, when the address book has changed on disk. |
299 | */ | 300 | */ |
300 | void addressBookChanged( AddressBook * ); | 301 | void addressBookChanged( AddressBook * ); |
301 | 302 | ||
302 | /** | 303 | /** |
303 | Emitted, when the address book has been locked for writing. | 304 | Emitted, when the address book has been locked for writing. |
304 | */ | 305 | */ |
305 | void addressBookLocked( AddressBook * ); | 306 | void addressBookLocked( AddressBook * ); |
306 | 307 | ||
307 | /** | 308 | /** |
308 | Emitted, when the address book has been unlocked. | 309 | Emitted, when the address book has been unlocked. |
309 | */ | 310 | */ |
310 | void addressBookUnlocked( AddressBook * ); | 311 | void addressBookUnlocked( AddressBook * ); |
311 | 312 | ||
312 | protected: | 313 | protected: |
313 | void deleteRemovedAddressees(); | 314 | void deleteRemovedAddressees(); |
314 | void setStandardResource( Resource * ); | 315 | void setStandardResource( Resource * ); |
315 | Resource *standardResource(); | 316 | Resource *standardResource(); |
316 | KRES::Manager<Resource> *resourceManager(); | 317 | KRES::Manager<Resource> *resourceManager(); |
317 | 318 | ||
318 | void init(const QString &config, const QString &family); | 319 | void init(const QString &config, const QString &family); |
319 | 320 | ||
320 | private: | 321 | private: |
321 | //US QPtrList<Resource> mDummy; // Remove in KDE 4 | 322 | //US QPtrList<Resource> mDummy; // Remove in KDE 4 |
322 | 323 | ||
323 | 324 | ||
324 | struct AddressBookData; | 325 | struct AddressBookData; |
325 | AddressBookData *d; | 326 | AddressBookData *d; |
326 | }; | 327 | }; |
327 | 328 | ||
328 | QDataStream &operator<<( QDataStream &, const AddressBook & ); | 329 | QDataStream &operator<<( QDataStream &, const AddressBook & ); |
329 | QDataStream &operator>>( QDataStream &, AddressBook & ); | 330 | QDataStream &operator>>( QDataStream &, AddressBook & ); |
330 | 331 | ||
331 | } | 332 | } |
332 | 333 | ||
333 | #endif | 334 | #endif |