The document provides an overview of the HTML::FormHandler Perl module, detailing its functionality for creating, processing, and validating forms using a Model-View-Controller (MVC) architecture. It includes examples on attribute creation with Moose, form field handling, and error validation, along with practical applications of dynamic forms and repeatable fields. Limitations of the system are noted, along with workarounds and suggestions for customization.

1. HTML::FormHandler Bryan Beeley Reach Systems www.reachsystems.com

2. Quick Moose Review Overview Functional Examples Real World Examples Limitations

3. Quick Moose Review Object Framework Simple Attribute/Accessor Creation Method Modifiers

4. Object Framework package MooseOb; use Moose; ... no Moose; package DerivedOb; use Moose; extends 'MooseOb'; ... no Moose; my $ob = DerivedOb->new; Moose

5. Moose Simple Attribute/Accessor Creation has 'attribute' => ( # Properties is => 'rw', # Attribute is read/write isa => 'Str', # Indicate a type ); … $obj->attribute('value'); … $val = $obj->attribute();

6. Moose Method Modifiers package Base; use Moose; sub method { print “inside\n”; } package Derived; use Moose; extends 'Base'; before 'method' => sub { print “before\n”; }; around 'method' => sub { my $orig = shift; my $self = shift; print “around\n”; $self->$orig(@_); # prints inside print “around\n”; }; after 'method' => sub { print “after\n”; };

7. HTML::FormHandler Overview HFH and MVC Forms Simple Example Object Creation Parameter Processing Validation Failed Validation Form Rendering Updating the Data Model Repeatable Fields

8. Model View Controller Form? HFH and MVC

9. Forms Fields Type

10. Name

11. Value Initial

12. Input

13. Validated

14. Forms – Top level object Fields – Objects within a form Type – The class of the field object

15. Name – An attribute of the field object

16. Value – Attributes of the field object Initial – Separate Attribute

17. Input – Separate Attribute (associted with a result object)

18. Validated – Separate Attribute

19. package Form; use HTML::FormHandler::Moose; extends 'HTML::FormHandler'; has_field 'column_name' => ( type => 'Text' ); has_field 'submit' => ( type => 'Submit' ); no HTML::FormHandler::Moose; … my $form = Form->new( item => $object ); $form->process( $params ); if ($form->validated) { # Form submitted successfully } else { $output = $form->render; }

20. package Form; use HTML::FormHandler::Moose; extends 'HTML::FormHandler::Model::DBIC'; use namespace::autoclean; has_field 'column_name' => ( type => 'Text' ); has_field 'submit' => ( type => 'Submit' ); __PACKAGE__->make_immutable; … my $form = Form->new( item => $dbic_row_ob ); $form->process( $c->req->parameters ); if ($form->validated) { # Redirect or something } else { my $output = $form->render; $c->stash->{template} = \$output; }

21. Object Creation No attributes and no model required my $form = Form->new; Attributes and row object my $form = Form->new( attr => 'val',

22. item => $row_ob ); Dynamic form my $form = HTML::FormHandler->new( field_list => [ text => { type => 'Text' },

23. number => { type => 'Integer' }, ], );