Author: tandraschko
Date: Mon Feb 10 15:40:27 2014
New Revision: 1566660
URL: http://svn.apache.org/r1566660
Log:
Further work on window handling...
Modified:
deltaspike/site/trunk/content/jsf.mdtext
Modified: deltaspike/site/trunk/content/jsf.mdtext
URL:
http://svn.apache.org/viewvc/deltaspike/site/trunk/content/jsf.mdtext?rev=1566660&r1=1566659&r2=1566660&view=diff
==============================================================================
--- deltaspike/site/trunk/content/jsf.mdtext (original)
+++ deltaspike/site/trunk/content/jsf.mdtext Mon Feb 10 15:40:27 2014
@@ -29,16 +29,37 @@ Notice: Licensed to the Apache Softwa
Each GET request results in an intermediate small html page which checks if
the browser tab fits the requested windowId.
-TODO
+#### Advantage
+
+ - Covers all edge cases
+
+#### Disadvantage
+
+ - Every GET requests streams the the windowhandler.html first -> The
+ application probably feels a litte bit slower
#### Change windowhandler.html
+To customize the look & feel of the windowhandler.html, you can simply provide
a own via:
+
+ :::java
+ @Specializes
+ public class MyClientWindowConfig extends DefaultClientWindowConfig
+ {
+ @Override
+ public String getClientWindowHtml()
+ {
+ return "<html><body>Loading...</body></html>";
+ }
+ }
+
+<br/>
### LAZY
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 `window.name` 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 `window.name.`
+For all further requests, a lazy check will be performed to check if the
windowID in the URL is matching with the `window.name`.
If it's not matching, the view will be refreshed with the right windowId in
the URL.
#### Examples
@@ -64,19 +85,24 @@ If it's not matching, the view will be r
TODO: Contra
+<br/>
### NONE
Any window or browser tab detection will be disabled for the current
request.<br/>
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.
+<br/>
### DELEGATED
Delegates the complete window handling to thew new JSF 2.2 ClientWindow (if
not disabled).
+<br/>
### CUSTOM
Enables to use an complete own
`org.apache.deltaspike.jsf.spi.scope.window.ClientWindow` implementation.
+<br/>
## Configuration
### ds:windowId
