You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@wicket.apache.org by ad...@apache.org on 2013/11/11 23:13:16 UTC
svn commit: r1540864 [7/38] - in /wicket/common/site/trunk/_site/guide: ./
gapi/ gapi/DefaultPackage/ gapi/spring/ guide/ guide/pages/
guide/src/docs/guide/ guide/src/docs/img/ guide/src/docs/imgOrigin/ img/
Modified: wicket/common/site/trunk/_site/guide/guide/chapter25.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter25.html?rev=1540864&r1=1540863&r2=1540864&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter25.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter25.html Mon Nov 11 22:13:12 2013
@@ -2,7 +2,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
- <title>25 Lost In Redirection With Apache Wicket (Appendix) 6.x</title>
+ <title>26 Lost In Redirection With Apache Wicket (Appendix) 6.x</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<link rel="stylesheet" href="../css/main.css" type="text/css" media="screen, print" title="Style" charset="utf-8"/>
<link rel="stylesheet" href="../css/pdf.css" type="text/css" media="print" title="PDF" charset="utf-8"/>
@@ -27,79 +27,82 @@ function addJsClass() {
<div class="toc-item" style="margin-left:0"><a href="../guide/chapter1.html"><strong>1</strong><span>Introduction</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter2.html"><strong>2</strong><span>Why should I learn Wicket?</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/howToSource.html"><strong>2</strong><span>How to use the example code</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter3.html"><strong>3</strong><span>Wicket says “Hello world!”</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter2.html"><strong>3</strong><span>Why should I learn Wicket?</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter4.html"><strong>4</strong><span>Wicket as page layout manager</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter3.html"><strong>4</strong><span>Wicket says “Hello world!”</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter5.html"><strong>5</strong><span>Keeping control over HTML</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter4.html"><strong>5</strong><span>Wicket as page layout manager</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter6.html"><strong>6</strong><span>Components lifecycle</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter5.html"><strong>6</strong><span>Keeping control over HTML</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter7.html"><strong>7</strong><span>Page versioning and caching</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter6.html"><strong>7</strong><span>Components lifecycle</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter8.html"><strong>8</strong><span>Under the hood of the request processing</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter7.html"><strong>8</strong><span>Page versioning and caching</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter9.html"><strong>9</strong><span>Wicket Links and URL generation</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter8.html"><strong>9</strong><span>Under the hood of the request processing</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter10.html"><strong>10</strong><span>Wicket models and forms</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter9.html"><strong>10</strong><span>Wicket Links and URL generation</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter11.html"><strong>11</strong><span>Wicket forms in detail</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter10.html"><strong>11</strong><span>Wicket models and forms</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter12.html"><strong>12</strong><span>Displaying multiple items with repeaters</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter11.html"><strong>12</strong><span>Wicket forms in detail</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter13.html"><strong>13</strong><span>Internationalization with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter12.html"><strong>13</strong><span>Displaying multiple items with repeaters</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter14.html"><strong>14</strong><span>Resource management with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter13.html"><strong>14</strong><span>Internationalization with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter15.html"><strong>15</strong><span>An example of integration with JavaScript</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter14.html"><strong>15</strong><span>Resource management with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter16.html"><strong>16</strong><span>Wicket advanced topics</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter15.html"><strong>16</strong><span>An example of integration with JavaScript</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter17.html"><strong>17</strong><span>Working with AJAX</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter16.html"><strong>17</strong><span>Wicket advanced topics</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter18.html"><strong>18</strong><span>Integration with enterprise containers</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter17.html"><strong>18</strong><span>Working with AJAX</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter19.html"><strong>19</strong><span>Security with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter18.html"><strong>19</strong><span>Integration with enterprise containers</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter20.html"><strong>20</strong><span>Test Driven Development with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter19.html"><strong>20</strong><span>Security with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter21.html"><strong>21</strong><span>Test Driven Development with Wicket and Spring</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter20.html"><strong>21</strong><span>Test Driven Development with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter22.html"><strong>22</strong><span>Wicket Best Practices</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter21.html"><strong>22</strong><span>Test Driven Development with Wicket and Spring</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter23.html"><strong>23</strong><span>Working with Maven (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter22.html"><strong>23</strong><span>Wicket Best Practices</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter24.html"><strong>24</strong><span>Project WicketStuff (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter23.html"><strong>24</strong><span>Working with Maven (Appendix)</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter25.html"><strong>25</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter24.html"><strong>25</strong><span>Project WicketStuff (Appendix)</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter26.html"><strong>26</strong><span>Contributing to this guide (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter25.html"><strong>26</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a>
+ </div>
+
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter26.html"><strong>27</strong><span>Contributing to this guide (Appendix)</span></a>
</div>
</div>
@@ -129,18 +132,18 @@ function addJsClass() {
<div id="main" class="corner-all">
- <div class="toc-item prev-left"><a href="../guide/chapter24.html"><< <strong>24</strong><span>Project WicketStuff (Appendix)</span></a></div>
+ <div class="toc-item prev-left"><a href="../guide/chapter24.html"><< <strong>25</strong><span>Project WicketStuff (Appendix)</span></a></div>
<span id='toggle-col1' class="toggle">(<a href="#" onclick="localToggle(); return false;">Quick Reference</a>)</span>
- <div class="toc-item next-right"><a href="../guide/chapter26.html"><strong>26</strong><span>Contributing to this guide (Appendix)</span> >></a></div>
+ <div class="toc-item next-right"><a href="../guide/chapter26.html"><strong>27</strong><span>Contributing to this guide (Appendix)</span> >></a></div>
<div class="project">
- <h1>25 Lost In Redirection With Apache Wicket (Appendix) - Reference Documentation</h1>
+ <h1>26 Lost In Redirection With Apache Wicket (Appendix) - Reference Documentation</h1>
<p><strong>Authors:</strong> Andrea Del Bene, Carsten Hufe, Christian Kroemer, Daniel Bartl, Paul BorÈ</p>
@@ -153,7 +156,7 @@ function addJsClass() {
-<h1 id="chapter25">25 Lost In Redirection With Apache Wicket (Appendix)</h1>
+<h1 id="chapter25">26 Lost In Redirection With Apache Wicket (Appendix)</h1>
Quite a few teams have already got stuck into the following problem when working with wicket forms in a clustered environment while having 2 (or more) tomcat server with enabled session replication running.<p class="paragraph"/>In case of invalid data being submitted with a form instance for example, it seemed like according error messages wouldnât be presented when the same form page gets displayed again. Sometimes! And sometimes they would! One of those nightmares of rather deterministic programmerâs life. This so called Lost In Redirection problem, even if it looks like a wicket bug at first, is rather a result of a default setting in wicket regarding the processing of form submissions in general. In order to prevent another wide known problem of double form submissions, Wicket uses a so called REDIRECT_TO_BUFFER strategy for dealing with rendering a page after web formâs processing (@see IRequestCycleSettings#RenderStrategy).<p class="paragraph"/>What does the def
ault RenderStrategy actually do?<p class="paragraph"/>Both logical parts of a single HTTP request, an action and a render part get processed within the same request, but instead of streaming the render result to the browser directly, the result is cached on the server first.<p class="paragraph"/><img border="0" class="center" src="../img/lost-in-redirection-mockup.png"></img><p class="paragraph"/>Wicket will create an according BufferedHttpServletResponse instance that will be used to cache the resulting HttpServletResponse within the WebApplication.<p class="paragraph"/><img border="0" class="center" src="../img/lost-in-redirection-mockup2.png"></img><p class="paragraph"/>After the buffered response is cached the HTTP status code of 302 getâs provided back to the browser resulting in an additional GET request to the redirect URL (which Wicket sets to the URL of the Form itself). There is a special handling code for this case in the WicketFilter instance that then looks up a Ma
p of buffered responses within the WebApplication accordingly. If an appropriate already cached response for the current request is found, it getâs streamed back to the browser immediately. No additional form processing happens now. The following is a code snippet taken from WicketFilter:<p class="paragraph"/><div class="code"><pre>// Are we using REDIRECT_TO_BUFFER?
<span class="java-keyword">if</span> (webApplication.getRequestCycleSettings().getRenderStrategy() == IRequestCycleSettings.REDIRECT_TO_BUFFER)
{
@@ -194,9 +197,9 @@ Quite a few teams have already got stuck
<div style="clear:both;margin-top:15px;"></div>
- <div class="toc-item prev-left"><a href="../guide/chapter24.html"><< <strong>24</strong><span>Project WicketStuff (Appendix)</span></a></div>
+ <div class="toc-item prev-left"><a href="../guide/chapter24.html"><< <strong>25</strong><span>Project WicketStuff (Appendix)</span></a></div>
- <div class="toc-item next-right"><a href="../guide/chapter26.html"><strong>26</strong><span>Contributing to this guide (Appendix)</span> >></a></div>
+ <div class="toc-item next-right"><a href="../guide/chapter26.html"><strong>27</strong><span>Contributing to this guide (Appendix)</span> >></a></div>
<div style="clear:both"></div>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter26.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter26.html?rev=1540864&r1=1540863&r2=1540864&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter26.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter26.html Mon Nov 11 22:13:12 2013
@@ -2,7 +2,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
- <title>26 Contributing to this guide (Appendix) 6.x</title>
+ <title>27 Contributing to this guide (Appendix) 6.x</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<link rel="stylesheet" href="../css/main.css" type="text/css" media="screen, print" title="Style" charset="utf-8"/>
<link rel="stylesheet" href="../css/pdf.css" type="text/css" media="print" title="PDF" charset="utf-8"/>
@@ -27,79 +27,82 @@ function addJsClass() {
<div class="toc-item" style="margin-left:0"><a href="../guide/chapter1.html"><strong>1</strong><span>Introduction</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter2.html"><strong>2</strong><span>Why should I learn Wicket?</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/howToSource.html"><strong>2</strong><span>How to use the example code</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter3.html"><strong>3</strong><span>Wicket says “Hello world!”</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter2.html"><strong>3</strong><span>Why should I learn Wicket?</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter4.html"><strong>4</strong><span>Wicket as page layout manager</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter3.html"><strong>4</strong><span>Wicket says “Hello world!”</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter5.html"><strong>5</strong><span>Keeping control over HTML</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter4.html"><strong>5</strong><span>Wicket as page layout manager</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter6.html"><strong>6</strong><span>Components lifecycle</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter5.html"><strong>6</strong><span>Keeping control over HTML</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter7.html"><strong>7</strong><span>Page versioning and caching</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter6.html"><strong>7</strong><span>Components lifecycle</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter8.html"><strong>8</strong><span>Under the hood of the request processing</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter7.html"><strong>8</strong><span>Page versioning and caching</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter9.html"><strong>9</strong><span>Wicket Links and URL generation</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter8.html"><strong>9</strong><span>Under the hood of the request processing</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter10.html"><strong>10</strong><span>Wicket models and forms</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter9.html"><strong>10</strong><span>Wicket Links and URL generation</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter11.html"><strong>11</strong><span>Wicket forms in detail</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter10.html"><strong>11</strong><span>Wicket models and forms</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter12.html"><strong>12</strong><span>Displaying multiple items with repeaters</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter11.html"><strong>12</strong><span>Wicket forms in detail</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter13.html"><strong>13</strong><span>Internationalization with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter12.html"><strong>13</strong><span>Displaying multiple items with repeaters</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter14.html"><strong>14</strong><span>Resource management with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter13.html"><strong>14</strong><span>Internationalization with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter15.html"><strong>15</strong><span>An example of integration with JavaScript</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter14.html"><strong>15</strong><span>Resource management with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter16.html"><strong>16</strong><span>Wicket advanced topics</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter15.html"><strong>16</strong><span>An example of integration with JavaScript</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter17.html"><strong>17</strong><span>Working with AJAX</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter16.html"><strong>17</strong><span>Wicket advanced topics</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter18.html"><strong>18</strong><span>Integration with enterprise containers</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter17.html"><strong>18</strong><span>Working with AJAX</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter19.html"><strong>19</strong><span>Security with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter18.html"><strong>19</strong><span>Integration with enterprise containers</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter20.html"><strong>20</strong><span>Test Driven Development with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter19.html"><strong>20</strong><span>Security with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter21.html"><strong>21</strong><span>Test Driven Development with Wicket and Spring</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter20.html"><strong>21</strong><span>Test Driven Development with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter22.html"><strong>22</strong><span>Wicket Best Practices</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter21.html"><strong>22</strong><span>Test Driven Development with Wicket and Spring</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter23.html"><strong>23</strong><span>Working with Maven (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter22.html"><strong>23</strong><span>Wicket Best Practices</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter24.html"><strong>24</strong><span>Project WicketStuff (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter23.html"><strong>24</strong><span>Working with Maven (Appendix)</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter25.html"><strong>25</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter24.html"><strong>25</strong><span>Project WicketStuff (Appendix)</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter26.html"><strong>26</strong><span>Contributing to this guide (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter25.html"><strong>26</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a>
+ </div>
+
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter26.html"><strong>27</strong><span>Contributing to this guide (Appendix)</span></a>
</div>
</div>
@@ -129,7 +132,7 @@ function addJsClass() {
<div id="main" class="corner-all">
- <div class="toc-item prev-left"><a href="../guide/chapter25.html"><< <strong>25</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a></div>
+ <div class="toc-item prev-left"><a href="../guide/chapter25.html"><< <strong>26</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a></div>
<span id='toggle-col1' class="toggle">(<a href="#" onclick="localToggle(); return false;">Quick Reference</a>)</span>
@@ -138,7 +141,7 @@ function addJsClass() {
<div class="project">
- <h1>26 Contributing to this guide (Appendix) - Reference Documentation</h1>
+ <h1>27 Contributing to this guide (Appendix) - Reference Documentation</h1>
<p><strong>Authors:</strong> Andrea Del Bene, Carsten Hufe, Christian Kroemer, Daniel Bartl, Paul BorÈ</p>
@@ -151,7 +154,7 @@ function addJsClass() {
-<h1 id="chapter26">26 Contributing to this guide (Appendix)</h1>
+<h1 id="chapter26">27 Contributing to this guide (Appendix)</h1>
You can contribute to this guide by following these steps:
<ul class="star">
<li>The guide uses Grails GDoc to generate the final HTML/PDF so you should consult with its <a href="http://grails.org/WikiSyntax" target="blank">syntax</a>.</li>
@@ -178,7 +181,7 @@ and attach it to a ticket in Apache Wick
<div style="clear:both;margin-top:15px;"></div>
- <div class="toc-item prev-left"><a href="../guide/chapter25.html"><< <strong>25</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a></div>
+ <div class="toc-item prev-left"><a href="../guide/chapter25.html"><< <strong>26</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a></div>
<div style="clear:both"></div>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter3.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter3.html?rev=1540864&r1=1540863&r2=1540864&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter3.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter3.html Mon Nov 11 22:13:12 2013
@@ -2,7 +2,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
- <title>3 Wicket says “Hello world!” 6.x</title>
+ <title>4 Wicket says “Hello world!” 6.x</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<link rel="stylesheet" href="../css/main.css" type="text/css" media="screen, print" title="Style" charset="utf-8"/>
<link rel="stylesheet" href="../css/pdf.css" type="text/css" media="print" title="PDF" charset="utf-8"/>
@@ -27,79 +27,82 @@ function addJsClass() {
<div class="toc-item" style="margin-left:0"><a href="../guide/chapter1.html"><strong>1</strong><span>Introduction</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter2.html"><strong>2</strong><span>Why should I learn Wicket?</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/howToSource.html"><strong>2</strong><span>How to use the example code</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter3.html"><strong>3</strong><span>Wicket says “Hello world!”</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter2.html"><strong>3</strong><span>Why should I learn Wicket?</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter4.html"><strong>4</strong><span>Wicket as page layout manager</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter3.html"><strong>4</strong><span>Wicket says “Hello world!”</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter5.html"><strong>5</strong><span>Keeping control over HTML</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter4.html"><strong>5</strong><span>Wicket as page layout manager</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter6.html"><strong>6</strong><span>Components lifecycle</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter5.html"><strong>6</strong><span>Keeping control over HTML</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter7.html"><strong>7</strong><span>Page versioning and caching</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter6.html"><strong>7</strong><span>Components lifecycle</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter8.html"><strong>8</strong><span>Under the hood of the request processing</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter7.html"><strong>8</strong><span>Page versioning and caching</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter9.html"><strong>9</strong><span>Wicket Links and URL generation</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter8.html"><strong>9</strong><span>Under the hood of the request processing</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter10.html"><strong>10</strong><span>Wicket models and forms</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter9.html"><strong>10</strong><span>Wicket Links and URL generation</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter11.html"><strong>11</strong><span>Wicket forms in detail</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter10.html"><strong>11</strong><span>Wicket models and forms</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter12.html"><strong>12</strong><span>Displaying multiple items with repeaters</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter11.html"><strong>12</strong><span>Wicket forms in detail</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter13.html"><strong>13</strong><span>Internationalization with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter12.html"><strong>13</strong><span>Displaying multiple items with repeaters</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter14.html"><strong>14</strong><span>Resource management with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter13.html"><strong>14</strong><span>Internationalization with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter15.html"><strong>15</strong><span>An example of integration with JavaScript</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter14.html"><strong>15</strong><span>Resource management with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter16.html"><strong>16</strong><span>Wicket advanced topics</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter15.html"><strong>16</strong><span>An example of integration with JavaScript</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter17.html"><strong>17</strong><span>Working with AJAX</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter16.html"><strong>17</strong><span>Wicket advanced topics</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter18.html"><strong>18</strong><span>Integration with enterprise containers</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter17.html"><strong>18</strong><span>Working with AJAX</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter19.html"><strong>19</strong><span>Security with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter18.html"><strong>19</strong><span>Integration with enterprise containers</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter20.html"><strong>20</strong><span>Test Driven Development with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter19.html"><strong>20</strong><span>Security with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter21.html"><strong>21</strong><span>Test Driven Development with Wicket and Spring</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter20.html"><strong>21</strong><span>Test Driven Development with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter22.html"><strong>22</strong><span>Wicket Best Practices</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter21.html"><strong>22</strong><span>Test Driven Development with Wicket and Spring</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter23.html"><strong>23</strong><span>Working with Maven (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter22.html"><strong>23</strong><span>Wicket Best Practices</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter24.html"><strong>24</strong><span>Project WicketStuff (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter23.html"><strong>24</strong><span>Working with Maven (Appendix)</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter25.html"><strong>25</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter24.html"><strong>25</strong><span>Project WicketStuff (Appendix)</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter26.html"><strong>26</strong><span>Contributing to this guide (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter25.html"><strong>26</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a>
+ </div>
+
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter26.html"><strong>27</strong><span>Contributing to this guide (Appendix)</span></a>
</div>
</div>
@@ -129,18 +132,18 @@ function addJsClass() {
<div id="main" class="corner-all">
- <div class="toc-item prev-left"><a href="../guide/chapter2.html"><< <strong>2</strong><span>Why should I learn Wicket?</span></a></div>
+ <div class="toc-item prev-left"><a href="../guide/chapter2.html"><< <strong>3</strong><span>Why should I learn Wicket?</span></a></div>
<span id='toggle-col1' class="toggle">(<a href="#" onclick="localToggle(); return false;">Quick Reference</a>)</span>
- <div class="toc-item next-right"><a href="../guide/chapter4.html"><strong>4</strong><span>Wicket as page layout manager</span> >></a></div>
+ <div class="toc-item next-right"><a href="../guide/chapter4.html"><strong>5</strong><span>Wicket as page layout manager</span> >></a></div>
<div class="project">
- <h1>3 Wicket says “Hello world!” - Reference Documentation</h1>
+ <h1>4 Wicket says “Hello world!” - Reference Documentation</h1>
<p><strong>Authors:</strong> Andrea Del Bene, Carsten Hufe, Christian Kroemer, Daniel Bartl, Paul BorÈ</p>
@@ -153,19 +156,19 @@ function addJsClass() {
<div id="table-of-content">
<h2>Table of Contents</h2>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter3_1"><strong>3.1</strong><span>Wicket distribution and modules</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter3_1"><strong>4.1</strong><span>Wicket distribution and modules</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter3_2"><strong>3.2</strong><span>Configuration of Wicket applications</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter3_2"><strong>4.2</strong><span>Configuration of Wicket applications</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter3_3"><strong>3.3</strong><span>The HomePage class</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter3_3"><strong>4.3</strong><span>The HomePage class</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter3_4"><strong>3.4</strong><span>Wicket Links</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter3_4"><strong>4.4</strong><span>Wicket Links</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter3_5"><strong>3.5</strong><span>Summary</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter3_5"><strong>4.5</strong><span>Summary</span></a>
</div>
</div>
@@ -173,17 +176,17 @@ function addJsClass() {
-<h1 id="chapter3">3 Wicket says âHello world!â</h1>
+<h1 id="chapter3">4 Wicket says âHello world!â</h1>
Wicket allows us to design our web pages in terms of components and containers, just like AWT does with desktop windows.
Both frameworks share the same component-based architecture: in AWT we have a <code>Windows</code> instance which represents the physical windows containing GUI components (like text fields, radio buttons, drawing areas, etc...), in Wicket we have a <code>WebPage</code> instance which represents the physical web page containing HTML components (pictures, buttons, forms, etc… ) .<p class="paragraph"/><img border="0" class="center" src="../img/uml-component.png"></img><p class="paragraph"/>In both frameworks we find a base class for GUI components called <code>Component</code>. Wicket pages can be composed (and usually are) by many components, just like AWT windows are composed by Swing/AWT components. Both frameworks promote the reuse of presentation code and GUI elements building custom components. Even if Wicket already comes with a rich set of ready-to-use components, building custom components is a common practice when working with this framework. We'll learn more about cus
tom components in the next chapters.
-<h2 id="chapter3_1">3.1 Wicket distribution and modules</h2>
+<h2 id="chapter3_1">4.1 Wicket distribution and modules</h2>
Wicket is available as a binary package on the main site <a href="http://wicket.apache.org" target="blank">http://wicket.apache.org</a> . Inside this archive we can find the distribution jars of the framework. Each jar corresponds to a sub-module of the framework. The following table reports these modules along with a short description of their purpose and with the related dependencies:<p class="paragraph"/><table class="wiki-table" cellpadding="0" cellspacing="0" border="0"><tr><th><strong class="bold">Module'sname</strong></th><th><strong class="bold">Description</strong></th><th><strong class="bold">Dependencies</strong></th></tr><tr class="table-odd"><td>wicket-core</td><td>Contains the main classes of the framework, like class <code>Component</code> and <code>Application</code>.</td><td>wicket-request, wicket-util</td></tr><tr class="table-even"><td>wicket-request</td><td>This module contains the classes involved into web request processing.</td><td>wicket-util</td></tr><tr cla
ss="table-odd"><td>wicket-util</td><td>Contains general-purpose utility classes for functional areas such as I/O, lang, string manipulation, security, etc...</td><td>None</td></tr><tr class="table-even"><td>wicket-datetime</td><td>Contains special purpose components designed to work with date and time.</td><td>wicket-core</td></tr><tr class="table-odd"><td>wicket-devutils</td><td>Contains utility classes and components to help developers with tasks such as debugging, class inspection and so on.</td><td>wicket-core, wicket-extensions</td></tr><tr class="table-even"><td>wicket-extensions</td><td>Contains a vast set of built-in components to build a rich UI for our web application (Ajax support is part of this module).</td><td>wicket-core</td></tr><tr class="table-odd"><td>wicket-auth-roles</td><td>Provides support for role-based authorization.</td><td>wicket-core</td></tr><tr class="table-even"><td>wicket-ioc</td><td>This module provides common classes to support Inversion Of Control.
It's used by both Spring and Guice integration module.</td><td>wicket-core</td></tr><tr class="table-odd"><td>wicket-guice</td><td>This module provides integration with the dependency injection framework developed by Google.</td><td>wicket-core, wicket-ioc</td></tr><tr class="table-even"><td>wicket-spring</td><td>This module provides integration with Spring framework.</td><td>wicket-core, wicket-ioc</td></tr><tr class="table-odd"><td>wicket-velocity</td><td>This module provides panels and utility class to integrate Wicket with Velocity template engine.</td><td>wicket-core</td></tr><tr class="table-even"><td>wicket-jmx</td><td>This module provides panels and utility class to integrate Wicket with Java Management Extensions.</td><td>wicket-core</td></tr><tr class="table-odd"><td>wicket-objectsizeof-agent</td><td>Provides integration with Java agent libraries and instrumentation tools.</td><td>wicket-core</td></tr></table><p class="paragraph"/>Please note that the core module depends
on the utility and request modules, hence it cannot be used without them.
-<h2 id="chapter3_2">3.2 Configuration of Wicket applications</h2>
+<h2 id="chapter3_2">4.2 Configuration of Wicket applications</h2>
In this chapter we will see a classic Hello World! example implemented using a Wicket page with a built-in component called <code>Label</code> (the code is from project the HelloWorldExample). Since this is the first example of the guide, before looking at Java code we will go through the common artifacts needed to build a Wicket application from scratch.<p class="paragraph"/><blockquote class="note">
All the example projects presented in this document have been generated using Maven and the utility page at <a href="http://wicket.apache.org/start/quickstart.html" target="blank">http://wicket.apache.org/start/quickstart.html</a> . <strong class="bold">Appendix A</strong> contains the instructions needed to use these projects and build a quickstart application using Apache Maven. All the artifacts used in the next example (files web.xml, HomePage.class and HomePage.html) are automatically generated by Maven.
</blockquote><p class="paragraph"/><h3>Wicket application structure</h3><p class="paragraph"/>A Wicket application is a standard Java EE web application, hence it is deployed through a web.xml file placed inside folder WEB-INF:<p class="paragraph"/><img border="0" class="center" src="../img/webinf.png"></img><p class="paragraph"/> <em class="italic">Illustration : The standard directory structure of a Wicket application</em> <p class="paragraph"/>The content of web.xml declares a servlet filter (class <code>org.apache.wicket.Protocol.http.WicketFilter</code>) which dispatches web requests to our Wicket application:<p class="paragraph"/><div class="code"><pre><span class="xml-tag"><?xml version=<span class="xml-quote">"1.0"</span> encoding=<span class="xml-quote">"UTF-8"</span>?></span>
@@ -223,7 +226,7 @@ If we prefer to use a servlet instead of
</blockquote>
-<h2 id="chapter3_3">3.3 The HomePage class</h2>
+<h2 id="chapter3_3">4.3 The HomePage class</h2>
<p class="paragraph"/>To complete our first Wicket application we must explore the home page class that is returned by the <code>Application</code>'s method <code>getHomePage()</code> seen above.
In Wicket a web page is a subclass of <code>org.apache.wicket.WebPage</code>. This subclass must have a corresponding HTML file which will be used by the framework as template to generate its HTML markup. This file is a regular plain HTML file (its extension must be html).<p class="paragraph"/>By default this HTML file must have the same name of the related page class and must be in the same package:<p class="paragraph"/><img border="0" class="center" src="../img/samepackage.png"></img><p class="paragraph"/> <em class="italic">Illustration :Page class and its related HTML file</em> <p class="paragraph"/>If you don't like to put class and html side by side (let's say you want all your HTML files in a separated folder) you can use Wicket settings to specify where HTML files can be found. We will cover this topic later in <a href="../guide/single.html#chapter14_9" class="guide">chapter 14.9</a>.<p class="paragraph"/>The Java code for the <code>HomePage</code> class is the following:<p
class="paragraph"/><div class="code"><pre><span class="java-keyword">package</span> org.wicketTutorial;<p class="paragraph"/><span class="java-keyword">import</span> org.apache.wicket.request.mapper.parameter.PageParameters;
<span class="java-keyword">import</span> org.apache.wicket.markup.html.basic.Label;
@@ -252,7 +255,7 @@ If we specify a <code>wicket:id</code> a
-<h2 id="chapter3_4">3.4 Wicket Links</h2>
+<h2 id="chapter3_4">4.4 Wicket Links</h2>
The basic form of interaction offered by web applications is to navigate through pages using links. In HTML a link is basically a pointer to another resource that most of the time is another page. Wicket implements links with component <code>org.apache.wicket.markup.html.link.Link</code>, but due to the component-oriented nature of the framework, this component is quite different from classic HTML links.
Following the analogy with GUI frameworks, we can consider Wicket link as a âclickâ event handler: its purpose is to perform some actions (on server side!) when the user clicks on it.<p class="paragraph"/>That said, you shouldn't be surprised to find an abstract method called <code>onClick()</code> inside the <code>Link</code> class. In the following example we have a page with a <code>Link</code> containing an empty implementation of <code>onClick</code>:<p class="paragraph"/><div class="code"><pre><span class="java-keyword">public</span> class HomePage <span class="java-keyword">extends</span> WebPage {
<span class="java-keyword">public</span> HomePage(){
@@ -283,7 +286,7 @@ Wicket comes with a rich set of link com
</blockquote>
-<h2 id="chapter3_5">3.5 Summary</h2>
+<h2 id="chapter3_5">4.5 Summary</h2>
In this chapter we have seen the basic elements that compose a Wicket application. We have started preparing the configuration artifacts needed for our applications. As promised in <a href="../guide/single.html#chapter2_4" class="guide">chapter 2.4</a>, we needed to put in place just a minimal amount of XML with an application class and a home page.
Then we have continued our âfirst contactâ with Wicket learning how to build a simple page with a label component as child. This example page has shown us how Wicket maps components to HTML tags and how it uses both of them to generate the final HTML markup.
In the last paragraph we had a first taste of Wicket links and we have seen how they can be considered as a âclickâ event listener and how they can be used to navigate from a page to another.
@@ -291,9 +294,9 @@ In the last paragraph we had a first tas
<div style="clear:both;margin-top:15px;"></div>
- <div class="toc-item prev-left"><a href="../guide/chapter2.html"><< <strong>2</strong><span>Why should I learn Wicket?</span></a></div>
+ <div class="toc-item prev-left"><a href="../guide/chapter2.html"><< <strong>3</strong><span>Why should I learn Wicket?</span></a></div>
- <div class="toc-item next-right"><a href="../guide/chapter4.html"><strong>4</strong><span>Wicket as page layout manager</span> >></a></div>
+ <div class="toc-item next-right"><a href="../guide/chapter4.html"><strong>5</strong><span>Wicket as page layout manager</span> >></a></div>
<div style="clear:both"></div>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter4.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter4.html?rev=1540864&r1=1540863&r2=1540864&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter4.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter4.html Mon Nov 11 22:13:12 2013
@@ -2,7 +2,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
- <title>4 Wicket as page layout manager 6.x</title>
+ <title>5 Wicket as page layout manager 6.x</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<link rel="stylesheet" href="../css/main.css" type="text/css" media="screen, print" title="Style" charset="utf-8"/>
<link rel="stylesheet" href="../css/pdf.css" type="text/css" media="print" title="PDF" charset="utf-8"/>
@@ -27,79 +27,82 @@ function addJsClass() {
<div class="toc-item" style="margin-left:0"><a href="../guide/chapter1.html"><strong>1</strong><span>Introduction</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter2.html"><strong>2</strong><span>Why should I learn Wicket?</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/howToSource.html"><strong>2</strong><span>How to use the example code</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter3.html"><strong>3</strong><span>Wicket says “Hello world!”</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter2.html"><strong>3</strong><span>Why should I learn Wicket?</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter4.html"><strong>4</strong><span>Wicket as page layout manager</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter3.html"><strong>4</strong><span>Wicket says “Hello world!”</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter5.html"><strong>5</strong><span>Keeping control over HTML</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter4.html"><strong>5</strong><span>Wicket as page layout manager</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter6.html"><strong>6</strong><span>Components lifecycle</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter5.html"><strong>6</strong><span>Keeping control over HTML</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter7.html"><strong>7</strong><span>Page versioning and caching</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter6.html"><strong>7</strong><span>Components lifecycle</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter8.html"><strong>8</strong><span>Under the hood of the request processing</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter7.html"><strong>8</strong><span>Page versioning and caching</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter9.html"><strong>9</strong><span>Wicket Links and URL generation</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter8.html"><strong>9</strong><span>Under the hood of the request processing</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter10.html"><strong>10</strong><span>Wicket models and forms</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter9.html"><strong>10</strong><span>Wicket Links and URL generation</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter11.html"><strong>11</strong><span>Wicket forms in detail</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter10.html"><strong>11</strong><span>Wicket models and forms</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter12.html"><strong>12</strong><span>Displaying multiple items with repeaters</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter11.html"><strong>12</strong><span>Wicket forms in detail</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter13.html"><strong>13</strong><span>Internationalization with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter12.html"><strong>13</strong><span>Displaying multiple items with repeaters</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter14.html"><strong>14</strong><span>Resource management with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter13.html"><strong>14</strong><span>Internationalization with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter15.html"><strong>15</strong><span>An example of integration with JavaScript</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter14.html"><strong>15</strong><span>Resource management with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter16.html"><strong>16</strong><span>Wicket advanced topics</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter15.html"><strong>16</strong><span>An example of integration with JavaScript</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter17.html"><strong>17</strong><span>Working with AJAX</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter16.html"><strong>17</strong><span>Wicket advanced topics</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter18.html"><strong>18</strong><span>Integration with enterprise containers</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter17.html"><strong>18</strong><span>Working with AJAX</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter19.html"><strong>19</strong><span>Security with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter18.html"><strong>19</strong><span>Integration with enterprise containers</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter20.html"><strong>20</strong><span>Test Driven Development with Wicket</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter19.html"><strong>20</strong><span>Security with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter21.html"><strong>21</strong><span>Test Driven Development with Wicket and Spring</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter20.html"><strong>21</strong><span>Test Driven Development with Wicket</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter22.html"><strong>22</strong><span>Wicket Best Practices</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter21.html"><strong>22</strong><span>Test Driven Development with Wicket and Spring</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter23.html"><strong>23</strong><span>Working with Maven (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter22.html"><strong>23</strong><span>Wicket Best Practices</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter24.html"><strong>24</strong><span>Project WicketStuff (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter23.html"><strong>24</strong><span>Working with Maven (Appendix)</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter25.html"><strong>25</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter24.html"><strong>25</strong><span>Project WicketStuff (Appendix)</span></a>
</div>
- <div class="toc-item" style="margin-left:0"><a href="../guide/chapter26.html"><strong>26</strong><span>Contributing to this guide (Appendix)</span></a>
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter25.html"><strong>26</strong><span>Lost In Redirection With Apache Wicket (Appendix)</span></a>
+ </div>
+
+ <div class="toc-item" style="margin-left:0"><a href="../guide/chapter26.html"><strong>27</strong><span>Contributing to this guide (Appendix)</span></a>
</div>
</div>
@@ -129,18 +132,18 @@ function addJsClass() {
<div id="main" class="corner-all">
- <div class="toc-item prev-left"><a href="../guide/chapter3.html"><< <strong>3</strong><span>Wicket says “Hello world!”</span></a></div>
+ <div class="toc-item prev-left"><a href="../guide/chapter3.html"><< <strong>4</strong><span>Wicket says “Hello world!”</span></a></div>
<span id='toggle-col1' class="toggle">(<a href="#" onclick="localToggle(); return false;">Quick Reference</a>)</span>
- <div class="toc-item next-right"><a href="../guide/chapter5.html"><strong>5</strong><span>Keeping control over HTML</span> >></a></div>
+ <div class="toc-item next-right"><a href="../guide/chapter5.html"><strong>6</strong><span>Keeping control over HTML</span> >></a></div>
<div class="project">
- <h1>4 Wicket as page layout manager - Reference Documentation</h1>
+ <h1>5 Wicket as page layout manager - Reference Documentation</h1>
<p><strong>Authors:</strong> Andrea Del Bene, Carsten Hufe, Christian Kroemer, Daniel Bartl, Paul BorÈ</p>
@@ -153,19 +156,19 @@ function addJsClass() {
<div id="table-of-content">
<h2>Table of Contents</h2>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter4_1"><strong>4.1</strong><span>Header, footer, left menu, content, etc...</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter4_1"><strong>5.1</strong><span>Header, footer, left menu, content, etc...</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter4_2"><strong>4.2</strong><span>Here comes the inheritance!</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter4_2"><strong>5.2</strong><span>Here comes the inheritance!</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter4_3"><strong>4.3</strong><span>Divide et impera!</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter4_3"><strong>5.3</strong><span>Divide et impera!</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter4_4"><strong>4.4</strong><span>Markup inheritance with the wicket:extend tag</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter4_4"><strong>5.4</strong><span>Markup inheritance with the wicket:extend tag</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter4_5"><strong>4.5</strong><span>Summary</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter4_5"><strong>5.5</strong><span>Summary</span></a>
</div>
</div>
@@ -173,12 +176,12 @@ function addJsClass() {
-<h1 id="chapter4">4 Wicket as page layout manager</h1>
+<h1 id="chapter4">5 Wicket as page layout manager</h1>
Before going ahead with more advanced topics, we will see how to maintain a consistent layout across our site using Wicket and its component-oriented features. Probably this is not the most interesting use we can get out of Wicket, but it is surely the simplest one so it's the best way to get our hands dirty with some code.
-<h2 id="chapter4_1">4.1 Header, footer, left menu, content, etc...</h2>
+<h2 id="chapter4_1">5.1 Header, footer, left menu, content, etc...</h2>
There was a time in the 90s when Internet was just a buzzword and watching a plain HTML page being rendered by a browser was a new and amazing experience. In those days we used to organize our page layout using the <code><frame></code> HTML tag. Over the years this tag has almost disappeared from our code and it survives only in few specific domains. For example is still being used by JavaDoc.<p class="paragraph"/>With the adoption of server side technologies like JSP, ASP or PHP the tag <code><frame></code> has been replaced by a template-based approach where we divide our page layout into some common areas that will be present in each page of our web application. Then, we manually insert these areas in every page including the appropriate markup fragments.<p class="paragraph"/>In this chapter we will see how to use Wicket to build a site layout. The sample layout we will use is a typical page layout consisting of the following areas:
<ul class="star">
<li><strong class="bold">a header</strong> which could contain site title, some logos, a navigation bar, etc...</li>
@@ -190,7 +193,7 @@ For the sake of simplicity we can consid
</blockquote><p class="paragraph"/>Now let's see how we can handle the layout of our web application using Wicket.
-<h2 id="chapter4_2">4.2 Here comes the inheritance!</h2>
+<h2 id="chapter4_2">5.2 Here comes the inheritance!</h2>
The need of ensuring a consistent layout across our pages unveiled a serious limit of the HTML: the inability to apply inheritance to web pages and their markup. Wouldn't be great if we could write our layout once in a page and then inherit it in the other pages of our application?
One of the goals of Wicket is to overcome this kind of limit.<p class="paragraph"/><h3>Markup inheritance</h3><p class="paragraph"/>As we have seen in the previous chapter, Wicket pages are pure Java classes, so we can easily write a page which is a subclass of another parent page. But in Wicket inheritance is not limited to the classic object-oriented code inheritance. When a class subclasses a <code>WebPage</code> it also inherits the HTML file of to the parent class. This type of inheritance is called markup inheritance.
To better illustrate this concept let's consider the following example where we have a page class called <code>GenericSitePage</code> with the corresponding HTML file GenericSitePage.html. Now let's create a specific page called <code>OrderCheckOutPage</code> where users can check out their orders on our our web site. This class extends <code>GenericSitePage</code> but we don't provide it with any corresponding HTML file.
@@ -220,7 +223,7 @@ add(myPanel);</pre></div><p class="parag
-<h2 id="chapter4_3">4.3 Divide et impera!</h2>
+<h2 id="chapter4_3">5.3 Divide et impera!</h2>
Let's go back to our layout example. In <a href="../guide/single.html#chapter4_1" class="guide">chapter 4.1</a> we have divided our layout in common areas that must be part of every page. Now we will build a reusable template page for our web application combining pages and panels. The code examples are from project MarkupInheritanceExample.<p class="paragraph"/><h3>Panels and layout areas</h3><p class="paragraph"/>First, let's build a custom panel for each layout area (except for 'content' area). For example given the header area<p class="paragraph"/><img border="0" class="center" src="../img/header-area.png"></img><p class="paragraph"/>we can build a panel called <code>HeaderPanel</code> with a related markup file called HeaderPanel.html containing the HTML for this area:<p class="paragraph"/><div class="code"><pre><html>
<head>
<meta http-equiv=<span class="java-quote">"Content-Type"</span> content=<span class="java-quote">"text/html; charset=UTF-8"</span>>
@@ -307,7 +310,7 @@ The page class contains the code to phys
}</pre></div><p class="paragraph"/>Obviously this page doesn't come with a related markup file. You can see the final page in the following picture:<p class="paragraph"/><img border="0" class="center" src="../img/final-login-page.png"></img><p class="paragraph"/>
-<h2 id="chapter4_4">4.4 Markup inheritance with the wicket:extend tag</h2>
+<h2 id="chapter4_4">5.4 Markup inheritance with the wicket:extend tag</h2>
With Wicket we can apply markup inheritance using another approach based on the tag <code><wicket:child></code>. This tag is used inside the parent's markup to define where the children pages/panels can âinjectâ their custom markup extending the markup inherited from the parent component.
An example of a parent page using the tag <code><wicket:child></code> is the following:<p class="paragraph"/><div class="code"><pre><html>
<head>
@@ -372,16 +375,16 @@ An example of a parent page using the ta
</html></pre></div><p class="paragraph"/>As we can see this approach doesn't require to create custom panels to use as content area and it can be useful if we don't have to handle a GUI with a high degree of complexity.
-<h2 id="chapter4_5">4.5 Summary</h2>
+<h2 id="chapter4_5">5.5 Summary</h2>
Wicket applies inheritance also to HTML markup making layout management much easier and less error-prone. Defining a master template page to use as base class for the other pages is a great way to build a consistent layout and use it across all the pages on the web site. During the chapter we have also introduced the <code>Panel</code> component, a very important Wicket class that is primarily designed to let us divide our pages in smaller and reusable UI components.
<div style="clear:both;margin-top:15px;"></div>
- <div class="toc-item prev-left"><a href="../guide/chapter3.html"><< <strong>3</strong><span>Wicket says “Hello world!”</span></a></div>
+ <div class="toc-item prev-left"><a href="../guide/chapter3.html"><< <strong>4</strong><span>Wicket says “Hello world!”</span></a></div>
- <div class="toc-item next-right"><a href="../guide/chapter5.html"><strong>5</strong><span>Keeping control over HTML</span> >></a></div>
+ <div class="toc-item next-right"><a href="../guide/chapter5.html"><strong>6</strong><span>Keeping control over HTML</span> >></a></div>
<div style="clear:both"></div>
</div>