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.

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.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicio.us.