Mojo::Content.3pm

Langue: en

Version: 2010-08-12 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

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