/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/org/waxworlds/edam/importcontacts/ContactsCache.java

  • Committer: edam
  • Date: 2011-04-22 15:36:06 UTC
  • Revision ID: edam@waxworlds.org-20110422153606-9x9l0nbmvx6oxfxu
- pulled contacts cache out in to seperate class

Show diffs side-by-side

added added

removed removed

1
1
/*
2
2
 * ContactsCache.java
3
3
 *
4
 
 * Copyright (C) 2011 Tim Marston <tim@ed.am>
 
4
 * Copyright (C) 2009 Tim Marston <edam@waxworlds.org>
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
8
 
 * http://ed.am/dev/android/import-contacts
 
8
 * http://www.waxworlds.org/edam/software/android/import-contacts
9
9
 *
10
10
 * This program is free software: you can redistribute it and/or modify
11
11
 * it under the terms of the GNU General Public License as published by
21
21
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
22
22
 */
23
23
 
24
 
package am.ed.importcontacts;
 
24
package org.waxworlds.edam.importcontacts;
25
25
 
26
26
import java.util.HashMap;
27
27
import java.util.HashSet;
28
28
 
 
29
import org.waxworlds.edam.importcontacts.Importer.AbortImportException;
 
30
 
29
31
import android.app.Activity;
 
32
import android.database.Cursor;
 
33
import android.provider.Contacts;
30
34
 
31
35
 
32
36
public class ContactsCache
33
37
{
34
 
        /**
35
 
         * Information that can be used to identify a contact within the cache
36
 
         */
37
 
        static public class CacheIdentifier
38
 
        {
39
 
                public enum Type {
40
 
                        NONE, NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
41
 
 
42
 
                private Type _type;
43
 
                private String _detail;
44
 
 
45
 
                protected CacheIdentifier()
46
 
                {
47
 
                        _type = Type.NONE;
48
 
                }
49
 
 
50
 
                protected CacheIdentifier( Type type, String detail )
51
 
                {
52
 
                        _type = type;
53
 
                        _detail = detail;
54
 
                }
55
 
 
56
 
                public Type getType()
57
 
                {
58
 
                        return _type;
59
 
                }
60
 
 
61
 
                public String getDetail()
62
 
                {
63
 
                        return _detail;
64
 
                }
65
 
        }
66
 
 
67
 
        // mappings of contact names, organisations and primary numbers to ids
68
 
        private HashMap< String, Long > _contactsByName
69
 
                = new HashMap< String, Long >();
70
 
        private HashMap< String, Long > _contactsByOrg
71
 
                = new HashMap< String, Long >();
72
 
        private HashMap< String, Long > _contactsByNumber
73
 
                = new HashMap< String, Long >();
74
 
        private HashMap< String, Long > _contactsByEmail
75
 
                = new HashMap< String, Long >();
76
 
 
77
 
        // mapping of contact ids to sets of associated data
78
 
        private HashMap< Long, HashSet< String > > _contactNumbers
79
 
                = new HashMap< Long, HashSet< String > >();
80
 
        private HashMap< Long, HashSet< String > > _contactEmails
81
 
                = new HashMap< Long, HashSet< String > >();
82
 
        private HashMap< Long, HashSet< String > > _contactAddresses
83
 
                = new HashMap< Long, HashSet< String > >();
84
 
        private HashMap< Long, HashSet< String > > _contactOrganisations
85
 
                = 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
 
 
137
 
        public boolean canLookup( CacheIdentifier identifier )
138
 
        {
139
 
                return lookup( identifier ) != null;
140
 
        }
141
 
 
142
 
        public Long lookup( CacheIdentifier identifier )
143
 
        {
144
 
                switch( identifier.getType() )
145
 
                {
146
 
                case NAME:
147
 
                        return _contactsByName.get( identifier.getDetail() );
148
 
                case ORGANISATION:
149
 
                        return _contactsByOrg.get( identifier.getDetail() );
150
 
                case PRIMARY_NUMBER:
151
 
                        return _contactsByNumber.get( identifier.getDetail() );
152
 
                case PRIMARY_EMAIL:
153
 
                        return _contactsByEmail.get( identifier.getDetail() );
154
 
                }
155
 
                return null;
156
 
        }
157
 
 
158
 
        public Long removeLookup( CacheIdentifier identifier )
159
 
        {
160
 
                switch( identifier.getType() )
161
 
                {
162
 
                case NAME:
163
 
                        return _contactsByName.remove( identifier.getDetail() );
164
 
                case ORGANISATION:
165
 
                        return _contactsByOrg.remove( identifier.getDetail() );
166
 
                case PRIMARY_NUMBER:
167
 
                        return _contactsByNumber.remove( identifier.getDetail() );
168
 
                case PRIMARY_EMAIL:
169
 
                        return _contactsByEmail.remove( identifier.getDetail() );
170
 
                }
171
 
                return null;
172
 
        }
173
 
 
174
 
        public void addLookup( CacheIdentifier identifier, Long id )
175
 
        {
176
 
                switch( identifier.getType() )
177
 
                {
178
 
                case NAME:
179
 
                        _contactsByName.put( identifier.getDetail(), id );
180
 
                        break;
181
 
                case ORGANISATION:
182
 
                        _contactsByOrg.put( identifier.getDetail(), id );
183
 
                        break;
184
 
                case PRIMARY_NUMBER:
185
 
                        _contactsByNumber.put( identifier.getDetail(), id );
186
 
                        break;
187
 
                case PRIMARY_EMAIL:
188
 
                        _contactsByEmail.put( identifier.getDetail(), id );
189
 
                        break;
190
 
                }
191
 
        }
192
 
 
193
 
        public void removeAssociatedData( Long id )
194
 
        {
195
 
                _contactNumbers.remove( id );
196
 
                _contactEmails.remove( id );
197
 
                _contactAddresses.remove( id );
198
 
                _contactOrganisations.remove( id );
199
 
        }
200
 
 
201
 
        public boolean hasAssociatedNumber( Long id, String number )
202
 
        {
203
 
                number = normalisePhoneNumber( number );
204
 
                if( number == null ) return false;
205
 
 
206
 
                HashSet< String > set = _contactNumbers.get( id );
207
 
                return set != null && set.contains( number );
208
 
        }
209
 
 
210
 
        public void addAssociatedNumber( Long id, String number )
211
 
        {
212
 
                number = normalisePhoneNumber( number );
213
 
                if( number == null ) return;
214
 
 
215
 
                HashSet< String > set = _contactNumbers.get( id );
216
 
                if( set == null ) {
217
 
                        set = new HashSet< String >();
218
 
                        _contactNumbers.put( id, set );
219
 
                }
220
 
                set.add( normalisePhoneNumber( number ) );
221
 
        }
222
 
 
223
 
        public boolean hasAssociatedEmail( Long id, String email )
224
 
        {
225
 
                email = normaliseEmailAddress( email );
226
 
                if( email == null ) return false;
227
 
 
228
 
                HashSet< String > set = _contactEmails.get( id );
229
 
                return set != null && set.contains( normaliseEmailAddress( email ) );
230
 
        }
231
 
 
232
 
        public void addAssociatedEmail( Long id, String email )
233
 
        {
234
 
                email = normaliseEmailAddress( email );
235
 
                if( email == null ) return;
236
 
 
237
 
                HashSet< String > set = _contactEmails.get( id );
238
 
                if( set == null ) {
239
 
                        set = new HashSet< String >();
240
 
                        _contactEmails.put( id, set );
241
 
                }
242
 
                set.add( normaliseEmailAddress( email ) );
243
 
        }
244
 
 
245
 
        public boolean hasAssociatedAddress( Long id, String address )
246
 
        {
247
 
                address = normaliseAddress( address );
248
 
                if( address == null ) return false;
249
 
 
250
 
                HashSet< String > set = _contactAddresses.get( id );
251
 
                return set != null && set.contains( normaliseAddress( address ) );
252
 
        }
253
 
 
254
 
        public void addAssociatedAddress( Long id, String address )
255
 
        {
256
 
                address = normaliseAddress( address );
257
 
                if( address == null ) return;
258
 
 
259
 
                HashSet< String > set = _contactAddresses.get( id );
260
 
                if( set == null ) {
261
 
                        set = new HashSet< String >();
262
 
                        _contactAddresses.put( id, set );
263
 
                }
264
 
                set.add( normaliseAddress( address ) );
265
 
        }
266
 
 
267
 
        public boolean hasAssociatedOrganisation( Long id, String organisation )
268
 
        {
269
 
                organisation = normaliseOrganisation( organisation );
270
 
                if( organisation == null ) return false;
271
 
 
272
 
                HashSet< String > set = _contactOrganisations.get( id );
273
 
                return set != null && set.contains(
274
 
                        normaliseOrganisation( organisation ) );
275
 
        }
276
 
 
277
 
        public void addAssociatedOrganisation( Long id, String organisation )
278
 
        {
279
 
                organisation = normaliseOrganisation( organisation );
280
 
                if( organisation == null ) return;
281
 
 
282
 
                HashSet< String > set = _contactOrganisations.get( id );
283
 
                if( set == null ) {
284
 
                        set = new HashSet< String >();
285
 
                        _contactOrganisations.put( id, set );
286
 
                }
287
 
                set.add( normaliseOrganisation( organisation ) );
288
 
        }
289
 
 
290
 
        static public String normaliseName( String name )
291
 
        {
292
 
                if( name == null ) return null;
293
 
                name = name.trim();
294
 
                return name.length() > 0? name : null;
295
 
        }
296
 
 
297
 
        static public String normalisePhoneNumber( String number )
298
 
        {
299
 
                if( number == null ) return null;
300
 
                number = number.trim().replaceAll( "[-\\(\\) ]", "" );
301
 
                return number.length() > 0? number : null;
302
 
        }
303
 
 
304
 
        static public String normaliseEmailAddress( String email )
305
 
        {
306
 
                if( email == null ) return null;
307
 
                email = email.trim().toLowerCase();
308
 
                return email.length() > 0? email : null;
309
 
        }
310
 
 
311
 
        static public String normaliseOrganisation( String organisation )
312
 
        {
313
 
                if( organisation == null ) return null;
314
 
                organisation = organisation.trim();
315
 
                return organisation.length() > 0? organisation : null;
316
 
        }
317
 
 
318
 
        static public String normaliseAddress( String address )
319
 
        {
320
 
                if( address == null ) return null;
321
 
                address = address.trim();
322
 
                return address.length() > 0? address : null;
 
38
        private HashMap< String, Long > _contacts;
 
39
 
 
40
        private HashMap< Long, HashSet< String > > _contactNumbers;
 
41
        private HashMap< Long, HashSet< String > > _contactEmails;
 
42
        private HashMap< Long, HashSet< String > > _contactAddresses;
 
43
 
 
44
        public boolean exists( String name )
 
45
        {
 
46
                return _contacts.containsKey( name );
 
47
        }
 
48
 
 
49
        public Long getId( String name )
 
50
        {
 
51
                return _contacts.get( name );
 
52
        }
 
53
 
 
54
        public void remove( String name )
 
55
        {
 
56
                _contacts.remove( name );
 
57
        }
 
58
 
 
59
        public void put( Long id, String name )
 
60
        {
 
61
                _contacts.put( name, id );
 
62
        }
 
63
 
 
64
        public boolean hasNumber( Long id, String number )
 
65
        {
 
66
                HashSet< String > cache = _contactNumbers.get( id );
 
67
                return cache != null && cache.contains( number );
 
68
        }
 
69
 
 
70
        public void addNumber( Long id, String number )
 
71
        {
 
72
                HashSet< String > cache = _contactNumbers.get( id );
 
73
                if( cache == null ) {
 
74
                        cache = new HashSet< String >();
 
75
                        _contactNumbers.put( id, cache );
 
76
                }
 
77
                cache.add( number );
 
78
        }
 
79
 
 
80
        public boolean hasEmail( Long id, String email )
 
81
        {
 
82
                HashSet< String > cache = _contactEmails.get( id );
 
83
                return cache != null && cache.contains( email );
 
84
        }
 
85
 
 
86
        public void addEmail( Long id, String email )
 
87
        {
 
88
                HashSet< String > cache = _contactEmails.get( id );
 
89
                if( cache == null ) {
 
90
                        cache = new HashSet< String >();
 
91
                        _contactEmails.put( id, cache );
 
92
                }
 
93
                cache.add( email );
 
94
        }
 
95
 
 
96
        public boolean hasAddress( Long id, String address )
 
97
        {
 
98
                HashSet< String > cache = _contactAddresses.get( id );
 
99
                return cache != null && cache.contains( address );
 
100
        }
 
101
 
 
102
        public void addAddress( Long id, String address )
 
103
        {
 
104
                HashSet< String > cache = _contactAddresses.get( id );
 
105
                if( cache == null ) {
 
106
                        cache = new HashSet< String >();
 
107
                        _contactAddresses.put( id, cache );
 
108
                }
 
109
                cache.add( address );
 
110
        }
 
111
 
 
112
        public void buildCache( Activity activity )
 
113
                throws AbortImportException
 
114
        {
 
115
                String[] cols;
 
116
                Cursor cur;
 
117
 
 
118
                // init contacts caches
 
119
                _contacts = new HashMap< String, Long >();
 
120
                _contactNumbers = new HashMap< Long, HashSet< String > >();
 
121
                _contactEmails = new HashMap< Long, HashSet< String > >();
 
122
                _contactAddresses = new HashMap< Long, HashSet< String > >();
 
123
 
 
124
                // query and store map of contact names to ids
 
125
                cols = new String[] { Contacts.People._ID, Contacts.People.NAME };
 
126
                cur = activity.managedQuery( Contacts.People.CONTENT_URI,
 
127
                        cols, null, null, null);
 
128
                if( cur.moveToFirst() ) {
 
129
                        int idCol = cur.getColumnIndex( Contacts.People._ID );
 
130
                        int nameCol = cur.getColumnIndex( Contacts.People.NAME );
 
131
                        do {
 
132
                                _contacts.put( cur.getString( nameCol ), cur.getLong( idCol ) );
 
133
                        } while( cur.moveToNext() );
 
134
                }
 
135
 
 
136
                // query and store map of contact ids to sets of phone numbers
 
137
                cols = new String[] { Contacts.Phones.PERSON_ID,
 
138
                                Contacts.Phones.NUMBER };
 
139
                cur = activity.managedQuery( Contacts.Phones.CONTENT_URI,
 
140
                        cols, null, null, null);
 
141
                if( cur.moveToFirst() ) {
 
142
                        int personIdCol = cur.getColumnIndex( Contacts.Phones.PERSON_ID );
 
143
                        int numberCol = cur.getColumnIndex( Contacts.Phones.NUMBER );
 
144
                        do {
 
145
                                Long id = cur.getLong( personIdCol );
 
146
                                String number = Importer.sanitisePhoneNumber(
 
147
                                                cur.getString( numberCol ) );
 
148
                                if( number != null ) {
 
149
                                        HashSet< String > numbers = _contactNumbers.get( id );
 
150
                                        if( numbers == null ) {
 
151
                                                numbers = new HashSet< String >();
 
152
                                                _contactNumbers.put( id, numbers );
 
153
                                        }
 
154
                                        numbers.add( number );
 
155
                                }
 
156
                        } while( cur.moveToNext() );
 
157
                }
 
158
 
 
159
                // query and store map of contact ids to sets of email addresses
 
160
                cols = new String[] { Contacts.ContactMethods.PERSON_ID,
 
161
                                Contacts.ContactMethods.DATA };
 
162
                cur = activity.managedQuery( Contacts.ContactMethods.CONTENT_URI,
 
163
                                cols, Contacts.ContactMethods.KIND + " = ?",
 
164
                                new String[] { "" + Contacts.KIND_EMAIL }, null );
 
165
                if( cur.moveToFirst() ) {
 
166
                        int personIdCol = cur.getColumnIndex(
 
167
                                Contacts.ContactMethods.PERSON_ID );
 
168
                        int addressCol = cur.getColumnIndex(
 
169
                                Contacts.ContactMethods.DATA );
 
170
                        do {
 
171
                                Long id = cur.getLong( personIdCol );
 
172
                                String address = Importer.sanitiseEmailAddress(
 
173
                                        cur.getString( addressCol ) );
 
174
                                if( address != null ) {
 
175
                                        HashSet< String > addresses = _contactEmails.get( id );
 
176
                                        if( addresses == null ) {
 
177
                                                addresses = new HashSet< String >();
 
178
                                                _contactEmails.put( id, addresses );
 
179
                                        }
 
180
                                        addresses.add( address );
 
181
                                }
 
182
                        } while( cur.moveToNext() );
 
183
                }
 
184
 
 
185
                // query and store map of contact ids to sets of postal addresses
 
186
                cols = new String[] { Contacts.ContactMethods.PERSON_ID,
 
187
                        Contacts.ContactMethods.DATA };
 
188
                cur = activity.managedQuery( Contacts.ContactMethods.CONTENT_URI,
 
189
                        cols, Contacts.ContactMethods.KIND + " = ?",
 
190
                        new String[] { "" + Contacts.KIND_POSTAL }, null );
 
191
                if( cur.moveToFirst() ) {
 
192
                        int personIdCol = cur.getColumnIndex(
 
193
                                Contacts.ContactMethods.PERSON_ID );
 
194
                        int addressCol = cur.getColumnIndex(
 
195
                                Contacts.ContactMethods.DATA );
 
196
                        do {
 
197
                                Long id = cur.getLong( personIdCol );
 
198
                                String address = cur.getString( addressCol );
 
199
                                if( address != null ) {
 
200
                                        HashSet< String > addresses = _contactAddresses.get( id );
 
201
                                        if( addresses == null ) {
 
202
                                                addresses = new HashSet< String >();
 
203
                                                _contactAddresses.put( id, addresses );
 
204
                                        }
 
205
                                        addresses.add( address );
 
206
                                }
 
207
                        } while( cur.moveToNext() );
 
208
                }
323
209
        }
324
210
}