Author: artdaw Date: 2009-08-27 20:23:22 -0400 (Thu, 27 Aug 2009) New Revision: 15381 Added: root/docs/trunk/guides/migrationguide/ root/docs/trunk/guides/migrationguide/en/ root/docs/trunk/guides/migrationguide/en/pom.xml root/docs/trunk/guides/migrationguide/en/src/ root/docs/trunk/guides/migrationguide/en/src/main/ root/docs/trunk/guides/migrationguide/en/src/main/docbook/ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/actionparam.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/binding.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/calendarDate.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/contextMenuDisablement.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/dataTableAjax.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerFor.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerPaired.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/explicitId.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/fileUploadListener.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/i18n.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/immediate.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/menuJSF.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/myfaces.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/resource.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/seamMultipartFilter.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/master.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/ root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/intro.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/req.xml root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/scope.xml root/docs/trunk/guides/migrationguide/pom.xml Modified: root/docs/trunk/guides/pom.xml Log: https://jira.jboss.org/jira/browse/RF-7335 - Migration Guide is added to the 4.0 build Added: root/docs/trunk/guides/migrationguide/en/pom.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/pom.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/pom.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,33 @@ +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> + <parent> + <groupId>org.richfaces.docs.guides</groupId> + <artifactId>migrationGuide</artifactId> + <version>4.0.0-SNAPSHOT</version> + </parent> + <modelVersion>4.0.0</modelVersion> + + <groupId>org.richfaces.docs.migrationGuide</groupId> + <artifactId>en</artifactId> + <packaging>jar</packaging> + <name>RichFaces Migration Guide (${translation})</name> + <build> + <finalName> + ${project.parent.artifactId}_${translation}-${version} + </finalName> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-dependency-plugin</artifactId> + </plugin> + <plugin> + <groupId>org.codehaus.mojo</groupId> + <artifactId>xml-maven-plugin</artifactId> + </plugin> + + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + </plugin> + </plugins> + </build> +</project> Property changes on: root/docs/trunk/guides/migrationguide/en/pom.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/actionparam.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/actionparam.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/actionparam.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -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 listener of the component itself is called then the other listeners are called. + </para> + <para> + This is why the <emphasis role="bold"><property>&lt;a4j:actionparam&gt;</property></emphasis> component setter is called after + <emphasis><property>&quot;actionListener&quot;</property></emphasis> of the component itself. + In the following example <code>#{bean.action}</code> is called before <code>#{bean.value}</code>: + </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 occurs in 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 solution 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 Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/actionparam.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="ajaxSingleFacets" role="NotInToc"> + <?dbhtml filename="ajaxSingleFacets.html"?> + <sectioninfo> + <keywordset> + <keyword>ajaxSingle</keyword> + <keyword>facet</keyword> + <keyword>static</keyword> + </keywordset> + </sectioninfo> + <title>The ajaxSingle/region components in facets of &lt;h:dataTable&gt;</title> + <section> + <title>Description</title> + <para> + The <property>RichFaces</property> components that have + <emphasis><property>&quot;ajaxSingle&quot;</property></emphasis> set to &quot;true&quot; does not work in + <emphasis><property>&quot;header&quot;</property></emphasis> or <emphasis><property>&quot;footer&quot;</property></emphasis> facets + of <emphasis role="bold"><property>&lt;h:dataTable&gt;</property></emphasis>, e.g. + <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> - scrolling doesn't work. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2696">Jira</uli... + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + The described above problem occurs if the following code is used. As a result the <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> component stops working. + </para> + <programlisting role="XML"><![CDATA[... +<h:dataTable> + <f:facet name="header"> + <rich:datascroller ajaxSingle="true"/> + </f:facet> + ... +</h:dataTable> +...]]></programlisting> + </section> + <section> + <title>Causes</title> + <para> + The ajaxSingle/region requires <code>invokeOnComponent()</code> 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> + + <section> + <title>Workarounds</title> + <para> + The solution is to use <emphasis role="bold"><property>&lt;rich:dataTable&gt;</property></emphasis> component. + </para> + </section> +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/ajaxSingleFacets.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/binding.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/binding.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/binding.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="binding" role="NotInToc"> + <?dbhtml filename="binding.html"?> + <sectioninfo> + <keywordset> + <keyword>binding</keyword> + <keyword>JSP</keyword> + </keywordset> + </sectioninfo> + <title>Binding problem in JSP</title> + <section> + <title>Description</title> + <para> + Binding does not work for all components in JSP: it is impossible to use the<emphasis><property>&quot;binding&quot;</property></emphasis> attribute for + RichFaces components, since wrong class-name is used in TLD generated from XML configuration files. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2918 ">Jira</ulink> + </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> + The described above problem occurs if binding attribute is used with RichFaces components. + </para> + </section> + <section> + <title>Causes</title> + <para> + There was a wrong <code>&lt;classname&gt;java.lang.String&lt;/classname&gt;</code> specified instead of <code>&lt;classname&gt;javax.faces.component.UIComponent&lt;/classname&gt;</code> in configuration files. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + The solution is to use <property>Facelets</property> upgrade to <ulink url=" http://www.jboss.org/jbossrichfaces/downloads/">RichFaces 3.2.0 SP1</ulink> + </para> + </section> + +</section> Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/binding.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/calendarDate.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/calendarDate.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/calendarDate.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="calendarDate" role="NotInToc"> + <?dbhtml filename="calendarDate.html"?> + <sectioninfo> + <keywordset> + <keyword>calendar</keyword> + <keyword>date</keyword> + <keyword>ondateselected</keyword> + </keywordset> + </sectioninfo> + <title>&lt;rich:calendar&gt; and &quot;ondateselected&quot; event problem</title> + <section> + <title>Description</title> + <para> + The <emphasis role="bold"><property>&lt;rich:calendar&gt;</property></emphasis> date selected event is fired before input update. + </para> + <para> + If <property>time</property> and <property>apply</property> elements are added to the calendar, + <emphasis><property>&quot;ondateselected&quot;</property></emphasis> gets fired when a date is selected but before it&apos;s updated in input. + Now we have three events instead of one. But it causes compatibility problem because this event was used by customers to save selected value via Ajax. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <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> + The described above problem occurs when <emphasis role="bold"><property>&lt;a4j:support&gt;</property></emphasis>is put inside <emphasis role="bold"><property>&lt;rich:calendar&gt;</property></emphasis>. + If the <emphasis><property>&quot;event&quot;</property></emphasis> property is set to &quot;ondateselected&quot; + previous value of the <emphasis role="bold"><property>&lt;rich:calendar&gt;</property></emphasis> is stored after selection. + </para> + </section> + <section> + <title>Causes</title> + <para> + Events firing sequence was changed. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + You need <emphasis><property>&quot;onchanged&quot;</property></emphasis> event to be fired after any change which causes input to be updated, both date and time. + </para> + <para> + Note, that + </para> + <itemizedlist> + <listitem> + <para> + <emphasis><property>&quot;ondateselected&quot;</property></emphasis> event is fired after a date is selected in popup + </para> + </listitem> + <listitem> + <para> + <emphasis><property>&quot;ontimechanged&quot;</property></emphasis> event is fired after new time is selected. + </para> + </listitem> + </itemizedlist> + </section> +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/calendarDate.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/contextMenuDisablement.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/contextMenuDisablement.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/contextMenuDisablement.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="contextMenuDisablement" role="NotInToc"> + <?dbhtml filename="contextMenuDisablement.html"?> + <sectioninfo> + <keywordset> + <keyword>contextMenu</keyword> + + </keywordset> + </sectioninfo> + <title>The &lt;rich:contextMenu&gt; if rendered completely disables right mouse click on a page</title> + <section> + <title>Description</title> + <para> + The <emphasis role="bold"><property>&lt;rich:contextMenu&gt;</property></emphasis> component + if rendered disables a right mouse click on a page by default in <property>RichFaces</property> 3.3.0. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.org/jira/browse/RF-5225">Jira</uli... + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + Checkout RichFaces Live Demo 3.3.0, run it, and proceed to the Context Menu page. + If you right click on the image + <emphasis role="bold"><property>&lt;rich:contextMenu&gt;</property></emphasis> appears. + If you click anywhere else, the right click will be non functional. + </para> + </section> + <section> + <title>Causes</title> + <para> + The <emphasis role="bold"><property>&lt;rich:contextMenu&gt;</property></emphasis> in <property>RichFaces</property> 3.3.0 completely disables + right mouse click on a page by default. + </para> + </section> + <section> + <title>Workarounds</title> + <para> + Update to <property>RichFaces</property> 3.3.1. + By default, the <emphasis role="bold"><property>&lt;rich:contextMenu&gt;</property></emphasis> in <property>RichFaces</property> 3.3.1 completely disables + right mouse click in the Context Menu area only. + </para> + </section> +</section> Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/contextMenuDisablement.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/dataTableAjax.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/dataTableAjax.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/dataTableAjax.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -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() methods 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;rich:outputPanel&gt;</property></emphasis> or <emphasis role="bold"><property>&lt;rich:messages&gt;</property></emphasis> components that should be updated. +If there are no <emphasis role="bold"><property>&lt;rich:outputPanel&gt;</property></emphasis>, <emphasis role="bold"><property>&lt;rich:messages&gt;</property></emphasis> components inside the <emphasis role="bold"><property>&lt;rich:dataTable&gt;</property></emphasis> will not be updated, but anyway the <code>encode()</code> methods is called by the Ajax request. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.org/jira/browse/RF-3341">Jira</uli... + </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: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/dataTableAjax.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerFor.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerFor.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerFor.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="datascrollerFor" role="NotInToc"> + <?dbhtml filename="datascrollerFor.html"?> + <sectioninfo> + <keywordset> + <keyword>datascroller</keyword> + <keyword>for</keyword> + <keyword>static</keyword> + </keywordset> + </sectioninfo> + <title>Static &quot;for&quot; attribute in &lt;rich:datascroller&gt;</title> + <section> + <title>Description</title> + <para> + The <emphasis><property>&quot;for&quot;</property></emphasis>attribute of <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> component + doesn&apos;t allow EL expressions in 3.2.0.GA. + </para> + <para> + Custom tags exploiting the ability of the <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> to have dynamic + <emphasis><property>&quot;for&quot;</property></emphasis> attribute doesn&apos;t work. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2923">Jira</uli... + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>How to reproduce</title> + <para> + The described above problem occurs if the following code is used: + </para> + <programlisting role="XML"><![CDATA[... +<rich:datascroller for="#{bean.property}"/> +...]]></programlisting> + </section> + <section> + <title>Causes</title> + <para> + Please, see <ulink url="http://jira.jboss.com/jira/browse/RF-1133">Jira</uli... + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + None, so far. + </para> + </section> +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerFor.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerPaired.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerPaired.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerPaired.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="datascrollerPaired" role="NotInToc"> + <?dbhtml filename="datascrollerPaired.html"?> + <sectioninfo> + <keywordset> + <keyword>datascroller</keyword> + <keyword>paired</keyword> + <keyword>page</keyword> + </keywordset> + </sectioninfo> + <title>Paired &lt;rich:datascroller&gt; components do not work</title> + <section> + <title>Description</title> + <para> + Two <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> components bound to the same table aren&apos;t synchronized. + Having two <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis>components on a page, session-scoped beans saves the data for only one <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> component. + It is a common pattern to have 2 <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> components: + the first in the header, the second in the footer. In this case the first one will not work. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2970">Jira</uli... + </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> + The described above problem occurs if two <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> components are added to any table. + </para> + </section> + <section> + <title>Causes</title> + <para> + The <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> component does not manage the scroll state of a data table. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + The solution is to use <emphasis><property>&quot;page&quot;</property></emphasis> attribute and bind it to the same property for all + <emphasis role="bold"><property>&lt;rich:datascroller&gt;</property></emphasis> components. + </para> + </section> + +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/datascrollerPaired.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/explicitId.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/explicitId.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/explicitId.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="explicitId" role="NotInToc"> + <?dbhtml filename="explicitId.html"?> + <sectioninfo> + <keywordset> + <keyword>explicit</keyword> + <keyword>id</keyword> + </keywordset> + </sectioninfo> + <title>Ajax requests in JSF 1.2</title> + <section> + <title>Description</title> + <para> + Ajax requests stop to work without any errors messages displayed, when intensive Ajax traffic is expected. No errors or other messages to detect cause of the defect are shown. + </para> + </section> + <section> + <title>How to reproduce</title> + <para> + The described above problem occurs if an <property>id</property> for Ajax command component is not defined. + </para> + <programlisting role="XML"><![CDATA[... + <h:form> + <h:panelGrid columns="2"> + <h:inputText id="myinput" value="#{userBean.name}"> + <a4j:support event="onkeyup" reRender="outtext" /> + </h:inputText> + <h:outputText id="outtext" value="#{userBean.name}" /> + </h:panelGrid> + </h:form> +...]]></programlisting> + </section> + <section> + <title>Causes</title> + <para> + The problem occurred due to specific usage of the dynamic id generation implementing JSF 1.2. + In case of simultaneous request processing, the id of the command component becomes <property>out-of-sync</property> + with id of the same component on the page. After that any Ajax requests of the component with old id is not processed. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + You should define the <property>id</property> for the command component and parent namespace components + (<emphasis role="bold"><property>&lt;h:form&gt;</property></emphasis>, + <emphasis role="bold"><property>&lt;f:subview&gt;</property></emphasis>, + <emphasis role="bold"><property>&lt;h:dataTable&gt;</property></emphasis> and so on) explicitly. + As soon as this is a core JSF 1.2 functionality, the problem cannot be solved on the <property>RichFaces</property> level. + </para> + </section> + +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/explicitId.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/fileUploadListener.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/fileUploadListener.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/fileUploadListener.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="fileUploadListener" role="NotInToc"> + <?dbhtml filename="fileUploadListener.html"?> + <sectioninfo> + <keywordset> + <keyword>fileUpload</keyword> + <keyword>listener</keyword> + </keywordset> + </sectioninfo> + <title>The &quot;fileUploadListener&quot; with MyFaces or JSF-RI 1.2_04</title> + <section> + <title>Description</title> + <para> + The <emphasis><property>&quot;fileUploadListener&quot;</property></emphasis>(<emphasis><property>&quot;UploadEvent&quot;</property></emphasis> event) is not invoked + when <property>MyFaces</property> or <property>JSF-RI 1.2_04</property> is used. But file is uploaded successfully. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2935">Jira(for MyFaces)</ulink> + </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> + <property>MyFaces</property> or <property>JSF-RI 1.2_04</property> with default configuration + </para> + </section> + <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;, the parameter checks if the extensions-filter has been properly configured. + </para> + <para> + The reason why usage of <property>JSF-RI 1.2_04</property> causes the problem is not yet identified. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + To avoid generation of errors from <property>MyFaces</property> in case of invalid filter configuration + you can set up the following parameters in <property>web.xml</property>: + </para> + <programlisting role="XML"><![CDATA[... +<context-param> + <param-name>org.apache.myfaces.CHECK_EXTENSIONS_FILTER</param-name> + <param-value>false</param-value> +</context-param> +...]]></programlisting> + <para> + In case of JSF 1.2_04, upgrading to <ulink url="https://javaserverfaces.dev.java.net/servlets/ProjectDocumentLi... 1.2_07</ulink> + (last stable version) works. + </para> + </section> +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/fileUploadListener.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/i18n.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/i18n.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/i18n.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="i18n" role="NotInToc"> + <?dbhtml filename="i18n.html"?> + <sectioninfo> + <keywordset> + <keyword>i18n</keyword> + <keyword>internationalization</keyword> + </keywordset> + </sectioninfo> + <title>non-ASCII characters in application with i18n</title> + <section> + <title>Description</title> + <para> + An application with i18n does not work correctly due to the validation error that occurs when non-ASCII characters are used. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2962">Jira</uli... + </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> + <programlisting role="XML"><![CDATA[... +<select id="j_id27:cbxUser" name="j_id27:cbxUser" size="1" style="width:120px"> + <option value="Al Korbeli& #269;o">Al Korbeli& #269;o</option> + <option value="Al Nagyov& aacute;">Al Nagyov& aacute;</option> + <option value="Al Tothov& aacute;">Al Tothov& aacute;</option> + <option value="An Gajdov& aacute;">An Gajdov& aacute;</option> + ... +</select> +...]]></programlisting> + </section> + <section> + <title>Causes</title> + <para> + Bug is caused by the<emphasis role="bold"><property>&lt;rich:fileUpload&gt;</property></emphasis> component + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + You need to update to <ulink url="http://www.jboss.org/jbossrichfaces/downloads/">RichFaces 3.2.0 SP1</ulink> + </para> + </section> + +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/i18n.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/immediate.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/immediate.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/immediate.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="immediate" role="NotInToc"> + <?dbhtml filename="immediate.html"?> + <sectioninfo> + <keywordset> + <keyword>a4j:support</keyword> + <keyword>immediate</keyword> + <keyword>JSP</keyword> + </keywordset> + </sectioninfo> + <title>Behavior of the &quot;immediate&quot; attribute is changed</title> + <section> + <title>Description</title> + <para> + Since we&apos;ve migrated to the <property>JSF 1.2</property> standard in <property>RichFaces 3.2.0</property> the + <emphasis><property>&quot;immediate&quot;</property></emphasis> attribute works exactly like it should according to the JSF 1.2 specification: + the default ActionListener stops execution after the Apply Request Values phase, so there is no interaction with a model any more. + We could not use the standard JSF API before as soon as we had to support not only JSF 1.2, but JSF 1.1 as well. + We used our own hack that emulated the behavior of the attribute. + This approach had a side effect that allowed interacting with a model but now this side effect is gone. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <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> + <programlisting role="XML"><![CDATA[... +<h:form> + <h:inputText id="oneA" value="#{bean.name}" size="8"> + <a4j:support event="onkeyup" reRender="three" immediate="true" focus="oneA" action="#{bean.actionOne}"/> + </h:inputText> + <h:selectBooleanCheckbox id="twoA" value="#{bean.option}"> + <a4j:support event="onclick" reRender="three" immediate="true" focus="twoA" action="#{bean.actionOne}"/> + </h:selectBooleanCheckbox> + <h:commandButton id="go" value="Submit"/> +</h:form> +<h:outputText id="three" value="#{bean.name} #{bean.option}"/> +...]]></programlisting> + </section> + <section> + <title>Causes</title> + <para> + Behavior of the <emphasis><property>&quot;immediate&quot;</property></emphasis> attribute is changed according to to JSF 1.2 specification. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + The solution includes the following steps: + </para> + <itemizedlist> + <listitem> + <para> + replace <emphasis><property>&quot;immediate&quot;</property></emphasis> attribute with <code>ajaxSingle=&quot;true&quot;</code> + </para> + </listitem> + <listitem> + <para> + add <emphasis><property>&quot;process&quot;</property></emphasis> attribute. + This attribute points to the components that should be processed together with the command component. + </para> + </listitem> + </itemizedlist> + </section> +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/immediate.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/menuJSF.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/menuJSF.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/menuJSF.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="menuJSF" role="NotInToc"> + <?dbhtml filename="menuJSF.html"?> + <sectioninfo> + <keywordset> + <keyword>JSF-RI-1.2_08</keyword> + <keyword>menu</keyword> + </keywordset> + </sectioninfo> + <title>Menu components and JSF-RI-1.2_08</title> + <section> + <title>Description</title> + <para> + Menu components do not work with JSF-RI-1.2_08: + </para> + <itemizedlist> + <listitem> + <para> + The <emphasis role="bold"><property>&lt;rich:contextMenu&gt;</property></emphasis> component is not invoked by the right mouse click + </para> + </listitem> + <listitem> + <para> + The <emphasis role="bold"><property>&lt;rich:dropDownMenu&gt;</property></emphasis> component causes the exception, displaying a XHTML invalid output message + </para> + </listitem> + </itemizedlist> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="https://javaserverfaces.dev.java.net/issues/show_bug.cgi?id=717 ">JavaServer Faces issues</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2637 ">Jira</ulink> + </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> + The described above problems occur if JSF-RI 1.2_08 and menu components are used on a page + </para> + </section> + <section> + <title>Causes</title> + <para> + It is a critical bug in JSF-RI 1.2_08 which has been already fixed in the further releases. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + Upgrade to <ulink url="https://javaserverfaces.dev.java.net/servlets/ProjectDocumentLi... 1.2_09</ulink> or above + </para> + </section> + +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/menuJSF.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/myfaces.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/myfaces.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/myfaces.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="myfaces" role="NotInToc"> + <?dbhtml filename="myfaces.html"?> + <sectioninfo> + <keywordset> + <keyword>MyFaces</keyword> + <keyword>RichFaces</keyword> + <keyword>WebLogic</keyword> + </keywordset> + </sectioninfo> + <title>RichFaces 3.2.0 with MyFaces 1.2.2 on WebLogic 10 MP1</title> + <section> + <title>Description</title> + <para> + If you try to use <property>RichFaces 3.2.0</property> with <property>MyFaces 1.2.2</property> on a + <property>WebLogic 10 MP1</property> server the following error appears: + </para> + <programlisting role="JAVA"><![CDATA[java.lang.IllegalStateException: Servlet response already use stream, Writer not possible +...]]></programlisting> + + + <para> + The same project works on <property>Tomcat 6.016</property>, <property>Tomcat 5.5.25</property> + <property>WebLogic 10MP1</property> with <property>RichFaces 3.1.4</property>. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <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> + The problem occurs if the environment mentioned above is set. + </para> + </section> + <section> + <title>Causes</title> + <para> + Unknown. Possible problem with <property>MyFaces</property> on <property>WebLogic 10MP1</property>. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + Switching to <ulink url="https://javaserverfaces.dev.java.net/servlets/ProjectDocumentLi... 1.2_07</ulink> + fixes the problem (see forum post) + </para> + </section> +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/myfaces.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/resource.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/resource.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/resource.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="resource" role="NotInToc"> + <?dbhtml filename="resource.html"?> + <sectioninfo> + <keywordset> + <keyword>resource</keyword> + <keyword>skinning</keyword> + </keywordset> + </sectioninfo> + <title>Resources for standard skinning classes</title> + <section> + <title>Description</title> + <para> + When standard skinning classes or background images are inaccessible + <code>&quot;Resource not registered : org.richfaces.renderkit.html.images.InputBackgroundImage&quot;</code> (another name is possible) exception appears in server log. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <listitem> + <para> + <ulink url="http://jira.jboss.com/jira/browse/RF-2944 ">Jira</ulink> + </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>The described above problem usually occurs after server restart when user refreshes the page</para> + </section> + <section> + <title>Causes</title> + <para> + The problem is caused when resources for standard skinning classes are not available to be registered during <property>RichFaces</property> library build + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + Switch off standard skinning classes by setting initial parameter in <property>web.xml</property>: + </para> + <programlisting role="XML"><![CDATA[... +<context-param> + <param-name>org.richfaces.CONTROL_SKINNING_CLASSES</param-name> + <param-value>disable</param-value> +</context-param> +...]]></programlisting> +<para> + Add <ulink url="http://docs.google.com/View?docid=dqk93fg_3ggsznfz5">ME... to the application classpath. +</para> + </section> + +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/resource.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/seamMultipartFilter.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/seamMultipartFilter.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/seamMultipartFilter.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<section id="seamMultipartFilter" role="NotInToc"> + <?dbhtml filename="seamMultipartFilter.html"?> + <sectioninfo> + <keywordset> + <keyword>rich:fileUpload</keyword> + <keyword>Seam</keyword> + <keyword>multi-part</keyword> + <keyword>filter</keyword> + </keywordset> + </sectioninfo> + <title>&lt;rich:fileUpload&gt; with Seam multi-part filter</title> + <section> + <title>Description</title> + <para> + The <emphasis role="bold"><property>&lt;rich:fileUpload&gt;</property></emphasis> component does not work with <property>Seam</property> multi-part filter. + </para> + </section> + <section> + <title>Links</title> + <itemizedlist> + <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> + The problem occurs if you use the <emphasis role="bold"><property>&lt;rich:fileUpload&gt;</property></emphasis> component and <property>Seam</property> multi-part filter at the same time. + </para> + </section> + <section> + <title>Causes</title> + <para> + Lack of specification on the <property>Servlet</property> level does not allow to use stuff doing the same thing. One of them should be turned off. + </para> + </section> + + <section> + <title>Workarounds</title> + <para> + The solution is turn the <property>Seam</property> multi-part filter off. + </para> + </section> +</section> \ No newline at end of file Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/included/seamMultipartFilter.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/master.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/master.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/master.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,187 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN" +"http://www.docbook.org/xml/4.3CR3/docbookx.dtd" [ + <!ENTITY intro SYSTEM "modules/intro.xml"> + <!ENTITY scope SYSTEM "modules/scope.xml"> + <!ENTITY req SYSTEM "modules/req.xml"> + + <!ENTITY i18n SYSTEM "included/i18n.xml"> + <!ENTITY menuJSF SYSTEM "included/menuJSF.xml"> + <!ENTITY binding SYSTEM "included/binding.xml"> + <!ENTITY explicitId SYSTEM "included/explicitId.xml"> + <!ENTITY resource SYSTEM "included/resource.xml"> + + <!ENTITY calendarDate SYSTEM "included/calendarDate.xml"> + <!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 immediate SYSTEM "included/immediate.xml"> + + + <!ENTITY fileUploadListener SYSTEM "included/fileUploadListener.xml"> + <!ENTITY myfaces SYSTEM "included/myfaces.xml"> + <!ENTITY seamMultipartFilter SYSTEM "included/seamMultipartFilter.xml"> + <!ENTITY contextMenuDisablement SYSTEM "included/contextMenuDisablement.xml"> + + + <!ENTITY dataTableAjax SYSTEM "included/dataTableAjax.xml"> + + <!ENTITY cdkguide "../../cdkguide/html_single/index.html"> + <!ENTITY devguide "../../devguide/html_single/index.html"> + <!ENTITY migrationguide "../../migrationguide/html_single/index.html"> + <!ENTITY photoalbumguide "../../realworld/html_single/index.html"> + <!ENTITY realworld "../../realworld/html_single/index.html"> + <!ENTITY tlddoc "../../tlddoc/index.html"> + <!ENTITY apidoc "../../apidoc/index.html"> + <!ENTITY apidoc_framework "../../apidoc_framework/index.html"> + +]> +<book> + <bookinfo> + <title>RichFaces Migration Guide</title> + <corpauthor> + <inlinemediaobject> + <imageobject role="fo"> + <imagedata format="PNG" fileref="images/richfaces_logo.png" /> + </imageobject> + <imageobject role="html"> + <imagedata/> + </imageobject> + </inlinemediaobject> + </corpauthor> + <author> + <firstname>Gleb</firstname> + <surname>Galkin</surname> + <email&gt;ggalkin(a)exadel.com&lt;/email&gt; + </author> + <copyright> + <year>2008, 2009</year> + <holder>Red Hat</holder> + </copyright> +<abstract> + <title/> + <para> + <ulink url="../pdf/richfaces_migration_guide.pdf">PDF version</ulink> + </para> +</abstract> + + </bookinfo> + + <toc/> + + &intro; + &scope; + &req; + + <chapter id="RichFacesMigrationIssues31to32" xreflabel="RichFacesMigrationIssues31to32"> + <?dbhtml filename="RichFacesMigrationIssues31to32.html"?> + <chapterinfo> + <keywordset> + <keyword>RichFaces</keyword> + <keyword>Migration Guide</keyword> + </keywordset> + </chapterinfo> + <title>The RichFaces Migration Issues 3.1.x - 3.2.0</title> + + <para> + This chapter includes only those issues that concern migration from from 3.1.x 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="MostImportant31to32"> + <?dbhtml filename="MostImportant31to32.html"?> + <sectioninfo> + <keywordset> + <keyword>important</keyword> + <keyword>issues</keyword> + </keywordset> + </sectioninfo> + <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 ways to handle the cases. + </para> + &i18n; + &menuJSF; + &binding; + &explicitId; + &resource; + </section> + + <section id="PreviousVersions31to32"> + <?dbhtml filename="PreviousVersions31to32.html"?> + <sectioninfo> + <keywordset> + <keyword>upgrade</keyword> + <keyword>previous</keyword> + <keyword>version</keyword> + </keywordset> + </sectioninfo> + <title>Issues with upgrading from previous versions</title> + <para>This section covers issues you can encounter upgrading to <property>RichFaces 3.2.0</property> from previous versions.</para> + &calendarDate; + &datascrollerPaired; + &datascrollerFor; + &ajaxSingleFacets; + &actionparam; + &immediate; + </section> + + <section id="ThirdPartyFrameworks31to32"> + <?dbhtml filename="ThirdPartyFrameworks31to32.html"?> + <sectioninfo> + <keywordset> + <keyword>third</keyword> + <keyword>party</keyword> + <keyword>frameworks</keyword> + </keywordset> + </sectioninfo> + <title>Issues with compatibility with third party frameworks</title> + <para>This section covers issues related to compatibility with third party frameworks. </para> + &fileUploadListener; + &myfaces; + &seamMultipartFilter; + </section> + </chapter> + + <chapter id="RichFacesMigrationIssues32to33" xreflabel="RichFacesMigrationIssues32to33"> + <?dbhtml filename="RichFacesMigrationIssues32to33.html"?> + <chapterinfo> + <keywordset> + <keyword>RichFaces</keyword> + <keyword>Migration Guide</keyword> + </keywordset> + </chapterinfo> + <title>The RichFaces Migration Issues 3.2.x - 3.3.0</title> + <para> + This chapter includes only those issues that concern migration from from 3.2.x versions to 3.3.0. + Issues, that are 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> + + +&dataTableAjax; + </chapter> + <chapter id="RichFacesMigrationIssues330to331" xreflabel="RichFacesMigrationIssues330to331"> + <?dbhtml filename="RichFacesMigrationIssues330to331.html"?> + <chapterinfo> + <keywordset> + <keyword>RichFaces</keyword> + <keyword>Migration Guide</keyword> + </keywordset> + </chapterinfo> + <title>The RichFaces Migration Issues 3.3.0 - 3.3.1</title> + <para> + This chapter includes only those issues that concern migration from from 3.3.0 versions to 3.3.1. + Issues, that are 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> + &contextMenuDisablement; + </chapter> +</book> Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/master.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/intro.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/intro.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/intro.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,19 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="introduction" xreflabel="introduction"> + <?dbhtml filename="intro.html"?> + <chapterinfo> + <keywordset> + <keyword>RichFaces</keyword> + <keyword>Migration Guide</keyword> + </keywordset> + </chapterinfo> + + <title>Introduction</title> + <para> + This document is aimed to provide guidelines for migrating <property>RichFaces</property> projects. + </para> + <para> + <property>RichFaces</property> Migration Guide covers troublesome issues caused by migration and provides + suitable workarounds and examples. + </para> +</chapter> Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/intro.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/req.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/req.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/req.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,19 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="req" xreflabel="req"> + <?dbhtml filename="requirements.html"?> + <chapterinfo> + <keywordset> + <keyword>RichFaces</keyword> + <keyword>Migration Guide</keyword> + <keyword>requirements</keyword> + </keywordset> + </chapterinfo> + + <title>Minimum requirements for the project with RichFaces 3.2.0</title> + <para> + You can find all technical requirements to start working with <property>RichFaces</property> + in the <ulink url="http://www.jboss.org/jbossrichfaces/docs/index.html">De... Guide</ulink>. + </para> + +</chapter> + Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/req.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/scope.xml =================================================================== --- root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/scope.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/scope.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,35 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="scope" xreflabel="scope"> + <?dbhtml filename="scope.html"?> + <chapterinfo> + <keywordset> + <keyword>RichFaces</keyword> + <keyword>Migration Guide</keyword> + <keyword>scope</keyword> + </keywordset> + </chapterinfo> + + <title>Scope of the document</title> + + <itemizedlist> + <listitem> + <para> + This document should not be used as a tutorial for <property>RichFaces</property> framework + since it is created to describe the issues caused by migration process + </para> + </listitem> + <listitem> + <para> + It is assumed that you are familiar with basic tenets of <property>RichFaces</property> framework. + If you are newbie in <property>RichFaces</property> you can find + <property>RichFaces</property> documentation on <ulink url="http://www.jboss.org/jbossrichfaces/docs/index.html">Ri... project page</ulink>. + </para> + </listitem> + <listitem> + <para> + Concepts related to Web or application servers configuration, JSF, JSF implementations are beyond the scope of this document + </para> + </listitem> + </itemizedlist> + +</chapter> Property changes on: root/docs/trunk/guides/migrationguide/en/src/main/docbook/modules/scope.xml ___________________________________________________________________ Name: svn:executable + * Added: root/docs/trunk/guides/migrationguide/pom.xml =================================================================== --- root/docs/trunk/guides/migrationguide/pom.xml (rev 0) +++ root/docs/trunk/guides/migrationguide/pom.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -0,0 +1,243 @@ +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> + <parent> + <groupId>org.richfaces.docs</groupId> + <artifactId>guides</artifactId> + <version>4.0.0-SNAPSHOT</version> + </parent> + <modelVersion>4.0.0</modelVersion> + <groupId>org.richfaces.docs.guides</groupId> + <artifactId>migrationGuide</artifactId> + <packaging>pom</packaging> + <name>RichFaces Migration Guide</name> + <modules> + <module>${docs.translation}</module> + </modules> + + <!--version>3.3.2-SNAPSHOT</version> + <name>Migration Guide</name> + <description>RichFaces Migration Guide from 3.1.* to 3.2.0 version</description> + <pluginRepositories> + <pluginRepository> + <releases> + <enabled>true</enabled> + </releases> + <snapshots> + <enabled>false</enabled> + <updatePolicy>never</updatePolicy> + </snapshots> + <id>repository.jboss.com</id> + <name>Jboss Repository for Maven</name> + <url>http://repository.jboss.com/maven2/</url> + <layout>default</layout> + </pluginRepository> + </pluginRepositories> + <profiles> + <profile> + <id>html</id> + <build> + <pluginManagement> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin + </artifactId> + <version>2.1.0-200803311251UTC-MPJDOCBOOK-8 + </version> + <configuration> + <formats> + <format> + <formatName>html</formatName> + <stylesheetResource> ${xsl_html}</stylesheetResource> + <finalName> index.html</finalName> + <imageCopyingRequired> true</imageCopyingRequired> + <imagePathSettingRequired> false</imagePathSettingRequired> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </pluginManagement> + </build> + </profile> + <profile> + <id>html_single</id> + <build> + <pluginManagement> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin + </artifactId> + <version>2.1.0-200803311251UTC-MPJDOCBOOK-8 + </version> + <configuration> + <formats> + <format> + <formatName>html_single</formatName> + <stylesheetResource> ${xsl_html_single}</stylesheetResource> + <imageCopyingRequired> true</imageCopyingRequired> + <imagePathSettingRequired> false</imagePathSettingRequired> + <finalName> index.html</finalName> + </format> + </formats> + </configuration> + </plugin> + </plugins> + </pluginManagement> + </build> + </profile> + </profiles> + <build> + <pluginManagement> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-dependency-plugin</artifactId> + <executions> + <execution> + <id>unpack</id> + <phase>generate-resources</phase> + <goals> + <goal>unpack</goal> + </goals> + <configuration> + <artifactItems> + <artifactItem> + <groupId> + org.richfaces.docs.common-resources + </groupId> + <artifactId> + ${translation} + </artifactId> + <version> + ${project.version} + </version> + <type>jar</type> + <overWrite>true</overWrite> + <outputDirectory> + ${project.build.directory} + </outputDirectory> + </artifactItem> + </artifactItems> + <overWriteReleases> + false + </overWriteReleases> + <overWriteSnapshots> + true + </overWriteSnapshots> + </configuration> + </execution> + </executions> + </plugin> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.1.0-200803311251UTC-MPJDOCBOOK-8</version> + <executions> + <execution> + <id>jdocbook:generate</id> + <phase>compile</phase> + <goals> + <goal>generate</goal> + </goals> + </execution> + <execution> + <id>jdocbook:resources</id> + <phase>process-resources</phase> + <goals> + <goal>resources</goal> + </goals> + </execution> + <execution> + <id>jdocbook:bundle</id> + <phase>package</phase> + <goals> + <goal>bundle</goal> + </goals> + </execution> + </executions> + <dependencies> + <dependency> + <groupId>org.jboss</groupId> + <artifactId>jbossorg-docbook-xslt</artifactId> + <version>1.1.0</version> + </dependency> + <dependency> + <groupId>org.jboss</groupId> + <artifactId>jbossorg-jdocbook-style</artifactId> + <version>1.1.0</version> + <type>jdocbook-style</type> + </dependency> + <dependency> + <groupId>org.richfaces.docs.common-resources</groupId> + <artifactId>${translation}</artifactId> + <version>${project.version}</version> + <type>jar</type> + </dependency> + <dependency> + <groupId>org.apache.xmlgraphics</groupId> + <artifactId>fop</artifactId> + <version>0.95</version> + </dependency> + </dependencies> + <configuration> + <sourceDirectory> + ${basedir}/src/main/docbook + </sourceDirectory> + <imageResource> + <directory> + ${project.build.directory}/common-resources + </directory> + </imageResource> + <cssResource> + <directory> + ${project.build.directory}/common-resources + </directory> + </cssResource> + <sourceDocumentName>master.xml</sourceDocumentName> + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>classpath:/common-resources/xslt/pdf-common.xsl</stylesheetResource> + <finalName>richfaces_migration_guide.pdf</finalName> + <imagePathSettingRequired>true</imagePathSettingRequired> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource> + ${xsl_html} + </stylesheetResource> + <finalName>index.html</finalName> + <imageCopyingRequired> + true + </imageCopyingRequired> + <imagePathSettingRequired> + false + </imagePathSettingRequired> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource> + ${xsl_html_single} + </stylesheetResource> + <imageCopyingRequired>true</imageCopyingRequired> + <imagePathSettingRequired>false</imagePathSettingRequired> + <finalName>index.html </finalName> + </format> + </formats> + <xincludeSupported>true</xincludeSupported> + <options> + <xincludeSupported>true</xincludeSupported> + <useRelativeImageUris> true </useRelativeImageUris> + <xmlTransformerType> saxon </xmlTransformerType> + <docbookVersion>1.72.0</docbookVersion> + </options> + </configuration> + </plugin> + </plugins> + </pluginManagement> + </build> + <modules> + <module>en</module> + </modules--> +</project> Property changes on: root/docs/trunk/guides/migrationguide/pom.xml ___________________________________________________________________ Name: svn:executable + * Modified: root/docs/trunk/guides/pom.xml =================================================================== --- root/docs/trunk/guides/pom.xml 2009-08-27 23:30:30 UTC (rev 15380) +++ root/docs/trunk/guides/pom.xml 2009-08-28 00:23:22 UTC (rev 15381) @@ -18,7 +18,8 @@ <!-- all deployed modules should be reflected in version-matrix also --> <modules> - <module>testguide</module> + <module>testguide</module> + <module>migrationguide</module> </modules> <build> @@ -232,4 +233,4 @@ </build> </profile> </profiles> -</project> \ No newline at end of file +</project>