aboutsummaryrefslogtreecommitdiffstats
path: root/addressbook/backend/idl/addressbook.idl
blob: eabab4b5c2be0eb003707abab8135bf193e120cf (plain) (blame)
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
/*
 *
 * Author:
 *   Nat Friedman (nat@helixcode.com)
 *
 * Copyright 2000, Helix Code, Inc.
 */

#include <gnome-unknown.idl>

module Evolution {

    typedef string CardId;

    interface CardCursor {
        long   get_length ();
        string get_nth    (in long n);
    };

    interface Book : GNOME::Unknown {
        /*
         * Fetching cards in the addresbook.
         */
        string get_vcard (in CardId id);

        /*
         * Adding and deleting cards in the book.
         */
        void create_card (in string vcard);
        void remove_card (in CardId Id);
            
        /*
         * Modifying cards in the addressbook.
         */
        void modify_card (in string vcard);

        void check_connection ();

        string get_name ();
    };

    interface BookListener : GNOME::Unknown {

        enum CallStatus {
            Success,
            RepositoryOffline,
            PermissionDenied,
            CardNotFound
        };

        void respond_create_card (in CallStatus status);

        void respond_remove_card (in CallStatus status);

        void respond_modify_card (in CallStatus status);
        
        void report_open_book_progress (in string status_message, in short percent);

        void respond_open_book (in CallStatus status, in Book book);

        /**
         * report_connection_status:
         *
         * Used to report changes in the connection to the
         * contact repository.  This is often a response to a
         * call to check_connection() on the Book, but wombat
         * is free to report the connection status without
         * being asked.
         */
        void report_connection_status (in boolean connected);

        void signal_card_added (in CardId id);
        void signal_card_removed (in CardId id);
        void signal_card_changed (in CardId id);
    };

    interface BookFactory : GNOME::Unknown {
        exception ProtocolNotSupported {};

        void open_book (in string uri, in BookListener listener)
            raises (ProtocolNotSupported);
    };
};