X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial%2FAdvancedCRUD.pod;h=45431785118d95f795fc60e889390eb1b034ce40;hb=8c7de3d51d592dc104eb714fb9c9864766dd1b7a;hp=22f562b3ff0a42773d3cba903141ad4550a555a9;hpb=64ccd8a8bfbc16276c044c94702b1440c2897695;p=catagits%2FCatalyst-Runtime.git
diff --git a/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod b/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod
index 22f562b..4543178 100644
--- a/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod
+++ b/lib/Catalyst/Manual/Tutorial/AdvancedCRUD.pod
@@ -2,8 +2,6 @@
Catalyst::Manual::Tutorial::AdvancedCRUD - Catalyst Tutorial - Part 8: Advanced CRUD
-
-
=head1 OVERVIEW
This is B for the Catalyst tutorial.
@@ -46,12 +44,10 @@ B
=item 9
-L
+L
=back
-
-
=head1 DESCRIPTION
This part of the tutorial explores more advanced functionality for
@@ -64,23 +60,22 @@ forms and model objects.
In keeping with the Catalyst (and Perl) spirit of flexibility, there are
many different ways approach advanced CRUD operations in a Catalyst
environment. One alternative is to use
-L
-to instantly construct a set of Controller methods and templates for
-basic CRUD operations. Although a popular subject in Quicktime movies
-that serve as promotional material for various frameworks, more
-real-world applications require more control. Other options include
-L and
-L.
-
-Here, we will make use of the L to not only
-ease form creation, but to also provide validation of the submitted
-data. The approached used by the part of the tutorial is to slowly
-incorporate additional L functionality in a
-step-wise fashion (we start with fairly simple form creation and then
-move on to more complex and "magical" features such as validation and
+L to instantly construct a set
+of Controller methods and templates for basic CRUD operations. Although
+a popular subject in Quicktime movies that serve as promotional material
+for various frameworks, more real-world applications require more
+control. Other options include L and
+L.
+
+Here, we will make use of the L to not only ease form
+creation, but to also provide validation of the submitted data. The
+approached used by the part of the tutorial is to slowly incorporate
+additional L functionality in a step-wise fashion (we
+start with fairly simple form creation and then move on to more complex
+and "magical" features such as validation and
auto-population/auto-saving).
-B Part 8 of the tutorial is optional. Users who do not which to
+B Part 8 of the tutorial is optional. Users who do not wish to
use L may skip this section.
B: Note that all of the code for this part of the tutorial can be
@@ -90,22 +85,18 @@ following command:
svn checkout http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial@###
IMPORTANT: Does not work yet. Will be completed for final version.
-
-
=head1 C FORM CREATION
-This section looks at how L can be used to
+This section looks at how L can be used to
add additional functionality to the manually created form from Part 3.
-
=head2 Add the C Plugin
Open C in your editor and add the following to the list of
-plugins (be sure to leave the existing plugins enabled:
+plugins (be sure to leave the existing plugins enabled):
HTML::Widget
-
=head2 Add a Form Creation Helper Method
Open C in your editor and add the
@@ -140,13 +131,11 @@ following method:
}
This method provides a central location (so it can be called by multiple
-actions, such as create and edit) that builds an HTML::Wiget-based form
-with the appropriate fields. The "Get Authors" code uses DBIC to
-retrieve a list of model objects and then uses C
-
=head2 Test The Create Form
Press C to kill the previous server instance (if it's still
@@ -290,7 +275,7 @@ bogus information. Although we have constrained the authors with the
drop-down list, there are no restrictions on items such as the length of
the title (for example, you can create a one-letter title) and value for
the rating (you can use any number you want, and even non-numeric values
-with SQLite). The next section seeks to address this concern.
+with SQLite). The next section will address this concern.
B Depending on the database you are using and how you established
the columns in your tables, the database could obviously provide various
@@ -298,7 +283,6 @@ levels of "type enforcement" on your data. The key point being made in
the previous paragraph is that the I itself is not
performing any validation.
-
=head1 C VALIDATION AND FILTERING
Although the use of L in the previous section
@@ -310,7 +294,6 @@ form contains a valid email address). Filtering can be used to remove
extraneous whitespace from fields or to escape meta-characters in user
input.
-
=head2 Add Constraints and Filters to the Widget Creation Method
Open C in your editor and update the
@@ -376,7 +359,6 @@ Two filters are run on every field to remove and escape unwanted input.
=back
-
=head2 Rebuild the Form Submission Method to Include Validation
Edit C and change C to
@@ -463,7 +445,6 @@ similar to the prior version of the C method.
=back
-
=head2 Try Out the Form
Press C to kill the previous server instance (if it's still running) and restart it:
@@ -476,7 +457,6 @@ two, and zero authors. When you click Submit, the HTML::Widget
C items will validate the logic and insert feedback as
appropriate.
-
=head1 Enable C Support
In this section we will take advantage of some of the "auto-population"
@@ -504,7 +484,6 @@ records in the database.
In other words, the two methods are a mirror image of each other: one
reads from the database while the other writes to the database.
-
=head2 Add C to DBIC Model
In order to use L, we
@@ -515,7 +494,6 @@ C and update the C line to match:
__PACKAGE__->load_components(qw/PK::Auto Core HTMLWidget/);
-
=head2 Use C in C
Edit C and update C to
@@ -576,8 +554,6 @@ have to call C<$book-Eadd_to_book_authors> once per author because
C does not currently handle the relationships
between tables.
-
-
=head1 AUTHOR
Kennedy Clark, C
@@ -586,7 +562,8 @@ Please report any errors, issues or suggestions to the author.
Copyright 2006, Kennedy Clark. All rights reserved.
-This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
+This library is free software; you can redistribute it and/or modify it
+under the same terms as Perl itself.
Version: .94