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/21 21:42:31 UTC
svn commit: r1534344 [2/3] - /wicket/common/site/trunk/_site/guide/guide/
Modified: wicket/common/site/trunk/_site/guide/guide/chapter21.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter21.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter21.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter21.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -238,15 +238,24 @@ Since the development of many web applic
tester.assertComponent(<span class="java-quote">"login"</span>, LoginComponent.class);
}
}</pre></div><p class="paragraph"/>By defining three annotations on the class level (see code snippet above) in your test, Spring's TestContext framework takes care of preparing and initializing an ApplicationContext instance having all the beans defined in the according Spring context file as well as the transaction management in case your integration test includes some kind of database access. Fields marked with <code>@Autowired</code> annotation will be automatically dependency injected as well so that you can easily access and use these for your testing purposes. Since MyWebApplication, which extends Wicket's WebApplication type and represents the main class of our web application, is also a bean within the ApplicationContext managed by Spring, it will also be provided to us by the test framework itself and can be easily used in order to initialize a WicketTester instance later on during the execution of the test's setUp() method. With this kind of simple, annotation ba
sed test configuration we are able to run an integration test that verifies whether a LoginPage gets started and initialized, whether the rendering of the page runs smoothly and whether the page itself contains a LoginComponent that we possibly need in order to process user's login successfully.<p class="paragraph"/>When you run this test though, you'll unfortunately get the following exception raised:<p class="paragraph"/><div class="code"><pre>java.lang.IllegalStateException: No WebApplicationContext found: no ContextLoaderListener registered?
- at org.springframework.web.context.support.WebApplicationContextUtils.getRequiredWebApplicationContext(WebApplicationContextUtils.java:84)
- at org.apache.wicket.spring.injection.annot.SpringComponentInjector.<init>(SpringComponentInjector.java:72)
- at com.comsysto.serviceplatform.uiwebapp.MyWebApplication.initializeSpringComponentInjector(MyWebApplication.java:59)
- at com.comsysto.serviceplatform.uiwebapp.MyWebApplication.init(MyWebApplication.java:49)
- at org.apache.wicket.protocol.http.WicketFilter.init(WicketFilter.java:719)
- at org.apache.wicket.protocol.http.MockWebApplication.<init>(MockWebApplication.java:168)
- at org.apache.wicket.util.tester.BaseWicketTester.<init>(BaseWicketTester.java:219)
- at org.apache.wicket.util.tester.WicketTester.<init>(WicketTester.java:325)
- at org.apache.wicket.util.tester.WicketTester.<init>(WicketTester.java:308)</pre></div><p class="paragraph"/>As you can see above, the Exception gets raised during the initialization of the WicketTester instance even before the actual test method gets executed. Even though we have applied rather cool and simple annotation based test configuration already described and passed in perfectly well prepared ApplicationContext instance to the WicketTester instance in the constructor, somewhere down the rabbit hole someone complained that no WebApplicationContext instance could have been found which seems to be required in order to initialize the WicketTester properly.<p class="paragraph"/><img border="0" class="center" src="../img/description-of-illegalstate.jpg"></img><p class="paragraph"/>The problem that we run against here is due to the fact that SpringComponentInjector during its own initialization is trying to get hold of an according Spring's ApplicationContext instance tha
t would normally be there in a runtime environment but does not find any since we are running in a test environment currently. SpringComponentInjector delegates to Spring's own WebApplicationContextUtils class to retrieve the instance of ApplicationContext out of the ServletContext which is perfectly fine for a runtime environment but is unfortunately failing in a test environment:<p class="paragraph"/><div class="code"><pre><span class="java-keyword">public</span> <span class="java-keyword">static</span> WebApplicationContext getRequiredWebApplicationContext(ServletContext sc)
+ at org.springframework.web.context.support.WebApplicationContextUtils.
+ getRequiredWebApplicationContext(WebApplicationContextUtils.java:84)
+ at org.apache.wicket.spring.injection.annot.
+ SpringComponentInjector.<init>(SpringComponentInjector.java:72)
+ at com.comsysto.serviceplatform.uiwebapp.MyWebApplication.
+ initializeSpringComponentInjector(MyWebApplication.java:59)
+ at com.comsysto.serviceplatform.uiwebapp.MyWebApplication.
+ init(MyWebApplication.java:49)
+ at org.apache.wicket.protocol.http.WicketFilter.
+ init(WicketFilter.java:719)
+ at org.apache.wicket.protocol.http.MockWebApplication.
+ <init>(MockWebApplication.java:168)
+ at org.apache.wicket.util.tester.BaseWicketTester.
+ <init>(BaseWicketTester.java:219)
+ at org.apache.wicket.util.tester.WicketTester.
+ <init>(WicketTester.java:325)
+ at org.apache.wicket.util.tester.WicketTester.
+ <init>(WicketTester.java:308)</pre></div><p class="paragraph"/>As you can see above, the Exception gets raised during the initialization of the WicketTester instance even before the actual test method gets executed. Even though we have applied rather cool and simple annotation based test configuration already described and passed in perfectly well prepared ApplicationContext instance to the WicketTester instance in the constructor, somewhere down the rabbit hole someone complained that no WebApplicationContext instance could have been found which seems to be required in order to initialize the WicketTester properly.<p class="paragraph"/><img border="0" class="center" src="../img/description-of-illegalstate.jpg"></img><p class="paragraph"/>The problem that we run against here is due to the fact that SpringComponentInjector during its own initialization is trying to get hold of an according Spring's ApplicationContext instance that would normally be there in a runtime environ
ment but does not find any since we are running in a test environment currently. SpringComponentInjector delegates to Spring's own WebApplicationContextUtils class to retrieve the instance of ApplicationContext out of the ServletContext which is perfectly fine for a runtime environment but is unfortunately failing in a test environment:<p class="paragraph"/><div class="code"><pre><span class="java-keyword">public</span> <span class="java-keyword">static</span> WebApplicationContext getRequiredWebApplicationContext(ServletContext sc)
<span class="java-keyword">throws</span> IllegalStateException {<p class="paragraph"/> WebApplicationContext wac = getWebApplicationContext(sc);
<span class="java-keyword">if</span> (wac == <span class="java-keyword">null</span>) {
<span class="java-keyword">throw</span> <span class="java-keyword">new</span> IllegalStateException(<span class="java-quote">"No WebApplicationContext found: no ContextLoaderListener registered?"</span>);
@@ -275,6 +284,7 @@ Since the development of many web applic
}</pre></div><p class="paragraph"/>For additional clarification of how <code>MyWebApplication</code> now relates to both Wicket and Spring framework here is an according class diagram:<p class="paragraph"/><img border="0" class="center" src="../img/mywebapp-class-diagramm.jpg"></img>
+
<h2 id="chapter21_3">21.3 Summary</h2>
<p class="paragraph"/>With the configuration outlined above, no additional modifications are required to the test itself. It's going to turn green now. This way you can use exactly the same Spring context configuration that you'd use in your runtime environment for running your JUnit based integration tests as well.
@@ -304,17 +314,7 @@ Since the development of many web applic
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter22.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter22.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter22.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter22.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -522,17 +522,7 @@ add(settings);</pre></div><p class="para
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter23.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter23.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter23.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter23.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -284,17 +284,7 @@ QWickie is released under ASF 2.0 licens
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter24.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter24.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter24.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter24.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -188,27 +188,32 @@ Every WicketStuff module can be download
<h2 id="chapter24_2">24.2 Module tinymce</h2>
<p class="paragraph"/>Module tinymce offers integration with the namesake JavaScript library that turns our âhumbleâ text-areas into a full-featured HTML WYSIWYG editor:<p class="paragraph"/><img border="0" class="center" src="../img/tinymce.png"></img><p class="paragraph"/>To âtinyfyâ a textarea component we must use behavior TinyMceBehavior:<p class="paragraph"/><div class="code"><pre>TextArea textArea = <span class="java-keyword">new</span> TextArea(<span class="java-quote">"textArea"</span>, <span class="java-keyword">new</span> Model(<span class="java-quote">""</span>));
-textArea.add(<span class="java-keyword">new</span> TinyMceBehavior());</pre></div><p class="paragraph"/>By default TinyMceBehavior adds only a basic set of functionalities to our textarea:<p class="paragraph"/><img border="0" class="center" src="../img/tinymce_basic.png"></img><p class="paragraph"/>To add more functionalities we must use class TinyMCESettings to register additional TinyMCE plugins and to customize the toolbars buttons. The following code is an excerpt from example page FullFeaturedTinyMCEPage:<p class="paragraph"/><div class="code"><pre>TinyMCESettings settings = <span class="java-keyword">new</span> TinyMCESettings(TinyMCESettings.Theme.advanced);
+textArea.add(<span class="java-keyword">new</span> TinyMceBehavior());</pre></div><p class="paragraph"/>By default TinyMceBehavior adds only a basic set of functionalities to our textarea:<p class="paragraph"/><img border="0" class="center" src="../img/tinymce_basic.png"></img><p class="paragraph"/>To add more functionalities we must use class TinyMCESettings to register additional TinyMCE plugins and to customize the toolbars buttons. The following code is an excerpt from example page FullFeaturedTinyMCEPage:<p class="paragraph"/><div class="code"><pre>TinyMCESettings settings = <span class="java-keyword">new</span> TinyMCESettings(
+ TinyMCESettings.Theme.advanced);
//…
// first toolbar
//…
settings.add(Button.newdocument, TinyMCESettings.Toolbar.first,
- TinyMCESettings.Position.before);
+ TinyMCESettings.Position.before);
settings.add(Button.separator, TinyMCESettings.Toolbar.first,
- TinyMCESettings.Position.before);
+ TinyMCESettings.Position.before);
settings.add(Button.fontselect, TinyMCESettings.Toolbar.first,
- TinyMCESettings.Position.after);
+ TinyMCESettings.Position.after);
//…
// other settings
-settings.setToolbarAlign(TinyMCESettings.Align.left);
-settings.setToolbarLocation(TinyMCESettings.Location.top);
-settings.setStatusbarLocation(TinyMCESettings.Location.bottom);
+settings.setToolbarAlign(
+ TinyMCESettings.Align.left);
+settings.setToolbarLocation(
+ TinyMCESettings.Location.top);
+settings.setStatusbarLocation(
+ TinyMCESettings.Location.bottom);
settings.setResizing(<span class="java-keyword">true</span>);
//…
TextArea textArea = <span class="java-keyword">new</span> TextArea(<span class="java-quote">"ta"</span>, <span class="java-keyword">new</span> Model(TEXT));
textArea.add(<span class="java-keyword">new</span> TinyMceBehavior(settings));</pre></div><p class="paragraph"/>For more configuration examples see pages inside package wicket.contrib.examples.tinymce in the example project of the module.
+
<h2 id="chapter24_3">24.3 Module wicketstuff-gmap3</h2>
<p class="paragraph"/>Module wicketstuff-gmap3 integrates <a href="http://maps.google.com" target="blank">Google Maps</a> service with Wicket providing component org.wicketstuff.gmap.GMap. If we want to embed Google Maps into one of our pages we just need to add component GMap inside the page. The following snippet is taken from example page SimplePage:<p class="paragraph"/><strong class="bold">HTML:</strong><p class="paragraph"/><div class="code"><pre>…
<body>
@@ -278,17 +283,7 @@ add(grid);</pre></div><p class="paragrap
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
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=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter25.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter25.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -217,17 +217,7 @@ Quite a few teams have already got stuck
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</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=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter26.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter26.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -155,7 +155,7 @@ function addJsClass() {
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>
-<li>Checkout Apache Wicket's <a href="https://svn.apache.org/repos/asf/wicket/common/site/trunk/_site/" target="blank">site</a></li>
+<li>Checkout Apache Wicket's <a href="../ref/Httpssvnapacheorgreposasfwicketcommonsitetrunksite/site.html" class="https://svn.apache.org/repos/asf/wicket/common/site/trunk/_site/">site</a></li>
</ul><p class="paragraph"/><div class="code"><pre>svn checkout https://svn.apache.org/repos/asf/wicket/common/site/trunk/_site/</pre></div>
<ul class="star">
<li>Edit the <em class="italic">.gdoc</em> files in <em class="italic">_site/guide/guide/src/docs/guide</em> folder</li>
@@ -173,7 +173,7 @@ You can contribute to this guide by foll
<li>To preview your changes open <em class="italic">_site/guide/index.html</em> in a browser</li>
<li>Create a patch with</li>
</ul><p class="paragraph"/><div class="code"><pre>svn diff > my.patch</pre></div>
-and attach it to a ticket in Apache Wicket's <a href="https://issues.apache.org/jira/browse/WICKET" target="blank">JIRA</a><p class="paragraph"/><strong class="bold">Thank you!</strong>
+and attach it to a ticket in Apache Wicket's <a href="../ref/Httpsissuesapacheorgjirabrowse WICKET/JIRA.html" class="https://issues.apache.org/jira/browse/WICKET">JIRA</a><p class="paragraph"/><strong class="bold">Thank you!</strong>
<div style="clear:both;margin-top:15px;"></div>
@@ -199,17 +199,7 @@ and attach it to a ticket in Apache Wick
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</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=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter3.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter3.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -314,17 +314,7 @@ In the last paragraph we had a first tas
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</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=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter4.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter4.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -162,7 +162,7 @@ function addJsClass() {
<div class="toc-item" style="margin-left:0px"><a href="#chapter4_3"><strong>4.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>4.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>
@@ -307,7 +307,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">4.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>
@@ -402,17 +402,7 @@ Wicket applies inheritance also to HTML
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter5.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter5.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter5.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter5.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -177,7 +177,7 @@ function addJsClass() {
<div class="toc-item" style="margin-left:0px"><a href="#chapter5_8"><strong>5.8</strong><span>How to render component body only</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter5_9"><strong>5.9</strong><span>Hiding decorating elements with the <wicket:enclosure> tag</span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter5_9"><strong>5.9</strong><span>Hiding decorating elements with the wicket:enclosure tag</span></a>
</div>
<div class="toc-item" style="margin-left:0px"><a href="#chapter5_10"><strong>5.10</strong><span>Surrounding existing markup with Border</span></a>
@@ -304,7 +304,7 @@ add(label);</pre></div><p class="paragra
</html></pre></div><p class="paragraph"/>As you can see the <code><div></code> tag used for component <code>Label</code> is not present in the final markup.
-<h2 id="chapter5_9">5.9 Hiding decorating elements with the <wicket:enclosure> tag</h2>
+<h2 id="chapter5_9">5.9 Hiding decorating elements with the wicket:enclosure tag</h2>
Our data are rarely displayed alone without a caption or other graphic elements that make clear the meaning of their value. For example:<p class="paragraph"/><div class="code"><pre><label>Total amount: </label><span wicket:id=<span class="java-quote">"totalAmount"</span>></span></pre></div><p class="paragraph"/>Wicket comes with a nice utility tag called <code><wicket:enclosure></code> that automatically hides those decorating elements if the related data value is not visible. All we have to do is to put the involved markup inside this tag. Applying <code><wicket:enclosure></code> to the previous example we get the following markup:<p class="paragraph"/><div class="code"><pre><wicket:enclosure>
<label>Total amount: </label><span wicket:id=<span class="java-quote">"totalAmount"</span>></span>
</wicket:enclosure></pre></div><p class="paragraph"/>Now if component <code>totalAmount</code> is not visible, its description (<code>Total amount:</code>) will be automatically hidden. If we have more then a Wicket component inside <code><wicket:enclosure></code> we can use <code>child</code> attribute to specify which component will control the overall visibility:<p class="paragraph"/><div class="code"><pre><wicket:enclosure child=<span class="java-quote">"totalAmount"</span>>
@@ -389,17 +389,7 @@ To perform this task Wicket provides a s
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter6.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter6.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter6.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter6.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -293,17 +293,7 @@ If we forget to call superclass version
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter7.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter7.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter7.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter7.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -222,10 +222,12 @@ For the second level cache we can use th
<span class="java-keyword">public</span> void init()
{
<span class="java-keyword">super</span>.init();
- getApplicationSettings().setPageExpiredErrorPage(CustomExpiredErrorPage.class);
+ getApplicationSettings().setPageExpiredErrorPage(
+ CustomExpiredErrorPage.class);
}</pre></div><p class="paragraph"/>The page class provided as custom error page must have a public constructor with no argument or a constructor that takes as input a single PageParameters argument (the page must be bookmarkable as described in paragraph 8.1.1).
+
<h2 id="chapter7_3">7.3 Stateless pages</h2>
<p class="paragraph"/>Wicket makes it very easy to build stateful pages, but sometimes we might want to use an âold schoolâ stateless page that doesn't keep memory of its state in the user session. For example consider the public area of a site or a login page: in those cases a stateful page would be a waste of resources or even a security threat, as we will see in paragraph 10.9.<p class="paragraph"/>In Wicket a page can be stateless only if it satisfies the following requirements:
<ol>
@@ -282,17 +284,7 @@ Page '<page class>' is not state
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter8.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter8.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter8.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter8.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -233,7 +233,9 @@ This paragraph will provide just the bas
<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>
-</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 sessio
ns 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>);
+</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>);
session.setAttribute(<span class="java-quote">"userName"</span>, <span class="java-quote">"Mr BadGuy"</span>);</pre></div><p class="paragraph"/><h3>Temporary and permanent sessions</h3><p class="paragraph"/>Wicket doesn't need to store data into user session as long as the user visits only stateless pages. Nonetheless, even under these conditions, a temporary session object is created to process each request but it is discarded at the end of the current request. To know if the current session is temporary, we can use the isTemporary() method:<p class="paragraph"/><div class="code"><pre>Session.get().isTemporary();</pre></div><p class="paragraph"/>If a session is not temporary (i.e. it is permanent), it's identified by an unique id which can be read calling the getId() method. This value will be null if the session is temporary.<p class="paragraph"/>Although Wicket is able to automatically recognize when it needs to replace a temporary session with a permanent one, sometimes
we may need to manually control this process to make our initially temporary session permanent.<p class="paragraph"/>To illustrate this possible scenario let's consider project BindSessionExample where we have a stateless home page which sets a session attribute inside its constructor and then it redirects the user to another page which displays with a label the session attribute previously created. The code of the two pages is as follows:<p class="paragraph"/>Home page:
<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(<span class="java-keyword">final</span> PageParameters parameters) {
@@ -270,6 +272,7 @@ Remember that invalidateNow() will immed
}</pre></div><p class="paragraph"/>Code to get the object from the metadata:<p class="paragraph"/><div class="code"><pre>Connection connection = Application.get().getMetaData(MetaDataApp.connectionKey);</pre></div><p class="paragraph"/>Since MetaDataKey<T> class is declared as abstract, we must implement it with a subclass or with an anonymous class (like we did in the example above).
+
<h2 id="chapter8_5">8.5 Summary</h2>
<p class="paragraph"/>In this chapter we had a look at how Wicket internally handles a web request. Even if most of the time we won't need to customize this internal process, knowing how it works is essential to use the framework at 100%.<p class="paragraph"/>Entities like Application and Session will come in handy again when we will tackle the topic of security in chapter 18.
@@ -299,17 +302,7 @@ Remember that invalidateNow() will immed
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/chapter9.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/chapter9.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/chapter9.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/chapter9.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -159,7 +159,7 @@ function addJsClass() {
<div class="toc-item" style="margin-left:0px"><a href="#chapter9_2"><strong>9.2</strong><span>Bookmarkable links</span></a>
</div>
- <div class="toc-item" style="margin-left:0px"><a href="#chapter9_3"><strong>9.3</strong><span>Automatically creating bookmarkable links with tag <wicket:link></span></a>
+ <div class="toc-item" style="margin-left:0px"><a href="#chapter9_3"><strong>9.3</strong><span>Automatically creating bookmarkable links with tag wicket:link</span></a>
</div>
<div class="toc-item" style="margin-left:0px"><a href="#chapter9_4"><strong>9.4</strong><span>External links</span></a>
@@ -199,7 +199,8 @@ pageParameters.get(<span class="java-
<span class="java-keyword">public</span> PageWithParameters(PageParameters parameters) {
<span class="java-keyword">super</span>(parameters);
}
- }</pre></div><p class="paragraph"/>The code is quite straightforward and itâs more interesting to look at the URL generated for the target page:<p class="paragraph"/><div class="code"><pre><app root>/PageParametersExample/wicket/bookmarkable/org.wicketTutorial.PageWithParameters?foo=foo&bar=bar</pre></div><p class="paragraph"/>At first glance the URL above could seem a little weird, except for the last part which contains the two named parameters used to build the target page.<p class="paragraph"/>The reason for this âstrangeâ URL is that, as we explained in paragraph 6.2.5, when a page is instantiated using a constructor with no argument or using a constructor that accepts only a PageParameters, Wicket will try to generate a static URL for it, with no session-relative informations. This kind of URL is called bookmarkable because it can be saved by the users as a bookmark and accessed at a later time.<p class="paragraph"/>A bookmarkable URL is compos
ed by a fixed prefix (which by default is bookmarkable) and the qualified name of the page class (org.wicketTutorial.PageWithParameters in our example). Segment wicket is another fixed prefix added by default during URL generation. In paragraph 8.6.4 we will see how to customize fixed prefixes with a custom implementation of IMapperContext interface.<p class="paragraph"/><h3>Indexed parameters</h3><p class="paragraph"/>Besides named parameters, Wicket also supports indexed parameters. These kinds of parameters are rendered as URL segments placed before named parameters. Let's consider for example the following URL:<p class="paragraph"/><div class="code"><pre><application path>/foo/bar?1&baz=baz</pre></div><p class="paragraph"/>The URL above contains two indexed parameters (foo and bar) and a query string consisting of the page id and a named parameter (baz). Just like named parameters also indexed parameters are handled by the PageParameters class. The methods provided b
y PageParameters for indexed parameters are set(int index, Object object) (to add/modify a parameter), remove(int index)(to remove a parameter) and get(int index) (to read a parameter).<p class="paragraph"/>As their name suggests, indexed parameters are identified by a numeric index and they are rendered following the order in which they have been added to the PageParameters. The following is an example of indexed parameters:<p class="paragraph"/><div class="code"><pre>PageParameters pageParameters = <span class="java-keyword">new</span> PageParameters();
+ }</pre></div><p class="paragraph"/>The code is quite straightforward and itâs more interesting to look at the URL generated for the target page:<p class="paragraph"/><div class="code"><pre><app root>/PageParametersExample/wicket/bookmarkable/
+ org.wicketTutorial.PageWithParameters?foo=foo&bar=bar</pre></div><p class="paragraph"/>At first glance the URL above could seem a little weird, except for the last part which contains the two named parameters used to build the target page.<p class="paragraph"/>The reason for this âstrangeâ URL is that, as we explained in paragraph 6.2.5, when a page is instantiated using a constructor with no argument or using a constructor that accepts only a PageParameters, Wicket will try to generate a static URL for it, with no session-relative informations. This kind of URL is called bookmarkable because it can be saved by the users as a bookmark and accessed at a later time.<p class="paragraph"/>A bookmarkable URL is composed by a fixed prefix (which by default is bookmarkable) and the qualified name of the page class (org.wicketTutorial.PageWithParameters in our example). Segment wicket is another fixed prefix added by default during URL generation. In paragraph 8.6.4 we will
see how to customize fixed prefixes with a custom implementation of IMapperContext interface.<p class="paragraph"/><h3>Indexed parameters</h3><p class="paragraph"/>Besides named parameters, Wicket also supports indexed parameters. These kinds of parameters are rendered as URL segments placed before named parameters. Let's consider for example the following URL:<p class="paragraph"/><div class="code"><pre><application path>/foo/bar?1&baz=baz</pre></div><p class="paragraph"/>The URL above contains two indexed parameters (foo and bar) and a query string consisting of the page id and a named parameter (baz). Just like named parameters also indexed parameters are handled by the PageParameters class. The methods provided by PageParameters for indexed parameters are set(int index, Object object) (to add/modify a parameter), remove(int index)(to remove a parameter) and get(int index) (to read a parameter).<p class="paragraph"/>As their name suggests, indexed parameters are ident
ified by a numeric index and they are rendered following the order in which they have been added to the PageParameters. The following is an example of indexed parameters:<p class="paragraph"/><div class="code"><pre>PageParameters pageParameters = <span class="java-keyword">new</span> PageParameters();
//add a couple of parameters
pageParameters.set(0, <span class="java-quote">"foo"</span>);
pageParameters.set(1, <span class="java-quote">"bar"</span>);
@@ -212,11 +213,12 @@ pageParameters.get(1);</pre></div><p cla
}<p class="paragraph"/>});</pre></div><p class="paragraph"/>The URL generated for the linked page (PageWithParameters) is the one seen at the beginning of the paragraph.
+
<h2 id="chapter9_2">9.2 Bookmarkable links</h2>
<p class="paragraph"/>A link to a bookmarkable page can be built with the link component org.apache.wicket.markup.html.link.BookmarkablePageLink:<p class="paragraph"/><div class="code"><pre>BookmarkablePageLink bpl=<span class="java-keyword">new</span> BookmarkablePageLink(PageWithParameters.class, pageParameters);</pre></div><p class="paragraph"/>The specific purpose of this component is to provide an anchor to a bookmarkable page, hence we don't have to implement any abstract method like we do with Link component.
-<h2 id="chapter9_3">9.3 Automatically creating bookmarkable links with tag <wicket:link></h2>
+<h2 id="chapter9_3">9.3 Automatically creating bookmarkable links with tag wicket:link</h2>
<p class="paragraph"/>Bookmarkable pages can be linked directly inside markup files without writing any Java code. Using <wicket:link> tag we ask Wicket to automatically add bookmarkable links for the anchors wrapped inside it. Here is an example of usage of <wicket:link> tag taken from the home page of the project BookmarkablePageAutoLink:<p class="paragraph"/><div class="code"><pre><!DOCTYPE html>
<html xmlns:wicket=<span class="java-quote">"http://wicket.apache.org"</span>>
<head>
@@ -231,7 +233,7 @@ pageParameters.get(1);</pre></div><p cla
</wicket:link>
</div>
</body>
-</html></pre></div><p class="paragraph"/>The key part of the markup above is the href attribute which must contain the package-relative path to a page. The home page is inside package org.wicketTutorial which in turns contains the sub package anotherPackage. This package hierarchy is reflected by the href attributes: in the first anchor we have a link to the home page itself while the second anchor points to page SubPackagePage which is placed into sub package anotherPackage. Absolute paths are supported as well and we can use them if we want to specify the full package of a given page. For example the link to SubPackagePage could have been written in the following (more verbose) way:<p class="paragraph"/><div class="code"><pre><a href=<span class="java-quote">"/org/wicketTutorial/anotherPackage/SubPackagePage.html"</span>>SubPackagePage</a></pre></div><p class="paragraph"/>If we take a look also at the markup of SubPackagePage we can see that it contains
a link to the home page which uses the parent directory selector (relative path):<p class="paragraph"/><div class="code"><pre><!DOCTYPE html>
+</html></pre></div><p class="paragraph"/>The key part of the markup above is the href attribute which must contain the package-relative path to a page. The home page is inside package org.wicketTutorial which in turns contains the sub package anotherPackage. This package hierarchy is reflected by the href attributes: in the first anchor we have a link to the home page itself while the second anchor points to page SubPackagePage which is placed into sub package anotherPackage. Absolute paths are supported as well and we can use them if we want to specify the full package of a given page. For example the link to SubPackagePage could have been written in the following (more verbose) way:<p class="paragraph"/><div class="code"><pre><a href=<span class="java-quote">"/org/wicketTutorial/anotherPackage/SubPackagePage.html"</span>> SubPackagePage</a></pre></div><p class="paragraph"/>If we take a look also at the markup of SubPackagePage we can see that it contain
s a link to the home page which uses the parent directory selector (relative path):<p class="paragraph"/><div class="code"><pre><!DOCTYPE html>
<html xmlns:wicket=<span class="java-quote">"http://wicket.apache.org"</span>>
<head>
<meta charset=<span class="java-quote">"utf-8"</span> />
@@ -255,6 +257,7 @@ pageParameters.get(1);</pre></div><p cla
}</pre></div><p class="paragraph"/>The purpose of <wicket:link> tag is not limited to just simplifying the usage of bookmarkable pages. As we we will see in chapter 13, this tag can also be adopted to manage web resources like pictures, CSS files, JavaScript files and so on.
+
<h2 id="chapter9_4">9.4 External links</h2>
<p class="paragraph"/>Since Wicket uses plain HTML markup files as templates, we can place an anchor to an external page directly inside the markup file. When we need to dynamically generate external anchors, we can use link component org.apache.wicket.markup.html.link.ExternalLink. In order to build an external link we must specify the value of the href attribute using a model or a plain string. In the next snippet, given an instance of Person, we generate a Google search query for its full name:<p class="paragraph"/>Html:<p class="paragraph"/><div class="code"><pre><a wicket:id=<span class="java-quote">"externalSite"</span>>Search me on Google!</a></pre></div><p class="paragraph"/>Java code:<p class="paragraph"/><div class="code"><pre>Person person = <span class="java-keyword">new</span> Person(<span class="java-quote">"John"</span>, <span class="java-quote">"Smith"</span>);
<span class="java-object">String</span> fullName = person.getFullName();
@@ -356,17 +359,7 @@ setResponsePage(MountedPageWithPlacehold
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>
Modified: wicket/common/site/trunk/_site/guide/guide/index.html
URL: http://svn.apache.org/viewvc/wicket/common/site/trunk/_site/guide/guide/index.html?rev=1534344&r1=1534343&r2=1534344&view=diff
==============================================================================
--- wicket/common/site/trunk/_site/guide/guide/index.html (original)
+++ wicket/common/site/trunk/_site/guide/guide/index.html Mon Oct 21 19:42:30 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://comsysto.github.io/wicket-userguide/img/apache-wicket.png"/></a></span>
+ <span id="logo"><a href="/" target="_blank"><img height="80px" src="http://wicket.apache.org/guide/img/apache-wicket.png"/></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>
+ <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>
</div>
<p>Free Online Guide for Apache Wicket framework</p>
@@ -146,7 +146,7 @@ function addJsClass(el) {
<div class="toc-item" style="margin-left:10px"><a href="../guide/chapter4.html#chapter4_3"><strong>4.3</strong><span>Divide et impera!</span></a></div>
- <div class="toc-item" style="margin-left:10px"><a href="../guide/chapter4.html#chapter4_4"><strong>4.4</strong><span>Markup inheritance with the <wicket:extend> tag</span></a></div>
+ <div class="toc-item" style="margin-left:10px"><a href="../guide/chapter4.html#chapter4_4"><strong>4.4</strong><span>Markup inheritance with the wicket:extend tag</span></a></div>
<div class="toc-item" style="margin-left:10px"><a href="../guide/chapter4.html#chapter4_5"><strong>4.5</strong><span>Summary</span></a></div>
@@ -168,7 +168,7 @@ function addJsClass(el) {
<div class="toc-item" style="margin-left:10px"><a href="../guide/chapter5.html#chapter5_8"><strong>5.8</strong><span>How to render component body only</span></a></div>
- <div class="toc-item" style="margin-left:10px"><a href="../guide/chapter5.html#chapter5_9"><strong>5.9</strong><span>Hiding decorating elements with the <wicket:enclosure> tag</span></a></div>
+ <div class="toc-item" style="margin-left:10px"><a href="../guide/chapter5.html#chapter5_9"><strong>5.9</strong><span>Hiding decorating elements with the wicket:enclosure tag</span></a></div>
<div class="toc-item" style="margin-left:10px"><a href="../guide/chapter5.html#chapter5_10"><strong>5.10</strong><span>Surrounding existing markup with Border</span></a></div>
@@ -216,7 +216,7 @@ function addJsClass(el) {
<div class="toc-item" style="margin-left:10px"><a href="../guide/chapter9.html#chapter9_2"><strong>9.2</strong><span>Bookmarkable links</span></a></div>
- <div class="toc-item" style="margin-left:10px"><a href="../guide/chapter9.html#chapter9_3"><strong>9.3</strong><span>Automatically creating bookmarkable links with tag <wicket:link></span></a></div>
+ <div class="toc-item" style="margin-left:10px"><a href="../guide/chapter9.html#chapter9_3"><strong>9.3</strong><span>Automatically creating bookmarkable links with tag wicket:link</span></a></div>
<div class="toc-item" style="margin-left:10px"><a href="../guide/chapter9.html#chapter9_4"><strong>9.4</strong><span>External links</span></a></div>
@@ -478,17 +478,7 @@ function addJsClass(el) {
<div id="footer">
-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>
+Copyright © 2013 â <a href="http://www.apache.org/" target="_blank">The Apache Software Foundation</a>
</div>