Class: DBus::Service
- Inherits:
-
Object
- Object
- DBus::Service
- Defined in:
- lib/dbus/bus.rb
Overview
This represents a remote service. It should not be instantiated directly Use Bus::service()
Instance Attribute Summary collapse
-
#bus ⇒ Object
readonly
The bus the service is running on.
-
#name ⇒ Object
readonly
The service name.
-
#root ⇒ Object
readonly
The service root (FIXME).
Instance Method Summary collapse
-
#[](path) ⇒ ProxyObject
Retrieves an object at the given path.
-
#exists? ⇒ Boolean
Determine whether the service name already exists.
-
#export(obj) ⇒ Object
Export an object obj (an DBus::Object subclass instance).
-
#get_node(path, create = false) ⇒ Object
Get the object node corresponding to the given path.
-
#initialize(name, bus) ⇒ Service
constructor
Create a new service with a given name on a given bus.
-
#introspect ⇒ Object
Perform an introspection on all the objects on the service (starting recursively from the root).
-
#object(path, api: ApiOptions::A0) ⇒ ProxyObject
Retrieves an object at the given path whose methods always return an array.
-
#unexport(obj) ⇒ Object
Undo exporting an object obj.
Constructor Details
Instance Attribute Details
#bus ⇒ Object (readonly)
The bus the service is running on.
25 26 27 |
# File 'lib/dbus/bus.rb', line 25 def bus @bus end |
#name ⇒ Object (readonly)
The service name.
23 24 25 |
# File 'lib/dbus/bus.rb', line 23 def name @name end |
Instance Method Details
#[](path) ⇒ ProxyObject
Retrieves an object at the given path.
53 54 55 |
# File 'lib/dbus/bus.rb', line 53 def [](path) object(path, api: ApiOptions::A1) end |
#exists? ⇒ Boolean
Determine whether the service name already exists.
36 37 38 |
# File 'lib/dbus/bus.rb', line 36 def exists? bus.proxy.ListNames[0].member?(@name) end |
#export(obj) ⇒ Object
Export an object obj (an DBus::Object subclass instance).
72 73 74 75 |
# File 'lib/dbus/bus.rb', line 72 def export(obj) obj.service = self get_node(obj.path, true).object = obj end |
#get_node(path, create = false) ⇒ Object
Get the object node corresponding to the given path. if create is true, the the nodes in the path are created if they do not already exist.
95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 |
# File 'lib/dbus/bus.rb', line 95 def get_node(path, create = false) n = @root path.sub(/^\//, "").split("/").each do |elem| if not n[elem] if not create return nil else n[elem] = Node.new(elem) end end n = n[elem] end if n.nil? DBus.logger.debug "Warning, unknown object #{path}" end n end |
#introspect ⇒ Object
Perform an introspection on all the objects on the service (starting recursively from the root).
42 43 44 45 46 47 48 49 |
# File 'lib/dbus/bus.rb', line 42 def introspect if block_given? raise NotImplementedError else rec_introspect(@root, "/") end self end |
#object(path, api: ApiOptions::A0) ⇒ ProxyObject
Retrieves an object at the given path whose methods always return an array.
60 61 62 63 64 65 66 67 68 69 |
# File 'lib/dbus/bus.rb', line 60 def object(path, api: ApiOptions::A0) node = get_node(path, _create = true) if node.object.nil? || node.object.api != api node.object = ProxyObject.new( @bus, @name, path, api: api ) end node.object end |
#unexport(obj) ⇒ Object
Undo exporting an object obj. Raises ArgumentError if it is not a DBus::Object. Returns the object, or false if obj was not exported.
80 81 82 83 84 85 86 87 88 89 90 91 |
# File 'lib/dbus/bus.rb', line 80 def unexport(obj) raise ArgumentError.new("DBus::Service#unexport() expects a DBus::Object argument") unless obj.kind_of?(DBus::Object) return false unless obj.path pathSep = obj.path.rindex("/") #last path seperator parent_path = obj.path[1..pathSep-1] node_name = obj.path[pathSep+1..-1] parent_node = get_node(parent_path, false) return false unless parent_node obj.service = nil parent_node.delete(node_name).object end |