Page History

...

Div

style	float:right
title	Related Articles
class	aui-label

Content by Label

showLabels	false
showSpace	false
title	Related Articles
cql	label = "new-users"

...

and space = currentSpace()

Getting started with Tapestry is easy, and you have lots of ways to begin: watch a video, browse the source code of a working demo app, create a skeleton app using Maven, or step through the tutorial.

...

For a fast-paced introduction, watch Mark W. Shead's 10 Minute Demo. This video shows how to set up a simple Tapestry application, complete with form validation, Hibernate-based persistence, and Ajax. The video provides a preview of the development speed and productivity that experienced Tapestry users enjoy.

...

You can also play with Tapestry via our live demonstration applications. To start, have a look at the Hotel Booking Demo. The source code is provided so you can download and play with it. Also check out the Jumpstart demonstration site.

Create your first Tapestry project

...

No Format
mvn archetype:generate -DarchetypeCatalog=http://tapestryDfilter=org.apache.org

Maven will prompt you for the archetype to create ("Tapestry 5 Quickstart Project") and the exact version number ("5.4.-beta-28", at the time of writing). It also asks you for a group id, an artifact id, and a version number.

Note
Currently, it is necessary to use a staging URI to get the 5.4 beta archetype. This will change after the final Tapestry 5.4 release.

tapestry:quickstart

(Alternatively, if you want to get an archetype for a not-yet-released version of Tapestry – most users don't – you can use the staging URI, https://repository.apache.org/content/repositories/staging ).

Maven will prompt you for the archetype to create ("Tapestry 5 Quickstart Project") and the exact version number (e.g., "5.5.0"). It also asks you for a group id, an artifact id, and a version number. You can see this in the following transcript:

noformat

Code Block

language	text

$ mvn archetype:generate -DarchetypeCatalog=httpshttp://repositorytapestry.apache.org/content/repositories/staging
[
[INFO] Scanning for projects...
[INFO]
[INFO] -----------------------------                                                                         
[INFO] -----------------------------------------------
[INFO] Building Maven Stub -------------------------
[INFO] Building Maven Stub Project (No POM) 1
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] >>> maven-archetype-plugin:2.32:generate (default-cli) > generate-sources @ standalone-pom >>>
[INFO] 
[INFO] <<< maven-archetype-plugin:2.32:generate (default-cli) < generate-sources @ standalone-pom <<<
[INFO] 
[INFO] --- maven-archetype-plugin:2.32:generate (default-cli) @ standalone-pom ---
[INFO] Generating project in Interactive mode
[INFO] No archetype defined. Using maven-archetype-quickstart (org.apache.maven.archetypes:maven-archetype-quickstart:1.0)
Choose archetype:
...
51: httpshttp://repositorytapestry.apache.org/content/repositories/staging -> org.apache.tapestry:quickstart (-)
...Tapestry 5 Quickstart Project)
2: http://tapestry.apache.org -> org.apache.tapestry:tapestry-archetype (Tapestry 5.4.5 Archetype)
Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): 105: 51
Choose org.apache.tapestry:quickstart version: 
1: 5.0.319
2: 5.1.30.15
3: 5.32.26
4: 5.3.3-rc-17
5: 5.34.35
6: 5.35.40
7: 5.36.54
8: 5.7.3.6
9: 5.38.7
10: 5.3.8
11: 5.4-beta-3
12: 5.4-beta-6
13: 5.4-beta-22
14: 5.4-beta-26
15: 5.4-beta-27
16: 5.4-beta-28
Choose a number: 16: 16
Define value for property 'groupId': : com.example
Define 4
Choose a number: 9: 9
Define value for property 'groupId': : com.example
Define value for property 'artifactId': : newapp
Define value for property 'version':  1.0-SNAPSHOT: : 
Define value for property 'package':  com.example: : com.example.newapp
Confirm properties configuration:
groupId: com.example
artifactId: newapp
version: 1.0-SNAPSHOT
package: com.example.newapp
 Y: :
[INFO] ----------------------------------------------------------------------------
[INFO] Using following parameters for creating project from Archetype: quickstart:5.4-beta-28
[INFO] ---------------- com.example.newapp
 Y: : Y
[INFO] ------------------------------------------------------------
[INFO] Parameter: groupId, Value: com.example
[INFO] Parameter: artifactId, Value: newapp------------------------
[INFO] Parameter:Using version,following Value: 1.0-SNAPSHOT
[INFO] Parameter: package, Value: com.example.newapp
[INFO] Parameter: packageInPathFormat, Value: com/example/newapp
[INFO] Parameter: package, Value: com.example.newapp
[INFO] Parameter: version, Value: 1.0-SNAPSHOTparameters for creating project from Archetype: quickstart:5.8.4
[INFO] ----------------------------------------------------------------------------
[INFO] Parameter: groupId, Value: com.example
[INFO] Parameter: artifactId, Value: newapp
[WARNINGINFO] Don't override file /Users/hlship/workspaces/tapestry/tapestry-doc-examples/newapp/src/test/java
[WARNING] Don't override file /Users/hlship/workspaces/tapestry/tapestry-doc-examples/newapp/src/main/webapp
[WARNING] Don't override file /Users/hlship/workspaces/tapestry/tapestry-doc-examples/newapp/src/main/resources/Parameter: version, Value: 1.0-SNAPSHOT
[INFO] Parameter: package, Value: com.example.newapp
[INFO] Parameter: packageInPathFormat, Value: com/example/newapp
[WARNINGINFO] Don't override file /Users/hlship/workspaces/tapestry/tapestry-doc-examples/newapp/src/test/resources
[WARNING] Don't override file /Users/hlship/workspaces/tapestry/tapestry-doc-examples/newapp/src/test/conf
[WARNING] Don't override file /Users/hlship/workspaces/tapestry/tapestry-doc-examples/newapp/src/siteParameter: package, Value: com.example.newapp
[INFO] Parameter: version, Value: 1.0-SNAPSHOT
[INFO] Parameter: groupId, Value: com.example
[INFO] Parameter: artifactId, Value: newapp

[INFO] project created from Archetype in dir: /Usershome/hlshipjoeuser/workspacesjunk/tapestry/tapestry-doc-examples/junk2/newapp
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 3240.094 s020s
[INFO] Finished at: 2015-04-03T08:10:26-07:00 Sun Apr 09 16:55:01 EDT 2020
[INFO] Final Memory: 15M16M/216M303M
[INFO] ------------------------------------------------------------------------
~/workspaces/tapestry/tapestry-doc-examples
$

Maven will (after performing a number of one-time downloads) create a skeleton project ready to run. Because we specified an artifactId of "newapp", the project is created in the newapp directory. (Note: if you get "Unable to get resource" warnings at this stage, you may be behind a firewall which blocks outbound HTTP requests to Maven repositories.)

To run the skeleton application, change to the newapp directory and execute the "mvn jetty:run" command to start the Jetty app server:

Code Blocknoformat

language	bash

$ cd newapp
$ mvn jetty:run
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building newapp Tapestry 5 Application 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------

...

Application 'app' (version 1.0-SNAPSHOT-DEV) startup time: 329 ms to build IoC Registry, 919 ms overall.
 ______                  __             ____
/_  __/__ ____  ___ ___ / /_______ __  / __/
 / / / _ `/ _ \/ -_|_-</ __/ __/ // / /__ \
/_/  \_,_/ .__/\__/___/\__/_/  \_, / /____/
        /_/                   /___/  5.8.4-beta-28 (development mode)

[INFO] Started SelectChannelConnector@0.0.0.0:8080
[INFO] Started Jetty Server

After some more one-time downloads you can open your browser to http://localhost:8080/newapp to see the application running:

Image RemovedImage Added

The application consists of three pages sharing a common look and feel. The initial page, Index, allows you to perform some basic operations.

...

The bundled version of the Bootstrap CSS library has a per-project override. You can see the files in src/webapp/context/mybootstrap, and the overrides to enable that in AppModule.java.
By default, Tapestry users Prototype as its client-side library, but the archetype overrides this to jQuery, which is preferred for new projects.
The archetype adds a simple filter that shows the timing of each request.
The archetype sets up not just for builds with Maven, but also via Gradle.

...

Be sure to read about the core Tapestry Principles, and browse the extensive User Guide Documentation.

Obtain Help

Tapestry has an active user mailing list on which you can find a lot of valuable support, commonly within just a few minutes. You can subscribe by sending e-mail to users-subscribe@tapestry.apache.org or look for an answer in the archives. More Options...

Having trouble? Try our Frequently Asked Questions.

Tutorial.

...

Page tree

Versions Compared

Old Version 60

New Version Current

Key

Create your first Tapestry project

Obtain Help