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
|
/* Registrar.cs
*
* GNOME Do is the legal property of its developers. Please refer to the
* COPYRIGHT file distributed with this source distribution.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
using System;
#if USE_DBUS_SHARP
using DBus;
#else
using NDesk.DBus;
#endif
using org.freedesktop.DBus;
namespace Do.Platform.Linux.DBus
{
/// <summary>
/// Registrar is used for getting DBus-ready classes on and off the
/// session bus.
/// </summary>
static class Registrar
{
const string BusName = "org.gnome.Do";
const string BaseItemPath = "/org/gnome/Do";
const string ControllerItemPath = BaseItemPath + "/Controller";
static Registrar ()
{
try {
BusG.Init ();
} catch {
}
}
/// <summary>
/// Get an instace of T if it exists on the session bus.
/// Returns null if there is no such instance.
/// </summary>
/// <param name="objectPath">
/// A <see cref="System.String"/> containing the bus path of the instance.
/// </param>
/// <returns>
/// A <see cref="T"/> instance if it was found on the bus; null otherwise.
/// </returns>
public static T GetInstance<T> (string objectPath)
{
try {
if (!Bus.Session.NameHasOwner (BusName)) {
return default (T);
}
} catch {
return default (T);
}
return Bus.Session.GetObject<T> (BusName, new ObjectPath (objectPath));
}
/// <summary>
/// Register an instance of T on the session bus. Returns null if another
/// instance at the same path exists on the bus, or if registration fails
/// in another way.
/// </summary>
/// <param name="busItem">
/// A <see cref="T"/> instance to register on the bus.
/// </param>
/// <param name="objectPath">
/// A <see cref="System.String"/> containing the bus path being requested for
/// the object.
/// </param>
/// <returns>
/// A <see cref="T"/> instance registered on the bus if successful; null otherwise.
/// </returns>
public static T Register<T> (T busItem, string objectPath)
{
try {
Bus.Session.RequestName (BusName);
Bus.Session.Register (new ObjectPath (objectPath), busItem);
} catch {
return default (T);
}
return busItem;
}
/// <summary>
/// Get an IController instance registered on the session bus.
/// </summary>
/// <returns>
/// A <see cref="IController"/> instance if successful; null otherwise.
/// </returns>
public static IController GetControllerInstance ()
{
return GetInstance<IController> (ControllerItemPath);
}
/// <summary>
/// Register an IController instance on the session bus.
/// </summary>
/// <param name="commander">
/// A <see cref="IController"/> instance to register.
/// </param>
/// <returns>
/// A <see cref="IController"/> instance if registered successfully; null otherwise.
/// </returns>
public static IController RegisterController (IController commander)
{
return Register<IController> (commander, ControllerItemPath);
}
}
}
|