include/dbus-c++/connection.h

   1 /*
   2  *
   3  *  D-Bus++ - C++ bindings for D-Bus
   4  *
   5  *  Copyright (C) 2005-2009  Paolo Durante <shackan@gmail.com>
   6  *
   7  *
   8  *  This library is free software; you can redistribute it and/or
   9  *  modify it under the terms of the GNU Lesser General Public
  10  *  License as published by the Free Software Foundation; either
  11  *  version 2.1 of the License, or (at your option) any later version.
  12  *
  13  *  This library is distributed in the hope that it will be useful,
  14  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  *  Lesser General Public License for more details.
  17  *
  18  *  You should have received a copy of the GNU Lesser General Public
  19  *  License along with this library; if not, write to the Free Software
  20  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  *
  22  */
  23
  24
  25 #ifndef __DBUSXX_CONNECTION_H
  26 #define __DBUSXX_CONNECTION_H
  27
  28 #include <list>
  29
  30 #include "api.h"
  31 #include "types.h"
  32 #include "util.h"
  33 #include "message.h"
  34 #include "pendingcall.h"
  35
  36 namespace DBus {
  37
  38 class Connection;
  39
  40 typedef Slot<bool, const Message &> MessageSlot;
  41
  42 typedef std::list<Connection> ConnectionList;
  43
  44 class ObjectAdaptor;
  45 class ObjectProxy;
  46 class Dispatcher;
  47
  48 class DBUSXXAPI Connection
  49 {
  50 public:
  51
  52         static Connection system_bus(Dispatcher *dispatcher = NULL);
  53         static Connection system_bus_private(Dispatcher *dispatcher = NULL);
  54
  55         static Connection session_bus(Dispatcher *dispatcher = NULL);
  56         static Connection session_bus_private(Dispatcher *dispatcher = NULL);
  57
  58         static Connection activation_bus(Dispatcher *dispatcher = NULL);
  59         static Connection activation_bus_private(Dispatcher *dispatcher = NULL);
  60
  61         struct Private;
  62
  63         typedef std::list<Private *> PrivatePList;
  64
  65         Connection();
  66
  67         Connection(RefPtrI<Private>);
  68
  69         Connection(const char *address, bool priv, Dispatcher *dispatcher = NULL);
  70
  71         Connection(const Connection &c);
  72
  73         virtual ~Connection();
  74
  75         bool operator == (const Connection &) const;
  76
  77         Connection &operator = (const Connection &);
  78
  79         void add_match(const char *rule);
  80
  81         void remove_match(const char *rule);
  82
  83         bool add_filter(MessageSlot &);
  84
  85         void remove_filter(MessageSlot &);
  86
  87         bool unique_name(const char *n);
  88
  89         const char *unique_name() const;
  90
  91         bool register_bus();
  92
  93         bool connected() const;
  94
  95         void disconnect();
  96
  97         void exit_on_disconnect(bool exit);
  98
  99         void flush();
 100
 101         bool send(const Message &, unsigned int *serial = NULL);
 102
 103         Message send_blocking(Message &msg, int timeout = -1);
 104
 105         PendingCall send_async(Message &msg, ObjectProxy *proxy, const PendingCallSlot &slot, void* data, int timeout);
 106
 107         void request_name(const char *name, int flags = 0);
 108
 109         bool has_name(const char *name);
 110
 111         bool start_service(const char *name, unsigned long flags);
 112
 113         const std::vector<std::string>& names();
 114
 115 private:
 116
 117         DBUSXXAPILOCAL void init();
 118
 119 private:
 120
 121         RefPtrI<Private> _pvt;
 122
 123 friend class ObjectAdaptor; // needed in order to register object paths for a connection
 124 };
 125
 126 class DBUSXXAPI CallInfo
 127 {
 128 public:
 129
 130    CallInfo();
 131         CallInfo(const Connection &c, const Message &m);
 132         CallInfo(const Connection &c, const PendingCall &pc);
 133
 134         const Connection &conn() const { return _conn; }
 135         const Message &msg() const { return _msg; }
 136         const Error &error() const { return _error; }
 137
 138         uint32_t sender_pid();
 139         uint32_t sender_uid();
 140
 141         CallInfo &operator = (const CallInfo& info);
 142
 143 protected:
 144
 145         Connection _conn;
 146         Message _msg;
 147         Error _error;
 148 };
 149
 150 } /* namespace DBus */
 151
 152 #endif//__DBUSXX_CONNECTION_H