51
51
private Doit _doit;
52
52
private int _response;
53
private int _response_extra;
54
private int _merge_setting;
55
private int _last_merge_decision;
53
private int _responseExtra;
54
private int _mergeSetting;
55
private int _lastMergeDecision;
56
56
private boolean _abort = false;
57
private boolean _is_finished = false;
58
private ContactsCache _contacts_cache = null;
57
private boolean _isFinished = false;
58
private ContactsCache _contactsCache = null;
61
* Data about a contact
63
60
public class ContactData
69
public TypeDetail( int type )
80
class PreferredDetail extends TypeDetail
82
protected boolean _is_preferred;
84
public PreferredDetail( int type, boolean is_preferred )
87
_is_preferred = is_preferred;
90
public boolean isPreferred()
96
class ExtraDetail extends PreferredDetail
98
protected String _extra;
100
public ExtraDetail( int type, boolean is_preferred, String extra )
102
super( type, is_preferred );
104
if( extra != null ) extra = extra.trim();
108
public String getExtra()
113
public void setExtra( String extra )
115
if( extra != null ) extra = extra.trim();
120
@SuppressWarnings("serial")
121
protected class ContactNotIdentifiableException extends Exception
125
protected String _name = null;
126
protected String _primary_organisation = null;
127
protected boolean _primary_organisation_is_preferred = false;
128
protected String _primary_number = null;
129
protected boolean _primary_number_is_preferred = false;
130
protected String _primary_email = null;
131
protected boolean _primary_email_is_preferred = false;
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;
64
public String _number;
66
public boolean _isPreferred;
68
public PhoneData( String number, int type, boolean isPreferred ) {
71
_isPreferred = isPreferred;
74
public String getNumber() {
78
public int getType() {
82
public boolean isPreferred() {
89
private String _email;
91
private boolean _isPreferred;
93
public EmailData( String email, int type, boolean isPreferred ) {
96
_isPreferred = isPreferred;
99
public String getAddress() {
103
public int getType() {
107
public boolean isPreferred() {
114
private String _address;
117
public AddressData( String address, int type ) {
122
public String getAddress() {
126
public int getType() {
131
public String _name = null;
132
public HashMap< String, PhoneData > _phones = null;
133
public HashMap< String, EmailData > _emails = null;
134
public HashMap< String, AddressData > _addresses = null;
139
136
protected void setName( String name )
144
public boolean hasName()
146
return _name != null;
149
141
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 a previous organisation wasn't, then remember
179
// that this is 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
// if this is the first number added, or it's a preferred number
227
// and a previous number wasn't, then remember that this is the
229
if( _primary_number == null ||
230
( is_preferred && !_primary_number_is_preferred ) )
232
_primary_number = number;
233
_primary_number_is_preferred = is_preferred;
237
public boolean hasNumbers()
239
return _numbers != null && _numbers.size() > 0;
242
public HashMap< String, PreferredDetail > getNumbers()
247
public boolean hasPrimaryNumber()
249
return _primary_number != null;
252
public String getPrimaryNumber()
254
return _primary_number;
257
protected void addEmail( String email, int type, boolean is_preferred )
260
email = sanitisesEmailAddress( email );
263
// TODO: warn that an imported email addtrss is being ignored
267
// add the email, as non-preferred (we prefer only one email in
268
// finalise() after they're all imported)
269
if( _emails == null )
270
_emails = new HashMap< String, PreferredDetail >();
146
protected void addPhone( String number, int type, boolean isPreferred )
148
if( _phones == null ) _phones = new HashMap< String, PhoneData >();
149
if( !_phones.containsKey( number ) )
151
new PhoneData( number, type, isPreferred ) );
154
protected void addEmail( String email, int type, boolean isPreferred )
156
if( _emails == null ) _emails = new HashMap< String, EmailData >();
271
157
if( !_emails.containsKey( email ) )
272
_emails.put( email, new PreferredDetail( type, false ) );
274
// if this is the first email added, or it's a preferred email
275
// and a previous email wasn't, then remember that this is the
277
if( _primary_email == null ||
278
( is_preferred && !_primary_email_is_preferred ) )
280
_primary_email = email;
281
_primary_email_is_preferred = is_preferred;
285
public boolean hasEmails()
287
return _emails != null && _emails.size() > 0;
290
public HashMap< String, PreferredDetail > getEmails()
295
public boolean hasPrimaryEmail()
297
return _primary_email != null;
300
public String getPrimaryEmail()
302
return _primary_email;
158
_emails.put( email, new EmailData( email, type, isPreferred ) );
305
161
protected void addAddress( String address, int type )
307
address = address.trim();
308
if( address.length() <= 0 )
310
// TODO: warn that an imported address is being ignored
314
163
if( _addresses == null ) _addresses =
315
new HashMap< String, TypeDetail >();
164
new HashMap< String, AddressData >();
316
165
if( !_addresses.containsKey( address ) )
317
_addresses.put( address, new TypeDetail( type ) );
320
public boolean hasAddresses()
322
return _addresses != null && _addresses.size() > 0;
325
public HashMap< String, TypeDetail > getAddresses()
330
protected void finalise()
331
throws ContactNotIdentifiableException
333
// ensure that if there is a primary number, it is preferred so
334
// that there is always one preferred number. Android will assign
335
// preference to one anyway so we might as well decide one sensibly.
336
if( _primary_number != null ) {
337
PreferredDetail data = _numbers.get( _primary_number );
338
_numbers.put( _primary_number,
339
new PreferredDetail( data.getType(), true ) );
342
// do the same for the primary email
343
if( _primary_email != null ) {
344
PreferredDetail data = _emails.get( _primary_email );
345
_emails.put( _primary_email,
346
new PreferredDetail( data.getType(), true ) );
349
// do the same for the primary organisation
350
if( _primary_organisation != null ) {
351
ExtraDetail data = _organisations.get( _primary_organisation );
352
_organisations.put( _primary_organisation,
353
new ExtraDetail( 0, true, data.getExtra() ) );
356
// create a cache identifier from this contact data, which can be
357
// used to look-up an existing contact
358
_cache_identifier = ContactsCache.createIdentifier( this );
359
if( _cache_identifier == null )
360
throw new ContactNotIdentifiableException();
363
public ContactsCache.CacheIdentifier getCacheIdentifier()
365
return _cache_identifier;
368
private String sanitisePhoneNumber( String number )
370
number = number.trim();
371
Pattern p = Pattern.compile( "^[-\\(\\) \\+0-9#*]+" );
372
Matcher m = p.matcher( number );
373
if( m.lookingAt() ) return m.group( 0 );
377
private String sanitisesEmailAddress( String email )
379
email = email.trim();
380
Pattern p = Pattern.compile(
381
"^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
382
Matcher m = p.matcher( email );
384
String[] bits = email.split( "@" );
385
return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase();
166
_addresses.put( address, new AddressData( address, type ) );
644
// It is expected that we use contact.getCacheIdentifier() here. The
645
// contact we are passed should have been successfully finalise()d,
646
// which includes generating a valid cache identifier.
647
ContactsCache.CacheIdentifier cache_identifier =
648
contact.getCacheIdentifier();
650
// check to see if this contact is a duplicate and should be skipped
651
if( !checkForDuplicate( cache_identifier, _merge_setting ) ) {
656
423
// if( !showContinue( "====[ IMPORTING ]====\n: " + contact._name ) )
657
424
// finish( ACTION_ABORT );
659
// keep track of whether we've informed the UI of what we're doing
660
boolean ui_informed = false;
662
// attempt to lookup the id of an existing contact in the cache with
663
// this contact data's cache identifier
664
Long id = (Long)_contacts_cache.lookup( cache_identifier );
426
ContentValues values = new ContentValues();
427
boolean uiInformed = false;
666
429
// does contact exist already?
430
Uri contactUri = null;
432
if( ( id = (Long)_contactsCache.getId( contact._name ) ) != null )
669
434
// should we skip this import altogether?
670
if( _last_merge_decision == Doit.ACTION_KEEP ) return;
435
if( _lastMergeDecision == Doit.ACTION_KEEP ) return;
672
437
// get contact's URI
673
Uri contact_uri = ContentUris.withAppendedId(
438
contactUri = ContentUris.withAppendedId(
674
439
Contacts.People.CONTENT_URI, id );
676
441
// should we destroy the existing contact before importing?
677
if( _last_merge_decision == Doit.ACTION_OVERWRITE )
679
// remove from device
680
_doit.getContentResolver().delete( contact_uri, null, null );
683
_contacts_cache.removeLookup( contact.getCacheIdentifier() );
684
_contacts_cache.removeAssociatedData( id );
686
// show that we're overwriting a contact
442
if( _lastMergeDecision == Doit.ACTION_OVERWRITE ) {
443
_doit.getContentResolver().delete( contactUri, null, null );
687
447
_doit._handler.sendEmptyMessage(
688
448
Doit.MESSAGE_CONTACTOVERWRITTEN );
691
// discard the contact id
452
_contactsCache.remove( contact._name );
696
// if we don't have a contact id yet (or if we did, but we destroyed it
697
// when we deleted the contact), we'll have to create a new contact
456
// if we don't have a contact URI it is because the contact never
457
// existed or because we deleted it
458
if( contactUri == null )
700
460
// create a new contact
701
ContentValues values = new ContentValues();
702
461
values.put( Contacts.People.NAME, contact._name );
703
Uri contact_uri = _doit.getContentResolver().insert(
462
contactUri = _doit.getContentResolver().insert(
704
463
Contacts.People.CONTENT_URI, values );
705
id = ContentUris.parseId( contact_uri );
706
if( id == null || id <= 0 )
707
showError( R.string.error_unabletoaddcontact );
464
id = ContentUris.parseId( contactUri );
465
if( id <= 0 ) return; // shouldn't happen!
709
467
// try to add them to the "My Contacts" group
719
_contacts_cache.addLookup(
720
ContactsCache.createIdentifier( contact ), id );
477
_contactsCache.put( id, contact._name );
722
// if we haven't already shown that we're overwriting a contact,
723
// show that we're creating a new contact
725
481
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTCREATED );
730
// if we haven't already shown that we're overwriting or creating a
731
// contact, show that we're merging a contact
733
488
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
735
490
// 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() );
491
if( contact._phones != null )
492
importContactPhones( contactUri, contact._phones );
493
if( contact._emails != null )
494
importContactEmails( contactUri, contact._emails );
495
if( contact._addresses != null )
496
importContactAddresses( contactUri, contact._addresses );
746
private void importContactPhones( Long id,
747
HashMap< String, ContactData.PreferredDetail > datas )
499
private void importContactPhones( Uri contactUri,
500
HashMap< String, ContactData.PhoneData > phones )
749
// get URI to contact's phones
750
Uri contact_phones_uri = Uri.withAppendedPath(
751
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
752
Contacts.People.Phones.CONTENT_DIRECTORY );
753
Set< String > datas_keys = datas.keySet();
502
Long contactId = ContentUris.parseId( contactUri );
503
Uri contactPhonesUri = Uri.withAppendedPath( contactUri,
504
Contacts.People.Phones.CONTENT_DIRECTORY );
505
Set< String > phonesKeys = phones.keySet();
755
507
// add phone numbers
756
Iterator< String > i = datas_keys.iterator();
508
Iterator< String > i = phonesKeys.iterator();
757
509
while( i.hasNext() ) {
758
String number = i.next();
759
ContactData.PreferredDetail data = datas.get( number );
510
ContactData.PhoneData phone = phones.get( i.next() );
761
512
// we don't want to add this number if it's crap, or it already
762
513
// exists (which would cause a duplicate to be created). We don't
765
516
// if the number exists at all, it doesn't need importing. Because
766
517
// of this, we also can't update the cache (which we don't need to
767
518
// anyway, so it's not a problem).
768
if( _contacts_cache.hasAssociatedNumber( id, number ) )
519
String number = sanitisePhoneNumber( phone._number );
520
if( number == null ) continue;
521
if( _contactsCache.hasNumber( contactId, number ) ) continue;
771
523
// add phone number
772
524
ContentValues values = new ContentValues();
773
values.put( Contacts.Phones.TYPE, data.getType() );
774
values.put( Contacts.Phones.NUMBER, number );
775
if( data.isPreferred() )
776
values.put( Contacts.Phones.ISPRIMARY, 1 );
777
_doit.getContentResolver().insert( contact_phones_uri, values );
525
values.put( Contacts.Phones.TYPE, phone._type );
526
values.put( Contacts.Phones.NUMBER, phone._number );
527
if( phone._isPreferred ) values.put( Contacts.Phones.ISPRIMARY, 1 );
528
_doit.getContentResolver().insert( contactPhonesUri, values );
779
530
// and add this address to the cache to prevent a addition of
780
531
// duplicate date from another file
781
_contacts_cache.addAssociatedNumber( id, number );
532
_contactsCache.addNumber( contactId, number );
785
private void importContactEmails( Long id,
786
HashMap< String, ContactData.PreferredDetail > datas )
536
private void importContactEmails( Uri contactUri,
537
HashMap< String, ContactData.EmailData > emails )
788
// get URI to contact's contact methods
789
Uri contact_contact_methods_uri = Uri.withAppendedPath(
790
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
791
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
792
Set< String > datas_keys = datas.keySet();
539
Long contactId = ContentUris.parseId( contactUri );
540
Uri contactContactMethodsUri = Uri.withAppendedPath( contactUri,
541
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
542
Set< String > emailsKeys = emails.keySet();
794
544
// add email addresses
795
Iterator< String > i = datas_keys.iterator();
545
Iterator< String > i = emailsKeys.iterator();
796
546
while( i.hasNext() ) {
797
String email = i.next();
798
ContactData.PreferredDetail data = datas.get( email );
547
ContactData.EmailData email = emails.get( i.next() );
800
549
// we don't want to add this email address if it exists already or
801
550
// we would introduce duplicates.
802
if( _contacts_cache.hasAssociatedEmail( id, email ) )
551
String address = sanitiseEmailAddress( email.getAddress() );
552
if( address == null ) continue;
553
if( _contactsCache.hasEmail( contactId, address ) ) continue;
805
555
// add phone number
806
556
ContentValues values = new ContentValues();
807
557
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL );
808
values.put( Contacts.ContactMethods.DATA, email );
809
values.put( Contacts.ContactMethods.TYPE, data.getType() );
810
if( data.isPreferred() )
558
values.put( Contacts.ContactMethods.DATA, email.getAddress() );
559
values.put( Contacts.ContactMethods.TYPE, email.getType() );
560
if( email.isPreferred() )
811
561
values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
812
_doit.getContentResolver().insert( contact_contact_methods_uri,
562
_doit.getContentResolver().insert( contactContactMethodsUri,
815
565
// and add this address to the cache to prevent a addition of
816
566
// duplicate date from another file
817
_contacts_cache.addAssociatedEmail( id, email );
567
_contactsCache.addEmail( contactId, address );
821
private void importContactAddresses( Long id,
822
HashMap< String, ContactData.TypeDetail > datas )
571
private void importContactAddresses( Uri contactUri,
572
HashMap< String, ContactData.AddressData > addresses )
824
// get URI to contact's contact methods
825
Uri contact_contact_methods_uri = Uri.withAppendedPath(
826
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
827
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
574
Long contactId = ContentUris.parseId( contactUri );
575
Uri contactContactMethodsUri = Uri.withAppendedPath( contactUri,
576
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
577
Set< String > addressesKeys = addresses.keySet();
830
Set< String > datas_keys = datas.keySet();
831
Iterator< String > i = datas_keys.iterator();
580
Iterator< String > i = addressesKeys.iterator();
832
581
while( i.hasNext() ) {
833
String address = i.next();
834
ContactData.TypeDetail data = datas.get( address );
582
ContactData.AddressData address = addresses.get( i.next() );
836
584
// we don't want to add this address if it exists already or we
837
585
// would introduce duplicates
838
if( _contacts_cache.hasAssociatedAddress( id, address ) )
586
if( address == null ) continue;
587
if( _contactsCache.hasAddress( contactId, address.getAddress() ) )
841
590
// add postal address
842
591
ContentValues values = new ContentValues();
843
592
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_POSTAL );
844
values.put( Contacts.ContactMethods.DATA, address );
845
values.put( Contacts.ContactMethods.TYPE, data.getType() );
846
_doit.getContentResolver().insert( contact_contact_methods_uri,
593
values.put( Contacts.ContactMethods.DATA, address.getAddress() );
594
values.put( Contacts.ContactMethods.TYPE, address.getType() );
595
_doit.getContentResolver().insert( contactContactMethodsUri,
849
598
// and add this address to the cache to prevent a addition of
850
599
// duplicate date from another file
851
_contacts_cache.addAssociatedAddress( id, address );
855
private void importContactOrganisations( Long id,
856
HashMap< String, ContactData.ExtraDetail > datas )
859
Set< String > datas_keys = datas.keySet();
860
Iterator< String > i = datas_keys.iterator();
861
while( i.hasNext() ) {
862
String organisation = i.next();
863
ContactData.ExtraDetail data = datas.get( organisation );
865
// we don't want to add this address if it exists already or we
866
// would introduce duplicates
867
if( _contacts_cache.hasAssociatedOrganisation( id, organisation ) )
870
// add organisation address
871
ContentValues values = new ContentValues();
872
values.put( Contacts.Organizations.PERSON_ID, id );
873
values.put( Contacts.Organizations.COMPANY, organisation );
874
values.put( Contacts.ContactMethods.TYPE,
875
Contacts.OrganizationColumns.TYPE_WORK );
876
if( data.getExtra() != null )
877
values.put( Contacts.Organizations.TITLE, data.getExtra() );
878
_doit.getContentResolver().insert(
879
Contacts.Organizations.CONTENT_URI, values );
881
// and add this address to the cache to prevent a addition of
882
// duplicate date from another file
883
_contacts_cache.addAssociatedOrganisation( id, organisation );
600
_contactsCache.addAddress( contactId, address.getAddress() );