1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
|
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
* The Evolution addressbook client object.
*
* Author:
* Chris Toshok (toshok@ximian.com)
*
* Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
*/
#ifndef __E_BOOK_H__
#define __E_BOOK_H__
#include <glib.h>
#include <glib-object.h>
#include "libedataserver/e-list.h"
#include "libedataserver/e-source.h"
#include "libedataserver/e-source-list.h"
#include <libebook/e-contact.h>
#include <libebook/e-book-query.h>
#include <libebook/e-book-view.h>
#include <libebook/e-book-types.h>
#define E_TYPE_BOOK (e_book_get_type ())
#define E_BOOK(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), E_TYPE_BOOK, EBook))
#define E_BOOK_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), E_TYPE_BOOK, EBookClass))
#define E_IS_BOOK(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), E_TYPE_BOOK))
#define E_IS_BOOK_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), E_TYPE_BOOK))
#define E_BOOK_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), E_TYPE_BOOK, EBookClass))
G_BEGIN_DECLS
typedef struct _EBook EBook;
typedef struct _EBookClass EBookClass;
typedef struct _EBookPrivate EBookPrivate;
typedef void (*EBookCallback) (EBook *book, EBookStatus status, gpointer closure);
typedef void (*EBookOpenProgressCallback) (EBook *book,
const char *status_message,
short percent,
gpointer closure);
typedef void (*EBookIdCallback) (EBook *book, EBookStatus status, const char *id, gpointer closure);
typedef void (*EBookContactCallback) (EBook *book, EBookStatus status, EContact *contact, gpointer closure);
typedef void (*EBookListCallback) (EBook *book, EBookStatus status, GList *list, gpointer closure);
typedef void (*EBookBookViewCallback) (EBook *book, EBookStatus status, EBookView *book_view, gpointer closure);
typedef void (*EBookEListCallback) (EBook *book, EBookStatus status, EList *list, gpointer closure);
struct _EBook {
GObject parent;
/*< private >*/
EBookPrivate *priv;
};
struct _EBookClass {
GObjectClass parent;
/*
* Signals.
*/
void (* writable_status) (EBook *book, gboolean writable);
void (* connection_status) (EBook *book, gboolean connected);
void (* auth_required) (EBook *book);
void (* backend_died) (EBook *book);
/* Padding for future expansion */
void (*_ebook_reserved0) (void);
void (*_ebook_reserved1) (void);
void (*_ebook_reserved2) (void);
void (*_ebook_reserved3) (void);
void (*_ebook_reserved4) (void);
};
/* Creating a new addressbook. */
EBook *e_book_new (ESource *source, GError **error);
EBook *e_book_new_from_uri (const char *uri, GError **error);
EBook *e_book_new_system_addressbook (GError **error);
EBook *e_book_new_default_addressbook (GError **error);
/* loading addressbooks */
gboolean e_book_open (EBook *book,
gboolean only_if_exists,
GError **error);
guint e_book_async_open (EBook *book,
gboolean only_if_exists,
EBookCallback open_response,
gpointer closure);
gboolean e_book_remove (EBook *book,
GError **error);
guint e_book_async_remove (EBook *book,
EBookCallback cb,
gpointer closure);
gboolean e_book_get_required_fields (EBook *book,
GList **fields,
GError **error);
guint e_book_async_get_required_fields (EBook *book,
EBookEListCallback cb,
gpointer closure);
gboolean e_book_get_supported_fields (EBook *book,
GList **fields,
GError **error);
guint e_book_async_get_supported_fields (EBook *book,
EBookEListCallback cb,
gpointer closure);
gboolean e_book_get_supported_auth_methods (EBook *book,
GList **auth_methods,
GError **error);
guint e_book_async_get_supported_auth_methods (EBook *book,
EBookEListCallback cb,
gpointer closure);
/* User authentication. */
gboolean e_book_authenticate_user (EBook *book,
const char *user,
const char *passwd,
const char *auth_method,
GError **error);
guint e_book_async_authenticate_user (EBook *book,
const char *user,
const char *passwd,
const char *auth_method,
EBookCallback cb,
gpointer closure);
/* Fetching contacts. */
gboolean e_book_get_contact (EBook *book,
const char *id,
EContact **contact,
GError **error);
guint e_book_async_get_contact (EBook *book,
const char *id,
EBookContactCallback cb,
gpointer closure);
/* Deleting contacts. */
gboolean e_book_remove_contact (EBook *book,
const char *id,
GError **error);
guint e_book_async_remove_contact (EBook *book,
EContact *contact,
EBookCallback cb,
gpointer closure);
guint e_book_async_remove_contact_by_id (EBook *book,
const char *id,
EBookCallback cb,
gpointer closure);
gboolean e_book_remove_contacts (EBook *book,
GList *ids,
GError **error);
guint e_book_async_remove_contacts (EBook *book,
GList *ids,
EBookCallback cb,
gpointer closure);
/* Adding contacts. */
gboolean e_book_add_contact (EBook *book,
EContact *contact,
GError **error);
gboolean e_book_async_add_contact (EBook *book,
EContact *contact,
EBookIdCallback cb,
gpointer closure);
/* Modifying contacts. */
gboolean e_book_commit_contact (EBook *book,
EContact *contact,
GError **error);
guint e_book_async_commit_contact (EBook *book,
EContact *contact,
EBookCallback cb,
gpointer closure);
/* Returns a live view of a query. */
gboolean e_book_get_book_view (EBook *book,
EBookQuery *query,
GList *requested_fields,
int max_results,
EBookView **book_view,
GError **error);
guint e_book_async_get_book_view (EBook *book,
EBookQuery *query,
GList *requested_fields,
int max_results,
EBookBookViewCallback cb,
gpointer closure);
/* Returns a static snapshot of a query. */
gboolean e_book_get_contacts (EBook *book,
EBookQuery *query,
GList **contacts,
GError **error);
guint e_book_async_get_contacts (EBook *book,
EBookQuery *query,
EBookListCallback cb,
gpointer closure);
/* Needed for syncing */
gboolean e_book_get_changes (EBook *book,
char *changeid,
GList **changes,
GError **error);
guint e_book_async_get_changes (EBook *book,
char *changeid,
EBookListCallback cb,
gpointer closure);
void e_book_free_change_list (GList *change_list);
const char *e_book_get_uri (EBook *book);
ESource *e_book_get_source (EBook *book);
const char *e_book_get_static_capabilities (EBook *book,
GError **error);
gboolean e_book_check_static_capability (EBook *book,
const char *cap);
gboolean e_book_is_opened (EBook *book);
gboolean e_book_is_writable (EBook *book);
gboolean e_book_is_online (EBook *book);
/* Cancel a pending operation. */
gboolean e_book_cancel (EBook *book,
GError **error);
/* Identity */
gboolean e_book_get_self (EContact **contact, EBook **book, GError **error);
gboolean e_book_set_self (EBook *book, EContact *contact, GError **error);
gboolean e_book_is_self (EContact *contact);
/* Addressbook Discovery */
gboolean e_book_set_default_addressbook (EBook *book, GError **error);
gboolean e_book_set_default_source (ESource *source, GError **error);
gboolean e_book_get_addressbooks (ESourceList** addressbook_sources, GError **error);
GType e_book_get_type (void);
G_END_DECLS
#endif /* ! __E_BOOK_H__ */
|
