The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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.