NAME

Mojo::Content - HTTP 1.1 Content Base Class

SYNOPSIS

use 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.

body_cb

my $cb = $content->body_cb;

$counter = 1;
$content = $content->body_cb(sub {
    my $self  = shift;
    my $chunk = '';
    $chunk    = "hello world!" if $counter == 1;
    $chunk    = "hello world2!\n\n" if $counter == 2;
    $counter++;
    return $chunk;
});

Content generator callback.

buffer

my $buffer = $content->buffer;
$content   = $content->buffer(Mojo::ByteStream->new);

Parser buffer.

filter

my $filter = $content->filter;
$content   = $content->filter(Mojo::Filter::Chunked->new);

Input filter.

filter_buffer

my $filter_buffer = $content->filter_buffer;
$content          = $content->filter_buffer(Mojo::ByteStream->new);

Input buffer for filtering.

headers

my $headers = $content->headers;
$content    = $content->headers(Mojo::Headers->new);

The headers.

relaxed

my $relaxed = $content->relaxed;
$content    = $content->relaxed(1);

Activate relaxed filtering for HTTP 0.9.

raw_header_size

my $size = $content->raw_header_size;

Raw size of headers in bytes.

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.

generate_body_chunk

my $chunk = $content->generate_body_chunk(0);

Generate content from body_cb.

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 in the buffer.

header_size

my $size = $content->header_size;

Size of headers in bytes.

is_chunked

my $chunked = $content->is_chunked;

Chunked transfer encoding.

is_done

my $done = $content->is_done;

Check if parser is done.

is_multipart

my $multipart = $content->is_multipart;

Multipart content.

is_parsing_body

my $body = $content->is_parsing_body;

Check if body parsing started yet.

leftovers

my $bytes = $content->leftovers;

Leftovers for next HTTP message in buffer.

parse

$content = $content->parse("Content-Length: 12\r\n\r\nHello World!");

Parse content.

parse_body

$content = $content->parse_body("Hi!");

Parse body.

parse_body_once

$content = $content->parse_body_once("Hi!");

Parse body once.

parse_until_body

$content = $content->parse_until_body(
    "Content-Length: 12\r\n\r\nHello World!"
);

Parse and stop after headers.

raw_body_size

my $size = $content->raw_body_size;

Raw size of body in bytes.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicious.org.