You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tapestry.apache.org by hl...@apache.org on 2007/12/22 17:07:06 UTC
svn commit: r606461 - in
/tapestry/tapestry5/trunk/tapestry-tutorial1/src/site/apt: env.apt
first.apt forms.apt index.apt
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.