bzr branch
http://bzr.ed.am/android/import-contacts
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
1 |
/* |
2 |
* ContactsBackend.java |
|
3 |
* |
|
4 |
* Copyright (C) 2012 Tim Marston <tim@ed.am> |
|
5 |
* |
|
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 |
|
9 |
* |
|
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. |
|
14 |
* |
|
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. |
|
19 |
* |
|
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/>. |
|
22 |
*/ |
|
23 |
||
24 |
package am.ed.importcontacts; |
|
25 |
||
26 |
import java.util.HashSet; |
|
27 |
||
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; |
|
36 |
||
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
37 |
@SuppressWarnings( "deprecation" ) |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
38 |
public class ContactsBackend implements Backend |
39 |
{ |
|
40 |
private Activity _activity = null; |
|
41 |
||
42 |
ContactsBackend( Activity activity ) |
|
43 |
{ |
|
44 |
_activity = activity; |
|
45 |
} |
|
46 |
||
47 |
@Override |
|
48 |
public void populateCache( ContactsCache cache ) |
|
49 |
{ |
|
50 |
Cursor cur; |
|
51 |
||
52 |
// set of contact ids that we have not yet added |
|
57
by edam
cleanup; fixed some typos; updated TODO |
53 |
HashSet< Long > unadded_ids = new HashSet< Long >(); |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
54 |
|
55 |
// get all contacts |
|
56 |
cur = _activity.managedQuery( Contacts.People.CONTENT_URI, |
|
57 |
new String[] { |
|
58 |
Contacts.People._ID, |
|
59 |
Contacts.People.NAME, |
|
60 |
}, null, null, null ); |
|
61 |
while( cur.moveToNext() ) { |
|
62 |
Long id = cur.getLong( |
|
63 |
cur.getColumnIndex( Contacts.People._ID ) ); |
|
64 |
String name = |
|
65 |
ContactsCache.normaliseName( cur.getString( |
|
66 |
cur.getColumnIndex( Contacts.People.NAME ) ) ); |
|
67 |
if( name != null ) |
|
68 |
{ |
|
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 |
} |
|
75 |
} |
|
76 |
||
77 |
// record that a lookup for this contact's id still needs to be |
|
78 |
// added by some other means |
|
57
by edam
cleanup; fixed some typos; updated TODO |
79 |
unadded_ids.add( id ); |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
80 |
} |
81 |
||
82 |
// get contact organisations, primary ones first |
|
83 |
cur = _activity.managedQuery( Contacts.Organizations.CONTENT_URI, |
|
84 |
new String[] { |
|
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 ) ); |
|
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 |
|
57
by edam
cleanup; fixed some typos; updated TODO |
99 |
if( unadded_ids.contains( id ) ) { |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
100 |
cache.addLookup( new CacheIdentifier( |
101 |
CacheIdentifier.Type.ORGANISATION, organisation ), id ); |
|
57
by edam
cleanup; fixed some typos; updated TODO |
102 |
unadded_ids.remove( id ); |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
103 |
} |
104 |
||
105 |
// add associated data |
|
106 |
cache.addAssociatedOrganisation( id, organisation ); |
|
107 |
} |
|
108 |
} |
|
109 |
||
110 |
// get all phone numbers, primary ones first |
|
111 |
cur = _activity.managedQuery( Contacts.Phones.CONTENT_URI, |
|
112 |
new String[] { |
|
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 ) ); |
|
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 |
|
57
by edam
cleanup; fixed some typos; updated TODO |
127 |
if( unadded_ids.contains( id ) ) { |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
128 |
cache.addLookup( new CacheIdentifier( |
129 |
CacheIdentifier.Type.PRIMARY_NUMBER, number ), id ); |
|
57
by edam
cleanup; fixed some typos; updated TODO |
130 |
unadded_ids.remove( id ); |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
131 |
} |
132 |
||
133 |
// add associated data |
|
134 |
cache.addAssociatedNumber( id, number ); |
|
135 |
} |
|
136 |
} |
|
137 |
||
138 |
// now get all email addresses, primary ones first, and postal addresses |
|
139 |
cur = _activity.managedQuery( Contacts.ContactMethods.CONTENT_URI, |
|
140 |
new String[] { |
|
141 |
Contacts.ContactMethods.PERSON_ID, |
|
142 |
Contacts.ContactMethods.DATA, |
|
143 |
Contacts.ContactMethods.KIND, |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
144 |
}, Contacts.ContactMethods.KIND + " IN( ?, ? )", |
145 |
new String[] { |
|
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
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 ) |
|
155 |
{ |
|
156 |
String email = |
|
157 |
ContactsCache.normaliseEmailAddress( cur.getString( |
|
158 |
cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) ); |
|
159 |
if( email != null ) |
|
160 |
{ |
|
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 |
|
57
by edam
cleanup; fixed some typos; updated TODO |
164 |
if( unadded_ids.contains( id ) ) { |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
165 |
cache.addLookup( new CacheIdentifier( |
166 |
CacheIdentifier.Type.PRIMARY_EMAIL, email ), id ); |
|
57
by edam
cleanup; fixed some typos; updated TODO |
167 |
unadded_ids.remove( id ); |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
168 |
} |
169 |
||
170 |
// add associated data |
|
171 |
cache.addAssociatedEmail( id, email ); |
|
172 |
} |
|
173 |
} |
|
174 |
else if( kind == Contacts.KIND_POSTAL ) |
|
175 |
{ |
|
176 |
String address = |
|
177 |
ContactsCache.normaliseAddress( cur.getString( |
|
178 |
cur.getColumnIndex( Contacts.ContactMethods.DATA ) ) ); |
|
179 |
if( address != null ) |
|
180 |
{ |
|
181 |
// add associated data |
|
182 |
cache.addAssociatedAddress( id, address ); |
|
183 |
} |
|
184 |
} |
|
185 |
} |
|
186 |
} |
|
187 |
||
188 |
@Override |
|
189 |
public void deleteContact( Long id ) |
|
190 |
{ |
|
191 |
Uri contact_uri = |
|
192 |
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ); |
|
193 |
_activity.getContentResolver().delete( contact_uri, null, null ); |
|
194 |
} |
|
195 |
||
196 |
@Override |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
197 |
public Long addContact( String name ) throws ContactCreationException |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
198 |
{ |
199 |
ContentValues values = new ContentValues(); |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
200 |
if( name != null ) |
201 |
values.put( Contacts.People.NAME, name ); |
|
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
202 |
Uri contact_uri = _activity.getContentResolver().insert( |
203 |
Contacts.People.CONTENT_URI, values ); |
|
204 |
Long id = ContentUris.parseId( contact_uri ); |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
205 |
if( id == 0 ) |
206 |
throw new ContactCreationException(); |
|
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
207 |
|
208 |
// try to add them to the "My Contacts" group |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
209 |
try { |
210 |
Contacts.People.addToMyContactsGroup( |
|
211 |
_activity.getContentResolver(), id ); |
|
212 |
} |
|
213 |
catch( IllegalStateException e ) { |
|
214 |
// ignore any failure |
|
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
215 |
} |
216 |
||
57
by edam
cleanup; fixed some typos; updated TODO |
217 |
return id; |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
218 |
} |
219 |
||
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
220 |
private int convertTypeToBackendType( Class< ? > cls, int type ) |
221 |
throws ContactCreationException |
|
222 |
{ |
|
223 |
if( cls == Contacts.Phones.class ) |
|
224 |
{ |
|
225 |
switch( type ) |
|
226 |
{ |
|
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; |
|
239 |
} |
|
240 |
} |
|
241 |
else if( cls == Contacts.ContactMethods.class ) |
|
242 |
{ |
|
243 |
switch( type ) |
|
244 |
{ |
|
245 |
case ContactData.TYPE_HOME: |
|
246 |
return Contacts.ContactMethods.TYPE_HOME; |
|
247 |
case ContactData.TYPE_WORK: |
|
248 |
return Contacts.ContactMethods.TYPE_WORK; |
|
249 |
} |
|
250 |
} |
|
251 |
||
252 |
// still here? |
|
253 |
throw new ContactCreationException(); |
|
254 |
} |
|
255 |
||
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
256 |
@Override |
257 |
public void addContactPhone( Long id, String number, |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
258 |
ContactData.PreferredDetail data ) throws ContactCreationException |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
259 |
{ |
260 |
Uri contact_phones_uri = Uri.withAppendedPath( |
|
261 |
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ), |
|
262 |
Contacts.People.Phones.CONTENT_DIRECTORY ); |
|
263 |
||
264 |
ContentValues values = new ContentValues(); |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
265 |
values.put( Contacts.Phones.TYPE, |
266 |
convertTypeToBackendType( Contacts.Phones.class, |
|
267 |
data.getType() ) ); |
|
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
268 |
values.put( Contacts.Phones.NUMBER, number ); |
269 |
if( data.isPreferred() ) |
|
270 |
values.put( Contacts.Phones.ISPRIMARY, 1 ); |
|
271 |
||
272 |
_activity.getContentResolver().insert( contact_phones_uri, values ); |
|
273 |
} |
|
274 |
||
275 |
@Override |
|
276 |
public void addContactEmail( Long id, String email, |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
277 |
ContactData.PreferredDetail data ) throws ContactCreationException |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
278 |
{ |
279 |
Uri contact_contact_methods_uri = Uri.withAppendedPath( |
|
280 |
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ), |
|
281 |
Contacts.People.ContactMethods.CONTENT_DIRECTORY ); |
|
282 |
||
283 |
ContentValues values = new ContentValues(); |
|
284 |
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_EMAIL ); |
|
285 |
values.put( Contacts.ContactMethods.DATA, email ); |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
286 |
values.put( Contacts.ContactMethods.TYPE, |
287 |
convertTypeToBackendType( Contacts.ContactMethods.class, |
|
288 |
data.getType() ) ); |
|
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
289 |
if( data.isPreferred() ) |
290 |
values.put( Contacts.ContactMethods.ISPRIMARY, 1 ); |
|
291 |
||
292 |
_activity.getContentResolver().insert( contact_contact_methods_uri, |
|
293 |
values ); |
|
294 |
} |
|
295 |
||
296 |
@Override |
|
297 |
public void addContactAddresses( Long id, String address, |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
298 |
ContactData.TypeDetail data ) throws ContactCreationException |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
299 |
{ |
300 |
Uri contact_contact_methods_uri = Uri.withAppendedPath( |
|
301 |
ContentUris.withAppendedId( Contacts.People.CONTENT_URI, id ), |
|
302 |
Contacts.People.ContactMethods.CONTENT_DIRECTORY ); |
|
303 |
||
304 |
ContentValues values = new ContentValues(); |
|
305 |
values.put( Contacts.ContactMethods.KIND, Contacts.KIND_POSTAL ); |
|
306 |
values.put( Contacts.ContactMethods.DATA, address ); |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
307 |
values.put( Contacts.ContactMethods.TYPE, |
308 |
convertTypeToBackendType( Contacts.ContactMethods.class, |
|
309 |
data.getType() ) ); |
|
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
310 |
|
311 |
_activity.getContentResolver().insert( contact_contact_methods_uri, |
|
312 |
values ); |
|
313 |
} |
|
314 |
||
315 |
@Override |
|
316 |
public void addContactOrganisation( Long id, String organisation, |
|
61
by edam
made contacts backend throw exceptions when it can't create contacts on the device; specified Locale in lower/upper case conversions; stripped old Contacts types from Importer (and replaced with our own types, which are now converted in the backend; switched using Integer() constructors to Integer.valueOf(); rewrote the main importer routine a bit |
317 |
ContactData.ExtraDetail data ) throws ContactCreationException |
53
by edam
abstracted the android contacts API in to an interface, ready to be switched to |
318 |
{ |
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() ); |
|
326 |
||
327 |
_activity.getContentResolver().insert( |
|
328 |
Contacts.Organizations.CONTENT_URI, values ); |
|
329 |
} |
|
330 |
||
331 |
||
332 |
} |