NAME

Linux::Event::HTTP::Body::Stream - writable producer for a streaming HTTP body

DESCRIPTION

Applications obtain this object from a Linux::Event::HTTP::Transaction, for example $tx->request_body(...) while producing a client Request or $tx->response_body(...) while producing a server Response. They do not construct it directly.

The producer belongs to the Transaction rather than the Request or Response message. write supplies more body bytes and preserves Linux::Event's cooperative backpressure return value. False means the bytes were accepted but the producer should stop until on_drain runs. complete supplies optional final bytes and announces that no more body bytes will be produced.

on_cancel reports that the HTTP consumer disappeared or the exchange became terminal before production completed so an upstream producer can stop work.