30
50
private Doit _doit;
31
51
private int _response;
32
private int _responseExtra;
33
private HashMap< String, Long > _contacts;
34
private HashMap< Long, HashSet< String > > _contactNumbers;
35
private HashMap< Long, HashSet< String > > _contactEmails;
36
private int _mergeSetting;
37
private int _lastMergeDecision;
52
private int _response_extra;
53
private int _merge_setting;
54
private int _last_merge_decision;
38
55
private boolean _abort = false;
39
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
41
63
public class ContactData
45
public String _number;
47
public boolean _isPreferred;
49
public PhoneData( String number, int type, boolean isPreferred ) {
52
_isPreferred = isPreferred;
55
public String getNumber() {
59
public int getType() {
63
public boolean isPreferred() {
70
private String _email;
72
private boolean _isPreferred;
74
public EmailData( String email, int type, boolean isPreferred ) {
77
_isPreferred = isPreferred;
80
public String getAddress() {
84
public int getType() {
88
public boolean isPreferred() {
93
public String _name = null;
94
public HashMap< String, PhoneData > _phones = null;
95
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;
144
protected HashSet< String > _notes = null;
146
private ContactsCache.CacheIdentifier _cache_identifier = null;
97
148
protected void setName( String name )
153
public boolean hasName()
155
return _name != null;
102
158
public String getName()
107
protected void addPhone( String number, int type, boolean isPreferred )
109
if( _phones == null ) _phones = new HashMap< String, PhoneData >();
110
if( !_phones.containsKey( number ) )
112
new PhoneData( number, type, isPreferred ) );
115
protected void addEmail( String email, int type, boolean isPreferred )
117
if( _emails == null ) _emails = new HashMap< String, EmailData >();
163
protected void addOrganisation( String organisation, String title,
164
boolean is_preferred )
166
organisation = organisation.trim();
167
if( organisation.length() <= 0 )
169
// TODO: warn that an imported organisation is being ignored
173
if( title != null ) {
174
title = title.trim();
175
if( title.length() <= 0 ) title = null;
178
// add the organisation, as non-preferred (we prefer only one
179
// organisation in finalise() after they're all imported)
180
if( _organisations == null )
181
_organisations = new HashMap< String, ExtraDetail >();
182
if( !_organisations.containsKey( organisation ) )
183
_organisations.put( organisation,
184
new ExtraDetail( 0, false, title ) );
186
// if this is the first organisation added, or it's a preferred
187
// organisation and the current primary organisation isn't, then
188
// record this as the primary organisation.
189
if( _primary_organisation == null ||
190
( is_preferred && !_primary_organisation_is_preferred ) )
192
_primary_organisation = organisation;
193
_primary_organisation_is_preferred = is_preferred;
197
public boolean hasOrganisations()
199
return _organisations != null && _organisations.size() > 0;
202
public HashMap< String, ExtraDetail > getOrganisations()
204
return _organisations;
207
public boolean hasPrimaryOrganisation()
209
return _primary_organisation != null;
212
public String getPrimaryOrganisation()
214
return _primary_organisation;
217
protected void addNumber( String number, int type,
218
boolean is_preferred )
220
number = sanitisePhoneNumber( number );
223
// TODO: warn that an imported phone number is being ignored
227
// add the number, as non-preferred (we prefer only one number
228
// in finalise() after they're all imported)
229
if( _numbers == null )
230
_numbers = new HashMap< String, PreferredDetail >();
231
if( !_numbers.containsKey( number ) )
232
_numbers.put( number,
233
new PreferredDetail( type, false ) );
235
final Set< Integer > non_voice_types = new HashSet< Integer >(
236
Arrays.asList( TYPE_FAX_HOME, TYPE_FAX_WORK, TYPE_PAGER ) );
238
// if this is the first number added, or it's a preferred number
239
// and the current primary number isn't, or this number is on equal
240
// standing with the primary number in terms of preference and it is
241
// a voice number and the primary number isn't, then record this as
242
// the primary number.
243
if( _primary_number == null ||
244
( is_preferred && !_primary_number_is_preferred ) ||
245
( is_preferred == _primary_number_is_preferred &&
246
!non_voice_types.contains( type ) &&
247
non_voice_types.contains( _primary_number_type ) ) )
249
_primary_number = number;
250
_primary_number_type = type;
251
_primary_number_is_preferred = is_preferred;
255
public boolean hasNumbers()
257
return _numbers != null && _numbers.size() > 0;
260
public HashMap< String, PreferredDetail > getNumbers()
265
public boolean hasPrimaryNumber()
267
return _primary_number != null;
270
public String getPrimaryNumber()
272
return _primary_number;
275
protected void addEmail( String email, int type, boolean is_preferred )
278
email = sanitisesEmailAddress( email );
281
// TODO: warn that an imported email address is being ignored
285
// add the email, as non-preferred (we prefer only one email in
286
// finalise() after they're all imported)
287
if( _emails == null )
288
_emails = new HashMap< String, PreferredDetail >();
118
289
if( !_emails.containsKey( email ) )
119
_emails.put( email, new EmailData( email, type, isPreferred ) );
290
_emails.put( email, new PreferredDetail( type, false ) );
292
// if this is the first email added, or it's a preferred email and
293
// the current primary organisation isn't, then record this as the
295
if( _primary_email == null ||
296
( is_preferred && !_primary_email_is_preferred ) )
298
_primary_email = email;
299
_primary_email_is_preferred = is_preferred;
303
public boolean hasEmails()
305
return _emails != null && _emails.size() > 0;
308
public HashMap< String, PreferredDetail > getEmails()
313
public boolean hasPrimaryEmail()
315
return _primary_email != null;
318
public String getPrimaryEmail()
320
return _primary_email;
323
protected void addAddress( String address, int type )
325
address = address.trim();
326
if( address.length() <= 0 )
328
// TODO: warn that an imported address is being ignored
332
if( _addresses == null ) _addresses =
333
new HashMap< String, TypeDetail >();
334
if( !_addresses.containsKey( address ) )
335
_addresses.put( address, new TypeDetail( type ) );
338
public boolean hasAddresses()
340
return _addresses != null && _addresses.size() > 0;
343
public HashMap< String, TypeDetail > getAddresses()
348
protected void addNote( String note )
350
if( _notes == null ) _notes = new HashSet< String >();
351
if( !_notes.contains( note ) )
355
public boolean hasNotes()
357
return _notes != null && _notes.size() > 0;
360
public HashSet< String > getNotes()
365
protected void finalise()
366
throws ContactNotIdentifiableException
368
// ensure that if there is a primary number, it is preferred so
369
// that there is always one preferred number. Android will assign
370
// preference to one anyway so we might as well decide one sensibly.
371
if( _primary_number != null ) {
372
PreferredDetail data = _numbers.get( _primary_number );
373
_numbers.put( _primary_number,
374
new PreferredDetail( data.getType(), true ) );
377
// do the same for the primary email
378
if( _primary_email != null ) {
379
PreferredDetail data = _emails.get( _primary_email );
380
_emails.put( _primary_email,
381
new PreferredDetail( data.getType(), true ) );
384
// do the same for the primary organisation
385
if( _primary_organisation != null ) {
386
ExtraDetail data = _organisations.get( _primary_organisation );
387
_organisations.put( _primary_organisation,
388
new ExtraDetail( 0, true, data.getExtra() ) );
391
// create a cache identifier from this contact data, which can be
392
// used to look-up an existing contact
393
_cache_identifier = ContactsCache.CacheIdentifier.factory( this );
394
if( _cache_identifier == null )
395
throw new ContactNotIdentifiableException();
398
public ContactsCache.CacheIdentifier getCacheIdentifier()
400
return _cache_identifier;
403
private String sanitisePhoneNumber( String number )
405
number = number.trim();
406
Pattern p = Pattern.compile( "^[-\\(\\) \\+0-9#*]+" );
407
Matcher m = p.matcher( number );
408
if( m.lookingAt() ) return m.group( 0 );
412
private String sanitisesEmailAddress( String email )
414
email = email.trim();
415
Pattern p = Pattern.compile(
416
"^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
417
Matcher m = p.matcher( email );
419
String[] bits = email.split( "@" );
420
return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase( Locale.US );
426
@SuppressWarnings("serial")
123
427
protected class AbortImportException extends Exception { };
125
429
public Importer( Doit doit )
689
// It is expected that we use contact.getCacheIdentifier() here. The
690
// contact we are passed should have been successfully finalise()d,
691
// which includes generating a valid cache identifier.
692
ContactsCache.CacheIdentifier cache_identifier =
693
contact.getCacheIdentifier();
370
695
// if( !showContinue( "====[ IMPORTING ]====\n: " + contact._name ) )
371
696
// finish( ACTION_ABORT );
373
ContentValues values = new ContentValues();
374
boolean uiInformed = false;
376
// does contact exist already?
377
Uri contactUri = null;
379
if( ( id = (Long)_contacts.get( contact._name ) ) != null )
381
// should we skip this import altogether?
382
if( _lastMergeDecision == R.id.merge_keep ) return;
385
contactUri = ContentUris.withAppendedId(
386
Contacts.People.CONTENT_URI, id );
388
// should we destroy the existing contact before importing?
389
if( _lastMergeDecision == R.id.merge_overwrite ) {
390
_doit.getContentResolver().delete( contactUri, null, null );
394
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTOVERWRITTEN );
698
// attempt to lookup the id of an existing contact in the cache with
699
// this contact data's cache identifier
700
Long id = (Long)_contacts_cache.lookup( cache_identifier );
702
// check to see if this contact should be skipped
703
if( shouldWeSkipContact( cache_identifier.getDetail(), id != null,
706
// show that we're skipping a contact
707
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTSKIPPED );
711
// if a contact exists, and we're overwriting, destroy the existing
712
// contact before importing
713
boolean contact_deleted = false;
714
if( id != null && _last_merge_decision == Doit.ACTION_OVERWRITE )
716
contact_deleted = true;
718
// remove from device
719
_backend.deleteContact( id );
722
_contacts_cache.removeLookup( cache_identifier );
723
_contacts_cache.removeAssociatedData( id );
725
// show that we're overwriting a contact
726
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTOVERWRITTEN );
728
// discard the contact id
733
// if we don't have a contact id yet (or we did, but we destroyed it
734
// when we deleted the contact), we'll have to create a new contact
737
// create a new contact
738
id = _backend.addContact( contact._name );
398
_contacts.remove( contact._name );
741
_contacts_cache.addLookup( cache_identifier, id );
743
// if we haven't already shown that we're overwriting a contact,
744
// show that we're creating a new contact
745
if( !contact_deleted )
746
_doit._handler.sendEmptyMessage(
747
Doit.MESSAGE_CONTACTCREATED );
750
// show that we're merging with an existing contact
751
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
753
// import contact parts
754
if( contact.hasNumbers() )
755
importContactPhones( id, contact.getNumbers() );
756
if( contact.hasEmails() )
757
importContactEmails( id, contact.getEmails() );
758
if( contact.hasAddresses() )
759
importContactAddresses( id, contact.getAddresses() );
760
if( contact.hasOrganisations() )
761
importContactOrganisations( id, contact.getOrganisations() );
762
if( contact.hasNotes() )
763
importContactNotes( id, contact.getNotes() );
402
// if we don't have a contact URI it is because the contact never
403
// existed or because we deleted it
404
if( contactUri == null )
765
catch( Backend.ContactCreationException e )
406
// create a new contact
407
values.put( Contacts.People.NAME, contact._name );
408
contactUri = _doit.getContentResolver().insert(
409
Contacts.People.CONTENT_URI, values );
410
id = ContentUris.parseId( contactUri );
411
if( id <= 0 ) return; // shouldn't happen!
413
// add them to the "My Contacts" group
414
Contacts.People.addToGroup(
415
_doit.getContentResolver(), id,
416
Contacts.Groups.GROUP_MY_CONTACTS );
419
_contacts.put( contact._name, id );
423
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTCREATED );
767
showError( R.string.error_unabletoaddcontact );
430
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
432
// import contact parts
433
if( contact._phones != null )
434
importContactPhones( contactUri, contact._phones );
435
if( contact._emails != null )
436
importContactEmails( contactUri, contact._emails );
439
private void importContactPhones( Uri contactUri,
440
HashMap< String, ContactData.PhoneData > phones )
771
private void importContactPhones( Long id,
772
HashMap< String, ContactData.PreferredDetail > datas )
773
throws ContactCreationException
442
Long contactId = ContentUris.parseId( contactUri );
443
Uri contactPhonesUri = Uri.withAppendedPath( contactUri,
444
Contacts.People.Phones.CONTENT_DIRECTORY );
446
775
// add phone numbers
447
Set phonesKeys = phones.keySet();
448
Iterator i = phonesKeys.iterator();
776
Set< String > datas_keys = datas.keySet();
777
Iterator< String > i = datas_keys.iterator();
449
778
while( i.hasNext() ) {
450
ContactData.PhoneData phone = phones.get( i.next() );
779
String number = i.next();
780
ContactData.PreferredDetail data = datas.get( number );
452
782
// we don't want to add this number if it's crap, or it already
453
783
// exists (which would cause a duplicate to be created). We don't
456
786
// if the number exists at all, it doesn't need importing. Because
457
787
// of this, we also can't update the cache (which we don't need to
458
788
// anyway, so it's not a problem).
459
String number = sanitisePhoneNumber( phone._number );
460
if( number == null ) continue;
461
HashSet< String > numbers = _contactNumbers.get( contactId );
462
if( numbers != null && numbers.contains( number ) ) continue;
465
ContentValues values = new ContentValues();
466
values.put( Contacts.Phones.TYPE, phone._type );
467
values.put( Contacts.Phones.NUMBER, phone._number );
468
if( phone._isPreferred ) values.put( Contacts.Phones.ISPRIMARY, 1 );
469
_doit.getContentResolver().insert( contactPhonesUri, values );
473
private void importContactEmails( Uri contactUri,
474
HashMap< String, ContactData.EmailData > emails )
476
Long contactId = ContentUris.parseId( contactUri );
477
Uri contactContactMethodsUri = Uri.withAppendedPath( contactUri,
478
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
481
Set emailsKeys = emails.keySet();
482
Iterator i = emailsKeys.iterator();
483
while( i.hasNext() ) {
484
ContactData.EmailData email = emails.get( i.next() );
486
// like with phone numbers, we don't want to add this email address
487
// if it exists already or we would introduce duplicates.
488
String address = sanitiseEmailAddress( email.getAddress() );
489
if( address == null ) continue;
490
HashSet< String > addresses = _contactEmails.get( contactId );
491
if( addresses != null && addresses.contains( address ) ) continue;
494
ContentValues values = new ContentValues();
495
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL );
496
values.put( Contacts.ContactMethods.DATA, email.getAddress() );
497
values.put( Contacts.ContactMethods.TYPE, email.getType() );
498
if( email.isPreferred() )
499
values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
500
_doit.getContentResolver().insert( contactContactMethodsUri,
789
if( _contacts_cache.hasAssociatedNumber( id, number ) )
793
_backend.addContactPhone( id, number, data );
795
// and add this address to the cache to prevent a addition of
796
// duplicate date from another file
797
_contacts_cache.addAssociatedNumber( id, number );
801
private void importContactEmails( Long id,
802
HashMap< String, ContactData.PreferredDetail > datas )
803
throws ContactCreationException
805
// add email addresses
806
Set< String > datas_keys = datas.keySet();
807
Iterator< String > i = datas_keys.iterator();
808
while( i.hasNext() ) {
809
String email = i.next();
810
ContactData.PreferredDetail data = datas.get( email );
812
// we don't want to add this email address if it exists already or
813
// we would introduce duplicates.
814
if( _contacts_cache.hasAssociatedEmail( id, email ) )
818
_backend.addContactEmail( id, email, data );
820
// and add this address to the cache to prevent a addition of
821
// duplicate date from another file
822
_contacts_cache.addAssociatedEmail( id, email );
826
private void importContactAddresses( Long id,
827
HashMap< String, ContactData.TypeDetail > datas )
828
throws ContactCreationException
831
Set< String > datas_keys = datas.keySet();
832
Iterator< String > i = datas_keys.iterator();
833
while( i.hasNext() ) {
834
String address = i.next();
835
ContactData.TypeDetail data = datas.get( address );
837
// we don't want to add this address if it exists already or we
838
// would introduce duplicates
839
if( _contacts_cache.hasAssociatedAddress( id, address ) )
842
// add postal address
843
_backend.addContactAddresses( id, address, data );
845
// and add this address to the cache to prevent a addition of
846
// duplicate date from another file
847
_contacts_cache.addAssociatedAddress( id, address );
851
private void importContactOrganisations( Long id,
852
HashMap< String, ContactData.ExtraDetail > datas )
853
throws ContactCreationException
856
Set< String > datas_keys = datas.keySet();
857
Iterator< String > i = datas_keys.iterator();
858
while( i.hasNext() ) {
859
String organisation = i.next();
860
ContactData.ExtraDetail data = datas.get( organisation );
862
// we don't want to add this address if it exists already or we
863
// would introduce duplicates
864
if( _contacts_cache.hasAssociatedOrganisation( id, organisation ) )
867
// add organisation address
868
_backend.addContactOrganisation( id, organisation, data );
870
// and add this address to the cache to prevent a addition of
871
// duplicate date from another file
872
_contacts_cache.addAssociatedOrganisation( id, organisation );
876
private void importContactNotes( Long id,
877
HashSet< String > datas )
878
throws ContactCreationException
881
Iterator< String > i = datas.iterator();
882
while( i.hasNext() ) {
883
String note = i.next();
885
// we don't want to add this note if it exists already or we would
886
// introduce duplicates
887
if( _contacts_cache.hasAssociatedNote( id, note ) )
891
_backend.addContactNote( id, note );
893
// and add this note to the cache to prevent a addition of duplicate
894
// date from another file
895
_contacts_cache.addAssociatedNote( id, note );
505
900
synchronized protected void checkAbort() throws AbortImportException
509
904
throw new AbortImportException();
513
private void buildContactsCache() throws AbortImportException
516
setProgressMessage( R.string.doit_caching );
521
// init contacts caches
522
_contacts = new HashMap< String, Long >();
523
_contactNumbers = new HashMap< Long, HashSet< String > >();
524
_contactEmails = new HashMap< Long, HashSet< String > >();
526
// query and store map of contact names to ids
527
cols = new String[] { Contacts.People._ID, Contacts.People.NAME };
528
cur = _doit.managedQuery( Contacts.People.CONTENT_URI,
529
cols, null, null, null);
530
if( cur.moveToFirst() ) {
531
int idCol = cur.getColumnIndex( Contacts.People._ID );
532
int nameCol = cur.getColumnIndex( Contacts.People.NAME );
534
_contacts.put( cur.getString( nameCol ), cur.getLong( idCol ) );
535
} while( cur.moveToNext() );
538
// query and store map of contact ids to sets of phone numbers
539
cols = new String[] { Contacts.Phones.PERSON_ID,
540
Contacts.Phones.NUMBER };
541
cur = _doit.managedQuery( Contacts.Phones.CONTENT_URI,
542
cols, null, null, null);
543
if( cur.moveToFirst() ) {
544
int personIdCol = cur.getColumnIndex( Contacts.Phones.PERSON_ID );
545
int numberCol = cur.getColumnIndex( Contacts.Phones.NUMBER );
547
Long id = cur.getLong( personIdCol );
548
String number = sanitisePhoneNumber(
549
cur.getString( numberCol ) );
550
if( number != null ) {
551
HashSet< String > numbers = _contactNumbers.get( id );
552
if( numbers == null ) {
553
_contactNumbers.put( id, new HashSet< String >() );
554
numbers = _contactNumbers.get( id );
556
numbers.add( number );
558
} while( cur.moveToNext() );
561
// query and store map of contact ids to sets of email addresses
562
cols = new String[] { Contacts.ContactMethods.PERSON_ID,
563
Contacts.ContactMethods.DATA };
564
cur = _doit.managedQuery( Contacts.ContactMethods.CONTENT_URI,
565
cols, Contacts.ContactMethods.KIND + " = ?",
566
new String[] { "" + Contacts.KIND_EMAIL }, null );
567
if( cur.moveToFirst() ) {
568
int personIdCol = cur.getColumnIndex(
569
Contacts.ContactMethods.PERSON_ID );
570
int addressCol = cur.getColumnIndex(
571
Contacts.ContactMethods.DATA );
573
Long id = cur.getLong( personIdCol );
574
String address = sanitiseEmailAddress(
575
cur.getString( addressCol ) );
576
if( address != null ) {
577
HashSet< String > addresses = _contactEmails.get( id );
578
if( addresses == null ) {
579
_contactEmails.put( id, new HashSet< String >() );
580
addresses = _contactEmails.get( id );
582
addresses.add( address );
584
} while( cur.moveToNext() );
588
private String sanitisePhoneNumber( String number )
590
number = number.replaceAll( "[-\\(\\) ]", "" );
591
Pattern p = Pattern.compile( "^\\+?[0-9]+" );
592
Matcher m = p.matcher( number );
593
if( m.lookingAt() ) return m.group( 0 );
597
private String sanitiseEmailAddress( String address )
599
address = address.trim();
600
Pattern p = Pattern.compile(
601
"^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
602
Matcher m = p.matcher( address );
604
String[] bits = address.split( "@" );
605
return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase();