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 &lt;rich:dataTable&gt; 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>&lt;rich:dataTable&gt;</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>&lt;rich:dataTable&gt;</property></emphasis> has nested <emphasis role="bold"><property>&lt;h:outputPanel&gt;</property></emphasis> or <emphasis role="bold"><property>&lt;h:messages&gt;</property></emphasis> components that should be updated. +If there are no <emphasis role="bold"><property>&lt;h:outputPanel&gt;</property></emphasis>, <emphasis role="bold"><property>&lt;h:messages&gt;</property></emphasis> components inside the <emphasis role="bold"><property>&lt;rich:dataTable&gt;</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&amp;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>&lt;rich:dataTable&gt;</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>&lt;a4j:region&gt;</property></emphasis> component with <code>renderRegionOnly=&quot;true&quot;</code>. The <emphasis role="bold"><property>&lt;rich:dataTable&gt;</property></emphasis> should be outside of the <emphasis role="bold"><property>&lt;a4j:region&gt;</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"?>