=head3 Setup
$ catalyst.pl MyApp
+ # output omitted
$ cd MyApp
- $ script/create.pl controller My::Controller
+ $ script/myapp_create.pl controller My::Controller
=head3 Run
- $ script/server.pl
+ $ script/myapp_server.pl
Now visit these locations with your favorite browser or user agent to see Catalyst in action:
name => 'My Application',
root => '/home/joeuser/myapp/root',
- # You can put whatever you want in here:
- # my_param_name => $my_param_value,
+ # You can put anything else you want in here:
+ my_configuration_variable => 'something',
);
sub default : Private {
=head3 Actions
-A Catalyst controller is defined by its actions. An action is
-a sub with a special attribute. You've already seen some
-examples of actions in this document.
+A Catalyst controller is defined by its actions. An action is a sub with
+a special attribute. You've already seen some examples of actions in
+this document.
Catalyst supports several types of actions:
=item * B<Regex>
- sub bar : Regex('^foo(\d+)/bar(\d+)$') { }
+ sub bar : Regex('^item(\d+)/order(\d+)$') { }
-Matches any URL that matches the pattern in the action key, e.g. http://localhost:3000/foo23/bar42. The '' around the regexp is optional, but perltidy likes it. :)
+Matches any URL that matches the pattern in the action key, e.g. http://localhost:3000/item23/order42. The '' around the regexp is optional, but perltidy likes it. :)
+
+Regex matches act globally, i.e. without reference to the namespace from which it is called, so that a C<bar> method in the C<MyApp::Controller::Catalog::Order::Process> namespace won't match any form of C<bar>, C<Catalog>, C<Order>, or C<Process> unless you explicitly put this in the regex.
If you use capturing parentheses to extract values within the matching URL (23, 42 in the above example), those values are available in the $c->req->snippets array. If you want to pass arguments at the end of your URL, you must use regex action keys. See L</URL Argument Handling> below.
package MyApp;
sub foo : Global { }
-Matches http://localhost:3000/foo. The function name is mapped
-directly to the application base.
+Matches http://localhost:3000/foo. The function name is mapped directly
+to the application base.
=item * B<Namespace-Prefixed>
$c->forward('foo');
-See L</Flow Control> for a full explanation of C<forward>.
+See L</Flow Control> for a full explanation of C<forward>. Note that, as discussed there, when forwarding from another component, you must use the absolute path to the method, so that a private C<bar> method in your C<MyApp::Controller::Catalog::Order::Process> controller must, if called from elsewhere, be reach with C<$c-E<gt>forward('/catalog/order/process/bar')>.
=back
-B<Note:> After seeing these examples, you probably wonder what the point is of defining names for regex and path actions. Actually, every public
-action is also a private one, so you have one unified way of addressing components in your C<forward>s.
+B<Note:> After seeing these examples, you probably wonder what the point
+is of defining names for regex and path actions. Actually, every public
+action is also a private one, so you have one unified way of addressing
+components in your C<forward>s.
=head4 Built-in Private Actions
sub default : Private { }
You can define the Built-in Private Actions within your controllers as
-well. The actions will override the ones in lower level controllers/
-global.
+well. The actions will override the ones in lower level controllers or
+your global application.
In addition to the normal built-ins, you have a special action for
making inheritance chains, 'auto'. These will be run after C<begin>,
=back
-B<Note:> auto actions have to return a true value to continue processing!
-You can also die in the autochain action, in that case,
-the request will go straight to the finalize stage, without processing
+B<Note:> auto actions have to return a true value to continue
+processing! You can also die in the autochain action, in that case, the
+request will go straight to the finalize stage, without processing
further actions.
1;
+(You can also generate this automatically by using the helper script:
+
+ script/myapp_create.pl view TT TT
+
+where the first C<TT> tells the script to create a Template Toolkit
+view, and the second tells the script that its name should be C<TT>.)
+
This gives us a process() method and we can now just do $c->forward('MyApp::V::TT') to render our templates. The base class makes process() implicit, so we don't have to say C<$c-E<gt>forward(qw/MyApp::V::TT process/)>.
sub hello : Global {
Start your application on the command line...
- script/server.pl
+ script/myapp_server.pl
...then visit http://localhost:3000/ in a browser to view the output.
You can also do it all from the command line:
- script/test.pl http://localhost/
+ script/myapp_test.pl http://localhost/
Have fun!
Catalyst includes a helper script, C<catalyst.pl>, that will set up a
skeleton application for you:
- $ catalyst.pl My::App
created "My-App"
created "My-App/script"
created "My-App/lib"
created "My-App/lib/My/App/V"
created "My-App/lib/My/App/C"
created "My-App/lib/My/App.pm"
+ created "My-App/Build.PL"
created "My-App/Makefile.PL"
created "My-App/README"
created "My-App/Changes"
created "My-App/t/01app.t"
- created "My-App/t/02podcoverage.t"
- created "My-App/script/cgi.pl"
- created "My-App/script/nph-cgi.pl"
- created "My-App/script/fcgi.pl"
- created "My-App/script/server.pl"
- created "My-App/script/test.pl"
- created "My-App/script/create.pl"
+ created "My-App/t/02pod.t"
+ created "My-App/t/03podcoverage.t"
+ created "My-App/script/my_app_cgi.pl"
+ created "My-App/script/my_app_fastcgi.pl"
+ created "My-App/script/my_app_server.pl"
+ created "My-App/script/my_app_test.pl"
+ created "My-App/script/my_app_create.pl"
This creates the directory structure shown, populated with skeleton
files.
Catalyst provides:
$ cd My-App
- $ script/server.pl
+ $ script/my_app_server.pl
+
[...] [catalyst] [debug] Debug messages enabled
+ [...] [catalyst] [debug] Loaded dispatcher "Catalyst::Dispatcher"
[...] [catalyst] [debug] Loaded engine "Catalyst::Engine::HTTP"
+ [...] [catalyst] [debug] Found home "/usr/home/jester/foo/My-App/script/.."
[...] [catalyst] [debug] Loaded private actions
- .=----------------------+----------------------+---------------=.
- | Private | Class | Code |
- |=----------------------+----------------------+---------------=|
- | /default | MyApp | CODE(0x86f08ac)|
- '=----------------------+----------------------+---------------='
- "My::App" defined "!default" as "CODE(0x83fd570)"
- [...] [catalyst] [info] My::App powered by Catalyst 5.00
- You can connect to your server at http://localhost:3000
-
-(Note that each line logged by Catalyst includes a timestamp, which has
+ .=--------------------------------+------------------------------------=.
+ | Private | Class |
+ |=--------------------------------+------------------------------------=|
+ | /default | My::App |
+ '=--------------------------------+------------------------------------='
+
+ [....] [catalyst] [info] My::App powered by Catalyst 5.20
+ You can connect to your server at http://localhost:3000/
+
+(Note that each line logged by Catalyst begins with a timestamp, which has
been replaced here with "C<...>" so that the text fits onto the lines.)
The server is now waiting for you to make requests of it. Try using
GET / HTTP/1.0
HTTP/1.0 200
- Server: Catalyst/5.00
+ Server: Catalyst/5.20
Status: 200
- Date: Sun, 20 Mar 2005 12:31:55 GMT
- X-catalyst: 5.00
+ Date: Fri May 13 14:15:46 EDT 2005
+ X-catalyst: 5.20
Content-length: 40
Content-Type: text/html; charset=ISO-8859-1
The server will continue running until you interrupt it.
The application can also be tested from the command line using the generated
-helper script, C<script/test.pl>.
+helper script, C<script/my_app_test.pl>.
=head2 Getting your application invoked
projects / catagits/Catalyst-Runtime.git / commitdiff