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

  • Committer: edam
  • Date: 2009-01-13 06:35:26 UTC
  • Revision ID: edam@waxworlds.org-20090113063526-l9t1s9git4bav60a
- new contact's phone numebrs and email addresses are added to the caches after those contacts are updated to account for the situation where the same contact is imported again from another file (or the contact exists twice in the same file!?)

Show diffs side-by-side

added added

removed removed

src/am/ed/importcontacts/Backend.java
1
 
/*
2
 
 * Backend.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 am.ed.importcontacts.Importer.ContactData;
27
 
 
28
 
public interface Backend
29
 
{
30
 
        /**
31
 
         * Build-up our contacts cache, using contacts on the device.
32
 
         * @param cache the contacts cache to populate
33
 
         */
34
 
        public void populateCache( ContactsCache cache );
35
 
 
36
 
        /**
37
 
         * Delete a contact from the device.
38
 
         * @param id of the contact to delete
39
 
         */
40
 
        public void deleteContact( Long id );
41
 
 
42
 
        @SuppressWarnings("serial")
43
 
        public class ContactCreationException extends Exception { };
44
 
 
45
 
        /**
46
 
         * Add a contact to the device.
47
 
         * @param name name of the new contact, or null if there isn't one
48
 
         * @return the new contact's id
49
 
         * @throws ContactCreationException
50
 
         */
51
 
        public Long addContact( String name ) throws ContactCreationException;
52
 
 
53
 
        /**
54
 
         * Add a phone number to an existing contact on the device.
55
 
         * @param id the existing contact's id
56
 
         * @param number the phone number
57
 
         * @param data data about the number
58
 
         * @throws ContactCreationException
59
 
         */
60
 
        public void addContactPhone( Long id, String number,
61
 
                ContactData.PreferredDetail data ) throws ContactCreationException;
62
 
 
63
 
        /**
64
 
         * Add an email address to an existing contact on the device.
65
 
         * @param id the existing contact's id
66
 
         * @param email the email address
67
 
         * @param data data about the email address
68
 
         * @throws ContactCreationException
69
 
         */
70
 
        public void addContactEmail( Long id, String email,
71
 
                ContactData.PreferredDetail data ) throws ContactCreationException;
72
 
 
73
 
        /**
74
 
         * Add an address to an existing contact on the device.
75
 
         * @param id the existing contact's id
76
 
         * @param address the address
77
 
         * @param data data about the address
78
 
         * @throws ContactCreationException
79
 
         */
80
 
        public void addContactAddresses( Long id, String address,
81
 
                ContactData.TypeDetail data ) throws ContactCreationException;
82
 
 
83
 
        /**
84
 
         * Add a title and organisation to an existing contact on the device.
85
 
         * @param id the existing contact's id
86
 
         * @param organisation the organisation
87
 
         * @param data data about the organisation
88
 
         * @throws ContactCreationException
89
 
         */
90
 
        public void addContactOrganisation( Long id, String organisation,
91
 
                ContactData.ExtraDetail data ) throws ContactCreationException;
92
 
 
93
 
        /**
94
 
         * Add a note to an existing contact on the device.
95
 
         * @param id the existing contact's id
96
 
         * @param note the note
97
 
         * @throws ContactCreationException
98
 
         */
99
 
        public void addContactNote( Long id, String note )
100
 
                throws ContactCreationException;
101
 
 
102
 
}