[richfaces-svn-commits] JBoss Rich Faces SVN: r8002 - in trunk/docs/migrationguide/en/src/main/docbook: included and 1 other directory.

Author: artdaw Date: 2008-04-21 10:04:30 -0400 (Mon, 21 Apr 2008) New Revision: 8002 Added: trunk/docs/migrationguide/en/src/main/docbook/included/actionparam.xml Modified: trunk/docs/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml trunk/docs/migrationguide/en/src/main/docbook/included/fileUploadListener.xml trunk/docs/migrationguide/en/src/main/docbook/master.xml Log: http://jira.jboss.com/jira/browse/RF-3048 - new issue was added. tag <code> was changed to <property> Added: trunk/docs/migrationguide/en/src/main/docbook/included/actionparam.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/actionparam.xml (rev 0) +++ trunk/docs/migrationguide/en/src/main/docbook/included/actionparam.xml 2008-04-21 14:04:30 UTC (rev 8002) @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="actionparam" role="NotInToc"> + <?dbhtml filename="actionparam.html"?> + <sectioninfo> + <keywordset> + <keyword>a4j:actionparam</keyword> + <keyword>actionListener</keyword> + <keyword>JSP</keyword> + </keywordset> + </sectioninfo> + <title>Action listeners calling problem with &lt;a4j:actionparam&gt; on JSP page</title> + <section> + <title>Description</title> + <para> + As it has been mentioned above we&apos;ve migrated to <property>JSF 1.2</property> standard in <property>RichFaces 3.2.0</property>. + The order of calling action listeners has been changed in <property>JSF 1.2</property>: first the own components listener is called then the other ones. + </para> + <para> + This is why the <emphasis role="bold"><property>&lt;a4j:actionparamr&gt;</property></emphasis> components setter is called after + <emphasis><property>&quot;actionListener&quot;</property></emphasis> of the component itself. + In the following example <property>#{bean.action}</property> is called before <property>#{bean.value}</property>: + </para> + <para> + <emphasis role="bold">Example:</emphasis> + </para> + <programlisting role="XML"><![CDATA[... +<a4:support actionListener="#{bean.action}" event="onclick"> + <a4j:actionparam assignTo="#{bean.value}" value="John"/> +</a4j:support> +...]]></programlisting> + <para> + This issue is reproduced for JSP pages only. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-3110">Jira</uli... + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <programlisting role="XML"><![CDATA[... +<f:view> + <h:form> + <h:panelGrid width="120" border="5"> + <a4j:support event="onclick" reRender="rep" actionListener="#{actionPlanBean.actionListener}"> + <a4j:actionparam name="username" value="John" assignTo="#{actionPlanBean.name}" /> + </a4j:support> + <h:outputLabel value="Panel 1 - John"/> + </h:panelGrid> + <rich:panel> + <h:outputText id="rep" value="I say: #{actionPlanBean.helloLabel}"/> + </rich:panel> + </h:form> +</f:view> +...]]></programlisting> + </section> + <section> + <title>Causes</title> + <para> + Please, see <ulink url="http://jira.jboss.com/jira/browse/RF-3080">Jira</uli...;. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + The decision is to use <emphasis role="bold"><property>&lt;a4j:actionParam&gt;</property></emphasis> before: + </para> + <programlisting role="XML"><![CDATA[... +<f:actionListener binding="#{skin.binding}"/> +...]]></programlisting> + + </section> +</section> \ No newline at end of file Modified: trunk/docs/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml 2008-04-21 14:02:31 UTC (rev 8001) +++ trunk/docs/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml 2008-04-21 14:04:30 UTC (rev 8002) @@ -46,7 +46,7 @@ <section> <title>Causes</title> <para> - The ajaxSingle/region requires <code>invokeOnComponent()</code> to work properly. For more details, please, + The ajaxSingle/region requires <property>invokeOnComponent()</property> to work properly. For more details, please, see <ulink url="https://javaserverfaces.dev.java.net/issues/show_bug.cgi?id=718... Faces issues reporting</ulink> page. </para> </section> Modified: trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml 2008-04-21 14:02:31 UTC (rev 8001) +++ trunk/docs/migrationguide/en/src/main/docbook/included/binding.xml 2008-04-21 14:04:30 UTC (rev 8002) @@ -40,7 +40,7 @@ <section> <title>Causes</title> <para> - There was <code>&lt;classname&gt;java.lang.String&lt;/classname&gt;</code> instead of <code>&lt;classname&gt;javax.faces.component.UIComponent&lt;/classname&gt;</code> in configuration files. + There was <property>&lt;classname&gt;java.lang.String&lt;/classname&gt;</property> instead of <property>&lt;classname&gt;javax.faces.component.UIComponent&lt;/classname&gt;</property> in configuration files. </para> </section> Modified: trunk/docs/migrationguide/en/src/main/docbook/included/fileUploadListener.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/included/fileUploadListener.xml 2008-04-21 14:02:31 UTC (rev 8001) +++ trunk/docs/migrationguide/en/src/main/docbook/included/fileUploadListener.xml 2008-04-21 14:04:30 UTC (rev 8002) @@ -39,7 +39,7 @@ <section> <title>Causes</title> <para> - In case <property>MyFaces</property> <code>org.apache.myfaces.CHECK_EXTENSIONS_FILTER</code> parameter is set to &quot;true&quot;. + In case <property>MyFaces</property> <property>org.apache.myfaces.CHECK_EXTENSIONS_FILTER</property> parameter is set to &quot;true&quot;. This parameter checks if the extensions-filter has been properly configured. </para> <para> Modified: trunk/docs/migrationguide/en/src/main/docbook/master.xml =================================================================== --- trunk/docs/migrationguide/en/src/main/docbook/master.xml 2008-04-21 14:02:31 UTC (rev 8001) +++ trunk/docs/migrationguide/en/src/main/docbook/master.xml 2008-04-21 14:04:30 UTC (rev 8002) @@ -15,6 +15,7 @@ <!ENTITY datascrollerPaired SYSTEM "included/datascrollerPaired.xml"> <!ENTITY datascrollerFor SYSTEM "included/datascrollerFor.xml"> <!ENTITY ajaxSingleFacets SYSTEM "included/ajaxSingleFacets.xml"> + <!ENTITY actionparam SYSTEM "included/actionparam.xml"> <!ENTITY fileUploadListener SYSTEM "included/fileUploadListener.xml"> <!ENTITY myfaces SYSTEM "included/myfaces.xml"> @@ -46,9 +47,10 @@ <title>The RichFaces Migration Issues</title> <para> - This chapter includes only the issue with migration from previous versions to 3.2.0. - Issues with new components and other problems are not included. - The <ulink url="http://jira.jboss.com/jira/browse/RF">Jira</ulink> contains everything. + This chapter includes only those issues that concern migration from the previous versions to 3.2.0. + Issues, related to the new components and other problems are not covered here. + However, <ulink url="http://jira.jboss.com/jira/browse/RF">Jira</ulink> contains all issues + and if you can not find your case there, please, feel free to report it. </para> <section id="MostImportant"> <?dbhtml filename="MostImportant.html"?> @@ -58,8 +60,13 @@ <keyword>issues</keyword> </keywordset> </sectioninfo> - <title>Most important</title> - + <title>Most important issues</title> + <para> + Migrating to <property>RichFaces 3.2.0</property> you can encounter + with malfunction of the components caused by a number of reasons. + However, most of the problems can be positively solved. + This section covers the most significant issues you can potentially encounter, providing way to handle the cases. + </para> &i18n; &menuJSF; &binding; @@ -82,6 +89,7 @@ &datascrollerPaired; &datascrollerFor; &ajaxSingleFacets; + &actionparam; </section> <section id="ThirdPartyFrameworks">