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. Note that this event is EXPERIMENTAL and might change without warning!
$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.
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. Note that this method is EXPERIMENTAL and might change without warning!
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.
parse
$multi = $multi->parse('Content-Type: multipart/mixed');Parse content chunk.