NAME

CatalystX::RequestModel::ContentBodyParser::MultiPart - Parse multipart uploads

SYNOPSIS

    TBD

DESCRIPTION

Given a list of uploads and possible form parameters:

    [debug] "POST" request for "upload" from "127.0.0.1"
    [debug] Body Parameters are:
    .-------------------------------------+--------------------------------------.
    | Parameter                           | Value                                |
    +-------------------------------------+--------------------------------------+
    | notes                               | This is the file you seek!           |
    '-------------------------------------+--------------------------------------'
    [debug] File Uploads are:
    .--------------+----------------------------+--------------------+-----------.
    | Parameter    | Filename                   | Type               | Size      |
    +--------------+----------------------------+--------------------+-----------+
    | file         | file.txt                   |                    | 13        |
    '--------------+----------------------------+--------------------+-----------'

If you have a request model like:

    package Example::Model::UploadRequest;

    use Moose;
    use CatalystX::RequestModel;

    extends 'Catalyst::Model';
    content_type 'multipart/form-data';

    has notes => (is=>'ro', required=>1, property=>1);  
    has file => (is=>'ro', property=>1);

    __PACKAGE__->meta->make_immutable();

This will be mapped to an instance of the request model:

    $request_model->notes;      # 'This is the file you seek!';
    $request_model->file;     # Instance of L<Catalyst::Request::Upload>.

This is basically a subclass of CatalystX::RequestModel::ContentBodyParser::FormURLEncoded with added support for multipart form uploads. You should see the parent file for more details.

EXCEPTIONS

See CatalystX::RequestModel::ContentBodyParser for exceptions.

AUTHOR

See CatalystX::RequestModel.

COPYRIGHT

See CatalystX::RequestModel.

LICENSE

See CatalystX::RequestModel.