JBoss Rich Faces SVN: r12210 - trunk/docs/realworld_app_guide/en/src/main/docbook/modules.
by richfaces-svn-commits@lists.jboss.org
Author: atsebro
Date: 2009-01-12 07:40:56 -0500 (Mon, 12 Jan 2009)
New Revision: 12210
Modified:
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/intro.xml
Log:
RF-4494: Tutorial about developing this sample application
Modified: trunk/docs/realworld_app_guide/en/src/main/docbook/modules/intro.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/modules/intro.xml 2009-01-12 12:37:04 UTC (rev 12209)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/modules/intro.xml 2009-01-12 12:40:56 UTC (rev 12210)
@@ -4,7 +4,7 @@
<title>Introduction</title>
<para>
- The <emphasis>RichFaces Real World Application</emphasis> — the working name is "<emphasis role="bold">Photo Album</emphasis>" — is created to imaginate the way,
+ The <emphasis>RichFaces Real World Application</emphasis> — the working name is "<emphasis role="bold">Photo Album</emphasis>" — is created to imaginate the way
the web applications designed and developed with <property>RichFaces</property> could look and behave.
</para>
<para>
16 years, 12 months
JBoss Rich Faces SVN: r12209 - in trunk/docs/realworld_app_guide/en/src/main/docbook: modules and 1 other directory.
by richfaces-svn-commits@lists.jboss.org
Author: atsebro
Date: 2009-01-12 07:37:04 -0500 (Mon, 12 Jan 2009)
New Revision: 12209
Removed:
trunk/docs/realworld_app_guide/en/src/main/docbook/included/
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/req.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/scope.xml
Modified:
trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/rw_itself.xml
Log:
RF-4494: Tutorial about developing this sample application
Modified: trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml 2009-01-12 11:46:11 UTC (rev 12208)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml 2009-01-12 12:37:04 UTC (rev 12209)
@@ -22,12 +22,12 @@
<holder>Red Hat</holder>
</copyright>
- <abstract>
+ <!--<abstract>
<title/>
<para>
<ulink url="http://www.jboss.org/file-access/default/members/jbossrichfaces/freezone/...">PDF version</ulink>
</para>
- </abstract>
+ </abstract> -->
</bookinfo>
<toc/>
Deleted: trunk/docs/realworld_app_guide/en/src/main/docbook/modules/req.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/modules/req.xml 2009-01-12 11:46:11 UTC (rev 12208)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/modules/req.xml 2009-01-12 12:37:04 UTC (rev 12209)
@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<chapter id="rw_itself" xreflabel="rw_itself">
- <?dbhtml filename="requirements.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>RichFaces</keyword>
-
- </keywordset>
- </chapterinfo>
-
- <title>The Real World as it is</title>
- <para>
-
- </para>
-
-</chapter>
-
Modified: trunk/docs/realworld_app_guide/en/src/main/docbook/modules/rw_itself.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/modules/rw_itself.xml 2009-01-12 11:46:11 UTC (rev 12208)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/modules/rw_itself.xml 2009-01-12 12:37:04 UTC (rev 12209)
@@ -8,7 +8,7 @@
</keywordset>
</chapterinfo>
- <title>The Real World as it is</title>
+ <title>The Real World main features</title>
<para>The "Photo Album" is a desktop-like online photo manager that provides social service with pictures uploading, preview, storage, management and sharing features.
It allows to create own albums, upload photos there, share the albums with other users, search albums.
For newcomers the system allows "Anonymous regime" that may be used to search and view others albums, but no personal albums, no possibility to mark favorite photos and friends albums are available.
@@ -139,12 +139,48 @@
</tbody>
</tgroup>
</table>
+ <para>Not registered users should proceed with registration. The registration requires following fields:
+ <itemizedlist>
+ <listitem><para>First name</para></listitem>
+ <listitem><para>Second name</para></listitem>
+ <listitem><para>Login</para></listitem>
+ <listitem><para>Password</para></listitem>
+ <listitem><para>Confirm</para></listitem>
+ <listitem><para>Email</para></listitem>
+ <listitem><para>Birth Date</para></listitem>
+ <listitem><para>Avatar</para></listitem>
+
+
+ </itemizedlist>
+
+ </para>
- <para>After loging in the user gets to his personal page. The interface of the "cabinet" consists of menu bar, albums panels and working area.
+ <para>After loging in the user gets to his personal page. It interface consists of menu bar, albums panels and working area.
</para>
+ <figure>
+ <title>Personal page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/rw_its_pers.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The system "Message" service:
+ </para>
+ <figure>
+ <title>Personal page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/rw_its_mess.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
-
+ <note>
+ <title>Note:</title>
+ <para>The work on "Photo Album is in progress". The guide will be augumented with inforamtion.</para>
+ </note>
</section>
Deleted: trunk/docs/realworld_app_guide/en/src/main/docbook/modules/scope.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/modules/scope.xml 2009-01-12 11:46:11 UTC (rev 12208)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/modules/scope.xml 2009-01-12 12:37:04 UTC (rev 12209)
@@ -1,35 +0,0 @@
-<?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 <ulink url="http://www.jboss.org/jbossrichfaces/docs/index.html">here</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>
16 years, 12 months
JBoss Rich Faces SVN: r12208 - in trunk/sandbox/samples/maven-rd-plugin-sample/src/main: java/org/richfaces/datatablescroller and 2 other directories.
by richfaces-svn-commits@lists.jboss.org
Author: abelevich
Date: 2009-01-12 06:46:11 -0500 (Mon, 12 Jan 2009)
New Revision: 12208
Added:
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/Converter.java
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/DemoInventoryItem.java
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/ToolBar.java
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/ToolBarItem.java
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/datatablescroller/
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/datatablescroller/DataTableScrollerBean.java
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/datatablescroller/Facet.java
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/pages/oneMorePage.xhtml
Modified:
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/WEB-INF/faces-config.xml
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/WEB-INF/web.xml
trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/pages/index.xhtml
Log:
extend demo
Added: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/Converter.java
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/Converter.java (rev 0)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/Converter.java 2009-01-12 11:46:11 UTC (rev 12208)
@@ -0,0 +1,23 @@
+package org.richfaces;
+
+import javax.faces.component.UIComponent;
+import javax.faces.context.FacesContext;
+
+public class Converter implements javax.faces.convert.Converter{
+
+ public Object getAsObject(FacesContext context, UIComponent component,
+ String value) {
+
+ int index = value.indexOf(':');
+
+ return new ToolBarItem(value.substring(0, index), value.substring(index + 1));
+ }
+
+ public String getAsString(FacesContext context, UIComponent component,
+ Object value) {
+
+ ToolBarItem optionItem = (ToolBarItem) value;
+ return optionItem.getLabel() + ":" + optionItem.getIcon();
+ }
+
+}
\ No newline at end of file
Added: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/DemoInventoryItem.java
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/DemoInventoryItem.java (rev 0)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/DemoInventoryItem.java 2009-01-12 11:46:11 UTC (rev 12208)
@@ -0,0 +1,154 @@
+package org.richfaces;
+
+import java.math.BigDecimal;
+import java.io.Serializable;
+
+/**
+ * Created by IntelliJ IDEA.
+ * User: Wesley
+ * Date: Jan 26, 2007
+ * Time: 8:21:36 AM
+ * To change this template use File | Settings | File Templates.
+ */
+public class DemoInventoryItem implements Serializable {
+
+ String make;
+ String model;
+ String stock;
+ String vin;
+
+ BigDecimal mileage;
+ BigDecimal mileageMarket;
+ Integer price;
+ BigDecimal priceMarket;
+
+ int daysLive;
+ BigDecimal changeSearches;
+ BigDecimal changePrice;
+
+ BigDecimal exposure;
+ BigDecimal activity;
+ BigDecimal printed;
+ BigDecimal inquiries;
+
+
+ public String getMake() {
+ return make;
+ }
+
+ public void setMake(String make) {
+ this.make = make;
+ }
+
+ public String getModel() {
+ return model;
+ }
+
+ public void setModel(String model) {
+ this.model = model;
+ }
+
+ public String getStock() {
+ return stock;
+ }
+
+ public void setStock(String stock) {
+ this.stock = stock;
+ }
+
+ public String getVin() {
+ return vin;
+ }
+
+ public void setVin(String vin) {
+ this.vin = vin;
+ }
+
+ public BigDecimal getMileage() {
+ return mileage;
+ }
+
+ public void setMileage(BigDecimal mileage) {
+ this.mileage = mileage;
+ }
+
+ public BigDecimal getMileageMarket() {
+ return mileageMarket;
+ }
+
+ public void setMileageMarket(BigDecimal mileageMarket) {
+ this.mileageMarket = mileageMarket;
+ }
+
+ public Integer getPrice() {
+ return price;
+ }
+
+ public void setPrice(Integer price) {
+ this.price = price;
+ }
+
+ public BigDecimal getPriceMarket() {
+ return priceMarket;
+ }
+
+ public void setPriceMarket(BigDecimal priceMarket) {
+ this.priceMarket = priceMarket;
+ }
+
+ public int getDaysLive() {
+ return daysLive;
+ }
+
+ public void setDaysLive(int daysLive) {
+ this.daysLive = daysLive;
+ }
+
+ public BigDecimal getChangeSearches() {
+ return changeSearches;
+ }
+
+ public void setChangeSearches(BigDecimal changeSearches) {
+ this.changeSearches = changeSearches;
+ }
+
+ public BigDecimal getChangePrice() {
+ return changePrice;
+ }
+
+ public void setChangePrice(BigDecimal changePrice) {
+ this.changePrice = changePrice;
+ }
+
+ public BigDecimal getExposure() {
+ return exposure;
+ }
+
+ public void setExposure(BigDecimal exposure) {
+ this.exposure = exposure;
+ }
+
+ public BigDecimal getActivity() {
+ return activity;
+ }
+
+ public void setActivity(BigDecimal activity) {
+ this.activity = activity;
+ }
+
+ public BigDecimal getPrinted() {
+ return printed;
+ }
+
+ public void setPrinted(BigDecimal printed) {
+ this.printed = printed;
+ }
+
+ public BigDecimal getInquiries() {
+ return inquiries;
+ }
+
+ public void setInquiries(BigDecimal inquiries) {
+ this.inquiries = inquiries;
+ }
+}
Added: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/ToolBar.java
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/ToolBar.java (rev 0)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/ToolBar.java 2009-01-12 11:46:11 UTC (rev 12208)
@@ -0,0 +1,54 @@
+package org.richfaces;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class ToolBar {
+ private List<ToolBarItem> items = new ArrayList<ToolBarItem>();
+ private List<ToolBarItem> freeItems = new ArrayList<ToolBarItem>();
+ public ToolBar() {
+ ToolBarItem item = new ToolBarItem();
+ item.setIcon("create_folder");
+ item.setLabel("Create Folder");
+ items.add(item);
+ item = new ToolBarItem();
+ item.setIcon("create_doc");
+ item.setLabel("Create Doc");
+ items.add(item);
+ item = new ToolBarItem();
+ item.setIcon("find");
+ item.setLabel("Find");
+ items.add(item);
+ item = new ToolBarItem();
+ item.setIcon("open");
+ item.setLabel("Open");
+ freeItems.add(item);
+ item = new ToolBarItem();
+ item.setIcon("save");
+ item.setLabel("Save");
+ freeItems.add(item);
+ item = new ToolBarItem();
+ item.setIcon("save_all");
+ item.setLabel("Save All");
+ freeItems.add(item);
+ item = new ToolBarItem();
+ item.setIcon("delete");
+ item.setLabel("Delete");
+ freeItems.add(item);
+ }
+
+ public List<ToolBarItem> getItems() {
+ return items;
+ }
+ public void setItems(List<ToolBarItem> items) {
+ this.items = items;
+ }
+
+ public List<ToolBarItem> getFreeItems() {
+ return freeItems;
+ }
+
+ public void setFreeItems(List<ToolBarItem> freeItems) {
+ this.freeItems = freeItems;
+ }
+}
Added: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/ToolBarItem.java
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/ToolBarItem.java (rev 0)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/ToolBarItem.java 2009-01-12 11:46:11 UTC (rev 12208)
@@ -0,0 +1,67 @@
+package org.richfaces;
+
+public class ToolBarItem {
+private String icon;
+private String label;
+private String iconURI;
+public ToolBarItem() {
+ // TODO Auto-generated constructor stub
+}
+
+public ToolBarItem(String label, String icon) {
+ setLabel(label);
+ setIcon(icon);
+}
+
+public String getLabel() {
+ return label;
+}
+public void setLabel(String label) {
+ this.label = label;
+}
+
+public String getIcon() {
+ return icon;
+}
+
+public void setIcon(String icon) {
+ this.icon = icon;
+}
+
+
+
+public int hashCode() {
+ final int prime = 31;
+ int result = 1;
+ result = prime * result + ((icon == null) ? 0 : icon.hashCode());
+ result = prime * result + ((label == null) ? 0 : label.hashCode());
+ return result;
+}
+
+public boolean equals(Object obj) {
+ if (this == obj)
+ return true;
+ if (obj == null)
+ return false;
+ if (getClass() != obj.getClass())
+ return false;
+ final ToolBarItem other = (ToolBarItem) obj;
+ if (icon == null) {
+ if (other.icon != null)
+ return false;
+ } else if (!icon.equals(other.icon))
+ return false;
+ if (label == null) {
+ if (other.label != null)
+ return false;
+ } else if (!label.equals(other.label))
+ return false;
+ return true;
+}
+
+public String getIconURI() {
+ return "/images/icons/"+icon+".gif";
+}
+
+
+}
Added: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/datatablescroller/DataTableScrollerBean.java
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/datatablescroller/DataTableScrollerBean.java (rev 0)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/datatablescroller/DataTableScrollerBean.java 2009-01-12 11:46:11 UTC (rev 12208)
@@ -0,0 +1,315 @@
+/**
+ *
+ */
+package org.richfaces.datatablescroller;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashSet;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Random;
+import java.util.Set;
+
+import javax.faces.context.FacesContext;
+
+import org.richfaces.component.UIScrollableDataTable;
+import org.richfaces.DemoInventoryItem;
+import org.richfaces.model.SortField;
+import org.richfaces.model.SortOrder;
+import org.richfaces.model.selection.SimpleSelection;
+
+/**
+ * @author Nick Belaevski - nbelaevski(a)exadel.com
+ * created 02.03.2007
+ *
+ */
+public class DataTableScrollerBean {
+
+ private DemoInventoryItem currentItem = new DemoInventoryItem();
+
+ private Set<Integer> keys = new HashSet<Integer>();
+
+ private int currentRow;
+
+ private SimpleSelection selection = new SimpleSelection();
+
+ private UIScrollableDataTable table;
+
+ private SortOrder order = new SortOrder();
+
+ private int scrollerPage;
+
+ private ArrayList<DemoInventoryItem> selectedCars = new ArrayList<DemoInventoryItem>();
+ private ArrayList<Facet> columns = new ArrayList<Facet>();
+ private static int DECIMALS = 1;
+ private static int ROUNDING_MODE = BigDecimal.ROUND_HALF_UP;
+
+ private List <DemoInventoryItem> allCars = null;
+
+ public DataTableScrollerBean() {
+ initColumnsHeaders();
+ SortField[] fields = {new SortField("make", true)};
+ order.setFields(fields);
+ }
+
+ public List <DemoInventoryItem> getAllCars() {
+ synchronized (this) {
+ if (allCars == null) {
+ allCars = new ArrayList<DemoInventoryItem>();
+ for (int k = 0; k <= 5; k++) {
+ try{
+ switch (k) {
+ case 0:
+ allCars.addAll(createCar("Chevrolet","Corvette", 5));
+ allCars.addAll(createCar("Chevrolet","Malibu", 8));
+ allCars.addAll(createCar("Chevrolet","S-10", 10));
+ allCars.addAll(createCar("Chevrolet","Tahoe", 6));
+ break;
+
+ case 1:
+ allCars.addAll(createCar("Ford","Taurus", 12));
+ allCars.addAll(createCar("Ford","Explorer", 11));
+ break;
+ case 2:
+ allCars.addAll(createCar("Nissan","Maxima", 9));
+ break;
+ case 3:
+ allCars.addAll(createCar("Toyota","4-Runner", 7));
+ allCars.addAll(createCar("Toyota","Camry", 15));
+ allCars.addAll(createCar("Toyota","Avalon", 13));
+ break;
+ case 4:
+ allCars.addAll(createCar("GMC","Sierra", 8));
+ allCars.addAll(createCar("GMC","Yukon", 10));
+ break;
+ case 5:
+ allCars.addAll(createCar("Infiniti","G35", 6));
+ break;
+ /*case 6:
+ allCars.addAll(createCar("UAZ","469", 6));
+ break;*/
+ default:
+ break;
+ }
+ }catch(Exception e){
+ System.out.println("!!!!!!loadAllCars Error: " + e.getMessage());
+ e.printStackTrace();
+ }
+ }
+ }
+ }
+ return allCars;
+ }
+
+ public List<DemoInventoryItem> getTenRandomCars() {
+ List<DemoInventoryItem> result = new ArrayList<DemoInventoryItem>();
+ int size = getAllCars().size()-1;
+ for (int i = 0; i < 10; i++) {
+ result.add(getAllCars().get(rand(1, size)));
+ }
+ return result;
+ }
+
+ public int genRand() {
+ return rand(1,10000);
+ }
+
+ public List <DemoInventoryItem> createCar(String make, String model, int count){
+
+ ArrayList <DemoInventoryItem> iiList = null;
+
+ try{
+ int arrayCount = count;
+
+ DemoInventoryItem[] demoInventoryItemArrays = new DemoInventoryItem[arrayCount];
+
+ for (int j = 0; j < demoInventoryItemArrays.length; j++){
+ DemoInventoryItem ii = new DemoInventoryItem();
+
+ ii.setMake(make);
+ ii.setModel(model);
+ ii.setStock(randomstring(6,7));
+ ii.setVin(randomstring(14,15));
+ ii.setMileage(new BigDecimal(rand(5000,80000)).setScale(DECIMALS, ROUNDING_MODE));
+ ii.setMileageMarket(new BigDecimal(rand(25000,45000)).setScale(DECIMALS, ROUNDING_MODE));
+ ii.setPrice(new Integer(rand(15000,55000)));
+ ii.setPriceMarket(new BigDecimal(rand(15000,55000)).setScale(DECIMALS, ROUNDING_MODE));
+ ii.setDaysLive(rand(1,90));
+ ii.setChangeSearches(new BigDecimal(rand(0,5)).setScale(DECIMALS, ROUNDING_MODE));
+ ii.setChangePrice(new BigDecimal(rand(0,5)).setScale(DECIMALS, ROUNDING_MODE));
+ ii.setExposure(new BigDecimal(rand(0,5)).setScale(DECIMALS, ROUNDING_MODE));
+ ii.setActivity(new BigDecimal(rand(0,5)).setScale(DECIMALS, ROUNDING_MODE));
+ ii.setPrinted(new BigDecimal(rand(0,5)).setScale(DECIMALS, ROUNDING_MODE));
+ ii.setInquiries(new BigDecimal(rand(0,5)).setScale(DECIMALS, ROUNDING_MODE));
+ demoInventoryItemArrays[j] = ii;
+
+ }
+
+ iiList = new ArrayList<DemoInventoryItem>(Arrays.asList(demoInventoryItemArrays));
+
+ }catch(Exception e){
+ System.out.println("!!!!!!createCategory Error: " + e.getMessage());
+ e.printStackTrace();
+ }
+ return iiList;
+ }
+
+ public static int rand(int lo, int hi)
+ {
+ Random rn2 = new Random();
+ //System.out.println("**" + lo);
+ //System.out.println("**" + hi);
+ int n = hi - lo + 1;
+ int i = rn2.nextInt() % n;
+ if (i < 0)
+ i = -i;
+ return lo + i;
+ }
+
+ public static String randomstring(int lo, int hi)
+ {
+ int n = rand(lo, hi);
+ byte b[] = new byte[n];
+ for (int i = 0; i < n; i++)
+ b[i] = (byte)rand('A', 'Z');
+ return new String(b);
+ }
+
+ public SimpleSelection getSelection() {
+ return selection;
+ }
+
+ public void setSelection(SimpleSelection selection) {
+ this.selection = selection;
+ }
+
+ public String takeSelection() {
+ getSelectedCars().clear();
+ if (getSelection().isSelectAll()){
+ getSelectedCars().addAll(allCars);
+ }else{
+ Iterator<Object> iterator = getSelection().getKeys();
+ while (iterator.hasNext()){
+ Object key = iterator.next();
+ table.setRowKey(key);
+ if (table.isRowAvailable()) {
+ getSelectedCars().add((DemoInventoryItem) table.getRowData());
+ }
+ }
+ }
+ return null;
+ }
+
+ public ArrayList<DemoInventoryItem> getSelectedCars() {
+ return selectedCars;
+ }
+
+ public void setSelectedCars(ArrayList<DemoInventoryItem> selectedCars) {
+ this.selectedCars = selectedCars;
+ }
+
+ public UIScrollableDataTable getTable() {
+ return table;
+ }
+
+ public void setTable(UIScrollableDataTable table) {
+ this.table = table;
+ }
+
+ public void initColumnsHeaders(){
+ columns.clear();
+ String header;
+ String footer="";
+ header = "Chevrolet";
+ Facet facet = new Facet(header ,footer);
+ columns.add(facet);
+ header = "Ford";
+ facet = new Facet(header ,footer);
+ columns.add(facet);
+ header = "Nissan";
+ facet = new Facet(header ,footer);
+ columns.add(facet);
+ header = "Toyota";
+ facet = new Facet(header ,footer);
+ columns.add(facet);
+ header = "GMC";
+ facet = new Facet(header ,footer);
+ columns.add(facet);
+ header = "Infiniti";
+ facet = new Facet(header ,footer);
+ columns.add(facet);
+ }
+
+ public ArrayList<DemoInventoryItem[]> getModel() {
+
+ ArrayList<DemoInventoryItem[]> model = new ArrayList<DemoInventoryItem[]>();
+ for (int i = 0; i < 9; i++) {
+ DemoInventoryItem[] items = new DemoInventoryItem[6];
+ items[0]=createCar("Chevrolet","Corvette", 1).get(0);
+ items[1]=createCar("Ford","Explorer", 1).get(0);
+ items[2]=createCar("Nissan","Maxima", 1).get(0);
+ items[3]=createCar("Toyota","Camry", 1).get(0);
+ items[4]=createCar("GMC","Yukon", 1).get(0);
+ items[5]=createCar("Infiniti","G35", 1).get(0);
+ model.add(items);
+ }
+ return model;
+ }
+
+ public ArrayList<Facet> getColumns() {
+ return columns;
+ }
+
+ public int getScrollerPage() {
+ return scrollerPage;
+ }
+
+ public void setScrollerPage(int scrollerPage) {
+ this.scrollerPage = scrollerPage;
+ }
+
+ public SortOrder getOrder() {
+ return order;
+ }
+
+ public void setOrder(SortOrder order) {
+ this.order = order;
+ }
+
+ public DemoInventoryItem getCurrentItem() {
+ return currentItem;
+ }
+
+ public void setCurrentItem(DemoInventoryItem currentItem) {
+ this.currentItem = currentItem;
+ }
+
+ public int getCurrentRow() {
+ return currentRow;
+ }
+
+ public void setCurrentRow(int currentRow) {
+ this.currentRow = currentRow;
+ }
+
+ public void store() {
+ allCars.set(currentRow, currentItem);
+ keys.clear();
+ keys.add(currentRow);
+ }
+
+ public void delete() {
+ allCars.remove(currentRow);
+ }
+
+ public Set<Integer> getKeys() {
+ return keys;
+ }
+
+ public void setKeys(Set<Integer> keys) {
+ this.keys = keys;
+ }
+
+}
Added: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/datatablescroller/Facet.java
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/datatablescroller/Facet.java (rev 0)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/java/org/richfaces/datatablescroller/Facet.java 2009-01-12 11:46:11 UTC (rev 12208)
@@ -0,0 +1,53 @@
+/*
+ * Facet.java Date created: 10.12.2007
+ * Last modified by: $Author$
+ * $Revision$ $Date$
+ */
+
+package org.richfaces.datatablescroller;
+
+/**
+ * TODO Class description goes here.
+ * @author "Andrey Markavtsov"
+ *
+ */
+public class Facet {
+ private String header;
+ private String footer;
+
+ /**
+ * TODO Description goes here.
+ * @param header
+ * @param footer
+ */
+ public Facet(String header, String footer) {
+ super();
+ this.header = header;
+ this.footer = footer;
+ }
+ /**
+ * @return the header
+ */
+ public String getHeader() {
+ return header;
+ }
+ /**
+ * @param header the header to set
+ */
+ public void setHeader(String header) {
+ this.header = header;
+ }
+ /**
+ * @return the footer
+ */
+ public String getFooter() {
+ return footer;
+ }
+ /**
+ * @param footer the footer to set
+ */
+ public void setFooter(String footer) {
+ this.footer = footer;
+ }
+
+}
Modified: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/WEB-INF/faces-config.xml
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/WEB-INF/faces-config.xml 2009-01-12 11:41:40 UTC (rev 12207)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/WEB-INF/faces-config.xml 2009-01-12 11:46:11 UTC (rev 12208)
@@ -3,8 +3,32 @@
"http://java.sun.com/dtd/web-facesconfig_1_1.dtd">
<faces-config>
<managed-bean>
- <managed-bean-name>bean</managed-bean-name>
- <managed-bean-class>org.richfaces.cdk.sandbox.Bean</managed-bean-class>
- <managed-bean-scope>request</managed-bean-scope>
+ <managed-bean-name>dataTableScrollerBean</managed-bean-name>
+ <managed-bean-class>org.richfaces.datatablescroller.DataTableScrollerBean</managed-bean-class>
+ <managed-bean-scope>session</managed-bean-scope>
</managed-bean>
+ <managed-bean>
+ <managed-bean-name>toolBar</managed-bean-name>
+ <managed-bean-class>org.richfaces.ToolBar</managed-bean-class>
+ <managed-bean-scope>session</managed-bean-scope>
+ </managed-bean>
+
+ <navigation-rule>
+ <from-view-id>/pages/oneMorePage.xhtml</from-view-id>
+ <navigation-case>
+ <from-outcome>main</from-outcome>
+ <to-view-id>/pages/index.xhtml</to-view-id>
+ </navigation-case>
+ </navigation-rule>
+ <navigation-rule>
+ <from-view-id>/pages/index.xhtml</from-view-id>
+ <navigation-case>
+ <from-outcome>onemorepage</from-outcome>
+ <to-view-id>/pages/oneMorePage.xhtml</to-view-id>
+ </navigation-case>
+ </navigation-rule>
+ <converter>
+ <converter-id>listShuttleconverter</converter-id>
+ <converter-class>org.richfaces.Converter</converter-class>
+ </converter>
</faces-config>
Modified: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/WEB-INF/web.xml
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/WEB-INF/web.xml 2009-01-12 11:41:40 UTC (rev 12207)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/WEB-INF/web.xml 2009-01-12 11:46:11 UTC (rev 12208)
@@ -10,8 +10,14 @@
<param-name>javax.faces.STATE_SAVING_METHOD</param-name>
<param-value>server</param-value>
</context-param>
- <!--
- -->
+ <context-param>
+ <param-name>org.ajax4jsf.VIEW_HANDLERS</param-name>
+ <param-value>com.sun.facelets.FaceletViewHandler</param-value>
+ </context-param>
+ <context-param>
+ <param-name>javax.faces.DEFAULT_SUFFIX</param-name>
+ <param-value>.xhtml</param-value>
+ </context-param>
<filter>
<display-name>Ajax4jsf Filter</display-name>
<filter-name>ajax4jsf</filter-name>
Modified: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/pages/index.xhtml
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/pages/index.xhtml 2009-01-12 11:41:40 UTC (rev 12207)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/pages/index.xhtml 2009-01-12 11:46:11 UTC (rev 12208)
@@ -3,10 +3,50 @@
xmlns:f="http://java.sun.com/jsf/core"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:ui="http://java.sun.com/jsf/facelets"
- xmlns:a4j="https://ajax4jsf.dev.java.net/ajax"
+ xmlns:a4j="http://richfaces.org/a4j"
+ xmlns:rich="http://richfaces.org/rich"
xmlns:c="http://java.sun.com/jsp/jstl/core"
>
<f:view>
-
+ <h:form>
+ <rich:datascroller align="left" for="carList" maxPages="20"
+ page="#{dataTableScrollerBean.scrollerPage}" reRender="sc2" id="sc1" />
+ <rich:spacer height="30" />
+ <rich:dataTable width="483" id="carList" rows="10" columnClasses="col"
+ value="#{dataTableScrollerBean.allCars}" var="category">
+ <f:facet name="header">
+ <rich:columnGroup>
+ <h:column>
+ <h:outputText styleClass="headerText" value="Make" />
+ </h:column>
+ <h:column>
+ <h:outputText styleClass="headerText" value="Model" />
+ </h:column>
+ <h:column>
+ <h:outputText styleClass="headerText" value="Price" />
+ </h:column>
+ <h:column>
+ <h:outputText styleClass="headerText" value="Mileage" />
+ </h:column>
+ </rich:columnGroup>
+ </f:facet>
+
+ <h:column>
+ <h:outputText value="#{category.make}" />
+ </h:column>
+ <h:column>
+ <h:outputText value="#{category.model}" />
+ </h:column>
+ <h:column>
+ <h:outputText value="#{category.price}" />
+ </h:column>
+ <h:column>
+ <h:outputText value="#{category.mileage}" />
+ </h:column>
+ </rich:dataTable>
+ <rich:datascroller align="left" for="carList" maxPages="20"
+ page="#{dataTableScrollerBean.scrollerPage}" id="sc2" reRender="sc1" />
+ <h:commandLink action="onemorepage">To the One More Pages</h:commandLink>
+ </h:form>
</f:view>
</html>
\ No newline at end of file
Added: trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/pages/oneMorePage.xhtml
===================================================================
--- trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/pages/oneMorePage.xhtml (rev 0)
+++ trunk/sandbox/samples/maven-rd-plugin-sample/src/main/webapp/pages/oneMorePage.xhtml 2009-01-12 11:46:11 UTC (rev 12208)
@@ -0,0 +1,44 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"
+ xmlns:f="http://java.sun.com/jsf/core"
+ xmlns:h="http://java.sun.com/jsf/html"
+ xmlns:ui="http://java.sun.com/jsf/facelets"
+ xmlns:a4j="http://richfaces.org/a4j"
+ xmlns:rich="http://richfaces.org/rich"
+ xmlns:c="http://java.sun.com/jstl/core"
+ >
+ <f:view>
+ <h:form>
+ <rich:toolBar id="toolBar" itemSeparator="line" height="28px">
+ <c:forEach items="#{toolBar.items}" var="item">
+ <h:panelGroup>
+ <h:graphicImage value="#{item.iconURI}" styleClass="pic" />
+ <h:outputLink value="#" style="color:#{a4jSkin.generalTextColor}; text-decoration:none;" >
+ <h:outputText value="#{item.label}" />
+ </h:outputLink>
+ </h:panelGroup>
+ </c:forEach>
+ </rich:toolBar>
+ <rich:spacer height="20" />
+ <rich:listShuttle sourceValue="#{toolBar.freeItems}"
+ targetValue="#{toolBar.items}" var="items" listHeight="300"
+ listWidth="300" sourceCaptionLabel="Available Items"
+ targetCaptionLabel="Currently Active Items"
+ converter="listShuttleconverter">
+
+ <rich:column width="18">
+ <h:graphicImage value="#{items.iconURI}"></h:graphicImage>
+ </rich:column>
+
+ <rich:column>
+ <h:outputText value="#{items.label}"></h:outputText>
+ </rich:column>
+
+ <a4j:support event="onlistchanged" reRender="toolBar" />
+ <a4j:support event="onorderchanged" reRender="toolBar" />
+
+ </rich:listShuttle>
+ <h:commandLink action="main"> To the Main page" </h:commandLink>
+ </h:form>
+ </f:view>
+</html>
\ No newline at end of file
16 years, 12 months
JBoss Rich Faces SVN: r12207 - in trunk/docs: realworld_app_guide and 8 other directories.
by richfaces-svn-commits@lists.jboss.org
Author: atsebro
Date: 2009-01-12 06:41:40 -0500 (Mon, 12 Jan 2009)
New Revision: 12207
Added:
trunk/docs/realworld_app_guide/
trunk/docs/realworld_app_guide/en/
trunk/docs/realworld_app_guide/en/pom.xml
trunk/docs/realworld_app_guide/en/src/
trunk/docs/realworld_app_guide/en/src/main/
trunk/docs/realworld_app_guide/en/src/main/docbook/
trunk/docs/realworld_app_guide/en/src/main/docbook/included/
trunk/docs/realworld_app_guide/en/src/main/docbook/included/actionparam.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/ajaxSingleFacets.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/binding.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/calendarDate.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/dataTableAjax.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/datascrollerFor.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/datascrollerPaired.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/explicitId.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/fileUploadListener.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/i18n.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/menuJSF.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/myfaces.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/resource.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/included/seamMultipartFilter.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/getting_started.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/intro.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/req.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/rw_itself.xml
trunk/docs/realworld_app_guide/en/src/main/docbook/modules/scope.xml
trunk/docs/realworld_app_guide/en/src/main/resources/
trunk/docs/realworld_app_guide/en/src/main/resources/images/
trunk/docs/realworld_app_guide/en/src/main/resources/images/rw_its_start.png
trunk/docs/realworld_app_guide/pom.xml
Log:
https://jira.jboss.org/jira/browse/RF-4494 - Tutorial about developing this Sample application
Added: trunk/docs/realworld_app_guide/en/pom.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/pom.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/pom.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -0,0 +1,42 @@
+<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">
+
+ <modelVersion>4.0.0</modelVersion>
+
+ <parent>
+ <groupId>org.richfaces.docs</groupId>
+ <artifactId>realworld</artifactId>
+ <version>3.3.0-SNAPSHOT</version>
+ <relativePath>../pom.xml</relativePath>
+ </parent>
+ <groupId>org.richfaces.docs.migration</groupId>
+ <artifactId>${translation}</artifactId>
+ <version>3.3.0-SNAPSHOT</version>
+ <packaging>jar</packaging>
+ <name>RichFaces Realworld application Guide (${translation})</name>
+
+ <properties>
+ <translation>en</translation>
+ </properties>
+ <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>
+ <version>1.0-beta-2</version>
+ </plugin>
+
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ <extensions>true</extensions>
+ </plugin>
+ </plugins>
+ </build>
+</project>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/actionparam.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/actionparam.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/actionparam.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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 <a4j:actionparam> on JSP page</title>
+ <section>
+ <title>Description</title>
+ <para>
+ As it has been mentioned above we'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><a4j:actionparam></property></emphasis> component setter is called after
+ <emphasis><property>"actionListener"</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</ulink>
+ </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</ulink>.
+ </para>
+ </section>
+
+ <section>
+ <title>Workarounds</title>
+ <para>
+ The solution is to use <emphasis role="bold"><property><a4j:actionParam></property></emphasis> before:
+ </para>
+ <programlisting role="XML"><![CDATA[...
+<f:actionListener binding="#{skin.binding}"/>
+...]]></programlisting>
+
+ </section>
+</section>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/ajaxSingleFacets.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/ajaxSingleFacets.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/ajaxSingleFacets.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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 <h:dataTable></title>
+ <section>
+ <title>Description</title>
+ <para>
+ The <property>RichFaces</property> components that have
+ <emphasis><property>"ajaxSingle"</property></emphasis> set to "true" does not work in
+ <emphasis><property>"header"</property></emphasis> or <emphasis><property>"footer"</property></emphasis> facets
+ of <emphasis role="bold"><property><h:dataTable></property></emphasis>, e.g.
+ <emphasis role="bold"><property><rich:datascroller></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</ulink>
+ </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><rich:datascroller></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">JavaServer Faces issues reporting</ulink> page.
+ </para>
+ </section>
+
+ <section>
+ <title>Workarounds</title>
+ <para>
+ The solution is to use <emphasis role="bold"><property><rich:dataTable></property></emphasis> component.
+ </para>
+ </section>
+</section>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/binding.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/binding.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/binding.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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>"binding"</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&op=viewtopic&p=4140368#...">RichFaces 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><classname>java.lang.String</classname></code> specified instead of <code><classname>javax.faces.component.UIComponent</classname></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>
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/calendarDate.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/calendarDate.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/calendarDate.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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><rich:calendar> and "ondateselected" event problem</title>
+ <section>
+ <title>Description</title>
+ <para>
+ The <emphasis role="bold"><property><rich:calendar></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>"ondateselected"</property></emphasis> gets fired when a date is selected but before it'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&op=viewtopic&t=132914">RichFaces Forum</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>How to reproduce</title>
+ <para>
+ The described above problem occurs when <emphasis role="bold"><property><a4j:support></property></emphasis>is put inside <emphasis role="bold"><property><rich:calendar></property></emphasis>.
+ If the <emphasis><property>"event"</property></emphasis> property is set to "ondateselected"
+ previous value of the <emphasis role="bold"><property><rich:calendar></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>"onchanged"</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>"ondateselected"</property></emphasis> event is fired after a date is selected in popup
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis><property>"ontimechanged"</property></emphasis> event is fired after new time is selected.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+</section>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/dataTableAjax.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/dataTableAjax.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/dataTableAjax.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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 <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><rich:outputPanel></property></emphasis> or <emphasis role="bold"><property><rich:messages></property></emphasis> components that should be updated.
+If there are no <emphasis role="bold"><property><rich:outputPanel></property></emphasis>, <emphasis role="bold"><property><rich:messages></property></emphasis> components inside the <emphasis role="bold"><property><rich:dataTable></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="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#...">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>
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/datascrollerFor.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/datascrollerFor.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/datascrollerFor.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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 "for" attribute in <rich:datascroller></title>
+ <section>
+ <title>Description</title>
+ <para>
+ The <emphasis><property>"for"</property></emphasis>attribute of <emphasis role="bold"><property><rich:datascroller></property></emphasis> component
+ doesn't allow EL expressions in 3.2.0.GA.
+ </para>
+ <para>
+ Custom tags exploiting the ability of the <emphasis role="bold"><property><rich:datascroller></property></emphasis> to have dynamic
+ <emphasis><property>"for"</property></emphasis> attribute doesn't work.
+ </para>
+ </section>
+ <section>
+ <title>Links</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <ulink url="http://jira.jboss.com/jira/browse/RF-2923">Jira</ulink>
+ </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</ulink>
+ </para>
+ </section>
+
+ <section>
+ <title>Workarounds</title>
+ <para>
+ None, so far.
+ </para>
+ </section>
+</section>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/datascrollerPaired.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/datascrollerPaired.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/datascrollerPaired.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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 <rich:datascroller> components do not work</title>
+ <section>
+ <title>Description</title>
+ <para>
+ Two <emphasis role="bold"><property><rich:datascroller></property></emphasis> components bound to the same table aren't synchronized.
+ Having two <emphasis role="bold"><property><rich:datascroller></property></emphasis>components on a page, session-scoped beans saves the data for only one <emphasis role="bold"><property><rich:datascroller></property></emphasis> component.
+ It is a common pattern to have 2 <emphasis role="bold"><property><rich:datascroller></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</ulink>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4141786#...">RichFaces Forum</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>How to reproduce</title>
+ <para>
+ The described above problem occurs if two <emphasis role="bold"><property><rich:datascroller></property></emphasis> components are added to any table.
+ </para>
+ </section>
+ <section>
+ <title>Causes</title>
+ <para>
+ The <emphasis role="bold"><property><rich:datascroller></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>"page"</property></emphasis> attribute and bind it to the same property for all
+ <emphasis role="bold"><property><rich:datascroller></property></emphasis> components.
+ </para>
+ </section>
+
+</section>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/explicitId.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/explicitId.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/explicitId.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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><h:form></property></emphasis>,
+ <emphasis role="bold"><property><f:subview></property></emphasis>,
+ <emphasis role="bold"><property><h:dataTable></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
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/fileUploadListener.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/fileUploadListener.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/fileUploadListener.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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 "fileUploadListener" with MyFaces or JSF-RI 1.2_04</title>
+ <section>
+ <title>Description</title>
+ <para>
+ The <emphasis><property>"fileUploadListener"</property></emphasis>(<emphasis><property>"UploadEvent"</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&op=viewtopic&t=132530&a...">RichFaces 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 "true", 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/ProjectDocumentList?folderI...">JSF-RI 1.2_07</ulink>
+ (last stable version) works.
+ </para>
+ </section>
+</section>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/i18n.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/i18n.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/i18n.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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</ulink>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4141302#...">RichFaces 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><rich:fileUpload></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
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/menuJSF.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/menuJSF.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/menuJSF.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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><rich:contextMenu></property></emphasis> component is not invoked by the right mouse click
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The <emphasis role="bold"><property><rich:dropDownMenu></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&op=viewtopic&p=4140689#...">RichFaces 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/ProjectDocumentList?folderI...">JSF-RI 1.2_09</ulink> or above
+ </para>
+ </section>
+
+</section>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/myfaces.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/myfaces.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/myfaces.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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&op=viewtopic&p=4141659#...">RichFaces 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/ProjectDocumentList?folderI...">JSF-RI 1.2_07</ulink>
+ fixes the problem (see forum post)
+ </para>
+ </section>
+</section>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/resource.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/resource.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/resource.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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>"Resource not registered : org.richfaces.renderkit.html.images.InputBackgroundImage"</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&op=viewtopic&p=4140846#...">RichFaces 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">META-INF/resources-config.xml</ulink> to the application classpath.
+</para>
+ </section>
+
+</section>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/included/seamMultipartFilter.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/included/seamMultipartFilter.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/included/seamMultipartFilter.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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><rich:fileUpload> with Seam multi-part filter</title>
+ <section>
+ <title>Description</title>
+ <para>
+ The <emphasis role="bold"><property><rich:fileUpload></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&op=viewtopic&p=4141587#...">RichFaces Forum</ulink>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>How to reproduce</title>
+ <para>
+ The problem occurs if you use the <emphasis role="bold"><property><rich:fileUpload></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
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/master.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
+"http://www.oasis-open.org/docbook/xml/4.3CR3/docbookx.dtd" [
+ <!ENTITY intro SYSTEM "modules/intro.xml">
+ <!ENTITY getting_started SYSTEM "modules/getting_started.xml">
+ <!ENTITY rw_itself SYSTEM "modules/rw_itself.xml">
+
+
+]>
+
+<book>
+ <bookinfo>
+ <title>RichFaces Real World Application Guide</title>
+
+ <author>
+ <firstname>Alex</firstname>
+ <surname>Tsebro</surname>
+ <email>atsebro(a)exadel.com</email>
+ </author>
+ <copyright>
+ <year>2009</year>
+ <holder>Red Hat</holder>
+ </copyright>
+
+ <abstract>
+ <title/>
+ <para>
+ <ulink url="http://www.jboss.org/file-access/default/members/jbossrichfaces/freezone/...">PDF version</ulink>
+ </para>
+ </abstract>
+
+ </bookinfo>
+ <toc/>
+ &intro;
+ &getting_started;
+ &rw_itself;
+
+
+</book>
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/modules/getting_started.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/modules/getting_started.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/modules/getting_started.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="Getting_started_with_RW" xreflabel="Getting_started_with_RW">
+ <?dbhtml filename="RichFacesMigrationIssues31to32.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>RichFaces</keyword>
+
+ </keywordset>
+ </chapterinfo>
+ <title>Getting started</title>
+
+ <section>
+ <title>Environment configuration</title>
+ <para>
+ The working version of the application is available online(?).
+ Those who wish to rimmage and touch the source code form inside can dowload the project from repository and deploy it locally.
+ Following should be installed and configured to start working with project source:
+ </para>
+
+ <itemizedlist>
+ <listitem><para>JDK 1.5 and higher</para></listitem>
+ <listitem><para>Maven 2.0.9</para></listitem>
+ <listitem><para>JBDS (or Eclipse)</para></listitem>
+ <listitem><para>JBoss Server 4.2.3</para></listitem>
+ <listitem><para>SVN client </para></listitem>
+ <listitem><para>Browser</para></listitem>
+ </itemizedlist>
+ </section>
+
+ <section>
+ <title>Installation</title>
+ <para>Do the following steps for downloading and installing the Real World demo.</para>
+
+ <itemizedlist>
+ <listitem><para><literallayout><emphasis>Checkout the project using installed SVN client</emphasis>.
+ URL of repository: <code>https://svn.jboss.org/repos/richfaces/trunk/test-applications/realworld/</code></literallayout></para></listitem>.
+ <listitem><para><emphasis>Build the project</emphasis>. Open command line, point to the folder with checkouted project and tell Maven: <code>mvn clean install eclipse:eclipseMaven 2.0.9</code>.</para></listitem>
+ <listitem><para><emphasis>Import the project into your IDE</emphasis>. Steps to do for JBDS users: click <code>File</code> -> <code>Import</code> and select <code>Existing project into Workspace</code> as import source; in <code>Import Project</code> window click <code>Browse</code> button and point to the realworld project folder; сlick <code>OK</code>. Three SNAPSHOTS (ear, ejb, web) should appear in <code>Projects</code> area. Checkmark them all and click <code>Finish</code>. These projects should appear in JBDS <code>Package Explorer</code> window.</para></listitem>
+ <listitem><para><emphasis>Register the pass to project images</emphasis>. Open project <code>web.xml</code> file (<code>realworld-web-1.0-SNAPSHOT\src\main\webapp\WEB-INF\web.xml</code>) and change <code>uploadRoot</code> parameter value from <code>E:\Andrey\Upload\</code> to yours e.g. <code>D:\realworld\Upload\</code>.</para></listitem>
+ <listitem><para><emphasis>Run realworld-ear-1.0-SNAPSHOT</emphasis> on the <code>JBoss 4.2. Server</code> under 3 Runtime (those who prefer manual job ^) should deploy and start realqorld.ear file).</para></listitem>
+ <listitem><para>Browse to <code>http:/localhost:8080/realworld</code>.</para></listitem>
+ </itemizedlist>
+
+
+
+ </section>
+
+
+
+
+
+</chapter>
\ No newline at end of file
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/modules/intro.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/modules/intro.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/modules/intro.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="introduction" xreflabel="introduction">
+ <?dbhtml filename="intro.html"?>
+
+ <title>Introduction</title>
+ <para>
+ The <emphasis>RichFaces Real World Application</emphasis> — the working name is "<emphasis role="bold">Photo Album</emphasis>" — is created to imaginate the way,
+ the web applications designed and developed with <property>RichFaces</property> could look and behave.
+ </para>
+ <para>
+ The RichFaces are evolved from <emphasis>Ajax4JSF</emphasis> framework (merge of Ajax and JavaServer Faces technologies) and
+ represent a framework and library of <emphasis>Ajax-capable UI components for JSF framework</emphasis>.
+ Amongst the wide range of similar libraries the RichFaces has set of benefits that is fully described in
+ the <ulink url="http://www.jboss.org/file-access/default/members/jbossrichfaces/freezone/...">Introduction to the RichFaces</ulink>.
+ The "Photo Album" covers some of the most important of them and demonstrates:
+ </para>
+
+ <itemizedlist>
+ <listitem><para><emphasis>wide variety of UI components</emphasis>, which provides Lego-like way of building user interfaces for web applications;</para></listitem>
+ <listitem><para><emphasis>built-in Ajax capability</emphasis>, which offers both component-wide and a lot more flexible page-wide Ajax support;</para></listitem>
+ <listitem><para><emphasis>highly customizable look-and-feel</emphasis> (the RichFaces have special feature called
+ "<ulink url="http://www.jboss.org/file-access/default/members/jbossrichfaces/freezone/...">Skinnability</ulink>").</para></listitem>
+ </itemizedlist>
+</chapter>
+
+
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/modules/req.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/modules/req.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/modules/req.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="rw_itself" xreflabel="rw_itself">
+ <?dbhtml filename="requirements.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>RichFaces</keyword>
+
+ </keywordset>
+ </chapterinfo>
+
+ <title>The Real World as it is</title>
+ <para>
+
+ </para>
+
+</chapter>
+
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/modules/rw_itself.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/modules/rw_itself.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/modules/rw_itself.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -0,0 +1,156 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="rw_itself" xreflabel="rw_itself">
+ <?dbhtml filename="requirements.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>RichFaces</keyword>
+
+ </keywordset>
+ </chapterinfo>
+
+ <title>The Real World as it is</title>
+ <para>The "Photo Album" is a desktop-like online photo manager that provides social service with pictures uploading, preview, storage, management and sharing features.
+It allows to create own albums, upload photos there, share the albums with other users, search albums.
+For newcomers the system allows "Anonymous regime" that may be used to search and view others albums, but no personal albums, no possibility to mark favorite photos and friends albums are available.
+ </para>
+
+ <section>
+ <title>Used components</title>
+
+ <para>Below there is a list of components used in "Photo album".</para>
+ <table>
+ <title>Components used in "Photo album"</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Value</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>a4j:commandLink</entry>
+ <entry>The component is very similar to the <h:commandLink> component, the only difference is that an Ajax form submit is generated on a click and it allows dynamic rerendering after a response comes back. It's not necessary to plug any support into the component, as Ajax support is already built in.</entry>
+ </row>
+ <row>
+ <entry>a4j:commandButton</entry>
+ <entry>The component is very similar to the <h:commandButton> component, the only difference is that an Ajax form submit is generated on a click and it allows dynamic rerendering after a response comes back. It's not necessary to plug any support into the component, as Ajax support is already built in.</entry>
+ </row>
+ <row>
+ <entry>a4j:push</entry>
+ <entry>The component periodically perform Ajax request to server, to simulate 'push' data.</entry>
+ </row>
+ <row>
+ <entry>a4J:poll</entry>
+ <entry>The component allows periodical sending of Ajax requests to a server and is used for a page updating according to a specified time interval.</entry>
+ </row>
+ <row>
+ <entry>rich:calendar</entry>
+ <entry>The component is used for creating monthly calendar elements on a page.</entry>
+ </row>
+ <row>
+ <entry>rich:contextMenu</entry>
+ <entry>The component is used for creation multileveled context menus that are activated after a user defines an event ("onmouseover", "onclick", etc.) on any element on the page.</entry>
+ </row>
+ <row>
+ <entry>rich:dataGrid</entry>
+ <entry>The component to render data as a grid that allows choosing data from a model and obtains built-in support of Ajax updates.</entry>
+ </row>
+ <row>
+ <entry>rich:datascroller</entry>
+ <entry>The component designed for providing the functionality of tables scrolling using Ajax requests.</entry>
+ </row>
+ <row>
+ <entry>rich:fileUpload</entry>
+ <entry>The component designed to perform Ajax-ed files upload to server.</entry>
+ </row>
+ <row>
+ <entry>rich:inplaceInput</entry>
+ <entry>The component is an input component used for displaying and editing data inputted. </entry>
+ </row>
+ <row>
+ <entry>rich:inplaceSelect</entry>
+ <entry>The component is used for creation select based inputs: it shows the value as text in one state and enables editing the value, providing a list of options in another state.</entry>
+ </row>
+ <row>
+ <entry>rich:mediaOutput</entry>
+ <entry>The component implements one of the basic features specified in the framework. The component is a facility for generating images, video, sounds and other binary resources defined by you on-the-fly.</entry>
+ </row>
+ <row>
+ <entry>rich:modalPanel</entry>
+ <entry>The component implements a modal dialog window. All operations in the main application window are locked out while this window is active. Opening and closing the window is done through client JavaScript code.</entry>
+ </row>
+ <row>
+ <entry>rich:progressBar</entry>
+ <entry>The component is designed for displaying a progress bar which shows the current status of the process. </entry>
+ </row>
+ <row>
+ <entry>rich:tree</entry>
+ <entry>The component is designed for hierarchical data presentation and is applied for building a tree structure with a drag-and-drop capability. The component also uses built-in drag and drop.</entry>
+ </row>
+
+
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+
+ <section>
+ <title>Main views</title>
+ <para>The following section contains some most importants screenshots provided with additional comments.
+ </para>
+ <para>Starting page of the "Photo album" contains some basic information about RichFaces an log-in fields:
+ </para>
+ <figure>
+ <title>"Photo album" start page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/rw_its_start.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Three users where created for test purposes. Their names, passes and albums are listed in the table below:</para>
+ <table>
+ <title>Components used in "Photo album"</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Pass</entry>
+ <entry>Albums</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>amarkhel</entry>
+ <entry>12345</entry>
+ <entry>Cars, Tetki</entry>
+ </row>
+ <row>
+ <entry>root</entry>
+ <entry>12345</entry>
+ <entry>Football</entry>
+ </row>
+ <row>
+ <entry>qqqq</entry>
+ <entry>12345</entry>
+ <entry>Japan, Music</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <para>After loging in the user gets to his personal page. The interface of the "cabinet" consists of menu bar, albums panels and working area.
+ </para>
+
+
+
+ </section>
+
+
+
+
+
+
+</chapter>
+
Added: trunk/docs/realworld_app_guide/en/src/main/docbook/modules/scope.xml
===================================================================
--- trunk/docs/realworld_app_guide/en/src/main/docbook/modules/scope.xml (rev 0)
+++ trunk/docs/realworld_app_guide/en/src/main/docbook/modules/scope.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -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 <ulink url="http://www.jboss.org/jbossrichfaces/docs/index.html">here</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>
Added: trunk/docs/realworld_app_guide/en/src/main/resources/images/rw_its_start.png
===================================================================
(Binary files differ)
Property changes on: trunk/docs/realworld_app_guide/en/src/main/resources/images/rw_its_start.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/docs/realworld_app_guide/pom.xml
===================================================================
--- trunk/docs/realworld_app_guide/pom.xml (rev 0)
+++ trunk/docs/realworld_app_guide/pom.xml 2009-01-12 11:41:40 UTC (rev 12207)
@@ -0,0 +1,184 @@
+<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>
+ <artifactId>docs</artifactId>
+ <groupId>org.richfaces</groupId>
+ <version>3.3.0-SNAPSHOT</version>
+ </parent>
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>org.richfaces.docs</groupId>
+ <artifactId>realworld</artifactId>
+ <packaging>pom</packaging>
+ <version>3.3.0-SNAPSHOT</version>
+ <name>RichFaces Realworld application 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>
+ <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>
+ ${project.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-SNAPSHOT</version>
+ </dependency>
+ <dependency>
+ <groupId>org.jboss</groupId>
+ <artifactId>jbossorg-jdocbook-style</artifactId>
+ <version>1.1.0-SNAPSHOT</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>
+ </dependencies>
+ <configuration>
+ <sourceDirectory>
+ ${basedir}/src/main/docbook
+ </sourceDirectory>
+ <imageResource>
+ <directory>
+ ${basedir}/src/main/resources
+ </directory>
+ </imageResource>
+ <cssResource>
+ <directory>
+ ${project.build.directory}/common-resources
+ </directory>
+ </cssResource>
+ <sourceDocumentName>master.xml</sourceDocumentName>
+ <formats>
+ <format>
+ <formatName>pdf</formatName>
+ <stylesheetResource>classpath:/xslt/org/jboss/pdf.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>
+ <properties>
+ <masterTranslation>en</masterTranslation>
+ </properties>
+
+ <modules>
+ <module>en</module>
+ </modules>
+
+</project>
\ No newline at end of file
16 years, 12 months
JBoss Rich Faces SVN: r12206 - trunk/docs/userguide/en/src/main/docbook/modules.
by richfaces-svn-commits@lists.jboss.org
Author: msorokin
Date: 2009-01-12 05:55:26 -0500 (Mon, 12 Jan 2009)
New Revision: 12206
Modified:
trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml
Log:
https://jira.jboss.org/jira/browse/RF-398
Corrected a mistake
Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2009-01-12 10:27:37 UTC (rev 12205)
+++ trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2009-01-12 10:55:26 UTC (rev 12206)
@@ -1945,7 +1945,7 @@
</itemizedlist>
</section>
<section id="BiuldInSkinnability">
- <title>Built-in skinnability in RichFaces</title>
+ <title>Built-in Skinnability in RichFaces</title>
<para> RichFaces gives an opportunity to incorporate <property>skinnability</property>
into UI design. With this framework you can easily use named skin parameters in
properties files to control the appearance of the skins that are applied
@@ -3057,7 +3057,7 @@
</section>
</section>
<section>
- <title>Client-side script for extended skinning support</title>
+ <title>Client-side Script for Extended Skinning Support</title>
<para>As it was mentioned earlier in the guide, extended skinning of standard HTML
controls is applied automatically: the browser type is detected and if a browser
doesn't fully support extended skinning feature, only basic skinning is
@@ -3106,7 +3106,7 @@
<link href='/ YOUR_PROJECT_NAME /a4j_3_2_2-SNAPSHOT/org/richfaces/skin.xcss/DATB/eAF7sqpgb-jyGdIAFrMEaw__.jsf' type='text/css' rel='stylesheet' class='component' />
]]></programlisting>
<note>
- <para> Now necessary to use resources prefix <code>a4j/versionXXX</code> instead of
+ <para> Now it's necessary to use <code>a4j/versionXXX</code> resources prefix instead of
<code>a4j_versionXXX</code>. Base64 encoder changed to use
'<code>!</code>' instead of '<code>.</code>'. </para>
</note>
@@ -3172,8 +3172,8 @@
<section id="PlugnSkin" role="new">
<?dbhtml filename="PlugnSkin.html"?>
<title>Plug-n-Skin</title>
- <para> Plug-n-Skin is a feature that gives a developer an opportunity to easily create,
- customize and plug into a project a custom skin. The skin can be created basing on
+ <para> Plug-n-Skin is a feature that gives you an opportunity to easily create,
+ customize and plug into your project a custom skin. The skin can be created basing on
parameters of some predefined RichFaces skin. </para>
<para> The feature also provides an option to unify the appearance of rich controls with
standard HTML elements. </para>
@@ -3198,21 +3198,21 @@
<itemizedlist>
<listitem>
<para>
- <code>DarchetypeVersion</code> indicates the RichFaces version. For example,
+ <code>-DarchetypeVersion</code> indicates the RichFaces version. For example,
<code>"3.3.0-SNAPSHOT"</code>
</para>
</listitem>
<listitem>
<para>
- <code>DartifactId</code> artifact id of the project </para>
+ <code>-DartifactId</code> artifact id of the project </para>
</listitem>
<listitem>
<para>
- <code>DgroupId</code> group id of the project </para>
+ <code>-DgroupId</code> group id of the project </para>
</listitem>
<listitem>
<para>
- <code>Dversion</code> the version of the project you create, by default it
+ <code>-Dversion</code> the version of the project you create, by default it
is <code>"1.0.-SNAPSHOT"</code>
</para>
</listitem>
@@ -3231,11 +3231,11 @@
<itemizedlist>
<listitem>
<para>
- <code>Dname</code> defines the name of the new skin </para>
+ <code>-Dname</code> defines the name of the new skin </para>
</listitem>
<listitem>
<para>
- <code>Dpackage</code> base package of the skin. By default
+ <code>-Dpackage</code> base package of the skin. By default
"groupId" of the project is used. </para>
</listitem>
</itemizedlist>
@@ -3243,11 +3243,11 @@
<itemizedlist>
<listitem>
<para>
- <code>DbaseSkin</code> defines the name of the base skin. </para>
+ <code>-DbaseSkin</code> defines the name of the base skin. </para>
</listitem>
<listitem>
<para>
- <code>DcreateExt</code> if set to "true", extended CSS classes are
+ <code>-DcreateExt</code> if set to "true", extended CSS classes are
added. For more information, please, see <link linkend="StControlsSkinning">
"Standard controls skinning"
</link>
16 years, 12 months
JBoss Rich Faces SVN: r12205 - trunk/docs/userguide/en/src/main/docbook/modules.
by richfaces-svn-commits@lists.jboss.org
Author: msorokin
Date: 2009-01-12 05:27:37 -0500 (Mon, 12 Jan 2009)
New Revision: 12205
Modified:
trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml
Log:
https://jira.jboss.org/jira/browse/RF-398
Corrected a mistake
Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2009-01-12 08:50:21 UTC (rev 12204)
+++ trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2009-01-12 10:27:37 UTC (rev 12205)
@@ -683,8 +683,41 @@
</section>
-
+ <section>
+ <title>JavaScript API</title>
+ <table>
+ <title>JavaScript API</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Function</entry>
+ <entry>Description</entry>
+
+ </row>
+ </thead>
+ <tbody>
+ <!--Sorting API -->
+ <row>
+ <entry>getSize()</entry>
+ <entry>Returns the current size to the queue</entry>
+
+ </row>
+ <row>
+ <entry>getMaximumSize()</entry>
+ <entry>Returns the maximum size to the queue, specified in the "size" attribute</entry>
+
+ </row>
+
+
+
+
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+
+
</section>
@@ -1981,7 +2014,7 @@
</simplelist>
</section>
<section id="StControlsSkinning">
- <title>Standard controls skinning</title>
+ <title>Standard Controls Skinning</title>
<para> The feature is designed to unify the look and feel of standard HTML element and
RichFaces components. Skinning can be applied to all controls on a page basing on
elements' name and attribute type (where applicable). Also this feature
@@ -3029,15 +3062,15 @@
controls is applied automatically: the browser type is detected and if a browser
doesn't fully support extended skinning feature, only basic skinning is
applied. </para>
- <para> However, if a develop doesn't want to the rich components and standard HTML
+ <para> However, if you don't want the RichFaces components and standard HTML
controls to be skinned automatically and perform the skinnability implementation
- himself, he might encounter with a problem, i.e. standard HTML controls in such
- browsers as Opera and Safari are affected by standard controls skinning featured. (
+ yourself, you might encounter with a problem, namely standard HTML controls in such
+ browsers as Opera and Safari will affected by standard controls skinning featured. (
<link linkend="ScriptsandStylesLoadStrategy">Here</link> you can get more
details on how to disable skinnability.) </para>
<para> In brief, to disable the skinnability mechanism of RichFaces you need to set the
- "org.richfaces.LoadStyleStrategy" parameter to "NONE" in
- web.xml. </para>
+ "org.richfaces.LoadStyleStrategy" parameter to "NONE" in the
+ <code>web.xml</code> file. </para>
<programlisting role="XML"><![CDATA[...
<context-param>
<param-name>org.richfaces.LoadStyleStrategy</param-name>
@@ -3046,9 +3079,9 @@
...
]]></programlisting>
<para> Additionally, you should include the style sheets that perform skinning of the
- rich component and standard HTML controls. </para>
+ RichFaces component and standard HTML controls. </para>
<para> In order to resolve the problem with extended skinning in Opera and Safari a
- client script (skinning.js) is added to the RichFaces library. The script detects
+ client script (<code>skinning.js</code>) is added to the RichFaces library. The script detects
the browser type and enables extended skinning only for those browsers that fully
support it. </para>
<para> The script can be activated by inserting this JavaScript code to the page: </para>
@@ -3079,7 +3112,7 @@
</note>
</section>
<section id="XCSSfileformat">
- <title>XCSS file format</title>
+ <title>XCSS File Format</title>
<para> XCSS files are the core of RichFaces components skinnability. </para>
<para> XCSS is an XML formatted CSS that adds extra functionality to the skinning
process </para>
16 years, 12 months
JBoss Rich Faces SVN: r12204 - trunk/docs/userguide/en/src/main/docbook/modules.
by richfaces-svn-commits@lists.jboss.org
Author: msorokin
Date: 2009-01-12 03:50:21 -0500 (Mon, 12 Jan 2009)
New Revision: 12204
Modified:
trunk/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml
Log:
https://jira.jboss.org/jira/browse/RF-398
Corrected a mistake
Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml 2009-01-12 03:32:41 UTC (rev 12203)
+++ trunk/docs/userguide/en/src/main/docbook/modules/RFCGettingStarted.xml 2009-01-12 08:50:21 UTC (rev 12204)
@@ -55,7 +55,7 @@
<para>Go to the folder with unzipped earlier RichFaces binary files
and open <code>lib</code> folder. This folder contains three
<code>*.jar</code> files with API, UI and
- implementation libraries. Copy that "jars" from
+ implementation libraries. Copy that "jars" from
<code>lib</code> folder to <code>WEB-INF/lib</code> folder
of "Greeter" JSF application. </para>
</section>
@@ -270,6 +270,7 @@
Following links might be useful for those who already use this IDE and RichFaces for developing applications and those who wish to improve their development process:</para>
<itemizedlist>
<listitem>
+
<para>"<ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/GettingStartedGuide/...">Rich Components</ulink>" chapter
in "Getting Started with JBoss Developer Studio Guide" describes how to add RichFaces components into a CRUD application;
</para>
16 years, 12 months
JBoss Rich Faces SVN: r12203 - trunk/docs/userguide/en/src/main/docbook/included.
by richfaces-svn-commits@lists.jboss.org
Author: cluts
Date: 2009-01-11 22:32:41 -0500 (Sun, 11 Jan 2009)
New Revision: 12203
Modified:
trunk/docs/userguide/en/src/main/docbook/included/orderingList.xml
Log:
RF-5242 - the information has been updated
Modified: trunk/docs/userguide/en/src/main/docbook/included/orderingList.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/orderingList.xml 2009-01-12 03:29:43 UTC (rev 12202)
+++ trunk/docs/userguide/en/src/main/docbook/included/orderingList.xml 2009-01-12 03:32:41 UTC (rev 12203)
@@ -103,7 +103,8 @@
<para>
Currently the button controls type is based on <emphasis role="bold"><property><div></property></emphasis> element.
</para>
- </note>
+ </note>
+ <para>The information about the <emphasis><property>"converter"</property></emphasis> attribute is <link linkend="conv">here</link>.</para>
<para> The <emphasis>
<property>"selection" </property>
</emphasis> attribute stores the collection of items selected by you. In the example
16 years, 12 months
JBoss Rich Faces SVN: r12202 - trunk/docs/userguide/en/src/main/docbook/included.
by richfaces-svn-commits@lists.jboss.org
Author: cluts
Date: 2009-01-11 22:29:43 -0500 (Sun, 11 Jan 2009)
New Revision: 12202
Modified:
trunk/docs/userguide/en/src/main/docbook/included/listShuttle.xml
Log:
RF-5394 - added the necessary information about this limitation
RF-5242 - the information has been updated
Modified: trunk/docs/userguide/en/src/main/docbook/included/listShuttle.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/listShuttle.xml 2009-01-12 03:20:30 UTC (rev 12201)
+++ trunk/docs/userguide/en/src/main/docbook/included/listShuttle.xml 2009-01-12 03:29:43 UTC (rev 12202)
@@ -47,6 +47,10 @@
performs moving items between lists</para></listitem>
</itemizedlist>
</para>
+ <note>
+ <title>Note:</title>
+ <para>Now the listener can not be called from the column facet. This is a temporary limitation. The additional information is <ulink url="https://jira.jboss.org/jira/browse/RF-5327">here</ulink>.</para>
+ </note>
<para> The <emphasis>
<property>"sourceValue" </property>
</emphasis> attribute defines a List or Array of items to be shown in the source list.</para>
@@ -106,11 +110,10 @@
</emphasis> attribute is used to convert component data to a particular component's value.
For example, when you select items in a list, a converter is used to format a set of objects to a strings to be displayed.
</para>
- <note>
+ <note id="conv">
<para>
- It is necessary to override the <emphasis>
- <property>"equals"</property></emphasis> and <emphasis>
- <property>"hashCode"</property></emphasis> methods in your own class!
+ The <emphasis><property>"converter"</property></emphasis> attribute and the <emphasis><property>"equals"</property></emphasis> and <emphasis>
+ <property>"hashCode"</property></emphasis> methods should be defined only in your own class.
</para>
</note>
<para>
16 years, 12 months
JBoss Rich Faces SVN: r12201 - trunk/docs/userguide/en/src/main/docbook/included.
by richfaces-svn-commits@lists.jboss.org
Author: cluts
Date: 2009-01-11 22:20:30 -0500 (Sun, 11 Jan 2009)
New Revision: 12201
Modified:
trunk/docs/userguide/en/src/main/docbook/included/column.xml
Log:
RF-5448 - the information about usage the attribute has been updated.
Modified: trunk/docs/userguide/en/src/main/docbook/included/column.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/column.xml 2009-01-10 16:10:09 UTC (rev 12200)
+++ trunk/docs/userguide/en/src/main/docbook/included/column.xml 2009-01-12 03:20:30 UTC (rev 12201)
@@ -411,7 +411,7 @@
<para><emphasis>
<property>"sortExpression"</property>
</emphasis> attribute defines a bean property which is used
- for sorting of a column.</para>
+ for sorting of a column. This attribute can be used only with the <emphasis role="bold"><property><rich:scrollableDataTable></property></emphasis> component.</para>
</section>
<section id="filter">
16 years, 12 months