… | |
… | |
71 | my %CO_SLOT; # number of open connections, and wait queue, per host |
71 | my %CO_SLOT; # number of open connections, and wait queue, per host |
72 | |
72 | |
73 | =item http_get $url, key => value..., $cb->($data, $headers) |
73 | =item http_get $url, key => value..., $cb->($data, $headers) |
74 | |
74 | |
75 | Executes an HTTP-GET request. See the http_request function for details on |
75 | Executes an HTTP-GET request. See the http_request function for details on |
76 | additional parameters. |
76 | additional parameters and the return value. |
77 | |
77 | |
78 | =item http_head $url, key => value..., $cb->($data, $headers) |
78 | =item http_head $url, key => value..., $cb->($data, $headers) |
79 | |
79 | |
80 | Executes an HTTP-HEAD request. See the http_request function for details on |
80 | Executes an HTTP-HEAD request. See the http_request function for details |
81 | additional parameters. |
81 | on additional parameters and the return value. |
82 | |
82 | |
83 | =item http_post $url, $body, key => value..., $cb->($data, $headers) |
83 | =item http_post $url, $body, key => value..., $cb->($data, $headers) |
84 | |
84 | |
85 | Executes an HTTP-POST request with a request body of C<$body>. See the |
85 | Executes an HTTP-POST request with a request body of C<$body>. See the |
86 | http_request function for details on additional parameters. |
86 | http_request function for details on additional parameters and the return |
|
|
87 | value. |
87 | |
88 | |
88 | =item http_request $method => $url, key => value..., $cb->($data, $headers) |
89 | =item http_request $method => $url, key => value..., $cb->($data, $headers) |
89 | |
90 | |
90 | Executes a HTTP request of type C<$method> (e.g. C<GET>, C<POST>). The URL |
91 | Executes a HTTP request of type C<$method> (e.g. C<GET>, C<POST>). The URL |
91 | must be an absolute http or https URL. |
92 | must be an absolute http or https URL. |
|
|
93 | |
|
|
94 | When called in void context, nothing is returned. In other contexts, |
|
|
95 | C<http_request> returns a "cancellation guard" - you have to keep the |
|
|
96 | object at least alive until the callback get called. If the object gets |
|
|
97 | destroyed before the callbakc is called, the request will be cancelled. |
92 | |
98 | |
93 | The callback will be called with the response data as first argument |
99 | The callback will be called with the response data as first argument |
94 | (or C<undef> if it wasn't available due to errors), and a hash-ref with |
100 | (or C<undef> if it wasn't available due to errors), and a hash-ref with |
95 | response headers as second argument. |
101 | response headers as second argument. |
96 | |
102 | |
… | |
… | |
188 | my ($body, $hdr) = @_; |
194 | my ($body, $hdr) = @_; |
189 | use Data::Dumper; |
195 | use Data::Dumper; |
190 | print Dumper $hdr; |
196 | print Dumper $hdr; |
191 | } |
197 | } |
192 | ; |
198 | ; |
|
|
199 | |
|
|
200 | Example: make another simple HTTP GET request, but immediately try to |
|
|
201 | cancel it. |
|
|
202 | |
|
|
203 | my $request = http_request GET => "http://www.nethype.de/", sub { |
|
|
204 | my ($body, $hdr) = @_; |
|
|
205 | print "$body\n"; |
|
|
206 | }; |
|
|
207 | |
|
|
208 | undef $request; |
193 | |
209 | |
194 | =cut |
210 | =cut |
195 | |
211 | |
196 | sub _slot_schedule; |
212 | sub _slot_schedule; |
197 | sub _slot_schedule($) { |
213 | sub _slot_schedule($) { |