/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-21 10:44:01 UTC
  • Revision ID: tim@ed.am-20121221104401-onydwv9k4e4heode
added thank you message to intro

Show diffs side-by-side

added added

removed removed

src/am/ed/importcontacts/ContactsCache.java
1
1
/*
2
2
 * ContactsCache.java
3
3
 *
4
 
 * Copyright (C) 2011 Tim Marston <tim@ed.am>
 
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
7
 * to as "this program"). For more information, see
25
25
 
26
26
import java.util.HashMap;
27
27
import java.util.HashSet;
28
 
 
29
 
import android.app.Activity;
30
 
 
 
28
import java.util.Locale;
31
29
 
32
30
public class ContactsCache
33
31
{
34
32
        /**
35
 
         * Information that can be used to identify a contact within the cache
 
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
36
         */
37
 
        static public class CacheIdentifier
 
37
        public static class CacheIdentifier
38
38
        {
39
 
                public enum Type {
40
 
                        NONE, NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
 
39
                public enum Type { NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
41
40
 
42
41
                private Type _type;
43
42
                private String _detail;
44
43
 
45
 
                protected CacheIdentifier()
46
 
                {
47
 
                        _type = Type.NONE;
 
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
                 * @param type the detail type
 
49
                 * @param detail the detail
 
50
                 * @return the cache identifier, or null
 
51
                 */
 
52
                public static CacheIdentifier factory( Type type, String detail )
 
53
                {
 
54
                        switch( type )
 
55
                        {
 
56
                        case NAME: detail = normaliseName( detail ); break;
 
57
                        case ORGANISATION: detail = normaliseOrganisation( detail ); break;
 
58
                        case PRIMARY_NUMBER: detail = normalisePhoneNumber( detail ); break;
 
59
                        case PRIMARY_EMAIL: detail = normaliseEmailAddress( detail ); break;
 
60
                        default: return null;
 
61
                        }
 
62
                        if( detail == null ) return null;
 
63
                        return new CacheIdentifier( type, detail );
 
64
                }
 
65
 
 
66
                /**
 
67
                 * Obtain a cache identifier from contact data.  This routine is
 
68
                 * designed to be as robust as possible and may return null when a cache
 
69
                 * identifier can not be created.
 
70
                 * @param contact the contact data
 
71
                 * @return the cache identifier, or null
 
72
                 */
 
73
                public static CacheIdentifier factory( Importer.ContactData contact )
 
74
                {
 
75
                        CacheIdentifier identifier = null;
 
76
 
 
77
                        if( contact.hasName() )
 
78
                                identifier = factory( CacheIdentifier.Type.NAME,
 
79
                                        contact.getName() );
 
80
                        if( identifier != null ) return identifier;
 
81
 
 
82
                        if( contact.hasPrimaryOrganisation() )
 
83
                                identifier = factory( CacheIdentifier.Type.ORGANISATION,
 
84
                                        contact.getPrimaryOrganisation() );
 
85
                        if( identifier != null ) return identifier;
 
86
 
 
87
                        if( contact.hasPrimaryNumber() )
 
88
                                identifier = factory( CacheIdentifier.Type.PRIMARY_NUMBER,
 
89
                                        contact.getPrimaryNumber() );
 
90
                        if( identifier != null ) return identifier;
 
91
 
 
92
                        if( contact.hasPrimaryEmail() )
 
93
                                identifier = factory( CacheIdentifier.Type.PRIMARY_EMAIL,
 
94
                                        contact.getPrimaryEmail() );
 
95
                        if( identifier != null ) return identifier;
 
96
 
 
97
                        return null;
48
98
                }
49
99
 
50
100
                protected CacheIdentifier( Type type, String detail )
83
133
                = new HashMap< Long, HashSet< String > >();
84
134
        private HashMap< Long, HashSet< String > > _contactOrganisations
85
135
                = new HashMap< Long, HashSet< String > >();
86
 
 
87
 
        ContactsCache()
88
 
        {
89
 
                // init id lookups
90
 
//              _contactsByName = new HashMap< String, Long >();
91
 
//              _contactsByOrg = new HashMap< String, Long >();
92
 
//              _contactsByNumber = new HashMap< String, Long >();
93
 
//              _contactsByEmail = new HashMap< String, Long >();
94
 
 
95
 
                // init associated data cache
96
 
//              _contactNumbers = new HashMap< Long, HashSet< String > >();
97
 
//              _contactEmails = new HashMap< Long, HashSet< String > >();
98
 
//              _contactAddresses = new HashMap< Long, HashSet< String > >();
99
 
//              _contactOrganisations = new HashMap< Long, HashSet< String > >();
100
 
        }
101
 
 
102
 
        public static CacheIdentifier createIdentifier(
103
 
                Importer.ContactData contact )
104
 
        {
105
 
                if( contact.hasName() ) {
106
 
                        String name = normaliseName( contact.getName() );
107
 
                        if( name != null )
108
 
                                return new CacheIdentifier(
109
 
                                        CacheIdentifier.Type.NAME, name );
110
 
                }
111
 
 
112
 
                if( contact.hasPrimaryOrganisation() ) {
113
 
                        String organisation = normaliseOrganisation(
114
 
                                contact.getPrimaryOrganisation() );
115
 
                        if( organisation != null )
116
 
                                return new CacheIdentifier(
117
 
                                        CacheIdentifier.Type.ORGANISATION, organisation );
118
 
                }
119
 
 
120
 
                if( contact.hasPrimaryNumber() ) {
121
 
                        String number = normalisePhoneNumber( contact.getPrimaryNumber() );
122
 
                        if( number != null )
123
 
                        return new CacheIdentifier(
124
 
                                CacheIdentifier.Type.PRIMARY_NUMBER, number );
125
 
                }
126
 
 
127
 
                if( contact.hasPrimaryEmail() ) {
128
 
                        String email = normaliseEmailAddress( contact.getPrimaryEmail() );
129
 
                        if( email != null )
130
 
                        return new CacheIdentifier(
131
 
                                CacheIdentifier.Type.PRIMARY_EMAIL, email );
132
 
                }
133
 
 
134
 
                return null;
135
 
        }
 
136
        private HashMap< Long, HashSet< String > > _contactNotes
 
137
                = new HashMap< Long, HashSet< String > >();
136
138
 
137
139
        public boolean canLookup( CacheIdentifier identifier )
138
140
        {
139
141
                return lookup( identifier ) != null;
140
142
        }
141
143
 
 
144
        /**
 
145
         * Retrieve the contact id of a contact identified by the specified cache
 
146
         * identifier, if it exists.
 
147
         * @param identifier the cache identifier
 
148
         * @return a contact id, or null
 
149
         */
142
150
        public Long lookup( CacheIdentifier identifier )
143
151
        {
144
152
                switch( identifier.getType() )
155
163
                return null;
156
164
        }
157
165
 
 
166
        /**
 
167
         * Remove any cache entry that is identified by the cache identifier.
 
168
         * @param identifier the cache identifier
 
169
         * @return the contact id of the contact that was removed, or null
 
170
         */
158
171
        public Long removeLookup( CacheIdentifier identifier )
159
172
        {
160
173
                switch( identifier.getType() )
171
184
                return null;
172
185
        }
173
186
 
 
187
        /**
 
188
         * Add a lookup from a contact identifier to a contact id to the cache.
 
189
         * @param identifier the cache identifier
 
190
         * @param id teh contact id
 
191
         */
174
192
        public void addLookup( CacheIdentifier identifier, Long id )
175
193
        {
176
194
                switch( identifier.getType() )
190
208
                }
191
209
        }
192
210
 
 
211
        /**
 
212
         * Remove any data that is associated with an contact id.
 
213
         * @param id
 
214
         */
193
215
        public void removeAssociatedData( Long id )
194
216
        {
195
217
                _contactNumbers.remove( id );
196
218
                _contactEmails.remove( id );
197
219
                _contactAddresses.remove( id );
198
220
                _contactOrganisations.remove( id );
 
221
                _contactNotes.remove( id );
199
222
        }
200
223
 
201
224
        public boolean hasAssociatedNumber( Long id, String number )
217
240
                        set = new HashSet< String >();
218
241
                        _contactNumbers.put( id, set );
219
242
                }
220
 
                set.add( normalisePhoneNumber( number ) );
 
243
                set.add( number );
221
244
        }
222
245
 
223
246
        public boolean hasAssociatedEmail( Long id, String email )
226
249
                if( email == null ) return false;
227
250
 
228
251
                HashSet< String > set = _contactEmails.get( id );
229
 
                return set != null && set.contains( normaliseEmailAddress( email ) );
 
252
                return set != null && set.contains( email );
230
253
        }
231
254
 
232
255
        public void addAssociatedEmail( Long id, String email )
239
262
                        set = new HashSet< String >();
240
263
                        _contactEmails.put( id, set );
241
264
                }
242
 
                set.add( normaliseEmailAddress( email ) );
 
265
                set.add( email );
243
266
        }
244
267
 
245
268
        public boolean hasAssociatedAddress( Long id, String address )
248
271
                if( address == null ) return false;
249
272
 
250
273
                HashSet< String > set = _contactAddresses.get( id );
251
 
                return set != null && set.contains( normaliseAddress( address ) );
 
274
                return set != null && set.contains( address );
252
275
        }
253
276
 
254
277
        public void addAssociatedAddress( Long id, String address )
261
284
                        set = new HashSet< String >();
262
285
                        _contactAddresses.put( id, set );
263
286
                }
264
 
                set.add( normaliseAddress( address ) );
 
287
                set.add( address );
265
288
        }
266
289
 
267
290
        public boolean hasAssociatedOrganisation( Long id, String organisation )
270
293
                if( organisation == null ) return false;
271
294
 
272
295
                HashSet< String > set = _contactOrganisations.get( id );
273
 
                return set != null && set.contains(
274
 
                        normaliseOrganisation( organisation ) );
 
296
                return set != null && set.contains( organisation );
275
297
        }
276
298
 
277
299
        public void addAssociatedOrganisation( Long id, String organisation )
284
306
                        set = new HashSet< String >();
285
307
                        _contactOrganisations.put( id, set );
286
308
                }
287
 
                set.add( normaliseOrganisation( organisation ) );
 
309
                set.add( organisation );
 
310
        }
 
311
 
 
312
        public boolean hasAssociatedNote( Long id, String note )
 
313
        {
 
314
                note = normaliseNote( note );
 
315
                if( note == null ) return false;
 
316
 
 
317
                HashSet< String > set = _contactNotes.get( id );
 
318
                return set != null && set.contains( note );
 
319
        }
 
320
 
 
321
        public void addAssociatedNote( Long id, String note )
 
322
        {
 
323
                note = normaliseNote( note );
 
324
                if( note == null ) return;
 
325
 
 
326
                HashSet< String > set = _contactNotes.get( id );
 
327
                if( set == null ) {
 
328
                        set = new HashSet< String >();
 
329
                        _contactNotes.put( id, set );
 
330
                }
 
331
                set.add( note );
288
332
        }
289
333
 
290
334
        static public String normaliseName( String name )
304
348
        static public String normaliseEmailAddress( String email )
305
349
        {
306
350
                if( email == null ) return null;
307
 
                email = email.trim().toLowerCase();
 
351
                email = email.trim().toLowerCase( Locale.US );
308
352
                return email.length() > 0? email : null;
309
353
        }
310
354
 
321
365
                address = address.trim();
322
366
                return address.length() > 0? address : null;
323
367
        }
 
368
 
 
369
        static public String normaliseNote( String note )
 
370
        {
 
371
                if( note == null ) return null;
 
372
                note = note.trim();
 
373
                return note.length() > 0? note : null;
 
374
        }
324
375
}