[ViewVC] Diff of: cvs/AnyEvent-HTTP/HTTP.pm

Comparing AnyEvent-HTTP/HTTP.pm (file contents):
Revision 1.71 by root, Fri Dec 31 20:50:58 2010 UTC vs.
Revision 1.90 by root, Mon Jan 3 00:41:25 2011 UTC

…		…
36		36
37	=cut	37	=cut
38		38
39	package AnyEvent::HTTP;	39	package AnyEvent::HTTP;
40		40
41	use strict;	41	use common::sense;
42	no warnings;
43		42
44	use Errno ();	43	use Errno ();
45		44
46	use AnyEvent 5.0 ();	45	use AnyEvent 5.0 ();
47	use AnyEvent::Util ();	46	use AnyEvent::Util ();
…		…
58	our $MAX_PERSISTENT = 8;	57	our $MAX_PERSISTENT = 8;
59	our $PERSISTENT_TIMEOUT = 2;	58	our $PERSISTENT_TIMEOUT = 2;
60	our $TIMEOUT = 300;	59	our $TIMEOUT = 300;
61		60
62	# changing these is evil	61	# changing these is evil
63	our $MAX_PERSISTENT_PER_HOST = 0;	62	our $MAX_PERSISTENT_PER_HOST = 2;
64	our $MAX_PER_HOST = 4;	63	our $MAX_PER_HOST = 4;
65		64
66	our $PROXY;	65	our $PROXY;
67	our $ACTIVE = 0;	66	our $ACTIVE = 0;
68		67
…		…
122		121
123	If the server sends a header multiple times, then their contents will be	122	If the server sends a header multiple times, then their contents will be
124	joined together with a comma (C<,>), as per the HTTP spec.	123	joined together with a comma (C<,>), as per the HTTP spec.
125		124
126	If an internal error occurs, such as not being able to resolve a hostname,	125	If an internal error occurs, such as not being able to resolve a hostname,
127	then C<$data> will be C<undef>, C<< $headers->{Status} >> will be C<59x>	126	then C<$data> will be C<undef>, C<< $headers->{Status} >> will be
128	(usually C<599>) and the C<Reason> pseudo-header will contain an error	127	C<590>-C<599> and the C<Reason> pseudo-header will contain an error
129	message.	128	message. Currently the following status codes are used:
		129
		130	=over 4
		131
		132	=item 595 - errors during connection etsbalishment, proxy handshake.
		133
		134	=item 596 - errors during TLS negotiation, request sending and header processing.
		135
		136	=item 597 - errors during body receiving or processing.
		137
		138	=item 598 - user aborted request via C<on_header> or C<on_body>.
		139
		140	=item 599 - other, usually nonretryable, errors (garbled URL etc.).
		141
		142	=back
130		143
131	A typical callback might look like this:	144	A typical callback might look like this:
132		145
133	sub {	146	sub {
134	my ($body, $hdr) = @_;	147	my ($body, $hdr) = @_;
…		…
156	C<Host:>, C<Content-Length:>, C<Connection:> and C<Cookie:> headers and	169	C<Host:>, C<Content-Length:>, C<Connection:> and C<Cookie:> headers and
157	will provide defaults at least for C<TE:>, C<Referer:> and C<User-Agent:>	170	will provide defaults at least for C<TE:>, C<Referer:> and C<User-Agent:>
158	(this can be suppressed by using C<undef> for these headers in which case	171	(this can be suppressed by using C<undef> for these headers in which case
159	they won't be sent at all).	172	they won't be sent at all).
160		173
		174	You really should provide your own C<User-Agent:> header value that is
		175	appropriate for your program - I wouldn't be surprised if the default
		176	AnyEvent string gets blocked by webservers sooner or later.
		177
161	=item timeout => $seconds	178	=item timeout => $seconds
162		179
163	The time-out to use for various stages - each connect attempt will reset	180	The time-out to use for various stages - each connect attempt will reset
164	the timeout, as will read or write activity, i.e. this is not an overall	181	the timeout, as will read or write activity, i.e. this is not an overall
165	timeout.	182	timeout.
…		…
182	=item cookie_jar => $hash_ref	199	=item cookie_jar => $hash_ref
183		200
184	Passing this parameter enables (simplified) cookie-processing, loosely	201	Passing this parameter enables (simplified) cookie-processing, loosely
185	based on the original netscape specification.	202	based on the original netscape specification.
186		203
187	The C<$hash_ref> must be an (initially empty) hash reference which will	204	The C<$hash_ref> must be an (initially empty) hash reference which
188	get updated automatically. It is possible to save the cookie jar to	205	will get updated automatically. It is possible to save the cookie jar
189	persistent storage with something like JSON or Storable, but this is not	206	to persistent storage with something like JSON or Storable - see the
190	recommended, as session-only cookies might survive longer than expected.	207	C<AnyEvent::HTTP::cookie_jar_expire> function if you wish to remove
		208	expired or session-only cookies, and also for documentation on the format
		209	of the cookie jar.
191		210
192	Note that this cookie implementation is not meant to be complete. If	211	Note that this cookie implementation is not meant to be complete. If
193	you want complete cookie management you have to do that on your	212	you want complete cookie management you have to do that on your
194	own. C<cookie_jar> is meant as a quick fix to get some cookie-using sites	213	own. C<cookie_jar> is meant as a quick fix to get most cookie-using sites
195	working. Cookies are a privacy disaster, do not use them unless required	214	working. Cookies are a privacy disaster, do not use them unless required
196	to.	215	to.
197		216
198	When cookie processing is enabled, the C<Cookie:> and C<Set-Cookie:>	217	When cookie processing is enabled, the C<Cookie:> and C<Set-Cookie:>
199	headers will be set and handled by this module, otherwise they will be	218	headers will be set and handled by this module, otherwise they will be
…		…
314	Example: do a HTTP HEAD request on https://www.google.com/, use a	333	Example: do a HTTP HEAD request on https://www.google.com/, use a
315	timeout of 30 seconds.	334	timeout of 30 seconds.
316		335
317	http_request	336	http_request
318	GET => "https://www.google.com",	337	GET => "https://www.google.com",
		338	headers => { "user-agent" => "MySearchClient 1.0" },
319	timeout => 30,	339	timeout => 30,
320	sub {	340	sub {
321	my ($body, $hdr) = @_;	341	my ($body, $hdr) = @_;
322	use Data::Dumper;	342	use Data::Dumper;
323	print Dumper $hdr;	343	print Dumper $hdr;
…		…
364	push @{ $CO_SLOT{$_[0]}[1] }, $_[1];	384	push @{ $CO_SLOT{$_[0]}[1] }, $_[1];
365		385
366	_slot_schedule $_[0];	386	_slot_schedule $_[0];
367	}	387	}
368		388
		389	#############################################################################
		390
		391	# expire cookies
		392	sub cookie_jar_expire($;$) {
		393	my ($jar, $session_end) = @_;
		394
		395	%$jar = () if $jar->{version} != 1;
		396
		397	my $anow = AE::now;
		398
		399	while (my ($chost, $paths) = each %$jar) {
		400	next unless ref $paths;
		401
		402	while (my ($cpath, $cookies) = each %$paths) {
		403	while (my ($cookie, $kv) = each %$cookies) {
		404	if (exists $kv->{_expires}) {
		405	delete $cookies->{$cookie}
		406	if $anow > $kv->{_expires};
		407	} elsif ($session_end) {
		408	delete $cookies->{$cookie};
		409	}
		410	}
		411
		412	delete $paths->{$cpath}
		413	unless %$cookies;
		414	}
		415
		416	delete $jar->{$chost}
		417	unless %$paths;
		418	}
		419	}
		420
		421	# extract cookies from jar
369	sub cookie_jar_extract($$$$) {	422	sub cookie_jar_extract($$$$) {
370	my ($jar, $uscheme, $uhost, $upath) = @_;	423	my ($jar, $uscheme, $uhost, $upath) = @_;
371		424
372	%$jar = () if $jar->{version} != 1;	425	%$jar = () if $jar->{version} != 1;
373		426
…		…
388	next unless $cpath eq substr $upath, 0, length $cpath;	441	next unless $cpath eq substr $upath, 0, length $cpath;
389		442
390	while (my ($cookie, $kv) = each %$cookies) {	443	while (my ($cookie, $kv) = each %$cookies) {
391	next if $uscheme ne "https" && exists $kv->{secure};	444	next if $uscheme ne "https" && exists $kv->{secure};
392		445
393	if (exists $kv->{expires}) {	446	if (exists $kv->{_expires} and AE::now > $kv->{_expires}) {
394	if (AE::now > parse_date ($kv->{expires})) {
395	delete $cookies->{$cookie};	447	delete $cookies->{$cookie};
396	next;	448	next;
397	}
398	}	449	}
399		450
400	my $value = $kv->{value};	451	my $value = $kv->{value};
401		452
402	if ($value =~ /[=;,[:space:]]/) {	453	if ($value =~ /[=;,[:space:]]/) {
…		…
410	}	461	}
411		462
412	\@cookies	463	\@cookies
413	}	464	}
414		465
		466	# parse set_cookie header into jar
		467	sub cookie_jar_set_cookie($$$$) {
		468	my ($jar, $set_cookie, $uhost, $date) = @_;
		469
		470	my $anow = int AE::now;
		471	my $snow; # server-now
		472
		473	for ($set_cookie) {
		474	# parse NAME=VALUE
		475	my @kv;
		476
		477	# expires is not http-compliant in the original cookie-spec,
		478	# we support the official date format and some extensions
		479	while (
		480	m{
		481	\G\s*
		482	(?:
		483	expires \s=\s ([A-Z][a-z][a-z]+,\ [^,;]+)
		484	\| ([^=;,[:space:]]+) (?: \s=\s (?: "((?:[^\\"]+\|\\.))" \| ([^=;,[:space:]]) ) )?
		485	)
		486	}gcxsi
		487	) {
		488	my $name = $2;
		489	my $value = $4;
		490
		491	if (defined $1) {
		492	# expires
		493	$name = "expires";
		494	$value = $1;
		495	} elsif (defined $3) {
		496	# quoted
		497	$value = $3;
		498	$value =~ s/\\(.)/$1/gs;
		499	}
		500
		501	push @kv, lc $name, $value;
		502
		503	last unless /\G\s*;/gc;
		504	}
		505
		506	last unless @kv;
		507
		508	my $name = shift @kv;
		509	my %kv = (value => shift @kv, @kv);
		510
		511	if (exists $kv{"max-age"}) {
		512	$kv{_expires} = $anow + delete $kv{"max-age"};
		513	} elsif (exists $kv{expires}) {
		514	$snow \|\|= parse_date ($date) \|\| $anow;
		515	$kv{_expires} = $anow + (parse_date (delete $kv{expires}) - $snow);
		516	} else {
		517	delete $kv{_expires};
		518	}
		519
		520	my $cdom;
		521	my $cpath = (delete $kv{path}) \|\| "/";
		522
		523	if (exists $kv{domain}) {
		524	$cdom = delete $kv{domain};
		525
		526	$cdom =~ s/^\.?/./; # make sure it starts with a "."
		527
		528	next if $cdom =~ /\.$/;
		529
		530	# this is not rfc-like and not netscape-like. go figure.
		531	my $ndots = $cdom =~ y/.//;
		532	next if $ndots < ($cdom =~ /\.[^.][^.]\.[^.][^.]$/ ? 3 : 2);
		533	} else {
		534	$cdom = $uhost;
		535	}
		536
		537	# store it
		538	$jar->{version} = 1;
		539	$jar->{lc $cdom}{$cpath}{$name} = \%kv;
		540
		541	redo if /\G\s*,/gc;
		542	}
		543	}
		544
415	# continue to parse $_ for headers and place them into the arg	545	# continue to parse $_ for headers and place them into the arg
416	sub parse_hdr() {	546	sub parse_hdr() {
417	my %hdr;	547	my %hdr;
418		548
419	# things seen, not parsed:	549	# things seen, not parsed:
…		…
481	: return $cb->(undef, { @pseudo, Status => 599, Reason => "Only http and https URL schemes supported" });	611	: return $cb->(undef, { @pseudo, Status => 599, Reason => "Only http and https URL schemes supported" });
482		612
483	$uauthority =~ /^(?: .*\@ )? ([^\@:]+) (?: : (\d+) )?$/x	613	$uauthority =~ /^(?: .*\@ )? ([^\@:]+) (?: : (\d+) )?$/x
484	or return $cb->(undef, { @pseudo, Status => 599, Reason => "Unparsable URL" });	614	or return $cb->(undef, { @pseudo, Status => 599, Reason => "Unparsable URL" });
485		615
486	my $uhost = $1;	616	my $uhost = lc $1;
487	$uport = $2 if defined $2;	617	$uport = $2 if defined $2;
488		618
489	$hdr{host} = defined $2 ? "$uhost:$2" : "$uhost"	619	$hdr{host} = defined $2 ? "$uhost:$2" : "$uhost"
490	unless exists $hdr{host};	620	unless exists $hdr{host};
491		621
…		…
510	$rscheme = "http" unless defined $rscheme;	640	$rscheme = "http" unless defined $rscheme;
511		641
512	# don't support https requests over https-proxy transport,	642	# don't support https requests over https-proxy transport,
513	# can't be done with tls as spec'ed, unless you double-encrypt.	643	# can't be done with tls as spec'ed, unless you double-encrypt.
514	$rscheme = "http" if $uscheme eq "https" && $rscheme eq "https";	644	$rscheme = "http" if $uscheme eq "https" && $rscheme eq "https";
		645
		646	$rhost = lc $rhost;
		647	$rscheme = lc $rscheme;
515	} else {	648	} else {
516	($rhost, $rport, $rscheme, $rpath) = ($uhost, $uport, $uscheme, $upath);	649	($rhost, $rport, $rscheme, $rpath) = ($uhost, $uport, $uscheme, $upath);
517	}	650	}
518		651
519	# leave out fragment and query string, just a heuristic	652	# leave out fragment and query string, just a heuristic
…		…
521	$hdr{"user-agent"} = $USERAGENT unless exists $hdr{"user-agent"};	654	$hdr{"user-agent"} = $USERAGENT unless exists $hdr{"user-agent"};
522		655
523	$hdr{"content-length"} = length $arg{body}	656	$hdr{"content-length"} = length $arg{body}
524	if length $arg{body} \|\| $method ne "GET";	657	if length $arg{body} \|\| $method ne "GET";
525		658
526	$hdr{connection} = "close TE"; #1.1	659	my $idempotent = $method =~ /^(?:GET\|HEAD\|PUT\|DELETE\|OPTIONS\|TRACE)$/;
		660
		661	# default value for keepalive is true iff the request is for an idempotent method
		662	my $keepalive = exists $arg{keepalive}
		663	? $arg{keepalive}*1
		664	: $idempotent ? $PERSISTENT_TIMEOUT : 0;
		665
		666	$hdr{connection} = ($keepalive ? "" : "close ") . "Te"; #1.1
527	$hdr{te} = "trailers" unless exists $hdr{te}; #1.1	667	$hdr{te} = "trailers" unless exists $hdr{te}; #1.1
528		668
529	my %state = (connect_guard => 1);	669	my %state = (connect_guard => 1);
530		670
531	_get_slot $uhost, sub {	671	my $ae_error = 595; # connecting
532	$state{slot_guard} = shift;
533		672
		673	# handle actual, non-tunneled, request
		674	my $handle_actual_request = sub {
		675	$ae_error = 596; # request phase
		676
		677	$state{handle}->starttls ("connect") if $uscheme eq "https" && !exists $state{handle}{tls};
		678
		679	# send request
		680	$state{handle}->push_write (
		681	"$method $rpath HTTP/1.1\015\012"
		682	. (join "", map "\u$_: $hdr{$_}\015\012", grep defined $hdr{$_}, keys %hdr)
		683	. "\015\012"
		684	. (delete $arg{body})
		685	);
		686
		687	# return if error occured during push_write()
534	return unless $state{connect_guard};	688	return unless %state;
535		689
536	my $connect_cb = sub {	690	# reduce memory usage, save a kitten, also re-use it for the response headers.
537	$state{fh} = shift	691	%hdr = ();
		692
		693	# status line and headers
		694	$state{read_response} = sub {
		695	for ("$_[1]") {
		696	y/\015//d; # weed out any \015, as they show up in the weirdest of places.
		697
		698	/^HTTP\/0([0-9\.]+) \s+ ([0-9]{3}) (?: \s+ ([^\012]) )? \012/gxci
		699	or return (%state = (), $cb->(undef, { @pseudo, Status => 599, Reason => "Invalid server response" }));
		700
		701	# 100 Continue handling
		702	# should not happen as we don't send expect: 100-continue,
		703	# but we handle it just in case.
		704	# since we send the request body regardless, if we get an error
		705	# we are out of-sync, which we currently do NOT handle correctly.
		706	return $state{handle}->push_read (line => $qr_nlnl, $state{read_response})
		707	if $2 eq 100;
		708
		709	push @pseudo,
		710	HTTPVersion => $1,
		711	Status => $2,
		712	Reason => $3,
538	or do {	713	;
539	my $err = "$!";	714
		715	my $hdr = parse_hdr
		716	or return (%state = (), $cb->(undef, { @pseudo, Status => 599, Reason => "Garbled response headers" }));
		717
		718	%hdr = (%$hdr, @pseudo);
		719	}
		720
		721	# redirect handling
		722	# microsoft and other shitheads don't give a shit for following standards,
		723	# try to support some common forms of broken Location headers.
		724	if ($hdr{location} !~ /^(?: $ \| [^:\/?\#]+ : )/x) {
		725	$hdr{location} =~ s/^\.\/+//;
		726
		727	my $url = "$rscheme://$uhost:$uport";
		728
		729	unless ($hdr{location} =~ s/^\///) {
		730	$url .= $upath;
		731	$url =~ s/\/[^\/]*$//;
		732	}
		733
		734	$hdr{location} = "$url/$hdr{location}";
		735	}
		736
		737	my $redirect;
		738
		739	if ($recurse) {
		740	my $status = $hdr{Status};
		741
		742	# industry standard is to redirect POST as GET for
		743	# 301, 302 and 303, in contrast to HTTP/1.0 and 1.1.
		744	# also, the UA should ask the user for 301 and 307 and POST,
		745	# industry standard seems to be to simply follow.
		746	# we go with the industry standard.
		747	if ($status == 301 or $status == 302 or $status == 303) {
		748	# HTTP/1.1 is unclear on how to mutate the method
		749	$method = "GET" unless $method eq "HEAD";
		750	$redirect = 1;
		751	} elsif ($status == 307) {
		752	$redirect = 1;
		753	}
		754	}
		755
		756	my $finish = sub { # ($data, $err_status, $err_reason[, $keepalive])
		757	my $may_keep_alive = $_[3];
		758
		759	$state{handle}->destroy if $state{handle};
540	%state = ();	760	%state = ();
541	return $cb->(undef, { @pseudo, Status => 599, Reason => $err });	761
		762	if (defined $_[1]) {
		763	$hdr{OrigStatus} = $hdr{Status}; $hdr{Status} = $_[1];
		764	$hdr{OrigReason} = $hdr{Reason}; $hdr{Reason} = $_[2];
		765	}
		766
		767	# set-cookie processing
		768	if ($arg{cookie_jar}) {
		769	cookie_jar_set_cookie $arg{cookie_jar}, $hdr{"set-cookie"}, $uhost, $hdr{date};
		770	}
		771
		772	if ($redirect && exists $hdr{location}) {
		773	# we ignore any errors, as it is very common to receive
		774	# Content-Length != 0 but no actual body
		775	# we also access %hdr, as $_[1] might be an erro
		776	http_request (
		777	$method => $hdr{location},
		778	%arg,
		779	recurse => $recurse - 1,
		780	Redirect => [$_[0], \%hdr],
		781	$cb);
		782	} else {
		783	$cb->($_[0], \%hdr);
		784	}
		785	};
		786
		787	$ae_error = 597; # body phase
		788
		789	my $len = $hdr{"content-length"};
		790
		791	# body handling, many different code paths
		792	# - no body expected
		793	# - want_body_handle
		794	# - te chunked
		795	# - 2x length known (with or without on_body)
		796	# - 2x length not known (with or without on_body)
		797	if (!$redirect && $arg{on_header} && !$arg{on_header}(\%hdr)) {
		798	$finish->(undef, 598 => "Request cancelled by on_header");
		799	} elsif (
		800	$hdr{Status} =~ /^(?:1..\|204\|205\|304)$/
		801	or $method eq "HEAD"
		802	or (defined $len && $len == 0) # == 0, not !, because "0 " is true
		803	) {
		804	# no body
		805	$finish->("", undef, undef, 1);
		806
		807	} elsif (!$redirect && $arg{want_body_handle}) {
		808	$_[0]->on_eof (undef);
		809	$_[0]->on_error (undef);
		810	$_[0]->on_read (undef);
		811
		812	$finish->(delete $state{handle});
		813
		814	} elsif ($hdr{"transfer-encoding"} =~ /\bchunked\b/i) {
		815	my $cl = 0;
		816	my $body = undef;
		817	my $on_body = $arg{on_body} \|\| sub { $body .= shift; 1 };
		818
		819	$state{read_chunk} = sub {
		820	$_[1] =~ /^([0-9a-fA-F]+)/
		821	or $finish->(undef, $ae_error => "Garbled chunked transfer encoding");
		822
		823	my $len = hex $1;
		824
		825	if ($len) {
		826	$cl += $len;
		827
		828	$_[0]->push_read (chunk => $len, sub {
		829	$on_body->($_[1], \%hdr)
		830	or return $finish->(undef, 598 => "Request cancelled by on_body");
		831
		832	$_[0]->push_read (line => sub {
		833	length $_[1]
		834	and return $finish->(undef, $ae_error => "Garbled chunked transfer encoding");
		835	$_[0]->push_read (line => $state{read_chunk});
		836	});
		837	});
		838	} else {
		839	$hdr{"content-length"} \|\|= $cl;
		840
		841	$_[0]->push_read (line => $qr_nlnl, sub {
		842	if (length $_[1]) {
		843	for ("$_[1]") {
		844	y/\015//d; # weed out any \015, as they show up in the weirdest of places.
		845
		846	my $hdr = parse_hdr
		847	or return $finish->(undef, $ae_error => "Garbled response trailers");
		848
		849	%hdr = (%hdr, %$hdr);
		850	}
		851	}
		852
		853	$finish->($body, undef, undef, 1);
		854	});
		855	}
542	};	856	};
543		857
544	pop; # free memory, save a tree	858	$_[0]->push_read (line => $state{read_chunk});
545		859
		860	} elsif ($arg{on_body}) {
		861	if (defined $len) {
		862	$_[0]->on_read (sub {
		863	$len -= length $_[0]{rbuf};
		864
		865	$arg{on_body}(delete $_[0]{rbuf}, \%hdr)
		866	or return $finish->(undef, 598 => "Request cancelled by on_body");
		867
		868	$len > 0
		869	or $finish->("", undef, undef, 1);
		870	});
		871	} else {
		872	$_[0]->on_eof (sub {
		873	$finish->("");
		874	});
		875	$_[0]->on_read (sub {
		876	$arg{on_body}(delete $_[0]{rbuf}, \%hdr)
		877	or $finish->(undef, 598 => "Request cancelled by on_body");
		878	});
		879	}
		880	} else {
		881	$_[0]->on_eof (undef);
		882
		883	if (defined $len) {
		884	$_[0]->on_read (sub {
		885	$finish->((substr delete $_[0]{rbuf}, 0, $len, ""), undef, undef, 1)
		886	if $len <= length $_[0]{rbuf};
		887	});
		888	} else {
		889	$_[0]->on_error (sub {
		890	($! == Errno::EPIPE \|\| !$!)
		891	? $finish->(delete $_[0]{rbuf})
		892	: $finish->(undef, $ae_error => $_[2]);
		893	});
		894	$_[0]->on_read (sub { });
		895	}
		896	}
		897	};
		898
		899	$state{handle}->push_read (line => $qr_nlnl, $state{read_response});
		900	};
		901
		902	my $connect_cb = sub {
		903	$state{fh} = shift
		904	or do {
		905	my $err = "$!";
		906	%state = ();
		907	return $cb->(undef, { @pseudo, Status => $ae_error, Reason => $err });
		908	};
		909
546	return unless delete $state{connect_guard};	910	return unless delete $state{connect_guard};
547		911
548	# get handle	912	# get handle
549	$state{handle} = new AnyEvent::Handle	913	$state{handle} = new AnyEvent::Handle
550	fh => $state{fh},	914	fh => $state{fh},
551	peername => $rhost,	915	peername => $rhost,
552	tls_ctx => $arg{tls_ctx},	916	tls_ctx => $arg{tls_ctx},
553	# these need to be reconfigured on keepalive handles	917	# these need to be reconfigured on keepalive handles
554	timeout => $timeout,	918	timeout => $timeout,
555	on_error => sub {	919	on_error => sub {
556	%state = ();	920	%state = ();
557	$cb->(undef, { @pseudo, Status => 599, Reason => $_[2] });	921	$cb->(undef, { @pseudo, Status => $ae_error, Reason => $_[2] });
558	},	922	},
559	on_eof => sub {	923	on_eof => sub {
560	%state = ();	924	%state = ();
561	$cb->(undef, { @pseudo, Status => 599, Reason => "Unexpected end-of-file" });	925	$cb->(undef, { @pseudo, Status => $ae_error, Reason => "Unexpected end-of-file" });
562	},	926	},
563	;	927	;
564		928
565	# limit the number of persistent connections	929	# limit the number of persistent connections
566	# keepalive not yet supported	930	# keepalive not yet supported
567	# if ($KA_COUNT{$_[1]} < $MAX_PERSISTENT_PER_HOST) {	931	# if ($KA_COUNT{$_[1]} < $MAX_PERSISTENT_PER_HOST) {
568	# ++$KA_COUNT{$_[1]};	932	# ++$KA_COUNT{$_[1]};
569	# $state{handle}{ka_count_guard} = AnyEvent::Util::guard {	933	# $state{handle}{ka_count_guard} = AnyEvent::Util::guard {
570	# --$KA_COUNT{$_[1]}	934	# --$KA_COUNT{$_[1]}
571	# };	935	# };
572	# $hdr{connection} = "keep-alive";	936	# $hdr{connection} = "keep-alive";
573	# }	937	# }
574		938
575	$state{handle}->starttls ("connect") if $rscheme eq "https";	939	$state{handle}->starttls ("connect") if $rscheme eq "https";
576		940
577	# handle actual, non-tunneled, request
578	my $handle_actual_request = sub {
579	$state{handle}->starttls ("connect") if $uscheme eq "https" && !exists $state{handle}{tls};
580
581	# send request
582	$state{handle}->push_write (
583	"$method $rpath HTTP/1.1\015\012"
584	. (join "", map "\u$_: $hdr{$_}\015\012", grep defined $hdr{$_}, keys %hdr)
585	. "\015\012"
586	. (delete $arg{body})
587	);
588
589	# return if error occured during push_write()
590	return unless %state;
591
592	%hdr = (); # reduce memory usage, save a kitten, also make it possible to re-use
593
594	# status line and headers
595	$state{read_response} = sub {
596	for ("$_[1]") {
597	y/\015//d; # weed out any \015, as they show up in the weirdest of places.
598
599	/^HTTP\/([0-9\.]+) \s+ ([0-9]{3}) (?: \s+ ([^\012]*) )? \012/igxc
600	or return (%state = (), $cb->(undef, { @pseudo, Status => 599, Reason => "Invalid server response" }));
601
602	# 100 Continue handling
603	# should not happen as we don't send expect: 100-continue,
604	# but we handle it just in case.
605	# since we send the request body regardless, if we get an error
606	# we are out of-sync, which we currently do NOT handle correctly.
607	return $state{handle}->push_read (line => $qr_nlnl, $state{read_response})
608	if $2 eq 100;
609
610	push @pseudo,
611	HTTPVersion => $1,
612	Status => $2,
613	Reason => $3,
614	;
615
616	my $hdr = parse_hdr
617	or return (%state = (), $cb->(undef, { @pseudo, Status => 599, Reason => "Garbled response headers" }));
618
619	%hdr = (%$hdr, @pseudo);
620	}
621
622	# redirect handling
623	# microsoft and other shitheads don't give a shit for following standards,
624	# try to support some common forms of broken Location headers.
625	if ($hdr{location} !~ /^(?: $ \| [^:\/?\#]+ : )/x) {
626	$hdr{location} =~ s/^\.\/+//;
627
628	my $url = "$rscheme://$uhost:$uport";
629
630	unless ($hdr{location} =~ s/^\///) {
631	$url .= $upath;
632	$url =~ s/\/[^\/]*$//;
633	}
634
635	$hdr{location} = "$url/$hdr{location}";
636	}
637
638	my $redirect;
639
640	if ($recurse) {
641	my $status = $hdr{Status};
642
643	# industry standard is to redirect POST as GET for
644	# 301, 302 and 303, in contrast to http/1.0 and 1.1.
645	# also, the UA should ask the user for 301 and 307 and POST,
646	# industry standard seems to be to simply follow.
647	# we go with the industry standard.
648	if ($status == 301 or $status == 302 or $status == 303) {
649	# HTTP/1.1 is unclear on how to mutate the method
650	$method = "GET" unless $method eq "HEAD";
651	$redirect = 1;
652	} elsif ($status == 307) {
653	$redirect = 1;
654	}
655	}
656
657	my $finish = sub { # ($data, $err_status, $err_reason[, $keepalive])
658	my $keepalive = pop;
659
660	$state{handle}->destroy if $state{handle};
661	%state = ();
662
663	if (defined $_[1]) {
664	$hdr{OrigStatus} = $hdr{Status}; $hdr{Status} = $_[1];
665	$hdr{OrigReason} = $hdr{Reason}; $hdr{Reason} = $_[2];
666	}
667
668	# set-cookie processing
669	if ($arg{cookie_jar}) {
670	for ($hdr{"set-cookie"}) {
671	# parse NAME=VALUE
672	my @kv;
673
674	while (
675	m{
676	\G\s*
677	(?:
678	expires \s=\s ([A-Z][a-z][a-z],\ [^,;]+)
679	\| ([^=;,[:space:]]+) \s=\s (?: "((?:[^\\"]+\|\\.))" \| ([^=;,[:space:]]) )
680	)
681	}gcxsi
682	) {
683	my $name = $2;
684	my $value = $4;
685
686	unless (defined $name) {
687	# expires
688	$name = "expires";
689	$value = $1;
690	} elsif (!defined $value) {
691	# quoted
692	$value = $3;
693	$value =~ s/\\(.)/$1/gs;
694	}
695
696	push @kv, lc $name, $value;
697
698	last unless /\G\s*;/gc;
699	}
700
701	last unless @kv;
702
703	my $name = shift @kv;
704	my %kv = (value => shift @kv, @kv);
705
706	$kv{expires} \|\|= format_date (AE::now + $kv{"max-age"})
707	if exists $kv{"max-age"};
708
709	my $cdom;
710	my $cpath = (delete $kv{path}) \|\| "/";
711
712	if (exists $kv{domain}) {
713	$cdom = delete $kv{domain};
714
715	$cdom =~ s/^\.?/./; # make sure it starts with a "."
716
717	next if $cdom =~ /\.$/;
718
719	# this is not rfc-like and not netscape-like. go figure.
720	my $ndots = $cdom =~ y/.//;
721	next if $ndots < ($cdom =~ /\.[^.][^.]\.[^.][^.]$/ ? 3 : 2);
722	} else {
723	$cdom = $uhost;
724	}
725
726	# store it
727	$arg{cookie_jar}{version} = 1;
728	$arg{cookie_jar}{$cdom}{$cpath}{$name} = \%kv;
729
730	redo if /\G\s*,/gc;
731	}
732	}
733
734	if ($redirect && exists $hdr{location}) {
735	# we ignore any errors, as it is very common to receive
736	# Content-Length != 0 but no actual body
737	# we also access %hdr, as $_[1] might be an erro
738	http_request (
739	$method => $hdr{location},
740	%arg,
741	recurse => $recurse - 1,
742	Redirect => [$_[0], \%hdr],
743	$cb);
744	} else {
745	$cb->($_[0], \%hdr);
746	}
747	};
748
749	my $len = $hdr{"content-length"};
750
751	if (!$redirect && $arg{on_header} && !$arg{on_header}(\%hdr)) {
752	$finish->(undef, 598 => "Request cancelled by on_header");
753	} elsif (
754	$hdr{Status} =~ /^(?:1..\|204\|205\|304)$/
755	or $method eq "HEAD"
756	or (defined $len && !$len)
757	) {
758	# no body
759	$finish->("", undef, undef, 1);
760	} else {
761	# body handling, many different code paths
762	# - no body expected
763	# - want_body_handle
764	# - te chunked
765	# - 2x length known (with or without on_body)
766	# - 2x length not known (with or without on_body)
767	if (!$redirect && $arg{want_body_handle}) {
768	$_[0]->on_eof (undef);
769	$_[0]->on_error (undef);
770	$_[0]->on_read (undef);
771
772	$finish->(delete $state{handle});
773
774	} elsif ($hdr{"transfer-encoding"} =~ /\bchunked\b/i) {
775	my $cl = 0;
776	my $body = undef;
777	my $on_body = $arg{on_body} \|\| sub { $body .= shift; 1 };
778
779	$_[0]->on_error (sub { $finish->(undef, 599 => $_[2]) });
780
781	my $read_chunk; $read_chunk = sub {
782	$_[1] =~ /^([0-9a-fA-F]+)/
783	or $finish->(undef, 599 => "Garbled chunked transfer encoding");
784
785	my $len = hex $1;
786
787	if ($len) {
788	$cl += $len;
789
790	$_[0]->push_read (chunk => $len, sub {
791	$on_body->($_[1], \%hdr)
792	or return $finish->(undef, 598 => "Request cancelled by on_body");
793
794	$_[0]->push_read (line => sub {
795	length $_[1]
796	and return $finish->(undef, 599 => "Garbled chunked transfer encoding");
797	$_[0]->push_read (line => $read_chunk);
798	});
799	});
800	} else {
801	$hdr{"content-length"} \|\|= $cl;
802
803	$_[0]->push_read (line => $qr_nlnl, sub {
804	if (length $_[1]) {
805	for ("$_[1]") {
806	y/\015//d; # weed out any \015, as they show up in the weirdest of places.
807
808	my $hdr = parse_hdr
809	or return $finish->(undef, 599 => "Garbled response trailers");
810
811	%hdr = (%hdr, %$hdr);
812	}
813	}
814
815	$finish->($body, undef, undef, 1);
816	});
817	}
818	};
819
820	$_[0]->push_read (line => $read_chunk);
821
822	} elsif ($arg{on_body}) {
823	$_[0]->on_error (sub { $finish->(undef, 599 => $_[2]) });
824
825	if ($len) {
826	$_[0]->on_read (sub {
827	$len -= length $_[0]{rbuf};
828
829	$arg{on_body}(delete $_[0]{rbuf}, \%hdr)
830	or return $finish->(undef, 598 => "Request cancelled by on_body");
831
832	$len > 0
833	or $finish->("", undef, undef, 1);
834	});
835	} else {
836	$_[0]->on_eof (sub {
837	$finish->("");
838	});
839	$_[0]->on_read (sub {
840	$arg{on_body}(delete $_[0]{rbuf}, \%hdr)
841	or $finish->(undef, 598 => "Request cancelled by on_body");
842	});
843	}
844	} else {
845	$_[0]->on_eof (undef);
846
847	if ($len) {
848	$_[0]->on_error (sub { $finish->(undef, 599 => $_[2]) });
849	$_[0]->on_read (sub {
850	$finish->((substr delete $_[0]{rbuf}, 0, $len, ""), undef, undef, 1)
851	if $len <= length $_[0]{rbuf};
852	});
853	} else {
854	$_[0]->on_error (sub {
855	($! == Errno::EPIPE \|\| !$!)
856	? $finish->(delete $_[0]{rbuf})
857	: $finish->(undef, 599 => $_[2]);
858	});
859	$_[0]->on_read (sub { });
860	}
861	}
862	}
863	};
864
865	$state{handle}->push_read (line => $qr_nlnl, $state{read_response});
866	};
867
868	# now handle proxy-CONNECT method	941	# now handle proxy-CONNECT method
869	if ($proxy && $uscheme eq "https") {	942	if ($proxy && $uscheme eq "https") {
870	# oh dear, we have to wrap it into a connect request	943	# oh dear, we have to wrap it into a connect request
871		944
872	# maybe re-use $uauthority with patched port?	945	# maybe re-use $uauthority with patched port?
873	$state{handle}->push_write ("CONNECT $uhost:$uport HTTP/1.0\015\012Host: $uhost\015\012\015\012");	946	$state{handle}->push_write ("CONNECT $uhost:$uport HTTP/1.0\015\012\015\012");
874	$state{handle}->push_read (line => $qr_nlnl, sub {	947	$state{handle}->push_read (line => $qr_nlnl, sub {
875	$_[1] =~ /^HTTP\/([0-9\.]+) \s+ ([0-9]{3}) (?: \s+ ([^\015\012]*) )?/ix	948	$_[1] =~ /^HTTP\/([0-9\.]+) \s+ ([0-9]{3}) (?: \s+ ([^\015\012]*) )?/ix
876	or return (%state = (), $cb->(undef, { @pseudo, Status => 599, Reason => "Invalid proxy connect response ($_[1])" }));	949	or return (%state = (), $cb->(undef, { @pseudo, Status => 599, Reason => "Invalid proxy connect response ($_[1])" }));
877		950
878	if ($2 == 200) {	951	if ($2 == 200) {
879	$rpath = $upath;	952	$rpath = $upath;
880	&$handle_actual_request;	953	$handle_actual_request->();
881	} else {	954	} else {
882	%state = ();	955	%state = ();
883	$cb->(undef, { @pseudo, Status => $2, Reason => $3 });	956	$cb->(undef, { @pseudo, Status => $2, Reason => $3 });
884	}
885	});	957	}
886	} else {
887	&$handle_actual_request;
888	}	958	});
		959	} else {
		960	$handle_actual_request->();
889	};	961	}
		962	};
		963
		964	_get_slot $uhost, sub {
		965	$state{slot_guard} = shift;
		966
		967	return unless $state{connect_guard};
890		968
891	my $tcp_connect = $arg{tcp_connect}	969	my $tcp_connect = $arg{tcp_connect}
892	\|\| do { require AnyEvent::Socket; \&AnyEvent::Socket::tcp_connect };	970	\|\| do { require AnyEvent::Socket; \&AnyEvent::Socket::tcp_connect };
893		971
894	$state{connect_guard} = $tcp_connect->($rhost, $rport, $connect_cb, $arg{on_prepare} \|\| sub { $timeout });	972	$state{connect_guard} = $tcp_connect->($rhost, $rport, $connect_cb, $arg{on_prepare} \|\| sub { $timeout });
895
896	};	973	};
897		974
898	defined wantarray && AnyEvent::Util::guard { %state = () }	975	defined wantarray && AnyEvent::Util::guard { %state = () }
899	}	976	}
900		977
…		…
935	string of the form C<http://host:port> (optionally C<https:...>), croaks	1012	string of the form C<http://host:port> (optionally C<https:...>), croaks
936	otherwise.	1013	otherwise.
937		1014
938	To clear an already-set proxy, use C<undef>.	1015	To clear an already-set proxy, use C<undef>.
939		1016
		1017	=item AnyEvent::HTTP::cookie_jar_expire $jar[, $session_end]
		1018
		1019	Remove all cookies from the cookie jar that have been expired. If
		1020	C<$session_end> is given and true, then additionally remove all session
		1021	cookies.
		1022
		1023	You should call this function (with a true C<$session_end>) before you
		1024	save cookies to disk, and you should call this function after loading them
		1025	again. If you have a long-running program you can additonally call this
		1026	function from time to time.
		1027
		1028	A cookie jar is initially an empty hash-reference that is managed by this
		1029	module. It's format is subject to change, but currently it is like this:
		1030
		1031	The key C<version> has to contain C<1>, otherwise the hash gets
		1032	emptied. All other keys are hostnames or IP addresses pointing to
		1033	hash-references. The key for these inner hash references is the
		1034	server path for which this cookie is meant, and the values are again
		1035	hash-references. The keys of those hash-references is the cookie name, and
		1036	the value, you guessed it, is another hash-reference, this time with the
		1037	key-value pairs from the cookie, except for C<expires> and C<max-age>,
		1038	which have been replaced by a C<_expires> key that contains the cookie
		1039	expiry timestamp.
		1040
		1041	Here is an example of a cookie jar with a single cookie, so you have a
		1042	chance of understanding the above paragraph:
		1043
		1044	{
		1045	version => 1,
		1046	"10.0.0.1" => {
		1047	"/" => {
		1048	"mythweb_id" => {
		1049	_expires => 1293917923,
		1050	value => "ooRung9dThee3ooyXooM1Ohm",
		1051	},
		1052	},
		1053	},
		1054	}
		1055
940	=item $date = AnyEvent::HTTP::format_date $timestamp	1056	=item $date = AnyEvent::HTTP::format_date $timestamp
941		1057
942	Takes a POSIX timestamp (seconds since the epoch) and formats it as a HTTP	1058	Takes a POSIX timestamp (seconds since the epoch) and formats it as a HTTP
943	Date (RFC 2616).	1059	Date (RFC 2616).
944		1060
945	=item $timestamp = AnyEvent::HTTP::parse_date $date	1061	=item $timestamp = AnyEvent::HTTP::parse_date $date
946		1062
947	Takes a HTTP Date (RFC 2616) or a Cookie date (netscape cookie spec) and	1063	Takes a HTTP Date (RFC 2616) or a Cookie date (netscape cookie spec) or a
948	returns the corresponding POSIX timestamp, or C<undef> if the date cannot	1064	bunch of minor variations of those, and returns the corresponding POSIX
949	be parsed.	1065	timestamp, or C<undef> if the date cannot be parsed.
950		1066
951	=item $AnyEvent::HTTP::MAX_RECURSE	1067	=item $AnyEvent::HTTP::MAX_RECURSE
952		1068
953	The default value for the C<recurse> request parameter (default: C<10>).	1069	The default value for the C<recurse> request parameter (default: C<10>).
954		1070
…		…
993	sub parse_date($) {	1109	sub parse_date($) {
994	my ($date) = @_;	1110	my ($date) = @_;
995		1111
996	my ($d, $m, $y, $H, $M, $S);	1112	my ($d, $m, $y, $H, $M, $S);
997		1113
998	if ($date =~ /^[A-Z][a-z][a-z], ([0-9][0-9])[\- ]([A-Z][a-z][a-z])[\- ]([0-9][0-9][0-9][0-9]) ([0-9][0-9]):([0-9][0-9]):([0-9][0-9]) GMT$/) {	1114	if ($date =~ /^[A-Z][a-z][a-z]+, ([0-9][0-9]?)[\- ]([A-Z][a-z][a-z])[\- ]([0-9][0-9][0-9][0-9]) ([0-9][0-9]?):([0-9][0-9]?):([0-9][0-9]?) GMT$/) {
999	# RFC 822/1123, required by RFC 2616 (with " ")	1115	# RFC 822/1123, required by RFC 2616 (with " ")
1000	# cookie dates (with "-")	1116	# cookie dates (with "-")
1001		1117
1002	($d, $m, $y, $H, $M, $S) = ($1, $2, $3, $4, $5, $6);	1118	($d, $m, $y, $H, $M, $S) = ($1, $2, $3, $4, $5, $6);
1003		1119
1004	} elsif ($date =~ /^[A-Z][a-z]+, ([0-9][0-9])-([A-Z][a-z][a-z])-([0-9][0-9]) ([0-9][0-9]):([0-9][0-9]):([0-9][0-9]) GMT$/) {	1120	} elsif ($date =~ /^[A-Z][a-z][a-z]+, ([0-9][0-9]?)-([A-Z][a-z][a-z])-([0-9][0-9]) ([0-9][0-9]?):([0-9][0-9]?):([0-9][0-9]?) GMT$/) {
1005	# RFC 850	1121	# RFC 850
1006	($d, $m, $y, $H, $M, $S) = ($1, $2, $3 < 69 ? $3 + 2000 : $3 + 1900, $4, $5, $6);	1122	($d, $m, $y, $H, $M, $S) = ($1, $2, $3 < 69 ? $3 + 2000 : $3 + 1900, $4, $5, $6);
1007		1123
1008	} elsif ($date =~ /^[A-Z][a-z][a-z] ([A-Z][a-z][a-z]) ([0-9 ][0-9]) ([0-9][0-9]):([0-9][0-9]):([0-9][0-9]) ([0-9][0-9][0-9][0-9])$/) {	1124	} elsif ($date =~ /^[A-Z][a-z][a-z]+ ([A-Z][a-z][a-z]) ([0-9 ]?[0-9]) ([0-9][0-9]?):([0-9][0-9]?):([0-9][0-9]?) ([0-9][0-9][0-9][0-9])$/) {
1009	# ISO C's asctime	1125	# ISO C's asctime
1010	($d, $m, $y, $H, $M, $S) = ($2, $1, $6, $3, $4, $5);	1126	($d, $m, $y, $H, $M, $S) = ($2, $1, $6, $3, $4, $5);
1011	}	1127	}
1012	# other formats fail in the loop below	1128	# other formats fail in the loop below
1013		1129

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing AnyEvent-HTTP/HTTP.pm (file contents): Revision 1.71 by root, Fri Dec 31 20:50:58 2010 UTC vs. Revision 1.90 by root, Mon Jan 3 00:41:25 2011 UTC

Diff Legend

Comparing AnyEvent-HTTP/HTTP.pm (file contents):
Revision 1.71 by root, Fri Dec 31 20:50:58 2010 UTC vs.
Revision 1.90 by root, Mon Jan 3 00:41:25 2011 UTC