51
51
private Doit _doit;
52
52
private int _response;
53
private int _responseExtra;
54
private int _mergeSetting;
55
private int _lastMergeDecision;
53
private int _response_extra;
54
private int _merge_setting;
55
private int _last_merge_decision;
56
56
private boolean _abort = false;
57
private boolean _isFinished = false;
58
private ContactsCache _contactsCache = null;
57
private boolean _is_finished = false;
58
private ContactsCache _contacts_cache = null;
60
@SuppressWarnings("serial")
61
protected class ContactNeedsMoreInfoException extends Exception
66
* Data about a contact
60
68
public class ContactData
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;
74
public TypeDetail( int type )
85
class PreferredDetail extends TypeDetail
87
protected boolean _is_preferred;
89
public PreferredDetail( int type, boolean is_preferred )
92
_is_preferred = is_preferred;
95
public boolean isPreferred()
101
class ExtraDetail extends PreferredDetail
103
protected String _extra;
105
public ExtraDetail( int type, boolean is_preferred, String extra )
107
super( type, is_preferred );
109
if( extra != null ) extra = extra.trim();
113
public String getExtra()
118
public void setExtra( String extra )
120
if( extra != null ) extra = extra.trim();
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;
136
137
protected void setName( String name )
142
public boolean hasName()
144
return _name != null;
141
147
public String getName()
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 >();
152
protected void addOrganisation( String organisation, String title,
153
boolean is_preferred )
155
organisation = organisation.trim();
156
if( organisation.length() <= 0 )
158
// TODO: warn that an imported organisation is being ignored
162
if( title != null ) {
163
title = title.trim();
164
if( title.length() <= 0 ) title = null;
167
// add the organisation, as non-preferred (we prefer only one
168
// organisation in finalise() after they're all imported)
169
if( _organisations == null )
170
_organisations = new HashMap< String, ExtraDetail >();
171
if( !_organisations.containsKey( organisation ) )
172
_organisations.put( organisation,
173
new ExtraDetail( 0, false, title ) );
175
// if this is the first organisation added, or it's a preferred
176
// organisation and a previous organisation wasn't, then remember
177
// that this is the "primary organisation".
178
if( _primary_organisation == null ||
179
( is_preferred && !_primary_organisation_is_preferred ) )
181
_primary_organisation = organisation;
182
_primary_organisation_is_preferred = is_preferred;
186
public boolean hasOrganisations()
188
return _organisations != null && _organisations.size() > 0;
191
public HashMap< String, ExtraDetail > getOrganisations()
193
return _organisations;
196
public boolean hasPrimaryOrganisation()
198
return _primary_organisation != null;
201
public String getPrimaryOrganisation()
203
return _primary_organisation;
206
protected void addNumber( String number, int type,
207
boolean is_preferred )
209
number = sanitisePhoneNumber( number );
212
// TODO: warn that an imported phone number is being ignored
216
// add the number, as non-preferred (we prefer only one number
217
// in finalise() after they're all imported)
218
if( _numbers == null )
219
_numbers = new HashMap< String, PreferredDetail >();
220
if( !_numbers.containsKey( number ) )
221
_numbers.put( number,
222
new PreferredDetail( type, false ) );
224
// if this is the first number added, or it's a preferred number
225
// and a previous number wasn't, then remember that this is the
227
if( _primary_number == null ||
228
( is_preferred && !_primary_number_is_preferred ) )
230
_primary_number = number;
231
_primary_number_is_preferred = is_preferred;
235
public boolean hasNumbers()
237
return _numbers != null && _numbers.size() > 0;
240
public HashMap< String, PreferredDetail > getNumbers()
245
public boolean hasPrimaryNumber()
247
return _primary_number != null;
250
public String getPrimaryNumber()
252
return _primary_number;
255
protected void addEmail( String email, int type, boolean is_preferred )
258
email = sanitisesEmailAddress( email );
261
// TODO: warn that an imported email addtrss is being ignored
265
// add the email, as non-preferred (we prefer only one email in
266
// finalise() after they're all imported)
267
if( _emails == null )
268
_emails = new HashMap< String, PreferredDetail >();
157
269
if( !_emails.containsKey( email ) )
158
_emails.put( email, new EmailData( email, type, isPreferred ) );
270
_emails.put( email, new PreferredDetail( type, false ) );
272
// if this is the first email added, or it's a preferred email
273
// and a previous email wasn't, then remember that this is the
275
if( _primary_email == null ||
276
( is_preferred && !_primary_email_is_preferred ) )
278
_primary_email = email;
279
_primary_email_is_preferred = is_preferred;
283
public boolean hasEmails()
285
return _emails != null && _emails.size() > 0;
288
public HashMap< String, PreferredDetail > getEmails()
293
public boolean hasPrimaryEmail()
295
return _primary_email != null;
298
public String getPrimaryEmail()
300
return _primary_email;
161
303
protected void addAddress( String address, int type )
305
address = address.trim();
306
if( address.length() <= 0 )
308
// TODO: warn that an imported address is being ignored
163
312
if( _addresses == null ) _addresses =
164
new HashMap< String, AddressData >();
313
new HashMap< String, TypeDetail >();
165
314
if( !_addresses.containsKey( address ) )
166
_addresses.put( address, new AddressData( address, type ) );
315
_addresses.put( address, new TypeDetail( type ) );
318
public boolean hasAddresses()
320
return _addresses != null && _addresses.size() > 0;
323
public HashMap< String, TypeDetail > getAddresses()
328
protected void finalise()
330
// ensure that if there is a primary number, it is preferred so
331
// that there is always one preferred number. Android will assign
332
// preference to one anyway so we might as well decide one sensibly.
333
if( _primary_number != null ) {
334
PreferredDetail data = _numbers.get( _primary_number );
335
_numbers.put( _primary_number,
336
new PreferredDetail( data.getType(), true ) );
339
// do the same for the primary email
340
if( _primary_email != null ) {
341
PreferredDetail data = _emails.get( _primary_email );
342
_emails.put( _primary_email,
343
new PreferredDetail( data.getType(), true ) );
346
// do the same for the primary organisation
347
if( _primary_organisation != null ) {
348
ExtraDetail data = _organisations.get( _primary_organisation );
349
_organisations.put( _primary_organisation,
350
new ExtraDetail( 0, true, data.getExtra() ) );
354
private String sanitisePhoneNumber( String number )
356
number = number.trim();
357
Pattern p = Pattern.compile( "^[-\\(\\) \\+0-9#*]+" );
358
Matcher m = p.matcher( number );
359
if( m.lookingAt() ) return m.group( 0 );
363
private String sanitisesEmailAddress( String email )
365
email = email.trim();
366
Pattern p = Pattern.compile(
367
"^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
368
Matcher m = p.matcher( email );
370
String[] bits = email.split( "@" );
371
return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase();
361
569
return _doit.getText( res );
364
protected boolean isImportRequired( String name )
365
throws AbortImportException
572
protected boolean isImportRequired( ContactData contact )
573
throws AbortImportException, ContactNeedsMoreInfoException
368
return isImportRequired( name, _mergeSetting );
576
return isImportRequired( contact, _merge_setting );
371
synchronized private boolean isImportRequired( String name,
372
int mergeSetting ) throws AbortImportException
579
synchronized private boolean isImportRequired(
580
ContactData contact, int merge_setting )
581
throws AbortImportException, ContactNeedsMoreInfoException
374
_lastMergeDecision = mergeSetting;
583
_last_merge_decision = merge_setting;
585
// create a cache identifier which we can use to detect if this contact
586
// is valid for importing
587
ContactsCache.CacheIdentifier identifier =
588
ContactsCache.createIdentifier( contact );
589
if( identifier == null )
590
throw new ContactNeedsMoreInfoException();
376
592
// handle special cases
377
switch( mergeSetting )
593
switch( merge_setting )
379
595
case Doit.ACTION_KEEP:
380
596
// if we keep contacts on duplicate, we better check for one
381
return !_contactsCache.exists( name );
597
return !_contacts_cache.canLookup( identifier );
383
599
case Doit.ACTION_PROMPT:
384
// if we are prompting on duplicate, we better check for one
385
if( !_contactsCache.exists( name ) )
600
// if we are prompting on duplicate, we better check for one and if
601
// the contact doesn'te exist, we want to import it
602
if( !_contacts_cache.canLookup( identifier ) )
388
605
// ok, it exists, so do prompt
389
_doit._handler.sendMessage( Message.obtain(
390
_doit._handler, Doit.MESSAGE_MERGEPROMPT, name ) );
606
_doit._handler.sendMessage( Message.obtain( _doit._handler,
607
Doit.MESSAGE_MERGEPROMPT, identifier.getDetail() ) );
424
641
// finish( ACTION_ABORT );
426
643
ContentValues values = new ContentValues();
427
boolean uiInformed = false;
644
boolean ui_informed = false;
647
// give the contact a chance to finalise it's data
650
// create something, from the contact data, that we can use to identify
651
// a cache entry and attempt to lookup the id of an existing contact in
653
ContactsCache.CacheIdentifier identifier =
654
ContactsCache.createIdentifier( contact );
655
if( identifier != null ) id = (Long)_contacts_cache.lookup( identifier );
429
657
// does contact exist already?
430
Uri contactUri = null;
432
if( ( id = (Long)_contactsCache.getId( contact._name ) ) != null )
434
660
// should we skip this import altogether?
435
if( _lastMergeDecision == Doit.ACTION_KEEP ) return;
661
if( _last_merge_decision == Doit.ACTION_KEEP ) return;
437
663
// get contact's URI
438
contactUri = ContentUris.withAppendedId(
664
Uri contact_uri = ContentUris.withAppendedId(
439
665
Contacts.People.CONTENT_URI, id );
441
667
// should we destroy the existing contact before importing?
442
if( _lastMergeDecision == Doit.ACTION_OVERWRITE ) {
443
_doit.getContentResolver().delete( contactUri, null, null );
668
if( _last_merge_decision == Doit.ACTION_OVERWRITE )
670
// remove from device
671
_doit.getContentResolver().delete( contact_uri, null, null );
674
_contacts_cache.removeLookup( identifier );
675
_contacts_cache.removeAssociatedData( id );
677
// show that we're overwriting a contact
447
678
_doit._handler.sendEmptyMessage(
448
679
Doit.MESSAGE_CONTACTOVERWRITTEN );
452
_contactsCache.remove( contact._name );
682
// discard the contact id
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 )
687
// if we don't have a contact id yet (or if we did, but we destroyed it
688
// when we deleted the contact), we'll have to create a new contact
460
691
// create a new contact
461
692
values.put( Contacts.People.NAME, contact._name );
462
contactUri = _doit.getContentResolver().insert(
693
Uri contact_uri = _doit.getContentResolver().insert(
463
694
Contacts.People.CONTENT_URI, values );
464
id = ContentUris.parseId( contactUri );
465
if( id <= 0 ) return; // shouldn't happen!
695
id = ContentUris.parseId( contact_uri );
696
if( id == null || id <= 0 )
697
showError( R.string.error_unabletoaddcontact );
467
699
// try to add them to the "My Contacts" group
477
_contactsCache.put( id, contact._name );
709
_contacts_cache.addLookup(
710
ContactsCache.createIdentifier( contact ), id );
712
// if we haven't already shown that we're overwriting a contact,
713
// show that we're creating a new contact
481
715
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTCREATED );
720
// if we haven't already shown that we're overwriting or creating a
721
// contact show that we're merging a contact
488
723
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
490
725
// import contact parts
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 );
726
if( contact.hasNumbers() )
727
importContactPhones( id, contact.getNumbers() );
728
if( contact.hasEmails() )
729
importContactEmails( id, contact.getEmails() );
730
if( contact.hasAddresses() )
731
importContactAddresses( id, contact.getAddresses() );
732
if( contact.hasOrganisations() )
733
importContactOrganisations( id, contact.getOrganisations() );
499
private void importContactPhones( Uri contactUri,
500
HashMap< String, ContactData.PhoneData > phones )
736
private void importContactPhones( Long id,
737
HashMap< String, ContactData.PreferredDetail > datas )
502
Long contactId = ContentUris.parseId( contactUri );
503
Uri contactPhonesUri = Uri.withAppendedPath( contactUri,
504
Contacts.People.Phones.CONTENT_DIRECTORY );
505
Set< String > phonesKeys = phones.keySet();
739
// get URI to contact's phones
740
Uri contact_phones_uri = Uri.withAppendedPath(
741
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
742
Contacts.People.Phones.CONTENT_DIRECTORY );
743
Set< String > datas_keys = datas.keySet();
507
745
// add phone numbers
508
Iterator< String > i = phonesKeys.iterator();
746
Iterator< String > i = datas_keys.iterator();
509
747
while( i.hasNext() ) {
510
ContactData.PhoneData phone = phones.get( i.next() );
748
String number = i.next();
749
ContactData.PreferredDetail data = datas.get( number );
512
751
// we don't want to add this number if it's crap, or it already
513
752
// exists (which would cause a duplicate to be created). We don't
516
755
// if the number exists at all, it doesn't need importing. Because
517
756
// of this, we also can't update the cache (which we don't need to
518
757
// anyway, so it's not a problem).
519
String number = sanitisePhoneNumber( phone._number );
520
if( number == null ) continue;
521
if( _contactsCache.hasNumber( contactId, number ) ) continue;
758
if( _contacts_cache.hasAssociatedNumber( id, number ) )
523
761
// add phone number
524
762
ContentValues values = new ContentValues();
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 );
763
values.put( Contacts.Phones.TYPE, data.getType() );
764
values.put( Contacts.Phones.NUMBER, number );
765
if( data.isPreferred() )
766
values.put( Contacts.Phones.ISPRIMARY, 1 );
767
_doit.getContentResolver().insert( contact_phones_uri, values );
530
769
// and add this address to the cache to prevent a addition of
531
770
// duplicate date from another file
532
_contactsCache.addNumber( contactId, number );
771
_contacts_cache.addAssociatedNumber( id, number );
536
private void importContactEmails( Uri contactUri,
537
HashMap< String, ContactData.EmailData > emails )
775
private void importContactEmails( Long id,
776
HashMap< String, ContactData.PreferredDetail > datas )
539
Long contactId = ContentUris.parseId( contactUri );
540
Uri contactContactMethodsUri = Uri.withAppendedPath( contactUri,
541
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
542
Set< String > emailsKeys = emails.keySet();
778
// get URI to contact's contact methods
779
Uri contact_contact_methods_uri = Uri.withAppendedPath(
780
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
781
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
782
Set< String > datas_keys = datas.keySet();
544
784
// add email addresses
545
Iterator< String > i = emailsKeys.iterator();
785
Iterator< String > i = datas_keys.iterator();
546
786
while( i.hasNext() ) {
547
ContactData.EmailData email = emails.get( i.next() );
787
String email = i.next();
788
ContactData.PreferredDetail data = datas.get( email );
549
790
// we don't want to add this email address if it exists already or
550
791
// we would introduce duplicates.
551
String address = sanitiseEmailAddress( email.getAddress() );
552
if( address == null ) continue;
553
if( _contactsCache.hasEmail( contactId, address ) ) continue;
792
if( _contacts_cache.hasAssociatedEmail( id, email ) )
555
795
// add phone number
556
796
ContentValues values = new ContentValues();
557
797
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL );
558
values.put( Contacts.ContactMethods.DATA, email.getAddress() );
559
values.put( Contacts.ContactMethods.TYPE, email.getType() );
560
if( email.isPreferred() )
798
values.put( Contacts.ContactMethods.DATA, email );
799
values.put( Contacts.ContactMethods.TYPE, data.getType() );
800
if( data.isPreferred() )
561
801
values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
562
_doit.getContentResolver().insert( contactContactMethodsUri,
802
_doit.getContentResolver().insert( contact_contact_methods_uri,
565
805
// and add this address to the cache to prevent a addition of
566
806
// duplicate date from another file
567
_contactsCache.addEmail( contactId, address );
807
_contacts_cache.addAssociatedEmail( id, email );
571
private void importContactAddresses( Uri contactUri,
572
HashMap< String, ContactData.AddressData > addresses )
811
private void importContactAddresses( Long id,
812
HashMap< String, ContactData.TypeDetail > datas )
574
Long contactId = ContentUris.parseId( contactUri );
575
Uri contactContactMethodsUri = Uri.withAppendedPath( contactUri,
576
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
577
Set< String > addressesKeys = addresses.keySet();
814
// get URI to contact's contact methods
815
Uri contact_contact_methods_uri = Uri.withAppendedPath(
816
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
817
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
580
Iterator< String > i = addressesKeys.iterator();
820
Set< String > datas_keys = datas.keySet();
821
Iterator< String > i = datas_keys.iterator();
581
822
while( i.hasNext() ) {
582
ContactData.AddressData address = addresses.get( i.next() );
823
String address = i.next();
824
ContactData.TypeDetail data = datas.get( address );
584
826
// we don't want to add this address if it exists already or we
585
827
// would introduce duplicates
586
if( address == null ) continue;
587
if( _contactsCache.hasAddress( contactId, address.getAddress() ) )
828
if( _contacts_cache.hasAssociatedAddress( id, address ) )
590
831
// add postal address
591
832
ContentValues values = new ContentValues();
592
833
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_POSTAL );
593
values.put( Contacts.ContactMethods.DATA, address.getAddress() );
594
values.put( Contacts.ContactMethods.TYPE, address.getType() );
595
_doit.getContentResolver().insert( contactContactMethodsUri,
834
values.put( Contacts.ContactMethods.DATA, address );
835
values.put( Contacts.ContactMethods.TYPE, data.getType() );
836
_doit.getContentResolver().insert( contact_contact_methods_uri,
598
839
// and add this address to the cache to prevent a addition of
599
840
// duplicate date from another file
600
_contactsCache.addAddress( contactId, address.getAddress() );
841
_contacts_cache.addAssociatedAddress( id, address );
845
private void importContactOrganisations( Long id,
846
HashMap< String, ContactData.ExtraDetail > datas )
849
Set< String > datas_keys = datas.keySet();
850
Iterator< String > i = datas_keys.iterator();
851
while( i.hasNext() ) {
852
String organisation = i.next();
853
ContactData.ExtraDetail data = datas.get( organisation );
855
// we don't want to add this address if it exists already or we
856
// would introduce duplicates
857
if( _contacts_cache.hasAssociatedOrganisation( id, organisation ) )
860
// add organisation address
861
ContentValues values = new ContentValues();
862
values.put( Contacts.Organizations.PERSON_ID, id );
863
values.put( Contacts.Organizations.COMPANY, organisation );
864
values.put( Contacts.ContactMethods.TYPE,
865
Contacts.OrganizationColumns.TYPE_WORK );
866
if( data.getExtra() != null )
867
values.put( Contacts.Organizations.TITLE, data.getExtra() );
868
_doit.getContentResolver().insert(
869
Contacts.Organizations.CONTENT_URI, values );
871
// and add this address to the cache to prevent a addition of
872
// duplicate date from another file
873
_contacts_cache.addAssociatedOrganisation( id, organisation );