![]() |
![]()
| ![]() |
![]()
NAMECatalyst::ActionRole::ConsumesContent - Match on HTTP Request Content-Type SYNOPSISpackage MyApp::Web::Controller::MyController; use base 'Catalyst::Controller'; sub start : POST Chained('/') CaptureArg(0) { ... } sub is_json : Chained('start') Consumes('application/json') { ... } sub is_urlencoded : Chained('start') Consumes('application/x-www-form-urlencoded') { ... } sub is_multipart : Chained('start') Consumes('multipart/form-data') { ... } ## Alternatively, for common types... sub is_json : Chained('start') Consume(JSON) { ... } sub is_urlencoded : Chained('start') Consumes(UrlEncoded) { ... } sub is_multipart : Chained('start') Consumes(Multipart) { ... } ## Or allow more than one type sub is_more_than_one : Chained('start') : Consumes('application/x-www-form-urlencoded') : Consumes('multipart/form-data') { ## ... } 1; DESCRIPTIONThis is an action role that lets your Catalyst::Action match on the content type of the incoming request. Generally when there's a PUT or POST request, there's a request content body with a matching MIME content type. Commonly this will be one of the types used with classic HTML forms ('application/x-www-form-urlencoded' for example) but there's nothing stopping you specifying any valid content type. For matching purposes, we match strings but the casing is insensitive. REQUIRESThis role requires the following methods in the consuming class. matchmatch_capturesReturns 1 if the action matches the existing request and zero if not. METHODSThis role defines the following methods matchmatch_capturesAround method modifier that return 1 if the request content type matches one of the allowed content types (see "http_methods") and zero otherwise. allowed_content_typesAn array of strings that are the allowed content types for matching this action. can_consumeBoolean. Does the current request match content type with what this actionrole can consume? list_extra_infoAdd the accepted content type to the debug screen. AUTHORSCatalyst Contributors, see Catalyst.pm COPYRIGHTThis library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.
|