deltaspike-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r897175 - in /websites/staging/deltaspike/trunk/content: ./ jsf.html
Date Mon, 10 Feb 2014 15:41:53 GMT
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 -&gt; The
+    application probably feels a litte bit slower</li>
+</ul>
 <h4 id="change-windowhandlerhtml">Change windowhandler.html</h4>
+<p>To customize the look &amp; 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">&quot;&lt;html&gt;&lt;body&gt;Loading...&lt;/body&gt;&lt;/html&gt;&quot;</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/>



Mime
View raw message