/android/import-contacts

To get this branch, use:
bzr branch http://bzr.ed.am/android/import-contacts
39 by edam
- pulled contacts cache out in to seperate class
1
/*
2
 * ContactsCache.java
3
 *
50 by edam
updated all URLs, email addresses and package names to ed.am
4
 * Copyright (C) 2011 Tim Marston <tim@ed.am>
39 by edam
- pulled contacts cache out in to seperate class
5
 *
6
 * This file is part of the Import Contacts program (hereafter referred
7
 * to as "this program"). For more information, see
50 by edam
updated all URLs, email addresses and package names to ed.am
8
 * http://ed.am/dev/android/import-contacts
39 by edam
- pulled contacts cache out in to seperate class
9
 *
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.
14
 *
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.
19
 *
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/>.
22
 */
23
50 by edam
updated all URLs, email addresses and package names to ed.am
24
package am.ed.importcontacts;
39 by edam
- pulled contacts cache out in to seperate class
25
26
import java.util.HashMap;
27
import java.util.HashSet;
28
50 by edam
updated all URLs, email addresses and package names to ed.am
29
import am.ed.importcontacts.Importer.AbortImportException;
39 by edam
- pulled contacts cache out in to seperate class
30
31
import android.app.Activity;
32
import android.database.Cursor;
33
import android.provider.Contacts;
34
35
36
public class ContactsCache
37
{
40 by edam
- fixed logic for vcard field types (home, work, cell, etc) so it works
38
	/**
39
	 * Information that can be used to identify a contact within the cache
40
	 */
41
	static public class CacheIdentifier
42
	{
43
		public enum Type {
44
			NONE, NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
45
46
		private Type _type;
47
		private String _detail;
48
49
		protected CacheIdentifier()
50
		{
51
			_type = Type.NONE;
52
		}
53
54
		protected CacheIdentifier( Type type, String detail )
55
		{
56
			_type = type;
57
			_detail = detail;
58
		}
59
60
		public Type getType()
61
		{
62
			return _type;
63
		}
64
65
		public String getDetail()
66
		{
67
			return _detail;
68
		}
69
	}
70
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;
76
77
	// mapping of contact ids to sets of associated data
39 by edam
- pulled contacts cache out in to seperate class
78
	private HashMap< Long, HashSet< String > > _contactNumbers;
79
	private HashMap< Long, HashSet< String > > _contactEmails;
80
	private HashMap< Long, HashSet< String > > _contactAddresses;
40 by edam
- fixed logic for vcard field types (home, work, cell, etc) so it works
81
	private HashMap< Long, HashSet< String > > _contactOrganisations;
82
83
	public static CacheIdentifier createIdentifier(
84
		Importer.ContactData contact )
85
	{
86
		if( contact.hasName() ) {
87
			String name = normaliseName( contact.getName() );
88
			if( name != null )
89
				return new CacheIdentifier(
90
					CacheIdentifier.Type.NAME, name );
91
		}
92
93
		if( contact.hasPrimaryOrganisation() ) {
94
			String organisation = normaliseOrganisation(
95
				contact.getPrimaryOrganisation() );
96
			if( organisation != null )
97
				return new CacheIdentifier(
98
					CacheIdentifier.Type.ORGANISATION, organisation );
99
		}
100
101
		if( contact.hasPrimaryNumber() ) {
102
			String number = normalisePhoneNumber( contact.getPrimaryNumber() );
103
			if( number != null )
104
			return new CacheIdentifier(
105
				CacheIdentifier.Type.PRIMARY_NUMBER, number );
106
		}
107
108
		if( contact.hasPrimaryEmail() ) {
109
			String email = normaliseEmailAddress( contact.getPrimaryEmail() );
110
			if( email != null )
111
			return new CacheIdentifier(
112
				CacheIdentifier.Type.PRIMARY_EMAIL, email );
113
		}
114
115
		return null;
116
	}
117
118
	public boolean canLookup( CacheIdentifier identifier )
119
	{
120
		return lookup( identifier ) != null;
121
	}
122
123
	public Long lookup( CacheIdentifier identifier )
124
	{
125
		switch( identifier.getType() )
126
		{
127
		case NAME:
128
			return _contactsByName.get( identifier.getDetail() );
129
		case ORGANISATION:
130
			return _contactsByOrg.get( identifier.getDetail() );
131
		case PRIMARY_NUMBER:
132
			return _contactsByNumber.get( identifier.getDetail() );
133
		case PRIMARY_EMAIL:
134
			return _contactsByEmail.get( identifier.getDetail() );
135
		}
136
		return null;
137
	}
138
139
	public Long removeLookup( CacheIdentifier identifier )
140
	{
141
		switch( identifier.getType() )
142
		{
143
		case NAME:
144
			return _contactsByName.remove( identifier.getDetail() );
145
		case ORGANISATION:
146
			return _contactsByOrg.remove( identifier.getDetail() );
147
		case PRIMARY_NUMBER:
148
			return _contactsByNumber.remove( identifier.getDetail() );
149
		case PRIMARY_EMAIL:
150
			return _contactsByEmail.remove( identifier.getDetail() );
151
		}
152
		return null;
153
	}
154
155
	public void addLookup( CacheIdentifier identifier, Long id )
156
	{
157
		switch( identifier.getType() )
158
		{
159
		case NAME:
160
			_contactsByName.put( identifier.getDetail(), id );
161
			break;
162
		case ORGANISATION:
163
			_contactsByOrg.put( identifier.getDetail(), id );
164
			break;
165
		case PRIMARY_NUMBER:
166
			_contactsByNumber.put( identifier.getDetail(), id );
167
			break;
168
		case PRIMARY_EMAIL:
169
			_contactsByEmail.put( identifier.getDetail(), id );
170
			break;
171
		}
172
	}
173
174
	public void removeAssociatedData( Long id )
175
	{
176
		_contactNumbers.remove( id );
177
		_contactEmails.remove( id );
178
		_contactAddresses.remove( id );
179
		_contactOrganisations.remove( id );
180
	}
181
182
	public boolean hasAssociatedNumber( Long id, String number )
183
	{
184
		number = normalisePhoneNumber( number );
185
		if( number == null ) return false;
186
187
		HashSet< String > set = _contactNumbers.get( id );
188
		return set != null && set.contains( number );
189
	}
190
191
	public void addAssociatedNumber( Long id, String number )
192
	{
193
		number = normalisePhoneNumber( number );
194
		if( number == null ) return;
195
196
		HashSet< String > set = _contactNumbers.get( id );
197
		if( set == null ) {
198
			set = new HashSet< String >();
199
			_contactNumbers.put( id, set );
200
		}
201
		set.add( normalisePhoneNumber( number ) );
202
	}
203
204
	public boolean hasAssociatedEmail( Long id, String email )
205
	{
206
		email = normaliseEmailAddress( email );
207
		if( email == null ) return false;
208
209
		HashSet< String > set = _contactEmails.get( id );
210
		return set != null && set.contains( normaliseEmailAddress( email ) );
211
	}
212
213
	public void addAssociatedEmail( Long id, String email )
214
	{
215
		email = normaliseEmailAddress( email );
216
		if( email == null ) return;
217
218
		HashSet< String > set = _contactEmails.get( id );
219
		if( set == null ) {
220
			set = new HashSet< String >();
221
			_contactEmails.put( id, set );
222
		}
223
		set.add( normaliseEmailAddress( email ) );
224
	}
225
226
	public boolean hasAssociatedAddress( Long id, String address )
227
	{
228
		address = normaliseAddress( address );
229
		if( address == null ) return false;
230
231
		HashSet< String > set = _contactAddresses.get( id );
232
		return set != null && set.contains( normaliseAddress( address ) );
233
	}
234
235
	public void addAssociatedAddress( Long id, String address )
236
	{
237
		address = normaliseAddress( address );
238
		if( address == null ) return;
239
240
		HashSet< String > set = _contactAddresses.get( id );
241
		if( set == null ) {
242
			set = new HashSet< String >();
243
			_contactAddresses.put( id, set );
244
		}
245
		set.add( normaliseAddress( address ) );
246
	}
247
248
	public boolean hasAssociatedOrganisation( Long id, String organisation )
249
	{
250
		organisation = normaliseOrganisation( organisation );
251
		if( organisation == null ) return false;
252
253
		HashSet< String > set = _contactOrganisations.get( id );
254
		return set != null && set.contains(
255
			normaliseOrganisation( organisation ) );
256
	}
257
258
	public void addAssociatedOrganisation( Long id, String organisation )
259
	{
260
		organisation = normaliseOrganisation( organisation );
261
		if( organisation == null ) return;
262
263
		HashSet< String > set = _contactOrganisations.get( id );
264
		if( set == null ) {
265
			set = new HashSet< String >();
266
			_contactOrganisations.put( id, set );
267
		}
268
		set.add( normaliseOrganisation( organisation ) );
39 by edam
- pulled contacts cache out in to seperate class
269
	}
270
271
	public void buildCache( Activity activity )
272
		throws AbortImportException
273
	{
274
		Cursor cur;
275
40 by edam
- fixed logic for vcard field types (home, work, cell, etc) so it works
276
		// init id lookups
277
		_contactsByName = new HashMap< String, Long >();
278
		_contactsByOrg = new HashMap< String, Long >();
279
		_contactsByNumber = new HashMap< String, Long >();
280
		_contactsByEmail = new HashMap< String, Long >();
281
282
		// init associated data cache
39 by edam
- pulled contacts cache out in to seperate class
283
		_contactNumbers = new HashMap< Long, HashSet< String > >();
284
		_contactEmails = new HashMap< Long, HashSet< String > >();
285
		_contactAddresses = new HashMap< Long, HashSet< String > >();
40 by edam
- fixed logic for vcard field types (home, work, cell, etc) so it works
286
		_contactOrganisations = new HashMap< Long, HashSet< String > >();
287
288
		// set of contact ids that we have not yet added
289
		HashSet< Long > unadded = new HashSet< Long >();
290
291
		// get all contacts
39 by edam
- pulled contacts cache out in to seperate class
292
		cur = activity.managedQuery( Contacts.People.CONTENT_URI,
40 by edam
- fixed logic for vcard field types (home, work, cell, etc) so it works
293
			new String[] {
294
				Contacts.People._ID,
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 ) ) );
302
			if( name != null )
303
			{
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 );
308
					continue;
309
				}
310
			}
311
312
			// record that a lookup for this contact's id still needs to be
313
			// added by some other means
314
			unadded.add( id );
315
		}
316
317
		// get contact organisations, primary ones first
318
		cur = activity.managedQuery( Contacts.Organizations.CONTENT_URI,
319
			new String[] {
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 )
329
			{
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
332
				// by organisation
333
				if( unadded.contains( id ) ) {
334
					addLookup( new CacheIdentifier(
335
						CacheIdentifier.Type.ORGANISATION, organisation ), id );
336
					unadded.remove( id );
337
				}
338
339
				// add associated data
340
				addAssociatedOrganisation( id, organisation );
341
			}
342
		}
343
344
		// get all phone numbers, primary ones first
39 by edam
- pulled contacts cache out in to seperate class
345
		cur = activity.managedQuery( Contacts.Phones.CONTENT_URI,
40 by edam
- fixed logic for vcard field types (home, work, cell, etc) so it works
346
			new String[] {
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 ) ) );
355
			if( number != null )
356
			{
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
359
				// number
360
				if( unadded.contains( id ) ) {
361
					addLookup( new CacheIdentifier(
362
						CacheIdentifier.Type.PRIMARY_NUMBER, number ), id );
363
					unadded.remove( id );
364
				}
365
366
				// add associated data
367
				addAssociatedNumber( id, number );
368
			}
369
		}
370
371
		// now get all email addresses, primary ones first, and postal addresses
372
		cur = activity.managedQuery( Contacts.ContactMethods.CONTENT_URI,
373
			new String[] {
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 )
387
			{
388
				String email = normaliseEmailAddress( cur.getString(
389
					cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) );
390
				if( email != null )
391
				{
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 );
399
					}
400
401
					// add associated data
402
					addAssociatedEmail( id, email );
403
				}
404
			}
405
			else if( kind == Contacts.KIND_POSTAL )
406
			{
407
				String address = normaliseAddress( cur.getString(
408
					cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) );
409
				if( address != null )
410
				{
411
					// add associated data
412
					addAssociatedAddress( id, address );
413
				}
414
			}
415
		}
416
	}
417
418
	static private String normaliseName( String name )
419
	{
420
		if( name == null ) return null;
421
		name = name.trim();
422
		return name.length() > 0? name : null;
423
	}
424
425
	static private String normalisePhoneNumber( String number )
426
	{
427
		if( number == null ) return null;
428
		number = number.trim().replaceAll( "[-\\(\\) ]", "" );
429
		return number.length() > 0? number : null;
430
	}
431
432
	static private String normaliseEmailAddress( String email )
433
	{
434
		if( email == null ) return null;
435
		email = email.trim().toLowerCase();
436
		return email.length() > 0? email : null;
437
	}
438
439
	static private String normaliseOrganisation( String organisation )
440
	{
441
		if( organisation == null ) return null;
442
		organisation = organisation.trim();
443
		return organisation.length() > 0? organisation : null;
444
	}
445
446
	static private String normaliseAddress( String address )
447
	{
448
		if( address == null ) return null;
449
		address = address.trim();
450
		return address.length() > 0? address : null;
39 by edam
- pulled contacts cache out in to seperate class
451
	}
452
}