/android/import-contacts

To get this branch, use:
bzr branch http://bzr.ed.am/android/import-contacts

« back to all changes in this revision

Viewing changes to src/org/waxworlds/importcontacts/Importer.java

  • Committer: edam
  • Date: 2009-01-13 06:35:26 UTC
  • Revision ID: edam@waxworlds.org-20090113063526-l9t1s9git4bav60a
- new contact's phone numebrs and email addresses are added to the caches after those contacts are updated to account for the situation where the same contact is imported again from another file (or the contact exists twice in the same file!?)

Show diffs side-by-side

added added

removed removed

src/org/waxworlds/importcontacts/Importer.java
1
1
/*
2
2
 * Importer.java
3
3
 *
4
 
 * Copyright (C) 2009 to 2012 Tim Marston <tim@ed.am>
 
4
 * Copyright (C) 2009 Tim Marston <edam@waxworlds.org>
5
5
 *
6
6
 * This file is part of the Import Contacts program (hereafter referred
7
7
 * to as "this program"). For more information, see
8
 
 * http://ed.am/dev/android/import-contacts
 
8
 * http://www.waxworlds.org/edam/software/android/import-contacts
9
9
 *
10
10
 * This program is free software: you can redistribute it and/or modify
11
11
 * it under the terms of the GNU General Public License as published by
21
21
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
22
22
 */
23
23
 
24
 
package am.ed.importcontacts;
 
24
package org.waxworlds.importcontacts;
25
25
 
26
 
import java.util.Arrays;
27
26
import java.util.HashMap;
28
27
import java.util.HashSet;
29
28
import java.util.Iterator;
31
30
import java.util.regex.Matcher;
32
31
import java.util.regex.Pattern;
33
32
 
 
33
import android.content.ContentUris;
 
34
import android.content.ContentValues;
34
35
import android.content.SharedPreferences;
 
36
import android.database.Cursor;
 
37
import android.net.Uri;
35
38
import android.os.Message;
36
 
import android.provider.Contacts.PhonesColumns;
 
39
import android.provider.Contacts;
37
40
 
38
41
public class Importer extends Thread
39
42
{
 
43
        public final static int ACTION_GOBACK = 0;
40
44
        public final static int ACTION_ABORT = 1;
41
45
        public final static int ACTION_ALLDONE = 2;
42
46
 
48
52
 
49
53
        private Doit _doit;
50
54
        private int _response;
51
 
        private int _response_extra;
52
 
        private int _merge_setting;
53
 
        private int _last_merge_decision;
 
55
        private int _responseExtra;
 
56
        private HashMap< String, Long > _contacts;
 
57
        private HashMap< Long, HashSet< String > > _contactNumbers;
 
58
        private HashMap< Long, HashSet< String > > _contactEmails;
 
59
        private int _mergeSetting;
 
60
        private int _lastMergeDecision;
54
61
        private boolean _abort = false;
55
 
        private boolean _is_finished = false;
56
 
        private ContactsCache _contacts_cache = null;
57
 
        private Backend _backend = null;
 
62
        private boolean _isFinished = false;
58
63
 
59
 
        /**
60
 
         * Data about a contact
61
 
         */
62
64
        public class ContactData
63
65
        {
64
 
                class TypeDetail
65
 
                {
66
 
                        protected int _type;
67
 
 
68
 
                        public TypeDetail( int type )
69
 
                        {
70
 
                                _type = type;
71
 
                        }
72
 
 
73
 
                        public int getType()
74
 
                        {
75
 
                                return _type;
76
 
                        }
77
 
                }
78
 
 
79
 
                class PreferredDetail extends TypeDetail
80
 
                {
81
 
                        protected boolean _is_preferred;
82
 
 
83
 
                        public PreferredDetail( int type, boolean is_preferred )
84
 
                        {
85
 
                                super( type );
86
 
                                _is_preferred = is_preferred;
87
 
                        }
88
 
 
89
 
                        public boolean isPreferred()
90
 
                        {
91
 
                                return _is_preferred;
92
 
                        }
93
 
                }
94
 
 
95
 
                class ExtraDetail extends PreferredDetail
96
 
                {
97
 
                        protected String _extra;
98
 
 
99
 
                        public ExtraDetail( int type, boolean is_preferred, String extra )
100
 
                        {
101
 
                                super( type, is_preferred );
102
 
 
103
 
                                if( extra != null ) extra = extra.trim();
104
 
                                _extra = extra;
105
 
                        }
106
 
 
107
 
                        public String getExtra()
108
 
                        {
109
 
                                return _extra;
110
 
                        }
111
 
 
112
 
                        public void setExtra( String extra )
113
 
                        {
114
 
                                if( extra != null ) extra = extra.trim();
115
 
                                _extra = extra;
116
 
                        }
117
 
                }
118
 
 
119
 
                @SuppressWarnings("serial")
120
 
                protected class ContactNotIdentifiableException extends Exception
121
 
                {
122
 
                }
123
 
 
124
 
                protected String _name = null;
125
 
                protected String _primary_organisation = null;
126
 
                protected boolean _primary_organisation_is_preferred;
127
 
                protected String _primary_number = null;
128
 
                protected int _primary_number_type;
129
 
                protected boolean _primary_number_is_preferred;
130
 
                protected String _primary_email = null;
131
 
                protected boolean _primary_email_is_preferred;
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
 
                private ContactsCache.CacheIdentifier _cache_identifier = null;
 
66
                class PhoneData
 
67
                {
 
68
                        public String _number;
 
69
                        public int _type;
 
70
                        public boolean _isPreferred;
 
71
 
 
72
                        public PhoneData( String number, int type, boolean isPreferred ) {
 
73
                                _number = number;
 
74
                                _type = type;
 
75
                                _isPreferred = isPreferred;
 
76
                        }
 
77
 
 
78
                        public String getNumber() {
 
79
                                return _number;
 
80
                        }
 
81
 
 
82
                        public int getType() {
 
83
                                return _type;
 
84
                        }
 
85
 
 
86
                        public boolean isPreferred() {
 
87
                                return _isPreferred;
 
88
                        }
 
89
                }
 
90
 
 
91
                class EmailData
 
92
                {
 
93
                        private String _email;
 
94
                        public int _type;
 
95
                        private boolean _isPreferred;
 
96
 
 
97
                        public EmailData( String email, int type, boolean isPreferred ) {
 
98
                                _email = email;
 
99
                                _type = type;
 
100
                                _isPreferred = isPreferred;
 
101
                        }
 
102
 
 
103
                        public String getAddress() {
 
104
                                return _email;
 
105
                        }
 
106
 
 
107
                        public int getType() {
 
108
                                return _type;
 
109
                        }
 
110
 
 
111
                        public boolean isPreferred() {
 
112
                                return _isPreferred;
 
113
                        }
 
114
                }
 
115
 
 
116
                public String _name = null;
 
117
                public HashMap< String, PhoneData > _phones = null;
 
118
                public HashMap< String, EmailData > _emails = null;
138
119
 
139
120
                protected void setName( String name )
140
121
                {
141
122
                        _name = name;
142
123
                }
143
124
 
144
 
                public boolean hasName()
145
 
                {
146
 
                        return _name != null;
147
 
                }
148
 
 
149
125
                public String getName()
150
126
                {
151
127
                        return _name;
152
128
                }
153
129
 
154
 
                protected void addOrganisation( String organisation, String title,
155
 
                        boolean is_preferred )
156
 
                {
157
 
                        organisation = organisation.trim();
158
 
                        if( organisation.length() <= 0 )
159
 
                        {
160
 
                                // TODO: warn that an imported organisation is being ignored
161
 
                                return;
162
 
                        }
163
 
 
164
 
                        if( title != null ) {
165
 
                                title = title.trim();
166
 
                                if( title.length() <= 0 ) title = null;
167
 
                        }
168
 
 
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 ) );
176
 
 
177
 
                        // if this is the first organisation added, or it's a preferred
178
 
                        // organisation and the current primary organisation isn't, then
179
 
                        // record this as the primary organisation.
180
 
                        if( _primary_organisation == null ||
181
 
                                ( is_preferred && !_primary_organisation_is_preferred ) )
182
 
                        {
183
 
                                _primary_organisation = organisation;
184
 
                                _primary_organisation_is_preferred = is_preferred;
185
 
                        }
186
 
                }
187
 
 
188
 
                public boolean hasOrganisations()
189
 
                {
190
 
                        return _organisations != null && _organisations.size() > 0;
191
 
                }
192
 
 
193
 
                public HashMap< String, ExtraDetail > getOrganisations()
194
 
                {
195
 
                        return _organisations;
196
 
                }
197
 
 
198
 
                public boolean hasPrimaryOrganisation()
199
 
                {
200
 
                        return _primary_organisation != null;
201
 
                }
202
 
 
203
 
                public String getPrimaryOrganisation()
204
 
                {
205
 
                        return _primary_organisation;
206
 
                }
207
 
 
208
 
                protected void addNumber( String number, int type,
209
 
                        boolean is_preferred )
210
 
                {
211
 
                        number = sanitisePhoneNumber( number );
212
 
                        if( number == null )
213
 
                        {
214
 
                                // TODO: warn that an imported phone number is being ignored
215
 
                                return;
216
 
                        }
217
 
 
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 ) );
225
 
 
226
 
                        final Set< Integer > non_voice_types = new HashSet< Integer >(
227
 
                                Arrays.asList( PhonesColumns.TYPE_FAX_HOME,
228
 
                                        PhonesColumns.TYPE_FAX_WORK, PhonesColumns.TYPE_PAGER ) );
229
 
 
230
 
                        // if this is the first number added, or it's a preferred number
231
 
                        // and the current primary number isn't, or this number is on equal
232
 
                        // standing with the primary number in terms of preference and it is
233
 
                        // a voice number and the primary number isn't, then record this as
234
 
                        // the primary number.
235
 
                        if( _primary_number == null ||
236
 
                                ( is_preferred && !_primary_number_is_preferred ) ||
237
 
                                ( is_preferred == _primary_number_is_preferred &&
238
 
                                        !non_voice_types.contains( type ) &&
239
 
                                        non_voice_types.contains( _primary_number_type ) ) )
240
 
                        {
241
 
                                _primary_number = number;
242
 
                                _primary_number_type = type;
243
 
                                _primary_number_is_preferred = is_preferred;
244
 
                        }
245
 
                }
246
 
 
247
 
                public boolean hasNumbers()
248
 
                {
249
 
                        return _numbers != null && _numbers.size() > 0;
250
 
                }
251
 
 
252
 
                public HashMap< String, PreferredDetail > getNumbers()
253
 
                {
254
 
                        return _numbers;
255
 
                }
256
 
 
257
 
                public boolean hasPrimaryNumber()
258
 
                {
259
 
                        return _primary_number != null;
260
 
                }
261
 
 
262
 
                public String getPrimaryNumber()
263
 
                {
264
 
                        return _primary_number;
265
 
                }
266
 
 
267
 
                protected void addEmail( String email, int type, boolean is_preferred )
268
 
                {
269
 
 
270
 
                        email = sanitisesEmailAddress( email );
271
 
                        if( email == null )
272
 
                        {
273
 
                                // TODO: warn that an imported email address is being ignored
274
 
                                return;
275
 
                        }
276
 
 
277
 
                        // add the email, as non-preferred (we prefer only one email in
278
 
                        // finalise() after they're all imported)
279
 
                        if( _emails == null )
280
 
                                _emails = new HashMap< String, PreferredDetail >();
 
130
                protected void addPhone( String number, int type, boolean isPreferred )
 
131
                {
 
132
                        if( _phones == null ) _phones = new HashMap< String, PhoneData >();
 
133
                        if( !_phones.containsKey( number ) )
 
134
                                _phones.put( number,
 
135
                                                new PhoneData( number, type, isPreferred ) );
 
136
                }
 
137
 
 
138
                protected void addEmail( String email, int type, boolean isPreferred )
 
139
                {
 
140
                        if( _emails == null ) _emails = new HashMap< String, EmailData >();
281
141
                        if( !_emails.containsKey( email ) )
282
 
                                _emails.put( email, new PreferredDetail( type, false ) );
283
 
 
284
 
                        // if this is the first email added, or it's a preferred email and
285
 
                        // the current primary organisation isn't, then record this as the
286
 
                        // primary email.
287
 
                        if( _primary_email == null ||
288
 
                                ( is_preferred && !_primary_email_is_preferred ) )
289
 
                        {
290
 
                                _primary_email = email;
291
 
                                _primary_email_is_preferred = is_preferred;
292
 
                        }
293
 
                }
294
 
 
295
 
                public boolean hasEmails()
296
 
                {
297
 
                        return _emails != null && _emails.size() > 0;
298
 
                }
299
 
 
300
 
                public HashMap< String, PreferredDetail > getEmails()
301
 
                {
302
 
                        return _emails;
303
 
                }
304
 
 
305
 
                public boolean hasPrimaryEmail()
306
 
                {
307
 
                        return _primary_email != null;
308
 
                }
309
 
 
310
 
                public String getPrimaryEmail()
311
 
                {
312
 
                        return _primary_email;
313
 
                }
314
 
 
315
 
                protected void addAddress( String address, int type )
316
 
                {
317
 
                        address = address.trim();
318
 
                        if( address.length() <= 0 )
319
 
                        {
320
 
                                // TODO: warn that an imported address is being ignored
321
 
                                return;
322
 
                        }
323
 
 
324
 
                        if( _addresses == null ) _addresses =
325
 
                                new HashMap< String, TypeDetail >();
326
 
                        if( !_addresses.containsKey( address ) )
327
 
                                _addresses.put( address, new TypeDetail( type ) );
328
 
                }
329
 
 
330
 
                public boolean hasAddresses()
331
 
                {
332
 
                        return _addresses != null && _addresses.size() > 0;
333
 
                }
334
 
 
335
 
                public HashMap< String, TypeDetail > getAddresses()
336
 
                {
337
 
                        return _addresses;
338
 
                }
339
 
 
340
 
                protected void finalise()
341
 
                        throws ContactNotIdentifiableException
342
 
                {
343
 
                        // ensure that if there is a primary number, it is preferred so
344
 
                        // that there is always one preferred number. Android will assign
345
 
                        // preference to one anyway so we might as well decide one sensibly.
346
 
                        if( _primary_number != null ) {
347
 
                                PreferredDetail data = _numbers.get( _primary_number );
348
 
                                _numbers.put( _primary_number,
349
 
                                        new PreferredDetail( data.getType(), true ) );
350
 
                        }
351
 
 
352
 
                        // do the same for the primary email
353
 
                        if( _primary_email != null ) {
354
 
                                PreferredDetail data = _emails.get( _primary_email );
355
 
                                _emails.put( _primary_email,
356
 
                                        new PreferredDetail( data.getType(), true ) );
357
 
                        }
358
 
 
359
 
                        // do the same for the primary organisation
360
 
                        if( _primary_organisation != null ) {
361
 
                                ExtraDetail data = _organisations.get( _primary_organisation );
362
 
                                _organisations.put( _primary_organisation,
363
 
                                        new ExtraDetail( 0, true, data.getExtra() ) );
364
 
                        }
365
 
 
366
 
                        // create a cache identifier from this contact data, which can be
367
 
                        // used to look-up an existing contact
368
 
                        _cache_identifier = ContactsCache.createIdentifier( this );
369
 
                        if( _cache_identifier == null )
370
 
                                throw new ContactNotIdentifiableException();
371
 
                }
372
 
 
373
 
                public ContactsCache.CacheIdentifier getCacheIdentifier()
374
 
                {
375
 
                        return _cache_identifier;
376
 
                }
377
 
 
378
 
                private String sanitisePhoneNumber( String number )
379
 
                {
380
 
                        number = number.trim();
381
 
                        Pattern p = Pattern.compile( "^[-\\(\\) \\+0-9#*]+" );
382
 
                        Matcher m = p.matcher( number );
383
 
                        if( m.lookingAt() ) return m.group( 0 );
384
 
                        return null;
385
 
                }
386
 
 
387
 
                private String sanitisesEmailAddress( String email )
388
 
                {
389
 
                        email = email.trim();
390
 
                        Pattern p = Pattern.compile(
391
 
                                "^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
392
 
                        Matcher m = p.matcher( email );
393
 
                        if( m.matches() ) {
394
 
                                String[] bits = email.split( "@" );
395
 
                                return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase();
396
 
                        }
397
 
                        return null;
 
142
                                _emails.put( email, new EmailData( email, type, isPreferred ) );
398
143
                }
399
144
        }
400
145
 
401
 
        @SuppressWarnings("serial")
402
146
        protected class AbortImportException extends Exception { };
403
147
 
404
148
        public Importer( Doit doit )
406
150
                _doit = doit;
407
151
 
408
152
                SharedPreferences prefs = getSharedPreferences();
409
 
                _merge_setting = prefs.getInt( "merge_setting", Doit.ACTION_PROMPT );
 
153
                _mergeSetting = prefs.getInt( "merge_setting", 0 );
410
154
        }
411
155
 
412
156
        @Override
414
158
        {
415
159
                try
416
160
                {
417
 
                        // update UI
418
 
                        setProgressMessage( R.string.doit_caching );
419
 
 
420
 
                        // create the appropriate backend
421
 
//                      if( Integer.parseInt( android.os.Build.VERSION.SDK ) >= 5 )
422
 
//                              _backend = new ContactsContractBackend( _doit );
423
 
//                      else
424
 
                                _backend = new ContactsBackend( _doit );
425
 
 
426
 
                        // create a cache of existing contacts and populate it
427
 
                        _contacts_cache = new ContactsCache();
428
 
                        _backend.populateCache( _contacts_cache );
 
161
                        // cache current contact names
 
162
                        buildContactsCache();
429
163
 
430
164
                        // do the import
431
165
                        onImport();
442
176
 
443
177
        synchronized private void setIsFinished()
444
178
        {
445
 
                _is_finished = true;
 
179
                _isFinished = true;
446
180
        }
447
181
 
448
182
        protected void onImport() throws AbortImportException
459
193
                wake( response, RESPONSEEXTRA_NONE );
460
194
        }
461
195
 
462
 
        synchronized public void wake( int response, int response_extra )
 
196
        synchronized public void wake( int response, int responseExtra )
463
197
        {
464
198
                _response = response;
465
 
                _response_extra = response_extra;
 
199
                _responseExtra = responseExtra;
466
200
                notify();
467
201
        }
468
202
 
469
203
        synchronized public boolean setAbort()
470
204
        {
471
 
                if( !_is_finished && !_abort ) {
 
205
                if( !_isFinished && !_abort ) {
472
206
                        _abort = true;
473
207
                        notify();
474
208
                        return true;
491
225
        {
492
226
                checkAbort();
493
227
                _doit._handler.sendMessage( Message.obtain(
494
 
                        _doit._handler, Doit.MESSAGE_ERROR, message ) );
 
228
                                _doit._handler, Doit.MESSAGE_ERROR, message ) );
495
229
                try {
496
230
                        wait();
497
231
                }
498
232
                catch( InterruptedException e ) { }
499
 
 
500
233
                // no need to check if an abortion happened during the wait, we are
501
234
                // about to finish anyway!
502
235
                finish( ACTION_ABORT );
512
245
        {
513
246
                checkAbort();
514
247
                _doit._handler.sendMessage( Message.obtain(
515
 
                        _doit._handler, Doit.MESSAGE_ERROR, message ) );
 
248
                                _doit._handler, Doit.MESSAGE_ERROR, message ) );
516
249
                try {
517
250
                        wait();
518
251
                }
519
252
                catch( InterruptedException e ) { }
520
 
 
521
253
                // no need to check if an abortion happened during the wait, we are
522
254
                // about to finish anyway!
523
255
                finish( ACTION_ABORT );
533
265
        {
534
266
                checkAbort();
535
267
                _doit._handler.sendMessage( Message.obtain(
536
 
                        _doit._handler, Doit.MESSAGE_CONTINUEORABORT, message ) );
 
268
                                _doit._handler, Doit.MESSAGE_CONTINUEORABORT, message ) );
537
269
                try {
538
270
                        wait();
539
271
                }
549
281
        {
550
282
                checkAbort();
551
283
                _doit._handler.sendMessage( Message.obtain( _doit._handler,
552
 
                        Doit.MESSAGE_SETPROGRESSMESSAGE, getText( res ) ) );
 
284
                                Doit.MESSAGE_SETPROGRESSMESSAGE, getText( res ) ) );
553
285
        }
554
286
 
555
 
        protected void setProgressMax( int max_progress )
 
287
        protected void setProgressMax( int maxProgress )
556
288
                        throws AbortImportException
557
289
        {
558
290
                checkAbort();
559
291
                _doit._handler.sendMessage( Message.obtain(
560
 
                        _doit._handler, Doit.MESSAGE_SETMAXPROGRESS,
561
 
                        new Integer( max_progress ) ) );
 
292
                                _doit._handler, Doit.MESSAGE_SETMAXPROGRESS,
 
293
                                new Integer( maxProgress ) ) );
562
294
        }
563
295
 
564
 
        protected void setTmpProgress( int tmp_progress )
565
 
                throws AbortImportException
 
296
        protected void setTmpProgress( int tmpProgress ) throws AbortImportException
566
297
        {
567
298
                checkAbort();
568
299
                _doit._handler.sendMessage( Message.obtain(
569
 
                        _doit._handler, Doit.MESSAGE_SETTMPPROGRESS,
570
 
                        new Integer( tmp_progress ) ) );
 
300
                                _doit._handler, Doit.MESSAGE_SETTMPPROGRESS,
 
301
                                new Integer( tmpProgress ) ) );
571
302
        }
572
303
 
573
304
        protected void setProgress( int progress ) throws AbortImportException
574
305
        {
575
306
                checkAbort();
576
307
                _doit._handler.sendMessage( Message.obtain(
577
 
                        _doit._handler, Doit.MESSAGE_SETPROGRESS,
578
 
                        new Integer( progress ) ) );
 
308
                                _doit._handler, Doit.MESSAGE_SETPROGRESS,
 
309
                                new Integer( progress ) ) );
579
310
        }
580
311
 
581
312
        protected void finish( int action ) throws AbortImportException
584
315
                int message;
585
316
                switch( action )
586
317
                {
587
 
                case ACTION_ALLDONE:    message = Doit.MESSAGE_ALLDONE; break;
 
318
                case ACTION_GOBACK:             message = Doit.MESSAGE_FINISHED_GOBACK; break;
 
319
                case ACTION_ALLDONE:    message = Doit.MESSAGE_FINISHED_ALLDONE; break;
588
320
                default:        // fall through
589
 
                case ACTION_ABORT:              message = Doit.MESSAGE_ABORT; break;
 
321
                case ACTION_ABORT:              message = Doit.MESSAGE_FINISHED; break;
590
322
                }
591
323
                _doit._handler.sendEmptyMessage( message );
592
324
 
599
331
                return _doit.getText( res );
600
332
        }
601
333
 
602
 
        synchronized private boolean checkForDuplicate(
603
 
                ContactsCache.CacheIdentifier cache_identifier, int merge_setting )
604
 
                throws AbortImportException
 
334
        protected boolean isImportRequired( String name )
 
335
                        throws AbortImportException
605
336
        {
606
 
                _last_merge_decision = merge_setting;
 
337
                checkAbort();
 
338
                return isImportRequired( name, _mergeSetting );
 
339
        }
607
340
 
608
 
                // it is ok to use contact.getCacheIdentifier(). The contact has already
609
 
                // been finalised, which means a valid cache identifier will have been
610
 
                // created for it (or it would have been skipped)
 
341
        synchronized private boolean isImportRequired( String name,
 
342
                        int mergeSetting ) throws AbortImportException
 
343
        {
 
344
                _lastMergeDecision = mergeSetting;
611
345
 
612
346
                // handle special cases
613
 
                switch( merge_setting )
 
347
                switch( mergeSetting )
614
348
                {
615
 
                case Doit.ACTION_KEEP:
 
349
                case R.id.merge_keep:
616
350
                        // if we keep contacts on duplicate, we better check for one
617
 
                        return !_contacts_cache.canLookup( cache_identifier );
 
351
                        return !_contacts.containsKey( name );
618
352
 
619
 
                case Doit.ACTION_PROMPT:
620
 
                        // if we are prompting on duplicate, we better check for one and if
621
 
                        // the contact doesn'te exist, we want to import it
622
 
                        if( !_contacts_cache.canLookup( cache_identifier ) )
 
353
                case R.id.merge_prompt:
 
354
                        // if we are prompting on duplicate, we better check for one
 
355
                        if( !_contacts.containsKey( name ) )
623
356
                                return true;
624
357
 
625
358
                        // ok, it exists, so do prompt
626
 
                        _doit._handler.sendMessage( Message.obtain( _doit._handler,
627
 
                                Doit.MESSAGE_MERGEPROMPT, cache_identifier.getDetail() ) );
 
359
                        _doit._handler.sendMessage( Message.obtain(
 
360
                                        _doit._handler, Doit.MESSAGE_MERGEPROMPT, name ) );
628
361
                        try {
629
362
                                wait();
630
363
                        }
633
366
                        // check if an abortion happened during the wait
634
367
                        checkAbort();
635
368
 
636
 
                        // if "always" was selected, make choice permanent
637
 
                        if( _response_extra == RESPONSEEXTRA_ALWAYS )
638
 
                                _merge_setting = _response;
 
369
                        // if "always" was selected, make choice permenant
 
370
                        if( _responseExtra == RESPONSEEXTRA_ALWAYS )
 
371
                                _mergeSetting = _response;
639
372
 
640
 
                        // recurse, with our new merge setting
641
 
                        return checkForDuplicate( cache_identifier, _response );
 
373
                        // recurse, with out new merge setting
 
374
                        return isImportRequired( name, _response );
642
375
                }
643
376
 
644
377
                // for all other cases (either overwriting or merging) we will need the
657
390
        {
658
391
                checkAbort();
659
392
 
660
 
                // It is expected that we use contact.getCacheIdentifier() here. The
661
 
                // contact we are passed should have been successfully finalise()d,
662
 
                // which includes generating a valid cache identifier.
663
 
                ContactsCache.CacheIdentifier cache_identifier =
664
 
                        contact.getCacheIdentifier();
665
 
 
666
 
                // check to see if this contact is a duplicate and should be skipped
667
 
                if( !checkForDuplicate( cache_identifier, _merge_setting ) ) {
668
 
                        skipContact();
669
 
                        return;
670
 
                }
671
 
 
672
393
//              if( !showContinue( "====[ IMPORTING ]====\n: " + contact._name ) )
673
394
//                      finish( ACTION_ABORT );
674
395
 
675
 
                // keep track of whether we've informed the UI of what we're doing
676
 
                boolean ui_informed = false;
677
 
 
678
 
                // attempt to lookup the id of an existing contact in the cache with
679
 
                // this contact data's cache identifier
680
 
                Long id = (Long)_contacts_cache.lookup( cache_identifier );
 
396
                ContentValues values = new ContentValues();
 
397
                boolean uiInformed = false;
681
398
 
682
399
                // does contact exist already?
683
 
                if( id != null )
 
400
                Uri contactUri = null;
 
401
                Long id;
 
402
                if( ( id = (Long)_contacts.get( contact._name ) ) != null )
684
403
                {
685
404
                        // should we skip this import altogether?
686
 
                        if( _last_merge_decision == Doit.ACTION_KEEP ) return;
 
405
                        if( _lastMergeDecision == R.id.merge_keep ) return;
 
406
 
 
407
                        // get contact's URI
 
408
                        contactUri = ContentUris.withAppendedId(
 
409
                                        Contacts.People.CONTENT_URI, id );
687
410
 
688
411
                        // should we destroy the existing contact before importing?
689
 
                        if( _last_merge_decision == Doit.ACTION_OVERWRITE )
690
 
                        {
691
 
                                // remove from device
692
 
                                _backend.deleteContact( id );
 
412
                        if( _lastMergeDecision == R.id.merge_overwrite ) {
 
413
                                _doit.getContentResolver().delete( contactUri, null, null );
 
414
                                contactUri = null;
 
415
 
 
416
                                // upate the UI
 
417
                                _doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTOVERWRITTEN );
 
418
                                uiInformed = true;
693
419
 
694
420
                                // update cache
695
 
                                _contacts_cache.removeLookup( cache_identifier );
696
 
                                _contacts_cache.removeAssociatedData( id );
697
 
 
698
 
                                // show that we're overwriting a contact
699
 
                                _doit._handler.sendEmptyMessage(
700
 
                                                Doit.MESSAGE_CONTACTOVERWRITTEN );
701
 
                                ui_informed = true;
702
 
 
703
 
                                // discard the contact id
704
 
                                id = null;
 
421
                                _contacts.remove( contact._name );
705
422
                        }
706
423
                }
707
424
 
708
 
                // if we don't have a contact id yet (or we did, but we destroyed it
709
 
                // when we deleted the contact), we'll have to create a new contact
710
 
                if( id == null )
 
425
                // if we don't have a contact URI it is because the contact never
 
426
                // existed or because we deleted it
 
427
                if( contactUri == null )
711
428
                {
712
429
                        // create a new contact
713
 
                        id = _backend.addContact( contact._name );
714
 
                        if( id == null )
715
 
                                showError( R.string.error_unabletoaddcontact );
 
430
                        values.put( Contacts.People.NAME, contact._name );
 
431
                        contactUri = _doit.getContentResolver().insert(
 
432
                                        Contacts.People.CONTENT_URI, values );
 
433
                        id = ContentUris.parseId( contactUri );
 
434
                        if( id <= 0 ) return;   // shouldn't happen!
 
435
 
 
436
                        // add them to the "My Contacts" group
 
437
                        Contacts.People.addToGroup(
 
438
                                        _doit.getContentResolver(), id,
 
439
                                        Contacts.Groups.GROUP_MY_CONTACTS );
716
440
 
717
441
                        // update cache
718
 
                        _contacts_cache.addLookup( cache_identifier, id );
 
442
                        _contacts.put( contact._name, id );
719
443
 
720
 
                        // if we haven't already shown that we're overwriting a contact,
721
 
                        // show that we're creating a new contact
722
 
                        if( !ui_informed ) {
 
444
                        // update UI
 
445
                        if( !uiInformed ) {
723
446
                                _doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTCREATED );
724
 
                                ui_informed = true;
 
447
                                uiInformed = true;
725
448
                        }
726
449
                }
727
450
 
728
 
                // if we haven't already shown that we're overwriting or creating a
729
 
                // contact, show that we're merging a contact
730
 
                if( !ui_informed )
 
451
                // update UI
 
452
                if( !uiInformed )
731
453
                        _doit._handler.sendEmptyMessage( Doit.MESSAGE_CONTACTMERGED );
732
454
 
733
455
                // import contact parts
734
 
                if( contact.hasNumbers() )
735
 
                        importContactPhones( id, contact.getNumbers() );
736
 
                if( contact.hasEmails() )
737
 
                        importContactEmails( id, contact.getEmails() );
738
 
                if( contact.hasAddresses() )
739
 
                        importContactAddresses( id, contact.getAddresses() );
740
 
                if( contact.hasOrganisations() )
741
 
                        importContactOrganisations( id, contact.getOrganisations() );
 
456
                if( contact._phones != null )
 
457
                        importContactPhones( contactUri, contact._phones );
 
458
                if( contact._emails != null )
 
459
                        importContactEmails( contactUri, contact._emails );
742
460
        }
743
461
 
744
 
        private void importContactPhones( Long id,
745
 
                        HashMap< String, ContactData.PreferredDetail > datas )
 
462
        private void importContactPhones( Uri contactUri,
 
463
                        HashMap< String, ContactData.PhoneData > phones )
746
464
        {
 
465
                Long contactId = ContentUris.parseId( contactUri );
 
466
                Uri contactPhonesUri = Uri.withAppendedPath( contactUri,
 
467
                                Contacts.People.Phones.CONTENT_DIRECTORY );
 
468
                Set phonesKeys = phones.keySet();
 
469
 
747
470
                // add phone numbers
748
 
                Set< String > datas_keys = datas.keySet();
749
 
                Iterator< String > i = datas_keys.iterator();
 
471
                Iterator i = phonesKeys.iterator();
750
472
                while( i.hasNext() ) {
751
 
                        String number = i.next();
752
 
                        ContactData.PreferredDetail data = datas.get( number );
 
473
                        ContactData.PhoneData phone = phones.get( i.next() );
753
474
 
754
475
                        // we don't want to add this number if it's crap, or it already
755
476
                        // exists (which would cause a duplicate to be created). We don't
758
479
                        // if the number exists at all, it doesn't need importing. Because
759
480
                        // of this, we also can't update the cache (which we don't need to
760
481
                        // anyway, so it's not a problem).
761
 
                        if( _contacts_cache.hasAssociatedNumber( id, number ) )
762
 
                                continue;
 
482
                        String number = sanitisePhoneNumber( phone._number );
 
483
                        if( number == null ) continue;
 
484
                        HashSet< String > numbers = _contactNumbers.get( contactId );
 
485
                        if( numbers != null && numbers.contains( number ) ) continue;
763
486
 
764
487
                        // add phone number
765
 
                        _backend.addContactPhone( id, number, data );
766
 
 
767
 
                        // and add this address to the cache to prevent a addition of
768
 
                        // duplicate date from another file
769
 
                        _contacts_cache.addAssociatedNumber( id, number );
 
488
                        ContentValues values = new ContentValues();
 
489
                        values.put( Contacts.Phones.TYPE, phone._type );
 
490
                        values.put( Contacts.Phones.NUMBER, phone._number );
 
491
                        if( phone._isPreferred ) values.put( Contacts.Phones.ISPRIMARY, 1 );
 
492
                        _doit.getContentResolver().insert( contactPhonesUri, values );
 
493
                }
 
494
 
 
495
                // now add those phone numbers to the cache to prevent the addition of
 
496
                // duplicate data from another file
 
497
                i = phonesKeys.iterator();
 
498
                while( i.hasNext() ) {
 
499
                        ContactData.PhoneData phone = phones.get( i.next() );
 
500
 
 
501
                        String number = sanitisePhoneNumber( phone._number );
 
502
                        if( number != null ) {
 
503
                                HashSet< String > numbers = _contactNumbers.get( contactId );
 
504
                                if( numbers == null ) {
 
505
                                        _contactNumbers.put( contactId, new HashSet< String >() );
 
506
                                        numbers = _contactNumbers.get( contactId );
 
507
                                }
 
508
                                numbers.add( number );
 
509
                        }
770
510
                }
771
511
        }
772
512
 
773
 
        private void importContactEmails( Long id,
774
 
                        HashMap< String, ContactData.PreferredDetail > datas )
 
513
        private void importContactEmails( Uri contactUri,
 
514
                        HashMap< String, ContactData.EmailData > emails )
775
515
        {
 
516
                Long contactId = ContentUris.parseId( contactUri );
 
517
                Uri contactContactMethodsUri = Uri.withAppendedPath( contactUri,
 
518
                                Contacts.People.ContactMethods.CONTENT_DIRECTORY );
 
519
                Set emailsKeys = emails.keySet();
 
520
 
776
521
                // add email addresses
777
 
                Set< String > datas_keys = datas.keySet();
778
 
                Iterator< String > i = datas_keys.iterator();
 
522
                Iterator i = emailsKeys.iterator();
779
523
                while( i.hasNext() ) {
780
 
                        String email = i.next();
781
 
                        ContactData.PreferredDetail data = datas.get( email );
 
524
                        ContactData.EmailData email = emails.get( i.next() );
782
525
 
783
 
                        // we don't want to add this email address if it exists already or
784
 
                        // we would introduce duplicates.
785
 
                        if( _contacts_cache.hasAssociatedEmail( id, email ) )
786
 
                                continue;
 
526
                        // like with phone numbers, we don't want to add this email address
 
527
                        // if it exists already or we would introduce duplicates.
 
528
                        String address = sanitiseEmailAddress( email.getAddress() );
 
529
                        if( address == null ) continue;
 
530
                        HashSet< String > addresses = _contactEmails.get( contactId );
 
531
                        if( addresses != null && addresses.contains( address ) ) continue;
787
532
 
788
533
                        // add phone number
789
 
                        _backend.addContactEmail( id, email, data );
790
 
 
791
 
                        // and add this address to the cache to prevent a addition of
792
 
                        // duplicate date from another file
793
 
                        _contacts_cache.addAssociatedEmail( id, email );
794
 
                }
795
 
        }
796
 
 
797
 
        private void importContactAddresses( Long id,
798
 
                HashMap< String, ContactData.TypeDetail > datas )
799
 
        {
800
 
                // add addresses
801
 
                Set< String > datas_keys = datas.keySet();
802
 
                Iterator< String > i = datas_keys.iterator();
803
 
                while( i.hasNext() ) {
804
 
                        String address = i.next();
805
 
                        ContactData.TypeDetail data = datas.get( address );
806
 
 
807
 
                        // we don't want to add this address if it exists already or we
808
 
                        // would introduce duplicates
809
 
                        if( _contacts_cache.hasAssociatedAddress( id, address ) )
810
 
                                continue;
811
 
 
812
 
                        // add postal address
813
 
                        _backend.addContactAddresses( id, address, data );
814
 
 
815
 
                        // and add this address to the cache to prevent a addition of
816
 
                        // duplicate date from another file
817
 
                        _contacts_cache.addAssociatedAddress( id, address );
818
 
                }
819
 
        }
820
 
 
821
 
        private void importContactOrganisations( Long id,
822
 
                HashMap< String, ContactData.ExtraDetail > datas )
823
 
        {
824
 
                // add addresses
825
 
                Set< String > datas_keys = datas.keySet();
826
 
                Iterator< String > i = datas_keys.iterator();
827
 
                while( i.hasNext() ) {
828
 
                        String organisation = i.next();
829
 
                        ContactData.ExtraDetail data = datas.get( organisation );
830
 
 
831
 
                        // we don't want to add this address if it exists already or we
832
 
                        // would introduce duplicates
833
 
                        if( _contacts_cache.hasAssociatedOrganisation( id, organisation ) )
834
 
                                continue;
835
 
 
836
 
                        // add organisation address
837
 
                        _backend.addContactOrganisation( id, organisation, data );
838
 
 
839
 
                        // and add this address to the cache to prevent a addition of
840
 
                        // duplicate date from another file
841
 
                        _contacts_cache.addAssociatedOrganisation( id, organisation );
 
534
                        ContentValues values = new ContentValues();
 
535
                        values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL );
 
536
                        values.put( Contacts.ContactMethods.DATA, email.getAddress() );
 
537
                        values.put( Contacts.ContactMethods.TYPE, email.getType() );
 
538
                        if( email.isPreferred() )
 
539
                                values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
 
540
                        _doit.getContentResolver().insert( contactContactMethodsUri,
 
541
                                        values );
 
542
                }
 
543
 
 
544
                // now add those email addresses to the cache to prevent the addition of
 
545
                // duplicate data from another file
 
546
                i = emailsKeys.iterator();
 
547
                while( i.hasNext() ) {
 
548
                        ContactData.EmailData email = emails.get( i.next() );
 
549
 
 
550
                        String address = sanitiseEmailAddress( email.getAddress() );
 
551
                        if( address != null ) {
 
552
                                HashSet< String > addresses = _contactEmails.get( contactId );
 
553
                                if( addresses == null ) {
 
554
                                        _contactEmails.put( contactId, new HashSet< String >() );
 
555
                                        addresses = _contactEmails.get( contactId );
 
556
                                }
 
557
                                addresses.add( address );
 
558
                        }
842
559
                }
843
560
        }
844
561
 
849
566
                        throw new AbortImportException();
850
567
                }
851
568
        }
 
569
 
 
570
        private void buildContactsCache() throws AbortImportException
 
571
        {
 
572
                // update UI
 
573
                setProgressMessage( R.string.doit_caching );
 
574
 
 
575
                String[] cols;
 
576
                Cursor cur;
 
577
 
 
578
                // init contacts caches
 
579
                _contacts = new HashMap< String, Long >();
 
580
                _contactNumbers = new HashMap< Long, HashSet< String > >();
 
581
                _contactEmails = new HashMap< Long, HashSet< String > >();
 
582
 
 
583
                // query and store map of contact names to ids
 
584
                cols = new String[] { Contacts.People._ID, Contacts.People.NAME };
 
585
                cur = _doit.managedQuery( Contacts.People.CONTENT_URI,
 
586
                                cols, null, null, null);
 
587
                if( cur.moveToFirst() ) {
 
588
                        int idCol = cur.getColumnIndex( Contacts.People._ID );
 
589
                        int nameCol = cur.getColumnIndex( Contacts.People.NAME );
 
590
                        do {
 
591
                                _contacts.put( cur.getString( nameCol ), cur.getLong( idCol ) );
 
592
                        } while( cur.moveToNext() );
 
593
                }
 
594
 
 
595
                // query and store map of contact ids to sets of phone numbers
 
596
                cols = new String[] { Contacts.Phones.PERSON_ID,
 
597
                                Contacts.Phones.NUMBER };
 
598
                cur = _doit.managedQuery( Contacts.Phones.CONTENT_URI,
 
599
                                cols, null, null, null);
 
600
                if( cur.moveToFirst() ) {
 
601
                        int personIdCol = cur.getColumnIndex( Contacts.Phones.PERSON_ID );
 
602
                        int numberCol = cur.getColumnIndex( Contacts.Phones.NUMBER );
 
603
                        do {
 
604
                                Long id = cur.getLong( personIdCol );
 
605
                                String number = sanitisePhoneNumber(
 
606
                                                cur.getString( numberCol ) );
 
607
                                if( number != null ) {
 
608
                                        HashSet< String > numbers = _contactNumbers.get( id );
 
609
                                        if( numbers == null ) {
 
610
                                                _contactNumbers.put( id, new HashSet< String >() );
 
611
                                                numbers = _contactNumbers.get( id );
 
612
                                        }
 
613
                                        numbers.add( number );
 
614
                                }
 
615
                        } while( cur.moveToNext() );
 
616
                }
 
617
 
 
618
                // query and store map of contact ids to sets of email addresses
 
619
                cols = new String[] { Contacts.ContactMethods.PERSON_ID,
 
620
                                Contacts.ContactMethods.DATA };
 
621
                cur = _doit.managedQuery( Contacts.ContactMethods.CONTENT_URI,
 
622
                                cols, Contacts.ContactMethods.KIND + " = ?",
 
623
                                new String[] { "" + Contacts.KIND_EMAIL }, null );
 
624
                if( cur.moveToFirst() ) {
 
625
                        int personIdCol = cur.getColumnIndex(
 
626
                                        Contacts.ContactMethods.PERSON_ID );
 
627
                        int addressCol = cur.getColumnIndex(
 
628
                                        Contacts.ContactMethods.DATA );
 
629
                        do {
 
630
                                Long id = cur.getLong( personIdCol );
 
631
                                String address = sanitiseEmailAddress(
 
632
                                                cur.getString( addressCol ) );
 
633
                                if( address != null ) {
 
634
                                        HashSet< String > addresses = _contactEmails.get( id );
 
635
                                        if( addresses == null ) {
 
636
                                                _contactEmails.put( id, new HashSet< String >() );
 
637
                                                addresses = _contactEmails.get( id );
 
638
                                        }
 
639
                                        addresses.add( address );
 
640
                                }
 
641
                        } while( cur.moveToNext() );
 
642
                }
 
643
        }
 
644
 
 
645
        private String sanitisePhoneNumber( String number )
 
646
        {
 
647
                number = number.replaceAll( "[-\\(\\) ]", "" );
 
648
                Pattern p = Pattern.compile( "^\\+?[0-9]+" );
 
649
                Matcher m = p.matcher( number );
 
650
                if( m.lookingAt() ) return m.group( 0 );
 
651
                return null;
 
652
        }
 
653
 
 
654
        private String sanitiseEmailAddress( String address )
 
655
        {
 
656
                address = address.trim();
 
657
                Pattern p = Pattern.compile(
 
658
                                "^[^ @]+@[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?(\\.[a-zA-Z]([-a-zA-Z0-9]*[a-zA-z0-9])?)+$" );
 
659
                Matcher m = p.matcher( address );
 
660
                if( m.matches() ) {
 
661
                        String[] bits = address.split( "@" );
 
662
                        return bits[ 0 ] + "@" + bits[ 1 ].toLowerCase();
 
663
                }
 
664
                return null;
 
665
        }
852
666
}