Author: buildbot
Date: Mon Feb 10 15:41:53 2014
New Revision: 897175
Log:
Staging update by buildbot for deltaspike
Modified:
websites/staging/deltaspike/trunk/content/ (props changed)
websites/staging/deltaspike/trunk/content/jsf.html
Propchange: websites/staging/deltaspike/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Feb 10 15:41:53 2014
@@ -1 +1 @@
-1565939
+1566660
Modified: websites/staging/deltaspike/trunk/content/jsf.html
==============================================================================
--- websites/staging/deltaspike/trunk/content/jsf.html (original)
+++ websites/staging/deltaspike/trunk/content/jsf.html Mon Feb 10 15:41:53 2014
@@ -84,6 +84,8 @@
<li><a href="#intro">Intro</a></li>
<li><a href="#available-modes">Available modes</a><ul>
<li><a href="#clientwindow">CLIENTWINDOW</a><ul>
+<li><a href="#advantage">Advantage</a></li>
+<li><a href="#disadvantage">Disadvantage</a></li>
<li><a href="#change-windowhandlerhtml">Change windowhandler.html</a></li>
</ul>
</li>
@@ -170,13 +172,35 @@
<h2 id="available-modes">Available modes</h2>
<h3 id="clientwindow">CLIENTWINDOW</h3>
<p>Each GET request results in an intermediate small html page which checks if
the browser tab fits the requested windowId.</p>
-<p>TODO</p>
+<h4 id="advantage">Advantage</h4>
+<ul>
+<li>Covers all edge cases</li>
+</ul>
+<h4 id="disadvantage">Disadvantage</h4>
+<ul>
+<li>Every GET requests streams the the windowhandler.html first -> The
+ application probably feels a litte bit slower</li>
+</ul>
<h4 id="change-windowhandlerhtml">Change windowhandler.html</h4>
+<p>To customize the look & feel of the windowhandler.html, you can simply
provide a own via:</p>
+<div class="codehilite"><pre><span class="nd">@Specializes</span>
+<span class="kd">public</span> <span class="kd">class</span> <span
class="nc">MyClientWindowConfig</span> <span class="kd">extends</span> <span
class="n">DefaultClientWindowConfig</span>
+<span class="o">{</span>
+ <span class="nd">@Override</span>
+ <span class="kd">public</span> <span class="n">String</span> <span
class="nf">getClientWindowHtml</span><span class="o">()</span>
+ <span class="o">{</span>
+ <span class="k">return</span> <span
class="s">"<html><body>Loading...</body></html>"</span><span
class="o">;</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<p><br/></p>
<h3 id="lazy">LAZY</h3>
<p>Always appends the windowId to all, from JSF generated, URLs.<br/>
On the first GET request without a windowId, it will generate a new windowId
and redirect, with the windowId in the URL, to the same view again.<br/>
The current windowId will be stored in the <code>window.name</code> variable
on the client side. <br/>
-For all further requests, a lazy check will be performed to check if the
windowID in the URL is matching with the <code>window.name.</code>
+For all further requests, a lazy check will be performed to check if the
windowID in the URL is matching with the <code>window.name</code>.
If it's not matching, the view will be refreshed with the right windowId in
the URL.</p>
<h4 id="examples">Examples</h4>
<h5 id="first-get-request-with-windowid">First GET request with windowID</h5>
@@ -203,13 +227,18 @@ If it's not matching, the view will be r
<li>If it does not match, reload the URL with the right windowId taken from
<code>window.name</code></li>
</ul>
<p>TODO: Contra</p>
+<p><br/></p>
<h3 id="none">NONE</h3>
<p>Any window or browser tab detection will be disabled for the current
request.<br/>
-Scopes like @WindowScoped, @GroupedConversationScoped or @ViewAccessScoped
will not work.</p>
+Scopes like @WindowScoped, @GroupedConversationScoped or @ViewAccessScoped
will not work.
+This is also the default mode if the current request doesn't support
Javascript or if the user agent is a bot/crawler.</p>
+<p><br/></p>
<h3 id="delegated">DELEGATED</h3>
<p>Delegates the complete window handling to thew new JSF 2.2 ClientWindow (if
not disabled).</p>
+<p><br/></p>
<h3 id="custom">CUSTOM</h3>
<p>Enables to use an complete own
<code>org.apache.deltaspike.jsf.spi.scope.window.ClientWindow</code>
implementation.</p>
+<p><br/></p>
<h2 id="configuration">Configuration</h2>
<h3 id="dswindowid">ds:windowId</h3>
<p>The component <code>ds:windowId</code>
(<code>xmlns:ds="http://deltaspike.apache.org/jsf";</code>) is required to
enable the full control of the DeltaSpike window handling.<br/>
