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.
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.
on_read
my $cb = $content->on_read;
$content = $content->on_read(sub {...});Callback to be invoked when new content arrives.
$content = $content->on_read(sub {
my ($self, $chunk) = @_;
print $chunk;
});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::Base and implements the following new ones.
body_contains
my $found = $content->body_contains('foo bar baz');Check if content contains a specific string.
body_size
my $size = $content->body_size;Content size in bytes.
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 $leftovers = $content->has_leftovers;Check if there are leftovers.
header_size
my $size = $content->header_size;Size of headers in bytes.
is_chunked
my $chunked = $content->is_chunked;Check if content is chunked.
is_done
my $done = $content->is_done;Check if parser is done.
is_dynamic
my $dynamic = $content->is_dynamic;Check if content will be dynamic. Note that this method is EXPERIMENTAL and might change without warning!
is_multipart
my $multipart = $content->is_multipart;Check if content is multipart.
is_parsing_body
my $body = $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, 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 chunked content, the optional drain callback will be invoked once all data has been written.