4
* Copyright (C) 2012 Tim Marston <tim@ed.am>
6
* This file is part of the Import Contacts program (hereafter referred
7
* to as "this program"). For more information, see
8
* http://ed.am/dev/android/import-contacts
10
* This program is free software: you can redistribute it and/or modify
11
* it under the terms of the GNU General Public License as published by
12
* the Free Software Foundation, either version 3 of the License, or
13
* (at your option) any later version.
15
* This program is distributed in the hope that it will be useful,
16
* but WITHOUT ANY WARRANTY; without even the implied warranty of
17
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18
* GNU General Public License for more details.
20
* You should have received a copy of the GNU General Public License
21
* along with this program. If not, see <http://www.gnu.org/licenses/>.
24
package am.ed.importcontacts;
26
import java.util.HashSet;
28
import am.ed.importcontacts.ContactsCache.CacheIdentifier;
29
import am.ed.importcontacts.Importer.ContactData;
30
import android.app.Activity;
31
import android.content.ContentUris;
32
import android.content.ContentValues;
33
import android.database.Cursor;
34
import android.net.Uri;
35
import android.provider.Contacts;
37
@SuppressWarnings( "deprecation" )
38
public class ContactsBackend implements Backend
40
private Activity _activity = null;
42
ContactsBackend( Activity activity )
48
public void populateCache( ContactsCache cache )
52
// set of contact ids that we have not yet added
53
HashSet< Long > unadded_ids = new HashSet< Long >();
56
cur = _activity.managedQuery( Contacts.People.CONTENT_URI,
60
}, null, null, null );
61
while( cur.moveToNext() ) {
62
Long id = cur.getLong(
63
cur.getColumnIndex( Contacts.People._ID ) );
65
ContactsCache.normaliseName( cur.getString(
66
cur.getColumnIndex( Contacts.People.NAME ) ) );
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 );
77
// record that a lookup for this contact's id still needs to be
78
// added by some other means
79
unadded_ids.add( id );
82
// get contact organisations, primary ones first
83
cur = _activity.managedQuery( Contacts.Organizations.CONTENT_URI,
85
Contacts.Phones.PERSON_ID,
86
Contacts.Organizations.COMPANY,
87
}, null, null, Contacts.Organizations.ISPRIMARY + " DESC" );
88
while( cur.moveToNext() ) {
89
Long id = cur.getLong( cur.getColumnIndex(
90
Contacts.Organizations.PERSON_ID ) );
92
ContactsCache.normaliseOrganisation( cur.getString(
93
cur.getColumnIndex( Contacts.Organizations.COMPANY ) ) );
94
if( organisation != null )
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
99
if( unadded_ids.contains( id ) ) {
100
cache.addLookup( new CacheIdentifier(
101
CacheIdentifier.Type.ORGANISATION, organisation ), id );
102
unadded_ids.remove( id );
105
// add associated data
106
cache.addAssociatedOrganisation( id, organisation );
110
// get all phone numbers, primary ones first
111
cur = _activity.managedQuery( Contacts.Phones.CONTENT_URI,
113
Contacts.Phones.PERSON_ID,
114
Contacts.Phones.NUMBER,
115
}, null, null, Contacts.Phones.ISPRIMARY + " DESC" );
116
while( cur.moveToNext() ) {
117
Long id = cur.getLong(
118
cur.getColumnIndex( Contacts.Phones.PERSON_ID ) );
120
ContactsCache.normalisePhoneNumber( cur.getString(
121
cur.getColumnIndex( Contacts.Phones.NUMBER ) ) );
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
127
if( unadded_ids.contains( id ) ) {
128
cache.addLookup( new CacheIdentifier(
129
CacheIdentifier.Type.PRIMARY_NUMBER, number ), id );
130
unadded_ids.remove( id );
133
// add associated data
134
cache.addAssociatedNumber( id, number );
138
// now get all email addresses, primary ones first, and postal addresses
139
cur = _activity.managedQuery( Contacts.ContactMethods.CONTENT_URI,
141
Contacts.ContactMethods.PERSON_ID,
142
Contacts.ContactMethods.DATA,
143
Contacts.ContactMethods.KIND,
144
}, Contacts.ContactMethods.KIND + " IN( ?, ? )",
146
"" + Contacts.KIND_EMAIL,
147
"" + Contacts.KIND_POSTAL,
148
}, Contacts.ContactMethods.ISPRIMARY + " DESC" );
149
while( cur.moveToNext() ) {
150
Long id = cur.getLong(
151
cur.getColumnIndex( Contacts.ContactMethods.PERSON_ID ) );
152
int kind = cur.getInt(
153
cur.getColumnIndex( Contacts.ContactMethods.KIND ) );
154
if( kind == Contacts.KIND_EMAIL )
157
ContactsCache.normaliseEmailAddress( cur.getString(
158
cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) );
161
// if this is an email address for a contact for whom we
162
// have not added a lookup, add a lookup for the contact
163
// id by email address
164
if( unadded_ids.contains( id ) ) {
165
cache.addLookup( new CacheIdentifier(
166
CacheIdentifier.Type.PRIMARY_EMAIL, email ), id );
167
unadded_ids.remove( id );
170
// add associated data
171
cache.addAssociatedEmail( id, email );
174
else if( kind == Contacts.KIND_POSTAL )
177
ContactsCache.normaliseAddress( cur.getString(
178
cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) );
179
if( address != null )
181
// add associated data
182
cache.addAssociatedAddress( id, address );
189
public void deleteContact( Long id )
192
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id );
193
_activity.getContentResolver().delete( contact_uri, null, null );
197
public Long addContact( String name ) throws ContactCreationException
199
ContentValues values = new ContentValues();
201
values.put( Contacts.People.NAME, name );
202
Uri contact_uri = _activity.getContentResolver().insert(
203
Contacts.People.CONTENT_URI, values );
204
Long id = ContentUris.parseId( contact_uri );
206
throw new ContactCreationException();
208
// try to add them to the "My Contacts" group
210
Contacts.People.addToMyContactsGroup(
211
_activity.getContentResolver(), id );
213
catch( IllegalStateException e ) {
214
// ignore any failure
220
private int convertTypeToBackendType( Class< ? > cls, int type )
221
throws ContactCreationException
223
if( cls == Contacts.Phones.class )
227
case ContactData.TYPE_HOME:
228
return Contacts.Phones.TYPE_HOME;
229
case ContactData.TYPE_WORK:
230
return Contacts.Phones.TYPE_WORK;
231
case ContactData.TYPE_MOBILE:
232
return Contacts.Phones.TYPE_MOBILE;
233
case ContactData.TYPE_FAX_HOME:
234
return Contacts.Phones.TYPE_FAX_HOME;
235
case ContactData.TYPE_FAX_WORK:
236
return Contacts.Phones.TYPE_FAX_WORK;
237
case ContactData.TYPE_PAGER:
238
return Contacts.Phones.TYPE_PAGER;
241
else if( cls == Contacts.ContactMethods.class )
245
case ContactData.TYPE_HOME:
246
return Contacts.ContactMethods.TYPE_HOME;
247
case ContactData.TYPE_WORK:
248
return Contacts.ContactMethods.TYPE_WORK;
253
throw new ContactCreationException();
257
public void addContactPhone( Long id, String number,
258
ContactData.PreferredDetail data ) throws ContactCreationException
260
Uri contact_phones_uri = Uri.withAppendedPath(
261
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
262
Contacts.People.Phones.CONTENT_DIRECTORY );
264
ContentValues values = new ContentValues();
265
values.put( Contacts.Phones.TYPE,
266
convertTypeToBackendType( Contacts.Phones.class,
268
values.put( Contacts.Phones.NUMBER, number );
269
if( data.isPreferred() )
270
values.put( Contacts.Phones.ISPRIMARY, 1 );
272
_activity.getContentResolver().insert( contact_phones_uri, values );
276
public void addContactEmail( Long id, String email,
277
ContactData.PreferredDetail data ) throws ContactCreationException
279
Uri contact_contact_methods_uri = Uri.withAppendedPath(
280
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
281
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
283
ContentValues values = new ContentValues();
284
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL );
285
values.put( Contacts.ContactMethods.DATA, email );
286
values.put( Contacts.ContactMethods.TYPE,
287
convertTypeToBackendType( Contacts.ContactMethods.class,
289
if( data.isPreferred() )
290
values.put( Contacts.ContactMethods.ISPRIMARY, 1 );
292
_activity.getContentResolver().insert( contact_contact_methods_uri,
297
public void addContactAddresses( Long id, String address,
298
ContactData.TypeDetail data ) throws ContactCreationException
300
Uri contact_contact_methods_uri = Uri.withAppendedPath(
301
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ),
302
Contacts.People.ContactMethods.CONTENT_DIRECTORY );
304
ContentValues values = new ContentValues();
305
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_POSTAL );
306
values.put( Contacts.ContactMethods.DATA, address );
307
values.put( Contacts.ContactMethods.TYPE,
308
convertTypeToBackendType( Contacts.ContactMethods.class,
311
_activity.getContentResolver().insert( contact_contact_methods_uri,
316
public void addContactOrganisation( Long id, String organisation,
317
ContactData.ExtraDetail data ) throws ContactCreationException
319
ContentValues values = new ContentValues();
320
values.put( Contacts.Organizations.PERSON_ID, id );
321
values.put( Contacts.Organizations.COMPANY, organisation );
322
values.put( Contacts.ContactMethods.TYPE,
323
Contacts.OrganizationColumns.TYPE_WORK );
324
if( data.getExtra() != null )
325
values.put( Contacts.Organizations.TITLE, data.getExtra() );
327
_activity.getContentResolver().insert(
328
Contacts.Organizations.CONTENT_URI, values );