1 # Copyright (C) 2016 all contributors <meta@public-inbox.org>
2 # License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
4 # XXX This is a totally unstable API for public-inbox internal use only
5 # This is exposed via the 'pi-httpd.async' key in the PSGI env hash.
6 # The name of this key is not even stable!
7 # Currently is is intended for use with read-only pipes.
8 package PublicInbox::HTTPD::Async;
11 use base qw(Danga::Socket);
12 use fields qw(cb cleanup);
13 use Scalar::Util qw(weaken);
14 require PublicInbox::EvCleanup;
17 my ($class, $io, $cb, $cleanup) = @_;
18 my $self = fields::new($class);
19 IO::Handle::blocking($io, 0);
20 $self->SUPER::new($io);
22 $self->{cleanup} = $cleanup;
27 sub restart_read_cb ($) {
29 sub { $self->watch_read(1) }
33 my ($self, $io, $fh, $bref) = @_;
34 # In case the client HTTP connection ($io) dies, it
35 # will automatically close this ($self) object.
36 $io->{forward} = $self;
38 my $restart_read = restart_read_cb($self);
41 my $r = sysread($self->{sock}, $$bref, 8192);
44 if ($io->{write_buf_size}) {
46 $io->write($restart_read); # D::S::write
48 # stay in watch_read, but let other clients
49 # get some work done, too.
51 } elsif (!defined $r) {
52 return if $!{EAGAIN} || $!{EINTR};
55 # Done! Error handling will happen in $fh->close
56 # called by the {cleanup} handler
57 $io->{forward} = undef;
62 sub event_read { $_[0]->{cb}->() }
63 sub event_hup { $_[0]->{cb}->() }
64 sub event_err { $_[0]->{cb}->() }
65 sub sysread { shift->{sock}->sysread(@_) }
69 my $cleanup = $self->{cleanup};
70 $self->{cleanup} = $self->{cb} = undef;
71 $self->SUPER::close(@_);
73 # we defer this to the next timer loop since close is deferred
74 PublicInbox::EvCleanup::asap($cleanup) if $cleanup;
77 # do not let ourselves be closed during graceful termination
78 sub busy () { $_[0]->{cb} }