Net::DBus::RemoteObjecUser)Contributed Perl DocumenNet::DBus::RemoteObject(3p)



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

       my $object = $object->get_child_object($subpath, [$interface])
           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.

AUTHOR
       Daniel Berrange <dan@berrange.com>

COPYRIGHT
       Copright (C) 2004-2005, Daniel Berrange.

SEE ALSO
       Net::DBus::RemoteService, Net::DBus::Object



perl v5.12.2                      2008-02-20       Net::DBus::RemoteObject(3p)
