Net::DBus::RemoteObject - Access objects provided on the bus
SYNOPSIS
my $service = $bus->get_service("org.freedesktop.DBus");
my $object = $service->get_object("/org/freedesktop/DBus");
print "Names on the bus {\n";
foreach my $name (sort $object->ListNames) {
print " ", $name, "\n";
}
print "}\n";
DESCRIPTION
This module provides the API for accessing remote objects available
on the bus. It uses the autoloader to fake the presence of methods
based on the API of the remote object. There is also support for
setting callbacks against signals, and accessing properties of the
object.
METHODS
my $object = Net::DBus::RemoteObject->new($service, $object_path[, $interface]);
Creates a new handle to a remote object. The $service
parameter is an instance
of the Net::DBus::RemoteService method, and $object_path is the identifier of
an object exported by this service, for example "/org/freedesktop/DBus". For remote
objects which implement more than one interface it is possible to specify an optional
name of an interface as the third parameter. This is only really required, however, if
two interfaces in the object provide methods with the same name, since introspection
data can be used to automatically resolve the correct interface to call cases where
method names are unique. Rather than using this constructor directly, it is preferrable
to use the "get_object" method on Net::DBus::RemoteService, since this caches handles
to remote objects, eliminating unneccessary introspection data lookups.
my $object = $object->as_interface($interface);
Casts the object to a specific interface, returning a new instance of the
Net::DBus::RemoteObject specialized to the desired interface. It is only
neccessary to cast objects to a specific interface, if two interfaces
export methods or signals with the same name, or the remote object does not
support introspection.
my $service
= $object->get_service
Retrieves a handle for the remote service on which this object is
attached. The returned object is an instance of Net::DBus::RemoteService
my $path
= $object->get_object_path
Retrieves the unique path identifier for this object within the
service.
Retrieves a handle to a child of this object, identified
by the relative path $subpath
. The returned object
is an instance of "Net::DBus::RemoteObject". The optional
$interface parameter can be used to immediately cast
the object to a specific type.
$object->connect_to_signal($name, $coderef);
Connects a callback to a signal emitted by the object. The $name
parameter is the name of the signal within the object, and $coderef
is a reference to an anonymous subroutine. When the signal $name
is emitted by the remote object, the subroutine $coderef will be
invoked, and passed the parameters from the signal.
