Author: hlship
Date: Sat Dec 22 08:07:06 2007
New Revision: 606461
URL: http://svn.apache.org/viewvc?rev=606461&view=rev
Log:
TAPESTRY-1973: Tapestry 5 Tutorial Improvements
Modified:
tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/env.apt
tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/first.apt
tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/forms.apt
tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/index.apt
Modified: tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/env.apt
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/env.apt?rev=606461&r1=606460&r2=606461&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/env.apt (original)
+++ tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/env.apt Sat Dec 22
08:07:06 2007
@@ -33,7 +33,9 @@
Jetty Launcher was created by Geoff Longman, and is available from
http://jettylauncher.sourceforge.net/. Installation is easy, simply point
Eclipse's update manager at
{{{http://jettylauncher.sourceforge.net/updates/}http://jettylauncher.sourceforge.net/updates/}}.
-
+
+ If you are behind a firewall, you will need to set up a manual proxy
configuration in Eclipse (Window, Preferences..., General, Network Connections).
+
<<Caution: JettyLauncher is only compatible with Jetty 4 and Jetty 5. It
does not work with Jetty 6.>>
* Maven 2.0.7
Modified: tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/first.apt
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/first.apt?rev=606461&r1=606460&r2=606461&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/first.apt
(original)
+++ tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/first.apt Sat Dec
22 08:07:06 2007
@@ -35,7 +35,28 @@
The first time you execute this command, Maven will spend quite a while
downloading all kinds of JARs into
your local repository, which can take a minute or more. Later, once all that
is already available locally,
the whole command executes in under a second.
-
+
+ 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:
+
+----
+<settings>
+ <proxies>
+ <proxy>
+ <active>true</active>
+ <protocol>http</protocol>
+ <host>myProxyServer.com</host>
+ <port>8080</port>
+ <username>joeuser</username>
+ <password>myPassword</password>
+ <nonProxyHosts></nonProxyHosts>
+ </proxy>
+ </proxies>
+ <localRepository>C:/Documents and
Settings/joeuser/.m2/repository</localRepository>
+</settings>
+----
+
+ Of course, adjust \<localRepository\> to match the correct path for your
computer.
+
One of the first things you can do is use Maven to run Jetty directly.
Change into the newly created directory, and execute the command:
@@ -46,8 +67,13 @@
Again, the first time, there's a dizzying number of downloads, but before
you know it, the Jetty servlet container
is up and running.
+
+
+
+ One
- You can open a web browser to
{{{http://localhost:8080/tutorial1/}http://localhost:8080/tutorial1/}} to see
the running application:
+ You can open a web browser to
{{{http://localhost:8080/tapestry-tutorial1/}http://localhost:8080/tapestry-tutorial1/}}
+ to see the running application:
[startpage.png] Default Start page for Application
@@ -118,7 +144,7 @@
</web-app>
----
- This is short and sweet: ou can see that the package name you provided
earlier shows up as the tapestry.app-package context parameter; the
TapestryFilter instance will use
+ This is short and sweet: you can see that the package name you provided
earlier shows up as the tapestry.app-package context parameter; the
TapestryFilter instance will use
this information to locate the Java classes we'll look at next.
Tapestry 5 operates as a <servlet filter> rather than as a traditional
<servlet>. In this way, Tapestry has a chance to intercept all incoming
requests, to determine
@@ -216,7 +242,7 @@
}
---
- That's pretty darn simple: No classes to extend, no interfaces to implement,
just a very pure POJO (Plain Old Java Object). You do have to mee the Tapestry
framework
+ That's pretty darn simple: No classes to extend, no interfaces to implement,
just a very pure POJO (Plain Old Java Object). You do have to meet the Tapestry
framework
halfway:
* You need to put the Java class in the expected package,
org.apache.tapestry.tutorial.pages
@@ -285,8 +311,8 @@
[app-live-reload.png] Application after live class reloading
- This one of Tapestry's early <wow factor> features: changes to your
component classes are picked up immediately. No restart. No re-deploy. Make
the changes and see them <now>.
- Nothing should slow you down or get in the way of you getting our job done.
+ This is one of Tapestry's early <wow factor> features: changes to your
component classes are picked up immediately. No restart. No re-deploy. Make
the changes and see them <now>.
+ Nothing should slow you down or get in the way of you getting your job done.
Now that we have our basic application set up, and ready to run (or debug)
directly inside Eclipse, we can start working on implementing our
Hi/Lo game in earnest.
Modified: tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/forms.apt
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/forms.apt?rev=606461&r1=606460&r2=606461&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/forms.apt
(original)
+++ tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/forms.apt Sat Dec
22 08:07:06 2007
@@ -158,7 +158,7 @@
* Address Pages
- We're probably going to create a few pages related to addresses: pages for
creating them, for editting them, for searching and listing them.
+ We're probably going to create a few pages related to addresses: pages for
creating them, for editing them, for searching and listing them.
We'll create a sub-folder, address, to hold them. Let's get started on the
first of these pages, "address/Create" (that's the real name, including
the slash --- we'll see in a minute how that maps to classes and templates).
@@ -300,7 +300,7 @@
In Tapestry, every page and component may have its own message catalog.
This is a standard Java properties file, and it is named the same
as the page or component class, with a ".properties" extension. A message
catalog consists of a series of lines, each line is a message key and a message
value
- seperated with an equals sign.
+ separated with an equals sign.
All it takes is to create a message entry with a particular name: the name
of the property suffixed with "-label". As elsewhere, Tapestry is forgiving of
case.
@@ -395,7 +395,7 @@
Before we worry about storing the Address object, we should make sure that
the user provides reasonable values. For example,several of the fields should
be required,
and phone numbers and email address have specific formats.
- The BeanEditForm checks for a Tapestry-specific annotation, @Validate, on
the getter <or> setter method of each property.
+ The BeanEditForm checks for a Tapestry-specific annotation,
@org.apache.tapestry.beaneditor.Validate, on the getter <or> setter method of
each property.
Update the getter methods for the lastName, firstName, street1, city, state
and zip fields,
adding a @Validate annotation to each:
Modified: tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/index.apt
URL:
http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/index.apt?rev=606461&r1=606460&r2=606461&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/index.apt
(original)
+++ tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt/index.apt Sat Dec
22 08:07:06 2007
@@ -9,7 +9,7 @@
Welcome to Tapestry!
This is a tutorial for people who will be creating Tapestry 5 applications.
It doesn't matter whether you have experience with Tapestry 4 (or Tapestry 3,
for that matter) or whether you are completely new to Tapestry.
- In fact, in some ways, the less you know about web development in general,
and Tapestry in particular, the better of you may be ... that much less to
unlearn!
+ In fact, in some ways, the less you know about web development in general,
and Tapestry in particular, the better off you may be ... that much less to
unlearn!
You do need to have a reasonable understanding of HTML, a smattering of XML,
and a good understanding of basic Java language features, and a few newer
things such as Java Annotations.
