1 package Catalyst::Engine::HTTP::Base;
4 use base 'Catalyst::Engine';
6 use Catalyst::Exception;
8 use HTTP::Headers::Util 'split_header_words';
14 __PACKAGE__->mk_accessors(qw/http/);
16 Class::Struct::struct 'Catalyst::Engine::HTTP::Base::struct' => {
17 request => 'HTTP::Request',
18 response => 'HTTP::Response',
25 Catalyst::Engine::HTTP::Base - Base class for HTTP Engines
29 This is a base class for HTTP Engines.
31 =head1 OVERLOADED METHODS
33 This class overloads some methods from C<Catalyst::Engine>.
37 =item $c->finalize_body
43 $c->http->response->content( $c->response->body );
46 =item $c->finalize_headers
50 sub finalize_headers {
53 $c->http->response->code( $c->response->status );
55 for my $name ( $c->response->headers->header_field_names ) {
56 $c->http->response->push_header( $name => [ $c->response->header($name) ] );
60 =item $c->prepare_body
66 $c->request->body( $c->http->request->content );
69 =item $c->prepare_connection
73 sub prepare_connection {
75 $c->request->address( $c->http->address );
76 $c->request->hostname( $c->http->hostname );
77 $c->request->protocol( $c->http->request->protocol );
78 $c->request->secure(1) if ( $c->http->request->uri->port == 443 );
81 =item $c->prepare_headers
87 $c->request->method( $c->http->request->method );
88 $c->request->headers( $c->http->request->headers );
91 =item $c->prepare_parameters
95 sub prepare_parameters {
98 my ( @params, @uploads );
100 my $request = $c->http->request;
102 push( @params, $request->uri->query_form );
104 if ( $request->content_type eq 'application/x-www-form-urlencoded' ) {
105 my $uri = URI->new('http:');
106 $uri->query( $request->content );
107 push( @params, $uri->query_form );
110 if ( $request->content_type eq 'multipart/form-data' ) {
112 for my $part ( $request->parts ) {
114 my $disposition = $part->header('Content-Disposition');
115 my %parameters = @{ ( split_header_words($disposition) )[0] };
117 if ( $parameters{filename} ) {
119 my $fh = File::Temp->new( UNLINK => 0 );
121 unless ( $fh->write( $part->content ) ) {
122 Catalyst::Exception->throw( message => $! );
125 unless ( $fh->flush ) {
126 Catalyst::Exception->throw( message => $! );
129 my $upload = Catalyst::Request::Upload->new(
130 filename => $parameters{filename},
131 size => ( $fh->stat )[7],
132 tempname => $fh->filename,
133 type => $part->content_type
136 unless ( $fh->close ) {
137 Catalyst::Exception->throw( message => $! );
140 push( @uploads, $parameters{name}, $upload );
141 push( @params, $parameters{name}, $parameters{filename} );
144 push( @params, $parameters{name}, $part->content );
149 $c->request->param(@params);
150 $c->request->upload(@uploads);
153 =item $c->prepare_path
162 my $scheme = $c->http->request->uri->scheme;
163 my $host = $c->http->request->uri->host;
164 my $port = $c->http->request->uri->port;
167 $base->scheme($scheme);
171 $base = $base->canonical->as_string;
174 my $path = $c->http->request->uri->path || '/';
175 $path =~ s/%([0-9A-Fa-f]{2})/chr(hex($1))/eg;
178 $c->req->base($base);
179 $c->req->path($path);
182 =item $c->prepare_request($r)
186 sub prepare_request {
187 my ( $c, $http ) = @_;
191 =item $c->prepare_uploads
195 sub prepare_uploads {
207 Sebastian Riedel, C<sri@cpan.org>
208 Christian Hansen, C<ch@ngmedia.com>
212 This program is free software, you can redistribute it and/or modify it under
213 the same terms as Perl itself.