52
50
private Doit _doit;
53
51
private int _response;
54
private int _responseExtra;
55
private HashMap< String, Long > _contacts;
56
private HashMap< Long, HashSet< String > > _contactNumbers;
57
private HashMap< Long, HashSet< String > > _contactEmails;
58
private int _mergeSetting;
59
private int _lastMergeDecision;
52
private int _response_extra;
53
private int _merge_setting;
54
private int _last_merge_decision;
60
55
private boolean _abort = false;
61
private boolean _isFinished = false;
56
private boolean _is_finished = false;
57
private ContactsCache _contacts_cache = null;
58
private Backend _backend = null;
61
* Data about a contact
63
63
public class ContactData
67
public String _number;
69
public boolean _isPreferred;
71
public PhoneData( String number, int type, boolean isPreferred ) {
74
_isPreferred = isPreferred;
77
public String getNumber() {
81
public int getType() {
85
public boolean isPreferred() {
92
private String _email;
94
private boolean _isPreferred;
96
public EmailData( String email, int type, boolean isPreferred ) {
99
_isPreferred = isPreferred;
102
public String getAddress() {
106
public int getType() {
110
public boolean isPreferred() {
115
public String _name = null;
116
public HashMap< String, PhoneData > _phones = null;
117
public HashMap< String, EmailData > _emails = null;
65
public final static int TYPE_HOME = 0;
66
public final static int TYPE_WORK = 1;
67
public final static int TYPE_MOBILE = 2; // only used with phones
68
public final static int TYPE_FAX_HOME = 3; // only used with phones
69
public final static int TYPE_FAX_WORK = 4; // only used with phones
70
public final static int TYPE_PAGER = 5; // only used with phones
76
public TypeDetail( int type )
87
class PreferredDetail extends TypeDetail
89
protected boolean _is_preferred;
91
public PreferredDetail( int type, boolean is_preferred )
94
_is_preferred = is_preferred;
97
public boolean isPreferred()
103
class ExtraDetail extends PreferredDetail
105
protected String _extra;
107
public ExtraDetail( int type, boolean is_preferred, String extra )
109
super( type, is_preferred );
111
if( extra != null ) extra = extra.trim();
115
public String getExtra()
120
public void setExtra( String extra )
122
if( extra != null ) extra = extra.trim();
127
@SuppressWarnings("serial")
128
protected class ContactNotIdentifiableException extends Exception
132
protected String _name = null;
133
protected String _primary_organisation = null;
134
protected boolean _primary_organisation_is_preferred;
135
protected String _primary_number = null;
136
protected int _primary_number_type;
137
protected boolean _primary_number_is_preferred;
138
protected String _primary_email = null;
139
protected boolean _primary_email_is_preferred;
140
protected HashMap< String, ExtraDetail > _organisations = null;
141
protected HashMap< String, PreferredDetail > _numbers = null;
142
protected HashMap< String, PreferredDetail > _emails = null;
143
protected HashMap< String, TypeDetail > _addresses = null;
145
private ContactsCache.CacheIdentifier _cache_identifier = null;
119
147
protected void setName( String name )
152
public boolean hasName()
154
return _name != null;
124
157
public String getName()
129
protected void addPhone( String number, int type, boolean isPreferred )
131
if( _phones == null ) _phones = new HashMap< String, PhoneData >();
132
if( !_phones.containsKey( number ) )
134
new PhoneData( number, type, isPreferred ) );
137
protected void addEmail( String email, int type, boolean isPreferred )
139
if( _emails == null ) _emails = new HashMap< String, EmailData >();
162
protected void addOrganisation( String organisation, String title,
163
boolean is_preferred )
165
organisation = organisation.trim();
166
if( organisation.length() <= 0 )
168
// TODO: warn that an imported organisation is being ignored
172
if( title != null ) {
173
title = title.trim();
174
if( title.length() <= 0 ) title = null;
177
// add the organisation, as non-preferred (we prefer only one
178
// organisation in finalise() after they're all imported)
179
if( _organisations == null )
180
_organisations = new HashMap< String, ExtraDetail >();
181
if( !_organisations.containsKey( organisation ) )
182
_organisations.put( organisation,
183
new ExtraDetail( 0, false, title ) );
185
// if this is the first organisation added, or it's a preferred
186
// organisation and the current primary organisation isn't, then
187
// record this as the primary organisation.
188
if( _primary_organisation == null ||
189
( is_preferred && !_primary_organisation_is_preferred ) )
191
_primary_organisation = organisation;
192
_primary_organisation_is_preferred = is_preferred;
196
public boolean hasOrganisations()
198
return _organisations != null && _organisations.size() > 0;
201
public HashMap< String, ExtraDetail > getOrganisations()
203
return _organisations;
206
public boolean hasPrimaryOrganisation()
208
return _primary_organisation != null;
211
public String getPrimaryOrganisation()
213
return _primary_organisation;
216
protected void addNumber( String number, int type,
217
boolean is_preferred )
219
number = sanitisePhoneNumber( number );
222
// TODO: warn that an imported phone number is being ignored
226
// add the number, as non-preferred (we prefer only one number
227
// in finalise() after they're all imported)
228
if( _numbers == null )
229
_numbers = new HashMap< String, PreferredDetail >();
230
if( !_numbers.containsKey( number ) )
231
_numbers.put( number,
232
new PreferredDetail( type, false ) );
234
final Set< Integer > non_voice_types = new HashSet< Integer >(
235
Arrays.asList( TYPE_FAX_HOME, TYPE_FAX_WORK, TYPE_PAGER ) );
237
// if this is the first number added, or it's a preferred number
238
// and the current primary number isn't, or this number is on equal
239
// standing with the primary number in terms of preference and it is
240
// a voice number and the primary number isn't, then record this as
241
// the primary number.
242
if( _primary_number == null ||
243
( is_preferred && !_primary_number_is_preferred ) ||
244
( is_preferred == _primary_number_is_preferred &&
245
!non_voice_types.contains( type ) &&
246
non_voice_types.contains( _primary_number_type ) ) )
248
_primary_number = number;
249
_primary_number_type = type;
250
_primary_number_is_preferred = is_preferred;
254
public boolean hasNumbers()
256
return _numbers != null && _numbers.size() > 0;
259
public HashMap< String, PreferredDetail > getNumbers()
264
public boolean hasPrimaryNumber()
266
return _primary_number != null;
269
public String getPrimaryNumber()
271
return _primary_number;
274
protected void addEmail( String email, int type, boolean is_preferred )
277
email = sanitisesEmailAddress( email );
280
// TODO: warn that an imported email address is being ignored
284
// add the email, as non-preferred (we prefer only one email in
285
// finalise() after they're all imported)
286
if( _emails == null )
287
_emails = new HashMap< String, PreferredDetail >();
140
288
if( !_emails.containsKey( email ) )
141
_emails.put( email, new EmailData( email, type, isPreferred ) );
289
_emails.put( email, new PreferredDetail( type, false ) );
291
// if this is the first email added, or it's a preferred email and
292
// the current primary organisation isn't, then record this as the
294
if( _primary_email == null ||
295
( is_preferred && !_primary_email_is_preferred ) )
297
_primary_email = email;
298
_primary_email_is_preferred = is_preferred;
302
public boolean hasEmails()
304
return _emails != null && _emails.size() > 0;
307
public HashMap< String, PreferredDetail > getEmails()
312
public boolean hasPrimaryEmail()
314
return _primary_email != null;
317
public String getPrimaryEmail()
319
return _primary_email;
322
protected void addAddress( String address, int type )
324
address = address.trim();
325
if( address.length() <= 0 )
327
// TODO: warn that an imported address is being ignored
331
if( _addresses == null ) _addresses =
332
new HashMap< String, TypeDetail >();
333
if( !_addresses.containsKey( address ) )
334
_addresses.put( address, new TypeDetail( type ) );
337
public boolean hasAddresses()
339
return _addresses != null && _addresses.size() > 0;
342
public HashMap< String, TypeDetail > getAddresses()
347
protected void finalise()
348
throws ContactNotIdentifiableException
350
// ensure that if there is a primary number, it is preferred so
351
// that there is always one preferred number. Android will assign
352
// preference to one anyway so we might as well decide one sensibly.
353
if( _primary_number != null ) {
354
PreferredDetail data = _numbers.get( _primary_number );
355
_numbers.put( _primary_number,
356
new PreferredDetail( data.getType(), true ) );
359
// do the same for the primary email
360
if( _primary_email != null ) {
361
PreferredDetail data = _emails.get( _primary_email );
362
_emails.put( _primary_email,
363
new PreferredDetail( data.getType(), true ) );
366
// do the same for the primary organisation
367
if( _primary_organisation != null ) {
368
ExtraDetail data = _organisations.get( _primary_organisation );
369
_organisations.put( _primary_organisation,
370
new ExtraDetail( 0, true, data.getExtra() ) );
373
// create a cache identifier from this contact data, which can be
374
// used to look-up an existing contact
375
_cache_identifier = ContactsCache.createIdentifier( this );
376
if( _cache_identifier == null )
377
throw new ContactNotIdentifiableException();
380
public ContactsCache.CacheIdentifier getCacheIdentifier()
382
return _cache_identifier;
385
private String sanitisePhoneNumber( String number )
387
number = number.trim();
388
Pattern p = Pattern.compile( "^[-\\(\\) \\+0-9#*]+" );
389
Matcher m = p.matcher( number );
390
if( m.lookingAt() ) return m.group( 0 );
394
private String sanitisesEmailAddress( String email )
396
email = email.trim();
397
Pattern p = Pattern.compile(
398
"^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
399
Matcher m = p.matcher( email );
401
String[] bits = email.split( "@" );
402
return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase( Locale.US );
671
// It is expected that we use contact.getCacheIdentifier() here. The
672
// contact we are passed should have been successfully finalise()d,
673
// which includes generating a valid cache identifier.
674
ContactsCache.CacheIdentifier cache_identifier =
675
contact.getCacheIdentifier();
394
677
// if( !showContinue( "====[ IMPORTING ]====\n: " + contact._name ) )
395
678
// finish( ACTION_ABORT );
397
ContentValues values = new ContentValues();
398
boolean uiInformed = false;
400
// does contact exist already?
401
Uri contactUri = null;
403
if( ( id = (Long)_contacts.get( contact._name ) ) != null )
405
// should we skip this import altogether?
406
if( _lastMergeDecision == Doit.ACTION_KEEP ) return;
409
contactUri = ContentUris.withAppendedId(
410
Contacts.People.CONTENT_URI, id );
412
// should we destroy the existing contact before importing?
413
if( _lastMergeDecision == Doit.ACTION_OVERWRITE ) {
414
_doit.getContentResolver().delete( contactUri, null, null );
418
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTOVERWRITTEN );
680
// attempt to lookup the id of an existing contact in the cache with
681
// this contact data's cache identifier
682
Long id = (Long)_contacts_cache.lookup( cache_identifier );
684
// check to see if this contact should be skipped
685
if( shouldWeSkipContact( cache_identifier.getDetail(), id != null,
688
// show that we're skipping a contact
689
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTSKIPPED );
693
// if a contact exists, and we're overwriting, destroy the existing
694
// contact before importing
695
boolean contact_deleted = false;
696
if( id != null && _last_merge_decision == Doit.ACTION_OVERWRITE )
698
contact_deleted = true;
700
// remove from device
701
_backend.deleteContact( id );
704
_contacts_cache.removeLookup( cache_identifier );
705
_contacts_cache.removeAssociatedData( id );
707
// show that we're overwriting a contact
708
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTOVERWRITTEN );
710
// discard the contact id
715
// if we don't have a contact id yet (or we did, but we destroyed it
716
// when we deleted the contact), we'll have to create a new contact
719
// create a new contact
720
id = _backend.addContact( contact._name );
422
_contacts.remove( contact._name );
723
_contacts_cache.addLookup( cache_identifier, id );
725
// if we haven't already shown that we're overwriting a contact,
726
// show that we're creating a new contact
727
if( !contact_deleted )
728
_doit._handler.sendEmptyMessage(
729
Doit.MESSAGE_CONTACTCREATED );
732
// show that we're merging with an existing contact
733
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
735
// import contact parts
736
if( contact.hasNumbers() )
737
importContactPhones( id, contact.getNumbers() );
738
if( contact.hasEmails() )
739
importContactEmails( id, contact.getEmails() );
740
if( contact.hasAddresses() )
741
importContactAddresses( id, contact.getAddresses() );
742
if( contact.hasOrganisations() )
743
importContactOrganisations( id, contact.getOrganisations() );
426
// if we don't have a contact URI it is because the contact never
427
// existed or because we deleted it
428
if( contactUri == null )
745
catch( Backend.ContactCreationException e )
430
// create a new contact
431
values.put( Contacts.People.NAME, contact._name );
432
contactUri = _doit.getContentResolver().insert(
433
Contacts.People.CONTENT_URI, values );
434
id = ContentUris.parseId( contactUri );
435
if( id <= 0 ) return; // shouldn't happen!
437
// try to add them to the "My Contacts" group
439
Contacts.People.addToMyContactsGroup(
440
_doit.getContentResolver(), id );
442
catch( IllegalStateException e ) { }
445
_contacts.put( contact._name, id );
449
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTCREATED );
747
showError( R.string.error_unabletoaddcontact );
456
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
458
// import contact parts
459
if( contact._phones != null )
460
importContactPhones( contactUri, contact._phones );
461
if( contact._emails != null )
462
importContactEmails( contactUri, contact._emails );
465
private void importContactPhones( Uri contactUri,
466
HashMap< String, ContactData.PhoneData > phones )
751
private void importContactPhones( Long id,
752
HashMap< String, ContactData.PreferredDetail > datas )
753
throws ContactCreationException
468
Long contactId = ContentUris.parseId( contactUri );
469
Uri contactPhonesUri = Uri.withAppendedPath( contactUri,
470
Contacts.People.Phones.CONTENT_DIRECTORY );
471
Set< String > phonesKeys = phones.keySet();
473
755
// add phone numbers
474
Iterator< String > i = phonesKeys.iterator();
756
Set< String > datas_keys = datas.keySet();
757
Iterator< String > i = datas_keys.iterator();
475
758
while( i.hasNext() ) {
476
ContactData.PhoneData phone = phones.get( i.next() );
759
String number = i.next();
760
ContactData.PreferredDetail data = datas.get( number );
478
762
// we don't want to add this number if it's crap, or it already
479
763
// exists (which would cause a duplicate to be created). We don't
482
766
// if the number exists at all, it doesn't need importing. Because
483
767
// of this, we also can't update the cache (which we don't need to
484
768
// anyway, so it's not a problem).
485
String number = sanitisePhoneNumber( phone._number );
486
if( number == null ) continue;
487
HashSet< String > numbers = _contactNumbers.get( contactId );
488
if( numbers != null && numbers.contains( number ) ) continue;
769
if( _contacts_cache.hasAssociatedNumber( id, number ) )
490
772
// add phone number
491
ContentValues values = new ContentValues();
492
values.put( Contacts.Phones.TYPE, phone._type );
493
values.put( Contacts.Phones.NUMBER, phone._number );
494
if( phone._isPreferred ) values.put( Contacts.Phones.ISPRIMARY, 1 );
495
_doit.getContentResolver().insert( contactPhonesUri, values );
498
// now add those phone numbers to the cache to prevent the addition of
499
// duplicate data from another file
500
i = phonesKeys.iterator();
501
while( i.hasNext() ) {
502
ContactData.PhoneData phone = phones.get( i.next() );
504
String number = sanitisePhoneNumber( phone._number );
505
if( number != null ) {
506
HashSet< String > numbers = _contactNumbers.get( contactId );
507
if( numbers == null ) {
508
_contactNumbers.put( contactId, new HashSet< String >() );
509
numbers = _contactNumbers.get( contactId );
511
numbers.add( number );
773
_backend.addContactPhone( id, number, data );
775
// and add this address to the cache to prevent a addition of
776
// duplicate date from another file
777
_contacts_cache.addAssociatedNumber( id, number );
516
private void importContactEmails( Uri contactUri,
517
HashMap< String, ContactData.EmailData > emails )
781
private void importContactEmails( Long id,
782
HashMap< String, ContactData.PreferredDetail > datas )
783
throws ContactCreationException
519
Long contactId = ContentUris.parseId( contactUri );
520
Uri contactContactMethodsUri = Uri.withAppendedPath( contactUri,
521
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
522
Set< String > emailsKeys = emails.keySet();
524
785
// add email addresses
525
Iterator< String > i = emailsKeys.iterator();
786
Set< String > datas_keys = datas.keySet();
787
Iterator< String > i = datas_keys.iterator();
526
788
while( i.hasNext() ) {
527
ContactData.EmailData email = emails.get( i.next() );
789
String email = i.next();
790
ContactData.PreferredDetail data = datas.get( email );
529
// like with phone numbers, we don't want to add this email address
530
// if it exists already or we would introduce duplicates.
531
String address = sanitiseEmailAddress( email.getAddress() );
532
if( address == null ) continue;
533
HashSet< String > addresses = _contactEmails.get( contactId );
534
if( addresses != null && addresses.contains( address ) ) continue;
792
// we don't want to add this email address if it exists already or
793
// we would introduce duplicates.
794
if( _contacts_cache.hasAssociatedEmail( id, email ) )
536
797
// add phone number
537
ContentValues values = new ContentValues();
538
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL );
539
values.put( Contacts.ContactMethods.DATA, email.getAddress() );
540
values.put( Contacts.ContactMethods.TYPE, email.getType() );
541
if( email.isPreferred() )
542
values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
543
_doit.getContentResolver().insert( contactContactMethodsUri,
547
// now add those email addresses to the cache to prevent the addition of
548
// duplicate data from another file
549
i = emailsKeys.iterator();
550
while( i.hasNext() ) {
551
ContactData.EmailData email = emails.get( i.next() );
553
String address = sanitiseEmailAddress( email.getAddress() );
554
if( address != null ) {
555
HashSet< String > addresses = _contactEmails.get( contactId );
556
if( addresses == null ) {
557
_contactEmails.put( contactId, new HashSet< String >() );
558
addresses = _contactEmails.get( contactId );
560
addresses.add( address );
798
_backend.addContactEmail( id, email, data );
800
// and add this address to the cache to prevent a addition of
801
// duplicate date from another file
802
_contacts_cache.addAssociatedEmail( id, email );
806
private void importContactAddresses( Long id,
807
HashMap< String, ContactData.TypeDetail > datas )
808
throws ContactCreationException
811
Set< String > datas_keys = datas.keySet();
812
Iterator< String > i = datas_keys.iterator();
813
while( i.hasNext() ) {
814
String address = i.next();
815
ContactData.TypeDetail data = datas.get( address );
817
// we don't want to add this address if it exists already or we
818
// would introduce duplicates
819
if( _contacts_cache.hasAssociatedAddress( id, address ) )
822
// add postal address
823
_backend.addContactAddresses( id, address, data );
825
// and add this address to the cache to prevent a addition of
826
// duplicate date from another file
827
_contacts_cache.addAssociatedAddress( id, address );
831
private void importContactOrganisations( Long id,
832
HashMap< String, ContactData.ExtraDetail > datas )
833
throws ContactCreationException
836
Set< String > datas_keys = datas.keySet();
837
Iterator< String > i = datas_keys.iterator();
838
while( i.hasNext() ) {
839
String organisation = i.next();
840
ContactData.ExtraDetail data = datas.get( organisation );
842
// we don't want to add this address if it exists already or we
843
// would introduce duplicates
844
if( _contacts_cache.hasAssociatedOrganisation( id, organisation ) )
847
// add organisation address
848
_backend.addContactOrganisation( id, organisation, data );
850
// and add this address to the cache to prevent a addition of
851
// duplicate date from another file
852
_contacts_cache.addAssociatedOrganisation( id, organisation );
569
860
throw new AbortImportException();
573
private void buildContactsCache() throws AbortImportException
576
setProgressMessage( R.string.doit_caching );
581
// init contacts caches
582
_contacts = new HashMap< String, Long >();
583
_contactNumbers = new HashMap< Long, HashSet< String > >();
584
_contactEmails = new HashMap< Long, HashSet< String > >();
586
// query and store map of contact names to ids
587
cols = new String[] { Contacts.People._ID, Contacts.People.NAME };
588
cur = _doit.managedQuery( Contacts.People.CONTENT_URI,
589
cols, null, null, null);
590
if( cur.moveToFirst() ) {
591
int idCol = cur.getColumnIndex( Contacts.People._ID );
592
int nameCol = cur.getColumnIndex( Contacts.People.NAME );
594
_contacts.put( cur.getString( nameCol ), cur.getLong( idCol ) );
595
} while( cur.moveToNext() );
598
// query and store map of contact ids to sets of phone numbers
599
cols = new String[] { Contacts.Phones.PERSON_ID,
600
Contacts.Phones.NUMBER };
601
cur = _doit.managedQuery( Contacts.Phones.CONTENT_URI,
602
cols, null, null, null);
603
if( cur.moveToFirst() ) {
604
int personIdCol = cur.getColumnIndex( Contacts.Phones.PERSON_ID );
605
int numberCol = cur.getColumnIndex( Contacts.Phones.NUMBER );
607
Long id = cur.getLong( personIdCol );
608
String number = sanitisePhoneNumber(
609
cur.getString( numberCol ) );
610
if( number != null ) {
611
HashSet< String > numbers = _contactNumbers.get( id );
612
if( numbers == null ) {
613
_contactNumbers.put( id, new HashSet< String >() );
614
numbers = _contactNumbers.get( id );
616
numbers.add( number );
618
} while( cur.moveToNext() );
621
// query and store map of contact ids to sets of email addresses
622
cols = new String[] { Contacts.ContactMethods.PERSON_ID,
623
Contacts.ContactMethods.DATA };
624
cur = _doit.managedQuery( Contacts.ContactMethods.CONTENT_URI,
625
cols, Contacts.ContactMethods.KIND + " = ?",
626
new String[] { "" + Contacts.KIND_EMAIL }, null );
627
if( cur.moveToFirst() ) {
628
int personIdCol = cur.getColumnIndex(
629
Contacts.ContactMethods.PERSON_ID );
630
int addressCol = cur.getColumnIndex(
631
Contacts.ContactMethods.DATA );
633
Long id = cur.getLong( personIdCol );
634
String address = sanitiseEmailAddress(
635
cur.getString( addressCol ) );
636
if( address != null ) {
637
HashSet< String > addresses = _contactEmails.get( id );
638
if( addresses == null ) {
639
_contactEmails.put( id, new HashSet< String >() );
640
addresses = _contactEmails.get( id );
642
addresses.add( address );
644
} while( cur.moveToNext() );
648
private String sanitisePhoneNumber( String number )
650
number = number.replaceAll( "[-\\(\\) ]", "" );
651
Pattern p = Pattern.compile( "^\\+?[0-9]+" );
652
Matcher m = p.matcher( number );
653
if( m.lookingAt() ) return m.group( 0 );
657
private String sanitiseEmailAddress( String address )
659
address = address.trim();
660
Pattern p = Pattern.compile(
661
"^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
662
Matcher m = p.matcher( address );
664
String[] bits = address.split( "@" );
665
return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase();