Tapestry User's Guide

Howard Lewis Ship


Table of Contents

1. Introduction
An overview of Tapestry
Pages and components
Engines, services and friends
Object Graph Navigation Language
2. Page and component templates
Template locations
Template Contents
Components in templates
Component bodies
Component ids
Specifying parameters
Formal and informal parameters
Template directives
Localization
$remove$ jwcid
$content$ jwcid
3. Creating Tapestry components
Introduction
Component Specifications
Coding components
Component Parameters
Using Bindings
Connected Parameter Properties
Component Libraries
Referencing Library Components
Library component search path
Using Private Assets
Library Specifications
Libraries and Namespaces
4. Managing server-side state
Understanding servlet state
Engine
Visit object
Global object
Persistent page properties
Implementing persistent page properties manually
Manual persistent component properties
Stateless applications
5. Configuring Tapestry
Requirements
Web deployment descriptor
Configuration Search Path
Application extensions
Character Sets
A. Tapestry Object Properties
B. Tapestry JAR files
C. Tapestry Specification DTDs
<application> element
<bean> element
<binding> element
<component> element
<component-type> element
<component-specification> element
<configure> element
<context-asset> element
<description> element
<extension> element
<external-asset> element
<inherited-binding> element
<library> element
<library-specification> element
<listener-binding> element
<message-binding> element
<page> element
<page-specification> element
<parameter> element
<private-asset> element
<property> element
<property-specification> element
<reserved-parameter> element
<service> element
<set-message-property> element
<set-property> element
<static-binding> element
D. Tapestry Script Specification DTD
<body> element
<foreach> element
<if> element
<if-not> element
<include-script> element
<initialization> element
<input-symbol> element
<let> element
<script> element
<set> element
<unique> element

List of Figures

1.1. Tapestry request dispatch (high level)
2.1. Component templates and bodies
3.1. Core Tapestry Classes and Interfaces
3.2. Parameter Bindings
3.3. Reading a Parameter
3.4. Writing a Parameter
3.5. ParameterManager and renderComponent()
C.1. <application> Attributes
C.2. <application> Elements
C.3. <bean> Attributes
C.4. <bean> Elements
C.5. <binding> Attributes
C.6. <component> Attributes
C.7. <component> Elements
C.8. <component-type> Attributes
C.9. <component-specification> Attributes
C.10. <component-specification> Elements
C.11. <configure> Attributes
C.12. <context-asset> Attributes
C.13. <extension> Attributes
C.14. <component-specification> Elements
C.15. <external-asset> Attributes
C.16. <inherited-binding> Attributes
C.17. <library> Attributes
C.18. <library-specification> Elements
C.19. <listener-binding> Attributes
C.20. <message-binding> Attributes
C.21. <page> Attributes
C.22. <page-specification> Attributes
C.23. <page-specification> Elements
C.24. <parameter> Attributes
C.25. <private-asset> Attributes
C.26. <property> Attributes
C.27. <property-specification> Attributes
C.28. <reserved-parameter> Attributes
C.29. <service> Attributes
C.30. <set-message-property> Attributes
C.31. <set-property> Attributes
C.32. <static-binding> Attributes
D.1. <body> Elements
D.2. <foreach> Attributes
D.3. <foreach> Elements
D.4. <if> Attributes
D.5. <if> Elements
D.6. <if-not> Attributes
D.7. <if-not> Elements
D.8. <include-script> Attributes
D.9. <initialization> Elements
D.10. <input-symbol> Attributes
D.11. <let> Attributes
D.12. <let> Elements
D.13. <script> Elements
D.14. <set> Attributes
D.15. <unique> Elements

List of Tables

A.1. Tapestry Object Properties
C.1. Tapestry Specifications

List of Examples

2.1. Example HTML template containing components
2.2. HTML template with repetative blocks (partial)
2.3. Updated HTML template (partial)
3.1. Referencing a Component Library
4.1. Accessing the Visit object
4.2. Defining the Visit class
4.3. Persistent page property: Java class
4.4. Persistent page property: page specification
4.5. Use of initialize() method
4.6. Manual persistent page property
4.7. Manual Persistent Component Properties
5.1. Web Deployment Descriptor