4
* Copyright (C) 2011 to 2012 Tim Marston <tim@ed.am>
4
* Copyright (C) 2011 Tim Marston <tim@ed.am>
6
6
* This file is part of the Import Contacts program (hereafter referred
7
* to as "this program"). For more information, see
7
* to as "this program"). For more information, see
8
8
* http://ed.am/dev/android/import-contacts
10
10
* This program is free software: you can redistribute it and/or modify
26
26
import java.util.HashMap;
27
27
import java.util.HashSet;
28
import java.util.Locale;
29
import android.app.Activity;
30
32
public class ContactsCache
33
* A thing that can be used to identify (or lookup) a contact within the
34
* contacts cache. It is not a reference to a cache entry and may not
35
* identify an existing contact in the cache.
35
* Information that can be used to identify a contact within the cache
37
public static class CacheIdentifier
37
static public class CacheIdentifier
39
public enum Type { NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
40
NONE, NAME, ORGANISATION, PRIMARY_NUMBER, PRIMARY_EMAIL }
41
42
private Type _type;
42
43
private String _detail;
45
* Obtain a cache identifier. This routine is designed to be as robust
46
* as possible (in terms of bad or null detail values), and to return
47
* null when a cache identifier can not be created.
49
* @param type the detail type
50
* @param detail the detail
51
* @return the cache identifier, or null
53
public static CacheIdentifier factory( Type type, String detail )
57
case NAME: detail = normaliseName( detail ); break;
58
case ORGANISATION: detail = normaliseOrganisation( detail ); break;
59
case PRIMARY_NUMBER: detail = normalisePhoneNumber( detail ); break;
60
case PRIMARY_EMAIL: detail = normaliseEmailAddress( detail ); break;
63
if( detail == null ) return null;
64
return new CacheIdentifier( type, detail );
68
* Obtain a cache identifier from contact data. This routine is
69
* designed to be as robust as possible and may return null when a cache
70
* identifier can not be created.
72
* @param contact the contact data
73
* @return the cache identifier, or null
75
public static CacheIdentifier factory( Importer.ContactData contact )
77
CacheIdentifier identifier = null;
79
if( contact.hasName() )
80
identifier = factory( CacheIdentifier.Type.NAME,
82
if( identifier != null ) return identifier;
84
if( contact.hasPrimaryOrganisation() )
85
identifier = factory( CacheIdentifier.Type.ORGANISATION,
86
contact.getPrimaryOrganisation() );
87
if( identifier != null ) return identifier;
89
if( contact.hasPrimaryNumber() )
90
identifier = factory( CacheIdentifier.Type.PRIMARY_NUMBER,
91
contact.getPrimaryNumber() );
92
if( identifier != null ) return identifier;
94
if( contact.hasPrimaryEmail() )
95
identifier = factory( CacheIdentifier.Type.PRIMARY_EMAIL,
96
contact.getPrimaryEmail() );
97
if( identifier != null ) return identifier;
45
protected CacheIdentifier()
102
50
protected CacheIdentifier( Type type, String detail )
135
83
= new HashMap< Long, HashSet< String > >();
136
84
private HashMap< Long, HashSet< String > > _contactOrganisations
137
85
= new HashMap< Long, HashSet< String > >();
138
private HashMap< Long, HashSet< String > > _contactNotes
139
= new HashMap< Long, HashSet< String > >();
90
// _contactsByName = new HashMap< String, Long >();
91
// _contactsByOrg = new HashMap< String, Long >();
92
// _contactsByNumber = new HashMap< String, Long >();
93
// _contactsByEmail = new HashMap< String, Long >();
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 > >();
102
public static CacheIdentifier createIdentifier(
103
Importer.ContactData contact )
105
if( contact.hasName() ) {
106
String name = normaliseName( contact.getName() );
108
return new CacheIdentifier(
109
CacheIdentifier.Type.NAME, name );
112
if( contact.hasPrimaryOrganisation() ) {
113
String organisation = normaliseOrganisation(
114
contact.getPrimaryOrganisation() );
115
if( organisation != null )
116
return new CacheIdentifier(
117
CacheIdentifier.Type.ORGANISATION, organisation );
120
if( contact.hasPrimaryNumber() ) {
121
String number = normalisePhoneNumber( contact.getPrimaryNumber() );
123
return new CacheIdentifier(
124
CacheIdentifier.Type.PRIMARY_NUMBER, number );
127
if( contact.hasPrimaryEmail() ) {
128
String email = normaliseEmailAddress( contact.getPrimaryEmail() );
130
return new CacheIdentifier(
131
CacheIdentifier.Type.PRIMARY_EMAIL, email );
141
137
public boolean canLookup( CacheIdentifier identifier )
143
139
return lookup( identifier ) != null;
147
* Retrieve the contact id of a contact identified by the specified cache
148
* identifier, if it exists.
150
* @param identifier the cache identifier
151
* @return a contact id, or null
153
142
public Long lookup( CacheIdentifier identifier )
155
144
switch( identifier.getType() )
217
* Remove any data that is associated with an contact id.
221
193
public void removeAssociatedData( Long id )
223
195
_contactNumbers.remove( id );
224
196
_contactEmails.remove( id );
225
197
_contactAddresses.remove( id );
226
198
_contactOrganisations.remove( id );
227
_contactNotes.remove( id );
230
201
public boolean hasAssociatedNumber( Long id, String number )
312
284
set = new HashSet< String >();
313
285
_contactOrganisations.put( id, set );
315
set.add( organisation );
318
public boolean hasAssociatedNote( Long id, String note )
320
note = normaliseNote( note );
321
if( note == null ) return false;
323
HashSet< String > set = _contactNotes.get( id );
324
return set != null && set.contains( note );
327
public void addAssociatedNote( Long id, String note )
329
note = normaliseNote( note );
330
if( note == null ) return;
332
HashSet< String > set = _contactNotes.get( id );
334
set = new HashSet< String >();
335
_contactNotes.put( id, set );
287
set.add( normaliseOrganisation( organisation ) );
340
290
static public String normaliseName( String name )