Plack is not a framework per se, but is more of a toolkit that contains PSGI server implementations as well as utilities like plackup, Plack::Test and Middleware components.
Since Plack project is a revolution from HTTP::Engine, there seems a demand to write a quick web application in Request/Response style handler API. Plack::Request gives you a nice Object Oriented API around PSGI environment hash and response array, just like Rack's Rack::Request and Response objects. It could also be used as a library when writing a new middleware component, and a base class for requests/responses when you write a new web application framework based on Plack.
Use Plack::Request and Response
Plack::Request is a wrapper around PSGI environment, and the code goes like this:
use Plack::Request;
my $app = sub {
my $req = Plack::Request->new(shift);
my $name = $req->param('name');
my $res = $req->new_response(200);
$res->content_type('text/html');
$res->content("<html><body>Hello World</body></html>");
return $res->finalize;
};
The only thing you need to change, if you're migrating from HTTP::Engine, is the first line of the application to create a Plack::Request out of PSGI env (shift) and then call finalize to get an array reference out of Response object.
All other methods like path_info, uri, param, redirect etc. work like HTTP::Engine::Request and Response object which is very similar to Catalyst 's Request and Response object.
Plack::Request and Plack
Plack::Request is available as part of Plack on CPAN. Your framework can use Plack::Request to handle parameters and can also make it run on other PSGI server implementations such as mod_psgi.
Use Plack::Request or not?
Directly using Plack::Request in the .psgi code is quite handy to quickly write and test your code but not really recommended for a large scale application. It's exactly like writing a 1000 lines of .cgi script where you could factor out the application code into a module (.pm files). The same thing applies to .psgi file: it's best to create an application class by using and possibly extending Plack::Request, and then have just a few lines of code in .psgi file with Plack::Builder to configure middleware components.
Plack::Request is also supposed to be used from a web application framework to adapt to PSGI interface.
This is a small-fry detail, but the variable $name is un-used. To make the example a little more complete I'd change the content line to something like:
$res->content("Hello $name");
Then to demonstrate the capturing of the param one could do the following:
* plackup app.psgi
* curl http://localhost:5000/?name=Xavi
OR
* curl -d name=Xavi http://localhost:5000/
where app.psgi is the Plack::Request app demonstrated above. In the result of the curl operation one will see value of the name param.
Posted by: Mateu | 05/06/2011 at 06:57 AM