Class: DBus::Service

Inherits:
Object
  • Object
show all
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

Instance Method Summary collapse

Constructor Details

#initialize(name, bus) ⇒ Service

Create a new service with a given name on a given bus.



31
32
33
34
 
# File 'lib/dbus/bus.rb', line 31

def initialize(name, bus)
  @name, @bus = name, bus
  @root = Node.new("/")
end

Instance Attribute Details

#bus ⇒ Object (readonly)

The bus the service is running on.



26
27
28
 
# File 'lib/dbus/bus.rb', line 26

def bus
  @bus
end

#name ⇒ Object (readonly)

The service name.



24
25
26
 
# File 'lib/dbus/bus.rb', line 24

def name
  @name
end

#root ⇒ Object (readonly)

The service root (FIXME).



28
29
30
 
# File 'lib/dbus/bus.rb', line 28

def root
  @root
end

Instance Method Details

#exists? ⇒ Boolean

Determine whether the service name already exists.

Returns:

  • (Boolean) 


37
38
39
 
# File 'lib/dbus/bus.rb', line 37

def exists?
  bus.proxy.ListNames[0].member?(@name)
end

#export(obj) ⇒ Object

Export an object obj (an DBus::Object subclass instance).



63
64
65
66
 
# File 'lib/dbus/bus.rb', line 63

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.



86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
 
# File 'lib/dbus/bus.rb', line 86

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).



43
44
45
46
47
48
49
50
 
# File 'lib/dbus/bus.rb', line 43

def introspect
  if block_given?
    raise NotImplementedError
  else
    rec_introspect(@root, "/")
  end
  self
end

#object(path) ⇒ ProxyObject

Retrieves an object at the given path.

Returns:



54
55
56
57
58
59
60
 
# File 'lib/dbus/bus.rb', line 54

def object(path)
  node = get_node(path, true)
  if node.object.nil?
    node.object = ProxyObject.new(@bus, @name, path)
  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.

Raises:

  • (ArgumentError) 


71
72
73
74
75
76
77
78
79
80
81
82
 
# File 'lib/dbus/bus.rb', line 71

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)
end