49
53
private Doit _doit;
50
54
private int _response;
51
private int _response_extra;
52
private int _merge_setting;
53
private int _last_merge_decision;
55
private int _responseExtra;
56
private HashMap< String, Long > _contacts;
57
private HashMap< Long, HashSet< String > > _contactNumbers;
58
private HashMap< Long, HashSet< String > > _contactEmails;
59
private int _mergeSetting;
60
private int _lastMergeDecision;
54
61
private boolean _abort = false;
55
private boolean _is_finished = false;
56
private ContactsCache _contacts_cache = null;
57
private Backend _backend = null;
62
private boolean _isFinished = false;
60
* Data about a contact
62
64
public class ContactData
68
public TypeDetail( int type )
79
class PreferredDetail extends TypeDetail
81
protected boolean _is_preferred;
83
public PreferredDetail( int type, boolean is_preferred )
86
_is_preferred = is_preferred;
89
public boolean isPreferred()
95
class ExtraDetail extends PreferredDetail
97
protected String _extra;
99
public ExtraDetail( int type, boolean is_preferred, String extra )
101
super( type, is_preferred );
103
if( extra != null ) extra = extra.trim();
107
public String getExtra()
112
public void setExtra( String extra )
114
if( extra != null ) extra = extra.trim();
119
@SuppressWarnings("serial")
120
protected class ContactNotIdentifiableException extends Exception
124
protected String _name = null;
125
protected String _primary_organisation = null;
126
protected boolean _primary_organisation_is_preferred;
127
protected String _primary_number = null;
128
protected int _primary_number_type;
129
protected boolean _primary_number_is_preferred;
130
protected String _primary_email = null;
131
protected boolean _primary_email_is_preferred;
132
protected HashMap< String, ExtraDetail > _organisations = null;
133
protected HashMap< String, PreferredDetail > _numbers = null;
134
protected HashMap< String, PreferredDetail > _emails = null;
135
protected HashMap< String, TypeDetail > _addresses = null;
137
private ContactsCache.CacheIdentifier _cache_identifier = null;
68
public String _number;
70
public boolean _isPreferred;
72
public PhoneData( String number, int type, boolean isPreferred ) {
75
_isPreferred = isPreferred;
78
public String getNumber() {
82
public int getType() {
86
public boolean isPreferred() {
93
private String _email;
95
private boolean _isPreferred;
97
public EmailData( String email, int type, boolean isPreferred ) {
100
_isPreferred = isPreferred;
103
public String getAddress() {
107
public int getType() {
111
public boolean isPreferred() {
116
public String _name = null;
117
public HashMap< String, PhoneData > _phones = null;
118
public HashMap< String, EmailData > _emails = null;
139
120
protected void setName( String name )
144
public boolean hasName()
146
return _name != null;
149
125
public String getName()
154
protected void addOrganisation( String organisation, String title,
155
boolean is_preferred )
157
organisation = organisation.trim();
158
if( organisation.length() <= 0 )
160
// TODO: warn that an imported organisation is being ignored
164
if( title != null ) {
165
title = title.trim();
166
if( title.length() <= 0 ) title = null;
169
// add the organisation, as non-preferred (we prefer only one
170
// organisation in finalise() after they're all imported)
171
if( _organisations == null )
172
_organisations = new HashMap< String, ExtraDetail >();
173
if( !_organisations.containsKey( organisation ) )
174
_organisations.put( organisation,
175
new ExtraDetail( 0, false, title ) );
177
// if this is the first organisation added, or it's a preferred
178
// organisation and the current primary organisation isn't, then
179
// record this as the primary organisation.
180
if( _primary_organisation == null ||
181
( is_preferred && !_primary_organisation_is_preferred ) )
183
_primary_organisation = organisation;
184
_primary_organisation_is_preferred = is_preferred;
188
public boolean hasOrganisations()
190
return _organisations != null && _organisations.size() > 0;
193
public HashMap< String, ExtraDetail > getOrganisations()
195
return _organisations;
198
public boolean hasPrimaryOrganisation()
200
return _primary_organisation != null;
203
public String getPrimaryOrganisation()
205
return _primary_organisation;
208
protected void addNumber( String number, int type,
209
boolean is_preferred )
211
number = sanitisePhoneNumber( number );
214
// TODO: warn that an imported phone number is being ignored
218
// add the number, as non-preferred (we prefer only one number
219
// in finalise() after they're all imported)
220
if( _numbers == null )
221
_numbers = new HashMap< String, PreferredDetail >();
222
if( !_numbers.containsKey( number ) )
223
_numbers.put( number,
224
new PreferredDetail( type, false ) );
226
final Set< Integer > non_voice_types = new HashSet< Integer >(
227
Arrays.asList( PhonesColumns.TYPE_FAX_HOME,
228
PhonesColumns.TYPE_FAX_WORK, PhonesColumns.TYPE_PAGER ) );
230
// if this is the first number added, or it's a preferred number
231
// and the current primary number isn't, or this number is on equal
232
// standing with the primary number in terms of preference and it is
233
// a voice number and the primary number isn't, then record this as
234
// the primary number.
235
if( _primary_number == null ||
236
( is_preferred && !_primary_number_is_preferred ) ||
237
( is_preferred == _primary_number_is_preferred &&
238
!non_voice_types.contains( type ) &&
239
non_voice_types.contains( _primary_number_type ) ) )
241
_primary_number = number;
242
_primary_number_type = type;
243
_primary_number_is_preferred = is_preferred;
247
public boolean hasNumbers()
249
return _numbers != null && _numbers.size() > 0;
252
public HashMap< String, PreferredDetail > getNumbers()
257
public boolean hasPrimaryNumber()
259
return _primary_number != null;
262
public String getPrimaryNumber()
264
return _primary_number;
267
protected void addEmail( String email, int type, boolean is_preferred )
270
email = sanitisesEmailAddress( email );
273
// TODO: warn that an imported email address is being ignored
277
// add the email, as non-preferred (we prefer only one email in
278
// finalise() after they're all imported)
279
if( _emails == null )
280
_emails = new HashMap< String, PreferredDetail >();
130
protected void addPhone( String number, int type, boolean isPreferred )
132
if( _phones == null ) _phones = new HashMap< String, PhoneData >();
133
if( !_phones.containsKey( number ) )
135
new PhoneData( number, type, isPreferred ) );
138
protected void addEmail( String email, int type, boolean isPreferred )
140
if( _emails == null ) _emails = new HashMap< String, EmailData >();
281
141
if( !_emails.containsKey( email ) )
282
_emails.put( email, new PreferredDetail( type, false ) );
284
// if this is the first email added, or it's a preferred email and
285
// the current primary organisation isn't, then record this as the
287
if( _primary_email == null ||
288
( is_preferred && !_primary_email_is_preferred ) )
290
_primary_email = email;
291
_primary_email_is_preferred = is_preferred;
295
public boolean hasEmails()
297
return _emails != null && _emails.size() > 0;
300
public HashMap< String, PreferredDetail > getEmails()
305
public boolean hasPrimaryEmail()
307
return _primary_email != null;
310
public String getPrimaryEmail()
312
return _primary_email;
315
protected void addAddress( String address, int type )
317
address = address.trim();
318
if( address.length() <= 0 )
320
// TODO: warn that an imported address is being ignored
324
if( _addresses == null ) _addresses =
325
new HashMap< String, TypeDetail >();
326
if( !_addresses.containsKey( address ) )
327
_addresses.put( address, new TypeDetail( type ) );
330
public boolean hasAddresses()
332
return _addresses != null && _addresses.size() > 0;
335
public HashMap< String, TypeDetail > getAddresses()
340
protected void finalise()
341
throws ContactNotIdentifiableException
343
// ensure that if there is a primary number, it is preferred so
344
// that there is always one preferred number. Android will assign
345
// preference to one anyway so we might as well decide one sensibly.
346
if( _primary_number != null ) {
347
PreferredDetail data = _numbers.get( _primary_number );
348
_numbers.put( _primary_number,
349
new PreferredDetail( data.getType(), true ) );
352
// do the same for the primary email
353
if( _primary_email != null ) {
354
PreferredDetail data = _emails.get( _primary_email );
355
_emails.put( _primary_email,
356
new PreferredDetail( data.getType(), true ) );
359
// do the same for the primary organisation
360
if( _primary_organisation != null ) {
361
ExtraDetail data = _organisations.get( _primary_organisation );
362
_organisations.put( _primary_organisation,
363
new ExtraDetail( 0, true, data.getExtra() ) );
366
// create a cache identifier from this contact data, which can be
367
// used to look-up an existing contact
368
_cache_identifier = ContactsCache.createIdentifier( this );
369
if( _cache_identifier == null )
370
throw new ContactNotIdentifiableException();
373
public ContactsCache.CacheIdentifier getCacheIdentifier()
375
return _cache_identifier;
378
private String sanitisePhoneNumber( String number )
380
number = number.trim();
381
Pattern p = Pattern.compile( "^[-\\(\\) \\+0-9#*]+" );
382
Matcher m = p.matcher( number );
383
if( m.lookingAt() ) return m.group( 0 );
387
private String sanitisesEmailAddress( String email )
389
email = email.trim();
390
Pattern p = Pattern.compile(
391
"^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
392
Matcher m = p.matcher( email );
394
String[] bits = email.split( "@" );
395
return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase();
142
_emails.put( email, new EmailData( email, type, isPreferred ) );
401
@SuppressWarnings("serial")
402
146
protected class AbortImportException extends Exception { };
404
148
public Importer( Doit doit )
660
// It is expected that we use contact.getCacheIdentifier() here. The
661
// contact we are passed should have been successfully finalise()d,
662
// which includes generating a valid cache identifier.
663
ContactsCache.CacheIdentifier cache_identifier =
664
contact.getCacheIdentifier();
666
// check to see if this contact is a duplicate and should be skipped
667
if( !checkForDuplicate( cache_identifier, _merge_setting ) ) {
672
393
// if( !showContinue( "====[ IMPORTING ]====\n: " + contact._name ) )
673
394
// finish( ACTION_ABORT );
675
// keep track of whether we've informed the UI of what we're doing
676
boolean ui_informed = false;
678
// attempt to lookup the id of an existing contact in the cache with
679
// this contact data's cache identifier
680
Long id = (Long)_contacts_cache.lookup( cache_identifier );
396
ContentValues values = new ContentValues();
397
boolean uiInformed = false;
682
399
// does contact exist already?
400
Uri contactUri = null;
402
if( ( id = (Long)_contacts.get( contact._name ) ) != null )
685
404
// should we skip this import altogether?
686
if( _last_merge_decision == Doit.ACTION_KEEP ) return;
405
if( _lastMergeDecision == Doit.ACTION_KEEP ) return;
408
contactUri = ContentUris.withAppendedId(
409
Contacts.People.CONTENT_URI, id );
688
411
// should we destroy the existing contact before importing?
689
if( _last_merge_decision == Doit.ACTION_OVERWRITE )
691
// remove from device
692
_backend.deleteContact( id );
412
if( _lastMergeDecision == Doit.ACTION_OVERWRITE ) {
413
_doit.getContentResolver().delete( contactUri, null, null );
417
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTOVERWRITTEN );
695
_contacts_cache.removeLookup( cache_identifier );
696
_contacts_cache.removeAssociatedData( id );
698
// show that we're overwriting a contact
699
_doit._handler.sendEmptyMessage(
700
Doit.MESSAGE_CONTACTOVERWRITTEN );
703
// discard the contact id
421
_contacts.remove( contact._name );
708
// if we don't have a contact id yet (or we did, but we destroyed it
709
// when we deleted the contact), we'll have to create a new contact
425
// if we don't have a contact URI it is because the contact never
426
// existed or because we deleted it
427
if( contactUri == null )
712
429
// create a new contact
713
id = _backend.addContact( contact._name );
715
showError( R.string.error_unabletoaddcontact );
430
values.put( Contacts.People.NAME, contact._name );
431
contactUri = _doit.getContentResolver().insert(
432
Contacts.People.CONTENT_URI, values );
433
id = ContentUris.parseId( contactUri );
434
if( id <= 0 ) return; // shouldn't happen!
436
// add them to the "My Contacts" group
437
Contacts.People.addToGroup(
438
_doit.getContentResolver(), id,
439
Contacts.Groups.GROUP_MY_CONTACTS );
718
_contacts_cache.addLookup( cache_identifier, id );
442
_contacts.put( contact._name, id );
720
// if we haven't already shown that we're overwriting a contact,
721
// show that we're creating a new contact
723
446
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTCREATED );
728
// if we haven't already shown that we're overwriting or creating a
729
// contact, show that we're merging a contact
731
453
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
733
455
// import contact parts
734
if( contact.hasNumbers() )
735
importContactPhones( id, contact.getNumbers() );
736
if( contact.hasEmails() )
737
importContactEmails( id, contact.getEmails() );
738
if( contact.hasAddresses() )
739
importContactAddresses( id, contact.getAddresses() );
740
if( contact.hasOrganisations() )
741
importContactOrganisations( id, contact.getOrganisations() );
456
if( contact._phones != null )
457
importContactPhones( contactUri, contact._phones );
458
if( contact._emails != null )
459
importContactEmails( contactUri, contact._emails );
744
private void importContactPhones( Long id,
745
HashMap< String, ContactData.PreferredDetail > datas )
462
private void importContactPhones( Uri contactUri,
463
HashMap< String, ContactData.PhoneData > phones )
465
Long contactId = ContentUris.parseId( contactUri );
466
Uri contactPhonesUri = Uri.withAppendedPath( contactUri,
467
Contacts.People.Phones.CONTENT_DIRECTORY );
468
Set phonesKeys = phones.keySet();
747
470
// add phone numbers
748
Set< String > datas_keys = datas.keySet();
749
Iterator< String > i = datas_keys.iterator();
471
Iterator i = phonesKeys.iterator();
750
472
while( i.hasNext() ) {
751
String number = i.next();
752
ContactData.PreferredDetail data = datas.get( number );
473
ContactData.PhoneData phone = phones.get( i.next() );
754
475
// we don't want to add this number if it's crap, or it already
755
476
// exists (which would cause a duplicate to be created). We don't
758
479
// if the number exists at all, it doesn't need importing. Because
759
480
// of this, we also can't update the cache (which we don't need to
760
481
// anyway, so it's not a problem).
761
if( _contacts_cache.hasAssociatedNumber( id, number ) )
482
String number = sanitisePhoneNumber( phone._number );
483
if( number == null ) continue;
484
HashSet< String > numbers = _contactNumbers.get( contactId );
485
if( numbers != null && numbers.contains( number ) ) continue;
764
487
// add phone number
765
_backend.addContactPhone( id, number, data );
767
// and add this address to the cache to prevent a addition of
768
// duplicate date from another file
769
_contacts_cache.addAssociatedNumber( id, number );
488
ContentValues values = new ContentValues();
489
values.put( Contacts.Phones.TYPE, phone._type );
490
values.put( Contacts.Phones.NUMBER, phone._number );
491
if( phone._isPreferred ) values.put( Contacts.Phones.ISPRIMARY, 1 );
492
_doit.getContentResolver().insert( contactPhonesUri, values );
495
// now add those phone numbers to the cache to prevent the addition of
496
// duplicate data from another file
497
i = phonesKeys.iterator();
498
while( i.hasNext() ) {
499
ContactData.PhoneData phone = phones.get( i.next() );
501
String number = sanitisePhoneNumber( phone._number );
502
if( number != null ) {
503
HashSet< String > numbers = _contactNumbers.get( contactId );
504
if( numbers == null ) {
505
_contactNumbers.put( contactId, new HashSet< String >() );
506
numbers = _contactNumbers.get( contactId );
508
numbers.add( number );
773
private void importContactEmails( Long id,
774
HashMap< String, ContactData.PreferredDetail > datas )
513
private void importContactEmails( Uri contactUri,
514
HashMap< String, ContactData.EmailData > emails )
516
Long contactId = ContentUris.parseId( contactUri );
517
Uri contactContactMethodsUri = Uri.withAppendedPath( contactUri,
518
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
519
Set emailsKeys = emails.keySet();
776
521
// add email addresses
777
Set< String > datas_keys = datas.keySet();
778
Iterator< String > i = datas_keys.iterator();
522
Iterator i = emailsKeys.iterator();
779
523
while( i.hasNext() ) {
780
String email = i.next();
781
ContactData.PreferredDetail data = datas.get( email );
524
ContactData.EmailData email = emails.get( i.next() );
783
// we don't want to add this email address if it exists already or
784
// we would introduce duplicates.
785
if( _contacts_cache.hasAssociatedEmail( id, email ) )
526
// like with phone numbers, we don't want to add this email address
527
// if it exists already or we would introduce duplicates.
528
String address = sanitiseEmailAddress( email.getAddress() );
529
if( address == null ) continue;
530
HashSet< String > addresses = _contactEmails.get( contactId );
531
if( addresses != null && addresses.contains( address ) ) continue;
788
533
// add phone number
789
_backend.addContactEmail( id, email, data );
791
// and add this address to the cache to prevent a addition of
792
// duplicate date from another file
793
_contacts_cache.addAssociatedEmail( id, email );
797
private void importContactAddresses( Long id,
798
HashMap< String, ContactData.TypeDetail > datas )
801
Set< String > datas_keys = datas.keySet();
802
Iterator< String > i = datas_keys.iterator();
803
while( i.hasNext() ) {
804
String address = i.next();
805
ContactData.TypeDetail data = datas.get( address );
807
// we don't want to add this address if it exists already or we
808
// would introduce duplicates
809
if( _contacts_cache.hasAssociatedAddress( id, address ) )
812
// add postal address
813
_backend.addContactAddresses( id, address, data );
815
// and add this address to the cache to prevent a addition of
816
// duplicate date from another file
817
_contacts_cache.addAssociatedAddress( id, address );
821
private void importContactOrganisations( Long id,
822
HashMap< String, ContactData.ExtraDetail > datas )
825
Set< String > datas_keys = datas.keySet();
826
Iterator< String > i = datas_keys.iterator();
827
while( i.hasNext() ) {
828
String organisation = i.next();
829
ContactData.ExtraDetail data = datas.get( organisation );
831
// we don't want to add this address if it exists already or we
832
// would introduce duplicates
833
if( _contacts_cache.hasAssociatedOrganisation( id, organisation ) )
836
// add organisation address
837
_backend.addContactOrganisation( id, organisation, data );
839
// and add this address to the cache to prevent a addition of
840
// duplicate date from another file
841
_contacts_cache.addAssociatedOrganisation( id, organisation );
534
ContentValues values = new ContentValues();
535
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL );
536
values.put( Contacts.ContactMethods.DATA, email.getAddress() );
537
values.put( Contacts.ContactMethods.TYPE, email.getType() );
538
if( email.isPreferred() )
539
values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
540
_doit.getContentResolver().insert( contactContactMethodsUri,
544
// now add those email addresses to the cache to prevent the addition of
545
// duplicate data from another file
546
i = emailsKeys.iterator();
547
while( i.hasNext() ) {
548
ContactData.EmailData email = emails.get( i.next() );
550
String address = sanitiseEmailAddress( email.getAddress() );
551
if( address != null ) {
552
HashSet< String > addresses = _contactEmails.get( contactId );
553
if( addresses == null ) {
554
_contactEmails.put( contactId, new HashSet< String >() );
555
addresses = _contactEmails.get( contactId );
557
addresses.add( address );
849
566
throw new AbortImportException();
570
private void buildContactsCache() throws AbortImportException
573
setProgressMessage( R.string.doit_caching );
578
// init contacts caches
579
_contacts = new HashMap< String, Long >();
580
_contactNumbers = new HashMap< Long, HashSet< String > >();
581
_contactEmails = new HashMap< Long, HashSet< String > >();
583
// query and store map of contact names to ids
584
cols = new String[] { Contacts.People._ID, Contacts.People.NAME };
585
cur = _doit.managedQuery( Contacts.People.CONTENT_URI,
586
cols, null, null, null);
587
if( cur.moveToFirst() ) {
588
int idCol = cur.getColumnIndex( Contacts.People._ID );
589
int nameCol = cur.getColumnIndex( Contacts.People.NAME );
591
_contacts.put( cur.getString( nameCol ), cur.getLong( idCol ) );
592
} while( cur.moveToNext() );
595
// query and store map of contact ids to sets of phone numbers
596
cols = new String[] { Contacts.Phones.PERSON_ID,
597
Contacts.Phones.NUMBER };
598
cur = _doit.managedQuery( Contacts.Phones.CONTENT_URI,
599
cols, null, null, null);
600
if( cur.moveToFirst() ) {
601
int personIdCol = cur.getColumnIndex( Contacts.Phones.PERSON_ID );
602
int numberCol = cur.getColumnIndex( Contacts.Phones.NUMBER );
604
Long id = cur.getLong( personIdCol );
605
String number = sanitisePhoneNumber(
606
cur.getString( numberCol ) );
607
if( number != null ) {
608
HashSet< String > numbers = _contactNumbers.get( id );
609
if( numbers == null ) {
610
_contactNumbers.put( id, new HashSet< String >() );
611
numbers = _contactNumbers.get( id );
613
numbers.add( number );
615
} while( cur.moveToNext() );
618
// query and store map of contact ids to sets of email addresses
619
cols = new String[] { Contacts.ContactMethods.PERSON_ID,
620
Contacts.ContactMethods.DATA };
621
cur = _doit.managedQuery( Contacts.ContactMethods.CONTENT_URI,
622
cols, Contacts.ContactMethods.KIND + " = ?",
623
new String[] { "" + Contacts.KIND_EMAIL }, null );
624
if( cur.moveToFirst() ) {
625
int personIdCol = cur.getColumnIndex(
626
Contacts.ContactMethods.PERSON_ID );
627
int addressCol = cur.getColumnIndex(
628
Contacts.ContactMethods.DATA );
630
Long id = cur.getLong( personIdCol );
631
String address = sanitiseEmailAddress(
632
cur.getString( addressCol ) );
633
if( address != null ) {
634
HashSet< String > addresses = _contactEmails.get( id );
635
if( addresses == null ) {
636
_contactEmails.put( id, new HashSet< String >() );
637
addresses = _contactEmails.get( id );
639
addresses.add( address );
641
} while( cur.moveToNext() );
645
private String sanitisePhoneNumber( String number )
647
number = number.replaceAll( "[-\\(\\) ]", "" );
648
Pattern p = Pattern.compile( "^\\+?[0-9]+" );
649
Matcher m = p.matcher( number );
650
if( m.lookingAt() ) return m.group( 0 );
654
private String sanitiseEmailAddress( String address )
656
address = address.trim();
657
Pattern p = Pattern.compile(
658
"^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
659
Matcher m = p.matcher( address );
661
String[] bits = address.split( "@" );
662
return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase();