51
* Obtain a cache identifier. This routine is designed to be as robust
52
* as possible (in terms of bad or null detail values), and to return
53
* null when a cache identifier can not be created.
54
* @param type the detail type
55
* @param detail the detail
56
* @return the cache identifier, or null
58
public static CacheIdentifier factory( Type type, String detail )
62
case NAME: detail = normaliseName( detail ); break;
63
case ORGANISATION: detail = normaliseOrganisation( detail ); break;
64
case PRIMARY_NUMBER: detail = normalisePhoneNumber( detail ); break;
65
case PRIMARY_EMAIL: detail = normaliseEmailAddress( detail ); break;
68
if( detail == null ) return null;
69
return new CacheIdentifier( type, detail );
73
* Obtain a cache identifier from contact data. This routine is
74
* designed to be as robust as possible and may return null when a cache
75
* identifier can not be created.
76
* @param contact the contact data
77
* @return the cache identifier, or null
79
public static CacheIdentifier factory( Importer.ContactData contact )
81
CacheIdentifier ret = null;
83
if( contact.hasName() )
84
ret = factory( CacheIdentifier.Type.NAME,
86
if( ret == null && contact.hasPrimaryOrganisation() )
87
ret = factory( CacheIdentifier.Type.ORGANISATION,
88
contact.getPrimaryOrganisation() );
89
if( ret == null && contact.hasPrimaryNumber() )
90
ret = factory( CacheIdentifier.Type.PRIMARY_NUMBER,
91
contact.getPrimaryNumber() );
92
if( ret == null && contact.hasPrimaryEmail() )
93
ret = factory( CacheIdentifier.Type.PRIMARY_EMAIL,
94
contact.getPrimaryEmail() );
54
99
protected CacheIdentifier( Type type, String detail )
71
116
// 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;
117
private HashMap< String, Long > _contactsByName
118
= new HashMap< String, Long >();
119
private HashMap< String, Long > _contactsByOrg
120
= new HashMap< String, Long >();
121
private HashMap< String, Long > _contactsByNumber
122
= new HashMap< String, Long >();
123
private HashMap< String, Long > _contactsByEmail
124
= new HashMap< String, Long >();
77
126
// 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 );
127
private HashMap< Long, HashSet< String > > _contactNumbers
128
= new HashMap< Long, HashSet< String > >();
129
private HashMap< Long, HashSet< String > > _contactEmails
130
= new HashMap< Long, HashSet< String > >();
131
private HashMap< Long, HashSet< String > > _contactAddresses
132
= new HashMap< Long, HashSet< String > >();
133
private HashMap< Long, HashSet< String > > _contactOrganisations
134
= new HashMap< Long, HashSet< String > >();
135
private HashMap< Long, HashSet< String > > _contactNotes
136
= new HashMap< Long, HashSet< String > >();
118
138
public boolean canLookup( CacheIdentifier identifier )
120
140
return lookup( identifier ) != null;
144
* Retrieve the contact id of a contact identified by the specified cache
145
* identifier, if it exists.
146
* @param identifier the cache identifier
147
* @return a contact id, or null
123
149
public Long lookup( CacheIdentifier identifier )
125
151
switch( identifier.getType() )
265
305
set = new HashSet< String >();
266
306
_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 )
308
set.add( organisation );
311
public boolean hasAssociatedNote( Long id, String note )
313
note = normaliseNote( note );
314
if( note == null ) return false;
316
HashSet< String > set = _contactNotes.get( id );
317
return set != null && set.contains( note );
320
public void addAssociatedNote( Long id, String note )
322
note = normaliseNote( note );
323
if( note == null ) return;
325
HashSet< String > set = _contactNotes.get( id );
327
set = new HashSet< String >();
328
_contactNotes.put( id, set );
333
static public String normaliseName( String name )
420
335
if( name == null ) return null;
421
336
name = name.trim();
422
337
return name.length() > 0? name : null;
425
static private String normalisePhoneNumber( String number )
340
static public String normalisePhoneNumber( String number )
427
342
if( number == null ) return null;
428
343
number = number.trim().replaceAll( "[-\\(\\) ]", "" );
429
344
return number.length() > 0? number : null;
432
static private String normaliseEmailAddress( String email )
347
static public String normaliseEmailAddress( String email )
434
349
if( email == null ) return null;
435
email = email.trim().toLowerCase();
350
email = email.trim().toLowerCase( Locale.US );
436
351
return email.length() > 0? email : null;
439
static private String normaliseOrganisation( String organisation )
354
static public String normaliseOrganisation( String organisation )
441
356
if( organisation == null ) return null;
442
357
organisation = organisation.trim();
443
358
return organisation.length() > 0? organisation : null;
446
static private String normaliseAddress( String address )
361
static public String normaliseAddress( String address )
448
363
if( address == null ) return null;
449
364
address = address.trim();
450
365
return address.length() > 0? address : null;
368
static public String normaliseNote( String note )
370
if( note == null ) return null;
372
return note.length() > 0? note : null;