NAME¶

Mojo::Content::MultiPart - HTTP 1.1 multipart content container

SYNOPSIS¶

  use Mojo::Content::MultiPart;
  my $multi = Mojo::Content::MultiPart->new;
  $multi->parse('Content-Type: multipart/mixed; boundary=---foobar');
  my $single = $multi->parts->[4];

DESCRIPTION¶

Mojo::Content::MultiPart is a container for HTTP 1.1 multipart content as described in RFC 2616.

EVENTS¶

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

"part"¶

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

Emitted when a new Mojo::Content::Single part starts.

  $multi->on(part => sub {
    my ($multi, $single) = @_;
    return unless $single->headers->content_disposition =~ /name="([^"]+)"/;
    say "Field: $1";
  });

ATTRIBUTES¶

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

"parts"¶

  my $parts = $multi->parts;
  $multi    = $multi->parts([]);

Content parts embedded in this multipart content, usually Mojo::Content::Single objects.

METHODS¶

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

"new"¶

  my $multi = Mojo::Content::MultiPart->new;

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

"body_contains"¶

  my $success = $multi->body_contains('foobarbaz');

Check if content parts contain a specific string.

"body_size"¶

  my $size = $multi->body_size;

Content size in bytes.

"build_boundary"¶

  my $boundary = $multi->build_boundary;

Generate a suitable boundary for content.

"clone"¶

  my $clone = $multi->clone;

Clone content if possible, otherwise return "undef".

"get_body_chunk"¶

  my $chunk = $multi->get_body_chunk(0);

Get a chunk of content starting from a specfic position.

"is_multipart"¶

  my $true = $multi->is_multipart;

True.

SEE ALSO¶

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