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/10/23 22:43:36 UTC
svn commit: r1535166 [5/5] - in /wicket/common/site/trunk/_site/guide/guide:
./ pages/
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter6_6.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter6_6.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter6_6.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter6_6.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -183,7 +183,17 @@ function addJsClass() {
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter7_1.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter7_1.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter7_1.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter7_1.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -184,7 +184,17 @@ Stateless pages are never versioned and
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter7_2.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter7_2.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter7_2.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter7_2.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -169,7 +169,7 @@ function addJsClass() {
getPage().replace(firstLabel);
}
});<p class="paragraph"/> }
-}</pre></div><p class="paragraph"/>Now if we run the new example (project LifeCycleStagesRevisited) and we click on the âReloadâ button, a new page version is created and the page id is increased by one:<p class="paragraph"/>!reload-page-png!<p class="paragraph"/>If we press the back button the page version previously rendered (and serialized) will be retrieved (i.e. deserialized) and it will be used again to respond to our request (and page id is decremented):<p class="paragraph"/><img border="0" class="center" src="../img/browser-back.png"></img><p class="paragraph"/><blockquote class="note">
+}</pre></div><p class="paragraph"/>Now if we run the new example (project LifeCycleStagesRevisited) and we click on the âReloadâ button, a new page version is created and the page id is increased by one:<p class="paragraph"/><img border="0" class="center" src="../img/reload-page.png"></img><p class="paragraph"/>If we press the back button the page version previously rendered (and serialized) will be retrieved (i.e. deserialized) and it will be used again to respond to our request (and page id is decremented):<p class="paragraph"/><img border="0" class="center" src="../img/browser-back.png"></img><p class="paragraph"/><blockquote class="note">
For more details about page storing you can visit the wiki page at https://cwiki.apache.org/confluence/display/WICKET/Page+Storage .
On this page you can find which classes are involved into page storing mechanism and how they work together.
</blockquote><p class="paragraph"/>As we have stated at the beginning of this chapter, page versions are stored using Java serialization, therefore every object referenced inside a page must be serializable1. In paragraph 9.6 we will see how to overcome this limit and work with non-serializable objects in our components using detachable Wicket models.<p class="paragraph"/><h3>Using a specific page version with PageReference</h3><p class="paragraph"/>To retrieve a specific page version in our code we can use class org.apache.wicket. PageReference by providing its constructor with the corresponding page id:<p class="paragraph"/><div class="code"><pre>//load page version with page id = 3
@@ -226,7 +226,17 @@ For the second level cache we can use th
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter7_3.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter7_3.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter7_3.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter7_3.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -205,7 +205,17 @@ Page '<page class>' is not state
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter7_4.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter7_4.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter7_4.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter7_4.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -182,7 +182,17 @@ function addJsClass() {
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter8_1.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter8_1.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter8_1.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter8_1.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -182,7 +182,17 @@ function addJsClass() {
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter8_2.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter8_2.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter8_2.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter8_2.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -182,7 +182,17 @@ function addJsClass() {
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter8_3.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter8_3.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter8_3.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter8_3.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -169,20 +169,20 @@ This paragraph will provide just the bas
getRequestCycle().setResponsePage(page);
}</pre></div><p class="paragraph"/><h3>RequestCycle's hook methods and listeners</h3><p class="paragraph"/>The RequestCycle comes with some hook methods which can be overridden to perform custom actions when request handling reaches a specific stage. These methods are:
<ul class="star">
-<li>onBeginRequest(): called when the RequestCycle is about to start handling the request.</li>
-<li>onEndRequest(): called when the RequestCycle has finished to handle the request</li>
-<li>onDetach(): called after the request handling has completed and the RequestCycle is about to be detached from its thread. The default implementation of this method invokes detach() on the current session (the Session class will be shortly discussed in paragraph 7.4).</li>
+<li><strong class="bold">onBeginRequest():</strong> called when the RequestCycle is about to start handling the request.</li>
+<li><strong class="bold">onEndRequest():</strong> called when the RequestCycle has finished to handle the request</li>
+<li><strong class="bold">onDetach():</strong> called after the request handling has completed and the RequestCycle is about to be detached from its thread. The default implementation of this method invokes detach() on the current session (the Session class will be shortly discussed in paragraph 7.4).</li>
</ul><p class="paragraph"/>Methods onBeforeRequest and onEndRequest can be used if we need to execute custom actions before and after business code is executed, such as opening a Hibernate/JPA session and closing it when code has terminated.<p class="paragraph"/>A more flexible way to interact with the request processing is to use the listener interface org.apache.wicket.request.cycle.IRequestCycleListener. In addition to the three methods already seen for RequestCycle, this interface offers further hooks into request processing:
<ul class="star">
-<li>onBeginRequest(RequestCycle cycle): (see the description above)</li>
-<li>onEndRequest(RequestCycle cycle): (see the description above)</li>
-<li>onDetach(RequestCycle cycle): (see the description above)</li>
-<li>onRequestHandlerResolved(RequestCycle cycle, IRequestHandler handler): called when an IRequestHandler has been resolved.</li>
-<li>onRequestHandlerScheduled(RequestCycle cycle, IRequestHandler handler): called when an IRequestHandler has been scheduled for execution.</li>
-<li>onRequestHandlerExecuted(RequestCycle cycle, IRequestHandler handler): called when an IRequestHandler has been executed.</li>
-<li>onException(RequestCycle cycle, Exception ex): called when an exception has been thrown during request processing.</li>
-<li>onExceptionRequestHandlerResolved(RequestCycle rc, IRequestHandler rh, Exception ex): called when an IRequestHandler has been resolved and will be used to handle an exception.</li>
-<li>onUrlMapped(RequestCycle cycle, IRequestHandler handler, Url url): called when an URL has been generated for an IRequestHandler object.</li>
+<li><strong class="bold">onBeginRequest(RequestCycle cycle):</strong> (see the description above)</li>
+<li><strong class="bold">onEndRequest(RequestCycle cycle):</strong> (see the description above)</li>
+<li><strong class="bold">onDetach(RequestCycle cycle):</strong> (see the description above)</li>
+<li><strong class="bold">onRequestHandlerResolved(RequestCycle cycle, IRequestHandler handler):</strong> called when an IRequestHandler has been resolved.</li>
+<li><strong class="bold">onRequestHandlerScheduled(RequestCycle cycle, IRequestHandler handler):</strong> called when an IRequestHandler has been scheduled for execution.</li>
+<li><strong class="bold">onRequestHandlerExecuted(RequestCycle cycle, IRequestHandler handler):</strong> called when an IRequestHandler has been executed.</li>
+<li><strong class="bold">onException(RequestCycle cycle, Exception ex):</strong> called when an exception has been thrown during request processing.</li>
+<li><strong class="bold">onExceptionRequestHandlerResolved(RequestCycle rc, IRequestHandler rh, Exception ex):</strong> called when an IRequestHandler has been resolved and will be used to handle an exception.</li>
+<li><strong class="bold">onUrlMapped(RequestCycle cycle, IRequestHandler handler, Url url):</strong> called when an URL has been generated for an IRequestHandler object.</li>
</ul><p class="paragraph"/>To use the request cycle listeners we must add them to our application which in turn will pass them to the new RequestCycle's instances created with createRequestCycle method:<p class="paragraph"/><div class="code"><pre>@Override
<span class="java-keyword">public</span> void init() {<p class="paragraph"/> <span class="java-keyword">super</span>.init();<p class="paragraph"/> IRequestCycleListener myListener;
//listener initialization…
@@ -215,7 +215,17 @@ This paragraph will provide just the bas
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter8_4.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter8_4.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter8_4.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter8_4.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -160,9 +160,9 @@ function addJsClass() {
//add a custom session listener
getSessionListeners().add(myListener)<p class="paragraph"/>}</pre></div><p class="paragraph"/><h3>Handling session attributes</h3><p class="paragraph"/>The Session class handles session attributes in much the same way as the standard interface javax.servlet.http.HttpSession. The following methods are provided to create, read and remove session attributes:
<ul class="star">
-<li>setAttribute(String name, Serializable value): creates an attribute identified by the given name. If the session already contains an attribute with the same name, the new value will replace the existing one. The value must be a serializable object.</li>
-<li>getAttribute(String name): returns the value of the attribute identified by the given name, or null if the name does not correspond to any attribute.</li>
-<li>removeAttribute(String name): removes the attribute identified by the given name.</li>
+<li><strong class="bold">setAttribute(String name, Serializable value):</strong> creates an attribute identified by the given name. If the session already contains an attribute with the same name, the new value will replace the existing one. The value must be a serializable object.</li>
+<li><strong class="bold">getAttribute(String name):</strong> returns the value of the attribute identified by the given name, or null if the name does not correspond to any attribute.</li>
+<li><strong class="bold">removeAttribute(String name):</strong> removes the attribute identified by the given name.</li>
</ul><p class="paragraph"/>By default class WebSession will use the underlying http session to store attributes. Wicket will automatically add a prefix to the name of the attributes. This prefix is returned by the WebApplication's method getSessionAttributePrefix().<p class="paragraph"/><h3>Accessing to the HTTP session</h3><p class="paragraph"/>If for any reason we need to directly access to the underlying HttpSession object, we can retrieve it from the current request with the following code:<p class="paragraph"/><div class="code"><pre>HttpSession session = ((ServletWebRequest)RequestCycle.get()
.getRequest()).getContainerRequest().getSession();</pre></div><p class="paragraph"/>Using the raw session object might be necessary if we have to set a session attribute with a particular name without the prefix added by Wicket. Let's say for example that we are working with Tomcat as web server. One of the administrative tools provided by Tomcat is a page listing all the active user sessions of a given web application:<p class="paragraph"/><img border="0" class="center" src="../img/tomcat-admin-sessions.png"></img><p class="paragraph"/>Tomcat allows us to set the values that will be displayed in columns âGuessed localeâ and âGuessed User nameâ. One possible way to do this is to use session attributes named âLocaleâ and âuserNameâ but we can't create them via Wicket's Session class because they would not have exactly the name required by Tomcat. Instead, we must use the raw HttpSession and set our attributes on it:<p class="paragraph"/><div
class="code"><pre>HttpSession session = ((ServletWebRequest)RequestCycle.get().
getRequest()).getContainerRequest().getSession();<p class="paragraph"/>session.setAttribute(<span class="java-quote">"Locale"</span>, <span class="java-quote">"ENGLISH"</span>);
@@ -180,10 +180,10 @@ session.setAttribute(<span class="java&#
Remember that invalidateNow() will immediately remove any instance of components (and pages) from the session, meaning that once we have called this method we won't be able to work with them for the rest of the request process.
</blockquote><p class="paragraph"/><h3>Storing arbitrary objects with metadata</h3><p class="paragraph"/>JavaServer Pages Specification1 defines 4 scopes in which a page can create and access a variable. These scopes are:
<ul class="star">
-<li>request: variables declared in this scope can be seen only by pages processing the same request. The lifespan of these variables is (at most) equal to the one of the related request. They are discarded when the full response has been generated or when the request is forwarded somewhere else.</li>
-<li>page: variables declared in this scope can be seen only by the page that has created them.</li>
-<li>session: variables in session scope can be created and accessed by every page used in the same session where they are defined.</li>
-<li>application: this is the widest scope. Variables declared in this scope can be used by any page of a given web application.</li>
+<li><strong class="bold">request:</strong> variables declared in this scope can be seen only by pages processing the same request. The lifespan of these variables is (at most) equal to the one of the related request. They are discarded when the full response has been generated or when the request is forwarded somewhere else.</li>
+<li><strong class="bold">page:</strong> variables declared in this scope can be seen only by the page that has created them.</li>
+<li><strong class="bold">session:</strong> variables in session scope can be created and accessed by every page used in the same session where they are defined.</li>
+<li><strong class="bold">application:</strong> this is the widest scope. Variables declared in this scope can be used by any page of a given web application.</li>
</ul><p class="paragraph"/>Although Wicket doesn't implement the JSP Specification (it is rather an alternative to it), it offers a feature called metadata which resembles scoped variables but is much more powerful. Metadata is quite similar to a Java Map in that it stores pairs of key-value objects where the key must be unique. In Wicket each of the following classes has its own metadata store: RequestCycle, Session, Application and Component.<p class="paragraph"/>The key used for metadata is an instance of class org.apache.wicket.MetaDataKey<T>. To put an arbitrary object into metadata we must use the setMetaData method which takes two parameters as input: the key used to store the value and the value itself. If we are using metadata with classes Session or Component, data object must be serializable because Wicket serializes both session and component instances. This constraint is not applied to metadata of classes Application and RequestCycle which can contain a generic
object. In any case, the type of data object must be compatible with the type parameter T specified by the key.<p class="paragraph"/>To retrieve a previously inserted object we must use the getMetaData(MetaDataKey<T> key) method. In the following example we set a java.sql.Connection object in the application's metadata so it can be used by any page of the application:<p class="paragraph"/>Application class code:
<div class="code"><pre><span class="java-keyword">public</span> <span class="java-keyword">static</span> MetaDataApp <span class="java-keyword">extends</span> WebApplication{
//Do some stuff…
@@ -228,7 +228,17 @@ Remember that invalidateNow() will immed
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter8_5.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter8_5.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter8_5.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter8_5.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -182,7 +182,17 @@ function addJsClass() {
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter9_1.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter9_1.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter9_1.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter9_1.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -208,7 +208,17 @@ pageParameters.get(1);</pre></div><p cla
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter9_2.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter9_2.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter9_2.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter9_2.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -182,7 +182,17 @@ function addJsClass() {
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter9_3.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter9_3.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter9_3.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter9_3.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -218,7 +218,17 @@ function addJsClass() {
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter9_4.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter9_4.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter9_4.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter9_4.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -189,7 +189,17 @@ add(<span class="java-keyword">new</
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter9_5.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter9_5.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter9_5.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter9_5.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -194,7 +194,17 @@ function addJsClass() {
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter9_6.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter9_6.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter9_6.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter9_6.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -223,7 +223,17 @@ setResponsePage(MountedPageWithPlacehold
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/pages/chapter9_7.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/pages/chapter9_7.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/pages/chapter9_7.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/pages/chapter9_7.html Wed Oct 23 20:43:32 2013
@@ -113,10 +113,10 @@ function addJsClass() {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -182,7 +182,17 @@ function addJsClass() {
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/single.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/single.html?rev=1535166&r1=1535165&r2=1535166&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/single.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/single.html Wed Oct 23 20:43:32 2013
@@ -86,10 +86,10 @@ function addJsClass(el) {
<div id="header">
<div class="images clearfix">
- <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
- <span id="sponsor"><a href="http://www.apache.org/" target="_blank"><img height="60px" src="http://www.apache.org/images/asf_logo.gif"/></a></span>
+ <span id="sponsor"><a href="http://www.comsysto.com/" target="_blank"><img height="60px" src="http://comsysto.github.io/wicket-userguide/img/comsysto-logo.png"/></a></span>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -1120,7 +1120,7 @@ Stateless pages are never versioned and
getPage().replace(firstLabel);
}
});<p class="paragraph"/> }
-}</pre></div><p class="paragraph"/>Now if we run the new example (project LifeCycleStagesRevisited) and we click on the âReloadâ button, a new page version is created and the page id is increased by one:<p class="paragraph"/>!reload-page-png!<p class="paragraph"/>If we press the back button the page version previously rendered (and serialized) will be retrieved (i.e. deserialized) and it will be used again to respond to our request (and page id is decremented):<p class="paragraph"/><img border="0" class="center" src="../img/browser-back.png"></img><p class="paragraph"/><blockquote class="note">
+}</pre></div><p class="paragraph"/>Now if we run the new example (project LifeCycleStagesRevisited) and we click on the âReloadâ button, a new page version is created and the page id is increased by one:<p class="paragraph"/><img border="0" class="center" src="../img/reload-page.png"></img><p class="paragraph"/>If we press the back button the page version previously rendered (and serialized) will be retrieved (i.e. deserialized) and it will be used again to respond to our request (and page id is decremented):<p class="paragraph"/><img border="0" class="center" src="../img/browser-back.png"></img><p class="paragraph"/><blockquote class="note">
For more details about page storing you can visit the wiki page at https://cwiki.apache.org/confluence/display/WICKET/Page+Storage .
On this page you can find which classes are involved into page storing mechanism and how they work together.
</blockquote><p class="paragraph"/>As we have stated at the beginning of this chapter, page versions are stored using Java serialization, therefore every object referenced inside a page must be serializable1. In paragraph 9.6 we will see how to overcome this limit and work with non-serializable objects in our components using detachable Wicket models.<p class="paragraph"/><h3>Using a specific page version with PageReference</h3><p class="paragraph"/>To retrieve a specific page version in our code we can use class org.apache.wicket. PageReference by providing its constructor with the corresponding page id:<p class="paragraph"/><div class="code"><pre>//load page version with page id = 3
@@ -1212,20 +1212,20 @@ This paragraph will provide just the bas
getRequestCycle().setResponsePage(page);
}</pre></div><p class="paragraph"/><h3>RequestCycle's hook methods and listeners</h3><p class="paragraph"/>The RequestCycle comes with some hook methods which can be overridden to perform custom actions when request handling reaches a specific stage. These methods are:
<ul class="star">
-<li>onBeginRequest(): called when the RequestCycle is about to start handling the request.</li>
-<li>onEndRequest(): called when the RequestCycle has finished to handle the request</li>
-<li>onDetach(): called after the request handling has completed and the RequestCycle is about to be detached from its thread. The default implementation of this method invokes detach() on the current session (the Session class will be shortly discussed in paragraph 7.4).</li>
+<li><strong class="bold">onBeginRequest():</strong> called when the RequestCycle is about to start handling the request.</li>
+<li><strong class="bold">onEndRequest():</strong> called when the RequestCycle has finished to handle the request</li>
+<li><strong class="bold">onDetach():</strong> called after the request handling has completed and the RequestCycle is about to be detached from its thread. The default implementation of this method invokes detach() on the current session (the Session class will be shortly discussed in paragraph 7.4).</li>
</ul><p class="paragraph"/>Methods onBeforeRequest and onEndRequest can be used if we need to execute custom actions before and after business code is executed, such as opening a Hibernate/JPA session and closing it when code has terminated.<p class="paragraph"/>A more flexible way to interact with the request processing is to use the listener interface org.apache.wicket.request.cycle.IRequestCycleListener. In addition to the three methods already seen for RequestCycle, this interface offers further hooks into request processing:
<ul class="star">
-<li>onBeginRequest(RequestCycle cycle): (see the description above)</li>
-<li>onEndRequest(RequestCycle cycle): (see the description above)</li>
-<li>onDetach(RequestCycle cycle): (see the description above)</li>
-<li>onRequestHandlerResolved(RequestCycle cycle, IRequestHandler handler): called when an IRequestHandler has been resolved.</li>
-<li>onRequestHandlerScheduled(RequestCycle cycle, IRequestHandler handler): called when an IRequestHandler has been scheduled for execution.</li>
-<li>onRequestHandlerExecuted(RequestCycle cycle, IRequestHandler handler): called when an IRequestHandler has been executed.</li>
-<li>onException(RequestCycle cycle, Exception ex): called when an exception has been thrown during request processing.</li>
-<li>onExceptionRequestHandlerResolved(RequestCycle rc, IRequestHandler rh, Exception ex): called when an IRequestHandler has been resolved and will be used to handle an exception.</li>
-<li>onUrlMapped(RequestCycle cycle, IRequestHandler handler, Url url): called when an URL has been generated for an IRequestHandler object.</li>
+<li><strong class="bold">onBeginRequest(RequestCycle cycle):</strong> (see the description above)</li>
+<li><strong class="bold">onEndRequest(RequestCycle cycle):</strong> (see the description above)</li>
+<li><strong class="bold">onDetach(RequestCycle cycle):</strong> (see the description above)</li>
+<li><strong class="bold">onRequestHandlerResolved(RequestCycle cycle, IRequestHandler handler):</strong> called when an IRequestHandler has been resolved.</li>
+<li><strong class="bold">onRequestHandlerScheduled(RequestCycle cycle, IRequestHandler handler):</strong> called when an IRequestHandler has been scheduled for execution.</li>
+<li><strong class="bold">onRequestHandlerExecuted(RequestCycle cycle, IRequestHandler handler):</strong> called when an IRequestHandler has been executed.</li>
+<li><strong class="bold">onException(RequestCycle cycle, Exception ex):</strong> called when an exception has been thrown during request processing.</li>
+<li><strong class="bold">onExceptionRequestHandlerResolved(RequestCycle rc, IRequestHandler rh, Exception ex):</strong> called when an IRequestHandler has been resolved and will be used to handle an exception.</li>
+<li><strong class="bold">onUrlMapped(RequestCycle cycle, IRequestHandler handler, Url url):</strong> called when an URL has been generated for an IRequestHandler object.</li>
</ul><p class="paragraph"/>To use the request cycle listeners we must add them to our application which in turn will pass them to the new RequestCycle's instances created with createRequestCycle method:<p class="paragraph"/><div class="code"><pre>@Override
<span class="java-keyword">public</span> void init() {<p class="paragraph"/> <span class="java-keyword">super</span>.init();<p class="paragraph"/> IRequestCycleListener myListener;
//listener initialization…
@@ -1240,9 +1240,9 @@ This paragraph will provide just the bas
//add a custom session listener
getSessionListeners().add(myListener)<p class="paragraph"/>}</pre></div><p class="paragraph"/><h3>Handling session attributes</h3><p class="paragraph"/>The Session class handles session attributes in much the same way as the standard interface javax.servlet.http.HttpSession. The following methods are provided to create, read and remove session attributes:
<ul class="star">
-<li>setAttribute(String name, Serializable value): creates an attribute identified by the given name. If the session already contains an attribute with the same name, the new value will replace the existing one. The value must be a serializable object.</li>
-<li>getAttribute(String name): returns the value of the attribute identified by the given name, or null if the name does not correspond to any attribute.</li>
-<li>removeAttribute(String name): removes the attribute identified by the given name.</li>
+<li><strong class="bold">setAttribute(String name, Serializable value):</strong> creates an attribute identified by the given name. If the session already contains an attribute with the same name, the new value will replace the existing one. The value must be a serializable object.</li>
+<li><strong class="bold">getAttribute(String name):</strong> returns the value of the attribute identified by the given name, or null if the name does not correspond to any attribute.</li>
+<li><strong class="bold">removeAttribute(String name):</strong> removes the attribute identified by the given name.</li>
</ul><p class="paragraph"/>By default class WebSession will use the underlying http session to store attributes. Wicket will automatically add a prefix to the name of the attributes. This prefix is returned by the WebApplication's method getSessionAttributePrefix().<p class="paragraph"/><h3>Accessing to the HTTP session</h3><p class="paragraph"/>If for any reason we need to directly access to the underlying HttpSession object, we can retrieve it from the current request with the following code:<p class="paragraph"/><div class="code"><pre>HttpSession session = ((ServletWebRequest)RequestCycle.get()
.getRequest()).getContainerRequest().getSession();</pre></div><p class="paragraph"/>Using the raw session object might be necessary if we have to set a session attribute with a particular name without the prefix added by Wicket. Let's say for example that we are working with Tomcat as web server. One of the administrative tools provided by Tomcat is a page listing all the active user sessions of a given web application:<p class="paragraph"/><img border="0" class="center" src="../img/tomcat-admin-sessions.png"></img><p class="paragraph"/>Tomcat allows us to set the values that will be displayed in columns âGuessed localeâ and âGuessed User nameâ. One possible way to do this is to use session attributes named âLocaleâ and âuserNameâ but we can't create them via Wicket's Session class because they would not have exactly the name required by Tomcat. Instead, we must use the raw HttpSession and set our attributes on it:<p class="paragraph"/><div
class="code"><pre>HttpSession session = ((ServletWebRequest)RequestCycle.get().
getRequest()).getContainerRequest().getSession();<p class="paragraph"/>session.setAttribute(<span class="java-quote">"Locale"</span>, <span class="java-quote">"ENGLISH"</span>);
@@ -1260,10 +1260,10 @@ session.setAttribute(<span class="java&#
Remember that invalidateNow() will immediately remove any instance of components (and pages) from the session, meaning that once we have called this method we won't be able to work with them for the rest of the request process.
</blockquote><p class="paragraph"/><h3>Storing arbitrary objects with metadata</h3><p class="paragraph"/>JavaServer Pages Specification1 defines 4 scopes in which a page can create and access a variable. These scopes are:
<ul class="star">
-<li>request: variables declared in this scope can be seen only by pages processing the same request. The lifespan of these variables is (at most) equal to the one of the related request. They are discarded when the full response has been generated or when the request is forwarded somewhere else.</li>
-<li>page: variables declared in this scope can be seen only by the page that has created them.</li>
-<li>session: variables in session scope can be created and accessed by every page used in the same session where they are defined.</li>
-<li>application: this is the widest scope. Variables declared in this scope can be used by any page of a given web application.</li>
+<li><strong class="bold">request:</strong> variables declared in this scope can be seen only by pages processing the same request. The lifespan of these variables is (at most) equal to the one of the related request. They are discarded when the full response has been generated or when the request is forwarded somewhere else.</li>
+<li><strong class="bold">page:</strong> variables declared in this scope can be seen only by the page that has created them.</li>
+<li><strong class="bold">session:</strong> variables in session scope can be created and accessed by every page used in the same session where they are defined.</li>
+<li><strong class="bold">application:</strong> this is the widest scope. Variables declared in this scope can be used by any page of a given web application.</li>
</ul><p class="paragraph"/>Although Wicket doesn't implement the JSP Specification (it is rather an alternative to it), it offers a feature called metadata which resembles scoped variables but is much more powerful. Metadata is quite similar to a Java Map in that it stores pairs of key-value objects where the key must be unique. In Wicket each of the following classes has its own metadata store: RequestCycle, Session, Application and Component.<p class="paragraph"/>The key used for metadata is an instance of class org.apache.wicket.MetaDataKey<T>. To put an arbitrary object into metadata we must use the setMetaData method which takes two parameters as input: the key used to store the value and the value itself. If we are using metadata with classes Session or Component, data object must be serializable because Wicket serializes both session and component instances. This constraint is not applied to metadata of classes Application and RequestCycle which can contain a generic
object. In any case, the type of data object must be compatible with the type parameter T specified by the key.<p class="paragraph"/>To retrieve a previously inserted object we must use the getMetaData(MetaDataKey<T> key) method. In the following example we set a java.sql.Connection object in the application's metadata so it can be used by any page of the application:<p class="paragraph"/>Application class code:
<div class="code"><pre><span class="java-keyword">public</span> <span class="java-keyword">static</span> MetaDataApp <span class="java-keyword">extends</span> WebApplication{
//Do some stuff…
@@ -2386,11 +2386,11 @@ add(form);</pre></div><p class="paragrap
anotherLabel.labelValue=Value <span class="java-keyword">for</span> anotherLabel
form.anotherLabel.labelValue=Value <span class="java-keyword">for</span> anotherLabel inside form</pre></div><p class="paragraph"/>With the code and the bundle above, the label inside the form will display the value 'Value for anotherLabel inside form'.<p class="paragraph"/><h3>Package bundles</h3><p class="paragraph"/>If no one of the previous steps can find a resource for the given key, the algorithm will look for package bundles. These bundles have package as base name and they can be placed in one of the package of our application:<p class="paragraph"/><img border="0" class="center" src="../img/package-bundles.png"></img><p class="paragraph"/>Packages are traversed starting from the one containing the component requesting for a resource and going up to the root package.<p class="paragraph"/><h3>Bundles for feedback messages</h3><p class="paragraph"/>The algorithm described so far applies to feedback messages as well. In case of validation errors, the component that has cause
d the error will be considered as the component which the string resource is relative to. Furthermore, just like application class and components, validators can have their own bundles placed next to their class and having as base name their class name. This allows us to distribute validators along with the messages they use to report errors:<p class="paragraph"/><img border="0" class="center" src="../img/validator-with-bundle.png"></img><p class="paragraph"/>Validator's resource bundles have the lowest priority in the lookup algorithm. They can be overwritten by resource bundles of components, packages and application class.<p class="paragraph"/><h3>Extending the default lookup algorithm</h3><p class="paragraph"/>Wicket implements the default lookup algorithm using the strategy pattern1. The concrete strategies are abstracted with the interface org.apache.wicket.resource.loader.IStringResource Loader. By default Wicket uses the following implementations of IStringResourceLoader (so
rted by execution order):
<ol>
-<li>ComponentStringResourceLoader: implements most of the default algorithm. It searches for a given resource across bundles from the container hierarchy, from class hierarchy and from the given component.</li>
-<li>PackageStringResourceLoader: searches into package bundles.</li>
-<li>ClassStringResourceLoader: searches into bundles of a given class. By default the target class is the application class.</li>
-<li>ValidatorStringResourceLoader: searches for resources into validator's bundles. A list of validators is provided by the form component that failed validation.</li>
-<li>InitializerStringResourceLoader: this resource allows internationalization to interact with the initialization mechanism of the framework that will be illustrated in paragraph 15.4.</li>
+<li><strong class="bold">ComponentStringResourceLoader:</strong> implements most of the default algorithm. It searches for a given resource across bundles from the container hierarchy, from class hierarchy and from the given component.</li>
+<li><strong class="bold">PackageStringResourceLoader:</strong> searches into package bundles.</li>
+<li><strong class="bold">ClassStringResourceLoader:</strong> searches into bundles of a given class. By default the target class is the application class.</li>
+<li><strong class="bold">ValidatorStringResourceLoader:</strong> searches for resources into validator's bundles. A list of validators is provided by the form component that failed validation.</li>
+<li><strong class="bold">InitializerStringResourceLoader:</strong> this resource allows internationalization to interact with the initialization mechanism of the framework that will be illustrated in paragraph 15.4.</li>
</ol><p class="paragraph"/>Developer can customize lookup algorithm removing default resource loaders or adding custom implementations to the list of the resource loaders in use. This task can be accomplished using method getStringResourceLoaders of setting interface org.apache.wicket.settings. IResourceSettings:<p class="paragraph"/><div class="code"><pre>@Override
<span class="java-keyword">public</span> void init()
{
@@ -4430,7 +4430,17 @@ and attach it to a ticket in Apache Wick
<div id="footer">
-Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
+Copyright © 2013 â <a href="http://www.comsysto.com" target="_blank">comSysto GmbH</a>
+<script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+
+ ga('create', 'UA-43124634-1', 'comsysto.com');
+ ga('send', 'pageview');
+
+</script>
</div>