1 | =head1 NAME |
1 | =head1 NAME |
2 | |
2 | |
3 | AnyEvent::AIO - truly asynchronous file and directory I/O |
3 | AnyEvent::DBus - adapt Net::DBus to AnyEvent |
4 | |
4 | |
5 | =head1 SYNOPSIS |
5 | =head1 SYNOPSIS |
6 | |
6 | |
7 | use AnyEvent::DBus; |
7 | use AnyEvent::DBus; |
8 | |
8 | |
9 | # now use the Net::DBus API, preferably the non-blocking variants |
9 | # now use the Net::DBus API, preferably the non-blocking variants: |
|
|
10 | |
|
|
11 | use Net::DBus::Annotation qw(:call); |
|
|
12 | |
|
|
13 | $bus->get_object (...) |
|
|
14 | ->Method (dbus_call_async, $arg1, ...) |
|
|
15 | ->set_notify (sub { |
|
|
16 | my @data = $_[0]->get_result |
|
|
17 | ... |
|
|
18 | }); |
|
|
19 | |
|
|
20 | $bus->get_connection->send (...); |
10 | |
21 | |
11 | =head1 DESCRIPTION |
22 | =head1 DESCRIPTION |
12 | |
23 | |
13 | This module is an L<AnyEvent> user, you need to make sure that you use and |
24 | This module is an L<AnyEvent> user, you need to make sure that you use and |
14 | run a supported event loop. |
25 | run a supported event loop. |
… | |
… | |
18 | hacking L<Net::DBus::Reactor> so that all dbus connections created after |
29 | hacking L<Net::DBus::Reactor> so that all dbus connections created after |
19 | loading this module will automatically be managed by this module. |
30 | loading this module will automatically be managed by this module. |
20 | |
31 | |
21 | Note that a) a lot inside Net::DBus is still blocking b) if you call a |
32 | Note that a) a lot inside Net::DBus is still blocking b) if you call a |
22 | method that blocks, you again block your process (basically anything |
33 | method that blocks, you again block your process (basically anything |
23 | but calls to the Net::DBus::Binding::Connection objects block, but |
34 | but calls to the Net::DBus::Binding::Connection objects block, but see |
24 | see Net::DBus::Annoation, specifically dbus_call_async) and c) this |
35 | Net::DBus::Annoation, specifically dbus_call_async) c) the underlying |
|
|
36 | libdbus is often blocking itself, even with infinite timeouts and d) this |
25 | module only implements the minimum API required to make Net::DBus work - |
37 | module only implements the minimum API required to make Net::DBus work - |
26 | Net::DBus unfortunately has no nice hooking API. |
38 | Net::DBus unfortunately has no nice hooking API. |
27 | |
39 | |
28 | However, unlike L<Net::DBus::Reactor>, this module should be fully |
40 | However, unlike L<Net::DBus::Reactor>, this module should be fully |
29 | non-blocking as long as you only use non-blocking APIs (Net::DBus::Reactor |
41 | non-blocking as long as you only use non-blocking APIs (Net::DBus::Reactor |
30 | blocks on writes). It should also be faster, but Net::DBus is such a |
42 | blocks on writes). It should also be faster, but Net::DBus is such a |
31 | morass os unneeded method calls that speed won't matter much... |
43 | morass so unneeded method calls that speed won't matter much... |
32 | |
44 | |
33 | =head2 EXAMPLE |
45 | =head2 EXAMPLE |
34 | |
46 | |
35 | Here is a simple example. Both work with AnyEvent::DBus and do the same |
47 | Here is a simple example. Both work with AnyEvent::DBus and do the same |
36 | thing, but only the second is actually non-blocking. |
48 | thing, but only the second is actually non-blocking. |
… | |
… | |
78 | |
90 | |
79 | use AnyEvent (); |
91 | use AnyEvent (); |
80 | use Net::DBus (); |
92 | use Net::DBus (); |
81 | use Net::DBus::Binding::Watch (); |
93 | use Net::DBus::Binding::Watch (); |
82 | |
94 | |
83 | our $VERSION = '0.1'; |
95 | our $VERSION = '0.3'; |
84 | |
96 | |
85 | # yup, Net::DBus checks by using exists on %INC... |
97 | # yup, Net::DBus checks by using exists on %INC... |
86 | $INC{'Net/DBus/Reactor.pm'} = undef; |
98 | $INC{'Net/DBus/Reactor.pm'} = undef; |
87 | |
99 | |
88 | # claim we are the main reactor mainloop |
100 | # claim we are the main reactor mainloop |
… | |
… | |
105 | |
117 | |
106 | $f & Net::DBus::Binding::Watch::READABLE () |
118 | $f & Net::DBus::Binding::Watch::READABLE () |
107 | and |
119 | and |
108 | $O{$id}[0] = $on && AE::io $fd, 0, sub { |
120 | $O{$id}[0] = $on && AE::io $fd, 0, sub { |
109 | $w->handle (Net::DBus::Binding::Watch::READABLE ()); |
121 | $w->handle (Net::DBus::Binding::Watch::READABLE ()); |
110 | $con->dispatch; # wtf., we tell it data is ready, but have to call dispatch ourselves??? |
122 | $con->dispatch; |
111 | }; |
123 | }; |
112 | |
124 | |
113 | $f & Net::DBus::Binding::Watch::WRITABLE () |
125 | $f & Net::DBus::Binding::Watch::WRITABLE () |
114 | and |
126 | and |
115 | $O{$id}[1] = $on && AE::io $fd, 1, sub { |
127 | $O{$id}[1] = $on && AE::io $fd, 1, sub { |
116 | $w->handle (Net::DBus::Binding::Watch::WRITABLE ()); |
128 | $w->handle (Net::DBus::Binding::Watch::WRITABLE ()); |
117 | # calling flush, as NEt::DBus::Reactor does, is blocking :/ |
129 | $con->dispatch; |
118 | }; |
130 | }; |
119 | } |
131 | } |
120 | |
132 | |
121 | sub io_on { |
133 | sub io_on { |
122 | my ($con, $w) = @_; |
134 | my ($con, $w) = @_; |
… | |
… | |
131 | my ($con, $w) = @_; |
143 | my ($con, $w) = @_; |
132 | |
144 | |
133 | my $id = $w->get_data; |
145 | my $id = $w->get_data; |
134 | my $i = $w->get_interval * 0.001; |
146 | my $i = $w->get_interval * 0.001; |
135 | |
147 | |
136 | $O{$id} = $w->is_enabled && AE::timer $i, $i, sub { $w->handle }; |
148 | $O{$id} = $w->is_enabled && AE::timer $i, $i, sub { |
|
|
149 | $w->handle; |
|
|
150 | $con->dispatch; |
|
|
151 | }; |
137 | } |
152 | } |
138 | |
153 | |
139 | sub timeout_on { |
154 | sub timeout_on { |
140 | my ($con, $w) = @_; |
155 | my ($con, $w) = @_; |
141 | my $id = ++$I; |
156 | my $id = ++$I; |
… | |
… | |
146 | |
161 | |
147 | sub manage { |
162 | sub manage { |
148 | my (undef, $con) = @_; |
163 | my (undef, $con) = @_; |
149 | |
164 | |
150 | $con->set_watch_callbacks (\&io_on, \&watch_off, \&io_toggle); |
165 | $con->set_watch_callbacks (\&io_on, \&watch_off, \&io_toggle); |
|
|
166 | # if $con->can ("set_watch_callbacks"); |
|
|
167 | |
151 | $con->set_timeout_callbacks (\&timeout_on, \&watch_off, \&timeout_toggle); |
168 | $con->set_timeout_callbacks (\&timeout_on, \&watch_off, \&timeout_toggle); |
|
|
169 | # if $con->can ("set_timeout_callbacks"); |
|
|
170 | |
|
|
171 | $con->dispatch; # for good measure |
152 | } |
172 | } |
153 | |
173 | |
154 | =head1 SEE ALSO |
174 | =head1 SEE ALSO |
155 | |
175 | |
156 | L<AnyEvent>, L<Net::DBus>. |
176 | L<AnyEvent>, L<Net::DBus>. |