/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-18 11:58:46 UTC
  • Revision ID: tim@ed.am-20121218115846-xdwnw3zzcedbb3rp
bump version to 1.3 (we're skipping v1.2, for f-droid)

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 to 2012 Tim Marston <tim@ed.am>
 
4
 * Copyright (C) 2011 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
 
import java.util.Locale;
 
28
 
 
29
import android.app.Activity;
 
30
 
29
31
 
30
32
public class ContactsCache
31
33
{
32
34
        /**
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.
 
35
         * Information that can be used to identify a contact within the cache
36
36
         */
37
 
        public static class CacheIdentifier
 
37
        static public class CacheIdentifier
38
38
        {
39
 
                public enum Type { NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
 
39
                public enum Type {
 
40
                        NONE, NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
40
41
 
41
42
                private Type _type;
42
43
                private String _detail;
43
44
 
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;
 
45
                protected CacheIdentifier()
 
46
                {
 
47
                        _type = Type.NONE;
98
48
                }
99
49
 
100
50
                protected CacheIdentifier( Type type, String detail )
133
83
                = new HashMap< Long, HashSet< String > >();
134
84
        private HashMap< Long, HashSet< String > > _contactOrganisations
135
85
                = new HashMap< Long, HashSet< String > >();
136
 
        private HashMap< Long, HashSet< String > > _contactNotes
137
 
                = 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
        }
138
136
 
139
137
        public boolean canLookup( CacheIdentifier identifier )
140
138
        {
141
139
                return lookup( identifier ) != null;
142
140
        }
143
141
 
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
 
         */
150
142
        public Long lookup( CacheIdentifier identifier )
151
143
        {
152
144
                switch( identifier.getType() )
163
155
                return null;
164
156
        }
165
157
 
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
 
         */
171
158
        public Long removeLookup( CacheIdentifier identifier )
172
159
        {
173
160
                switch( identifier.getType() )
184
171
                return null;
185
172
        }
186
173
 
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
 
         */
192
174
        public void addLookup( CacheIdentifier identifier, Long id )
193
175
        {
194
176
                switch( identifier.getType() )
208
190
                }
209
191
        }
210
192
 
211
 
        /**
212
 
         * Remove any data that is associated with an contact id.
213
 
         * @param id
214
 
         */
215
193
        public void removeAssociatedData( Long id )
216
194
        {
217
195
                _contactNumbers.remove( id );
218
196
                _contactEmails.remove( id );
219
197
                _contactAddresses.remove( id );
220
198
                _contactOrganisations.remove( id );
221
 
                _contactNotes.remove( id );
222
199
        }
223
200
 
224
201
        public boolean hasAssociatedNumber( Long id, String number )
240
217
                        set = new HashSet< String >();
241
218
                        _contactNumbers.put( id, set );
242
219
                }
243
 
                set.add( number );
 
220
                set.add( normalisePhoneNumber( number ) );
244
221
        }
245
222
 
246
223
        public boolean hasAssociatedEmail( Long id, String email )
249
226
                if( email == null ) return false;
250
227
 
251
228
                HashSet< String > set = _contactEmails.get( id );
252
 
                return set != null && set.contains( email );
 
229
                return set != null && set.contains( normaliseEmailAddress( email ) );
253
230
        }
254
231
 
255
232
        public void addAssociatedEmail( Long id, String email )
262
239
                        set = new HashSet< String >();
263
240
                        _contactEmails.put( id, set );
264
241
                }
265
 
                set.add( email );
 
242
                set.add( normaliseEmailAddress( email ) );
266
243
        }
267
244
 
268
245
        public boolean hasAssociatedAddress( Long id, String address )
271
248
                if( address == null ) return false;
272
249
 
273
250
                HashSet< String > set = _contactAddresses.get( id );
274
 
                return set != null && set.contains( address );
 
251
                return set != null && set.contains( normaliseAddress( address ) );
275
252
        }
276
253
 
277
254
        public void addAssociatedAddress( Long id, String address )
284
261
                        set = new HashSet< String >();
285
262
                        _contactAddresses.put( id, set );
286
263
                }
287
 
                set.add( address );
 
264
                set.add( normaliseAddress( address ) );
288
265
        }
289
266
 
290
267
        public boolean hasAssociatedOrganisation( Long id, String organisation )
293
270
                if( organisation == null ) return false;
294
271
 
295
272
                HashSet< String > set = _contactOrganisations.get( id );
296
 
                return set != null && set.contains( organisation );
 
273
                return set != null && set.contains(
 
274
                        normaliseOrganisation( organisation ) );
297
275
        }
298
276
 
299
277
        public void addAssociatedOrganisation( Long id, String organisation )
306
284
                        set = new HashSet< String >();
307
285
                        _contactOrganisations.put( id, set );
308
286
                }
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 );
 
287
                set.add( normaliseOrganisation( organisation ) );
332
288
        }
333
289
 
334
290
        static public String normaliseName( String name )
348
304
        static public String normaliseEmailAddress( String email )
349
305
        {
350
306
                if( email == null ) return null;
351
 
                email = email.trim().toLowerCase( Locale.US );
 
307
                email = email.trim().toLowerCase();
352
308
                return email.length() > 0? email : null;
353
309
        }
354
310
 
365
321
                address = address.trim();
366
322
                return address.length() > 0? address : null;
367
323
        }
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
 
        }
375
324
}