Modified: websites/production/tapestry/content/documentation.html
==============================================================================
--- websites/production/tapestry/content/documentation.html (original)
+++ websites/production/tapestry/content/documentation.html Sun Nov 9 16:12:11
2014
@@ -61,10 +61,7 @@
</div>
<div id="content">
-<div id="ConfluenceContent"><div style="float:right;margin-left:1em">
-<h2 id="Documentation-AllTopics">All Topics</h2>
-
-<ul class="childpages-macro"><li><a shape="rect"
href="introduction.html">Introduction</a></li><li><a shape="rect"
href="getting-started.html">Getting Started</a></li><li><a shape="rect"
href="principles.html">Principles</a></li><li><a shape="rect"
href="tapestry-tutorial.html">Tapestry Tutorial</a><ul
class="childpages-macro"><li><a shape="rect"
href="dependencies-tools-and-plugins.html">Dependencies, Tools and
Plugins</a></li><li><a shape="rect"
href="creating-the-skeleton-application.html">Creating The Skeleton
Application</a></li><li><a shape="rect"
href="loading-the-project-into-eclipse.html">Loading the Project Into
Eclipse</a></li><li><a shape="rect" href="exploring-the-project.html">Exploring
the Project</a></li><li><a shape="rect"
href="implementing-the-hi-lo-guessing-game.html">Implementing the Hi-Lo
Guessing Game</a></li><li><a shape="rect"
href="using-beaneditform-to-create-user-forms.html">Using BeanEditForm To
Create User Forms</a></li><li><a shape="rect" href="using-t
apestry-with-hibernate.html">Using Tapestry With
Hibernate</a></li></ul></li><li><a shape="rect" href="user-guide.html">User
Guide</a><ul class="childpages-macro"><li><a shape="rect"
href="project-layout.html">Project Layout</a></li><li><a shape="rect"
href="configuration.html">Configuration</a></li><li><a shape="rect"
href="class-reloading.html">Class Reloading</a></li><li><a shape="rect"
href="component-reference.html">Component Reference</a></li><li><a shape="rect"
href="annotations.html">Annotations</a></li><li><a shape="rect"
href="component-classes.html">Component Classes</a></li><li><a shape="rect"
href="component-templates.html">Component Templates</a></li><li><a shape="rect"
href="property-expressions.html">Property Expressions</a></li><li><a
shape="rect" href="component-parameters.html">Component
Parameters</a></li><li><a shape="rect" href="type-coercion.html">Type
Coercion</a></li><li><a shape="rect" href="layout-component.html">Layout
Component</a></li><li><a shape="rect
" href="component-mixins.html">Component Mixins</a><ul
class="childpages-macro"><li><a shape="rect"
href="built-in-mixins.html">Built-in Mixins</a></li></ul></li><li><a
shape="rect" href="page-navigation.html">Page Navigation</a></li><li><a
shape="rect" href="localization.html">Localization</a></li><li><a shape="rect"
href="page-life-cycle.html">Page Life Cycle</a></li><li><a shape="rect"
href="request-processing.html">Request Processing</a></li><li><a shape="rect"
href="component-rendering.html">Component Rendering</a></li><li><a shape="rect"
href="component-events.html">Component Events</a></li><li><a shape="rect"
href="url-rewriting.html">URL rewriting</a></li><li><a shape="rect"
href="dom.html">DOM</a></li><li><a shape="rect"
href="response-compression.html">Response Compression</a></li><li><a
shape="rect" href="security.html">Security</a></li><li><a shape="rect"
href="https.html">HTTPS</a></li><li><a shape="rect"
href="content-type-and-markup.html">Content Type and Markup</a></
li><li><a shape="rect" href="persistent-page-data.html">Persistent Page
Data</a></li><li><a shape="rect" href="session-storage.html">Session
Storage</a><ul class="childpages-macro"><li><a shape="rect"
href="clustering-issues.html">Clustering Issues</a></li></ul></li><li><a
shape="rect" href="injection.html">Injection</a></li><li><a shape="rect"
href="environmental-services.html">Environmental Services</a></li><li><a
shape="rect" href="legacy-javascript.html">Legacy JavaScript</a></li><li><a
shape="rect" href="ajax-and-zones.html">Ajax and Zones</a></li><li><a
shape="rect" href="css.html">CSS</a></li><li><a shape="rect"
href="assets.html">Assets</a></li><li><a shape="rect"
href="forms-and-validation.html">Forms and Validation</a></li><li><a
shape="rect" href="beaneditform-guide.html">BeanEditForm Guide</a></li><li><a
shape="rect" href="uploading-files.html">Uploading Files</a></li><li><a
shape="rect" href="logging.html">Logging</a></li><li><a shape="rect"
href="unit-testing-pages-or-
components.html">Unit testing pages or components</a></li><li><a shape="rect"
href="integration-testing.html">Integration Testing</a></li><li><a shape="rect"
href="service-status.html">Service Status</a></li><li><a shape="rect"
href="modules.html">Modules</a><ul class="childpages-macro"><li><a shape="rect"
href="built-in-modules.html">Built In Modules</a></li><li><a shape="rect"
href="third-party-modules.html">Third Party Modules</a></li></ul></li><li><a
shape="rect" href="ioc.html">IoC</a><ul class="childpages-macro"><li><a
shape="rect" href="tapestry-ioc-overview.html">Tapestry IoC
Overview</a></li><li><a shape="rect" href="tapestry-ioc-modules.html">Tapestry
IoC Modules</a></li><li><a shape="rect"
href="defining-tapestry-ioc-services.html">Defining Tapestry IOC
Services</a></li><li><a shape="rect" href="service-advisors.html">Service
Advisors</a></li><li><a shape="rect"
href="tapestry-ioc-decorators.html">Tapestry IoC Decorators</a></li><li><a
shape="rect" href="tapestry-ioc-conf
iguration.html">Tapestry IoC Configuration</a></li><li><a shape="rect"
href="case-insensitivity.html">Case Insensitivity</a></li><li><a shape="rect"
href="autoloading-modules.html">Autoloading Modules</a></li><li><a shape="rect"
href="service-implementation-reloading.html">Service Implementation
Reloading</a></li><li><a shape="rect"
href="ordering-by-constraints.html">Ordering by Constraints</a></li><li><a
shape="rect" href="symbols.html">Symbols</a></li><li><a shape="rect"
href="chainbuilder-service.html">ChainBuilder Service</a></li><li><a
shape="rect" href="pipelinebuilder-service.html">PipelineBuilder
Service</a></li><li><a shape="rect"
href="shadowbuilder-service.html">ShadowBuilder Service</a></li><li><a
shape="rect" href="strategybuilder-service.html">StrategyBuilder
Service</a></li><li><a shape="rect" href="injection-in-detail.html">Injection
in Detail</a></li><li><a shape="rect" href="object-providers.html">Object
Providers</a></li><li><a shape="rect" href="service-serializ
ation.html">Service Serialization</a></li><li><a shape="rect"
href="typecoercer-service.html">TypeCoercer Service</a></li><li><a shape="rect"
href="starting-the-ioc-registry.html">Starting the IoC Registry</a></li><li><a
shape="rect" href="registry-startup.html">Registry Startup</a></li><li><a
shape="rect" href="parallel-execution.html">Parallel Execution</a></li><li><a
shape="rect" href="logging-in-tapestry.html">Logging in Tapestry</a></li><li><a
shape="rect" href="using-jsr-330-standard-annotations.html">Using JSR 330
standard annotations</a></li></ul></li><li><a shape="rect"
href="hibernate-core.html">Hibernate - Core</a><ul
class="childpages-macro"><li><a shape="rect"
href="hibernate-core-conf.html">Hibernate - Core - Conf</a></li><li><a
shape="rect" href="hibernate.html">Hibernate</a></li></ul></li><li><a
shape="rect" href="integrating-with-spring-framework.html">Integrating with
Spring Framework</a></li><li><a shape="rect" href="bean-validation.html">Bean
Validation</a></li><
li><a shape="rect" href="component-report.html">Component
Report</a></li><li><a shape="rect" href="aliases.html">Aliases</a></li><li><a
shape="rect" href="integrating-with-jpa.html">Integrating with
JPA</a></li><li><a shape="rect" href="javascript-modules.html">JavaScript
Modules</a></li><li><a shape="rect"
href="client-side-javascript.html">Client-Side JavaScript</a></li><li><a
shape="rect" href="coffeescript.html">CoffeeScript</a></li></ul></li><li><a
shape="rect" href="cheat-sheets.html">Cheat Sheets</a><ul
class="childpages-macro"><li><a shape="rect"
href="application-module-class-cheat-sheet.html">Application Module Class Cheat
Sheet</a></li><li><a shape="rect" href="component-cheat-sheet.html">Component
Cheat Sheet</a></li><li><a shape="rect"
href="tapestry-for-jsf-users.html">Tapestry for JSF
Users</a></li></ul></li><li><a shape="rect"
href="cookbook.html">Cookbook</a><ul class="childpages-macro"><li><a
shape="rect" href="default-parameter.html">Default Parameter</a></li><li>
<a shape="rect" href="overriding-exception-reporting.html">Overriding
Exception Reporting</a></li><li><a shape="rect"
href="error-page-recipe.html">Error Page Recipe</a></li><li><a shape="rect"
href="supporting-informal-parameters.html">Supporting Informal
Parameters</a></li><li><a shape="rect"
href="component-libraries.html">Component Libraries</a></li><li><a shape="rect"
href="switching-cases.html">Switching Cases</a></li><li><a shape="rect"
href="enum-parameter-recipe.html">Enum Parameter Recipe</a></li><li><a
shape="rect" href="extending-the-if-component.html">Extending the If
Component</a></li><li><a shape="rect"
href="meta-programming-page-content.html">Meta-Programming Page
Content</a></li><li><a shape="rect" href="using-select-with-a-list.html">Using
Select With a List</a></li><li><a shape="rect" href="ioc-cookbook.html">IoC
cookbook</a><ul class="childpages-macro"><li><a shape="rect"
href="ioc-cookbook-basic-services-and-injection.html">IoC Cookbook - Basic
Services and Inj
ection</a></li><li><a shape="rect"
href="ioc-cookbook-overriding-ioc-services.html">IoC Cookbook - Overriding IoC
Services</a></li><li><a shape="rect" href="ioc-cookbook-patterns.html">IoC
Cookbook - Patterns</a></li><li><a shape="rect"
href="ioc-cookbook-service-configurations.html">IoC cookbook - Service
Configurations</a></li></ul></li><li><a shape="rect"
href="performance-and-clustering.html">Performance and
Clustering</a></li></ul></li><li><a shape="rect"
href="frequently-asked-questions.html">Frequently Asked Questions</a><ul
class="childpages-macro"><li><a shape="rect"
href="general-questions.html">General Questions</a></li><li><a shape="rect"
href="templating-and-markup-faq.html">Templating and Markup FAQ</a></li><li><a
shape="rect" href="page-and-component-classes-faq.html">Page And Component
Classes FAQ</a></li><li><a shape="rect"
href="forms-and-form-components-faq.html">Forms and Form Components
FAQ</a></li><li><a shape="rect" href="beaneditform-faq.html">BeanEditForm FA
Q</a></li><li><a shape="rect" href="link-components-faq.html">Link Components
FAQ</a></li><li><a shape="rect" href="component-events-faq.html">Component
Events FAQ</a></li><li><a shape="rect" href="javascript-faq.html">JavaScript
FAQ</a></li><li><a shape="rect" href="ajax-components-faq.html">Ajax Components
FAQ</a></li><li><a shape="rect" href="injection-faq.html">Injection
FAQ</a></li><li><a shape="rect"
href="tapestry-inversion-of-control-faq.html">Tapestry Inversion of Control
FAQ</a></li><li><a shape="rect" href="security-faq.html">Security
FAQ</a></li><li><a shape="rect"
href="integration-with-existing-applications.html">Integration with existing
applications</a></li><li><a shape="rect"
href="request-processing-faq.html">Request Processing FAQ</a></li><li><a
shape="rect" href="limitations.html">Limitations</a></li><li><a shape="rect"
href="specific-errors-faq.html">Specific Errors FAQ</a></li><li><a shape="rect"
href="hibernate-support-faq.html">Hibernate Support FAQ</a></li><
li><a shape="rect" href="maven-support-faq.html">Maven Support
FAQ</a></li><li><a shape="rect" href="release-upgrade-faq.html">Release Upgrade
FAQ</a></li></ul></li><li><a shape="rect" href="release-notes.html">Release
Notes</a><ul class="childpages-macro"><li><a shape="rect"
href="how-to-upgrade.html">How to Upgrade</a></li><li><a shape="rect"
href="release-notes-50.html">Release Notes 5.0</a></li><li><a shape="rect"
href="release-notes-51.html">Release Notes 5.1</a></li><li><a shape="rect"
href="release-notes-52.html">Release Notes 5.2</a><ul
class="childpages-macro"><li><a shape="rect"
href="release-notes-520.html">Release Notes 5.2.0</a></li><li><a shape="rect"
href="release-notes-521.html">Release Notes 5.2.1</a></li><li><a shape="rect"
href="release-notes-522.html">Release Notes 5.2.2</a></li><li><a shape="rect"
href="release-notes-523.html">Release Notes 5.2.3</a></li><li><a shape="rect"
href="release-notes-524.html">Release Notes 5.2.4</a></li><li><a shape="rect"
href="relea
se-notes-525.html">Release Notes 5.2.5</a></li><li><a shape="rect"
href="release-notes-526.html">Release Notes 5.2.6</a></li></ul></li><li><a
shape="rect" href="release-notes-53.html">Release Notes 5.3</a></li><li><a
shape="rect" href="release-notes-531.html">Release Notes 5.3.1</a></li><li><a
shape="rect" href="release-notes-532.html">Release Notes 5.3.2</a></li><li><a
shape="rect" href="release-notes-533.html">Release Notes 5.3.3</a></li><li><a
shape="rect" href="release-notes-534.html">Release Notes 5.3.4</a></li><li><a
shape="rect" href="release-notes-535.html">Release Notes 5.3.5</a></li><li><a
shape="rect" href="release-notes-536.html">Release Notes 5.3.6</a></li><li><a
shape="rect" href="release-notes-537.html">Release Notes 5.3.7</a></li><li><a
shape="rect" href="release-notes-54.html">Release Notes
5.4</a></li></ul></li><li><a shape="rect"
href="javascript-rewrite.html">JavaScript Rewrite</a></li><li><a shape="rect"
href="support.html">Support</a></li><li><a shape="rect" hr
ef="developer-information.html">Developer Information</a><ul
class="childpages-macro"><li><a shape="rect"
href="building-tapestry-from-source.html">Building Tapestry from
Source</a></li><li><a shape="rect" href="confluence-site-setup.html">Confluence
Site Setup</a><ul class="childpages-macro"><li><a shape="rect"
href="since-and-deprecated-user-macros.html">Since and Deprecated User
Macros</a></li></ul></li><li><a shape="rect"
href="developer-bible.html">Developer Bible</a></li><li><a shape="rect"
href="release-process.html">Release Process</a></li><li><a shape="rect"
href="the-tapestry-jail.html">The tapestry jail</a></li><li><a shape="rect"
href="version-numbers.html">Version
Numbers</a></li></ul></li></ul></div><p>Welcome to the Tapestry 5
Documentation. A rich collection of guides is available to teach beginners the
basics and help even experienced developers deepen their understanding of
Tapestry's power. <em>Code less, deliver more!</em></p><h1
id="Documentation-Highlights">Hig
hlights</h1><p>These are the most useful starting points for common
needs.</p><div class="table-wrap"><table class="confluenceTable"><tbody><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
href="introduction.html">Introduction</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>An overview of Tapestry's general approach and
philosophy</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" href="getting-started.html">Getting
Started</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A quick
guide to creating your first Tapestry project, using Maven</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
href="tapestry-tutorial.html">Tapestry Tutorial</a></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Picks up where <em>Getting Started</em>
leaves off, explaining in greater detail how Tapestry
works</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p
><a shape="rect" href="user-guide.html">User Guide</a></p></td><td colspan="1"
>rowspan="1" class="confluenceTd"><p>Detailed articles on every Tapestry
>feature</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><a shape="rect"
>href="community.html">Community</a></p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>Getting support, mailing lists, JIRA, outside
>resources, and access to the source</p></td></tr><tr><td colspan="1"
>rowspan="1" class="confluenceTd"><p><a shape="rect"
>href="cookbook.html">Cookbook</a></p></td><td colspan="1" rowspan="1"
>class="confluenceTd"><p>Guides to doing common things with
>Tapestry</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><strong><a shape="rect"
>href="frequently-asked-questions.html">FAQ</a></strong></p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p>A quick place to check for
>common problems and solutions</p></td></tr><tr><td colspan="1" rowspan="1"
>class="confluenceTd"><p><a shape="rect" h
ref="component-cheat-sheet.html">Component Cheat Sheet</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>A concise guide to component
classes, methods and annotations</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://refcardz.dzone.com/refcardz/apache-tapestry-50?oid=hom7948";
>Refcard</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A
color, six page foldout guide to Tapestry 5.0
(PDF)</p></td></tr></tbody></table></div><h1
id="Documentation-APIandComponentReference">API and Component
Reference</h1><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>API (Javadoc):</p></th><td colspan="1" rowspan="1"
class="confluenceTd"><p>5.0<sup>1</sup></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>5.1<sup>1</sup></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>5.2<sup>1</sup></p></td><td colspan="1" rowspan="
1" class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://tapestry.apache.org/current/apidocs/";>5.3.7
(current)</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><a
shape="rect" class="external-link" href="http://tapestry.apache.org/5.4/";>5.4
(beta)</a></td></tr><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Component Reference:</p></th><td colspan="1"
rowspan="1" class="confluenceTd"><p>5.0<sup>1</sup></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>5.1<sup>1</sup></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>5.2<sup>1</sup></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><a shape="rect"
href="component-reference.html">5.3.7 (current)</a></p></td><td colspan="1"
rowspan="1" class="confluenceTd">same as current</td></tr><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Release Notes:</p></th><td colspan="1"
rowspan="1" class="confluenceTd"><p><a shape="rect"
href="release-notes-50.html">5.0</a></p><
/td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
href="release-notes-51.html">5.1</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect"
href="release-notes-52.html">5.2</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" href="release-notes.html">5.3.7
(current)</a></p></td><td colspan="1" rowspan="1" class="confluenceTd">not yet
available</td></tr></tbody></table></div><p><sup>1</sup> needs to be built
manually from archived sources at <a shape="rect" class="external-link"
href="http://archive.apache.org/dist/tapestry/";>http://archive.apache.org/dist/tapestry/</a>.</p><h1
id="Documentation-UserGuide">User Guide</h1><p><span
class="confluence-anchor-link" id="Documentation-userguide"></span>The <a
shape="rect" href="user-guide.html">User Guide</a> consists of over 75 pages of
detailed information on the concepts behind Tapestry and instructions on how to
use this powerful tool. Highlights include:</p><ul><l
i><a shape="rect" href="legacy-javascript.html">Legacy JavaScript</a> and <a
shape="rect" href="ajax-and-zones.html">Ajax and Zones</a> describe Tapestry's
built-in support for dynamic in-page behavior.</li><li><a shape="rect"
href="integrating-with-spring-framework.html">Integrating with Spring
Framework</a> describes how to integrate Spring into your Tapestry
application.</li><li><a shape="rect" href="hibernate.html">Tapestry/Hibernate
Integration Library</a> provides out-of-the-box support for using Hibernate
3.</li><li><a shape="rect" href="bean-validation.html">JSR 303: Bean
Validation</a> shows how to use standard annotations for validation</li><li><a
shape="rect" href="integration-testing.html">Integration Testing</a> shows how
to test your application with Selenium.</li></ul><p><a shape="rect"
href="user-guide.html">More topics</a>...</p><h1
id="Documentation-BlogsbyTapestryDevelopersandtheCommunity">Blogs by Tapestry
Developers and the Community</h1><ul><li><a shape="rect"
class="external-link" href="http://tapestryjava.blogspot.com/"; >Tapestry
Central</a> is Howard Lewis Ship's blog. As the creator of Tapestry, he
provides valuable insights into Tapestry's latest features and future
directions.</li><li><a shape="rect" class="external-link"
href="http://blog.tapestry5.de/"; >Igor Drobiazko's blog</a> (committer &
PMC) contains news on Tapestry development and will guide you through some of
the most exciting parts of Tapestry.</li><li><a shape="rect"
class="external-link" href="http://tawus.wordpress.com/"; >Java Magic</a> (by
Taha Hafeez, committer) has a series of tutorials illustrating some of the more
advanced Tapestry and Plastic features and techniques.</li><li><a shape="rect"
class="external-link" href="http://blog.andyhot.gr/tag/tapestry/"; >Andreas
Andreou's blog</a> (committer & PMC) has news and commentary on
Tapestry.</li><li><a shape="rect" class="external-link"
href="http://spreadthesource.com/"; >Spread the Source blog</a> (Christoph
e Cordenier and Robin Komiwes) has news and advanced tutorials on Tapestry
5.</li></ul><h1 id="Documentation-BooksonTapestry">Books on
Tapestry</h1><p>There are at least 8 published <a shape="rect"
href="books.html">books on Tapestry</a>, including two on Tapestry 5 —
and more on the way.</p><h1 id="Documentation-ArticlesonTapestry">Articles on
Tapestry</h1><ul><li>This <a shape="rect" class="external-link"
href="http://www.laliluna.de/articles/the-web-framework-evaluation.html";
>eBook</a> published in 2009 contains a <a shape="rect" class="external-link"
href="http://www.laliluna.de/articles/2009/08/14/tapestry-web-framework-evaluation-and-test.html";
>good introduction and analysis of Tapestry 5</a></li></ul><ul><li><a
shape="rect" class="external-link"
href="http://www.infoq.com/articles/tapestry5-intro"; >Tapestry 5 for
Nonbelievers</a> will convince the skeptical why Tapestry is the best web
framework.</li></ul><p><a shape="rect" href="articles.html">More
articles</a>...</p
><h1 id="Documentation-TapestryPresentations">Tapestry
>Presentations</h1><ul><li>Mark W. Shead's <a shape="rect"
>class="external-link"
>href="http://blog.markwshead.com/900/tapestry-5-10-minute-demo/"; >10 Minute
>Demo</a></li><li>H. L. Ship's <a shape="rect" class="external-link"
>href="https://www.youtube.com/watch?v=5BGt7eMFC20"; >Tapestry 5.4 -
>Bootstrap-enhanced Exception Reporting</a></li><li><a shape="rect"
>class="external-link"
>href="http://jazoon.com/Portals/0/Content/slides/th_a7_1130-1220_drobiazko.pdf";
> >JavaServer Faces 2.0 vs. Tapestry 5</a> (PDF) A Head-to-Head Comparison by
>Igor Drobiazko at Jazoon 2010</li><li><a shape="rect" class="external-link"
>href="http://www.parleys.com/#st=5&sl=5&id=1700"; >Tapestry 5: Java
>power, Scripting Ease</a> (VIDEO) by Howard Lewis Ship at Devoxx
>2009</li></ul><p><a shape="rect" href="presentations.html">More
>presentations</a> ...</p><h1 id="Documentation-TapestryWikis">Tapestry
>Wikis</h1><ul><li><a shape="rect" class="external-link"
href="http://wiki.apache.org/tapestry/FrontPage";>Tapestry Community Wiki</a>
(Moin Moin) contains a lot of user-generated information on different Tapestry
use cases.</li><li><a shape="rect"
href="https://cwiki.apache.org/confluence/x/VCFkAQ";>Documentation Source
wiki</a> (Confluence) – the wiki used as the content editor for the
official Tapestry documentation</li></ul><h1
id="Documentation-Gettinghelp">Getting help</h1><p>The primary method of
support is the <a shape="rect" href="mailing-lists.html">Tapestry Mailing
Lists</a>.</p><p>In addition, there are occasionally questions and answers
about Tapestry at <a shape="rect" class="external-link"
href="http://stackoverflow.com/questions/tagged/tapestry"; >Stack
Overflow</a>.</p><h1 id="Documentation-TheDeveloperCorner">The Developer
Corner</h1><p><a shape="rect" href="developer-information.html">Developer
Information</a> gives information needed by the Tapestry
developers</p><p> </p></div>
+<div id="ConfluenceContent"><div style="float:right;margin-left:1em"><h2
id="Documentation-AllTopics">All Topics</h2><ul class="childpages-macro"><li><a
shape="rect" href="introduction.html">Introduction</a></li><li><a shape="rect"
href="getting-started.html">Getting Started</a></li><li><a shape="rect"
href="principles.html">Principles</a></li><li><a shape="rect"
href="tapestry-tutorial.html">Tapestry Tutorial</a><ul
class="childpages-macro"><li><a shape="rect"
href="dependencies-tools-and-plugins.html">Dependencies, Tools and
Plugins</a></li><li><a shape="rect"
href="creating-the-skeleton-application.html">Creating The Skeleton
Application</a></li><li><a shape="rect"
href="loading-the-project-into-eclipse.html">Loading the Project Into
Eclipse</a></li><li><a shape="rect" href="exploring-the-project.html">Exploring
the Project</a></li><li><a shape="rect"
href="implementing-the-hi-lo-guessing-game.html">Implementing the Hi-Lo
Guessing Game</a></li><li><a shape="rect" href="using-bean
editform-to-create-user-forms.html">Using BeanEditForm To Create User
Forms</a></li><li><a shape="rect"
href="using-tapestry-with-hibernate.html">Using Tapestry With
Hibernate</a></li></ul></li><li><a shape="rect" href="user-guide.html">User
Guide</a><ul class="childpages-macro"><li><a shape="rect"
href="project-layout.html">Project Layout</a></li><li><a shape="rect"
href="configuration.html">Configuration</a></li><li><a shape="rect"
href="runtime-exceptions.html">Runtime Exceptions</a></li><li><a shape="rect"
href="class-reloading.html">Class Reloading</a></li><li><a shape="rect"
href="component-reference.html">Component Reference</a></li><li><a shape="rect"
href="annotations.html">Annotations</a></li><li><a shape="rect"
href="component-classes.html">Component Classes</a></li><li><a shape="rect"
href="component-templates.html">Component Templates</a></li><li><a shape="rect"
href="property-expressions.html">Property Expressions</a></li><li><a
shape="rect" href="component-parameters.
html">Component Parameters</a></li><li><a shape="rect"
href="type-coercion.html">Type Coercion</a></li><li><a shape="rect"
href="layout-component.html">Layout Component</a></li><li><a shape="rect"
href="component-mixins.html">Component Mixins</a><ul
class="childpages-macro"><li><a shape="rect"
href="built-in-mixins.html">Built-in Mixins</a></li></ul></li><li><a
shape="rect" href="page-navigation.html">Page Navigation</a></li><li><a
shape="rect" href="localization.html">Localization</a></li><li><a shape="rect"
href="page-life-cycle.html">Page Life Cycle</a></li><li><a shape="rect"
href="request-processing.html">Request Processing</a></li><li><a shape="rect"
href="component-rendering.html">Component Rendering</a></li><li><a shape="rect"
href="component-events.html">Component Events</a></li><li><a shape="rect"
href="url-rewriting.html">URL rewriting</a></li><li><a shape="rect"
href="dom.html">DOM</a></li><li><a shape="rect"
href="response-compression.html">Response Compression</a></li>
<li><a shape="rect" href="security.html">Security</a></li><li><a shape="rect"
href="https.html">HTTPS</a></li><li><a shape="rect"
href="content-type-and-markup.html">Content Type and Markup</a></li><li><a
shape="rect" href="persistent-page-data.html">Persistent Page
Data</a></li><li><a shape="rect" href="session-storage.html">Session
Storage</a><ul class="childpages-macro"><li><a shape="rect"
href="clustering-issues.html">Clustering Issues</a></li></ul></li><li><a
shape="rect" href="injection.html">Injection</a></li><li><a shape="rect"
href="environmental-services.html">Environmental Services</a></li><li><a
shape="rect" href="css.html">CSS</a></li><li><a shape="rect"
href="assets.html">Assets</a></li><li><a shape="rect"
href="forms-and-validation.html">Forms and Validation</a></li><li><a
shape="rect" href="beaneditform-guide.html">BeanEditForm Guide</a></li><li><a
shape="rect" href="uploading-files.html">Uploading Files</a></li><li><a
shape="rect" href="logging.html">Logging</a></li
><li><a shape="rect" href="unit-testing-pages-or-components.html">Unit testing
>pages or components</a></li><li><a shape="rect"
>href="integration-testing.html">Integration Testing</a></li><li><a
>shape="rect" href="service-status.html">Service Status</a></li><li><a
>shape="rect" href="modules.html">Modules</a><ul
>class="childpages-macro"><li><a shape="rect"
>href="built-in-modules.html">Built In Modules</a></li><li><a shape="rect"
>href="third-party-modules.html">Third Party Modules</a></li></ul></li><li><a
>shape="rect" href="ioc.html">IoC</a><ul class="childpages-macro"><li><a
>shape="rect" href="tapestry-ioc-overview.html">Tapestry IoC
>Overview</a></li><li><a shape="rect"
>href="tapestry-ioc-modules.html">Tapestry IoC Modules</a></li><li><a
>shape="rect" href="defining-tapestry-ioc-services.html">Defining Tapestry IOC
>Services</a></li><li><a shape="rect" href="service-advisors.html">Service
>Advisors</a></li><li><a shape="rect"
>href="tapestry-ioc-decorators.html">Tapestry IoC Decorators</a
></li><li><a shape="rect" href="tapestry-ioc-configuration.html">Tapestry IoC
>Configuration</a></li><li><a shape="rect" href="case-insensitivity.html">Case
>Insensitivity</a></li><li><a shape="rect"
>href="autoloading-modules.html">Autoloading Modules</a></li><li><a
>shape="rect" href="service-implementation-reloading.html">Service
>Implementation Reloading</a></li><li><a shape="rect"
>href="ordering-by-constraints.html">Ordering by Constraints</a></li><li><a
>shape="rect" href="symbols.html">Symbols</a></li><li><a shape="rect"
>href="chainbuilder-service.html">ChainBuilder Service</a></li><li><a
>shape="rect" href="pipelinebuilder-service.html">PipelineBuilder
>Service</a></li><li><a shape="rect"
>href="shadowbuilder-service.html">ShadowBuilder Service</a></li><li><a
>shape="rect" href="strategybuilder-service.html">StrategyBuilder
>Service</a></li><li><a shape="rect" href="injection-in-detail.html">Injection
>in Detail</a></li><li><a shape="rect" href="object-providers.html">Object
>Providers</
a></li><li><a shape="rect" href="service-serialization.html">Service
Serialization</a></li><li><a shape="rect"
href="typecoercer-service.html">TypeCoercer Service</a></li><li><a shape="rect"
href="starting-the-ioc-registry.html">Starting the IoC Registry</a></li><li><a
shape="rect" href="registry-startup.html">Registry Startup</a></li><li><a
shape="rect" href="parallel-execution.html">Parallel Execution</a></li><li><a
shape="rect" href="logging-in-tapestry.html">Logging in Tapestry</a></li><li><a
shape="rect" href="using-jsr-330-standard-annotations.html">Using JSR 330
standard annotations</a></li><li><a shape="rect"
href="operation-tracker.html">Operation Tracker</a></li></ul></li><li><a
shape="rect" href="hibernate-core.html">Hibernate - Core</a><ul
class="childpages-macro"><li><a shape="rect"
href="hibernate-core-conf.html">Hibernate - Core - Conf</a></li><li><a
shape="rect" href="hibernate.html">Hibernate</a></li></ul></li><li><a
shape="rect" href="integrating-with-spring-framew
ork.html">Integrating with Spring Framework</a></li><li><a shape="rect"
href="bean-validation.html">Bean Validation</a></li><li><a shape="rect"
href="component-report.html">Component Report</a></li><li><a shape="rect"
href="aliases.html">Aliases</a></li><li><a shape="rect"
href="integrating-with-jpa.html">Integrating with JPA</a></li><li><a
shape="rect" href="client-side-javascript.html">Client-Side JavaScript</a><ul
class="childpages-macro"><li><a shape="rect"
href="javascript-modules.html">JavaScript Modules</a></li><li><a shape="rect"
href="coffeescript.html">CoffeeScript</a></li><li><a shape="rect"
href="legacy-javascript.html">Legacy JavaScript</a></li><li><a shape="rect"
href="ajax-and-zones.html">Ajax and Zones</a></li></ul></li></ul></li><li><a
shape="rect" href="cheat-sheets.html">Cheat Sheets</a><ul
class="childpages-macro"><li><a shape="rect"
href="application-module-class-cheat-sheet.html">Application Module Class Cheat
Sheet</a></li><li><a shape="rect" href="component-c
heat-sheet.html">Component Cheat Sheet</a></li><li><a shape="rect"
href="tapestry-for-jsf-users.html">Tapestry for JSF
Users</a></li></ul></li><li><a shape="rect"
href="cookbook.html">Cookbook</a><ul class="childpages-macro"><li><a
shape="rect" href="default-parameter.html">Default Parameter</a></li><li><a
shape="rect" href="overriding-exception-reporting.html">Overriding Exception
Reporting</a></li><li><a shape="rect" href="error-page-recipe.html">Error Page
Recipe</a></li><li><a shape="rect"
href="supporting-informal-parameters.html">Supporting Informal
Parameters</a></li><li><a shape="rect"
href="component-libraries.html">Component Libraries</a></li><li><a shape="rect"
href="switching-cases.html">Switching Cases</a></li><li><a shape="rect"
href="enum-parameter-recipe.html">Enum Parameter Recipe</a></li><li><a
shape="rect" href="extending-the-if-component.html">Extending the If
Component</a></li><li><a shape="rect"
href="meta-programming-page-content.html">Meta-Programming Page Co
ntent</a></li><li><a shape="rect" href="using-select-with-a-list.html">Using
Select With a List</a></li><li><a shape="rect" href="ioc-cookbook.html">IoC
cookbook</a><ul class="childpages-macro"><li><a shape="rect"
href="ioc-cookbook-basic-services-and-injection.html">IoC Cookbook - Basic
Services and Injection</a></li><li><a shape="rect"
href="ioc-cookbook-overriding-ioc-services.html">IoC Cookbook - Overriding IoC
Services</a></li><li><a shape="rect" href="ioc-cookbook-patterns.html">IoC
Cookbook - Patterns</a></li><li><a shape="rect"
href="ioc-cookbook-service-configurations.html">IoC cookbook - Service
Configurations</a></li></ul></li><li><a shape="rect"
href="performance-and-clustering.html">Performance and
Clustering</a></li></ul></li><li><a shape="rect"
href="frequently-asked-questions.html">Frequently Asked Questions</a><ul
class="childpages-macro"><li><a shape="rect"
href="general-questions.html">General Questions</a></li><li><a shape="rect"
href="templating-and-markup-faq.h
tml">Templating and Markup FAQ</a></li><li><a shape="rect"
href="page-and-component-classes-faq.html">Page And Component Classes
FAQ</a></li><li><a shape="rect" href="forms-and-form-components-faq.html">Forms
and Form Components FAQ</a></li><li><a shape="rect"
href="beaneditform-faq.html">BeanEditForm FAQ</a></li><li><a shape="rect"
href="link-components-faq.html">Link Components FAQ</a></li><li><a shape="rect"
href="component-events-faq.html">Component Events FAQ</a></li><li><a
shape="rect" href="javascript-faq.html">JavaScript FAQ</a></li><li><a
shape="rect" href="ajax-components-faq.html">Ajax Components FAQ</a></li><li><a
shape="rect" href="injection-faq.html">Injection FAQ</a></li><li><a
shape="rect" href="tapestry-inversion-of-control-faq.html">Tapestry Inversion
of Control FAQ</a></li><li><a shape="rect" href="security-faq.html">Security
FAQ</a></li><li><a shape="rect"
href="integration-with-existing-applications.html">Integration with existing
applications</a></li><li><a sha
pe="rect" href="request-processing-faq.html">Request Processing
FAQ</a></li><li><a shape="rect"
href="limitations.html">Limitations</a></li><li><a shape="rect"
href="specific-errors-faq.html">Specific Errors FAQ</a></li><li><a shape="rect"
href="hibernate-support-faq.html">Hibernate Support FAQ</a></li><li><a
shape="rect" href="maven-support-faq.html">Maven Support FAQ</a></li><li><a
shape="rect" href="release-upgrade-faq.html">Release Upgrade
FAQ</a></li></ul></li><li><a shape="rect" href="release-notes.html">Release
Notes</a><ul class="childpages-macro"><li><a shape="rect"
href="how-to-upgrade.html">How to Upgrade</a></li><li><a shape="rect"
href="release-notes-50.html">Release Notes 5.0</a></li><li><a shape="rect"
href="release-notes-51.html">Release Notes 5.1</a></li><li><a shape="rect"
href="release-notes-52.html">Release Notes 5.2</a><ul
class="childpages-macro"><li><a shape="rect"
href="release-notes-520.html">Release Notes 5.2.0</a></li><li><a shape="rect"
href="release-note
s-521.html">Release Notes 5.2.1</a></li><li><a shape="rect"
href="release-notes-522.html">Release Notes 5.2.2</a></li><li><a shape="rect"
href="release-notes-523.html">Release Notes 5.2.3</a></li><li><a shape="rect"
href="release-notes-524.html">Release Notes 5.2.4</a></li><li><a shape="rect"
href="release-notes-525.html">Release Notes 5.2.5</a></li><li><a shape="rect"
href="release-notes-526.html">Release Notes 5.2.6</a></li></ul></li><li><a
shape="rect" href="release-notes-53.html">Release Notes 5.3</a></li><li><a
shape="rect" href="release-notes-531.html">Release Notes 5.3.1</a></li><li><a
shape="rect" href="release-notes-532.html">Release Notes 5.3.2</a></li><li><a
shape="rect" href="release-notes-533.html">Release Notes 5.3.3</a></li><li><a
shape="rect" href="release-notes-534.html">Release Notes 5.3.4</a></li><li><a
shape="rect" href="release-notes-535.html">Release Notes 5.3.5</a></li><li><a
shape="rect" href="release-notes-536.html">Release Notes 5.3.6</a></li><li><a
shape="
rect" href="release-notes-537.html">Release Notes 5.3.7</a></li><li><a
shape="rect" href="release-notes-54.html">Release Notes
5.4</a></li></ul></li><li><a shape="rect"
href="javascript-rewrite.html">JavaScript Rewrite</a></li><li><a shape="rect"
href="support.html">Support</a></li><li><a shape="rect"
href="developer-information.html">Developer Information</a><ul
class="childpages-macro"><li><a shape="rect"
href="building-tapestry-from-source.html">Building Tapestry from
Source</a></li><li><a shape="rect" href="confluence-site-setup.html">Confluence
Site Setup</a><ul class="childpages-macro"><li><a shape="rect"
href="since-and-deprecated-user-macros.html">Since and Deprecated User
Macros</a></li></ul></li><li><a shape="rect"
href="developer-bible.html">Developer Bible</a></li><li><a shape="rect"
href="release-process.html">Release Process</a></li><li><a shape="rect"
href="the-tapestry-jail.html">The tapestry jail</a></li><li><a shape="rect"
href="version-numbers.html">Version Number
s</a></li></ul></li></ul></div><p>Welcome to the Tapestry 5 Documentation. A
rich collection of guides is available to teach beginners the basics and help
even experienced developers deepen their understanding of Tapestry's power.
<em>Code less, deliver more!</em></p><h1
id="Documentation-Highlights">Highlights</h1><p>These are the most useful
starting points for common needs.</p><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect"
href="introduction.html">Introduction</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>An overview of Tapestry's general approach and
philosophy</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" href="getting-started.html">Getting
Started</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A quick
guide to creating your first Tapestry project, using Maven</p></td></tr><tr><td
colspan="1" rowspan="1" class="confluen
ceTd"><p><a shape="rect" href="tapestry-tutorial.html">Tapestry
Tutorial</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Picks
up where <em>Getting Started</em> leaves off, explaining in greater detail how
Tapestry works</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" href="user-guide.html">User
Guide</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Detailed
articles on every Tapestry feature</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect"
href="community.html">Community</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Getting support, mailing lists, JIRA, outside
resources, and access to the source</p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p><a shape="rect"
href="cookbook.html">Cookbook</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Guides to doing common things with
Tapestry</p></td></tr><tr><td colspan="1" rowspan="1" cl
ass="confluenceTd"><p><strong><a shape="rect"
href="frequently-asked-questions.html">FAQ</a></strong></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>A quick place to check for common problems
and solutions</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect"
href="component-cheat-sheet.html">Component Cheat Sheet</a></p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>A concise guide to component
classes, methods and annotations</p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://refcardz.dzone.com/refcardz/apache-tapestry-50?oid=hom7948";
>Refcard</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>A
color, six page foldout guide to Tapestry 5.0
(PDF)</p></td></tr></tbody></table></div><h1
id="Documentation-APIandComponentReference">API and Component
Reference</h1><div class="table-wrap"><table
class="confluenceTable"><tbody><tr><th colspan="1" rowspan
="1" class="confluenceTh"><p>API (Javadoc):</p></th><td colspan="1"
rowspan="1" class="confluenceTd"><p>5.0<sup>1</sup></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>5.1<sup>1</sup></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>5.2<sup>1</sup></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link"
href="http://tapestry.apache.org/current/apidocs/";>5.3.7
(current)</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><a
shape="rect" class="external-link" href="http://tapestry.apache.org/5.4/";>5.4
(beta)</a></td></tr><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Component Reference:</p></th><td colspan="1"
rowspan="1" class="confluenceTd"><p>5.0<sup>1</sup></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>5.1<sup>1</sup></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>5.2<sup>1</sup></p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p><a shape="rect" href="component-r
eference.html">5.3.7 (current)</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd">same as current</td></tr><tr><th colspan="1" rowspan="1"
class="confluenceTh"><p>Release Notes:</p></th><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect"
href="release-notes-50.html">5.0</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect"
href="release-notes-51.html">5.1</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect"
href="release-notes-52.html">5.2</a></p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><a shape="rect" href="release-notes.html">5.3.7
(current)</a></p></td><td colspan="1" rowspan="1" class="confluenceTd">not yet
available</td></tr></tbody></table></div><p><sup>1</sup> needs to be built
manually from archived sources at <a shape="rect" class="external-link"
href="http://archive.apache.org/dist/tapestry/";>http://archive.apache.org/dist/tapestry/</a>.</p><h1
id="Documentation-UserGuide">User G
uide</h1><p><span class="confluence-anchor-link"
id="Documentation-userguide"></span>The <a shape="rect"
href="user-guide.html">User Guide</a> consists of over 75 pages of detailed
information on the concepts behind Tapestry and instructions on how to use this
powerful tool. Highlights include:</p><ul><li><a shape="rect"
href="legacy-javascript.html">Legacy JavaScript</a> and <a shape="rect"
href="ajax-and-zones.html">Ajax and Zones</a> describe Tapestry's built-in
support for dynamic in-page behavior.</li><li><a shape="rect"
href="integrating-with-spring-framework.html">Integrating with Spring
Framework</a> describes how to integrate Spring into your Tapestry
application.</li><li><a shape="rect" href="hibernate.html">Tapestry/Hibernate
Integration Library</a> provides out-of-the-box support for using Hibernate
3.</li><li><a shape="rect" href="bean-validation.html">JSR 303: Bean
Validation</a> shows how to use standard annotations for validation</li><li><a
shape="rect" href="integra
tion-testing.html">Integration Testing</a> shows how to test your application
with Selenium.</li></ul><p><a shape="rect" href="user-guide.html">More
topics</a>...</p><h1
id="Documentation-BlogsbyTapestryDevelopersandtheCommunity">Blogs by Tapestry
Developers and the Community</h1><ul><li><a shape="rect" class="external-link"
href="http://tapestryjava.blogspot.com/"; >Tapestry Central</a> is Howard Lewis
Ship's blog. As the creator of Tapestry, he provides valuable insights into
Tapestry's latest features and future directions.</li><li><a shape="rect"
class="external-link" href="http://blog.tapestry5.de/"; >Igor Drobiazko's
blog</a> (committer & PMC) contains news on Tapestry development and will
guide you through some of the most exciting parts of Tapestry.</li><li><a
shape="rect" class="external-link" href="http://tawus.wordpress.com/"; >Java
Magic</a> (by Taha Hafeez, committer) has a series of tutorials illustrating
some of the more advanced Tapestry and Plastic features and tec
hniques.</li><li><a shape="rect" class="external-link"
href="http://blog.andyhot.gr/tag/tapestry/"; >Andreas Andreou's blog</a>
(committer & PMC) has news and commentary on Tapestry.</li><li><a
shape="rect" class="external-link" href="http://spreadthesource.com/"; >Spread
the Source blog</a> (Christophe Cordenier and Robin Komiwes) has news and
advanced tutorials on Tapestry 5.</li></ul><h1
id="Documentation-BooksonTapestry">Books on Tapestry</h1><p>There are at least
8 published <a shape="rect" href="books.html">books on Tapestry</a>, including
two on Tapestry 5 — and more on the way.</p><h1
id="Documentation-ArticlesonTapestry">Articles on Tapestry</h1><ul><li>This <a
shape="rect" class="external-link"
href="http://www.laliluna.de/articles/the-web-framework-evaluation.html";
>eBook</a> published in 2009 contains a <a shape="rect" class="external-link"
href="http://www.laliluna.de/articles/2009/08/14/tapestry-web-framework-evaluation-and-test.html";
>good introduction and ana
lysis of Tapestry 5</a></li></ul><ul><li><a shape="rect" class="external-link"
href="http://www.infoq.com/articles/tapestry5-intro"; >Tapestry 5 for
Nonbelievers</a> will convince the skeptical why Tapestry is the best web
framework.</li></ul><p><a shape="rect" href="articles.html">More
articles</a>...</p><h1 id="Documentation-TapestryPresentations">Tapestry
Presentations</h1><ul><li>Mark W. Shead's <a shape="rect" class="external-link"
href="http://blog.markwshead.com/900/tapestry-5-10-minute-demo/"; >10 Minute
Demo</a></li><li>H. L. Ship's <a shape="rect" class="external-link"
href="https://www.youtube.com/watch?v=5BGt7eMFC20"; >Tapestry 5.4 -
Bootstrap-enhanced Exception Reporting</a></li><li><a shape="rect"
class="external-link"
href="http://jazoon.com/Portals/0/Content/slides/th_a7_1130-1220_drobiazko.pdf";
>JavaServer Faces 2.0 vs. Tapestry 5</a> (PDF) A Head-to-Head Comparison by
Igor Drobiazko at Jazoon 2010</li><li><a shape="rect" class="external-link"
href="http://www.parleys.
com/#st=5&sl=5&id=1700" >Tapestry 5: Java power, Scripting Ease</a>
(VIDEO) by Howard Lewis Ship at Devoxx 2009</li></ul><p><a shape="rect"
href="presentations.html">More presentations</a> ...</p><h1
id="Documentation-TapestryWikis">Tapestry Wikis</h1><ul><li><a shape="rect"
class="external-link" href="http://wiki.apache.org/tapestry/FrontPage";>Tapestry
Community Wiki</a> (Moin Moin) contains a lot of user-generated information on
different Tapestry use cases.</li><li><a shape="rect"
href="https://cwiki.apache.org/confluence/x/VCFkAQ";>Documentation Source
wiki</a> (Confluence) – the wiki used as the content editor for the
official Tapestry documentation</li></ul><h1
id="Documentation-Gettinghelp">Getting help</h1><p>The primary method of
support is the <a shape="rect" href="mailing-lists.html">Tapestry Mailing
Lists</a>.</p><p>In addition, there are occasionally questions and answers
about Tapestry at <a shape="rect" class="external-link"
href="http://stackoverflow.com
/questions/tagged/tapestry" >Stack Overflow</a>.</p><h1
id="Documentation-TheDeveloperCorner">The Developer Corner</h1><p><a
shape="rect" href="developer-information.html">Developer Information</a> gives
information needed by the Tapestry developers</p><p> </p></div>
</div>
<div class="clearer"></div>
Modified: websites/production/tapestry/content/exploring-the-project.html
==============================================================================
--- websites/production/tapestry/content/exploring-the-project.html (original)
+++ websites/production/tapestry/content/exploring-the-project.html Sun Nov 9
16:12:11 2014
@@ -364,13 +364,13 @@ var footnoteMarkerHighlight = function(i
-<span class="gliffy-container" id="gliffy-container-24346949-4634"
data-fullwidth="913" data-ceoid="24188263"
data-edit="${diagramEditLink.getLinkUrl()}"
data-full="/confluence/plugins/gliffy/viewer.action?inline=false&attachmentId=24346949&attachmentVersion=2&lastPage=%2Fpages%2Fviewpage.action%3FpageId%3D24188263"
data-filename="Templates and Parameters">
+<span class="gliffy-container" id="gliffy-container-24346949-6367"
data-fullwidth="913" data-ceoid="24188263"
data-edit="/confluence/plugins/gliffy/editor.action?name=Templates and
Parameters&ceoid=24188263&key=TAPESTRY&pageId=24188263&inline=false&lastPage=%2Fpages%2Fviewpage.action%3FpageId%3D24188263"
data-full="/confluence/plugins/gliffy/viewer.action?inline=false&name=Templates
and
Parameters&ceoid=24188263&key=TAPESTRY&pageId=24188263&attachmentId=24346949&attachmentVersion=2&lastPage=%2Fpages%2Fviewpage.action%3FpageId%3D24188263"
data-filename="Templates and Parameters">
- <map id="gliffy-map-24346949-9277" name="gliffy-map-24346949-9277"></map>
+ <map id="gliffy-map-24346949-9379" name="gliffy-map-24346949-9379"></map>
- <img class="gliffy-image gliffy-image-border"
id="gliffy-image-24346949-4634" width="304" height="300" data-full-width="913"
data-full-height="901"
src="https://cwiki.apache.org/confluence/download/attachments/24188263/Templates%20and%20Parameters.png?version=2&modificationDate=1371888025000&api=v2";
alt="Templates and Parameters" usemap="#gliffy-map-24346949-9277">
+ <img class="gliffy-image gliffy-image-border"
id="gliffy-image-24346949-6367" width="304" height="300" data-full-width="913"
data-full-height="901"
src="https://cwiki.apache.org/confluence/download/attachments/24188263/Templates%20and%20Parameters.png?version=2&modificationDate=1371888025000&api=v2";
alt="Templates and Parameters" usemap="#gliffy-map-24346949-9379">
- <map class="gliffy-dynamic" id="gliffy-dynamic-map-24346949-4634"
name="gliffy-dynamic-map-24346949-4634"></map>
+ <map class="gliffy-dynamic" id="gliffy-dynamic-map-24346949-6367"
name="gliffy-dynamic-map-24346949-6367"></map>
</span>
Modified: websites/production/tapestry/content/forms-and-validation.html
==============================================================================
--- websites/production/tapestry/content/forms-and-validation.html (original)
+++ websites/production/tapestry/content/forms-and-validation.html Sun Nov 9
16:12:11 2014
@@ -101,11 +101,11 @@
</div>
</li></ul>
</div><p>The life's blood of any application is form input; this is the most
effective way to gather significant information from the user. Whether it's a
search form, a login screen or a multi-page registration wizard, forms are how
the user really expresses themselves to the application.</p><p>Tapestry excels
at creating forms and validating input. Input validation is declarative,
meaning you simply tell Tapestry what validations to apply to a given field,
and it takes care of it on the server and (once implemented) on the client as
well.</p><p>Finally, Tapestry is able to not only present the errors back to
the user, but to decorate the fields and the labels for the fields, marking
them as containing errors (primarily, using CSS
effects).</p><p><strong>Contents</strong></p><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1411690801523 {padding: 0px;}
-div.rbtoc1411690801523 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1411690801523 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1415548158572 {padding: 0px;}
+div.rbtoc1415548158572 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1415548158572 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1411690801523">
+/*]]>*/</style></p><div class="toc-macro rbtoc1415548158572">
<ul class="toc-indentation"><li>Related Articles</li></ul>
<ul><li><a shape="rect" href="#FormsandValidation-TheFormComponent">The Form
Component</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#FormsandValidation-FormEvents">Form Events</a></li><li><a shape="rect"
href="#FormsandValidation-TrackingValidationErrors">Tracking Validation
Errors</a></li><li><a shape="rect"
href="#FormsandValidation-StoringDataBetweenRequests">Storing Data Between
Requests</a></li><li><a shape="rect"
href="#FormsandValidation-ConfiguringFieldsandLabels">Configuring Fields and
Labels</a></li><li><a shape="rect"
href="#FormsandValidation-ErrorsandDecorations">Errors and
Decorations</a></li></ul>
@@ -200,7 +200,7 @@ div.rbtoc1411690801523 li {margin-left:
</body>
</html>
]]></script>
-</div></div><p>The Tapestry Form component is responsible for creating the
necessary URL for the form submission (this is Tapestry's responsibility, not
yours).</p><p>The <a shape="rect" class="external-link"
href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Errors.html";>Errors</a>
component must be placed inside a Form, it outputs all of the errors for all
the fields within the Form as a single list. It uses some simple styling to
make the result more presentable.</p><p>Each field component, such as the
TextField, is paired with a <a shape="rect" class="external-link"
href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Label.html";>Label</a>
component. The Label will render out a <label> element connected to the
field. This is very important for usability, especially for users with visual
disabilities. It also means you can click on the label text to move the cursor
to the corresponding field.</p><p>Th
e <code>for</code> parameter of the Label is the id of a component.</p><p>For
the TextField, we provide a component id, userName. We could specify the
<code>value</code> parameter, but the default is to match the TextField's id
against a property of the container, the Login page, if such a property
exists.</p><p>As a rule of thumb, you should always give your fields a specific
id (this id will be used to generate the <code>name</code> and <code>id</code>
attributes of the rendered tag). Being allowed to omit the value parameter
helps to keep the template from getting too cluttered.</p><p>The
<code>validate</code> parameter identifies what validations should occur for
the field. This is a list of validator names. Validators are configured within
Tapestry, and the list of available validators is extensible. "required" is a
name of one of the built-in validators, that ensures that the submitted value
is not the empty string. Likewise, "minlen" ensures that the value has the
specified m
inimum length.</p><p>The <code>validate</code> parameter was placed within the
Tapestry namespace using the <code>t:</code> prefix. This is not strictly
necessary, as the template is <em>well formed</em> either way. However, putting
the Tapestry specific values into the Tapestry namespace ensures that the
template will itself be <em>valid</em>.</p><h2
id="FormsandValidation-ErrorsandDecorations">Errors and
Decorations</h2><p><strong>Note: This section has not been updated to reflect
the introduction of client-side input validation.</strong></p><p>When you first
activate the Login page, the fields and forms will render normally, awaiting
input:</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/22872109/validation_initial.png?version=1&modificationDate=1276677599000&api=v2";
data-image-src="/confluence/download/attachments/22872109/validation_initial.png?version=1&modificationDate=1276677599000&api=v2"
title="Init
ial form presentation"></p><p>Notice how the Label components are displaying
the textual names for the fields. Given that we have not done any explicit
configuration, what's happened is that the component's ids ("userName" and
"password") have been converted to "User Name" and "Password".</p><p>If you
just submit the form as is, the fields will violate the "required" constraint
and the page will be redisplayed to present those errors to the
user:</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/22872109/validation_errors.png?version=1&modificationDate=1276677599000&api=v2";
data-image-src="/confluence/download/attachments/22872109/validation_errors.png?version=1&modificationDate=1276677599000&api=v2"
title="Errors and decorations"></p><p>There's a couple of subtle things going
on here. First, Tapestry tracks <em>all</em> the errors for <em>all</em> the
fields. The Errors component has displayed them at the top
of the form. Further, the <em>default validation decorator</em> has added
decorations to the labels and the fields, adding "t-error" to the CSS class for
the fields and labels. Tapestry provides a default CSS stylesheet that combines
with the "t-error" class to make things turn red.</p><p>Next, we'll fill in the
user name but not provide enough characters for password.</p><p><img
class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/22872109/validation_minlength.png?version=1&modificationDate=1276677600000&api=v2";
data-image-src="/confluence/download/attachments/22872109/validation_minlength.png?version=1&modificationDate=1276677600000&api=v2"
title="Minlength error message"></p><p>The user name field is OK, but there's
an error on just the password field. The PasswordField component always
displays a blank value by default, otherwise we'd see the partial password
displayed inside.</p><p>If you type in enough characters and s
ubmit, we see how the logic inside the Login page can attach errors to
fields:</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/22872109/validation_password.png?version=1&modificationDate=1276677600000&api=v2";
data-image-src="/confluence/download/attachments/22872109/validation_password.png?version=1&modificationDate=1276677600000&api=v2"
title="Application supplied errors"></p><p>This is nice and seamless; the same
look and feel and behavior for both the built-in validators, and for errors
generated based on application logic.</p><h1
id="FormsandValidation-FormValidation">Form Validation</h1><h2
id="FormsandValidation-AvailableValidators">Available
Validators</h2><p>Tapestry provides the following built-in validators:</p><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Validator</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>Con
straint Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Example</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>email</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>–</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Ensures that the given input looks like a valid e-mail
address</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield value="email" validate="email"
/></code></p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>max</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>long</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Enforces a maximum integer value</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code><t:textfield
value="age" validate="max=120,min=0" /></code></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>maxLength</p></td><t
d colspan="1" rowspan="1" class="confluenceTd"><p>int</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Makes sure that a string value has a
maximum length</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield value="zip"
validate="maxlength=7" /></code></p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>min</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>long</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Enforces a minimum integer value</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code><t:textfield
value="age" validate="max=120,min=0" /></code></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>minLength</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>int</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Makes sure that a string value has a
minimum length</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield v
alue="somefield" validate="minlength=1" /></code></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>none</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>–</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Does nothing (used to override a @Validate
annotation)</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield value="somefield" validate="none"
/></code></p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>regexp</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>pattern</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Makes sure that a string value conforms to a given
pattern</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield value="letterfield"
validate="regexp=^</code><code>[A-Za-z]+$" /></code></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>required</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p
>–</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Makes
>sure that a string value is not null and not the empty string</p></td><td
>colspan="1" rowspan="1" class="confluenceTd"><p><code><t:textfield
>value="name" validate="required"
>/></code></p></td></tr></tbody></table></div><h2
>id="FormsandValidation-CentralizingValidationwith@Validate">Centralizing
>Validation with @Validate</h2><p>The @<a shape="rect" class="external-link"
>href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/beaneditor/Validate.html";>Validate</a>
> annotation can take the place of the validate parameter of TextField,
>PasswordField, TextArea and other components. When the validate parameter is
>not bound, the component will check for the @Validate annotation and use its
>value as the validation definition.</p><p>The annotation may be placed on the
>getter or setter method, or on the field itself.</p><h2
>id="FormsandValidation-CustomizingValidationMessages">Customizing Validation
Messages</h2><p>Each validator (such as "required" or "minlength") has a
default message used (on the client side and the server side) when the
constraint is violated; that is, when the user input is not valid.</p><p>The
message can be customized by adding an entry to the page's <a shape="rect"
href="localization.html">message catalog</a> (or the containing component's
message catalog). As with any localized property, this can also go into the
application's message catalog.</p><p>The first key checked is
<em>formId</em>-<em>fieldId</em>-<em>validatorName</em>-message.</p><ul><li>formId:
the local component id of the Form component</li><li>fieldId: the local
component id of the field (TextField, etc.)</li><li>validatorName: the name of
the validator, i.e., "required" or "minlength"<br clear="none"> If there is not
message for that key, a second check is made, for
<em>fieldId</em>-<em>validatorName</em>-message.</li></ul><p>If that does not
match a message, then the built-in default v
alidation message is used.</p><h3
id="FormsandValidation-CustomizingValidationMessagesforBeanEditForm">Customizing
Validation Messages for BeanEditForm</h3><p>The <a shape="rect"
href="beaneditform-guide.html">BeanEditForm</a> component also supports
validation message customizing. The search for messages is similar; the
<em>formId</em> is the component id of the BeanEditForm component (not the Form
component it contains). The <em>fieldId</em> is the property name.</p><h2
id="FormsandValidation-ConfiguringValidatorContraintsintheMessageCatalog">Configuring
Validator Contraints in the Message Catalog</h2><p>It is possible to omit the
validation constraint from the validate parameter (or @Validator annotation),
in which case it is expected to be stored in the message catalog.</p><p>This is
useful when the validation constraint is awkward to enter inline, such as a
regular expression for use with the regexp validator.</p><p>The key here is
similar to customizing the validation message:
<em>formId</em>-<em>fieldId</em>-<em>validatorName</em> or just
<em>fieldId</em>-<em>validatorName</em>.</p><p>For example, your template may
have the following:</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
+</div></div><p>The Tapestry Form component is responsible for creating the
necessary URL for the form submission (this is Tapestry's responsibility, not
yours).</p><p>The <a shape="rect" class="external-link"
href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Errors.html";>Errors</a>
component must be placed inside a Form, it outputs all of the errors for all
the fields within the Form as a single list. It uses some simple styling to
make the result more presentable.</p><p>Each field component, such as the
TextField, is paired with a <a shape="rect" class="external-link"
href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/corelib/components/Label.html";>Label</a>
component. The Label will render out a <label> element connected to the
field. This is very important for usability, especially for users with visual
disabilities. It also means you can click on the label text to move the cursor
to the corresponding field.</p><p>Th
e <code>for</code> parameter of the Label is the id of a component.</p><p>For
the TextField, we provide a component id, userName. We could specify the
<code>value</code> parameter, but the default is to match the TextField's id
against a property of the container, the Login page, if such a property
exists.</p><p>As a rule of thumb, you should always give your fields a specific
id (this id will be used to generate the <code>name</code> and <code>id</code>
attributes of the rendered tag). Being allowed to omit the value parameter
helps to keep the template from getting too cluttered.</p><p>The
<code>validate</code> parameter identifies what validations should occur for
the field. This is a list of validator names. Validators are configured within
Tapestry, and the list of available validators is extensible. "required" is a
name of one of the built-in validators, that ensures that the submitted value
is not the empty string. Likewise, "minlength ensures that the value has the
specified
minimum length.</p><p>The <code>validate</code> parameter was placed within
the Tapestry namespace using the <code>t:</code> prefix. This is not strictly
necessary, as the template is <em>well formed</em> either way. However, putting
the Tapestry specific values into the Tapestry namespace ensures that the
template will itself be <em>valid</em>.</p><h2
id="FormsandValidation-ErrorsandDecorations">Errors and
Decorations</h2><p><strong>Note: This section has not been updated to reflect
the introduction of client-side input validation.</strong></p><p>When you first
activate the Login page, the fields and forms will render normally, awaiting
input:</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/22872109/validation_initial.png?version=1&modificationDate=1276677599000&api=v2";
data-image-src="/confluence/download/attachments/22872109/validation_initial.png?version=1&modificationDate=1276677599000&api=v2"
title="In
itial form presentation"></p><p>Notice how the Label components are displaying
the textual names for the fields. Given that we have not done any explicit
configuration, what's happened is that the component's ids ("userName" and
"password") have been converted to "User Name" and "Password".</p><p>If you
just submit the form as is, the fields will violate the "required" constraint
and the page will be redisplayed to present those errors to the
user:</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/22872109/validation_errors.png?version=1&modificationDate=1276677599000&api=v2";
data-image-src="/confluence/download/attachments/22872109/validation_errors.png?version=1&modificationDate=1276677599000&api=v2"
title="Errors and decorations"></p><p>There's a couple of subtle things going
on here. First, Tapestry tracks <em>all</em> the errors for <em>all</em> the
fields. The Errors component has displayed them at the to
p of the form. Further, the <em>default validation decorator</em> has added
decorations to the labels and the fields, adding "t-error" to the CSS class for
the fields and labels. Tapestry provides a default CSS stylesheet that combines
with the "t-error" class to make things turn red.</p><p>Next, we'll fill in the
user name but not provide enough characters for password.</p><p><img
class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/22872109/validation_minlength.png?version=1&modificationDate=1276677600000&api=v2";
data-image-src="/confluence/download/attachments/22872109/validation_minlength.png?version=1&modificationDate=1276677600000&api=v2"
title="Minlength error message"></p><p>The user name field is OK, but there's
an error on just the password field. The PasswordField component always
displays a blank value by default, otherwise we'd see the partial password
displayed inside.</p><p>If you type in enough characters and
submit, we see how the logic inside the Login page can attach errors to
fields:</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/22872109/validation_password.png?version=1&modificationDate=1276677600000&api=v2";
data-image-src="/confluence/download/attachments/22872109/validation_password.png?version=1&modificationDate=1276677600000&api=v2"
title="Application supplied errors"></p><p>This is nice and seamless; the same
look and feel and behavior for both the built-in validators, and for errors
generated based on application logic.</p><h1
id="FormsandValidation-FormValidation">Form Validation</h1><h2
id="FormsandValidation-AvailableValidators">Available
Validators</h2><p>Tapestry provides the following built-in validators:</p><div
class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1"
rowspan="1" class="confluenceTh"><p>Validator</p></th><th colspan="1"
rowspan="1" class="confluenceTh"><p>C
onstraint Type</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Description</p></th><th colspan="1" rowspan="1"
class="confluenceTh"><p>Example</p></th></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>email</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>–</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Ensures that the given input looks like a valid e-mail
address</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield value="email" validate="email"
/></code></p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>max</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>long</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Enforces a maximum integer value</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code><t:textfield
value="age" validate="max=120,min=0" /></code></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>maxLength</p></td>
<td colspan="1" rowspan="1" class="confluenceTd"><p>int</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>Makes sure that a string value
has a maximum length</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield value="zip"
validate="maxlength=7" /></code></p></td></tr><tr><td colspan="1"
rowspan="1" class="confluenceTd"><p>min</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>long</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Enforces a minimum integer value</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code><t:textfield
value="age" validate="max=120,min=0" /></code></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>minLength</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p>int</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>Makes sure that a string value has a
minimum length</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield
value="somefield" validate="minlength=1" /></code></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>none</p></td><td colspan="1"
rowspan="1" class="confluenceTd"><p>–</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Does nothing (used to override a @Validate
annotation)</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield value="somefield" validate="none"
/></code></p></td></tr><tr><td colspan="1" rowspan="1"
class="confluenceTd"><p>regexp</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>pattern</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p>Makes sure that a string value conforms to a given
pattern</p></td><td colspan="1" rowspan="1"
class="confluenceTd"><p><code><t:textfield value="letterfield"
validate="regexp=^</code><code>[A-Za-z]+$" /></code></p></td></tr><tr><td
colspan="1" rowspan="1" class="confluenceTd"><p>required</p></td><td
colspan="1" rowspan="1" class="confluenceTd">
<p>–</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Makes
sure that a string value is not null and not the empty string</p></td><td
colspan="1" rowspan="1" class="confluenceTd"><p><code><t:textfield
value="name" validate="required"
/></code></p></td></tr></tbody></table></div><h2
id="FormsandValidation-CentralizingValidationwith@Validate">Centralizing
Validation with @Validate</h2><p>The @<a shape="rect" class="external-link"
href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/beaneditor/Validate.html";>Validate</a>
annotation can take the place of the validate parameter of TextField,
PasswordField, TextArea and other components. When the validate parameter is
not bound, the component will check for the @Validate annotation and use its
value as the validation definition.</p><p>The annotation may be placed on the
getter or setter method, or on the field itself.</p><h2
id="FormsandValidation-CustomizingValidationMessages">Customizing Validatio
n Messages</h2><p>Each validator (such as "required" or "minlength") has a
default message used (on the client side and the server side) when the
constraint is violated; that is, when the user input is not valid.</p><p>The
message can be customized by adding an entry to the page's <a shape="rect"
href="localization.html">message catalog</a> (or the containing component's
message catalog). As with any localized property, this can also go into the
application's message catalog.</p><p>The first key checked is
<em>formId</em>-<em>fieldId</em>-<em>validatorName</em>-message.</p><ul><li>formId:
the local component id of the Form component</li><li>fieldId: the local
component id of the field (TextField, etc.)</li><li>validatorName: the name of
the validator, i.e., "required" or "minlength"<br clear="none"> If there is not
message for that key, a second check is made, for
<em>fieldId</em>-<em>validatorName</em>-message.</li></ul><p>If that does not
match a message, then the built-in default
validation message is used.</p><h3
id="FormsandValidation-CustomizingValidationMessagesforBeanEditForm">Customizing
Validation Messages for BeanEditForm</h3><p>The <a shape="rect"
href="beaneditform-guide.html">BeanEditForm</a> component also supports
validation message customizing. The search for messages is similar; the
<em>formId</em> is the component id of the BeanEditForm component (not the Form
component it contains). The <em>fieldId</em> is the property name.</p><h2
id="FormsandValidation-ConfiguringValidatorContraintsintheMessageCatalog">Configuring
Validator Contraints in the Message Catalog</h2><p>It is possible to omit the
validation constraint from the validate parameter (or @Validator annotation),
in which case it is expected to be stored in the message catalog.</p><p>This is
useful when the validation constraint is awkward to enter inline, such as a
regular expression for use with the regexp validator.</p><p>The key here is
similar to customizing the validation messag
e: <em>formId</em>-<em>fieldId</em>-<em>validatorName</em> or just
<em>fieldId</em>-<em>validatorName</em>.</p><p>For example, your template may
have the following:</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[ <t:textfield t:id="ssn"
validate="required,regexp"/>
]]></script>
</div></div><p>And your message catalog can contain:</p><div class="code panel
pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
Modified: websites/production/tapestry/content/home.html
==============================================================================
--- websites/production/tapestry/content/home.html (original)
+++ websites/production/tapestry/content/home.html Sun Nov 9 16:12:11 2014
@@ -61,23 +61,7 @@
</div>
<div id="content">
-<div id="ConfluenceContent"><p>This is the home page of the Apache Tapestry
wiki space in Confluence. The public home page is the <a shape="rect"
href="index.html">Index</a> page.</p>
-
-<p>From here you can go to</p>
-
-<ul><li><a shape="rect" href="index.html">Index</a> – the entry page for
the auto-generated website</li><li><a shape="rect"
href="documentation.html">Documentation</a> – the documentation main
page</li><li><a shape="rect" href="sandbox.html">Sandbox</a> – a sandbox
for developing new ideas and testing things out</li><li><a shape="rect"
href="board-reports.html">Board Reports</a> – Quarterly reports to the
Apache Board</li></ul>
-
-
-<p>After posting a new blog entry, you should update the following pages, to
force the new content to be included:</p>
-
-<ul><li><a shape="rect" href="index.html">Index</a></li><li><a shape="rect"
href="news.html">News</a></li></ul>
-
-
-<h2 id="Home-TODOList">TODO List</h2>
-
-<p>A quick place to jot down notes on work needed to be done.</p>
-
-<ul><li>Use of symbols to define (some) component parameter
defaults</li><li>Update examples r.e. use of Maven Archetype</li><li>Document
ResourceTranslators</li><li>Discuss OperationTracker</li><li>Discuss
PageCatalog page</li><li>Document that public static fields are also treated as
properties</li><li>Document AlertManager</li><li>Document 5.4 component fields
may be non-private (even public, if final)</li></ul></div>
+<div id="ConfluenceContent"><p>This is the home page of the Apache Tapestry
wiki space in Confluence. The public home page is the <a shape="rect"
href="index.html">Index</a> page.</p><p>From here you can go to</p><ul><li><a
shape="rect" href="index.html">Index</a> – the entry page for the
auto-generated website</li><li><a shape="rect"
href="documentation.html">Documentation</a> – the documentation main
page</li><li><a shape="rect" href="sandbox.html">Sandbox</a> – a sandbox
for developing new ideas and testing things out</li><li><a shape="rect"
href="board-reports.html">Board Reports</a> – Quarterly reports to the
Apache Board</li></ul><p>After posting a new blog entry, you should update the
following pages, to force the new content to be included:</p><ul><li><a
shape="rect" href="index.html">Index</a></li><li><a shape="rect"
href="news.html">News</a></li></ul><h2 id="Home-TODOList">TODO List</h2><p>A
quick place to jot down notes on work needed to be done.</
p><ul><li>Use of symbols to define (some) component parameter
defaults</li><li>Update examples r.e. use of Maven Archetype</li><li>Document
ResourceTranslators</li><li><span style="line-height: 1.4285715;">Discuss
PageCatalog page</span></li><li>Document that public static fields are also
treated as properties</li><li>Document AlertManager</li><li>Document 5.4
component fields may be non-private (even public, if final)</li></ul></div>
</div>
<div class="clearer"></div>
Modified: websites/production/tapestry/content/index.html
==============================================================================
--- websites/production/tapestry/content/index.html (original)
+++ websites/production/tapestry/content/index.html Sun Nov 9 16:12:11 2014
@@ -185,7 +185,12 @@ Tapestry 5.4-beta-22 contains a signific
This release is available from the Maven Central Repository, or as
a direct download.…
</div>
+
+ <div class="endsection">
+ <a shape="rect"
href="/confluence/pages/editblogpost.action?pageId=46633206">Edit</a>
+
+ </div>
</div>
@@ -210,16 +215,21 @@ This release is available from the Maven
While not an actual release candidate,…
</div>
+
+ <div class="endsection">
+ <a shape="rect"
href="/confluence/pages/editblogpost.action?pageId=41812917">Edit</a>
+
+ </div>
</div>
<div class="blog-post-listing">
<div class="logo-heading-block">
<span class="logoBlock">
- <a shape="rect" class="userLogoLink" href="
/confluence/display/~bobharner ">
- <img class="userLogo logo"
src="https://cwiki.apache.org/confluence/images/icons/profilepics/default.png";
alt="User icon: bobharner" title="bobharner">
- </a> </span>
+ <a shape="rect" class="userLogoLink"
href="/confluence/users/editmyprofilepicture.action" title="Add a picture of
yourself">
+ <img class="userLogo logo defaultLogo"
src="https://cwiki.apache.org/confluence/s/en_GB-1988229788/4109/76e0dbb30bc8580e459c201f3535d84f9283a9ac.1/_/images/icons/profilepics/add_profile_pic.png";
alt="User icon: Add a picture of yourself">
+ </a> </span>
<span class="blogHeading">
<a shape="rect" class="blogHeading"
href="2014/03/07/tapestry-54-beta-3-preview-now-available.html">Tapestry
5.4-beta-3 preview now available</a>
</span><div class="page-metadata not-personal"><a shape="rect"
class="url fn confluence-userlink" href=" /confluence/display/~bobharner
">Bob Harner</a> posted on Mar 07, 2014</div>
@@ -232,7 +242,12 @@ While not an actual release candidate, b
If you're using Maven (or Gradle or Ivy, etc),…
</div>
+
+ <div class="endsection">
+ <a shape="rect"
href="/confluence/pages/editblogpost.action?pageId=39622379">Edit</a>
+
+ </div>
</div>
</div><div class="big-col" id="content"><p>
Modified: websites/production/tapestry/content/integrating-with-jpa.html
==============================================================================
--- websites/production/tapestry/content/integrating-with-jpa.html (original)
+++ websites/production/tapestry/content/integrating-with-jpa.html Sun Nov 9
16:12:11 2014
@@ -83,11 +83,11 @@
<div style="border-right: 20px solid #D8E4F1;border-left: 20px solid #D8E4F1;">
<p> </p></div><p>Starting with Tapestry 5.3, Tapestry provides built-in
integration with the Java Persistence API (JPA). This module supersedes <a
shape="rect" class="external-link" href="http://tynamo.org/tapestry-jpa+guide";
>Tynamo's JPA integration</a>.</p><p><strong>Contents</strong></p><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1409271669214 {padding: 0px;}
-div.rbtoc1409271669214 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1409271669214 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1415548159023 {padding: 0px;}
+div.rbtoc1415548159023 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1415548159023 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1409271669214">
+/*]]>*/</style></p><div class="toc-macro rbtoc1415548159023">
<ul class="toc-indentation"><li><a shape="rect"
href="#IntegratingwithJPA-ConfiguringJPA">Configuring JPA</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#IntegratingwithJPA-XML-lessJPAconfiguration">XML-less JPA
configuration</a></li><li><a shape="rect"
href="#IntegratingwithJPA-Automaticallyaddingmanagedclasses">Automatically
adding managed classes</a></li></ul>
</li><li><a shape="rect"
href="#IntegratingwithJPA-InjectingtheEntityManager">Injecting the
EntityManager</a>
Modified:
websites/production/tapestry/content/integrating-with-spring-framework.html
==============================================================================
--- websites/production/tapestry/content/integrating-with-spring-framework.html
(original)
+++ websites/production/tapestry/content/integrating-with-spring-framework.html
Sun Nov 9 16:12:11 2014
@@ -92,11 +92,11 @@
</div>
</li></ul>
</div><p>Tapestry easily integrates with Spring Framework, allowing beans
defined by Spring to be injected into Tapestry IoC services, and into Tapestry
components. In addition, with Tapestry 5.2 and later, you can also go the other
way, injecting Tapestry services in Spring beans.</p><p>For integrating Spring
Security into your application, see <a shape="rect"
href="security.html">Security</a>.</p><p><strong>Contents</strong></p><p><style
type="text/css">/*<![CDATA[*/
-div.rbtoc1411690812067 {padding: 0px;}
-div.rbtoc1411690812067 ul {list-style: disc;margin-left: 0px;}
-div.rbtoc1411690812067 li {margin-left: 0px;padding-left: 0px;}
+div.rbtoc1415548077332 {padding: 0px;}
+div.rbtoc1415548077332 ul {list-style: disc;margin-left: 0px;}
+div.rbtoc1415548077332 li {margin-left: 0px;padding-left: 0px;}
-/*]]>*/</style></p><div class="toc-macro rbtoc1411690812067">
+/*]]>*/</style></p><div class="toc-macro rbtoc1415548077332">
<ul class="toc-indentation"><li>Related Articles</li></ul>
<ul><li><a shape="rect"
href="#IntegratingwithSpringFramework-SpringVersion">Spring
Version</a></li><li><a shape="rect"
href="#IntegratingwithSpringFramework-Usage">Usage</a>
<ul class="toc-indentation"><li><a shape="rect"
href="#IntegratingwithSpringFramework-Requireddependency">Required
dependency</a></li><li><a shape="rect"
href="#IntegratingwithSpringFramework-Updateyourweb.xmlfile">Update your
web.xml file</a></li><li><a shape="rect"
href="#IntegratingwithSpringFramework-AccessingtheSpringApplicationContext">Accessing
the Spring Application Context</a></li><li><a shape="rect"
href="#IntegratingwithSpringFramework-Injectingbeans">Injecting
beans</a></li><li><a shape="rect"
href="#IntegratingwithSpringFramework-InjectingTapestryservicesinSpringbeans">Injecting
Tapestry services in Spring beans</a></li></ul>
![https://cwiki.apache.org/confluence/download/attachments/24188263/Templates%20and%20Parameters.png?version=2&modificationDate=1371888025000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/24188263/Templates%20and%20Parameters.png?version=2&modificationDate=1371888025000&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/22872109/validation_initial.png?version=1&modificationDate=1276677599000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/22872109/validation_initial.png?version=1&modificationDate=1276677599000&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/22872109/validation_errors.png?version=1&modificationDate=1276677599000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/22872109/validation_errors.png?version=1&modificationDate=1276677599000&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/22872109/validation_minlength.png?version=1&modificationDate=1276677600000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/22872109/validation_minlength.png?version=1&modificationDate=1276677600000&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/22872109/validation_password.png?version=1&modificationDate=1276677600000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/22872109/validation_password.png?version=1&modificationDate=1276677600000&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/images/icons/profilepics/default.png"](https://cwiki.apache.org/confluence/images/icons/profilepics/default.png"){kind=link}
![https://cwiki.apache.org/confluence/s/en_GB-1988229788/4109/76e0dbb30bc8580e459c201f3535d84f9283a9ac.1/_/images/icons/profilepics/add_profile_pic.png"](https://cwiki.apache.org/confluence/s/en_GB-1988229788/4109/76e0dbb30bc8580e459c201f3535d84f9283a9ac.1/_/images/icons/profilepics/add_profile_pic.png"){kind=link}