1Catalyst::Manual::TutorUisaelr(3C)ontributed Perl DocumeCnattaatliyosnt::Manual::Tutorial(3)
2
6 Catalyst::Manual::Tutorial - Catalyst Tutorial: Overview
7
9 The Catalyst framework is a flexible and comprehensive environment for
10 quickly building high-functionality web applications. This tutorial is
11 designed to provide a rapid introduction to its basics and its most
12 commonly used features while focusing on real-world best practices.
13 We suggest that you read this introduction on the web. Make sure you
15 are reading the latest version of the tutorial by visiting
16 <http://search.cpan.org/perldoc?Catalyst::Manual::Tutorial>.
17 Alternatively you can use CPAN modules like Pod::Webserver,
18 Pod::POM::Web, Pod::Browser (Catalyst based), or CPAN::Mini::Webserver
19 to read a local copy of the tutorial.
20 The tutorial is divided into the following sections:
22 NOTE: CLICK THESE LINKS TO JUMP TO CHAPTERS (the index links above only
24 navigate inside this page).
25 1. Introduction
27 2. Catalyst Basics
29 3. More Catalyst Basics
31 4. Basic CRUD
33 5. Authentication
35 6. Authorization
37 7. Debugging
39 8. Testing
41 9. Advanced CRUD
43 10. Appendices
45 Final code tarballs for each chapter of the tutorial are available at
47 <http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/>.
48
50 Chapter 1: Intro
51 Note: Click on the heading in the previous line to jump to the actual
52 chapter. Below is a "table of contents" for this chapter.
53 · VERSIONS AND CONVENTIONS USED IN THIS TUTORIAL
55 · CATALYST INSTALLATION
57 · DATABASES
59 · WHERE TO GET WORKING CODE
61 Chapter 2: Catalyst Basics
63 Note: Click on the heading in the previous line to jump to the actual
64 chapter. Below is a "table of contents" for this chapter.
65 · CREATE A CATALYST PROJECT
67 · HELLO WORLD
69 · The Simplest Way
71 · Hello, World! Using a View and a Template
73 · CREATE A SIMPLE CONTROLLER AND AN ACTION
75 Chapter 3: More Catalyst Basics
77 Note: Click on the heading in the previous line to jump to the actual
78 chapter. Below is a "table of contents" for this chapter.
79 · CREATE A NEW APPLICATION
81 · EDIT THE LIST OF CATALYST PLUGINS
83 · CREATE A CATALYST CONTROLLER
85 · CATALYST VIEWS
87 · Create a Catalyst View
89 · Create a TT Template Page
91 · Test Run The Application
93 · CREATE A SQLITE DATABASE
95 · DATABASE ACCESS WITH DBIx::Class
97 · Create a Dynamic DBIC Model
99 · ENABLE THE MODEL IN THE CONTROLLER
101 · Test Run The Application
103 · CREATE A WRAPPER FOR THE VIEW
105 · Configure TT.pm For The Wrapper
107 · Create the Wrapper Template File and Stylesheet
109 · Test Run The Application
111 · A STATIC DATABASE MODEL WITH DBIx::Class
113 · Create Static DBIC Schema Files
115 · Updating the Generated DBIC Schema Files
117 · Run The Application
119 · UPDATING THE VIEW
121 · RUNNING THE APPLICATION FROM THE COMMAND LINE
123 · OPTIONAL INFORMATION
125 · Using RenderView for the Default View
127 · Using The Default Template Name
129 · Return To A Manually-Specified Template
131 Chapter 4: Basic CRUD
133 Note: Click on the heading in the previous line to jump to the actual
134 chapter. Below is a "table of contents" for this chapter.
135 · FORMLESS SUBMISSION
137 · Include a Create Action in the Books Controller
139 · Include a Template for the url_create Action:
141 · Try the url_create Feature
143 · CONVERT TO A CHAINED ACTION
145 · Try the Chained Action
147 · Refactor to Use a "Base" Method to Start the Chains
149 · MANUALLY BUILDING A CREATE FORM
151 · Add a Method to Display the Form
153 · Add a Template for the Form
155 · Add Method to Process Form Values and Update Database
157 · Test Out the Form
159 · A SIMPLE DELETE FEATURE
161 · Include a Delete Link in the List
163 · Add a Common Method to Retrieve a Book for the Chain
165 · Add a Delete Action to the Controller
167 · Try the Delete Feature
169 · Fixing a Dangerous URL
171 · Try the Delete and Redirect Logic
173 · Using uri_for to Pass Query Parameters
175 · Try the Delete and Redirect With Query Param Logic
177 · EXPLORING THE POWER OF DBIC
179 · Add Datetime Columns to Our Existing Books Table
181 · Update DBIC to Automatically Handle the Datetime Columns
183 · Create a ResultSet Class
185 · Chaining ResultSets
187 · Adding Methods to Result Classes
189 Chapter 5: Authentication
191 Note: Click on the heading in the previous line to jump to the actual
192 chapter. Below is a "table of contents" for this chapter.
193 · BASIC AUTHENTICATION
195 · Add Users and Roles to the Database
197 · Add User and Role Information to DBIC Schema
199 · Sanity-Check Reload of Development Server
201 · Include Authentication and Session Plugins
203 · Configure Authentication
205 · Add Login and Logout Controllers
207 · Add a Login Form TT Template Page
209 · Add Valid User Check
211 · Displaying Content Only to Authenticated Users
213 · Try Out Authentication
215 · USING PASSWORD HASHES
217 · Get a SHA-1 Hash for the Password
219 · Switch to SHA-1 Password Hashes in the Database
221 · Enable SHA-1 Hash Passwords in
223 Catalyst::Plugin::Authentication::Store::DBIC
224 · Try Out the Hashed Passwords
226 · USING THE SESSION FOR FLASH
228 · Try Out Flash
230 · Switch To Flash-To-Stash
232 Chapter 6: Authorization
234 Note: Click on the heading in the previous line to jump to the actual
235 chapter. Below is a "table of contents" for this chapter.
236 · BASIC AUTHORIZATION
238 · Update Plugins to Include Support for Authorization
240 · Add Config Information for Authorization
242 · Add Role-Specific Logic to the ``Book List'' Template
244 · Limit Books::add to admin Users
246 · Try Out Authentication And Authorization
248 · ENABLE MODEL-BASED AUTHORIZATION
250 Chapter 7: Debugging
252 Note: Click on the heading in the previous line to jump to the actual
253 chapter. Below is a "table of contents" for this chapter.
254 · LOG STATEMENTS
256 · RUNNING CATALYST UNDER THE PERL DEBUGGER
258 · DEBUGGING MODULES FROM CPAN
260 · TT DEBUGGING
262 Chapter 8: Testing
264 Note: Click on the heading in the previous line to jump to the actual
265 chapter. Below is a "table of contents" for this chapter.
266 · RUNNING THE "CANNED" CATALYST TESTS
268 · RUNNING A SINGLE TEST
270 · ADDING YOUR OWN TEST SCRIPT
272 · SUPPORTING BOTH PRODUCTION AND TEST DATABASES
274 Chapter 9: Advanced CRUD
276 Note: Click on the heading in the previous line to jump to the actual
277 chapter. Below is a "table of contents" for this chapter.
278 · ADVANCED CRUD OPTIONS
280 Chapter 10: Appendices
282 Note: Click on the heading in the previous line to jump to the actual
283 chapter. Below is a "table of contents" for this chapter.
284 · APPENDIX 1: CUT AND PASTE FOR POD-BASED EXAMPLES
286 · "Un-indenting" with Vi/Vim
288 · "Un-indenting" with Emacs
290 · APPENDIX 2: USING MYSQL AND POSTGRESQL
292 · MySQL
294 · PostgreSQL
296 · APPENDIX 3: IMPROVED HASHING SCRIPT
298
300 This tutorial would not have been possible without the input of many
301 different people in the Catalyst community. In particular, the primary
302 author would like to thank:
303 · Sebastian Riedel for founding the Catalyst project.
305 · The members of the Catalyst Core Team for their tireless efforts to
307 advance the Catalyst project. Although all of the Core Team
308 members have played a key role in this tutorial, it would have
309 never been possible without the critical contributions of: Matt
310 Trout, for his unfathomable knowledge of all things Perl and
311 Catalyst (and his willingness to answer lots of my questions);
312 Jesse Sheidlower, for his incredible skill with the written word
313 and dedication to improving the Catalyst documentation; and Yuval
314 Kogman, for his work on the Catalyst "Auth & Authz" plugins (the
315 original focus of the tutorial) and other key Catalyst modules.
316 · Other Catalyst documentation folks like Kieren Diment, Gavin Henry,
318 and Jess Robinson (including their work on the original Catalyst
319 tutorial).
320 · Kieren Diment for his oversite of Catalyst-related documentation.
322 · Everyone on #catalyst and #catalyst-dev.
324 · Louis Moore (who thanks Marcello Romani and Tom Lanyon) for the
326 PostgreSQL content in the Appendix.
327 · People who have emailed me with corrections and suggestions on the
329 tutorial. As of the most recent release, this include: Florian
330 Ragwitz, Mauro Andreolini, Jim Howard, Giovanni Gigante, William
331 Moreno, Bryan Roach, Ashley Berlin, David Kamholz, Kevin Old,
332 Henning Sprang, Jeremy Jones, David Kurtz, Ingo Wichmann, Shlomi
333 Fish, Murray Walker, Adam Witney and xenoterracide. Thanks to
334 Devin Austin for coming up with an initial version of a non-TTSite
335 wrapper page. Also, a huge thank you to Kiffin Gish for all the
336 hard work on the "database depluralization" effort and Rafael
337 Kitover for the work on updating the tutorial to include foreign
338 key support for SQLite. I'm sure I am missing some names here...
339 apologies for that (please let me know if you name should be here).
340
342 Kennedy Clark, "hkclark@gmail.com"
343 Please report any errors, issues or suggestions to the author. The
345 most recent version of the Catalyst Tutorial can be found at
346 http://dev.catalyst.perl.org/repos/Catalyst/Catalyst-Manual/5.80/trunk/lib/Catalyst/Manual/Tutorial/
347 <http://dev.catalyst.perl.org/repos/Catalyst/Catalyst-
348 Manual/5.80/trunk/lib/Catalyst/Manual/Tutorial/>.
349 Copyright 2006-2008, Kennedy Clark, under Creative Commons License
351 (http://creativecommons.org/licenses/by-nc-sa/2.5/
352 <http://creativecommons.org/licenses/by-nc-sa/2.5/>).
353perl v5.12.0 2010-02-17 Catalyst::Manual::Tutorial(3)