NAME¶
Net::DBus::GLib - Perl extension for the DBus GLib bindings
SYNOPSIS¶
####### Attaching to the bus ###########
use Net::DBus::GLib;
# Find the most appropriate bus
my $bus = Net::DBus::GLib->find;
# ... or explicitly go for the session bus
my $bus = Net::DBus::GLib->session;
# .... or explicitly go for the system bus
my $bus = Net::DBus::GLib->system
DESCRIPTION¶
Net::DBus::GLib provides an extension to the Net::DBus module allowing
integration with the GLib mainloop. To integrate with the main loop, simply
get a connection to the bus via the methods in Net::DBus::GLib rather than the
usual Net::DBus module. That's it - every other API remains the same.
EXAMPLE¶
As an example service using the GLib main loop, assuming that SomeObject
inherits from Net::DBus::Service
my $bus = Net::DBus::GLib->session();
my $service = $bus->export_service("org.designfu.SampleService");
my $object = SomeObject->new($service);
Glib::MainLoop->new()->run();
And as an example client
my $bus = Net::DBus::GLib->session();
my $service = $bus->get_service("org.designfu.SampleService");
my $object = $service->get_object("/SomeObject");
my $list = $object->HelloWorld("Hello from example-client.pl!");
METHODS¶
- my $bus = Net::DBus::GLib->find(%params);
- Search for the most appropriate bus to connect to and return a connection
to it. For details of the heuristics used, consult the method of the same
name in "Net::DBus". The
%params hash may contain an additional entry with
a name of "context". This can be a
reference to an instance of the
"Glib::MainContext" object; if omitted,
the default GLib context will be used.
- my $bus = Net::DBus::GLib->system(%params);
- Return a handle for the system message bus. For further details on this
method, consult to the method of the same name in Net::DBus. The
%params hash may contain an additional entry with
a name of "context". This can be a
reference to an instance of the
"Glib::MainContext" object; if omitted,
the default GLib context will be used.
- my $bus = Net::DBus::GLib->session(%params);
- Return a handle for the session message bus. For further details on this
method, consult to the method of the same name in Net::DBus. The
%params hash may contain an additional entry with
a name of "context". This can be a
reference to an instance of the
"Glib::MainContext" object; if omitted,
the default GLib context will be used.
AUTHOR¶
Daniel Berrange <dan@berrange.com>
COPYRIGHT¶
Copyright 2006-2008 by Daniel Berrange