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