606
568
return _doit.getText( res );
610
* Should we skip a contact, given whether it exists or not and the current
611
* merge setting? This routine handles throwing up a prompt, if required.
612
* @param contact_detail the display name of the contact
613
* @param exists true if this contact matches one in the cache
614
* @param merge_setting the merge setting to use
615
* @return true if the contact should be skipped outright
616
* @throws AbortImportException
618
synchronized private boolean shouldWeSkipContact( String contact_detail,
619
boolean exists, int merge_setting ) throws AbortImportException
571
protected boolean isImportRequired( ContactData contact )
572
throws AbortImportException, ContactNeedsMoreInfoException
575
return isImportRequired( contact, _merge_setting );
578
synchronized private boolean isImportRequired(
579
ContactData contact, int merge_setting )
580
throws AbortImportException, ContactNeedsMoreInfoException
621
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();
623
591
// handle special cases
624
592
switch( merge_setting )
626
594
case Doit.ACTION_KEEP:
627
// if we are skipping on a duplicate, check for one
595
// if we keep contacts on duplicate, we better check for one
596
return !_contactsCache.canLookup( identifier );
630
598
case Doit.ACTION_PROMPT:
631
// if we are prompting on duplicate, then we can say that we won't
632
// skip if there isn't one
633
if( !exists ) return false;
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 ) )
635
// ok, duplicate exists, so do prompt
604
// ok, it exists, so do prompt
636
605
_doit._handler.sendMessage( Message.obtain( _doit._handler,
637
Doit.MESSAGE_MERGEPROMPT, contact_detail ) );
606
Doit.MESSAGE_MERGEPROMPT, identifier.getDetail() ) );
671
// It is expected that we use contact.getCacheIdentifier() here. The
672
// contact we are passed should have been successfully finalise()d,
673
// which includes generating a valid cache identifier.
674
ContactsCache.CacheIdentifier cache_identifier =
675
contact.getCacheIdentifier();
677
639
// if( !showContinue( "====[ IMPORTING ]====\n: " + contact._name ) )
678
640
// finish( ACTION_ABORT );
680
// attempt to lookup the id of an existing contact in the cache with
681
// this contact data's cache identifier
682
Long id = (Long)_contacts_cache.lookup( cache_identifier );
684
// check to see if this contact should be skipped
685
if( shouldWeSkipContact( cache_identifier.getDetail(), id != null,
642
ContentValues values = new ContentValues();
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 );
656
// does contact exist already?
688
// show that we're skipping a contact
689
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTSKIPPED );
659
// should we skip this import altogether?
660
if( _last_merge_decision == Doit.ACTION_KEEP ) return;
663
Uri contactUri = ContentUris.withAppendedId(
664
Contacts.People.CONTENT_URI, id );
666
// should we destroy the existing contact before importing?
667
if( _last_merge_decision == Doit.ACTION_OVERWRITE )
669
// remove from device
670
_doit.getContentResolver().delete( contactUri, null, null );
673
_contactsCache.removeLookup( identifier );
674
_contactsCache.removeAssociatedData( id );
676
// show that we're overwriting a contact
677
_doit._handler.sendEmptyMessage(
678
Doit.MESSAGE_CONTACTOVERWRITTEN );
681
// discard the contact id
693
// if a contact exists, and we're overwriting, destroy the existing
694
// contact before importing
695
boolean contact_deleted = false;
696
if( id != null && _last_merge_decision == Doit.ACTION_OVERWRITE )
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
698
contact_deleted = true;
690
// create a new contact
691
values.put( Contacts.People.NAME, contact._name );
692
Uri contactUri = _doit.getContentResolver().insert(
693
Contacts.People.CONTENT_URI, values );
694
id = ContentUris.parseId( contactUri );
695
if( id == null || id <= 0 )
696
showError( R.string.error_unabletoaddcontact );
700
// remove from device
701
_backend.deleteContact( id );
698
// try to add them to the "My Contacts" group
700
Contacts.People.addToMyContactsGroup(
701
_doit.getContentResolver(), id );
703
catch( IllegalStateException e ) {
704
// ignore any failure
704
_contacts_cache.removeLookup( cache_identifier );
705
_contacts_cache.removeAssociatedData( id );
707
// show that we're overwriting a contact
708
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTOVERWRITTEN );
710
// discard the contact id
715
// if we don't have a contact id yet (or we did, but we destroyed it
716
// when we deleted the contact), we'll have to create a new contact
719
// create a new contact
720
id = _backend.addContact( contact._name );
723
_contacts_cache.addLookup( cache_identifier, id );
725
// if we haven't already shown that we're overwriting a contact,
726
// show that we're creating a new contact
727
if( !contact_deleted )
728
_doit._handler.sendEmptyMessage(
729
Doit.MESSAGE_CONTACTCREATED );
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
714
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTCREATED );
732
// show that we're merging with an existing contact
733
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
735
// 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() );
745
catch( Backend.ContactCreationException e )
747
showError( R.string.error_unabletoaddcontact );
719
// if we haven't already shown that we're overwriting or creating a
720
// contact show that we're merging a contact
722
_doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
724
// import contact parts
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() );
751
735
private void importContactPhones( Long id,
752
HashMap< String, ContactData.PreferredDetail > datas )
753
throws ContactCreationException
736
HashMap< String, ContactData.PreferredDetail > datas )
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();
755
744
// add phone numbers
756
Set< String > datas_keys = datas.keySet();
757
Iterator< String > i = datas_keys.iterator();
745
Iterator< String > i = datasKeys.iterator();
758
746
while( i.hasNext() ) {
759
747
String number = i.next();
760
748
ContactData.PreferredDetail data = datas.get( number );
766
754
// if the number exists at all, it doesn't need importing. Because
767
755
// of this, we also can't update the cache (which we don't need to
768
756
// anyway, so it's not a problem).
769
if( _contacts_cache.hasAssociatedNumber( id, number ) )
757
if( _contactsCache.hasAssociatedNumber( id, number ) )
772
760
// add phone number
773
_backend.addContactPhone( id, number, data );
761
ContentValues values = new ContentValues();
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 );
766
_doit.getContentResolver().insert( contactPhonesUri, values );
775
768
// and add this address to the cache to prevent a addition of
776
769
// duplicate date from another file
777
_contacts_cache.addAssociatedNumber( id, number );
770
_contactsCache.addAssociatedNumber( id, number );
781
774
private void importContactEmails( Long id,
782
HashMap< String, ContactData.PreferredDetail > datas )
783
throws ContactCreationException
775
HashMap< String, ContactData.PreferredDetail > datas )
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();
785
783
// add email addresses
786
Set< String > datas_keys = datas.keySet();
787
Iterator< String > i = datas_keys.iterator();
784
Iterator< String > i = datasKeys.iterator();
788
785
while( i.hasNext() ) {
789
786
String email = i.next();
790
787
ContactData.PreferredDetail data = datas.get( email );
792
789
// we don't want to add this email address if it exists already or
793
790
// we would introduce duplicates.
794
if( _contacts_cache.hasAssociatedEmail( id, email ) )
791
if( _contactsCache.hasAssociatedEmail( id, email ) )
797
794
// add phone number
798
_backend.addContactEmail( id, email, data );
795
ContentValues values = new ContentValues();
796
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL );
797
values.put( Contacts.ContactMethods.DATA, email );
798
values.put( Contacts.ContactMethods.TYPE, data.getType() );
799
if( data.isPreferred() )
800
values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
801
_doit.getContentResolver().insert( contactContactMethodsUri,
800
804
// and add this address to the cache to prevent a addition of
801
805
// duplicate date from another file
802
_contacts_cache.addAssociatedEmail( id, email );
806
_contactsCache.addAssociatedEmail( id, email );
806
810
private void importContactAddresses( Long id,
807
811
HashMap< String, ContactData.TypeDetail > datas )
808
throws ContactCreationException
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 );
811
Set< String > datas_keys = datas.keySet();
812
Iterator< String > i = datas_keys.iterator();
819
Set< String > datasKeys = datas.keySet();
820
Iterator< String > i = datasKeys.iterator();
813
821
while( i.hasNext() ) {
814
822
String address = i.next();
815
823
ContactData.TypeDetail data = datas.get( address );
817
825
// we don't want to add this address if it exists already or we
818
826
// would introduce duplicates
819
if( _contacts_cache.hasAssociatedAddress( id, address ) )
827
if( _contactsCache.hasAssociatedAddress( id, address ) )
822
830
// add postal address
823
_backend.addContactAddresses( id, address, data );
831
ContentValues values = new ContentValues();
832
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_POSTAL );
833
values.put( Contacts.ContactMethods.DATA, address );
834
values.put( Contacts.ContactMethods.TYPE, data.getType() );
835
_doit.getContentResolver().insert( contactContactMethodsUri,
825
838
// and add this address to the cache to prevent a addition of
826
839
// duplicate date from another file
827
_contacts_cache.addAssociatedAddress( id, address );
840
_contactsCache.addAssociatedAddress( id, address );
831
844
private void importContactOrganisations( Long id,
832
845
HashMap< String, ContactData.ExtraDetail > datas )
833
throws ContactCreationException
836
Set< String > datas_keys = datas.keySet();
837
Iterator< String > i = datas_keys.iterator();
848
Set< String > datasKeys = datas.keySet();
849
Iterator< String > i = datasKeys.iterator();
838
850
while( i.hasNext() ) {
839
851
String organisation = i.next();
840
852
ContactData.ExtraDetail data = datas.get( organisation );
842
854
// we don't want to add this address if it exists already or we
843
855
// would introduce duplicates
844
if( _contacts_cache.hasAssociatedOrganisation( id, organisation ) )
856
if( _contactsCache.hasAssociatedOrganisation( id, organisation ) )
847
859
// add organisation address
848
_backend.addContactOrganisation( id, organisation, data );
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 );
850
870
// and add this address to the cache to prevent a addition of
851
871
// duplicate date from another file
852
_contacts_cache.addAssociatedOrganisation( id, organisation );
872
_contactsCache.addAssociatedOrganisation( id, organisation );