10:54 a.m.
Author: artdaw
Date: 2008-12-23 11:54:44 -0500 (Tue, 23 Dec 2008)
New Revision: 11997
Added:
trunk/docs/migrationguide/en/src/main/docbook/included/dataTableAjax.xml
Modified:
trunk/docs/common-resources/en/src/main/css/html-common.css
trunk/docs/migrationguide/en/src/main/docbook/master.xml
Log:
RF-3048 - Migration issues were added
Modified: trunk/docs/common-resources/en/src/main/css/html-common.css
===================================================================
--- trunk/docs/common-resources/en/src/main/css/html-common.css 2008-12-23 16:08:35 UTC
(rev 11996)
+++ trunk/docs/common-resources/en/src/main/css/html-common.css 2008-12-23 16:54:44 UTC
(rev 11997)
@@ -22,11 +22,6 @@
color: #334D69;
}
-
-div.chapter, div.section {
- padding-top:3em;
-}
-
div.book, div.chapter, div.section{
width:1000px;
margin:0 auto;
@@ -38,6 +33,10 @@
font-size:10px;
}
+.docnav{
+ padding:1em 0 3em;
+}
+
.docnav li.previous strong, .docnav li.next strong {
width: 200px;
height:22px;
Added: trunk/docs/migrationguide/en/src/main/docbook/included/dataTableAjax.xml
===================================================================
--- trunk/docs/migrationguide/en/src/main/docbook/included/dataTableAjax.xml
(rev 0)
+++ trunk/docs/migrationguide/en/src/main/docbook/included/dataTableAjax.xml 2008-12-23
16:54:44 UTC (rev 11997)
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<section id="dataTableAjax" role="new">
+ <?dbhtml filename="dataTableAjax.html"?>
+ <sectioninfo>
+ <keywordset>
+ <keyword>dataTable</keyword>
+ <keyword>ajax</keyword>
+ </keywordset>
+ </sectioninfo>
+ <title>Ajax request calls encode() method of <rich:dataTable>
even if it is not necessary</title>
+ <section>
+ <title>Description</title>
+ <para>
+ Any Ajax request reloads the list that is related to the <emphasis
role="bold"><property><rich:dataTable></property></emphasis>
component even if the Ajax request is related to another bean.
+It happens because the Ajax request checks whether the <emphasis
role="bold"><property><rich:dataTable></property></emphasis>
has nested <emphasis
role="bold"><property><h:outputPanel></property></emphasis>
or <emphasis
role="bold"><property><h:messages></property></emphasis>
components that should be updated.
+If there are no <emphasis
role="bold"><property><h:outputPanel></property></emphasis>,
<emphasis
role="bold"><property><h:messages></property></emphasis>
components inside the <emphasis
role="bold"><property><rich:dataTable></property></emphasis>
is not updated, but anyway the <code>encode()</code> method is called by the
Ajax request.
+ </para>
+ </section>
+ <section>
+ <title>Links</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink
url="https://jira.jboss.org/jira/browse/RF-3341">Jira</ul...
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewtopic&...
Forum</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>How to reproduce</title>
+ <para>
+ Place the following code on a page and click the button. The list in
<code>myBean1.myList</code> will be reloaded.
+ </para>
+ <programlisting role="XML"><![CDATA[...
+<h:form id="form1">
+ <rich:dataTable id="myTable" value="#{myBean1.myList}"
var="comp">
+ ...
+ </rich:dataTable>
+</h:form>
+<h:form id="form2">
+ <h:outputText value="#{myBean2.test}"/>
+ <a4j:commandButton event="onclick" reRender="form2" />
+</h:form>
+...]]></programlisting>
+ </section>
+ <section>
+ <title>Causes</title>
+ <para>
+ Bug is caused by <emphasis
role="bold"><property><rich:dataTable></property></emphasis>
implementation peculiarity.
+ </para>
+ </section>
+
+ <section>
+ <title>Workarounds</title>
+ <para>
+ Wrap the zone of a page that should be processed and updated in the <emphasis
role="bold"><property><a4j:region></property></emphasis>
component with <code>renderRegionOnly="true"</code>. The
<emphasis
role="bold"><property><rich:dataTable></property></emphasis>
should be outside of the <emphasis
role="bold"><property><a4j:region></property></emphasis>.
+ </para>
+ </section>
+</section>
Property changes on:
trunk/docs/migrationguide/en/src/main/docbook/included/dataTableAjax.xml
___________________________________________________________________
Name: svn:executable
+ *
Modified: trunk/docs/migrationguide/en/src/main/docbook/master.xml
===================================================================
--- trunk/docs/migrationguide/en/src/main/docbook/master.xml 2008-12-23 16:08:35 UTC (rev
11996)
+++ trunk/docs/migrationguide/en/src/main/docbook/master.xml 2008-12-23 16:54:44 UTC (rev
11997)
@@ -23,6 +23,7 @@
<!ENTITY asClientId SYSTEM "included/asClientId.xml">
<!ENTITY panelGridClass SYSTEM "included/panelGridClass.xml">
+ <!ENTITY dataTableAjax SYSTEM "included/dataTableAjax.xml">
]>
<book>
@@ -155,7 +156,8 @@
However, most of the problems can be positively solved.
This section covers the most significant issues you can potentially encounter,
providing ways to handle the cases.
</para>
-&panelGridClass;
+&panelGridClass;
+&dataTableAjax;
</section>
<section id="ThirdPartyFrameworks32to33">
<?dbhtml filename="ThirdPartyFrameworks32to33.html"?>