/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/ContactsBackend.java

  • Committer: edam
  • Date: 2012-12-18 13:00:43 UTC
  • Revision ID: tim@ed.am-20121218130043-4zhj1cdeaqko3c4b
cleanup; fixed some typos; updated TODO

Show diffs side-by-side

added added

removed removed

23
23
 
24
24
package am.ed.importcontacts;
25
25
 
26
 
import java.util.HashMap;
27
26
import java.util.HashSet;
28
 
import java.util.Iterator;
29
27
 
30
28
import am.ed.importcontacts.ContactsCache.CacheIdentifier;
31
29
import am.ed.importcontacts.Importer.ContactData;
36
34
import android.net.Uri;
37
35
import android.provider.Contacts;
38
36
 
39
 
@SuppressWarnings( "deprecation" )
40
37
public class ContactsBackend implements Backend
41
38
{
42
39
        private Activity _activity = null;
54
51
                // set of contact ids that we have not yet added
55
52
                HashSet< Long > unadded_ids = new HashSet< Long >();
56
53
 
57
 
                // notes
58
 
                HashMap< Long, String > notes = new HashMap< Long, String >();
59
 
 
60
54
                // get all contacts
61
55
                cur = _activity.managedQuery( Contacts.People.CONTENT_URI,
62
56
                        new String[] {
63
57
                                Contacts.People._ID,
64
58
                                Contacts.People.NAME,
65
 
                                Contacts.People.NOTES,
66
59
                        }, null, null, null );
67
60
                while( cur.moveToNext() ) {
68
61
                        Long id = cur.getLong(
69
62
                                cur.getColumnIndex( Contacts.People._ID ) );
70
 
                        String name = cur.getString(
71
 
                                        cur.getColumnIndex( Contacts.People.NAME ) );
72
 
                        String note = cur.getString(
73
 
                                        cur.getColumnIndex( Contacts.People.NOTES ) );
74
 
 
75
 
                        // if we can, add a lookup for the contact id by name
76
 
                        CacheIdentifier cache_identifier = CacheIdentifier.factory(
77
 
                                CacheIdentifier.Type.NAME, name );
78
 
                        if( cache_identifier != null ) {
79
 
                                cache.addLookup( cache_identifier, id );
80
 
 
81
 
                                // add any associated notes (this would get done at the end but,
82
 
                                // since it is most common that contacts are identified by name,
83
 
                                // it is worth doing a special case here
84
 
                                cache.addAssociatedNote( id, note );
85
 
                        }
86
 
                        else
 
63
                        String name =
 
64
                                ContactsCache.normaliseName( cur.getString(
 
65
                                        cur.getColumnIndex( Contacts.People.NAME ) ) );
 
66
                        if( name != null )
87
67
                        {
88
 
                                // record that a lookup for this contact's id still needs to be
89
 
                                // added by some other means
90
 
                                unadded_ids.add( id );
 
68
                                // if we can, add a lookup for the contact id by name
 
69
                                if( name.length() > 0 ) {
 
70
                                        cache.addLookup( new CacheIdentifier(
 
71
                                                CacheIdentifier.Type.NAME, name ), id );
 
72
                                        continue;
 
73
                                }
 
74
                        }
91
75
 
92
 
                                // store this contact's notes, so that they can be added to the
93
 
                                // cache at the end, after this contact has been added (by
94
 
                                // whatever identifying means)
95
 
                                if( note != null && note.length() > 0 )
96
 
                                        notes.put( id, note );
97
 
                        }
 
76
                        // record that a lookup for this contact's id still needs to be
 
77
                        // added by some other means
 
78
                        unadded_ids.add( id );
98
79
                }
99
80
 
100
81
                // get contact organisations, primary ones first
106
87
                while( cur.moveToNext() ) {
107
88
                        Long id = cur.getLong( cur.getColumnIndex(
108
89
                                Contacts.Organizations.PERSON_ID ) );
109
 
                        String organisation = cur.getString(
110
 
                                cur.getColumnIndex( Contacts.Organizations.COMPANY ) );
111
 
 
112
 
                        // if this is an organisation name for a contact for whom we have
113
 
                        // not added a lookup, add a lookup for the contact id by
114
 
                        // organisation
115
 
                        if( unadded_ids.contains( id ) ) {
116
 
                                CacheIdentifier cache_identifier = CacheIdentifier.factory(
117
 
                                        CacheIdentifier.Type.ORGANISATION, organisation );
118
 
                                if( cache_identifier != null ) {
119
 
                                        cache.addLookup( cache_identifier, id );
 
90
                        String organisation =
 
91
                                ContactsCache.normaliseOrganisation( cur.getString(
 
92
                                        cur.getColumnIndex( Contacts.Organizations.COMPANY ) ) );
 
93
                        if( organisation != null )
 
94
                        {
 
95
                                // if this is an organisation name for a contact for whom we
 
96
                                // have not added a lookup, add a lookup for the contact id
 
97
                                // by organisation
 
98
                                if( unadded_ids.contains( id ) ) {
 
99
                                        cache.addLookup( new CacheIdentifier(
 
100
                                                CacheIdentifier.Type.ORGANISATION, organisation ), id );
120
101
                                        unadded_ids.remove( id );
121
102
                                }
 
103
 
 
104
                                // add associated data
 
105
                                cache.addAssociatedOrganisation( id, organisation );
122
106
                        }
123
 
 
124
 
                        // add associated data
125
 
                        cache.addAssociatedOrganisation( id, organisation );
126
107
                }
127
108
 
128
109
                // get all phone numbers, primary ones first
134
115
                while( cur.moveToNext() ) {
135
116
                        Long id = cur.getLong(
136
117
                                cur.getColumnIndex( Contacts.Phones.PERSON_ID ) );
137
 
                        String number = cur.getString(
138
 
                                cur.getColumnIndex( Contacts.Phones.NUMBER ) );
139
 
 
140
 
                        // if this is a number for a contact for whom we have not
141
 
                        // added a lookup, add a lookup for the contact id by phone
142
 
                        // number
143
 
                        if( unadded_ids.contains( id ) ) {
144
 
                                CacheIdentifier cache_identifier = CacheIdentifier.factory(
145
 
                                        CacheIdentifier.Type.PRIMARY_NUMBER, number );
146
 
                                if( cache_identifier != null ) {
147
 
                                        cache.addLookup( cache_identifier, id );
 
118
                        String number =
 
119
                                ContactsCache.normalisePhoneNumber( cur.getString(
 
120
                                        cur.getColumnIndex( Contacts.Phones.NUMBER ) ) );
 
121
                        if( number != null )
 
122
                        {
 
123
                                // if this is a number for a contact for whom we have not
 
124
                                // added a lookup, add a lookup for the contact id by phone
 
125
                                // number
 
126
                                if( unadded_ids.contains( id ) ) {
 
127
                                        cache.addLookup( new CacheIdentifier(
 
128
                                                CacheIdentifier.Type.PRIMARY_NUMBER, number ), id );
148
129
                                        unadded_ids.remove( id );
149
130
                                }
 
131
 
 
132
                                // add associated data
 
133
                                cache.addAssociatedNumber( id, number );
150
134
                        }
151
 
 
152
 
                        // add associated data
153
 
                        cache.addAssociatedNumber( id, number );
154
135
                }
155
136
 
156
137
                // now get all email addresses, primary ones first, and postal addresses
159
140
                                Contacts.ContactMethods.PERSON_ID,
160
141
                                Contacts.ContactMethods.DATA,
161
142
                                Contacts.ContactMethods.KIND,
162
 
                        }, Contacts.ContactMethods.KIND + " IN( ?, ? )",
163
 
                        new String[] {
 
143
                        }, Contacts.ContactMethods.KIND + " IN( ?, ? )", new String[] {
164
144
                                "" + Contacts.KIND_EMAIL,
165
145
                                "" + Contacts.KIND_POSTAL,
166
146
                        }, Contacts.ContactMethods.ISPRIMARY + " DESC" );
171
151
                                cur.getColumnIndex( Contacts.ContactMethods.KIND ) );
172
152
                        if( kind == Contacts.KIND_EMAIL )
173
153
                        {
174
 
                                String email = cur.getString(
175
 
                                        cur.getColumnIndex( Contacts.ContactMethods.DATA ) );
176
 
 
177
 
                                // if this is an email address for a contact for whom we have
178
 
                                // not added a lookup, add a lookup for the contact id by email
179
 
                                // address
180
 
                                if( unadded_ids.contains( id ) ) {
181
 
                                        CacheIdentifier cache_identifier = CacheIdentifier.factory(
182
 
                                                CacheIdentifier.Type.PRIMARY_EMAIL, email );
183
 
                                        if( cache_identifier != null ) {
184
 
                                                cache.addLookup( cache_identifier, id );
 
154
                                String email =
 
155
                                        ContactsCache.normaliseEmailAddress( cur.getString(
 
156
                                                cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) );
 
157
                                if( email != null )
 
158
                                {
 
159
                                        // if this is an email address for a contact for whom we
 
160
                                        // have not added a lookup, add a lookup for the contact
 
161
                                        // id by email address
 
162
                                        if( unadded_ids.contains( id ) ) {
 
163
                                                cache.addLookup( new CacheIdentifier(
 
164
                                                        CacheIdentifier.Type.PRIMARY_EMAIL, email ), id );
185
165
                                                unadded_ids.remove( id );
186
166
                                        }
 
167
 
 
168
                                        // add associated data
 
169
                                        cache.addAssociatedEmail( id, email );
187
170
                                }
188
 
 
189
 
                                // add associated data
190
 
                                cache.addAssociatedEmail( id, email );
191
171
                        }
192
172
                        else if( kind == Contacts.KIND_POSTAL )
193
173
                        {
194
 
                                String address = cur.getString(
195
 
                                        cur.getColumnIndex( Contacts.ContactMethods.DATA ) );
196
 
 
197
 
                                // add associated data
198
 
                                cache.addAssociatedAddress( id, address );
 
174
                                String address =
 
175
                                        ContactsCache.normaliseAddress( cur.getString(
 
176
                                                cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) );
 
177
                                if( address != null )
 
178
                                {
 
179
                                        // add associated data
 
180
                                        cache.addAssociatedAddress( id, address );
 
181
                                }
199
182
                        }
200
183
                }
201
 
 
202
 
                // finally, add the notes that we stored earlier (we have to add these
203
 
                // at the end because we can't be sure which piece of contact data will
204
 
                // cause the contact to be added to the cache
205
 
                Iterator< Long > i = notes.keySet().iterator();
206
 
                while( i.hasNext() ) {
207
 
                        Long id = i.next();
208
 
                        cache.addAssociatedNote( id, notes.get( id ) );
209
 
                }
210
184
        }
211
185
 
212
186
        @Override
218
192
        }
219
193
 
220
194
        @Override
221
 
        public Long addContact( String name ) throws ContactCreationException
 
195
        public Long addContact( String name )
222
196
        {
223
197
                ContentValues values = new ContentValues();
224
 
                if( name != null )
225
 
                        values.put( Contacts.People.NAME, name );
 
198
                values.put( Contacts.People.NAME, name );
226
199
                Uri contact_uri = _activity.getContentResolver().insert(
227
200
                        Contacts.People.CONTENT_URI, values );
228
201
                Long id = ContentUris.parseId( contact_uri );
229
 
                if( id == 0 )
230
 
                        throw new ContactCreationException();
 
202
                if( id == 0 ) id = null;
231
203
 
232
204
                // try to add them to the "My Contacts" group
233
 
                try {
234
 
                        Contacts.People.addToMyContactsGroup(
235
 
                                _activity.getContentResolver(), id );
236
 
                }
237
 
                catch( IllegalStateException e ) {
238
 
                        // ignore any failure
 
205
                if( id != null ) {
 
206
                        try {
 
207
                                Contacts.People.addToMyContactsGroup(
 
208
                                        _activity.getContentResolver(), id );
 
209
                        }
 
210
                        catch( IllegalStateException e ) {
 
211
                                // ignore any failure
 
212
                        }
239
213
                }
240
214
 
241
215
                return id;
242
216
        }
243
217
 
244
 
        private int convertTypeToBackendType( Class< ? > cls, int type )
245
 
                throws ContactCreationException
246
 
        {
247
 
                if( cls == Contacts.Phones.class )
248
 
                {
249
 
                        switch( type )
250
 
                        {
251
 
                        case ContactData.TYPE_HOME:
252
 
                                return Contacts.Phones.TYPE_HOME;
253
 
                        case ContactData.TYPE_WORK:
254
 
                                return Contacts.Phones.TYPE_WORK;
255
 
                        case ContactData.TYPE_MOBILE:
256
 
                                return Contacts.Phones.TYPE_MOBILE;
257
 
                        case ContactData.TYPE_FAX_HOME:
258
 
                                return Contacts.Phones.TYPE_FAX_HOME;
259
 
                        case ContactData.TYPE_FAX_WORK:
260
 
                                return Contacts.Phones.TYPE_FAX_WORK;
261
 
                        case ContactData.TYPE_PAGER:
262
 
                                return Contacts.Phones.TYPE_PAGER;
263
 
                        }
264
 
                }
265
 
                else if( cls == Contacts.ContactMethods.class )
266
 
                {
267
 
                        switch( type )
268
 
                        {
269
 
                        case ContactData.TYPE_HOME:
270
 
                                return Contacts.ContactMethods.TYPE_HOME;
271
 
                        case ContactData.TYPE_WORK:
272
 
                                return Contacts.ContactMethods.TYPE_WORK;
273
 
                        }
274
 
                }
275
 
 
276
 
                // still here?
277
 
                throw new ContactCreationException();
278
 
        }
279
 
 
280
218
        @Override
281
219
        public void addContactPhone( Long id, String number,
282
 
                ContactData.PreferredDetail data ) throws ContactCreationException
 
220
                ContactData.PreferredDetail data )
283
221
        {
284
222
                Uri contact_phones_uri = Uri.withAppendedPath(
285
223
                        ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
286
224
                        Contacts.People.Phones.CONTENT_DIRECTORY );
287
225
 
288
226
                ContentValues values = new ContentValues();
289
 
                values.put( Contacts.Phones.TYPE,
290
 
                        convertTypeToBackendType( Contacts.Phones.class,
291
 
                                data.getType() ) );
 
227
                values.put( Contacts.Phones.TYPE, data.getType() );
292
228
                values.put( Contacts.Phones.NUMBER, number );
293
229
                if( data.isPreferred() )
294
230
                        values.put( Contacts.Phones.ISPRIMARY, 1 );
298
234
 
299
235
        @Override
300
236
        public void addContactEmail( Long id, String email,
301
 
                ContactData.PreferredDetail data ) throws ContactCreationException
 
237
                ContactData.PreferredDetail data )
302
238
        {
303
239
                Uri contact_contact_methods_uri = Uri.withAppendedPath(
304
240
                        ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
307
243
                ContentValues values = new ContentValues();
308
244
                values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL );
309
245
                values.put( Contacts.ContactMethods.DATA, email );
310
 
                values.put( Contacts.ContactMethods.TYPE,
311
 
                        convertTypeToBackendType( Contacts.ContactMethods.class,
312
 
                                data.getType() ) );
 
246
                values.put( Contacts.ContactMethods.TYPE, data.getType() );
313
247
                if( data.isPreferred() )
314
248
                        values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
315
249
 
319
253
 
320
254
        @Override
321
255
        public void addContactAddresses( Long id, String address,
322
 
                ContactData.TypeDetail data ) throws ContactCreationException
 
256
                ContactData.TypeDetail data )
323
257
        {
324
258
                Uri contact_contact_methods_uri = Uri.withAppendedPath(
325
259
                        ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
328
262
                ContentValues values = new ContentValues();
329
263
                values.put( Contacts.ContactMethods.KIND, Contacts.KIND_POSTAL );
330
264
                values.put( Contacts.ContactMethods.DATA, address );
331
 
                values.put( Contacts.ContactMethods.TYPE,
332
 
                        convertTypeToBackendType( Contacts.ContactMethods.class,
333
 
                                data.getType() ) );
 
265
                values.put( Contacts.ContactMethods.TYPE, data.getType() );
334
266
 
335
267
                _activity.getContentResolver().insert( contact_contact_methods_uri,
336
268
                        values );
338
270
 
339
271
        @Override
340
272
        public void addContactOrganisation( Long id, String organisation,
341
 
                ContactData.ExtraDetail data ) throws ContactCreationException
 
273
                ContactData.ExtraDetail data )
342
274
        {
343
275
                ContentValues values = new ContentValues();
344
276
                values.put( Contacts.Organizations.PERSON_ID, id );
352
284
                        Contacts.Organizations.CONTENT_URI, values );
353
285
        }
354
286
 
355
 
        @Override
356
 
        public void addContactNote( Long id, String note )
357
 
                throws ContactCreationException
358
 
        {
359
 
                ContentValues values = new ContentValues();
360
 
                values.put( Contacts.People.NOTES, note );
361
 
                _activity.getContentResolver().update(
362
 
                        ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
363
 
                        values, null, null );
364
 
        }
365
287
 
366
288
}