Digimer: Created page with '{{dbtut_header}} Usage: use Net::DBus; my $bus=Net::DBus->find; my $service=$bus->get_service("org.freedesktop.DBus"); my $object=$service->get_object("/org…'

2009-10-12T03:01:03Z

Created page with '{{dbtut_header}} Usage: <source lang="perl"> use Net::DBus; my $bus=Net::DBus->find; my $service=$bus->get_service("org.freedesktop.DBus"); my $object=$service->get_object("/org…'

Páàjì titun

{{dbtut_header}}

Usage:
<source lang="perl">
use Net::DBus;
my $bus=Net::DBus->find;
my $service=$bus->get_service("org.freedesktop.DBus");
my $object=$service->get_object("/org/freedesktop/DBus");
</source>
 

= new =

Usage:
<source lang="perl">
my $object_path="/path/to/SomeObject";
my $interface=""; # Optional interface needed when a given object name is
# duplicated on multiple interfaces within the object.
my $object=Net::DBus::RemoteObject->new($service, $object_path[, $interface]);
</source>

This creates a handle to a remote '$object' at the given '$object_path' published on the message bus by the given '$service'. When more than one interface is available under the '$service', you may want to specify which '$interface' to use. This is required when the given '$object_path' exists on two or more interfaces.

This should not be directly called. Instead, it is preferable to use the [[Net::DBus::RemoteService Methods#get_object|get_object]] call as this will cache handles to remote objects, preventing unecessary introspection data lookups.

= as_interface =

Usage:
<source lang="perl">my $object=$object->as_interface($interface);</source>

This re-casts the object to the specified '$interface'. This is only needed when the original '$object' name is available on two or more interfaces or when the remote object does not support introspection data lookups.

= get_service =

Usage:
<source lang="perl">my $service=$object->get_service;</source>

This gets a handle to the remote '$service' that the remote '$object' is published under.

= get_object_path =

<source lang="perl">my $path=$object->get_object_path;</source>

The returns the remote $object's '$path' from within the service.

= get_child_object =

Usage:
<source lang="perl">
my $subpath="/ChildObject"; # This is RELATIVE to the parent's path, which is
# prepended to this value.
my $interface=""; # Optional, immediately casts the object to the
# specified interface.
my $child_object=$object->get_child_object($subpath, [$interface]);
</source>

This returns a handle to the '$child_object' at the specified '$subpath'. This '$subpath' is appended onto the parent object's path! So, if the parent object's path is '/path/to/SomeObject' and you set '$subpath' to '/ChildObject', the full path will be '/path/to/SomeObject/ChildObject'. The interface can be defined if you want to cast the child object to the specified interface immediately.

= connect_to_signal =

Usage:
<source lang="perl">
my $name="SomeSignal";
my $coderef=\&some_subroutine;
$object->connect_to_signal($name, $coderef);
</source>

This creates a callback attached to the remote method. When the signal with the given '$name' is emitted, the referenced subroutine will be called with the arguments from the signal being passed into it.
{{footer}}

Net::DBus::RemoteObject Methods - Revision history

Digimer: Created page with '{{dbtut_header}} Usage: use Net::DBus; my $bus=Net::DBus->find; my $service=$bus->get_service("org.freedesktop.DBus"); my $object=$service->get_object("/org…'