You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tapestry.apache.org by bu...@apache.org on 2014/11/18 02:19:47 UTC
svn commit: r929592 - in /websites/production/tapestry/content:
cache/main.pageCache creating-the-skeleton-application.data/startpage.png
creating-the-skeleton-application.html dependencies-tools-and-plugins.html
Author: buildbot
Date: Tue Nov 18 01:19:47 2014
New Revision: 929592
Log:
Production update by buildbot for tapestry
Modified:
websites/production/tapestry/content/cache/main.pageCache
websites/production/tapestry/content/creating-the-skeleton-application.data/startpage.png
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.
Modified: websites/production/tapestry/content/creating-the-skeleton-application.data/startpage.png
==============================================================================
Binary files - no diff available.
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 Tue Nov 18 01:19:47 2014
@@ -48,19 +48,13 @@
</div></div>
<div id="top">
-<div id="smallbanner"><div class="searchbox" style="float:right;margin: .3em 1em .1em 1em">
-<p>
-<span style="color: #999; font-size: 90%">Tapestry docs, issues, wikis & blogs:</span>
-</p><form enctype="application/x-www-form-urlencoded" method="get" action="http://tapestry.apache.org/search.html">
+<div id="smallbanner"><div class="searchbox" style="float:right;margin: .3em 1em .1em 1em"><span style="color: #999; font-size: 90%">Tapestry docs, issues, wikis & blogs:</span>
+<form enctype="application/x-www-form-urlencoded" method="get" action="http://tapestry.apache.org/search.html">
<input type="text" name="q">
<input type="submit" value="Search">
</form>
-</div>
-
-<div class="emblem" style="float:left"><a shape="rect" href="index.html"><img class="confluence-embedded-image" src="https://cwiki.apache.org/confluence/download/attachments/21791252/tapestry_s.png?version=3&modificationDate=1293093635000&api=v2" data-image-src="/confluence/download/attachments/21791252/tapestry_s.png?version=3&modificationDate=1293093635000&api=v2"></a></div>
-<div class="title" style="float:left; margin: 0 0 0 3em">
-<h1 id="SmallBanner-PageTitle">Creating The Skeleton Application</h1></div></div>
+</div><div class="emblem" style="float:left"><p><a shape="rect" href="index.html"><img class="confluence-embedded-image confluence-external-resource" src="http://tapestry.apache.org/images/tapestry_small.png" data-image-src="http://tapestry.apache.org/images/tapestry_small.png"></a></p></div><div class="title" style="float:left; margin: 0 0 0 3em"><h1 id="SmallBanner-PageTitle">Creating The Skeleton Application</h1></div></div>
<div class="clearer"></div>
</div>
@@ -83,7 +77,13 @@ table.ScrollbarTable td.ScrollbarNextIco
/*]]>*/</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><p>It will then prompt you 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">
+</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]
@@ -202,7 +202,7 @@ Application 'app' (version 1.0-SNAPSHOT-
2011-11-22 11:46:45.636::INFO: Started SelectChannelConnector@0.0.0.0: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=5&modificationDate=1321973423000&api=v2" data-image-src="/confluence/download/attachments/23340356/startpage.png?version=5&modificationDate=1321973423000&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=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">
<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>
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 Tue Nov 18 01:19:47 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 servlet container created by Greg Wilkins of Webtide (which offers commercial support for Jetty). Jetty is high performance and designed for 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 software build tool of rather epic ambitions. It has a very sophisticated plugin system that allows it to do virtually anything, though compiling Java code, building WAR and JAR files, and creating reports and web sites are its forte.</p><p>Perhaps the biggest advantage of Maven over, say, Ant, is that it can download project dependencies (such as the Tapestry JAR files, and the JAR files Tapestry itself depends on) automatically for you, from one of several central repositories.</p><p>Maven is not essential for using Tapestry, but is especially helpful when performing the initial setup of a Tapestry application.</p><p>Mave
n is available from <a shape="rect" class="external-link" href="http://maven.apache.org/download.html">http://maven.apache.org/download.html</a>.</p><p>There are plugins available for Eclipse, such as <a shape="rect" class="external-link" href="http://eclipse.org/m2e/" >m2e</a>, but for simplicity's sake we won't use those here; instead, we'll use Maven to generate Eclipse control files for us.</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-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[*/
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;}