Mojo::Content - HTTP content base class
package Mojo::Content::MyContent; use Mojo::Base 'Mojo::Content'; sub body_contains {...} sub body_size {...} sub get_body_chunk {...}
Mojo::Content is an abstract base class for HTTP content as described in RFC 2616.
Mojo::Content inherits all events from Mojo::EventEmitter and can emit the following new ones.
$content->on(body => sub { my $content = shift; ... });
Emitted once all headers have been parsed and the body starts.
$content->on(body => sub { my $content = shift; $content->auto_upgrade(0) if $content->headers->header('X-No-MultiPart'); });
$content->on(drain => sub { my ($content, $offset) = @_; ... });
Emitted once all data has been written.
$content->on(drain => sub { my $content = shift; $content->write_chunk(time); });
$content->on(read => sub { my ($content, $bytes) = @_; ... });
Emitted when a new chunk of content arrives.
$content->unsubscribe('read'); $content->on(read => sub { my ($content, $bytes) = @_; say "Streaming: $bytes"; });
Mojo::Content implements the following attributes.
my $bool = $content->auto_relax; $content = $content->auto_relax($bool);
Try to detect when relaxed parsing is necessary.
my $headers = $content->headers; $content = $content->headers(Mojo::Headers->new);
Content headers, defaults to a Mojo::Headers object.
my $size = $content->max_buffer_size; $content = $content->max_buffer_size(1024);
Maximum size in bytes of buffer for content parser, defaults to the value of the MOJO_MAX_BUFFER_SIZE environment variable or 262144.
262144
my $size = $content->max_leftover_size; $content = $content->max_leftover_size(1024);
Maximum size in bytes of buffer for pipelined HTTP requests, defaults to the value of the MOJO_MAX_LEFTOVER_SIZE environment variable or 262144.
my $bool = $content->relaxed; $content = $content->relaxed($bool);
Activate relaxed parsing for responses that are terminated with a connection close.
my $bool = $content->skip_body; $content = $content->skip_body($bool);
Skip body parsing and finish after headers.
Mojo::Content inherits all methods from Mojo::EventEmitter and implements the following new ones.
my $bool = $content->body_contains('foo bar baz');
Check if content contains a specific string. Meant to be overloaded in a subclass.
my $size = $content->body_size;
Content size in bytes. Meant to be overloaded in a subclass.
my $boundary = $content->boundary;
Extract multipart boundary from Content-Type header.
Content-Type
my $str = $content->build_body;
Render whole body.
my $str = $content->build_headers;
Render all headers.
my $charset = $content->charset;
Extract charset from Content-Type header.
my $clone = $content->clone;
Clone content if possible, otherwise return undef.
undef
my $bytes = $content->generate_body_chunk(0);
Generate dynamic content.
my $bytes = $content->get_body_chunk(0);
Get a chunk of content starting from a specific position. Meant to be overloaded in a subclass.
my $bytes = $content->get_header_chunk(13);
Get a chunk of the headers starting from a specific position.
my $size = $content->header_size;
Size of headers in bytes.
my $bool = $content->is_chunked;
Check if content is chunked.
my $bool = $content->is_compressed;
Check if content is gzip compressed.
gzip
my $bool = $content->is_dynamic;
Check if content will be dynamically generated, which prevents "clone" from working.
my $bool = $content->is_finished;
Check if parser is finished.
my $bool = $content->is_limit_exceeded;
Check if buffer has exceeded "max_buffer_size".
my $false = $content->is_multipart;
False.
my $bool = $content->is_parsing_body;
Check if body parsing started yet.
my $bytes = $content->leftovers;
Get leftover data from content parser.
$content = $content->parse("Content-Length: 12\x0d\x0a\x0d\x0aHello World!");
Parse content chunk.
$content = $content->parse_body('Hi!');
Parse body chunk and skip headers.
my $size = $content->progress;
Size of content already received from message in bytes.
$content = $content->write($bytes); $content = $content->write($bytes => sub {...});
Write dynamic content non-blocking, the optional drain callback will be invoked once all data has been written.
$content = $content->write_chunk($bytes); $content = $content->write_chunk($bytes => sub {...});
Write dynamic content non-blocking with chunked transfer encoding, the optional drain callback will be invoked once all data has been written.
chunked
Mojolicious, Mojolicious::Guides, http://mojolicio.us.
To install Mojolicious, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mojolicious
CPAN shell
perl -MCPAN -e shell install Mojolicious
For more information on module installation, please visit the detailed CPAN module installation guide.