[richfaces-svn-commits] JBoss Rich Faces SVN: r11997 - in trunk/docs: migrationguide/en/src/main/docbook and 1 other directories.
richfaces-svn-commits at lists.jboss.org
richfaces-svn-commits at lists.jboss.org
Tue Dec 23 11:54:44 EST 2008
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</ulink>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4197996#4197996">RichFaces 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"?>
More information about the richfaces-svn-commits
mailing list