NAME
Mojo::Content - HTTP 1.1 content base class
SYNOPSIS
use Mojo::Base 'Mojo::Content';DESCRIPTION
Mojo::Content is an abstract base class for HTTP 1.1 content as described in RFC 2616.
EVENTS
Mojo::Content can emit the following events.
body
$content->on(body => sub {
my $content = shift;
});Emitted once all headers have been parsed and the body starts. Note that this event is EXPERIMENTAL and might change without warning!
$content->on(body => sub {
my $content = shift;
$content->auto_upgrade(0) if $content->headers->header('X-No-MultiPart');
});read
$content->on(read => sub {
my ($content, $chunk) = @_;
});Emitted when a new chunk of content arrives, also disables normal content storage in asset objects.
$content->on(read => sub {
my ($content, $chunk) = @_;
say "STREAMING: $chunk";
});ATTRIBUTES
Mojo::Content implements the following attributes.
auto_relax
my $relax = $content->auto_relax;
$content = $content->auto_relax(1);Try to detect broken web servers and turn on relaxed parsing automatically.
headers
my $headers = $content->headers;
$content = $content->headers(Mojo::Headers->new);Content headers, defaults to a Mojo::Headers object.
relaxed
my $relaxed = $content->relaxed;
$content = $content->relaxed(1);Activate relaxed parsing for HTTP 0.9 and broken web servers.
METHODS
Mojo::Content inherits all methods from Mojo::EventEmitter and implements the following new ones.
body_contains
my $success = $content->body_contains('foo bar baz');Check if content contains a specific string.
body_size
my $size = $content->body_size;Content size in bytes.
boundary
my $boundary = $content->boundary;Extract multipart boundary from content type header. Note that this method is EXPERIMENTAL and might change without warning!
build_body
my $string = $content->build_body;Render whole body.
build_headers
my $string = $content->build_headers;Render all headers.
clone
my $clone = $content->clone;Clone content if possible. Note that this method is EXPERIMENTAL and might change without warning!
generate_body_chunk
my $chunk = $content->generate_body_chunk(0);Generate dynamic content.
get_body_chunk
my $chunk = $content->get_body_chunk(0);Get a chunk of content starting from a specfic position.
get_header_chunk
my $chunk = $content->get_header_chunk(13);Get a chunk of the headers starting from a specfic position.
has_leftovers
my $success = $content->has_leftovers;Check if there are leftovers.
header_size
my $size = $content->header_size;Size of headers in bytes.
is_chunked
my $success = $content->is_chunked;Check if content is chunked.
is_done
my $success = $content->is_done;Check if parser is done.
is_dynamic
my $success = $content->is_dynamic;Check if content will be dynamic. Note that this method is EXPERIMENTAL and might change without warning!
is_multipart
my $false = $content->is_multipart;False.
is_parsing_body
my $success = $content->is_parsing_body;Check if body parsing started yet.
leftovers
my $bytes = $content->leftovers;Remove leftover data from content parser.
parse
$content = $content->parse("Content-Length: 12\r\n\r\nHello World!");Parse content chunk.
parse_body
$content = $content->parse_body("Hi!");Parse body chunk.
parse_body_once
$content = $content->parse_body_once("Hi!");Parse body chunk once.
parse_until_body
$content = $content->parse_until_body(
"Content-Length: 12\r\n\r\nHello World!"
);Parse chunk and stop after headers.
progress
my $bytes = $content->progress;Number of bytes already received from message content. Note that this method is EXPERIMENTAL and might change without warning!
write
$content->write('Hello!');
$content->write('Hello!', sub {...});Write dynamic content non-blocking, the optional drain callback will be invoked once all data has been written.
write_chunk
$content->write_chunk('Hello!');
$content->write_chunk('Hello!', sub {...});Write dynamic content non-blocking with the chunked transfer encoding, the optional drain callback will be invoked once all data has been written.