4
* Copyright (C) 2011 Tim Marston <tim@ed.am>
6
* This file is part of the Import Contacts program (hereafter referred
7
* to as "this program"). For more information, see
8
* http://ed.am/dev/android/import-contacts
10
* This program is free software: you can redistribute it and/or modify
11
* it under the terms of the GNU General Public License as published by
12
* the Free Software Foundation, either version 3 of the License, or
13
* (at your option) any later version.
15
* This program is distributed in the hope that it will be useful,
16
* but WITHOUT ANY WARRANTY; without even the implied warranty of
17
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18
* GNU General Public License for more details.
20
* You should have received a copy of the GNU General Public License
21
* along with this program. If not, see <http://www.gnu.org/licenses/>.
24
package am.ed.importcontacts;
26
import java.util.HashMap;
27
import java.util.HashSet;
29
import am.ed.importcontacts.Importer.AbortImportException;
31
import android.app.Activity;
32
import android.database.Cursor;
33
import android.provider.Contacts;
36
public class ContactsCache
39
* Information that can be used to identify a contact within the cache
41
static public class CacheIdentifier
44
NONE, NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
47
private String _detail;
49
protected CacheIdentifier()
54
protected CacheIdentifier( Type type, String detail )
65
public String getDetail()
71
// mappings of contact names, organisations and primary numbers to ids
72
private HashMap< String, Long > _contactsByName;
73
private HashMap< String, Long > _contactsByOrg;
74
private HashMap< String, Long > _contactsByNumber;
75
private HashMap< String, Long > _contactsByEmail;
77
// mapping of contact ids to sets of associated data
78
private HashMap< Long, HashSet< String > > _contactNumbers;
79
private HashMap< Long, HashSet< String > > _contactEmails;
80
private HashMap< Long, HashSet< String > > _contactAddresses;
81
private HashMap< Long, HashSet< String > > _contactOrganisations;
83
public static CacheIdentifier createIdentifier(
84
Importer.ContactData contact )
86
if( contact.hasName() ) {
87
String name = normaliseName( contact.getName() );
89
return new CacheIdentifier(
90
CacheIdentifier.Type.NAME, name );
93
if( contact.hasPrimaryOrganisation() ) {
94
String organisation = normaliseOrganisation(
95
contact.getPrimaryOrganisation() );
96
if( organisation != null )
97
return new CacheIdentifier(
98
CacheIdentifier.Type.ORGANISATION, organisation );
101
if( contact.hasPrimaryNumber() ) {
102
String number = normalisePhoneNumber( contact.getPrimaryNumber() );
104
return new CacheIdentifier(
105
CacheIdentifier.Type.PRIMARY_NUMBER, number );
108
if( contact.hasPrimaryEmail() ) {
109
String email = normaliseEmailAddress( contact.getPrimaryEmail() );
111
return new CacheIdentifier(
112
CacheIdentifier.Type.PRIMARY_EMAIL, email );
118
public boolean canLookup( CacheIdentifier identifier )
120
return lookup( identifier ) != null;
123
public Long lookup( CacheIdentifier identifier )
125
switch( identifier.getType() )
128
return _contactsByName.get( identifier.getDetail() );
130
return _contactsByOrg.get( identifier.getDetail() );
132
return _contactsByNumber.get( identifier.getDetail() );
134
return _contactsByEmail.get( identifier.getDetail() );
139
public Long removeLookup( CacheIdentifier identifier )
141
switch( identifier.getType() )
144
return _contactsByName.remove( identifier.getDetail() );
146
return _contactsByOrg.remove( identifier.getDetail() );
148
return _contactsByNumber.remove( identifier.getDetail() );
150
return _contactsByEmail.remove( identifier.getDetail() );
155
public void addLookup( CacheIdentifier identifier, Long id )
157
switch( identifier.getType() )
160
_contactsByName.put( identifier.getDetail(), id );
163
_contactsByOrg.put( identifier.getDetail(), id );
166
_contactsByNumber.put( identifier.getDetail(), id );
169
_contactsByEmail.put( identifier.getDetail(), id );
174
public void removeAssociatedData( Long id )
176
_contactNumbers.remove( id );
177
_contactEmails.remove( id );
178
_contactAddresses.remove( id );
179
_contactOrganisations.remove( id );
182
public boolean hasAssociatedNumber( Long id, String number )
184
number = normalisePhoneNumber( number );
185
if( number == null ) return false;
187
HashSet< String > set = _contactNumbers.get( id );
188
return set != null && set.contains( number );
191
public void addAssociatedNumber( Long id, String number )
193
number = normalisePhoneNumber( number );
194
if( number == null ) return;
196
HashSet< String > set = _contactNumbers.get( id );
198
set = new HashSet< String >();
199
_contactNumbers.put( id, set );
201
set.add( normalisePhoneNumber( number ) );
204
public boolean hasAssociatedEmail( Long id, String email )
206
email = normaliseEmailAddress( email );
207
if( email == null ) return false;
209
HashSet< String > set = _contactEmails.get( id );
210
return set != null && set.contains( normaliseEmailAddress( email ) );
213
public void addAssociatedEmail( Long id, String email )
215
email = normaliseEmailAddress( email );
216
if( email == null ) return;
218
HashSet< String > set = _contactEmails.get( id );
220
set = new HashSet< String >();
221
_contactEmails.put( id, set );
223
set.add( normaliseEmailAddress( email ) );
226
public boolean hasAssociatedAddress( Long id, String address )
228
address = normaliseAddress( address );
229
if( address == null ) return false;
231
HashSet< String > set = _contactAddresses.get( id );
232
return set != null && set.contains( normaliseAddress( address ) );
235
public void addAssociatedAddress( Long id, String address )
237
address = normaliseAddress( address );
238
if( address == null ) return;
240
HashSet< String > set = _contactAddresses.get( id );
242
set = new HashSet< String >();
243
_contactAddresses.put( id, set );
245
set.add( normaliseAddress( address ) );
248
public boolean hasAssociatedOrganisation( Long id, String organisation )
250
organisation = normaliseOrganisation( organisation );
251
if( organisation == null ) return false;
253
HashSet< String > set = _contactOrganisations.get( id );
254
return set != null && set.contains(
255
normaliseOrganisation( organisation ) );
258
public void addAssociatedOrganisation( Long id, String organisation )
260
organisation = normaliseOrganisation( organisation );
261
if( organisation == null ) return;
263
HashSet< String > set = _contactOrganisations.get( id );
265
set = new HashSet< String >();
266
_contactOrganisations.put( id, set );
268
set.add( normaliseOrganisation( organisation ) );
271
public void buildCache( Activity activity )
272
throws AbortImportException
277
_contactsByName = new HashMap< String, Long >();
278
_contactsByOrg = new HashMap< String, Long >();
279
_contactsByNumber = new HashMap< String, Long >();
280
_contactsByEmail = new HashMap< String, Long >();
282
// init associated data cache
283
_contactNumbers = new HashMap< Long, HashSet< String > >();
284
_contactEmails = new HashMap< Long, HashSet< String > >();
285
_contactAddresses = new HashMap< Long, HashSet< String > >();
286
_contactOrganisations = new HashMap< Long, HashSet< String > >();
288
// set of contact ids that we have not yet added
289
HashSet< Long > unadded = new HashSet< Long >();
292
cur = activity.managedQuery( Contacts.People.CONTENT_URI,
295
Contacts.People.NAME,
296
}, null, null, null );
297
while( cur.moveToNext() ) {
298
Long id = cur.getLong(
299
cur.getColumnIndex( Contacts.People._ID ) );
300
String name = normaliseName( cur.getString(
301
cur.getColumnIndex( Contacts.People.NAME ) ) );
304
// if we can, add a lookup for the contact id by name
305
if( name.length() > 0 ) {
306
addLookup( new CacheIdentifier(
307
CacheIdentifier.Type.NAME, name ), id );
312
// record that a lookup for this contact's id still needs to be
313
// added by some other means
317
// get contact organisations, primary ones first
318
cur = activity.managedQuery( Contacts.Organizations.CONTENT_URI,
320
Contacts.Phones.PERSON_ID,
321
Contacts.Organizations.COMPANY,
322
}, null, null, Contacts.Organizations.ISPRIMARY + " DESC" );
323
while( cur.moveToNext() ) {
324
Long id = cur.getLong( cur.getColumnIndex(
325
Contacts.Organizations.PERSON_ID ) );
326
String organisation = normaliseOrganisation( cur.getString(
327
cur.getColumnIndex( Contacts.Organizations.COMPANY ) ) );
328
if( organisation != null )
330
// if this is an organisation name for a contact for whom we
331
// have not added a lookup, add a lookup for the contact id
333
if( unadded.contains( id ) ) {
334
addLookup( new CacheIdentifier(
335
CacheIdentifier.Type.ORGANISATION, organisation ), id );
336
unadded.remove( id );
339
// add associated data
340
addAssociatedOrganisation( id, organisation );
344
// get all phone numbers, primary ones first
345
cur = activity.managedQuery( Contacts.Phones.CONTENT_URI,
347
Contacts.Phones.PERSON_ID,
348
Contacts.Phones.NUMBER,
349
}, null, null, Contacts.Phones.ISPRIMARY + " DESC" );
350
while( cur.moveToNext() ) {
351
Long id = cur.getLong(
352
cur.getColumnIndex( Contacts.Phones.PERSON_ID ) );
353
String number = normalisePhoneNumber( cur.getString(
354
cur.getColumnIndex( Contacts.Phones.NUMBER ) ) );
357
// if this is a number for a contact for whom we have not
358
// added a lookup, add a lookup for the contact id by phone
360
if( unadded.contains( id ) ) {
361
addLookup( new CacheIdentifier(
362
CacheIdentifier.Type.PRIMARY_NUMBER, number ), id );
363
unadded.remove( id );
366
// add associated data
367
addAssociatedNumber( id, number );
371
// now get all email addresses, primary ones first, and postal addresses
372
cur = activity.managedQuery( Contacts.ContactMethods.CONTENT_URI,
374
Contacts.ContactMethods.PERSON_ID,
375
Contacts.ContactMethods.DATA,
376
Contacts.ContactMethods.KIND,
377
}, Contacts.ContactMethods.KIND + " IN( ?, ? )", new String[] {
378
"" + Contacts.KIND_EMAIL,
379
"" + Contacts.KIND_POSTAL,
380
}, Contacts.ContactMethods.ISPRIMARY + " DESC" );
381
while( cur.moveToNext() ) {
382
Long id = cur.getLong(
383
cur.getColumnIndex( Contacts.ContactMethods.PERSON_ID ) );
384
int kind = cur.getInt(
385
cur.getColumnIndex( Contacts.ContactMethods.KIND ) );
386
if( kind == Contacts.KIND_EMAIL )
388
String email = normaliseEmailAddress( cur.getString(
389
cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) );
392
// if this is an email address for a contact for whom we
393
// have not added a lookup, add a lookup for the contact
394
// id by email address
395
if( unadded.contains( id ) ) {
396
addLookup( new CacheIdentifier(
397
CacheIdentifier.Type.PRIMARY_EMAIL, email ), id );
398
unadded.remove( id );
401
// add associated data
402
addAssociatedEmail( id, email );
405
else if( kind == Contacts.KIND_POSTAL )
407
String address = normaliseAddress( cur.getString(
408
cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) );
409
if( address != null )
411
// add associated data
412
addAssociatedAddress( id, address );
418
static private String normaliseName( String name )
420
if( name == null ) return null;
422
return name.length() > 0? name : null;
425
static private String normalisePhoneNumber( String number )
427
if( number == null ) return null;
428
number = number.trim().replaceAll( "[-\\(\\) ]", "" );
429
return number.length() > 0? number : null;
432
static private String normaliseEmailAddress( String email )
434
if( email == null ) return null;
435
email = email.trim().toLowerCase();
436
return email.length() > 0? email : null;
439
static private String normaliseOrganisation( String organisation )
441
if( organisation == null ) return null;
442
organisation = organisation.trim();
443
return organisation.length() > 0? organisation : null;
446
static private String normaliseAddress( String address )
448
if( address == null ) return null;
449
address = address.trim();
450
return address.length() > 0? address : null;