(root)/android/import-contacts
» Revision
5
(compared to revision 94)
: src/am/ed/importcontacts/ContactsCache.java
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/am/ed/importcontacts/ContactsCache.java
- browse files at revision 5
- compare with another revision
- download diff
- download tarball
- view history from revision 5
- Committer: edam
- Date: 2009-01-11 13:00:52 UTC
- Revision ID: edam@waxworlds.org-20090111130052-q9bh0zz4ey47egbv
- updated todo list
- files added:
- src/org
- src/org/waxworlds
- files removed:
- COPYING
- gen
- gen/am
- gen/am/ed
- gen/am/ed/importcontacts
- src/am
- src/am/ed
- files renamed:
- res/layout/configure_vcf.xml => res/layout/import_vcf.xml
- src/am/ed/importcontacts/ => src/org/waxworlds/importcontacts/
- src/am/ed/importcontacts/ConfigureVCF.java => src/org/waxworlds/importcontacts/ImportVCF.java
- src/am/ed/importcontacts/VcardImporter.java => src/org/waxworlds/importcontacts/VCFImporter.java
- files modified:
- .classpath
added
removed
src/am/ed/importcontacts/ContactsCache.java
1
/*
2
* ContactsCache.java
3
*
4
* Copyright (C) 2011 to 2012 Tim Marston <tim@ed.am>
5
*
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
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
24
package am.ed.importcontacts;
25
26
import java.util.HashMap;
27
import java.util.HashSet;
28
import java.util.Locale;
29
30
public class ContactsCache
31
{
32
/**
33
* A thing that can be used to identify (or lookup) a contact within the
34
* contacts cache. It is not a reference to a cache entry and may not
35
* identify an existing contact in the cache.
36
*/
37
public static class CacheIdentifier
38
{
39
public enum Type { NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
40
41
private Type _type;
42
private String _detail;
43
44
/**
45
* Obtain a cache identifier. This routine is designed to be as robust
46
* as possible (in terms of bad or null detail values), and to return
47
* null when a cache identifier can not be created.
48
*
49
* @param type the detail type
50
* @param detail the detail
51
* @return the cache identifier, or null
52
*/
53
public static CacheIdentifier factory( Type type, String detail )
54
{
55
switch( type )
56
{
57
case NAME: detail = normaliseName( detail ); break;
58
case ORGANISATION: detail = normaliseOrganisation( detail ); break;
59
case PRIMARY_NUMBER: detail = normalisePhoneNumber( detail ); break;
60
case PRIMARY_EMAIL: detail = normaliseEmailAddress( detail ); break;
61
default: return null;
62
}
63
if( detail == null ) return null;
64
return new CacheIdentifier( type, detail );
65
}
66
67
/**
68
* Obtain a cache identifier from contact data. This routine is
69
* designed to be as robust as possible and may return null when a cache
70
* identifier can not be created.
71
*
72
* @param contact the contact data
73
* @return the cache identifier, or null
74
*/
75
public static CacheIdentifier factory( Importer.ContactData contact )
76
{
77
CacheIdentifier identifier = null;
78
79
if( contact.hasName() )
80
identifier = factory( CacheIdentifier.Type.NAME,
81
contact.getName() );
82
if( identifier != null ) return identifier;
83
84
if( contact.hasPrimaryOrganisation() )
85
identifier = factory( CacheIdentifier.Type.ORGANISATION,
86
contact.getPrimaryOrganisation() );
87
if( identifier != null ) return identifier;
88
89
if( contact.hasPrimaryNumber() )
90
identifier = factory( CacheIdentifier.Type.PRIMARY_NUMBER,
91
contact.getPrimaryNumber() );
92
if( identifier != null ) return identifier;
93
94
if( contact.hasPrimaryEmail() )
95
identifier = factory( CacheIdentifier.Type.PRIMARY_EMAIL,
96
contact.getPrimaryEmail() );
97
if( identifier != null ) return identifier;
98
99
return null;
100
}
101
102
protected CacheIdentifier( Type type, String detail )
103
{
104
_type = type;
105
_detail = detail;
106
}
107
108
public Type getType()
109
{
110
return _type;
111
}
112
113
public String getDetail()
114
{
115
return _detail;
116
}
117
}
118
119
// mappings of contact names, organisations and primary numbers to ids
120
private HashMap< String, Long > _contactsByName
121
= new HashMap< String, Long >();
122
private HashMap< String, Long > _contactsByOrg
123
= new HashMap< String, Long >();
124
private HashMap< String, Long > _contactsByNumber
125
= new HashMap< String, Long >();
126
private HashMap< String, Long > _contactsByEmail
127
= new HashMap< String, Long >();
128
129
// mapping of contact ids to sets of associated data
130
private HashMap< Long, HashSet< String > > _contactNumbers
131
= new HashMap< Long, HashSet< String > >();
132
private HashMap< Long, HashSet< String > > _contactEmails
133
= new HashMap< Long, HashSet< String > >();
134
private HashMap< Long, HashSet< String > > _contactAddresses
135
= new HashMap< Long, HashSet< String > >();
136
private HashMap< Long, HashSet< String > > _contactOrganisations
137
= new HashMap< Long, HashSet< String > >();
138
private HashMap< Long, HashSet< String > > _contactNotes
139
= new HashMap< Long, HashSet< String > >();
140
141
public boolean canLookup( CacheIdentifier identifier )
142
{
143
return lookup( identifier ) != null;
144
}
145
146
/**
147
* Retrieve the contact id of a contact identified by the specified cache
148
* identifier, if it exists.
149
*
150
* @param identifier the cache identifier
151
* @return a contact id, or null
152
*/
153
public Long lookup( CacheIdentifier identifier )
154
{
155
switch( identifier.getType() )
156
{
157
case NAME:
158
return _contactsByName.get( identifier.getDetail() );
159
case ORGANISATION:
160
return _contactsByOrg.get( identifier.getDetail() );
161
case PRIMARY_NUMBER:
162
return _contactsByNumber.get( identifier.getDetail() );
163
case PRIMARY_EMAIL:
164
return _contactsByEmail.get( identifier.getDetail() );
165
}
166
return null;
167
}
168
169
/**
170
* Remove any cache entry that is identified by the cache identifier.
171
*
172
* @param identifier the cache identifier
173
* @return the contact id of the contact that was removed, or null
174
*/
175
public Long removeLookup( CacheIdentifier identifier )
176
{
177
switch( identifier.getType() )
178
{
179
case NAME:
180
return _contactsByName.remove( identifier.getDetail() );
181
case ORGANISATION:
182
return _contactsByOrg.remove( identifier.getDetail() );
183
case PRIMARY_NUMBER:
184
return _contactsByNumber.remove( identifier.getDetail() );
185
case PRIMARY_EMAIL:
186
return _contactsByEmail.remove( identifier.getDetail() );
187
}
188
return null;
189
}
190
191
/**
192
* Add a lookup from a contact identifier to a contact id to the cache.
193
*
194
* @param identifier the cache identifier
195
* @param id teh contact id
196
*/
197
public void addLookup( CacheIdentifier identifier, Long id )
198
{
199
switch( identifier.getType() )
200
{
201
case NAME:
202
_contactsByName.put( identifier.getDetail(), id );
203
break;
204
case ORGANISATION:
205
_contactsByOrg.put( identifier.getDetail(), id );
206
break;
207
case PRIMARY_NUMBER:
208
_contactsByNumber.put( identifier.getDetail(), id );
209
break;
210
case PRIMARY_EMAIL:
211
_contactsByEmail.put( identifier.getDetail(), id );
212
break;
213
}
214
}
215
216
/**
217
* Remove any data that is associated with an contact id.
218
*
219
* @param id
220
*/
221
public void removeAssociatedData( Long id )
222
{
223
_contactNumbers.remove( id );
224
_contactEmails.remove( id );
225
_contactAddresses.remove( id );
226
_contactOrganisations.remove( id );
227
_contactNotes.remove( id );
228
}
229
230
public boolean hasAssociatedNumber( Long id, String number )
231
{
232
number = normalisePhoneNumber( number );
233
if( number == null ) return false;
234
235
HashSet< String > set = _contactNumbers.get( id );
236
return set != null && set.contains( number );
237
}
238
239
public void addAssociatedNumber( Long id, String number )
240
{
241
number = normalisePhoneNumber( number );
242
if( number == null ) return;
243
244
HashSet< String > set = _contactNumbers.get( id );
245
if( set == null ) {
246
set = new HashSet< String >();
247
_contactNumbers.put( id, set );
248
}
249
set.add( number );
250
}
251
252
public boolean hasAssociatedEmail( Long id, String email )
253
{
254
email = normaliseEmailAddress( email );
255
if( email == null ) return false;
256
257
HashSet< String > set = _contactEmails.get( id );
258
return set != null && set.contains( email );
259
}
260
261
public void addAssociatedEmail( Long id, String email )
262
{
263
email = normaliseEmailAddress( email );
264
if( email == null ) return;
265
266
HashSet< String > set = _contactEmails.get( id );
267
if( set == null ) {
268
set = new HashSet< String >();
269
_contactEmails.put( id, set );
270
}
271
set.add( email );
272
}
273
274
public boolean hasAssociatedAddress( Long id, String address )
275
{
276
address = normaliseAddress( address );
277
if( address == null ) return false;
278
279
HashSet< String > set = _contactAddresses.get( id );
280
return set != null && set.contains( address );
281
}
282
283
public void addAssociatedAddress( Long id, String address )
284
{
285
address = normaliseAddress( address );
286
if( address == null ) return;
287
288
HashSet< String > set = _contactAddresses.get( id );
289
if( set == null ) {
290
set = new HashSet< String >();
291
_contactAddresses.put( id, set );
292
}
293
set.add( address );
294
}
295
296
public boolean hasAssociatedOrganisation( Long id, String organisation )
297
{
298
organisation = normaliseOrganisation( organisation );
299
if( organisation == null ) return false;
300
301
HashSet< String > set = _contactOrganisations.get( id );
302
return set != null && set.contains( organisation );
303
}
304
305
public void addAssociatedOrganisation( Long id, String organisation )
306
{
307
organisation = normaliseOrganisation( organisation );
308
if( organisation == null ) return;
309
310
HashSet< String > set = _contactOrganisations.get( id );
311
if( set == null ) {
312
set = new HashSet< String >();
313
_contactOrganisations.put( id, set );
314
}
315
set.add( organisation );
316
}
317
318
public boolean hasAssociatedNote( Long id, String note )
319
{
320
note = normaliseNote( note );
321
if( note == null ) return false;
322
323
HashSet< String > set = _contactNotes.get( id );
324
return set != null && set.contains( note );
325
}
326
327
public void addAssociatedNote( Long id, String note )
328
{
329
note = normaliseNote( note );
330
if( note == null ) return;
331
332
HashSet< String > set = _contactNotes.get( id );
333
if( set == null ) {
334
set = new HashSet< String >();
335
_contactNotes.put( id, set );
336
}
337
set.add( note );
338
}
339
340
static public String normaliseName( String name )
341
{
342
if( name == null ) return null;
343
name = name.trim();
344
return name.length() > 0? name : null;
345
}
346
347
static public String normalisePhoneNumber( String number )
348
{
349
if( number == null ) return null;
350
number = number.trim().replaceAll( "[-\\(\\) ]", "" );
351
return number.length() > 0? number : null;
352
}
353
354
static public String normaliseEmailAddress( String email )
355
{
356
if( email == null ) return null;
357
email = email.trim().toLowerCase( Locale.US );
358
return email.length() > 0? email : null;
359
}
360
361
static public String normaliseOrganisation( String organisation )
362
{
363
if( organisation == null ) return null;
364
organisation = organisation.trim();
365
return organisation.length() > 0? organisation : null;
366
}
367
368
static public String normaliseAddress( String address )
369
{
370
if( address == null ) return null;
371
address = address.trim();
372
return address.length() > 0? address : null;
373
}
374
375
static public String normaliseNote( String note )
376
{
377
if( note == null ) return null;
378
note = note.trim();
379
return note.length() > 0? note : null;
380
}
381
}
Loggerhead is a web-based interface for Bazaar branches
Version: 1.18.2, Revision: 480