GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MOJO::CONTENT::SINGLE (3)

.ds Aq ’

NAME

Mojo::Content::Single - HTTP content

CONTENTS

SYNOPSIS



  use Mojo::Content::Single;

  my $single = Mojo::Content::Single->new;
  $single->parse("Content-Length: 12\x0d\x0a\x0d\x0aHello World!");
  say $single->headers->content_length;



DESCRIPTION

Mojo::Content::Single is a container for HTTP content, based on RFC 7230 <http://tools.ietf.org/html/rfc7230> and RFC 7231 <http://tools.ietf.org/html/rfc7231>.

EVENTS

Mojo::Content::Single inherits all events from Mojo::Content and can emit the following new ones.

    upgrade



  $single->on(upgrade => sub {
    my ($single, $multi) = @_;
    ...
  });



Emitted when content gets upgraded to a Mojo::Content::MultiPart object.



  $single->on(upgrade => sub {
    my ($single, $multi) = @_;
    return unless $multi->headers->content_type =~ /multipart\/([^;]+)/i;
    say "Multipart: $1";
  });



ATTRIBUTES

Mojo::Content::Single inherits all attributes from Mojo::Content and implements the following new ones.

    asset



  my $asset = $single->asset;
  $single   = $single->asset(Mojo::Asset::Memory->new);



The actual content, defaults to a Mojo::Asset::Memory object with auto_upgrade in Mojo::Asset::Memory enabled.

    auto_upgrade



  my $bool = $single->auto_upgrade;
  $single  = $single->auto_upgrade($bool);



Try to detect multipart content and automatically upgrade to a Mojo::Content::MultiPart object, defaults to a true value.

METHODS

Mojo::Content::Single inherits all methods from Mojo::Content and implements the following new ones.

    body_contains



  my $bool = $single->body_contains(1234567);



Check if content contains a specific string.

    body_size



  my $size = $single->body_size;



Content size in bytes.

    clone



  my $clone = $single->clone;



Clone content if possible, otherwise return undef.

    get_body_chunk



  my $bytes = $single->get_body_chunk(0);



Get a chunk of content starting from a specific position. Note that it might not be possible to get the same chunk twice if content was generated dynamically.

    new



  my $single = Mojo::Content::Single->new;
  my $single = Mojo::Content::Single->new(asset => Mojo::Asset::File->new);
  my $single = Mojo::Content::Single->new({asset => Mojo::Asset::File->new});



Construct a new Mojo::Content::Single object and subscribe to read event with default content parser.

    parse



  $single = $single->parse("Content-Length: 12\x0d\x0a\x0d\x0aHello World!");
  my $multi
    = $single->parse("Content-Type: multipart/form-data\x0d\x0a\x0d\x0a");



Parse content chunk and upgrade to Mojo::Content::MultiPart object if necessary.

SEE ALSO

Mojolicious, Mojolicious::Guides, <http://mojolicious.org>.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MOJO::CONTENT::SINGLE (3) 2016-03-15

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.