/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/am/ed/importcontacts/ContactsCache.java

  • Committer: edam
  • Date: 2012-12-19 17:51:35 UTC
  • Revision ID: tim@ed.am-20121219175135-1cpuafp76jg1ib1p
added preliminary (buggy) ContactsContract backend

Show diffs side-by-side

added added

removed removed

src/am/ed/importcontacts/ContactsCache.java
4
4
 * Copyright (C) 2011 to 2012 Tim Marston <tim@ed.am>
5
5
 *
6
6
 * This file is part of the Import Contacts program (hereafter referred
7
 
 * to as "this program").  For more information, see
 
7
 * to as "this program"). For more information, see
8
8
 * http://ed.am/dev/android/import-contacts
9
9
 *
10
10
 * This program is free software: you can redistribute it and/or modify
25
25
 
26
26
import java.util.HashMap;
27
27
import java.util.HashSet;
28
 
import java.util.Locale;
29
28
 
30
29
public class ContactsCache
31
30
{
32
31
        /**
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.
 
32
         * Information that can be used to identify a contact within the cache
36
33
         */
37
 
        public static class CacheIdentifier
 
34
        static public class CacheIdentifier
38
35
        {
39
 
                public enum Type { NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
 
36
                public enum Type {
 
37
                        NONE, NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
40
38
 
41
39
                private Type _type;
42
40
                private String _detail;
43
41
 
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;
 
42
                protected CacheIdentifier()
 
43
                {
 
44
                        _type = Type.NONE;
100
45
                }
101
46
 
102
47
                protected CacheIdentifier( Type type, String detail )
135
80
                = new HashMap< Long, HashSet< String > >();
136
81
        private HashMap< Long, HashSet< String > > _contactOrganisations
137
82
                = new HashMap< Long, HashSet< String > >();
138
 
        private HashMap< Long, HashSet< String > > _contactNotes
139
 
                = new HashMap< Long, HashSet< String > >();
 
83
 
 
84
        public static CacheIdentifier createIdentifier(
 
85
                Importer.ContactData contact )
 
86
        {
 
87
                if( contact.hasName() ) {
 
88
                        String name = normaliseName( contact.getName() );
 
89
                        if( name != null )
 
90
                                return new CacheIdentifier(
 
91
                                        CacheIdentifier.Type.NAME, name );
 
92
                }
 
93
 
 
94
                if( contact.hasPrimaryOrganisation() ) {
 
95
                        String organisation = normaliseOrganisation(
 
96
                                contact.getPrimaryOrganisation() );
 
97
                        if( organisation != null )
 
98
                                return new CacheIdentifier(
 
99
                                        CacheIdentifier.Type.ORGANISATION, organisation );
 
100
                }
 
101
 
 
102
                if( contact.hasPrimaryNumber() ) {
 
103
                        String number = normalisePhoneNumber( contact.getPrimaryNumber() );
 
104
                        if( number != null )
 
105
                        return new CacheIdentifier(
 
106
                                CacheIdentifier.Type.PRIMARY_NUMBER, number );
 
107
                }
 
108
 
 
109
                if( contact.hasPrimaryEmail() ) {
 
110
                        String email = normaliseEmailAddress( contact.getPrimaryEmail() );
 
111
                        if( email != null )
 
112
                        return new CacheIdentifier(
 
113
                                CacheIdentifier.Type.PRIMARY_EMAIL, email );
 
114
                }
 
115
 
 
116
                return null;
 
117
        }
140
118
 
141
119
        public boolean canLookup( CacheIdentifier identifier )
142
120
        {
143
121
                return lookup( identifier ) != null;
144
122
        }
145
123
 
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
124
        public Long lookup( CacheIdentifier identifier )
154
125
        {
155
126
                switch( identifier.getType() )
166
137
                return null;
167
138
        }
168
139
 
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
140
        public Long removeLookup( CacheIdentifier identifier )
176
141
        {
177
142
                switch( identifier.getType() )
188
153
                return null;
189
154
        }
190
155
 
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
156
        public void addLookup( CacheIdentifier identifier, Long id )
198
157
        {
199
158
                switch( identifier.getType() )
213
172
                }
214
173
        }
215
174
 
216
 
        /**
217
 
         * Remove any data that is associated with an contact id.
218
 
         *
219
 
         * @param id
220
 
         */
221
175
        public void removeAssociatedData( Long id )
222
176
        {
223
177
                _contactNumbers.remove( id );
224
178
                _contactEmails.remove( id );
225
179
                _contactAddresses.remove( id );
226
180
                _contactOrganisations.remove( id );
227
 
                _contactNotes.remove( id );
228
181
        }
229
182
 
230
183
        public boolean hasAssociatedNumber( Long id, String number )
246
199
                        set = new HashSet< String >();
247
200
                        _contactNumbers.put( id, set );
248
201
                }
249
 
                set.add( number );
 
202
                set.add( normalisePhoneNumber( number ) );
250
203
        }
251
204
 
252
205
        public boolean hasAssociatedEmail( Long id, String email )
255
208
                if( email == null ) return false;
256
209
 
257
210
                HashSet< String > set = _contactEmails.get( id );
258
 
                return set != null && set.contains( email );
 
211
                return set != null && set.contains( normaliseEmailAddress( email ) );
259
212
        }
260
213
 
261
214
        public void addAssociatedEmail( Long id, String email )
268
221
                        set = new HashSet< String >();
269
222
                        _contactEmails.put( id, set );
270
223
                }
271
 
                set.add( email );
 
224
                set.add( normaliseEmailAddress( email ) );
272
225
        }
273
226
 
274
227
        public boolean hasAssociatedAddress( Long id, String address )
277
230
                if( address == null ) return false;
278
231
 
279
232
                HashSet< String > set = _contactAddresses.get( id );
280
 
                return set != null && set.contains( address );
 
233
                return set != null && set.contains( normaliseAddress( address ) );
281
234
        }
282
235
 
283
236
        public void addAssociatedAddress( Long id, String address )
290
243
                        set = new HashSet< String >();
291
244
                        _contactAddresses.put( id, set );
292
245
                }
293
 
                set.add( address );
 
246
                set.add( normaliseAddress( address ) );
294
247
        }
295
248
 
296
249
        public boolean hasAssociatedOrganisation( Long id, String organisation )
299
252
                if( organisation == null ) return false;
300
253
 
301
254
                HashSet< String > set = _contactOrganisations.get( id );
302
 
                return set != null && set.contains( organisation );
 
255
                return set != null && set.contains(
 
256
                        normaliseOrganisation( organisation ) );
303
257
        }
304
258
 
305
259
        public void addAssociatedOrganisation( Long id, String organisation )
312
266
                        set = new HashSet< String >();
313
267
                        _contactOrganisations.put( id, set );
314
268
                }
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 );
 
269
                set.add( normaliseOrganisation( organisation ) );
338
270
        }
339
271
 
340
272
        static public String normaliseName( String name )
354
286
        static public String normaliseEmailAddress( String email )
355
287
        {
356
288
                if( email == null ) return null;
357
 
                email = email.trim().toLowerCase( Locale.US );
 
289
                email = email.trim().toLowerCase();
358
290
                return email.length() > 0? email : null;
359
291
        }
360
292
 
371
303
                address = address.trim();
372
304
                return address.length() > 0? address : null;
373
305
        }
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
306
}