Tapestry Examples
Tapestry's main distribution includes the Tapestry JAR files plus all source code for Tapestry, the Tapestry documentation, and Tapestry examples.
Because of licensing concerns, JAR dependencies (such as Javassist) and example applications are not distributed with Tapestry itself. As an Apache Software Foundation project, the Tapestry distributions must be limited to just software directly provided by the ASF; nothing from outside the ASF is allowed.
If you like, you can easily (?) build Tapestry, including the examples, from source. The necessary dependencies are automatically downloaded by Ant build scripts, but it takes some elbow grease to set up. Details at the Wiki.
But wouldn't it be nice to just get the compiled examples, ready to take for a spin? We think so, so we now provide the examples, precompiled, packaged, and ready to go, as a seperate distribution, from a non-ASF server.
These examples are available at http://howardlewisship.com/downloads/quick-start/ as tapestry-examples-version.tar.gz.
They require JBoss 4.0.2. Yes, we know there are several other open-source application servers out there, but it was easiest to pick one easy download to make the installation scripts turn-key.
Installation
Unpack the examples to a temporary directory.
From that directory, execute Ant. You will be prompted for the directory into which you installed JBoss.
bash-3.00$ ant Buildfile: build.xml -jboss-dir: [echo] Please provide the directory into which you installed JBoss 4.0.2 [echo] On windows systems, it is commonly C:/jboss-4.0.2 c:/jboss-4.0.2 -confirm: [echo] Installing the Tapestry demos WILL overwrite parts of your JBoss default configuration. [echo] You should back up your JBoss installation before continuing; better yet, use a fresh [echo] install just to run these Tapestry demos. [echo] *** The demos are only guaranteed to run on a clean install of JBoss 4.0.2 [input] Enter 'continue' to continue(continue) continue deploy: [echo] *** Shutting down JBoss [java] Shutdown message has been posted to the server. [java] Server shutdown may take a while - check logfiles for completion [echo] *** Installing Tapestry examples to c:/jboss-4.0.2/server/default [copy] Copying 4 files to C:\jboss-4.0.2\server\default [echo] Examples, database and configuration have been installed. [echo] You may now restart JBoss. BUILD SUCCESSFUL Total time: 12 seconds bash-3.00$
Workbench
http://localhost:8080/workbench/
The workbench is a testbed for many common Tapestry components. The tabs across the top demonstrate different Tapestry features and components, including localization, input validation, exception reporting, and the Palette and Table components.
Virtual Library
The Virtual Library is a small but complete J2EE application. It uses J2EE Entity beans with container managed persistence, and a stateless session facade, with Tapestry on the front end. The application is used to manage a shared pool of books, tracking who owns and who is currently borrowing each book.
Three users are built into the library. All three use the same password, "secret":
- dilbert@bigco.com
- squeue@bug.org
- ringbearer@bagend.shire
The "ringbearer" user has administrative access.