THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
Once you have Maven installed, execute the following command (copy and paste it as-is)Footnote mvn archetype:generate -DarchetypeCatalog=http://tapestry.apache.org will work as well, and you will be prompted for the other details interactively.:
| Panel | ||
|---|---|---|
| ||
mvn -DarchetypeVersion=5.2.5 -Darchetype.interactive=false -DgroupId=com.example -DarchetypeArtifactId=quickstart -Dversion=1.0-SNAPSHOT -DarchetypeGroupId=org.apache.tapestry -Dpackage=com.example.newapp -DartifactId=newapp --batch-mode -DarchetypeRepository=http://tapestry.apache.org archetype:generate |
. Maven will prompt you for the archetype to create ("Tapestry 5 Quickstart Project") and the exact version number ("5.3", at the time of writing). It also asks you for a group id, an artifact id, and a version number. You can see this in the following transcript:
| No Format |
|---|
$ mvn archetype:generate -DarchetypeCatalog=http://tapestry.apache.org
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Stub Project (No POM) 1
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] >>> maven-archetype-plugin:2.1:generate (default-cli) @ standalone-pom >>>
[INFO]
[INFO] <<< maven-archetype-plugin:2.1:generate (default-cli) @ standalone-pom <<<
[INFO]
[INFO] --- maven-archetype-plugin:2.1: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:
1: http://tapestry.apache.org -> org.apache.tapestry:quickstart (Tapestry 5 Quickstart Project)
2: http://tapestry.apache.org -> org.apache.tapestry:tapestry-archetype (Tapestry 4.1.6 Archetype)
Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): : 1
Choose version:
1: 5.0.19
2: 5.1.0.5
3: 5.2.6
4: 5.3
Choose a number: 4: 4
Downloading: http://tapestry.apache.org/org/apache/tapestry/quickstart/5.3/quickstart-5.3.jar
Downloading: http://repo1.maven.org/maven2/org/apache/tapestry/quickstart/5.3/quickstart-5.3.jar
Downloaded: http://repo1.maven.org/maven2/org/apache/tapestry/quickstart/5.3/quickstart-5.3.jar (64 KB at 69.3 KB/sec)
Downloading: http://tapestry.apache.org/org/apache/tapestry/quickstart/5.3/quickstart-5.3.pom
Downloading: http://repo1.maven.org/maven2/org/apache/tapestry/quickstart/5.3/quickstart-5.3.pom
Downloaded: http://repo1.maven.org/maven2/org/apache/tapestry/quickstart/5.3/quickstart-5.3.pom (400 B at 1.0 KB/sec)
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.3
[INFO] ----------------------------------------------------------------------------
[INFO] Parameter: groupId, Value: com.example
[INFO] Parameter: artifactId, Value: newapp
[INFO] Parameter: version, 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-SNAPSHOT
[INFO] Parameter: groupId, Value: com.example
[INFO] Parameter: artifactId, Value: newapp
[WARNING] Don't override file /Users/hlship/workspaces/github/newapp/src/test/java
[WARNING] Don't override file /Users/hlship/workspaces/github/newapp/src/main/webapp
[WARNING] Don't override file /Users/hlship/workspaces/github/newapp/src/main/resources/com/example/newapp
[WARNING] Don't override file /Users/hlship/workspaces/github/newapp/src/test/resources
[WARNING] Don't override file /Users/hlship/workspaces/github/newapp/src/test/conf
[WARNING] Don't override file /Users/hlship/workspaces/github/newapp/src/site
[INFO] project created from Archetype in dir: /Users/hlship/workspaces/github/newapp
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 31.062s
[INFO] Finished at: Tue Nov 22 11:11:14 PST 2011
[INFO] Final Memory: 7M/81M
[INFO] ------------------------------------------------------------------------
~/workspaces/github
$
|
Maven will (after performing a Maven will (after performing a large 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.)
...
After some more one-time downloads you can open your browser to http://localhost:8080/newapp to see the application running:
The application consists of three pages sharing a common look and feel. The initial page, Index, allows you to perform some basic operations.
You can also load the newly-created project it into any IDE and start coding. See the next section on where to find the different components of the application.
Exploring the
...
generated project
The archetype creates the following files:
| No Format |
|---|
newapp
├── build.gradle
├── gradle
│ └── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── pom.xml
└── src
├── main
│ ├── java
│ │ └── com
│ │ └── example
│ │ └── newapp
│ │ ├── components
│ │ │ └── Layout.java
│ │ ├── pages
│ │ │ ├── About.java
│ │ │ ├── Contact.java
│ │ │ └── Index.java
│ │ └── services
│ │ ├── AppModule.java
│ │ ├── DevelopmentModule.java
│ │ └── QaModule.java
│ ├── resources
│ │ ├── com
│ │ │ └── example
│ │ │ └── newapp
│ │ │ ├── components
│ │ │ │ └── Layout.tml
│ │ │ └── pages
│ │ │ ├── About.tml
│ │ │ ├── Contact.tml
│ │ │ ├── Index.properties
│ │ │ └── Index.tml
│ │ └── log4j.properties
│ └── webapp
│ ├── WEB-INF
│ │ ├── app.properties
│ │ └── web.xml
│ ├── favicon.ico
│ └── layout
│ ├── images
│ │ ├── img01.jpg
│ │ ├── img03.jpg
│ │ ├── img04.jpg
│ │ ├── img08.gif
│ │ ├── img09.gif
│ │ ├── img10.gif
│ │ ├── img11.gif
│ │ ├── img12.gif
│ │ ├── img13.gif
│ │ ├── img14.gif
│ │ ├── img18.gif
│ │ ├── img19.gif
│ │ └── img20.gif
│ ├── layout.css
│ └── license.txt
├── site
│ ├── apt
│ │ └── index.apt
│ └── site.xml
└── test
├── conf
│ ├── testng.xml
│ └── webdefault.xml
├── java
│ └── PLACEHOLDER
└── resources
└── PLACEHOLDER
|
A Tapestry application is composed of pages, each page consisting of one template file and one Java class.
Tapestry page templates have the .tml extension and are found in src/main/webapp/resources/com/example/newapp/pages
| Footnote |
|---|
That is, in the |
Java classes are found in src/main/java/com/example/newapp/pages
| Footnote |
|---|
That is, in the |
Index.tml -> Index.java).In the skeleton project, most of the HTML is not found on the pages themselves but in a Layout component which acts as a global template for the whole site. Java classes for components live in src/main/java/com/example/newapp/components and component templates go in src/main/resources/com/example/newapp/components.
What's next?
To deepen your understanding, step through the Tapestry Tutorial which goes into much more detail about setting up your project, as well as loading it into Eclipse ... then continues on to teach you more about Tapestry.
...