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;
57
private boolean _is_finished = false;
58
58
private ContactsCache _contactsCache = 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
568
return _doit.getText( res );
364
protected boolean isImportRequired( String name )
365
throws AbortImportException
571
protected boolean isImportRequired( ContactData contact )
572
throws AbortImportException, ContactNeedsMoreInfoException
368
return isImportRequired( name, _mergeSetting );
575
return isImportRequired( contact, _merge_setting );
371
synchronized private boolean isImportRequired( String name,
372
int mergeSetting ) throws AbortImportException
578
synchronized private boolean isImportRequired(
579
ContactData contact, int merge_setting )
580
throws AbortImportException, ContactNeedsMoreInfoException
374
_lastMergeDecision = mergeSetting;
582
_last_merge_decision = merge_setting;
584
// create a cache identifier which we can use to detect if this contact
585
// is valid for importing
586
ContactsCache.CacheIdentifier identifier =
587
ContactsCache.createIdentifier( contact );
588
if( identifier == null )
589
throw new ContactNeedsMoreInfoException();
376
591
// handle special cases
377
switch( mergeSetting )
592
switch( merge_setting )
379
594
case Doit.ACTION_KEEP:
380
595
// if we keep contacts on duplicate, we better check for one
381
return !_contactsCache.exists( name );
596
return !_contactsCache.canLookup( identifier );
383
598
case Doit.ACTION_PROMPT:
384
// if we are prompting on duplicate, we better check for one
385
if( !_contactsCache.exists( name ) )
599
// if we are prompting on duplicate, we better check for one and if
600
// the contact doesn'te exist, we want to import it
601
if( !_contactsCache.canLookup( identifier ) )
388
604
// ok, it exists, so do prompt
389
_doit._handler.sendMessage( Message.obtain(
390
_doit._handler, Doit.MESSAGE_MERGEPROMPT, name ) );
605
_doit._handler.sendMessage( Message.obtain( _doit._handler,
606
Doit.MESSAGE_MERGEPROMPT, identifier.getDetail() ) );
426
642
ContentValues values = new ContentValues();
427
643
boolean uiInformed = false;
646
// give the contact a chance to finalise it's data
649
// create something, from the contact data, that we can use to identify
650
// a cache entry and attempt to lookup the id of an existing contact in
652
ContactsCache.CacheIdentifier identifier =
653
ContactsCache.createIdentifier( contact );
654
if( identifier != null ) id = (Long)_contactsCache.lookup( identifier );
429
656
// does contact exist already?
430
Uri contactUri = null;
432
if( ( id = (Long)_contactsCache.getId( contact._name ) ) != null )
434
659
// should we skip this import altogether?
435
if( _lastMergeDecision == Doit.ACTION_KEEP ) return;
660
if( _last_merge_decision == Doit.ACTION_KEEP ) return;
437
662
// get contact's URI
438
contactUri = ContentUris.withAppendedId(
663
Uri contactUri = ContentUris.withAppendedId(
439
664
Contacts.People.CONTENT_URI, id );
441
666
// should we destroy the existing contact before importing?
442
if( _lastMergeDecision == Doit.ACTION_OVERWRITE ) {
667
if( _last_merge_decision == Doit.ACTION_OVERWRITE )
669
// remove from device
443
670
_doit.getContentResolver().delete( contactUri, null, null );
673
_contactsCache.removeLookup( identifier );
674
_contactsCache.removeAssociatedData( id );
676
// show that we're overwriting a contact
447
677
_doit._handler.sendEmptyMessage(
448
678
Doit.MESSAGE_CONTACTOVERWRITTEN );
449
679
uiInformed = true;
452
_contactsCache.remove( contact._name );
681
// 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 )
686
// if we don't have a contact id yet (or if we did, but we destroyed it
687
// when we deleted the contact), we'll have to create a new contact
460
690
// create a new contact
461
691
values.put( Contacts.People.NAME, contact._name );
462
contactUri = _doit.getContentResolver().insert(
692
Uri contactUri = _doit.getContentResolver().insert(
463
693
Contacts.People.CONTENT_URI, values );
464
694
id = ContentUris.parseId( contactUri );
465
if( id <= 0 ) return; // shouldn't happen!
695
if( id == null || id <= 0 )
696
showError( R.string.error_unabletoaddcontact );
467
698
// try to add them to the "My Contacts" group
477
_contactsCache.put( id, contact._name );
708
_contactsCache.addLookup(
709
ContactsCache.createIdentifier( contact ), id );
711
// if we haven't already shown that we're overwriting a contact,
712
// show that we're creating a new contact
480
713
if( !uiInformed ) {
481
714
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTCREATED );
482
715
uiInformed = true;
719
// if we haven't already shown that we're overwriting or creating a
720
// contact show that we're merging a contact
487
721
if( !uiInformed )
488
722
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
490
724
// 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 );
725
if( contact.hasNumbers() )
726
importContactPhones( id, contact.getNumbers() );
727
if( contact.hasEmails() )
728
importContactEmails( id, contact.getEmails() );
729
if( contact.hasAddresses() )
730
importContactAddresses( id, contact.getAddresses() );
731
if( contact.hasOrganisations() )
732
importContactOrganisations( id, contact.getOrganisations() );
499
private void importContactPhones( Uri contactUri,
500
HashMap< String, ContactData.PhoneData > phones )
735
private void importContactPhones( Long id,
736
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();
738
// get URI to contact's phones
739
Uri contactPhonesUri = Uri.withAppendedPath(
740
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
741
Contacts.People.Phones.CONTENT_DIRECTORY );
742
Set< String > datasKeys = datas.keySet();
507
744
// add phone numbers
508
Iterator< String > i = phonesKeys.iterator();
745
Iterator< String > i = datasKeys.iterator();
509
746
while( i.hasNext() ) {
510
ContactData.PhoneData phone = phones.get( i.next() );
747
String number = i.next();
748
ContactData.PreferredDetail data = datas.get( number );
512
750
// we don't want to add this number if it's crap, or it already
513
751
// exists (which would cause a duplicate to be created). We don't
516
754
// if the number exists at all, it doesn't need importing. Because
517
755
// of this, we also can't update the cache (which we don't need to
518
756
// 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;
757
if( _contactsCache.hasAssociatedNumber( id, number ) )
523
760
// add phone number
524
761
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 );
762
values.put( Contacts.Phones.TYPE, data.getType() );
763
values.put( Contacts.Phones.NUMBER, number );
764
if( data.isPreferred() )
765
values.put( Contacts.Phones.ISPRIMARY, 1 );
528
766
_doit.getContentResolver().insert( contactPhonesUri, values );
530
768
// and add this address to the cache to prevent a addition of
531
769
// duplicate date from another file
532
_contactsCache.addNumber( contactId, number );
770
_contactsCache.addAssociatedNumber( id, number );
536
private void importContactEmails( Uri contactUri,
537
HashMap< String, ContactData.EmailData > emails )
774
private void importContactEmails( Long id,
775
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();
777
// get URI to contact's contact methods
778
Uri contactContactMethodsUri = Uri.withAppendedPath(
779
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
780
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
781
Set< String > datasKeys = datas.keySet();
544
783
// add email addresses
545
Iterator< String > i = emailsKeys.iterator();
784
Iterator< String > i = datasKeys.iterator();
546
785
while( i.hasNext() ) {
547
ContactData.EmailData email = emails.get( i.next() );
786
String email = i.next();
787
ContactData.PreferredDetail data = datas.get( email );
549
789
// we don't want to add this email address if it exists already or
550
790
// we would introduce duplicates.
551
String address = sanitiseEmailAddress( email.getAddress() );
552
if( address == null ) continue;
553
if( _contactsCache.hasEmail( contactId, address ) ) continue;
791
if( _contactsCache.hasAssociatedEmail( id, email ) )
555
794
// add phone number
556
795
ContentValues values = new ContentValues();
557
796
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() )
797
values.put( Contacts.ContactMethods.DATA, email );
798
values.put( Contacts.ContactMethods.TYPE, data.getType() );
799
if( data.isPreferred() )
561
800
values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
562
801
_doit.getContentResolver().insert( contactContactMethodsUri,
565
804
// and add this address to the cache to prevent a addition of
566
805
// duplicate date from another file
567
_contactsCache.addEmail( contactId, address );
806
_contactsCache.addAssociatedEmail( id, email );
571
private void importContactAddresses( Uri contactUri,
572
HashMap< String, ContactData.AddressData > addresses )
810
private void importContactAddresses( Long id,
811
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();
813
// get URI to contact's contact methods
814
Uri contactContactMethodsUri = Uri.withAppendedPath(
815
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
816
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
580
Iterator< String > i = addressesKeys.iterator();
819
Set< String > datasKeys = datas.keySet();
820
Iterator< String > i = datasKeys.iterator();
581
821
while( i.hasNext() ) {
582
ContactData.AddressData address = addresses.get( i.next() );
822
String address = i.next();
823
ContactData.TypeDetail data = datas.get( address );
584
825
// we don't want to add this address if it exists already or we
585
826
// would introduce duplicates
586
if( address == null ) continue;
587
if( _contactsCache.hasAddress( contactId, address.getAddress() ) )
827
if( _contactsCache.hasAssociatedAddress( id, address ) )
590
830
// add postal address
591
831
ContentValues values = new ContentValues();
592
832
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_POSTAL );
593
values.put( Contacts.ContactMethods.DATA, address.getAddress() );
594
values.put( Contacts.ContactMethods.TYPE, address.getType() );
833
values.put( Contacts.ContactMethods.DATA, address );
834
values.put( Contacts.ContactMethods.TYPE, data.getType() );
595
835
_doit.getContentResolver().insert( contactContactMethodsUri,
598
838
// and add this address to the cache to prevent a addition of
599
839
// duplicate date from another file
600
_contactsCache.addAddress( contactId, address.getAddress() );
840
_contactsCache.addAssociatedAddress( id, address );
844
private void importContactOrganisations( Long id,
845
HashMap< String, ContactData.ExtraDetail > datas )
848
Set< String > datasKeys = datas.keySet();
849
Iterator< String > i = datasKeys.iterator();
850
while( i.hasNext() ) {
851
String organisation = i.next();
852
ContactData.ExtraDetail data = datas.get( organisation );
854
// we don't want to add this address if it exists already or we
855
// would introduce duplicates
856
if( _contactsCache.hasAssociatedOrganisation( id, organisation ) )
859
// add organisation address
860
ContentValues values = new ContentValues();
861
values.put( Contacts.Organizations.PERSON_ID, id );
862
values.put( Contacts.Organizations.COMPANY, organisation );
863
values.put( Contacts.ContactMethods.TYPE,
864
Contacts.OrganizationColumns.TYPE_WORK );
865
if( data.getExtra() != null )
866
values.put( Contacts.Organizations.TITLE, data.getExtra() );
867
_doit.getContentResolver().insert(
868
Contacts.Organizations.CONTENT_URI, values );
870
// and add this address to the cache to prevent a addition of
871
// duplicate date from another file
872
_contactsCache.addAssociatedOrganisation( id, organisation );