dbus-sharp/Bus.cs

   1 // Copyright 2006 Alp Toker <alp@atoker.com>
   2 // This software is made available under the MIT License
   3 // See COPYING for details
   4
   5 using System;
   6 using System.Collections.Generic;
   7 using org.freedesktop.DBus;
   8
   9 namespace Wv
  10 {
  11         using Transports;
  12
  13         public sealed class Bus : Connection
  14         {
  15                 static Bus systemBus = null;
  16                 public static Bus System
  17                 {
  18                         get {
  19                                 if (systemBus == null) {
  20                                         try {
  21                                                 if (Address.StarterBusType == "system")
  22                                                         systemBus = Starter;
  23                                                 else
  24                                                         systemBus = Bus.Open (Address.System);
  25                                         } catch (Exception e) {
  26                                                 throw new Exception ("Unable to open the system message bus.", e);
  27                                         }
  28                                 }
  29
  30                                 return systemBus;
  31                         }
  32                 }
  33
  34                 static Bus sessionBus = null;
  35                 public static Bus Session
  36                 {
  37                         get {
  38                                 if (sessionBus == null) {
  39                                         try {
  40                                                 if (Address.StarterBusType == "session")
  41                                                         sessionBus = Starter;
  42                                                 else
  43                                                         sessionBus = Bus.Open (Address.Session);
  44                                         } catch (Exception e) {
  45                                                 throw new Exception ("Unable to open the session message bus.", e);
  46                                         }
  47                                 }
  48
  49                                 return sessionBus;
  50                         }
  51                 }
  52
  53                 //TODO: parsing of starter bus type, or maybe do this another way
  54                 static Bus starterBus = null;
  55                 public static Bus Starter
  56                 {
  57                         get {
  58                                 if (starterBus == null) {
  59                                         try {
  60                                                 starterBus = Bus.Open (Address.Starter);
  61                                         } catch (Exception e) {
  62                                                 throw new Exception ("Unable to open the starter message bus.", e);
  63                                         }
  64                                 }
  65
  66                                 return starterBus;
  67                         }
  68                 }
  69
  70                 //public static readonly Bus Session = null;
  71
  72                 //TODO: use the guid, not the whole address string
  73                 //TODO: consider what happens when a connection has been closed
  74                 static Dictionary<string,Bus> buses = new Dictionary<string,Bus> ();
  75
  76                 //public static Connection Open (string address)
  77                 public static new Bus Open (string address)
  78                 {
  79                         if (address == null)
  80                                 throw new ArgumentNullException ("address");
  81
  82                         if (buses.ContainsKey (address))
  83                                 return buses[address];
  84
  85                         Bus bus = new Bus (address);
  86                         buses[address] = bus;
  87
  88                         return bus;
  89                 }
  90
  91                 IBus bus;
  92
  93                 static readonly string DBusName = "org.freedesktop.DBus";
  94                 static readonly ObjectPath DBusPath = new ObjectPath ("/org/freedesktop/DBus");
  95
  96                 public Bus (string address) : base (address)
  97                 {
  98                         bus = GetObject<IBus> (DBusName, DBusPath);
  99                         Register ();
 100                 }
 101
 102                 public Bus (Transport trans) : base (trans)
 103                 {
 104                         Authenticate();
 105
 106                         bus = GetObject<IBus> (DBusName, DBusPath);
 107                         Register ();
 108                 }
 109
 110                 //should this be public?
 111                 //as long as Bus subclasses Connection, having a Register with a completely different meaning is bad
 112                 void Register ()
 113                 {
 114                         if (unique_name != null)
 115                                 throw new Exception ("Bus already has a unique name");
 116
 117                         unique_name = bus.Hello ();
 118                 }
 119
 120                 public string GetUnixUserName (string name)
 121                 {
 122                         return bus.GetConnectionUnixUserName (name);
 123                 }
 124
 125                 public ulong GetUnixUser (string name)
 126                 {
 127                         return bus.GetConnectionUnixUser (name);
 128                 }
 129
 130                 public string GetCert (string name)
 131                 {
 132                         return bus.GetConnectionCert (name);
 133                 }
 134
 135                 public string GetCertFingerprint (string name)
 136                 {
 137                         return bus.GetConnectionCertFingerprint (name);
 138                 }
 139
 140                 public RequestNameReply RequestName (string name)
 141                 {
 142                         return RequestName (name, NameFlag.None);
 143                 }
 144
 145                 public RequestNameReply RequestName (string name, NameFlag flags)
 146                 {
 147                         return bus.RequestName (name, flags);
 148                 }
 149
 150                 public ReleaseNameReply ReleaseName (string name)
 151                 {
 152                         return bus.ReleaseName (name);
 153                 }
 154
 155                 public bool NameHasOwner (string name)
 156                 {
 157                         return bus.NameHasOwner (name);
 158                 }
 159
 160                 public StartReply StartServiceByName (string name)
 161                 {
 162                         return StartServiceByName (name, 0);
 163                 }
 164
 165                 public StartReply StartServiceByName (string name, uint flags)
 166                 {
 167                         return bus.StartServiceByName (name, flags);
 168                 }
 169
 170                 internal protected override void AddMatch (string rule)
 171                 {
 172                         bus.AddMatch (rule);
 173                 }
 174
 175                 internal protected override void RemoveMatch (string rule)
 176                 {
 177                         bus.RemoveMatch (rule);
 178                 }
 179
 180                 string unique_name = null;
 181                 public string UniqueName
 182                 {
 183                         get {
 184                                 return unique_name;
 185                         } set {
 186                                 if (unique_name != null)
 187                                         throw new Exception ("Unique name can only be set once");
 188                                 unique_name = value;
 189                         }
 190                 }
 191         }
 192 }