Author: buildbot
Date: Sat Nov 22 17:19:51 2014
New Revision: 930118
Log:
Production update by buildbot for tapestry
Added:
websites/production/tapestry/content/creating-the-skeleton-application.data/add-archetype-catalog.png
(with props)
websites/production/tapestry/content/creating-the-skeleton-application.data/run-configuration.png
(with props)
websites/production/tapestry/content/creating-the-skeleton-application.data/select-a-wizard.png
(with props)
websites/production/tapestry/content/creating-the-skeleton-application.data/select-archetype.png
(with props)
websites/production/tapestry/content/creating-the-skeleton-application.data/specify-archetype-parameters.png
(with props)
Modified:
websites/production/tapestry/content/cache/main.pageCache
websites/production/tapestry/content/creating-the-skeleton-application.html
websites/production/tapestry/content/dependencies-tools-and-plugins.html
Modified: websites/production/tapestry/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Added:
websites/production/tapestry/content/creating-the-skeleton-application.data/add-archetype-catalog.png
==============================================================================
Binary file - no diff available.
Propchange:
websites/production/tapestry/content/creating-the-skeleton-application.data/add-archetype-catalog.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added:
websites/production/tapestry/content/creating-the-skeleton-application.data/run-configuration.png
==============================================================================
Binary file - no diff available.
Propchange:
websites/production/tapestry/content/creating-the-skeleton-application.data/run-configuration.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added:
websites/production/tapestry/content/creating-the-skeleton-application.data/select-a-wizard.png
==============================================================================
Binary file - no diff available.
Propchange:
websites/production/tapestry/content/creating-the-skeleton-application.data/select-a-wizard.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added:
websites/production/tapestry/content/creating-the-skeleton-application.data/select-archetype.png
==============================================================================
Binary file - no diff available.
Propchange:
websites/production/tapestry/content/creating-the-skeleton-application.data/select-archetype.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added:
websites/production/tapestry/content/creating-the-skeleton-application.data/specify-archetype-parameters.png
==============================================================================
Binary file - no diff available.
Propchange:
websites/production/tapestry/content/creating-the-skeleton-application.data/specify-archetype-parameters.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Modified:
websites/production/tapestry/content/creating-the-skeleton-application.html
==============================================================================
--- websites/production/tapestry/content/creating-the-skeleton-application.html
(original)
+++ websites/production/tapestry/content/creating-the-skeleton-application.html
Sat Nov 22 17:19:51 2014
@@ -66,7 +66,7 @@
</div>
<div id="content">
-<div id="ConfluenceContent"><style type="text/css">/*<![CDATA[*/
+<div id="ConfluenceContent"><p> </p><p> </p><style
type="text/css">/*<![CDATA[*/
table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding:
3px;margin: 0px;background-color: #f0f0f0}
table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width:
16px;border: none;}
table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
@@ -74,88 +74,11 @@ table.ScrollbarTable td.ScrollbarParent
table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width:
16px;border: none;}
-/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td
colspan="1" rowspan="1" class="ScrollbarPrevIcon"><a shape="rect"
href="dependencies-tools-and-plugins.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/back_16.gif"; width="16"
height="16"></a></td><td colspan="1" rowspan="1" class="ScrollbarPrevName"
width="33%"><a shape="rect"
href="dependencies-tools-and-plugins.html">Dependencies, Tools and
Plugins</a> </td><td colspan="1" rowspan="1" class="ScrollbarParent"
width="33%"><sup><a shape="rect" href="tapestry-tutorial.html"><img
align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/up_16.gif"; width="8"
height="8"></a></sup><a shape="rect" href="tapestry-tutorial.html">Tapestry
Tutorial</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName"
width="33%"> <a shape="rect"
href="loading-the-project-into-eclipse.html">Loading the Project Into
Eclipse</a></td><td colspan="1" rowspan
="1" class="ScrollbarNextIcon"><a shape="rect"
href="loading-the-project-into-eclipse.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/forwd_16.gif"; width="16"
height="16"></a></td></tr></table></div><p>Before we can get down to the fun,
we have to create an empty application. Tapestry uses a feature of Maven to do
this: <strong>archetypes</strong> (a too-clever way of saying "project
templates").</p><p>What we'll do is create an empty shell application using
Maven, then import the application into Eclipse to do the rest of the
work.</p><p>For the tutorial, we're using a fresh install of Eclipse and an
empty workspace at <code>/Users/joeuser/workspace</code>. You may need to
adjust a few things for other operating systems or local paths.</p><h2
id="CreatingTheSkeletonApplication-UsingtheQuickstartArchetype">Using the
Quickstart Archetype</h2><p>From our workspace directory, we'll use Maven to
create a skeleton Tapestry project.</p><p>Before
proceeding, we have to decide on four things: A Maven <em>group id</em> and
<em>artifact id</em> for our project, a <em>version</em>, and a <em>base
package name</em>.</p><p>Maven uses the group id and artifact id to provide a
unique identity for the application, and Tapestry needs to have a base package
name so it knows where to look for pages and components.</p><p>For this
example, we'll use the group id <strong>com.example</strong>, artifact id
<strong>tutorial1</strong>, version <strong>1.0-SNAPSHOT</strong> and we'll use
<strong>com.example.tutorial</strong> as the base package.</p><p>Our final
command line is:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeContent panelContent pdl">
-<script class="theme: Default; brush: text; gutter: false"
type="syntaxhighlighter"><![CDATA[mvn archetype:generate
-DarchetypeCatalog=http://tapestry.apache.org
-]]></script>
-</div></div> <div class="aui-message hint shadowed information-macro">
- <span class="aui-icon icon-hint">Icon</span>
- <div class="message-content">
- <p>If you want to try an unreleased (alpha or
beta) version of Tapestry, use <span
class="nolink">https://repository.apache.org/content/repositories/staging</span>
archetype catalog URL instead.</p>
- </div>
- </div>
-<p>You will then be prompted to pick the archetype - choose the latest
<strong>Tapestry 5.X Quickstart Project</strong>, enter the group id, artifact
id, version and package when prompted.</p><div class="preformatted panel"
style="border-width: 1px;"><div class="preformattedContent panelContent">
-<pre>$ 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.7
-Choose a number: 4: 4
-Define value for property 'groupId': : com.example
-Define value for property 'artifactId': : tutorial1
-Define value for property 'version': 1.0-SNAPSHOT: :
-Define value for property 'package': com.example: : com.example.tutorial
-Confirm properties configuration:
-groupId: com.example
-artifactId: tutorial1
-version: 1.0-SNAPSHOT
-package: com.example.tutorial
- Y: :
-[INFO]
----------------------------------------------------------------------------
-[INFO] Using following parameters for creating project from Archetype:
quickstart:5.3.7
-[INFO]
----------------------------------------------------------------------------
-[INFO] Parameter: groupId, Value: com.example
-[INFO] Parameter: artifactId, Value: tutorial1
-[INFO] Parameter: version, Value: 1.0-SNAPSHOT
-[INFO] Parameter: package, Value: com.example.tutorial
-[INFO] Parameter: packageInPathFormat, Value: com/example/tutorial
-[INFO] Parameter: package, Value: com.example.tutorial
-[INFO] Parameter: version, Value: 1.0-SNAPSHOT
-[INFO] Parameter: groupId, Value: com.example
-[INFO] Parameter: artifactId, Value: tutorial1
-[WARNING] Don't override file /Users/joeuser/workspace/tutorial1/src/test/java
-[WARNING] Don't override file
/Users/joeuser/workspace/tutorial1/src/main/webapp
-[WARNING] Don't override file
/Users/joeuser/workspace/tutorial1/src/main/resources/com/example/tutorial
-[WARNING] Don't override file
/Users/joeuser/workspace/tutorial1/src/test/resources
-[WARNING] Don't override file /Users/joeuser/workspace/tutorial1/src/test/conf
-[WARNING] Don't override file /Users/joeuser/workspace/tutorial1/src/site
-[INFO] project created from Archetype in dir:
/Users/joeuser/workspace/tutorial1
-[INFO] ------------------------------------------------------------------------
-[INFO] BUILD SUCCESS
-[INFO] ------------------------------------------------------------------------
-[INFO] Total time: 22.398s
-[INFO] Finished at: Fri Mar 1 11:46:08 PST 2013
-[INFO] Final Memory: 7M/81M
-[INFO] ------------------------------------------------------------------------
-</pre>
-</div></div> <div class="aui-message hint shadowed information-macro">
- <span class="aui-icon icon-hint">Icon</span>
- <div class="message-content">
- <p>The first time you use Maven, you'll see quite
a bit more output, mostly about downloading all sorts of JARs and other files.
These downloaded files are cached locally and will not need to be downloaded
again, but you do have to be patient on first use.</p>
- </div>
- </div>
-<p>After executing the command, you'll see a new directory,
<code>tutorial1</code>.</p> <div class="aui-message hint shadowed
information-macro">
+/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td
colspan="1" rowspan="1" class="ScrollbarPrevIcon"><a shape="rect"
href="dependencies-tools-and-plugins.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/back_16.gif"; width="16"
height="16"></a></td><td colspan="1" rowspan="1" class="ScrollbarPrevName"
width="33%"><a shape="rect"
href="dependencies-tools-and-plugins.html">Dependencies, Tools and
Plugins</a> </td><td colspan="1" rowspan="1" class="ScrollbarParent"
width="33%"><sup><a shape="rect" href="tapestry-tutorial.html"><img
align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/up_16.gif"; width="8"
height="8"></a></sup><a shape="rect" href="tapestry-tutorial.html">Tapestry
Tutorial</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName"
width="33%"> <a shape="rect"
href="loading-the-project-into-eclipse.html">Loading the Project Into
Eclipse</a></td><td colspan="1" rowspan
="1" class="ScrollbarNextIcon"><a shape="rect"
href="loading-the-project-into-eclipse.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/forwd_16.gif"; width="16"
height="16"></a></td></tr></table></div><p>Before we can get down to the fun,
we have to create an empty application. Tapestry uses a feature of Maven to do
this: <strong>archetypes</strong> (a too-clever way of saying "project
templates").</p><p>For the tutorial, we're using a fresh install of Eclipse and
an empty workspace at <code>/users/joeuser/workspace</code>. You may need to
adjust a few things for other operating systems or local paths.</p><h2
id="CreatingTheSkeletonApplication-UsingtheQuickstartArchetype">Using the
Quickstart Archetype</h2><p>From Eclipse, we'll use a Maven archetype to create
a skeleton Tapestry project.</p> <div class="aui-message hint shadowed
information-macro">
<p class="title">Maven Behind a Firewall</p>
<span class="aui-icon icon-hint">Icon</span>
<div class="message-content">
- <p>If you are behind a firewall, before running
any "mvn" commands, you will need to configure your proxy settings in
settings.xml. Here is an example:</p><div class="code panel pdl"
style="border-width: 1px;"><div class="codeHeader panelHeader pdl"
style="border-bottom-width: 1px;"><b>settings.xml</b></div><div
class="codeContent panelContent pdl">
+ <p>If you are behind a firewall/proxy, before
performing any Maven downloads, you may need to configure your proxy settings
in your Maven settings.xml file (typically ~/.m2/settings.xml). Here is an
example:</p><div class="code panel pdl" style="border-width: 1px;"><div
class="codeHeader panelHeader pdl" style="border-bottom-width:
1px;"><b>settings.xml</b></div><div class="codeContent panelContent pdl">
<script class="theme: Default; brush: xml; gutter: false"
type="syntaxhighlighter"><![CDATA[<settings>
<proxies>
<proxy>
@@ -174,23 +97,21 @@ package: com.example.tutorial
</div></div><p>Of course, adjust the <code>localRepository</code> element to
match the correct path for your computer.</p>
</div>
</div>
-<h2
id="CreatingTheSkeletonApplication-RunningtheNewApplicationusingJetty">Running
the New Application using Jetty</h2><p>One of the first things you can do is
use Maven to run Jetty directly.</p><p>Change into the newly created directory,
and execute the command:</p><div class="code panel pdl" style="border-width:
1px;"><div class="codeContent panelContent pdl">
-<script class="theme: Default; brush: text; gutter: false"
type="syntaxhighlighter"><![CDATA[mvn jetty:run
-]]></script>
-</div></div><p>Again, the first time, there's a dizzying number of downloads,
but before you know it, the Jetty servlet container is up and
running.</p><p>Once Jetty is initialized (which only takes a few seconds),
you'll see the following in your console:</p><div class="preformatted panel"
style="border-width: 1px;"><div class="preformattedContent panelContent">
-<pre> TranslatorSource: DEFINED
- TypeCoercer: REAL
- URLEncoder: DEFINED
- UpdateListenerHub: DEFINED
- ValidateBindingFactory: DEFINED
- ValidationConstraintGenerator: DEFINED
+<p>Okay, let's get started creating our new project.</p><p>In Eclipse, go to
<strong>File > New ></strong> <strong>Project... > Maven > Maven
Project</strong></p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/23340356/select-a-wizard.png?version=1&modificationDate=1416675284654&api=v2";
data-image-src="/confluence/download/attachments/23340356/select-a-wizard.png?version=1&modificationDate=1416675284654&api=v2"></p><p>Then
click <strong>Next</strong>, <strong>Next</strong> (again), and then on the
<strong>Select an Archetype</strong> page click the <strong>Configure</strong>
button on the Catalog line. The <strong>Archetype</strong> preferences dialog
should appear. Click the <strong>Add Remote Catalog...</strong>
button:</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/23340356/add-archetype-catalog.png?version=1&modificationDate=14166753
54423&api=v2"
data-image-src="/confluence/download/attachments/23340356/add-archetype-catalog.png?version=1&modificationDate=1416675354423&api=v2"></p><p>As
shown above, enter <span class="nolink"><span
class="nolink">"http://tapestry.apache.org";</span></span> in the Catalog File
field, and "Apache Tapestry" in the Description field.</p><p>Click
<strong>OK</strong>, then<strong> OK</strong> again.</p><p>On the Select an
Archetype dialog, select the newly-added Apache Tapestry catalog, then select
the "quickstart" artifact from the list and click
<strong>Next</strong>.</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/23340356/select-archetype.png?version=1&modificationDate=1416675447884&api=v2";
data-image-src="/confluence/download/attachments/23340356/select-archetype.png?version=1&modificationDate=1416675447884&api=v2"></p><p>Fill
in the Group Id, Artifact Id, Version and Package  as follows:<
/p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/23340356/specify-archetype-parameters.png?version=1&modificationDate=1416675494780&api=v2";
data-image-src="/confluence/download/attachments/23340356/specify-archetype-parameters.png?version=1&modificationDate=1416675494780&api=v2"></p><p>then
click Finish.</p> <div class="aui-message hint shadowed information-macro">
+ <span class="aui-icon icon-hint">Icon</span>
+ <div class="message-content">
+ <p>The first time you use Maven, project creation
may take several minutes as Maven downloads hundreds of JAR dependencies. These
downloaded files are cached locally and will not need to be downloaded again,
but you do have to be patient on first use.</p>
+ </div>
+ </div>
+<p>After Maven finishes, you'll see a new directory, <code>tutorial in your
Package Explorer view in Eclipse.</code></p><h2
id="CreatingTheSkeletonApplication-RunningtheApplicationusingJetty">Running the
Application using Jetty</h2><p>One of the first things you can do is use Maven
to run Jetty directly.</p><p>Right-click on the tutorial project in your
Package Explorer view and select <strong>Run As > Maven Build...
></strong>, enter a Goal of <strong>"jetty:run"</strong>. This creates a
"Run Configuration" named "tutorial1" that we'll use throughout this tutorial
to start the app:</p><p><img class="confluence-embedded-image"
src="https://cwiki.apache.org/confluence/download/attachments/23340356/run-configuration.png?version=1&modificationDate=1416675566834&api=v2";
data-image-src="/confluence/download/attachments/23340356/run-configuration.png?version=1&modificationDate=1416675566834&api=v2"></p><p>Click
<strong>Run</strong>.</p><p>Again, the first time, there
's a dizzying number of downloads, but before you know it, the Jetty servlet
container is up and running.</p><p>Once Jetty is initialized (which only takes
a few seconds after the first time), you'll see the following in your
console:</p><div class="preformatted panel" style="border-width: 1px;"><div
class="preformattedContent panelContent">
+<pre> ValidationConstraintGenerator: DEFINED
ValidationDecoratorFactory: DEFINED
ValidatorMacro: DEFINED
ValueEncoderSource: DEFINED
86.77% unrealized services (164/189)
-Application 'app' (version 1.0-SNAPSHOT-DEV) startup time: 137 ms to build IoC
Registry, 705 ms overall.
+Application 'app' (version 1.0-SNAPSHOT-DEV) startup time: 87 ms to build IoC
Registry, 376 ms overall.
______ __ ____
/_ __/__ ____ ___ ___ / /_______ __ / __/
@@ -202,7 +123,7 @@ Application 'app' (version 1.0-SNAPSHOT-
2011-11-22 11:46:45.636::INFO: Started [email protected]:8080
[INFO] Started Jetty Server
</pre>
-</div></div><p> </p><p>You can now open a web browser to <a shape="rect"
class="external-link" href="http://localhost:8080/tutorial1/";
>http://localhost:8080/tutorial1/</a> to see the running
application:</p><p> </p><p><img class="confluence-embedded-image
confluence-content-image-border image-left" height="525" width="700"
src="https://cwiki.apache.org/confluence/download/attachments/23340356/startpage.png?version=6&modificationDate=1416272937876&api=v2";
data-image-src="/confluence/download/attachments/23340356/startpage.png?version=6&modificationDate=1416272937876&api=v2"></p><p> </p><div
style="clear: both"></div><p style="text-align: left;">The date and time in
the middle of the page proves that this is a live application.</p><p>This is a
complete little application; it doesn't do much, but it demonstrate how to
create a number of pages sharing a common layout, and demonstrates some simple
navigation and link handling. You can see that it has three
different pages that share a common layout. (<span style="line-height:
1.4285715;"><em>Layout</em> is a loose term meaning common look and feel and
navigation across many or all of the pages of an application. Often an
application will include a Layout component to provide that
commonness.)</span></p> <div class="aui-message problem shadowed
information-macro">
+</div></div><p> </p><p>You can now open a web browser to <a shape="rect"
class="external-link" href="http://localhost:8080/tutorial1/";
>http://localhost:8080/tutorial1/</a> to see the running
application:</p><p> </p><p><img class="confluence-embedded-image
confluence-content-image-border image-left" height="525" width="700"
src="https://cwiki.apache.org/confluence/download/attachments/23340356/startpage.png?version=6&modificationDate=1416272937000&api=v2";
data-image-src="/confluence/download/attachments/23340356/startpage.png?version=6&modificationDate=1416272937000&api=v2"></p><p> </p><div
style="clear: both"></div><p style="text-align: left;">The date and time in
the middle of the page proves that this is a live application.</p><p>This is a
complete little application; it doesn't do much, but it demonstrate how to
create a number of pages sharing a common layout, and demonstrates some simple
navigation and link handling. You can see that it has three
different pages that share a common layout. (<span style="line-height:
1.4285715;"><em>Layout</em> is a loose term meaning common look and feel and
navigation across many or all of the pages of an application. Often an
application will include a Layout component to provide that
commonness.)</span></p> <div class="aui-message problem shadowed
information-macro">
<span class="aui-icon icon-problem">Icon</span>
<div class="message-content">
<p>You should hit Control-C in the Terminal window
to close down Jetty before continuing with the tutorial.</p>
@@ -216,7 +137,12 @@ table.ScrollbarTable td.ScrollbarParent
table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width:
16px;border: none;}
-/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td
colspan="1" rowspan="1" class="ScrollbarPrevIcon"><a shape="rect"
href="dependencies-tools-and-plugins.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/back_16.gif"; width="16"
height="16"></a></td><td colspan="1" rowspan="1" class="ScrollbarPrevName"
width="33%"><a shape="rect"
href="dependencies-tools-and-plugins.html">Dependencies, Tools and
Plugins</a> </td><td colspan="1" rowspan="1" class="ScrollbarParent"
width="33%"><sup><a shape="rect" href="tapestry-tutorial.html"><img
align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/up_16.gif"; width="8"
height="8"></a></sup><a shape="rect" href="tapestry-tutorial.html">Tapestry
Tutorial</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName"
width="33%"> <a shape="rect"
href="loading-the-project-into-eclipse.html">Loading the Project Into
Eclipse</a></td><td colspan="1" rowspan
="1" class="ScrollbarNextIcon"><a shape="rect"
href="loading-the-project-into-eclipse.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/forwd_16.gif"; width="16"
height="16"></a></td></tr></table></div></div>
+/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td
colspan="1" rowspan="1" class="ScrollbarPrevIcon"><a shape="rect"
href="dependencies-tools-and-plugins.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/back_16.gif"; width="16"
height="16"></a></td><td colspan="1" rowspan="1" class="ScrollbarPrevName"
width="33%"><a shape="rect"
href="dependencies-tools-and-plugins.html">Dependencies, Tools and
Plugins</a> </td><td colspan="1" rowspan="1" class="ScrollbarParent"
width="33%"><sup><a shape="rect" href="tapestry-tutorial.html"><img
align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/up_16.gif"; width="8"
height="8"></a></sup><a shape="rect" href="tapestry-tutorial.html">Tapestry
Tutorial</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName"
width="33%"> <a shape="rect"
href="loading-the-project-into-eclipse.html">Loading the Project Into
Eclipse</a></td><td colspan="1" rowspan
="1" class="ScrollbarNextIcon"><a shape="rect"
href="loading-the-project-into-eclipse.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/forwd_16.gif"; width="16"
height="16"></a></td></tr></table></div> <div class="aui-message hint
shadowed information-macro">
+ <span class="aui-icon icon-hint">Icon</span>
+ <div class="message-content">
+ <p>If you want to try an unreleased (alpha or
beta) version of Tapestry, use <span
class="nolink">https://repository.apache.org/content/repositories/staging</span>
archetype catalog URL instead.</p>
+ </div>
+ </div></div>
</div>
<div class="clearer"></div>
Modified:
websites/production/tapestry/content/dependencies-tools-and-plugins.html
==============================================================================
--- websites/production/tapestry/content/dependencies-tools-and-plugins.html
(original)
+++ websites/production/tapestry/content/dependencies-tools-and-plugins.html
Sat Nov 22 17:19:51 2014
@@ -74,7 +74,7 @@ table.ScrollbarTable td.ScrollbarParent
table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width:
16px;border: none;}
-/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td
colspan="1" rowspan="1" class="ScrollbarPrevName" width="33%"> </td><td
colspan="1" rowspan="1" class="ScrollbarParent" width="33%"><sup><a
shape="rect" href="tapestry-tutorial.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/up_16.gif"; width="8"
height="8"></a></sup><a shape="rect" href="tapestry-tutorial.html">Tapestry
Tutorial</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName"
width="33%"> <a shape="rect"
href="creating-the-skeleton-application.html">Creating The Skeleton
Application</a></td><td colspan="1" rowspan="1" class="ScrollbarNextIcon"><a
shape="rect" href="creating-the-skeleton-application.html"><img align="middle"
border="0" src="https://cwiki.apache.org/confluence/images/icons/forwd_16.gif";
width="16" height="16"></a></td></tr></table></div><p>As much as we would like
to dive into Tapestry right now, we must first talk about settin
g up your development environment. The joy and the pain of Java development is
the volume of choice available. There's just a bewildering number of JDKs, IDEs
and other TLAs (Three Letter Acronyms) out there.</p><p>Let's talk about a
stack of tools, all open source and freely available, that you'll need to
setup. Likely you have some of these, or some version of these, already on your
development machine.</p><h1 id="Dependencies,ToolsandPlugins-JDK1.5orNewer">JDK
1.5 or Newer</h1><p>Tapestry 5 makes use of features of Java Development Kit
(JDK) version 1.5. This includes Java annotations, and a little bit of Java
generics. JDK 1.6 and JDK 1.7 work fine too.</p><h1
id="Dependencies,ToolsandPlugins-EclipseIDE">Eclipse IDE</h1><p>For this
tutorial we'll assume you're using Eclipse as your Integrated Development
Environment (IDE). Eclipse is a popular IDE, but feel free to adapt these
instructions to IntelliJ, NetBeans, or any other.</p><p>Eclipse comes in
various flavors, and includes
a reasonable XML editor built-in. It can be <a shape="rect"
class="external-link" href="http://www.eclipse.org/downloads/"; >downloaded from
the eclipse.org web site</a>. We recommend the latest version of Eclipse IDE
for Java Developers (but anything from version 3.7 onward should work
fine).</p><h1 id="Dependencies,ToolsandPlugins-Jetty">Jetty</h1><p>Jetty is an
open source web servlet and servlet container available from the Eclipse
Foundation. Jetty is designed for high performance and easy embedding in other
software.</p><h1
id="Dependencies,ToolsandPlugins-RunJettyRunEclipsePlugin">RunJettyRun Eclipse
Plugin</h1><p><a shape="rect" class="external-link"
href="http://code.google.com/p/run-jetty-run/"; >RunJettyRun</a> is a very
simple Eclipse plugin that bundles a version of Jetty (Jetty 6 at this writing)
so that you can create Eclipse launches that start Jetty to execute your web
application.</p><p>You can install RunJettyRun using Eclipse's <em>Install New
Software...</em> menu
item; the update URL is <a shape="rect" class="external-link"
href="http://run-jetty-run.googlecode.com/svn/trunk/updatesite";
>http://run-jetty-run.googlecode.com/svn/trunk/updatesite</a>.</p><p>This
tutorial was written with RunJettyRun version 1.3.1.</p><h1
id="Dependencies,ToolsandPlugins-ApacheMaven3">Apache Maven 3</h1><p>Maven is a
comprehensive software build tool with the ability to automatically download
project dependencies (such as the Tapestry JAR files, and the JAR files that
Tapestry itself depends on) from one of several central
repositories.</p><p>Maven is not essential for using Tapestry, but is
especially helpful when performing the initial set-up of a Tapestry
application.</p><p>Eclipse comes with its own Maven plugin, <a
shape="rect" class="external-link" href="http://eclipse.org/m2e/";
>M2Eclipse</a> (also known as m2e) that you are free to use if you're already
familiar with it. However, for this tutorial we'll use the Maven command line
("mvn"). The comma
nd-line version of Maven is available from <a shape="rect"
class="external-link"
href="http://maven.apache.org/download.html";>http://maven.apache.org/download.html</a>.
Go ahead and download and install it.</p><h1
id="Dependencies,ToolsandPlugins-Tapestry">Tapestry</h1><p>You should not have
to download this directly; as we'll see, Maven should take care of downloading
Tapestry, and its dependencies, as needed.</p><style
type="text/css">/*<![CDATA[*/
+/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td
colspan="1" rowspan="1" class="ScrollbarPrevName" width="33%"> </td><td
colspan="1" rowspan="1" class="ScrollbarParent" width="33%"><sup><a
shape="rect" href="tapestry-tutorial.html"><img align="middle" border="0"
src="https://cwiki.apache.org/confluence/images/icons/up_16.gif"; width="8"
height="8"></a></sup><a shape="rect" href="tapestry-tutorial.html">Tapestry
Tutorial</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName"
width="33%"> <a shape="rect"
href="creating-the-skeleton-application.html">Creating The Skeleton
Application</a></td><td colspan="1" rowspan="1" class="ScrollbarNextIcon"><a
shape="rect" href="creating-the-skeleton-application.html"><img align="middle"
border="0" src="https://cwiki.apache.org/confluence/images/icons/forwd_16.gif";
width="16" height="16"></a></td></tr></table></div><p>As much as we would like
to dive into Tapestry right now, we must first talk about settin
g up your development environment. The joy and the pain of Java development is
the volume of choice available. There's just a bewildering number of JDKs, IDEs
and other TLAs (Three Letter Acronyms) out there.</p><p>Let's talk about a
stack of tools, all open source and freely available, that you'll need to
setup. Likely you have some of these, or some version of these, already on your
development machine.</p><h1 id="Dependencies,ToolsandPlugins-JDK1.5orNewer">JDK
1.5 or Newer</h1><p>Tapestry 5 makes use of features of Java Development Kit
(JDK) version 1.5. This includes Java annotations, and a little bit of Java
generics. JDK 1.6 and JDK 1.7 work fine too.</p><h1
id="Dependencies,ToolsandPlugins-EclipseIDE">Eclipse IDE</h1><p>For this
tutorial we'll assume you're using Eclipse as your Integrated Development
Environment (IDE). Eclipse is a popular IDE, but feel free to adapt these
instructions to IntelliJ, NetBeans, or any other.</p><p>Eclipse comes in
various flavors, and includes
a reasonable XML editor built-in. It can be <a shape="rect"
class="external-link" href="http://www.eclipse.org/downloads/"; >downloaded from
the eclipse.org web site</a>. We recommend the latest version of Eclipse IDE
for Java Developers (but anything from version 3.7 onward should work
fine).</p><h1 id="Dependencies,ToolsandPlugins-ApacheMaven3">Apache Maven
3</h1><p>Maven is a software build tool with the ability to automatically
download project dependencies (such as the Tapestry JAR files, and the JAR
files that Tapestry itself depends on) from one of several central
repositories.</p><p>Maven is not essential for using Tapestry, but is
especially helpful when performing the initial set-up of a Tapestry
application.</p><p>Eclipse comes with a Maven plugin, <a shape="rect"
class="external-link" href="http://eclipse.org/m2e/"; >M2Eclipse</a> (also known
as m2e) with an embedded version of Maven. We'll use that here for simplicity's
sake. Alternatively, you could install Maven fr
om <a shape="rect" class="external-link"
href="http://maven.apache.org/download.html";>http://maven.apache.org/download.html</a>
and use it from the command line ("mvn").</p><h1
id="Dependencies,ToolsandPlugins-Jetty">Jetty</h1><p>Jetty is an open source
web server and servlet container available from the Eclipse Foundation. Jetty
is designed for high performance and easy embedding in other software. Maven
can download it for you and run it automatically, so you DO NOT have to
download it for this tutorial. Alternatively, you could download and install
the RunJettyRun Eclipse plugin from the Eclipse Marketplace.</p><h1
id="Dependencies,ToolsandPlugins-Tapestry">Tapestry</h1><p>You should not have
to download this directly; as we'll see, Maven should take care of downloading
Tapestry, and its dependencies, as needed.</p><style
type="text/css">/*<
![https://cwiki.apache.org/confluence/images/icons/back_16.gif"](https://cwiki.apache.org/confluence/images/icons/back_16.gif"){kind=link}
![https://cwiki.apache.org/confluence/images/icons/up_16.gif"](https://cwiki.apache.org/confluence/images/icons/up_16.gif"){kind=link}
![https://cwiki.apache.org/confluence/images/icons/forwd_16.gif"](https://cwiki.apache.org/confluence/images/icons/forwd_16.gif"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/23340356/select-a-wizard.png?version=1&modificationDate=1416675284654&api=v2"](https://cwiki.apache.org/confluence/download/attachments/23340356/select-a-wizard.png?version=1&modificationDate=1416675284654&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/23340356/select-archetype.png?version=1&modificationDate=1416675447884&api=v2"](https://cwiki.apache.org/confluence/download/attachments/23340356/select-archetype.png?version=1&modificationDate=1416675447884&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/23340356/specify-archetype-parameters.png?version=1&modificationDate=1416675494780&api=v2"](https://cwiki.apache.org/confluence/download/attachments/23340356/specify-archetype-parameters.png?version=1&modificationDate=1416675494780&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/23340356/run-configuration.png?version=1&modificationDate=1416675566834&api=v2"](https://cwiki.apache.org/confluence/download/attachments/23340356/run-configuration.png?version=1&modificationDate=1416675566834&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/23340356/startpage.png?version=6&modificationDate=1416272937876&api=v2"](https://cwiki.apache.org/confluence/download/attachments/23340356/startpage.png?version=6&modificationDate=1416272937876&api=v2"){kind=link}
![https://cwiki.apache.org/confluence/download/attachments/23340356/startpage.png?version=6&modificationDate=1416272937000&api=v2"](https://cwiki.apache.org/confluence/download/attachments/23340356/startpage.png?version=6&modificationDate=1416272937000&api=v2"){kind=link}