/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-21 14:47:57 UTC
  • Revision ID: tim@ed.am-20121221144757-5cb1lgsp7fdt7p2n
updated TODO

Show diffs side-by-side

added added

removed removed

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