Tapstry3之Table组件全攻略

这是T3版本下Table组件的使用例程。代码是国外大师级人物所写，现在把源代码整理出来：

如下图所示建立工程：

所需jar包一览如下：

bsf-2.3.0.jar
commons-beanutils-1.6.1.jar
commons-codec-1.2.jar
commons-collections-2.1.jar
commons-digester-1.5.jar
commons-fileupload-1.0.jar
commons-lang-1.0.jar
commons-logging-1.0.2.jar
jakarta-oro-2.0.6.jar
javassist-2.5.1.jar
ognl-2.6.3.jar
tapestry-3.0.1.jar
tapestry-contrib-3.0.1.jar

 

代码如下：

BirthDateComparator.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package datasource;
10. import java.util.Comparator;
11. /**
12.  * This is a very hokey and error prone comparator cobbled together
13.  * to demonstrate a point.  Don't use this in production.
14.  */
15. public class BirthDateComparator implements Comparator 
16. {
17.     // This comparator is designed to compare two
18.     // MM/DD/YYYY formatted Strings
19.     public int compare(Object o1, Object o2)
20.     {
21.         // return -1 if o1 < o2
22.         // return 0 if o1 == o2
23.         // return 1 if o1 > o2
24.         String month1 = "01";
25.         String day1 = "01";
26.         String year1 = "1900";
27.         if (o1 instanceof String) {
28.             String birthDate1 = (String) o1 ;
29.             //extract the month, date and year
30.             month1 = birthDate1.substring(0,2);
31.             day1 = birthDate1.substring(3,5);
32.             year1 = birthDate1.substring(6,10);
33.         }
35.         String month2 = "01";
36.         String day2 = "01";
37.         String year2 = "1900";
38.         if (o2 instanceof String) {
39.             String birthDate2 = (String) o2 ;
40.             //extract the month, date and year
41.             month2 = birthDate2.substring(0,2);
42.             day2 = birthDate2.substring(3,5);
43.             year2 = birthDate2.substring(6,10);
44.         }
45.         //System.out.println("month1 = " + month1 + " day1 = " + day1 + " year1 = " + year1);
46.         //System.out.println("month2 = " + month2 + " day2 = " + day2 + " year2 = " + year2);
47.         
48.         int yearCompare = year1.compareTo(year2);
49.         if(yearCompare !=0) {
50.             return yearCompare;
51.         }
52.         else {
53.             int monthCompare = month1.compareTo(month2);
54.             if(monthCompare !=0) {
55.                 return monthCompare;
56.             }
57.             else
58.             {
59.                 return day1.compareTo(day2);
60.                 
61.             }
62.         }
63.         
64.     }
65. }

DataItem.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package datasource;
10. import java.io.Serializable;
12. /**
13.  */
14. public class DataItem implements Serializable 
15. {
17.     String SSN;
18.     String FirstName;
19.     String LastName;
20.     String BirthDate;
21.     String Height;
22.     String Weight;
23.     
24.     boolean Selected;
25.     
26.     /**
27.      * @param ssn
28.      * @param firstName
29.      * @param lastName
30.      * @param birthDate
31.      * @param height
32.      * @param weight
33.      */
34.     public DataItem(String ssn, String firstName, String lastName,
35.             String birthDate, String height, String weight) {
36.         super();
37.         SSN = ssn;
38.         FirstName = firstName;
39.         LastName = lastName;
40.         BirthDate = birthDate;
41.         Height = height;
42.         Weight = weight;
43.         Selected = false;
44.     }
45.     
46.     public DataItem()
47.     {
48.         SSN = "ssn";
49.         FirstName = "firstName";
50.         LastName = "lastName";
51.         BirthDate = "birthDate";
52.         Height = "height";
53.         Weight = "100";
54.     }
55.     
56.     
57.     /**
58.      * @return Returns the birthDate.
59.      */
60.     public String getBirthDate() {
61.         return BirthDate;
62.     }
63.     /**
64.      * @param birthDate The birthDate to set.
65.      */
66.     public void setBirthDate(String birthDate) {
67.         BirthDate = birthDate;
68.     }
69.     /**
70.      * @return Returns the firstName.
71.      */
72.     public String getFirstName() {
73.         return FirstName;
74.     }
75.     /**
76.      * @param firstName The firstName to set.
77.      */
78.     public void setFirstName(String firstName) {
79.         FirstName = firstName;
80.     }
81.     /**
82.      * @return Returns the height.
83.      */
84.     public String getHeight() {
85.         return Height;
86.     }
87.     /**
88.      * @param height The height to set.
89.      */
90.     public void setHeight(String height) {
91.         Height = height;
92.     }
93.     /**
94.      * @return Returns the lastName.
95.      */
96.     public String getLastName() {
97.         return LastName;
98.     }
99.     /**
100.      * @param lastName The lastName to set.
101.      */
102.     public void setLastName(String lastName) {
103.         LastName = lastName;
104.     }
105.     /**
106.      * @return Returns the sSN.
107.      */
108.     public String getSSN() {
109.         return SSN;
110.     }
111.     /**
112.      * @param ssn The sSN to set.
113.      */
114.     public void setSSN(String ssn) {
115.         SSN = ssn;
116.     }
117.     /**
118.      * @return Returns the weight.
119.      */
120.     public String getWeight() {
121.         return Weight;
122.     }
123.     /**
124.      * @param weight The weight to set.
125.      */
126.     public void setWeight(String weight) {
127.         Weight = weight;
128.     }
130.     /**
131.      * @return Returns the birthDate.
132.      */
133.     public boolean getSelected() {
134.         return Selected;
135.     }
136.     /**
137.      * @param birthDate The birthDate to set.
138.      */
139.     public void setSelected(boolean selected) {
140.         Selected = selected;
141.     }
143. }

DataSource.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package datasource;
10. import java.io.Serializable;
11. import java.util.ArrayList;
12. import java.util.List;
14. /**
15.  */
16. public class DataSource implements Serializable {
17.     List dataItems;
18.     
19.     private static String[] firstNames = { 
20.             "Carol", "John", "Frank", "Barbara", "Julie", "Ted", "Ted", "Bob", "Mary", "Alice", "Fran"
21.             ,"Carrie", "John", "Frank", "Barbara", "Julie", "Bob", "Mary", "Alice", "Fran"
22.             ,"Carol", "John", "Frank", "Barbara", "Julie", "Ted", "Bob", "Mary", "Alice", "Fran"
23.             ,"Carol", "John", "John", "Frank", "Barbara", "Barbara", "Julie", "Ted", "Bob", "Mary", "Alice", "Fran"
24.             ,"Carol", "John", "Frank", "Barbara", "Julie", "Ted", "Bob", "Mary", "Alice", "Fran"
25.             ,"Carrol", "John", "Kenneth", "Barbara", "Julie", "Ted", "Bob", "Mary", "Alice", "Fran"
26.             ,"Carol", "John", "Frank", "Barbara", "Julie", "Ted", "Bob", "Mary", "Alice", "Fran"
27.             ,"Carol", "John", "Frank", "Mary", "Julie", "Ted", "Bob", "Mary", "Alice", "Fran"
28.             ,"Carl", "John", "Elizabeth", "Barbara", "Julie", "Ted", "Bob", "Mary", "Alice", "Fran"
29.             ,"Carol", "John", "Frank", "Barbara", "Julie", "Ted", "Bob", "Mary", "Alice", "Fran"
30.     };
31.     
32.     private static String[] lastNames = { 
33.             "Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
34.             ,"Wilson","Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
35.             ,"Nixon","Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
36.             ,"Patterson","Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
37.             ,"Franklin","Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
38.             ,"Jetson","Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
39.             ,"Adams","Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
40.             ,"Carleson","Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
41.             ,"Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
42.             ,"Smith", "Jones", "Johnson", "Reynolds", "Robinson", "Clark", "Lewis", "Washington", "Franklin", "Pierce"
43.     };
44.     
45.     private static String[] birthDates = { 
46.             "01/09/1960", "08/15/1972", "09/11/1973", "02/03/1982", "07/11/1978", "03/15/1990", "04/10/1955", "09/10/1955", "07/12/1956", "02/06/1968"
47.             ,"01/09/1961","01/09/1962", "08/15/1973", "09/11/1974", "02/03/1985", "07/11/1976", "03/15/1997", "04/12/1955", "09/10/1955", "07/12/1956", "02/06/1968"
48.             , "08/15/1972","01/09/1960", "08/15/1972", "09/11/1973", "02/03/1982", "07/11/1978", "03/15/1990", "04/13/1955", "09/10/1955", "07/12/1956", "02/06/1968"
49.             ,"01/09/1960", "08/15/1971", "09/11/1972", "02/03/1983", "07/11/1974", "03/15/1995", "04/12/1956", "09/10/1957", "07/12/1958", "02/06/1968"
50.             , "09/11/1973","01/09/1960", "08/15/1972", "09/11/1973", "02/03/1982", "07/11/1978", "03/15/1990", "04/14/1955", "09/10/1955", "07/12/1956", "02/06/1968"
51.             ,"01/09/1960", "08/15/1972", "09/11/1973", "02/03/1982", "07/11/1978", "03/15/1990", "04/12/1957", "09/10/1955", "07/12/1956", "02/06/1968"
52.             , "02/03/1982","01/09/1960", "08/15/1972", "09/11/1973", "02/03/1982", "07/11/1978", "03/15/1990", "04/15/1955", "09/10/1955", "07/12/1956", "02/06/1968"
53.             ,"01/09/1960", "08/15/1972", "09/11/1973", "02/03/1982", "07/11/1978", "03/15/1990", "04/12/1958", "09/10/1955", "07/12/1956", "02/06/1968"
54.             , "07/11/1978","01/09/1960", "08/15/1972", "09/11/1973", "02/03/1982", "07/11/1978", "03/15/1990", "04/16/1955", "09/10/1955", "07/12/1956", "02/06/1968"
55.             ,"01/09/1960", "08/15/1972", "09/11/1973", "02/03/1982", "07/11/1978", "03/15/1990", "04/12/1959", "09/10/1955", "07/12/1956", "02/06/1968"
56.     };
58.     private static String[] heights = { 
59.             "6' 4/"", "5' 11/"", "4' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
60.             ,"5' 2/"","6' 4/"", "5' 11/"", "4' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
61.             ,"6' 4/"", "5' 11/"", "4' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
62.             ,"5' 2/"","6' 4/"", "5' 11/"", "4' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
63.             ,"6' 4/"", "5' 11/"", "4' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
64.             ,"5' 2/"","6' 4/"", "5' 11/"", "4' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
65.             ,"6' 4/"", "5' 11/"", "4' 11/"", "4' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
66.             ,"5' 2/"","6' 4/"", "5' 11/"", "4' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
67.             ,"6' 4/"", "5' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
68.             ,"6' 4/"", "5' 11/"", "4' 11/"", "5' 2/"", "6'", "5' 5/"", "5' 8/"", "4' 9/"", "5'", "5' 9/""
69.     };
70.     
71.     private static int[] weights = { 
72.             210, 185, 140, 152, 200, 210, 160, 108, 100, 155
73.             ,210, 185, 140, 152, 200, 210, 160, 108, 100, 155
74.             , 140,210, 185, 140, 152, 200, 210, 160, 108, 100, 155
75.             ,210, 185, 140, 152, 200, 210, 160, 108, 100, 155
76.             ,210, 185, 140, 152, 200, 210, 160, 108, 100, 155
77.             , 140,210, 185, 140, 152, 200, 210, 160, 108, 100, 155
78.             ,210, 185, 140, 152, 200, 210, 160, 108, 100, 155
79.             , 140,210, 185, 140, 152, 200, 210, 160, 108, 100, 155
80.             ,210, 185, 140, 152, 200, 210, 160, 108, 100, 155
81.             ,210, 185, 140, 152, 200, 210, 160, 108, 100, 155
82.     };
83.     
84.     public DataSource() {
85.         if (dataItems == null) {
86.             dataItems = new ArrayList();
87.             int SSN = 1000;
88.             for (int i = 0; i < 100; i++) {
89.                 dataItems.add(new DataItem("123-45-" + (SSN + i), firstNames[i],
90.                         lastNames[i], birthDates[i], heights[i], new String(""+ weights[i])));
91.             }
92.         }
93.     }
95.     public List getDataItems() {
96.         return dataItems;
97.     }
99. }

ColumnChooserPage.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import java.util.List;
12. import org.apache.tapestry.IRequestCycle;
13. import org.apache.tapestry.contrib.palette.SortMode;
14. import org.apache.tapestry.form.IPropertySelectionModel;
15. import org.apache.tapestry.form.StringPropertySelectionModel;
16. import org.apache.tapestry.html.BasePage;
18. /**
19.  *
20.  */
21. public class ColumnChooserPage extends BasePage
22. {
24.     private List _selectedColumns;
26.     private SortMode _sort = SortMode.USER;
28.     private IPropertySelectionModel _sortModel;
30.     public ColumnChooserPage()
31.     {
32.         super();
33.     }
34.     
35.     public void initialize()
36.     {
37.         super.initialize();
38.         _sort = SortMode.USER;
39.         _selectedColumns = null;
40.     }
42.     public void formSubmit(IRequestCycle cycle)
43.     {
44.         ColumnChooserPage2 resultsPage = (ColumnChooserPage2) cycle.getPage("ColumnChooser2");
45.         if( _selectedColumns != null && _selectedColumns.size()>0)
46.         {
47.             // Convert the List to a String of 
48.             // comma-seperated ColumnIDs
49.             StringBuffer selectedColumns = new StringBuffer();
50.             for (int i=0; i < _selectedColumns.size(); i++)
51.             {
52.                 // Crude mapping of Labels to ColumnIDs
53.                 String columnString = (String)_selectedColumns.get(i);
54.                 if (columnString.equals("First Name")){
55.                     selectedColumns.append("FirstName");
56.                 } else if (columnString.equals("Last Name"))
57.                 {
58.                     selectedColumns.append("LastName");
59.                 } else if (columnString.equals("Birth Date"))
60.                 {
61.                     selectedColumns.append("=birthDateColumn");
62.                 } else {
63.                     selectedColumns.append(columnString);
64.                 }
65.                 if( i < (_selectedColumns.size()-1))
66.                 {
67.                     selectedColumns.append(",");
68.                 }
69.             }
70.             resultsPage.setSelectedColumns(selectedColumns.toString());
71.             cycle.activate(resultsPage);
72.         } else {
73.             _errorMsg = "Select at least one column";
74.         }
75.     }
77.     private IPropertySelectionModel columnModel;
79.     private String[] columns = { "SSN", "First Name", "Last Name", "Birth Date", "Height", "Weight" };
81.     public IPropertySelectionModel getColumnModel()
82.     {
83.         if (columnModel == null)
84.             columnModel = new StringPropertySelectionModel(columns);
86.         return columnModel;
87.     }
89.     public void setSort(SortMode value)
90.     {
91.         _sort = value;
92.     }
94.     public SortMode getSort()
95.     {
96.         return _sort;
97.     }
99.     public IPropertySelectionModel getSortModel()
100.     {
101.         return _sortModel;
102.     }
104.     public List getSelectedColumns()
105.     {
106.         return _selectedColumns;
107.     }
109.     public void setSelectedColumns(List selectedColumns)
110.     {
111.         _selectedColumns = selectedColumns;
112.     }
114.     String _errorMsg;
115.     
116.     public String getErrorMsg()
117.     {
118.         return _errorMsg;
119.     }
120. }

ColumnChooserPage2.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import java.util.List;
12. import org.apache.tapestry.IRequestCycle;
13. import org.apache.tapestry.contrib.table.model.IPrimaryKeyConvertor;
14. import org.apache.tapestry.contrib.table.model.ITableColumn;
15. import org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator;
16. import org.apache.tapestry.contrib.table.model.simple.SimpleTableColumn;
17. import org.apache.tapestry.event.PageEvent;
18. import org.apache.tapestry.event.PageRenderListener;
19. import org.apache.tapestry.html.BasePage;
21. import datasource.BirthDateComparator;
22. import datasource.DataItem;
24. /**
25.  *
26.  */
27. public abstract class ColumnChooserPage2 extends BasePage implements PageRenderListener
28. {
29.     public abstract List getDataItems();
30.     public abstract void setDataItems(List dataItems);
32.     public abstract String getColumnsString();
33.     public abstract void setColumnsString(String cols);
35.     private IPrimaryKeyConvertor m_dataItemConvertor;
37.     public ColumnChooserPage2()
38.     {
39.         super();
40.         // define a IPrimaryKeyConvertor that gets DataItems from the original list 
41.         m_dataItemConvertor = new IPrimaryKeyConvertor()
42.         {
43.             public Object getPrimaryKey(Object objValue)
44.             {
45.                 DataItem dataItem = (DataItem) objValue;
46.                 return dataItem.getSSN();
47.             }
49.             public Object getValue(Object objPrimaryKey)
50.             {
51.                 String SSN = (String)objPrimaryKey;
52.                 List list = getDataItems();
54.                 // find the item
55.                 int count = list.size();
56.                 for (int i = 0; i < count; i++)
57.                 {
58.                     DataItem item = (DataItem) list.get(i);
59.                     if (item.getSSN().equals(SSN)){
60.                         return item;
61.                     }
62.                 }
63.                 return new DataItem(); //Handle data item not found 
64.             }
65.         };
66.         
67.     }
69.     public IPrimaryKeyConvertor getDataItemConvertor()
70.     {
71.         return m_dataItemConvertor;
72.     }
74.     public void pageBeginRender(PageEvent event)
75.     {
76.         List list = getDataItems();
78.         if (list == null)
79.         {
80.             setDataItems(((TapestryTablesVisit)getVisit()).getDataItems());
81.         }
83.         setColumnsString(_selectedColumns);
84.         System.out.println("setColumnsString(" + _selectedColumns + ")");
86.     }
88.     public ITableColumn getBirthDateColumn()
89.     {
90.         // The column value is extracted in a custom evaluator class
91.         SimpleTableColumn birthDateColumn =  new SimpleTableColumn("BirthDate", "Birth Date", new BirthDateColumnEvaluator(), true);
92.         birthDateColumn.setColumnComparator(new BirthDateComparator());
93.         return birthDateColumn;
94.     }
96.     /**
97.      * A class defining the logic for getting the BirthDate from a DataItem
98.      */
99.     private static class BirthDateColumnEvaluator implements ITableColumnEvaluator
100.     {
101.         /**
102.          * @see org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator#getColumnValue(ITableColumn, Object)
103.          */
104.         public Object getColumnValue(ITableColumn objColumn, Object objRow)
105.         {
106.             DataItem dataItem = (DataItem) objRow;
107.             if( dataItem == null )
108.             {
109.                 return "No Birthdate";
110.             }
111.             return dataItem.getBirthDate();
112.         }
113.     }
115.     public void formSubmit(IRequestCycle cycle)
116.     {
117.         System.out.println("The form was submitted");
118.     }
120.     String _selectedColumns = "No Columns Selected";
121.     public void setSelectedColumns( String selectedColumns)
122.     {
123.         _selectedColumns = selectedColumns;
124.     }
125. }

CustomSortColumnPage.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import tapestrytables.TapestryTablesVisit;
11. import org.apache.tapestry.contrib.table.model.ITableColumn;
12. import org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator;
13. import org.apache.tapestry.contrib.table.model.simple.SimpleTableColumn;
14. import datasource.DataItem;
15. import datasource.BirthDateComparator;
18. import java.util.List;
20. import org.apache.tapestry.event.PageEvent;
21. import org.apache.tapestry.event.PageRenderListener;
22. import org.apache.tapestry.html.BasePage;
24. /**
25.  *
26.  */
27. public abstract class CustomSortColumnPage extends BasePage implements PageRenderListener
28. {
29.     public abstract List getDataItems();
30.     public abstract void setDataItems(List dataItems);
33.     public void pageBeginRender(PageEvent event)
34.     {
35.         List list = getDataItems();
37.         if (list == null)
38.         {
39.             setDataItems(((TapestryTablesVisit)getVisit()).getDataItems());
40.         }
41.     }
43.     public ITableColumn getBirthDateColumn()
44.     {
45.         // The column value is extracted in a custom evaluator class
46.         SimpleTableColumn birthDateColumn =  new SimpleTableColumn("BirthDate", "Birth Date", new BirthDateColumnEvaluator(), true);
47.         birthDateColumn.setColumnComparator(new BirthDateComparator());
48.         return birthDateColumn;
49.     }
51.     /**
52.      * A class defining the logic for getting the BirthDate from a DataItem
53.      */
54.     private static class BirthDateColumnEvaluator implements ITableColumnEvaluator
55.     {
56.         /**
57.          * @see org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator#getColumnValue(ITableColumn, Object)
58.          */
59.         public Object getColumnValue(ITableColumn objColumn, Object objRow)
60.         {
61.             DataItem dataItem = (DataItem) objRow;
62.             return dataItem.getBirthDate();
63.         }
64.     }
66. }

DirectLinkColumnPage.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import tapestrytables.TapestryTablesVisit;
12. import org.apache.tapestry.IRequestCycle;
13. import org.apache.tapestry.contrib.table.model.IPrimaryKeyConvertor;
14. import org.apache.tapestry.contrib.table.model.ITableColumn;
15. import org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator;
16. import org.apache.tapestry.contrib.table.model.simple.SimpleTableColumn;
17. import datasource.DataItem;
18. import datasource.BirthDateComparator;
21. import java.util.List;
23. import org.apache.tapestry.event.PageEvent;
24. import org.apache.tapestry.event.PageRenderListener;
25. import org.apache.tapestry.html.BasePage;
27. /**
28.  *
29.  */
30. public abstract class DirectLinkColumnPage extends BasePage implements PageRenderListener
31. {
32.     public abstract List getDataItems();
33.     public abstract void setDataItems(List dataItems);
35.     public abstract String getSelectedSSN();
36.     public abstract void setSelectedSSN(String selectedSSN);
37.     
39.     private IPrimaryKeyConvertor m_dataItemConvertor;
41.     public DirectLinkColumnPage()
42.     {
43.         super();
44.         // define a IPrimaryKeyConvertor that gets DataItems from the original list 
45.         m_dataItemConvertor = new IPrimaryKeyConvertor()
46.         {
47.             public Object getPrimaryKey(Object objValue)
48.             {
49.                 DataItem dataItem = (DataItem) objValue;
50.                 return dataItem.getSSN();
51.             }
53.             public Object getValue(Object objPrimaryKey)
54.             {
55.                 String SSN = (String)objPrimaryKey;
56.                 List list = getDataItems();
58.                 // find the item
59.                 int count = list.size();
60.                 for (int i = 0; i < count; i++)
61.                 {
62.                     DataItem item = (DataItem) list.get(i);
63.                     if (item.getSSN().equals(SSN)){
64.                         return item;
65.                     }
66.                 }
67.                 return new DataItem(); //Handle data item not found 
68.             }
69.         };
70.         
71.     }
73.     // authored by Rick Austin
74.     public void SelectListener(IRequestCycle cycle) {
75.         Object[] parameters = cycle.getServiceParameters();
76.         String SSN = (String)parameters[0];
77.         // Output the parameter value to the console to see if
78.         // this works.
79.         System.out.println("Selected SSN: " + SSN);
80.         setSelectedSSN(SSN);
81.     }
83.     public IPrimaryKeyConvertor getDataItemConvertor()
84.     {
85.         return m_dataItemConvertor;
86.     }
88.     public void pageBeginRender(PageEvent event)
89.     {
90.         List list = getDataItems();
92.         if (list == null)
93.         {
94.             setDataItems(((TapestryTablesVisit)getVisit()).getDataItems());
95.         }
96.     }
98.     public ITableColumn getBirthDateColumn()
99.     {
100.         // The column value is extracted in a custom evaluator class
101.         SimpleTableColumn birthDateColumn =  new SimpleTableColumn("BirthDate", "Birth Date", new BirthDateColumnEvaluator(), true);
102.         birthDateColumn.setColumnComparator(new BirthDateComparator());
103.         return birthDateColumn;
104.     }
106.     /**
107.      * A class defining the logic for getting the BirthDate from a DataItem
108.      */
109.     private static class BirthDateColumnEvaluator implements ITableColumnEvaluator
110.     {
111.         /**
112.          * @see org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator#getColumnValue(ITableColumn, Object)
113.          */
114.         public Object getColumnValue(ITableColumn objColumn, Object objRow)
115.         {
116.             DataItem dataItem = (DataItem) objRow;
117.             if( dataItem == null )
118.             {
119.                 return "No Birthdate";
120.             }
121.             return dataItem.getBirthDate();
122.         }
123.     }
125.     public void formSubmit(IRequestCycle cycle)
126.     {
127.         System.out.println("The form was submitted");
128.  /*     
129.         RequestContext context = cycle.getRequestContext();
131.         System.out.println(context.getParameter("hiddenCurrentPage"));
132.         
133.         //int iterRows = Integer.parseInt(context.getParameter("iterRows"));            
134.         String ew = "editableWeight";
135.         for (int i=0; i < 6; i++)
136.         {
137.             String suffix;
138.             if (i==0) {
139.                 suffix = "";
140.             } else {
141.                 suffix = "$" + (i-1);
142.             }
143.             String editableWeightString = context.getParameter(ew + suffix);
144.             if(editableWeightString != null)
145.             {
146.                 System.out.println("The " + ew + suffix + " parameter is: " + editableWeightString );
147.             }
148.         }
149.         
150.         // Process the submitted form
151.         List list = getDataItems();
153.         // Do something to process the list changes
154.         int count = list.size();
155.         for (int i = 0; i < 1; i++)
156.         {
157.             DataItem item = (DataItem) list.get(i);
158.             System.out.println(item.getWeight());
159.         }
161.         // Always important to set peristent properties; otherwise changes
162.         // made in this request cycle will be lost.  The framework
163.         // makes a copy of the list.
164.         setDataItems(list);
165. */
166.         }
168. }

DirectLinkTableColumnPage.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import tapestrytables.TapestryTablesVisit;
12. import org.apache.tapestry.IRequestCycle;
13. import org.apache.tapestry.components.Block;
14. import org.apache.tapestry.contrib.table.model.IPrimaryKeyConvertor;
15. import org.apache.tapestry.contrib.table.model.ITableColumn;
16. import org.apache.tapestry.contrib.table.model.ITableColumnModel;
17. import org.apache.tapestry.contrib.table.model.common.BlockTableRendererSource;
18. import org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator;
19. import org.apache.tapestry.contrib.table.model.simple.SimpleTableColumn;
20. import datasource.DataItem;
21. import datasource.BirthDateComparator;
23. import java.util.HashMap;
24. import java.util.Iterator;
25. import java.util.List;
27. import org.apache.tapestry.event.PageEvent;
28. import org.apache.tapestry.event.PageRenderListener;
29. import org.apache.tapestry.html.BasePage;
30. import org.apache.tapestry.util.ComponentAddress;
32. /**
33.  *  
34.  */
35. public abstract class DirectLinkTableColumnPage extends BasePage implements
36.         PageRenderListener {
37.     public abstract List getDataItems();
39.     public abstract void setDataItems(List dataItems);
41.     public abstract String getSelectedSSN();
43.     public abstract void setSelectedSSN(String selectedSSN);
45.     private IPrimaryKeyConvertor m_dataItemConvertor;
47.     public DirectLinkTableColumnPage() {
48.         super();
49.         // define a IPrimaryKeyConvertor that gets DataItems from the original
50.         // list
51.         m_dataItemConvertor = new IPrimaryKeyConvertor() {
52.             public Object getPrimaryKey(Object objValue) {
53.                 DataItem dataItem = (DataItem) objValue;
54.                 return dataItem.getSSN();
55.             }
57.             public Object getValue(Object objPrimaryKey) {
58.                 String SSN = (String) objPrimaryKey;
59.                 List list = getDataItems();
61.                 // find the item
62.                 int count = list.size();
63.                 for (int i = 0; i < count; i++) {
64.                     DataItem item = (DataItem) list.get(i);
65.                     if (item.getSSN().equals(SSN)) {
66.                         return item;
67.                     }
68.                 }
69.                 return new DataItem(); //Handle data item not found
70.             }
71.         };
73.     }
75.     // authored by Rick Austin
76.     public void SelectListener(IRequestCycle cycle) {
77.         Object[] parameters = cycle.getServiceParameters();
78.         String SSN = (String) parameters[0];
79.         // Output the parameter value to the console to see if
80.         // this works.
81.         System.out.println("Selected SSN: " + SSN);
82.         setSelectedSSN(SSN);
83.     }
85.     public IPrimaryKeyConvertor getDataItemConvertor() {
86.         return m_dataItemConvertor;
87.     }
89.     public void pageBeginRender(PageEvent event) {
90.         List list = getDataItems();
92.         if (list == null) {
93.             setDataItems(((TapestryTablesVisit) getVisit()).getDataItems());
94.         }
95.     }
97.     public ITableColumn getBirthDateColumn() {
98.         // The column value is extracted in a custom evaluator class
99.         SimpleTableColumn birthDateColumn = new SimpleTableColumn("BirthDate",
100.                 "Birth Date", new BirthDateColumnEvaluator(), true);
101.         birthDateColumn.setColumnComparator(new BirthDateComparator());
102.         return birthDateColumn;
103.     }
105.     /**
106.      * A class defining the logic for getting the BirthDate from a DataItem
107.      */
108.     private static class BirthDateColumnEvaluator implements
109.             ITableColumnEvaluator {
110.         /**
111.          * @see org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator#getColumnValue(ITableColumn,
112.          *      Object)
113.          */
114.         public Object getColumnValue(ITableColumn objColumn, Object objRow) {
115.             DataItem dataItem = (DataItem) objRow;
116.             if (dataItem == null) {
117.                 return "No Birthdate";
118.             }
119.             return dataItem.getBirthDate();
120.         }
121.     }
123.     public void formSubmit(IRequestCycle cycle) {
124.         System.out.println("The form was submitted");
125.         /*
126.          * RequestContext context = cycle.getRequestContext();
127.          * 
128.          * System.out.println(context.getParameter("hiddenCurrentPage"));
129.          * 
130.          * //int iterRows = Integer.parseInt(context.getParameter("iterRows"));
131.          * String ew = "editableWeight"; for (int i=0; i < 6; i++) { String
132.          * suffix; if (i==0) { suffix = ""; } else { suffix = "$" + (i-1); }
133.          * String editableWeightString = context.getParameter(ew + suffix);
134.          * if(editableWeightString != null) { System.out.println("The " + ew +
135.          * suffix + " parameter is: " + editableWeightString ); } }
136.          *  // Process the submitted form List list = getDataItems();
137.          *  // Do something to process the list changes int count = list.size();
138.          * for (int i = 0; i < 1; i++) { DataItem item = (DataItem) list.get(i);
139.          * System.out.println(item.getWeight()); }
140.          *  // Always important to set peristent properties; otherwise changes //
141.          * made in this request cycle will be lost. The framework // makes a
142.          * copy of the list. setDataItems(list);
143.          */
144.     }
145.     
146.     public ITableColumnModel getColumnModel()
147.     {
148.         return new ColumnModel();
149.     }
151.     class ColumnModel implements ITableColumnModel {
152.         private HashMap columns;
154.         public ColumnModel() {
155.             this.columns = new HashMap();
157.             SimpleTableColumn column1 = new SimpleTableColumn("SSN", "SSN",
158.                     new ITableColumnEvaluator() 
159.                     {
160.                         public Object getColumnValue(ITableColumn objColumn,
161.                                 Object objRow) 
162.                         {
163.                             return ((DataItem) objRow).getSSN();
164.                         }
165.                     }, true);
167.             // The following overrides the default SimpleTableColumn.getColumnValue to
168.             // render the Block component we defined on the HTML template
169.             column1.setValueRendererSource(new BlockTableRendererSource(new ComponentAddress(getComponent("SSNColumnValue"))));
170.             
171.             ITableColumn column2 = new SimpleTableColumn("LastName", "LastName",
172.                     new ITableColumnEvaluator() 
173.                     {
174.                         public Object getColumnValue(ITableColumn objColumn,
175.                                 Object objRow) 
176.                         {
177.                             return ((DataItem) objRow).getLastName();
178.                         }
179.                     }, true);
181.             ITableColumn column3 = new SimpleTableColumn("FirstName", "FirstName",
182.                     new ITableColumnEvaluator() {
183.                         public Object getColumnValue(ITableColumn objColumn,
184.                                 Object objRow) {
185.                             return ((DataItem) objRow).getFirstName();
186.                         }
187.                     }, true);
189.             ITableColumn column4 = new SimpleTableColumn("Height", "Height",
190.                     new ITableColumnEvaluator() {
191.                         public Object getColumnValue(ITableColumn objColumn,
192.                                 Object objRow) {
193.                             return ((DataItem) objRow).getHeight();
194.                         }
195.                     }, true);
197.             ITableColumn column5 = new SimpleTableColumn("Width", "Width",
198.                     new ITableColumnEvaluator() {
199.                         public Object getColumnValue(ITableColumn objColumn,
200.                                 Object objRow) {
201.                             return ((DataItem) objRow).getHeight();
202.                         }
203.                     }, true);
205.             columns.put(column1.getColumnName(), column1);
206.             columns.put(column2.getColumnName(), column2);
207.             columns.put(column3.getColumnName(), column3);
208.             columns.put(getBirthDateColumn().getColumnName(), getBirthDateColumn());
209.             columns.put(column4.getColumnName(), column4);
210.             columns.put(column5.getColumnName(), column5);
211.         }
213.         public int getColumnCount() {
214.             return this.columns.size();
215.         }
217.         public ITableColumn getColumn(String strName) {
218.             return (ITableColumn) columns.get(strName);
219.         }
221.         public Iterator getColumns() {
222.             return columns.values().iterator();
223.         }
225.     }
226. }

EditableColumnPage.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import tapestrytables.TapestryTablesVisit;
12. import org.apache.tapestry.IRequestCycle;
13. import org.apache.tapestry.contrib.table.model.ITableColumn;
14. import org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator;
15. import org.apache.tapestry.contrib.table.model.simple.SimpleTableColumn;
16. import datasource.DataItem;
17. import datasource.BirthDateComparator;
20. import java.util.List;
22. import org.apache.tapestry.event.PageEvent;
23. import org.apache.tapestry.event.PageRenderListener;
24. import org.apache.tapestry.html.BasePage;
26. /**
27.  *
28.  */
29. public abstract class EditableColumnPage extends BasePage implements PageRenderListener
30. {
31.     public abstract List getDataItems();
32.     public abstract void setDataItems(List dataItems);
35.     public void pageBeginRender(PageEvent event)
36.     {
37.         List list = getDataItems();
39.         if (list == null)
40.         {
41.             setDataItems(((TapestryTablesVisit)getVisit()).getDataItems());
42.         }
43.     }
45.     public ITableColumn getBirthDateColumn()
46.     {
47.         // The column value is extracted in a custom evaluator class
48.         SimpleTableColumn birthDateColumn =  new SimpleTableColumn("BirthDate", "Birth Date", new BirthDateColumnEvaluator(), true);
49.         birthDateColumn.setColumnComparator(new BirthDateComparator());
50.         return birthDateColumn;
51.     }
53.     /**
54.      * A class defining the logic for getting the BirthDate from a DataItem
55.      */
56.     private static class BirthDateColumnEvaluator implements ITableColumnEvaluator
57.     {
58.         /**
59.          * @see org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator#getColumnValue(ITableColumn, Object)
60.          */
61.         public Object getColumnValue(ITableColumn objColumn, Object objRow)
62.         {
63.             DataItem dataItem = (DataItem) objRow;
64.             return dataItem.getBirthDate();
65.         }
66.     }
68.     public void formSubmit(IRequestCycle cycle)
69.     {
70.         System.out.println("The form was submitted");
71.         // Process the submitted form
72.         List list = getDataItems();
74.         // Do something to process the list changes
75.         //int count = list.size();
76.         //for (int i = 0; i < count; i++)
77.         //{
78.         //    DataItem item = (DataItem) list.get(i);
79.         //    System.out.println(item.getWeight());
80.         //}
82.         // Always important to set peristent properties; otherwise changes
83.         // made in this request cycle will be lost.  The framework
84.         // makes a copy of the list.
85.         setDataItems(list);
86.     }
88. }

EditableColumnPage2.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import tapestrytables.TapestryTablesVisit;
12. import org.apache.tapestry.IRequestCycle;
13. import org.apache.tapestry.contrib.table.model.IPrimaryKeyConvertor;
14. import org.apache.tapestry.contrib.table.model.ITableColumn;
15. import org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator;
16. import org.apache.tapestry.contrib.table.model.simple.SimpleTableColumn;
17. import datasource.DataItem;
18. import datasource.BirthDateComparator;
21. import java.util.List;
23. import org.apache.tapestry.event.PageEvent;
24. import org.apache.tapestry.event.PageRenderListener;
25. import org.apache.tapestry.html.BasePage;
27. /**
28.  *
29.  */
30. public abstract class EditableColumnPage2 extends BasePage implements PageRenderListener
31. {
32.     public abstract List getDataItems();
33.     public abstract void setDataItems(List dataItems);
36.     private IPrimaryKeyConvertor m_dataItemConvertor;
38.     public EditableColumnPage2()
39.     {
40.         super();
41.         // define a IPrimaryKeyConvertor that gets DataItems from the original list 
42.         m_dataItemConvertor = new IPrimaryKeyConvertor()
43.         {
44.             public Object getPrimaryKey(Object objValue)
45.             {
46.                 DataItem dataItem = (DataItem) objValue;
47.                 return dataItem.getSSN();
48.             }
50.             public Object getValue(Object objPrimaryKey)
51.             {
52.                 String SSN = (String)objPrimaryKey;
53.                 List list = getDataItems();
55.                 // find the item
56.                 int count = list.size();
57.                 for (int i = 0; i < count; i++)
58.                 {
59.                     DataItem item = (DataItem) list.get(i);
60.                     if (item.getSSN().equals(SSN)){
61.                         return item;
62.                     }
63.                 }
64.                 return new DataItem(); //Handle data item not found 
65.             }
66.         };
67.         
68.     }
70.     public IPrimaryKeyConvertor getDataItemConvertor()
71.     {
72.         return m_dataItemConvertor;
73.     }
75.     public void pageBeginRender(PageEvent event)
76.     {
77.         List list = getDataItems();
79.         if (list == null)
80.         {
81.             setDataItems(((TapestryTablesVisit)getVisit()).getDataItems());
82.         }
83.     }
85.     public ITableColumn getBirthDateColumn()
86.     {
87.         // The column value is extracted in a custom evaluator class
88.         SimpleTableColumn birthDateColumn =  new SimpleTableColumn("BirthDate", "Birth Date", new BirthDateColumnEvaluator(), true);
89.         birthDateColumn.setColumnComparator(new BirthDateComparator());
90.         return birthDateColumn;
91.     }
93.     /**
94.      * A class defining the logic for getting the BirthDate from a DataItem
95.      */
96.     private static class BirthDateColumnEvaluator implements ITableColumnEvaluator
97.     {
98.         /**
99.          * @see org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator#getColumnValue(ITableColumn, Object)
100.          */
101.         public Object getColumnValue(ITableColumn objColumn, Object objRow)
102.         {
103.             DataItem dataItem = (DataItem) objRow;
104.             if( dataItem == null )
105.             {
106.                 return "No Birthdate";
107.             }
108.             return dataItem.getBirthDate();
109.         }
110.     }
112.     public void formSubmit(IRequestCycle cycle)
113.     {
114.         System.out.println("The form was submitted");
115.  /*     
116.         RequestContext context = cycle.getRequestContext();
118.         System.out.println(context.getParameter("hiddenCurrentPage"));
119.         
120.         //int iterRows = Integer.parseInt(context.getParameter("iterRows"));            
121.         String ew = "editableWeight";
122.         for (int i=0; i < 6; i++)
123.         {
124.             String suffix;
125.             if (i==0) {
126.                 suffix = "";
127.             } else {
128.                 suffix = "$" + (i-1);
129.             }
130.             String editableWeightString = context.getParameter(ew + suffix);
131.             if(editableWeightString != null)
132.             {
133.                 System.out.println("The " + ew + suffix + " parameter is: " + editableWeightString );
134.             }
135.         }
136.         
137.         // Process the submitted form
138.         List list = getDataItems();
140.         // Do something to process the list changes
141.         int count = list.size();
142.         for (int i = 0; i < 1; i++)
143.         {
144.             DataItem item = (DataItem) list.get(i);
145.             System.out.println(item.getWeight());
146.         }
148.         // Always important to set peristent properties; otherwise changes
149.         // made in this request cycle will be lost.  The framework
150.         // makes a copy of the list.
151.         setDataItems(list);
152. */
153.         }
155. }

FirstPass.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import tapestrytables.TapestryTablesVisit;
12. import java.util.List;
14. import org.apache.tapestry.event.PageEvent;
15. import org.apache.tapestry.event.PageRenderListener;
16. import org.apache.tapestry.html.BasePage;
18. /**
19.  *
20.  */
21. public abstract class FirstPass extends BasePage implements PageRenderListener
22. {
23.     public abstract List getDataItems();
24.     public abstract void setDataItems(List dataItems);
27.     public void pageBeginRender(PageEvent event)
28.     {
29.         List list = getDataItems();
31.         if (list == null)
32.         {
33.             setDataItems(((TapestryTablesVisit)getVisit()).getDataItems());
34.         }
35.     }
37. }

TapestryTablesVisit.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  *
8.  * This class pretty much corresponds to a users session object
9.  * It is accessible from all of the pages in the application
10.  */
11. package tapestrytables;
13. import datasource.DataSource;
15. import java.io.Serializable;
16. import java.util.List;
18. /**
19.  * 
20.  */
21. public class TapestryTablesVisit implements Serializable
22. {
23.     DataSource dataSource;
25.     public TapestryTablesVisit()
26.     {
27.         dataSource = new DataSource();
28.     }
30.     /**
31.      * @return Returns the list of Data Items.
32.      */
33.     public List getDataItems() {
34.         return dataSource.getDataItems();
35.     }
37. }

TestPage.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import java.util.List;
12. import org.apache.tapestry.IRequestCycle;
13. import org.apache.tapestry.contrib.table.components.TableView;
14. import org.apache.tapestry.contrib.table.model.IPrimaryKeyConvertor;
15. import org.apache.tapestry.event.PageEvent;
16. import org.apache.tapestry.event.PageRenderListener;
17. import org.apache.tapestry.form.IPropertySelectionModel;
18. import org.apache.tapestry.form.StringPropertySelectionModel;
19. import org.apache.tapestry.html.BasePage;
20. import org.apache.tapestry.request.RequestContext;
21. import org.apache.tapestry.valid.ValidationDelegate;
23. import datasource.DataItem;
25. /**
26.  *
27.  */
28. public abstract class TestPage extends BasePage implements PageRenderListener
29. {
30.     public abstract List getDataItems();
31.     public abstract void setDataItems(List dataItems);
33.     public abstract String getColumnsString();
34.     public abstract void setColumnsString(String cols);
36.     public static final IPropertySelectionModel COLUMNS_MODEL = 
37.         new StringPropertySelectionModel(new String[] { 
38.                 "SSN, FirstName, LastName", 
39.                 "SSN, LastName, FirstName", 
40.                 "LastName, FirstName", 
41.                 "LastName, SSN, FirstName" });
42.    
44.     
46.     private IPrimaryKeyConvertor m_dataItemConvertor;
48.     public TestPage()
49.     {
50.         super();
51.         
52.         // define a IPrimaryKeyConvertor that gets DataItems from the original list 
53.         m_dataItemConvertor = new IPrimaryKeyConvertor()
54.         {
55.             public Object getPrimaryKey(Object objValue)
56.             {
57.                 DataItem dataItem = (DataItem) objValue;
58.                 return dataItem.getSSN();
59.             }
61.             public Object getValue(Object objPrimaryKey)
62.             {
63.                 String SSN = (String)objPrimaryKey;
64.                 List list = getDataItems();
66.                 // find the item
67.                 int count = list.size();
68.                 for (int i = 0; i < count; i++)
69.                 {
70.                     DataItem item = (DataItem) list.get(i);
71.                     if (item.getSSN().equals(SSN)){
72.                         return item;
73.                     }
74.                 }
75.                 return new DataItem(); //Handle data item not found 
76.             }
77.         };
78.         
79.     }
81.     public IPrimaryKeyConvertor getDataItemConvertor()
82.     {
83.         return m_dataItemConvertor;
84.     }
85.     
86.     String colsString =  "SSN, FirstName, LastName";
88.     //int count = 0;
89.     public void pageBeginRender(PageEvent event)
90.     {
91.         List list = getDataItems();
93.         if (list == null)
94.         {
95.             setDataItems(((TapestryTablesVisit)getVisit()).getDataItems());
96.         }
97.         //String colStrings = event.getPage().getMessage("ColumnsString");
98.         //setColumnsString(columnsStrings[count%3]);
99.         setColumnsString(colsString);
100.         System.out.println("setColumnsString(" + colsString + ")");
101.     }
104.         
105.     public void formSubmit(IRequestCycle cycle)
106.     {
107.         colsString = getColumnsString();
108.         
109.         System.out.println("The form was submitted");
111.         ValidationDelegate delegate = (ValidationDelegate)getBeans().getBean("delegate");
112.         if(delegate.getHasErrors()) {
113.             // there are errors
114.             RequestContext context = cycle.getRequestContext();
116.             String currentPage = context.getParameter("hiddenCurrentPage");
117.             int currentPageInt = new Integer(currentPage).intValue();
118.             System.out.println("The current page is: " + currentPageInt );
119.             
120.             TableView tableView = (TableView)getComponent("tableView");
121.             if( tableView != null )
122.             {
123.                 System.out.println("Setting the current page back to " + currentPageInt);
124.                 // Remember, "hiddenCurrentPage" starts at "1": setCurrentPage is "0" based
125.                 tableView.getTableModel().getPagingState().setCurrentPage(currentPageInt-1);
126.             }
127.             return;
128.         }
129.     }
130. }

ValidateEditableColumnPage.java

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import tapestrytables.TapestryTablesVisit;
12. import org.apache.tapestry.IRequestCycle;
13. import org.apache.tapestry.contrib.table.components.FormTable;
14. import org.apache.tapestry.contrib.table.components.TableView;
15. import org.apache.tapestry.contrib.table.model.IPrimaryKeyConvertor;
16. import org.apache.tapestry.contrib.table.model.ITableColumn;
17. import org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator;
18. import org.apache.tapestry.contrib.table.model.simple.SimpleTableColumn;
20. import datasource.DataItem;
21. import datasource.BirthDateComparator;
23. import java.util.List;
25. import org.apache.tapestry.event.PageEvent;
26. import org.apache.tapestry.event.PageRenderListener;
27. import org.apache.tapestry.html.BasePage;
28. import org.apache.tapestry.request.RequestContext;
29. import org.apache.tapestry.valid.ValidationDelegate;
31. /**
32.  *
33.  */
34. public abstract class ValidateEditableColumnPage extends BasePage implements PageRenderListener
35. {
36.     public abstract List getDataItems();
37.     public abstract void setDataItems(List dataItems);
40.     private IPrimaryKeyConvertor m_dataItemConvertor;
42.     public ValidateEditableColumnPage()
43.     {
44.         super();
45.         // define a IPrimaryKeyConvertor that gets DataItems from the original list 
46.         m_dataItemConvertor = new IPrimaryKeyConvertor()
47.         {
48.             public Object getPrimaryKey(Object objValue)
49.             {
50.                 DataItem dataItem = (DataItem) objValue;
51.                 return dataItem.getSSN();
52.             }
54.             public Object getValue(Object objPrimaryKey)
55.             {
56.                 String SSN = (String)objPrimaryKey;
57.                 List list = getDataItems();
59.                 // find the item
60.                 int count = list.size();
61.                 for (int i = 0; i < count; i++)
62.                 {
63.                     DataItem item = (DataItem) list.get(i);
64.                     if (item.getSSN().equals(SSN)){
65.                         return item;
66.                     }
67.                 }
68.                 return new DataItem(); //Handle data item not found 
69.             }
70.         };
71.         
72.     }
74.     public IPrimaryKeyConvertor getDataItemConvertor()
75.     {
76.         return m_dataItemConvertor;
77.     }
79.     public void pageBeginRender(PageEvent event)
80.     {
81.         List list = getDataItems();
83.         if (list == null)
84.         {
85.             setDataItems(((TapestryTablesVisit)getVisit()).getDataItems());
86.         }
87.     }
89.     public ITableColumn getBirthDateColumn()
90.     {
91.         // The column value is extracted in a custom evaluator class
92.         SimpleTableColumn birthDateColumn =  new SimpleTableColumn("BirthDate", "Birth Date", new BirthDateColumnEvaluator(), true);
93.         birthDateColumn.setColumnComparator(new BirthDateComparator());
94.         return birthDateColumn;
95.     }
97.     /**
98.      * A class defining the logic for getting the BirthDate from a DataItem
99.      */
100.     private static class BirthDateColumnEvaluator implements ITableColumnEvaluator
101.     {
102.         /**
103.          * @see org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator#getColumnValue(ITableColumn, Object)
104.          */
105.         public Object getColumnValue(ITableColumn objColumn, Object objRow)
106.         {
107.             DataItem dataItem = (DataItem) objRow;
108.             if( dataItem == null )
109.             {
110.                 return "No Birthdate";
111.             }
112.             return dataItem.getBirthDate();
113.         }
114.     }
116.     public void formSubmit(IRequestCycle cycle) {
117.         System.out.println("The form was submitted");
119.         ValidationDelegate delegate = (ValidationDelegate) getBeans().getBean(
120.                 "delegate");
121.         if (delegate.getHasErrors()) {
122.             // there are errors
123.             RequestContext context = cycle.getRequestContext();
125.             String currentPage = context.getParameter("hiddenCurrentPage");
126.             if (currentPage != null) { 
128.                 int currentPageInt = new Integer(currentPage).intValue();
129.                 System.out.println("The current page is: " + currentPageInt);
131.                 FormTable formTable = (FormTable) getComponent("table");
132.                 if (formTable != null) {
133.                     System.out.println("Setting the current page back to "
134.                             + currentPageInt);
135.                     // Remember, "hiddenCurrentPage" starts at "1":
136.                     // setCurrentPage is "0" based
137.                     formTable.getTableModel().getPagingState().setCurrentPage(
138.                             currentPageInt - 1);
139.                 } 
140.             }else {
141.                 System.out.println("The parameter hiddenCurrentPage doesn't exist");
142. //              hiddenCurrentPage doesn't exist if there is only one page in the table
143.             }
144.             return;
145.         }
146.     }
147. }

ValidateEditableColumnPage2.java

 

1. /* Contributed by John Reynolds - October 2004
2.  * This work is hereby released into the Public Domain. 
3.  * To view a copy of the public domain dedication, visit 
4.  * http://creativecommons.org/licenses/publicdomain/ 
5.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
6.  * Stanford, California 94305, USA.
7.  */
8. package tapestrytables;
10. import tapestrytables.TapestryTablesVisit;
12. import org.apache.tapestry.IRequestCycle;
13. import org.apache.tapestry.contrib.table.components.FormTable;
14. import org.apache.tapestry.contrib.table.model.IPrimaryKeyConvertor;
15. import org.apache.tapestry.contrib.table.model.ITableColumn;
16. import org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator;
17. import org.apache.tapestry.contrib.table.model.simple.SimpleTableColumn;
19. import datasource.DataItem;
20. import datasource.BirthDateComparator;
22. import java.util.List;
24. import org.apache.tapestry.event.PageEvent;
25. import org.apache.tapestry.event.PageRenderListener;
26. import org.apache.tapestry.html.BasePage;
27. import org.apache.tapestry.request.RequestContext;
28. import org.apache.tapestry.valid.ValidationDelegate;
30. /**
31.  *
32.  */
33. public abstract class ValidateEditableColumnPage2 extends BasePage implements PageRenderListener
34. {
35.     public abstract List getDataItems();
36.     public abstract void setDataItems(List dataItems);
39.     private IPrimaryKeyConvertor m_dataItemConvertor;
41.     public ValidateEditableColumnPage2()
42.     {
43.         super();
44.         // define a IPrimaryKeyConvertor that gets DataItems from the original list 
45.         m_dataItemConvertor = new IPrimaryKeyConvertor()
46.         {
47.             public Object getPrimaryKey(Object objValue)
48.             {
49.                 DataItem dataItem = (DataItem) objValue;
50.                 return dataItem.getSSN();
51.             }
53.             public Object getValue(Object objPrimaryKey)
54.             {
55.                 String SSN = (String)objPrimaryKey;
56.                 List list = getDataItems();
58.                 // find the item
59.                 int count = list.size();
60.                 for (int i = 0; i < count; i++)
61.                 {
62.                     DataItem item = (DataItem) list.get(i);
63.                     if (item.getSSN().equals(SSN)){
64.                         return item;
65.                     }
66.                 }
67.                 return new DataItem(); //Handle data item not found 
68.             }
69.         };
70.         
71.     }
73.     public IPrimaryKeyConvertor getDataItemConvertor()
74.     {
75.         return m_dataItemConvertor;
76.     }
78.     public void pageBeginRender(PageEvent event)
79.     {
80.         List list = getDataItems();
82.         if (list == null)
83.         {
84.             setDataItems(((TapestryTablesVisit)getVisit()).getDataItems());
85.         }
86.     }
88.     public ITableColumn getBirthDateColumn()
89.     {
90.         // The column value is extracted in a custom evaluator class
91.         SimpleTableColumn birthDateColumn =  new SimpleTableColumn("BirthDate", "BirthDate", new BirthDateColumnEvaluator(), true);
92.         birthDateColumn.setColumnComparator(new BirthDateComparator());
94.         // Pick up any settings from the template and page
95.         birthDateColumn.loadSettings(this);
97.         return birthDateColumn;
98.     }
100.     /**
101.      * A class defining the logic for getting the BirthDate from a DataItem
102.      */
103.     private static class BirthDateColumnEvaluator implements ITableColumnEvaluator
104.     {
105.         /**
106.          * @see org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator#getColumnValue(ITableColumn, Object)
107.          */
108.         public Object getColumnValue(ITableColumn objColumn, Object objRow)
109.         {
110.             DataItem dataItem = (DataItem) objRow;
111.             if( dataItem == null )
112.             {
113.                 return "No Birthdate";
114.             }
115.             return dataItem.getBirthDate();
116.         }
117.     }
119.     public void formSubmit(IRequestCycle cycle) {
120.         System.out.println("The form was submitted");
122.         ValidationDelegate delegate = (ValidationDelegate) getBeans().getBean(
123.                 "delegate");
124.         if (delegate.getHasErrors()) {
125.             // there are errors
126.             RequestContext context = cycle.getRequestContext();
128.             String currentPage = context.getParameter("hiddenCurrentPage");
129.             if (currentPage != null) { 
131.                 int currentPageInt = new Integer(currentPage).intValue();
132.                 System.out.println("The current page is: " + currentPageInt);
134.                 FormTable formTable = (FormTable) getComponent("table");
135.                 if (formTable != null) {
136.                     System.out.println("Setting the current page back to "
137.                             + currentPageInt);
138.                     // Remember, "hiddenCurrentPage" starts at "1":
139.                     // setCurrentPage is "0" based
140.                     formTable.getTableModel().getPagingState().setCurrentPage(
141.                             currentPageInt - 1);
142.                 } 
143.             }else {
144.                 System.out.println("The parameter hiddenCurrentPage doesn't exist");
145. //              hiddenCurrentPage doesn't exist if there is only one page in the table
146.             }
147.             return;
148.         }
149.     }
150. }

style.css

1. body  
2. {
3.   font-family : Trebuchet MS, san serif;
4.   font-weight : normal;
5. }
7. table.mytable 
8. {
9.   border-style: solid;
10.   border-color: black;
11.   border-width: 1px;
12. }
14. th.columnheader
15. {
16.   background-color: rgb(228,228,228);
17. }
19. td.tablepager
20. {
21.   background-color: rgb(228,228,228);
22. }
24. tr.even
25. {
26.   background-color: lightblue;
27. }
29. tr.odd
30. {
31.   background-color: rgb(228,255,228);
32. }
34. code.snippet
35. {
36.   color: red;
37. }
39. code.highlight
40. {
41.   color: red;
42.   background-color: rgb(255,255,128);
43. }
45. span.inputerror
46. {
47.   color: red;
48.   font-weight : strong;
49.   background-color: yellow;
50. }
52. div.code
53. {
54.   color: red;
55.   background-color: rgb(255,255,228);
56. }
58. div.note
59. {
60.   background-color: rgb(228,255,228);
61. }
63. TABLE.palette TH
64. {
65.   font-size: 9pt;
66.   font-weight: bold;
67.   color: white;
68.   background-color: #330066;
69.   text-align: center;
70. }
72. TABLE.palette SELECT
73. {
74.   font-weight: bold;
75.   background-color: #839cd1;
76.   width: 200px;
77. }
79. TABLE.palette TD.controls
80. {
81.    text-align: center;
82.    vertical-align: middle;
83.    width: 60px;
84. }

ColumnChooser.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Choosing and Ordering Columns</h1>
7. <div class="note">
8.     This page demonstrates how to choose and order the table columns at runtime.
9. </div>            
11. <p>The columns that are displayed in the table can be dynamically specified
12.     rather then hard-coded.  It's a simple as setting the <code>columns</code>
13.     parameter to an expression rather then a string. 
14. </p><p>
15.     To demonstrate run-time column selection, we'll use a two-step process.    
16.     Use the following <code>contrib:Palette</code> to select
17.     the columns that you wish to see in the table (select at least one column), 
18.     and then select the <code>Continue</code> button to see the results.  
19. </p>
20. <form jwcid="@Form" listener="ognl:listeners.formSubmit">
22. <table class="form">
23.     <tr>
24.         <th>Columns:</th>
25.         <td><input jwcid="chooseColumns"/></td>
26.     </tr>
27.     <tr>
28.         <td></td>
29.         <td>
30.              <input type="submit" value="Continue"/>
31.              <code class="highlight"><span jwcid="@Insert" value="ognl:errorMsg"/></code>
32.         </td>
33.     </tr>
34. </table>
35. <p>
36.     I chose to use the <code>contrib:Palette</code> for this example because
37.     it is fairly straight-forward to use.  Regardless of how you choose to 
38.     specify the columns and their order, you must pass the columns
39.     to the Table's page before activating the page.  Here is the 
40.     relevent code from <code>ColumnChooserPage.java</code>:
41. <pre><code class="snippet">
42.   public void formSubmit(IRequestCycle cycle)
43.   {
44.       ColumnChooserPage2 resultsPage = (ColumnChooserPage2) cycle.getPage("ColumnChooser2");
45.       if( _selectedColumns != null && _selectedColumns.size()>0)
46.       {
47.         // Convert the List to a String of comma-seperated ColumnIDs
48.         StringBuffer selectedColumns = new StringBuffer();
49.         for (int i=0; i < _selectedColumns.size(); i++) {
50.             // Crude mapping of Labels to ColumnIDs
51.             String columnString = (String)_selectedColumns.get(i);
52.             if (columnString.equals("First Name")) {
53.                 selectedColumns.append("FirstName");
54.             } else if (columnString.equals("Last Name")) {
55.                 selectedColumns.append("LastName");
56.             } else if (columnString.equals("Birth Date")) {
57.                 selectedColumns.append("=birthDateColumn");
58.             } else {
59.                 selectedColumns.append(columnString);
60.             }
61.             if( i < (_selectedColumns.size()-1)) {
62.                 selectedColumns.append(",");
63.             }
64.         }
65. <code class="highlight">        resultsPage.setSelectedColumns(selectedColumns.toString());
66.         cycle.activate(resultsPage);
67. </code>    }
68.   }
69. </code></pre>        
70. </form>
71. <p>
72.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
73. </body>
74. </html>
75. <!--
76.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
77.  * This work is hereby released into the Public Domain. 
78.  * To view a copy of the public domain dedication, visit 
79.  * http://creativecommons.org/licenses/publicdomain/ 
80.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
81.  * Stanford, California 94305, USA.
82. -->

ColumnChooser.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!--
6.  * Contributed by John Reynolds - October 2004
7.  * This work is hereby released into the Public Domain. 
8.  * To view a copy of the public domain dedication, visit 
9.  * http://creativecommons.org/licenses/publicdomain/ 
10.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
11.  * Stanford, California 94305, USA.
12. -->
14. <page-specification class="tapestrytables.ColumnChooserPage">
15.   <context-asset name="stylesheet" path="css/style.css"/>
17.   <component id="chooseColumns" type="contrib:Palette">
18.     <binding name="model" expression="columnModel"/>
19.     <binding name="selected" expression="selectedColumns"/>
20.     <binding name="sort" expression="sort"/>
21.     <static-binding name="tableClass" value="palette"/>
22.   </component>
24. </page-specification>

ColumnChooser2.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Choosing and Ordering Columns</h1>
7. <div class="note">
8.     This page demonstrates how to choose and order the table columns at runtime.
9. </div>            
10. <p>
11.     The following <code>Table</code> should display the columns that you
12.     specified on the previous page (in the order you chose):
13. </p><p>
14.     <form jwcid="form">
15.     <table class="mytable" jwcid="table">
16.         <th>SSN</th>
17.         <th>First Name</th>
18.         <th>Last Name</th>
19.         <th>Birth Date</th>
20.         <th>Height</th>
21.         <th>Weight</th>
22.         <tr class="even">
23.             <td>123-44-5555</td>
24.             <td>John</td>
25.             <td>Reynolds</td>
26.             <td>10/01/2004</td>
27.             <td>5' 11"</td>
28.             <td>185</td>
29.         </tr>
30.         <tr class="odd">
31.             <td>123-44-5555</td>
32.             <td>John</td>
33.             <td>Reynolds</td>
34.             <td>10/01/2004</td>
35.             <td>5' 11"</td>
36.             <td>185</td>
37.         </tr>
38.         <tr class="even">
39.             <td>123-44-5555</td>
40.             <td>John</td>
41.             <td>Reynolds</td>
42.             <td>10/01/2004"</td>
43.             <td>5' 11"</td>
44.             <td>185</td>
45.         </tr>
46.         <tr class="odd">
47.             <td>123-44-5555</td>
48.             <td>John</td>
49.             <td>Reynolds</td>
50.             <td>10/01/2004</td>
51.             <td>5' 11"</td>
52.             <td>185</td>
53.         </tr>
54.     </table>
55.     </form>
57. </p><p>
58.     If you take a look at the files <code>ColumnChooser2.html</code>,
59.     <code>ColumnChooser2.page</code> and <code>ColumnChooserPage2.java</code> 
60.     you will see the elements necessary to specify the columns at runtime.
61. </p><p>
62.     Here are the relevent additions to <code>ColumnChooser2.page</code> 
63.     that sets up the <code>Table</code> to get the <code>columns</code>
64.     by evaluating an expression:
65. </p><p>
66.    
67. <pre><code class="snippet">        
68.     <component id="table" type="contrib:FormTable">
69.         <binding name="source" expression="dataItems"/>
70.         <binding name="convertor" expression="dataItemConvertor"/>
71.         <code class="highlight"><binding name="columns" expression="ColumnsString" /></code>
72.         <binding name="rowsClass" expression="beans.evenOdd.next"/>
73.         <binding name="pageSize" expression="6"/>
74.     </component>
75. </code></pre>
76. </p><p>
77. </p><p>
78.     Here is the method that was added to <code>ColumnChooserPage2.java</code> 
79.     to accept output from the column selector on the previous page:
80. </p><p>
81. <code class="highlight"><pre>
82.     public void setSelectedColumns( String selectedColumns)
83.     {
84.         _selectedColumns = selectedColumns;
85.         colsString = selectedColumns;
86.     }
87. </pre></code>    
88. </p><p>
89.     That's all there is to it.  Simply pass the desired columns to the page
90.     before it is rendered.
91. </p><p>
92.     <a href="#" jwcid="@PageLink" page="TenthPass">Using TableView, TableColumns, and TableFormRows...</a>
93. </p><p>
94.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
95. </p>
96. </body>
97. </html>
98. <!--
99.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
100.  * This work is hereby released into the Public Domain. 
101.  * To view a copy of the public domain dedication, visit 
102.  * http://creativecommons.org/licenses/publicdomain/ 
103.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
104.  * Stanford, California 94305, USA.
105. -->

ColumnChooser2.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="tapestrytables.ColumnChooserPage2">
16.         <context-asset name="stylesheet" path="css/style.css"/>
17.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
18.         <property-specification name="columnsString" type="java.lang.String" persistent="yes"/>
20.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
22.         <component id="form" type="Form">
23.             <binding name="listener" expression="listeners.formSubmit"/>
24.         </component>
26.         <component id="table" type="contrib:FormTable">
27.             <binding name="source" expression="dataItems"/>
28.             <binding name="convertor" expression="dataItemConvertor"/>
29.             <binding name="columns" expression="ColumnsString" />
30.             <binding name="rowsClass" expression="beans.evenOdd.next"/>
31.             <binding name="pageSize" expression="6"/>
32.         </component>
33. </page-specification>

ColumnChooser2.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

DirectLinkColumn.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Direct Links</h1>
7. <div class="note">
8.     This page demonstrates how to embed direct links in a column.
9. </div>            
10. <p>        
11.     Rick Austin provided the prototype for this page.
12.     The key, as discovered by Rick, is to use two components; a DirectLink 
13.     for the link functionality and an InsertText to render the text.
14.     When you click
15.     on one of the SSN links, the label below the table will be updated to indicate
16.     your selection:
17. </p><p>
18.     <form jwcid="form">
20.     <table class="mytable" jwcid="table">
21.        <span jwcid="SSNColumnValue@Block">
22.           <span jwcid="SSNLink">
23.              <span jwcid="SSNText"/>
24.           </span>
25.        </span>
26.         <th>SSN</th>
27.         <th>First Name</th>
28.         <th>Last Name</th>
29.         <th>Birth Date</th>
30.         <th>Height</th>
31.         <th>Weight</th>
32.         <tr class="even">
33.             <td>123-44-5555</td>
34.             <td>John</td>
35.             <td>Reynolds</td>
36.             <td>10/01/2004</td>
37.             <td>5' 11"</td>
38.             <td>185</td>
39.         </tr>
40.         <tr class="odd">
41.             <td>123-44-5555</td>
42.             <td>John</td>
43.             <td>Reynolds</td>
44.             <td>10/01/2004</td>
45.             <td>5' 11"</td>
46.             <td>185</td>
47.         </tr>
48.         <tr class="even">
49.             <td>123-44-5555</td>
50.             <td>John</td>
51.             <td>Reynolds</td>
52.             <td>10/01/2004"</td>
53.             <td>5' 11"</td>
54.             <td>185</td>
55.         </tr>
56.         <tr class="odd">
57.             <td>123-44-5555</td>
58.             <td>John</td>
59.             <td>Reynolds</td>
60.             <td>10/01/2004</td>
61.             <td>5' 11"</td>
62.             <td>185</td>
63.         </tr>
64.     </table>
65.     <input type="submit" value="Update"/>
66.     </form>
68. <div class="note">
69.     The last SSN that was selected was:
70.     <code class="highlight"><span jwcid="SelectedSSNText"/></code>
71. </div>
72. </p><p>
73.     If you take a look at the files <code>DirectLinkColumn.html</code>,
74.     <code>DirectLinkColumn.page</code> and <code>DirectLinkColumn.java</code> 
75.     you will see the elements necessary to embed direct links in a column.
76. </p><p>
77.     Here are the relevent additions to <code>DirectLinkColumn.page</code> 
78.     that sets up the components necessary for the links:
79. </p><p>
80.    
81. <code class="highlight"><pre>
82. <!--
83.  * Used to create a link which has a listener and passes in the current
84.  * SSN as a parameter.
85. -->
86. <component id="SSNLink" type="DirectLink">
87.     <binding name="listener" expression="listeners.SelectListener"/>
88.     <binding name="parameters" expression="components.table.tableRow.SSN"/>
89. </component> 
91. <!--
92.  * Used to output the SSN value into the row since the SSNLink component
93.  * creates a link but does not have a way of providing the link text.
94. -->
95. <component id="SSNText" type="InsertText">
96.     <binding name="value" expression="components.table.tableRow.SSN"/>
97. </component> 
98. </pre></code>        
99. </p><p>
100.     Here is the relevent snippet from <code>DirectLink.html</code> 
101.     that sets up the links:
102. </p><p>
103.    
104. <code class="snippet"><pre>
105.   <table class="mytable" jwcid="table">
106.      <code class="highlight"><span jwcid="SSNColumnValue@Block">
107.        <span jwcid="SSNLink">
108.          <span jwcid="SSNText"/>
109.        </span>
110.      </span></code>
111. </pre></code>
112. </p><p>
113. </p><p>
114.     Here is the method that was added to <code>DirectLinkColumnPage.java</code> 
115.     to process the links:
116. </p><p>
117. <code class="highlight"><pre>
118.     // authored by Rick Austin
119.     public void SelectListener(IRequestCycle cycle) {
120.         Object[] parameters = cycle.getServiceParameters();
121.         String SSN = (String)parameters[0];
122.         // Output the parameter value to the console to see if
123.         // this works.
124.         System.out.println("Selected SSN: " + SSN);
125.     }
126. </pre></code>    
127. </p><p>
128. <a href="#" jwcid="@PageLink" page="DirectLinkTableColumn">Direct Link using TableColumns...</a>
129. </p><p>
130. <a href="#" jwcid="@PageLink" page="ColumnChooser">Choosing and Ordering Columns...</a>
131. </p><p>
132.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
133. </p>
134. </body>
135. </html>
136. <!--
137.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
138.  * This work is hereby released into the Public Domain. 
139.  * To view a copy of the public domain dedication, visit 
140.  * http://creativecommons.org/licenses/publicdomain/ 
141.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
142.  * Stanford, California 94305, USA.
143. -->

DirectLinkColumn.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="tapestrytables.DirectLinkColumnPage">
16.         <context-asset name="stylesheet" path="css/style.css"/>
17.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
18.         <property-specification name="selectedSSN" type="java.lang.String" persistent="yes"/>
19.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
21.         <component id="form" type="Form">
22.             <binding name="listener" expression="listeners.formSubmit"/>
23.         </component>
25.         <component id="table" type="contrib:FormTable">
26.             <binding name="source" expression="dataItems"/>
27.             <binding name="convertor" expression="dataItemConvertor"/>
28.             <static-binding name="columns"
29.                 value="
30.                     SSN, 
31.                     FirstName, 
32.                     LastName, 
33.                     =birthDateColumn, 
34.                     Height, 
35.                     Weight"/>
36.             <binding name="rowsClass" expression="beans.evenOdd.next"/>
37.             <binding name="pageSize" expression="6"/>
38.             <static-binding  name="initialSortColumn" value="BirthDate"/>
39.         </component>
41.         <!--
42.         * Used to create a link which has a listener and passes in the current
43.         * SSN as a parameter.
44.         -->
45.         <component id="SSNLink" type="DirectLink">
46.            <binding name="listener" expression="listeners.SelectListener"/>
47.            <binding name="parameters" expression="components.table.tableRow.SSN"/>
48.         </component> 
50.         <!--
51.         * Used to output the SSN value into the row since the SSNLink component
52.         * creates a link but does not have a way of providing the link text.
53.         -->
54.         <component id="SSNText" type="InsertText">
55.           <binding name="value" expression="components.table.tableRow.SSN"/>
56.         </component> 
58.         <!--
59.         * Used to output the selected SSN value.
60.         -->
61.         <component id="SelectedSSNText" type="InsertText">
62.           <binding name="value" expression="selectedSSN"/>
63.         </component> 
64. </page-specification>

DirectLinkColumn.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

DirectLinkTableColumn.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Direct Links when using TableColumns</h1>
7. <div class="note">
8.     This page demonstrates how to embed direct links in a column when using
9.     a TableColumns object to define the columns.
10. </div>            
11. <p>        
12.     A question from Christian M�hlethaler prompted me to create this example.
13. </p><p>
14.     The previous Direct Link example works if the columns are defined using a String, but
15.     it wasn't obvious how to make this work if the columns are defined using
16.     a <code>TableColumns</code> object.
17. </p><p>
18.     The "trick" is to define a Column within your TableColumns that will get its
19.     ValueRenderer from your HTML template.
20. </p><p>
21.     <form jwcid="form">
23.     <table class="mytable" jwcid="table">
24.        <span jwcid="SSNColumnValue@Block">
25.           <span jwcid="SSNLink">
26.              <span jwcid="SSNText"/>
27.           </span>
28.        </span>
29.         <th>SSN</th>
30.         <th>First Name</th>
31.         <th>Last Name</th>
32.         <th>Birth Date</th>
33.         <th>Height</th>
34.         <th>Weight</th>
35.         <tr class="even">
36.             <td>123-44-5555</td>
37.             <td>John</td>
38.             <td>Reynolds</td>
39.             <td>10/01/2004</td>
40.             <td>5' 11"</td>
41.             <td>185</td>
42.         </tr>
43.         <tr class="odd">
44.             <td>123-44-5555</td>
45.             <td>John</td>
46.             <td>Reynolds</td>
47.             <td>10/01/2004</td>
48.             <td>5' 11"</td>
49.             <td>185</td>
50.         </tr>
51.         <tr class="even">
52.             <td>123-44-5555</td>
53.             <td>John</td>
54.             <td>Reynolds</td>
55.             <td>10/01/2004"</td>
56.             <td>5' 11"</td>
57.             <td>185</td>
58.         </tr>
59.         <tr class="odd">
60.             <td>123-44-5555</td>
61.             <td>John</td>
62.             <td>Reynolds</td>
63.             <td>10/01/2004</td>
64.             <td>5' 11"</td>
65.             <td>185</td>
66.         </tr>
67.     </table>
68.     <input type="submit" value="Update"/>
69.     </form>
71. <div class="note">
72.     The last SSN that was selected was:
73.     <code class="highlight"><span jwcid="SelectedSSNText"/></code>
74. </div>
75. </p><p>
76.     If you take a look at the files <code>DirectLinkTableColumn.html</code>,
77.     <code>DirectLinkTableColumn.page</code> and <code>DirectLinkTableColumn.java</code> 
78.     you will see the elements necessary to embed direct links when using <code>TableColumns</code>.
79. </p><p>
80.     Here are the relevent additions to <code>DirectTableLinkColumn.page</code> 
81.     that sets up the table to use a <code>TableColumns</code> object:
82. </p><p>
83.    
84. <code class="snippet"><pre>
86. <component id="table" type="contrib:FormTable">
87.     <binding name="source" expression="dataItems"/>
88.     <binding name="convertor" expression="dataItemConvertor"/>
89.     <binding name="columns"
90.         <code class="highlight">expression="columnModel"</code>/>
91.     <binding name="rowsClass" expression="beans.evenOdd.next"/>
92.     <binding name="pageSize" expression="6"/>
93.     <static-binding  name="initialSortColumn" value="BirthDate"/>
94. </component>
95.     
96. </pre></code>        
97. </p><p>
98.     Here is the method and the private class that was added to <code>DirectLinkTableColumnPage.java</code> 
99.     to define the TableColumnModel:
100. </p><p>
101. <div class="code"><pre>
102.     public ITableColumnModel getColumnModel()
103.     {
104.         return new ColumnModel();
105.     }
107.     class ColumnModel implements ITableColumnModel {
108.         private HashMap columns;
110.         public ColumnModel() {
111.             this.columns = new HashMap();
113.             SimpleTableColumn column1 = new SimpleTableColumn("SSN", "SSN",
114.                     new ITableColumnEvaluator() 
115.                     {
116.                         public Object getColumnValue(ITableColumn objColumn,
117.                                 Object objRow) 
118.                         {
119.                             return ((DataItem) objRow).getSSN();
120.                         }
121.                     }, true);
122. <code class="highlight">
123.             // The following overrides the default ValueRendererSource to
124.             // render the Block component we defined on the HTML template
125.             column1.setValueRendererSource( 
126.                 new BlockTableRendererSource(
127.                     new ComponentAddress(
128.                         getComponent("SSNColumnValue"))));
129. </code>            
130.             ITableColumn column2 = new SimpleTableColumn("LastName", "LastName",
131.                     new ITableColumnEvaluator() 
132.                     {
133.                         public Object getColumnValue(ITableColumn objColumn,
134.                                 Object objRow) 
135.                         {
136.                             return ((DataItem) objRow).getLastName();
137.                         }
138.                     }, true);
140.             ITableColumn column3 = new SimpleTableColumn("FirstName", "FirstName",
141.                     new ITableColumnEvaluator() {
142.                         public Object getColumnValue(ITableColumn objColumn,
143.                                 Object objRow) {
144.                             return ((DataItem) objRow).getFirstName();
145.                         }
146.                     }, true);
148.             ITableColumn column4 = new SimpleTableColumn("Height", "Height",
149.                     new ITableColumnEvaluator() {
150.                         public Object getColumnValue(ITableColumn objColumn,
151.                                 Object objRow) {
152.                             return ((DataItem) objRow).getHeight();
153.                         }
154.                     }, true);
156.             ITableColumn column5 = new SimpleTableColumn("Width", "Width",
157.                     new ITableColumnEvaluator() {
158.                         public Object getColumnValue(ITableColumn objColumn,
159.                                 Object objRow) {
160.                             return ((DataItem) objRow).getHeight();
161.                         }
162.                     }, true);
164.             columns.put(column1.getColumnName(), column1);
165.             columns.put(column2.getColumnName(), column2);
166.             columns.put(column3.getColumnName(), column3);
167.             columns.put(getBirthDateColumn().getColumnName(), getBirthDateColumn());
168.             columns.put(column4.getColumnName(), column4);
169.             columns.put(column5.getColumnName(), column5);
170.         }
172.         public int getColumnCount() {
173.             return this.columns.size();
174.         }
176.         public ITableColumn getColumn(String strName) {
177.             return (ITableColumn) columns.get(strName);
178.         }
180.         // Quick and dirty iterator
181.         public Iterator getColumns() {
182.             return columns.values().iterator();
183.         }
185.     }        
186. </pre></div>
187. </p>
188. <div class="note">    
189.     Note that the column ordering is "wierd" only because my quick and dirty example
190.     uses a <code>HashMap</code> to hold the <code>SimpleTableColumn</code> objects.
191.     
192. </div>
193. <p>
194. <a href="#" jwcid="@PageLink" page="ColumnChooser">Choosing and Ordering Columns...</a>
195. </p><p>
196.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
197. </p>
198. </body>
199. </html>
200. <!--
201.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
202.  * This work is hereby released into the Public Domain. 
203.  * To view a copy of the public domain dedication, visit 
204.  * http://creativecommons.org/licenses/publicdomain/ 
205.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
206.  * Stanford, California 94305, USA.
207. -->

DirectLinkTableColumn.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="tapestrytables.DirectLinkTableColumnPage">
16.         <context-asset name="stylesheet" path="css/style.css"/>
17.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
18.         <property-specification name="selectedSSN" type="java.lang.String" persistent="yes"/>
19.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
21.         <component id="form" type="Form">
22.             <binding name="listener" expression="listeners.formSubmit"/>
23.         </component>
25.         <component id="table" type="contrib:FormTable">
26.             <binding name="source" expression="dataItems"/>
27.             <binding name="convertor" expression="dataItemConvertor"/>
28.             <binding name="columns"
29.                 expression="columnModel"/>
30.             <binding name="rowsClass" expression="beans.evenOdd.next"/>
31.             <binding name="pageSize" expression="6"/>
32.             <static-binding  name="initialSortColumn" value="BirthDate"/>
33.         </component>
35.         <!--
36.         * Used to create a link which has a listener and passes in the current
37.         * SSN as a parameter.
38.         -->
39.         <component id="SSNLink" type="DirectLink">
40.            <binding name="listener" expression="listeners.SelectListener"/>
41.            <binding name="parameters" expression="components.table.tableRow.SSN"/>
42.         </component> 
44.         <!--
45.         * Used to output the SSN value into the row since the SSNLink component
46.         * creates a link but does not have a way of providing the link text.
47.         -->
48.         <component id="SSNText" type="InsertText">
49.           <binding name="value" expression="components.table.tableRow.SSN"/>
50.         </component> 
52.         <!--
53.         * Used to output the selected SSN value.
54.         -->
55.         <component id="SelectedSSNText" type="InsertText">
56.           <binding name="value" expression="selectedSSN"/>
57.         </component> 
58. </page-specification>

DirectLinkTableColumn.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

EighthPass.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Validating Editable Columns</h1>
7. <div class="note">
8.     This page demonstrates how to validate user input in an editable table.
9. </div>            
10. <p>        
11.     It's almost always necessary to check the user's input before accepting it.
12. </p><p>
13.     Try entering a non-numeric value in any of the <code>Weight</code> fields in
14.     the following table.
15. </p><p>
16.     <form jwcid="form">
18.     <table class="mytable" jwcid="table">
19.         <span jwcid="WeightColumnValue">
20.            <span jwcid="editableWeight"/>
21.         </span>
22.         <th>SSN</th>
23.         <th>First Name</th>
24.         <th>Last Name</th>
25.         <th>Birth Date</th>
26.         <th>Height</th>
27.         <th>Weight</th>
28.         <tr class="even">
29.             <td>123-44-5555</td>
30.             <td>John</td>
31.             <td>Reynolds</td>
32.             <td>10/01/2004</td>
33.             <td>5' 11"</td>
34.             <td>185</td>
35.         </tr>
36.         <tr class="odd">
37.             <td>123-44-5555</td>
38.             <td>John</td>
39.             <td>Reynolds</td>
40.             <td>10/01/2004</td>
41.             <td>5' 11"</td>
42.             <td>185</td>
43.         </tr>
44.         <tr class="even">
45.             <td>123-44-5555</td>
46.             <td>John</td>
47.             <td>Reynolds</td>
48.             <td>10/01/2004"</td>
49.             <td>5' 11"</td>
50.             <td>185</td>
51.         </tr>
52.         <tr class="odd">
53.             <td>123-44-5555</td>
54.             <td>John</td>
55.             <td>Reynolds</td>
56.             <td>10/01/2004</td>
57.             <td>5' 11"</td>
58.             <td>185</td>
59.         </tr>
60.         <tr class="even">
61.             <td>123-44-5555</td>
62.             <td>John</td>
63.             <td>Reynolds</td>
64.             <td>10/01/2004</td>
65.             <td>5' 11"</td>
66.             <td>185</td>
67.         </tr>
68.         <tr class="odd">
69.             <td>123-44-5555</td>
70.             <td>John</td>
71.             <td>Reynolds</td>
72.             <td>10/01/2004</td>
73.             <td>5' 11"</td>
74.             <td>185</td>
75.         </tr>
76.     </table>
77.     <input type="submit" value="Update"/>
78.     <span class="inputerror"><span jwcid="errors"/></span>
79.     </form>
80. </p><p>
81.     If you take a look at the files <code>Eighth.html</code>, <code>EighthPass.page</code> 
82.     and <code>ValidateEditableColumnPage.java</code> 
83.     you will see the changes necessary to validate the user's input.
84. </p><p>
85.     In the file <code>Eighth.html</code> we added the following to display any errors:
86. </p><p>
87.     <code class="highlight">
88.     <span class="inputerror"><span jwcid="errors"/><span>
89.     </code>
90. </p><p>
91.     Here is the relevent snippets from <code>EighthPass.page</code> 
92.     that sets up this component:
93. </p><p>
94. <pre>   
95. <code class="snippet">
96. <code class="highlight">
97.    <bean name="delegate" class="org.apache.tapestry.valid.ValidationDelegate"/>
98.    
99.    <bean name="numberValidator" class="org.apache.tapestry.valid.NumberValidator" lifecycle="page">
100.        <set-property name="required" expression="true"/>
101.        <set-property name="clientScriptingEnabled" expression="false"/>
102.    </bean>
103. </code>        
104.    <component id="form" type="Form">
105.        <binding name="listener" expression="listeners.formSubmit"/>
106. <code class="highlight">
107.        <binding name="delegate" expression="beans.delegate"/>
108. </code>
109.    </component>
110.                 
111.    <component id="table" type="contrib:FormTable">
112.        <binding name="source" expression="dataItems"/>
113.        <binding name="convertor" expression="dataItemConvertor"/>
114.        <static-binding name="columns"
115.            value="
116.                SSN, 
117.                FirstName, 
118.                LastName, 
119.                =birthDateColumn, 
120.                Height, 
121.                Weight"/>
122.        <binding name="rowsClass" expression="beans.evenOdd.next"/>
123.        <binding name="pageSize" expression="6"/>
124.        <static-binding  name="initialSortColumn" value="BirthDate"/>
125.    </component>
126.    <component id="WeightColumnValue" type="Block"/>
127.         
128.    <component id="editableWeight" <code class="highlight">type="ValidField"></code>
129.        <static-binding name="displayName">Weight</static-binding>
130.        <binding name="value" expression="components.table.tableRow.Weight"/>
131.        <binding name="size" expression="4"/>
132.        <code class="highlight"><binding name="validator" expression='beans.numberValidator'/></code>    
133.    </component>
134. <code class="highlight">
135.    <component id="errors" type="Delegator">
136.        <binding name="delegate" expression="beans.delegate.firstError"/>
137.    </component>
138. </code>
139. </code>
140. </pre>
141. </p><p>
142.     The response to validation errors is handled in <code>ValidateEditableColumnPage.java</code>:
143. <code class="snippet">
144. <pre>
145.     public void formSubmit(IRequestCycle cycle) {
146.         System.out.println("The form was submitted");
148. <code class="highlight">        ValidationDelegate delegate = (ValidationDelegate) getBeans().getBean(
149.                 "delegate");
150.         if (delegate.getHasErrors()) {
151.             // there are errors
152.             RequestContext context = cycle.getRequestContext();
154.             String currentPage = context.getParameter("hiddenCurrentPage");
155.             if (currentPage != null) { 
157.                 int currentPageInt = new Integer(currentPage).intValue();
158.                 System.out.println("The current page is: " + currentPageInt);
160.                 FormTable formTable = (FormTable) getComponent("table");
161.                 if (formTable != null) {
162.                     System.out.println("Setting the current page back to "
163.                             + currentPageInt);
164.                     // Remember, "hiddenCurrentPage" starts at "1":
165.                     // setCurrentPage is "0" based
166.                     formTable.getTableModel().getPagingState().setCurrentPage(
167.                             currentPageInt - 1);
168.                 } 
169.             }else {
170.                 System.out.println("The parameter hiddenCurrentPage doesn't exist");
171.                 // hiddenCurrentPage doesn't exist if there is only one page in the table            }
172.             return;
173.         }
174.     }
175. </code></pre></code>        
176. <a href="#" jwcid="@PageLink" page="NinthPass">Combining Validation and Sorting...</a>
177. </p><p>
178.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
179. </p>
180. </body>
181. </html>
182. <!--
183.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
184.  * This work is hereby released into the Public Domain. 
185.  * To view a copy of the public domain dedication, visit 
186.  * http://creativecommons.org/licenses/publicdomain/ 
187.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
188.  * Stanford, California 94305, USA.
189. -->

EighthPass.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="tapestrytables.ValidateEditableColumnPage">
16.         <context-asset name="stylesheet" path="css/style.css"/>
17.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
19.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
21.         <bean name="delegate" class="org.apache.tapestry.valid.ValidationDelegate"/>
22.         
23.         <bean name="numberValidator" class="org.apache.tapestry.valid.NumberValidator" lifecycle="page">
24.             <set-property name="required" expression="false"/>
25.             <set-property name="clientScriptingEnabled" expression="true"/>
26.         </bean>
27.         
28.         <component id="form" type="Form">
29.             <binding name="listener" expression="listeners.formSubmit"/>
30.             <binding name="delegate" expression="beans.delegate"/>
31.         </component>
32.                 
33.         <component id="table" type="contrib:FormTable">
34.             <binding name="source" expression="dataItems"/>
35.             <binding name="convertor" expression="dataItemConvertor"/>
36.             <static-binding name="columns"
37.                 value="
38.                     SSN, 
39.                     FirstName, 
40.                     LastName, 
41.                     =birthDateColumn, 
42.                     Height, 
43.                     Weight"/>
44.             <binding name="rowsClass" expression="beans.evenOdd.next"/>
45.             <binding name="pageSize" expression="6"/>
46.             <static-binding  name="initialSortColumn" value="BirthDate"/>
47.         </component>
49.         <component id="WeightColumnValue" type="Block"/>
50.         
51.         <component id="editableWeight" type="ValidField">
52.             <static-binding name="displayName">Weight</static-binding>
53.             <binding name="value" expression="components.table.tableRow.Weight"/>
54.             <binding name="size" expression="4"/>
55.             <binding name="validator" expression='beans.numberValidator'/>
56.         </component>
58.         <component id="errors" type="Delegator">
59.             <binding name="delegate" expression="beans.delegate.firstError"/>
60.         </component>
62. </page-specification>

EighthPass.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

FifthPass.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Simple Editable Column</h1>
7. <div class="note">
8.     This page demonstrates how to implement a table with an editable column.
9. </div>            
10. <p>        
11.     This example for using the Tapestry Table components is going to move
12.     beyond the initial requirements.  We are now going to implement an editable column,
13.     transforming the table from read-only to gathering user input.
14. </p><p>
15.     The table below allows the user to edit the <code>Weight</code> column.  Hopefully
16.     these values are stable or heading down ;-)
17. </p><p>
18.     <form jwcid="@Form" listener="ognl:listeners.formSubmit">
20.     <table class="mytable" jwcid="table@contrib:Table" 
21.     source="ognl:dataItems"
22.     columns="SSN, FirstName, LastName, 
23.         =birthDateColumn, Height, Weight"
24.     rowsClass="ognl:beans.evenOdd.next"
25.     pageSize="6"
26.     initialSortColumn="BirthDate">
27.         <span jwcid="WeightColumnValue@Block">
28.            <span jwcid="editableWeight@TextField" value="ognl:components.table.tableRow.Weight" size="4"/>
29.         </span>
30.         <th>SSN</th>
31.         <th>First Name</th>
32.         <th>Last Name</th>
33.         <th>Birth Date</th>
34.         <th>Height</th>
35.         <th>Weight</th>
36.         <tr class="even">
37.             <td>123-44-5555</td>
38.             <td>John</td>
39.             <td>Reynolds</td>
40.             <td>10/01/2004</td>
41.             <td>5' 11"</td>
42.             <td>185</td>
43.         </tr>
44.         <tr class="odd">
45.             <td>123-44-5555</td>
46.             <td>John</td>
47.             <td>Reynolds</td>
48.             <td>10/01/2004</td>
49.             <td>5' 11"</td>
50.             <td>185</td>
51.         </tr>
52.         <tr class="even">
53.             <td>123-44-5555</td>
54.             <td>John</td>
55.             <td>Reynolds</td>
56.             <td>10/01/2004"</td>
57.             <td>5' 11"</td>
58.             <td>185</td>
59.         </tr>
60.         <tr class="odd">
61.             <td>123-44-5555</td>
62.             <td>John</td>
63.             <td>Reynolds</td>
64.             <td>10/01/2004</td>
65.             <td>5' 11"</td>
66.             <td>185</td>
67.         </tr>
68.         <tr class="even">
69.             <td>123-44-5555</td>
70.             <td>John</td>
71.             <td>Reynolds</td>
72.             <td>10/01/2004</td>
73.             <td>5' 11"</td>
74.             <td>185</td>
75.         </tr>
76.         <tr class="odd">
77.             <td>123-44-5555</td>
78.             <td>John</td>
79.             <td>Reynolds</td>
80.             <td>10/01/2004</td>
81.             <td>5' 11"</td>
82.             <td>185</td>
83.         </tr>
84.     </table>
85.     <input type="submit" value="Update"/>
86.     </form>
87. </p><p>
88.     <b>Note:</b> The changes you make in the table on this page will not be submitted 
89.     unless you press the <code>Update</code> button.  
90.     Ideally any changes that the user makes would 
91.     be submitted prior to paging or sorting the table.  
92.     We'll take care of that later.  The really observant out there
93.     have probably also noticed that the <code>Weight</code> column doesn't
94.     validate the user's input.  We'll get around to dealing with that too.
95. </p><p>
96.     If you take a look at the files <code>FifthPass.html</code>, <code>FifthPass.page</code> 
97.     and <code>EditableColumnPage.java</code>, 
98.     you will see the changes made to make the <code>Weight</code> column editable.  
99.     We've inserted a <code>TextField</code> component, but the same technique
100.     could be used for other components.
101. </p><p>
102.     Here are the relevent HTML snippets from <code>FifthPass.html</code> 
103.     that sets up this component:
104. </p><p>
105.     To begin, we had to wrap the <code>table</code> inside a form and we added a button
106.     to submit any changes:
107. </p><p>
108. <code class="highlight">
109.     <form jwcid="@Form" listener="ognl:listeners.formSubmit">
110. </code>
111. </p><p>
112. <code class="highlight">
113.     <input type="submit" value="Update"/>
114. </code>
115. </p><p>
116.     We then made the following changes to the <code>Weight</code> column in the <code>table</code>:
117. </p><p>
118.    
119. <code class="snippet"><pre>    
120.     <table class="mytable" jwcid="table@contrib:Table" 
121.     source="ognl:dataItems"
122.     columns="SSN, FirstName, LastName, 
123.     =birthDateColumn, Height,
124.     <code class="highlight">Weight</code>"
125.     rowsClass="ognl:beans.evenOdd.next"
126.     pageSize="6"    
127.     initialSortColumn="BirthDate">
128. <code class="highlight">        
129.     <span jwcid="WeightColumnValue@Block">
130.     <span jwcid="editableWeight@TextField" value="ognl:components.table.tableRow.Weight" size="4"/>
131.     </span>
132. </code>
133. </pre></code>        
134. </p><p>
135.     The expression <code>jwcid="WeightColumnValue@Block"</code> tells Tapestry to 
136.     suspend normal processing when rendering values for the <code>Weight</code> column.
137.     Instead of normal rendering, the <code>editableWeight</code> component 
138.     (a <code>TextField</code>) will be displayed.
139. </p><p>
140.     The <code>editableWeight</code> gets its values by evaluating the expression 
141.     <code>ognl:components.table.tableRow.Weight</code>.  In a nutshell, the
142.     <code>getWeight()</code> is being called on the <code>DataItem</code> object
143.     that represents the current row of the table.
144. </p><p>
145.     To process form submissions we had to change the <code>BasePage</code> derivative
146.     that underlies this page.  This change is accomplished by making the following change to
147.     <code>FifthPass.page</code>:
148. </p><p>
149. <code class="snippet">
150. <page-specification 
151.     <code class="highlight">class="tapestrytables.EditableColumnPage"</code>>
152. </code>    
153. </p><p>
154.     With the additional requirement to process form submissions, we need to add a bit of code to our underlying <code>Page</code> object.  
155.     <code>EditableColumnPage.java</code> is the result.
156. </p><p>
157.     Below is the code added to <code>EditableColumnPage.java</code> that handles
158.     form submissions:
159. </p><pre>
160. <code class="highlight">
161.     public void formSubmit(IRequestCycle cycle)
162.     {
163.         // Process the submitted form
164.         List list = getDataItems();
166.         // Do something to process the list changes
167.         int count = list.size();
168.         for (int i = 0; i < count; i++)
169.         {
170.             DataItem item = (DataItem) list.get(i);
171.             System.out.println(item.getWeight());
172.         }
174.         // Always important to set peristent properties; otherwise changes
175.         // made in this request cycle will be lost.  The framework
176.         // makes a copy of the list.
177.         setDataItems(list);
178.     }
179. </code>    
180. </pre>
181.     As you can see, it isn't very difficult make a column editable, 
182.     but this example is unsatisfying because the user will lose changes
183.     unless the <code>Update</code> button is pressed prior to paging or sorting.
184.     A further problem concerns validating user input prior to updating the
185.     source data.
186. <p>
188. </p><p>
189. <a href="#" jwcid="@PageLink" page="SixthPass">Editable Column with Implicit Submit...</a>
191. </p><p>
192.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
193. </p>
194. </body>
195. </html>
196. <!--
197.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
198.  * This work is hereby released into the Public Domain. 
199.  * To view a copy of the public domain dedication, visit 
200.  * http://creativecommons.org/licenses/publicdomain/ 
201.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
202.  * Stanford, California 94305, USA.
203. -->

FifthPass.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="tapestrytables.EditableColumnPage">
16.         <context-asset name="stylesheet" path="css/style.css"/>
18.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
19.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
20.         
21. </page-specification>

FifthPass.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

FirstPass.html

1. <html jwcid="@Shell" title="Tapestry Table Examples" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6. <h1>Paging and Sortable Table</h1>
7. <div class="note">
8.     This page demonstrates how to implement a multi-page table that is sortable
9.     per column.
10. </div>            
11. <p>
12.     This is our first pass at implementing the desired table using Tapestry components.
13.     As mentioned before, the data that populates the table is coming from a Java
14.     Bean.
16. </p><p>
17.     <table class="mytable" jwcid="table@contrib:Table"
18.     source="ognl:dataItems"
19.     columns="SSN, FirstName, LastName, BirthDate, Height, Weight">
20.         <th>SSN</th>
21.         <th>First Name</th>
22.         <th>Last Name</th>
23.         <th>Birth Date</th>
24.         <th>Height</th>
25.         <th>Weight</th>
26.         <tr class="even">
27.             <td>123-44-5555</td>
28.             <td>John</td>
29.             <td>Reynolds</td>
30.             <td>10/01/2004</td>
31.             <td>5' 11"</td>
32.             <td>185</td>
33.         </tr>
34.         <tr class="odd">
35.             <td>123-44-5555</td>
36.             <td>John</td>
37.             <td>Reynolds</td>
38.             <td>10/01/2004</td>
39.             <td>5' 11"</td>
40.             <td>185</td>
41.         </tr>
42.         <tr class="even">
43.             <td>123-44-5555</td>
44.             <td>John</td>
45.             <td>Reynolds</td>
46.             <td>10/01/2004"</td>
47.             <td>5' 11"</td>
48.             <td>185</td>
49.         </tr>
50.         <tr class="odd">
51.             <td>123-44-5555</td>
52.             <td>John</td>
53.             <td>Reynolds</td>
54.             <td>10/01/2004</td>
55.             <td>5' 11"</td>
56.             <td>185</td>
57.         </tr>
58.         <tr class="even">
59.             <td>123-44-5555</td>
60.             <td>John</td>
61.             <td>Reynolds</td>
62.             <td>10/01/2004</td>
63.             <td>5' 11"</td>
64.             <td>185</td>
65.         </tr>
66.         <tr class="odd">
67.             <td>123-44-5555</td>
68.             <td>John</td>
69.             <td>Reynolds</td>
70.             <td>10/01/2004</td>
71.             <td>5' 11"</td>
72.             <td>185</td>
73.         </tr>
75.     </table>
76.     
77. </p><p>
78.     If you take a look at the files <code>TapestryTables.application</code>, <code>FirstPass.html</code> and <code>FirstPass.page</code>, 
79.     you will see that we
80.     have accomplished a great deal of functionality with very little work.
81.     The table on this page displays data from our <code>DataSource</code> Java Bean 
82.     on multiple pages,  
83.     a navigation component helps the user page through the table, and the table
84.     is sortable on any column (Observant folks may notice that sorting on the 
85.     <code>BirthDate</code> column isn't quite right.  We will address that 
86.     <a href="#" jwcid="@PageLink" page="FourthPass">later</a>).
87. </p><p>
89.     Here is the relevent HTML snippet from <code>FirstPass.html</code> 
90.     that sets up this component:
91. </p><p>
92.    
93. <code class="highlight">    
94.     <table class="mytable" jwcid="table@contrib:Table" 
95. <br>
96.     source="ognl:dataItems"
97. <br>    
98.     columns="SSN, FirstName, LastName, BirthDate, Height, Weight">
99. </code>        
100. </p><p>
101.     The <code>source</code> is set up by adding the following lines to 
102.     <code>FirstPass.page</code>:
103. </p><p>
104. <code clas="snippet">
105. <page-specification 
106.     <code class="highlight">
107.         class="tapestrytables.FirstPass"</code>>
108. <br>
109.         <property-specification 
110.     <code class="highlight">name="dataItems"</code> 
111.         type="java.util.List" persistent="yes"/>
112. </page-specification>
113. </code>    
114. </p><p>
115.     In a nutshell, this page specification tells Tapestry to instantiate and maintain a persitent
116.     <code>List</code> by invoking the method 
117.     <code>tapestrytables.FirstPass.getDataItems()</code>. 
118. </p><p>
119.     Functionally, this page is pretty awesome, but the table doesn't look right.
120.     We'll have to do some more work to match the vision of our HTML designer.
121. </p><p>
122. <a href="#" jwcid="@PageLink" page="SecondPass">Column Headings...</a>
123. </p>
124. <p>
125.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
126. </p>
127. </body>
128. </html>
129. <!--
130.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/
131.  * October 2004
132.  * This work is hereby released into the Public Domain. 
133.  * To view a copy of the public domain dedication, visit 
134.  * http://creativecommons.org/licenses/publicdomain/ 
135.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
136.  * Stanford, California 94305, USA.
137. -->

FirstPass.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
6. <page-specification class="tapestrytables.FirstPass">
7.         <context-asset name="stylesheet" path="css/style.css"/>
8.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
9. </page-specification>

FourthPass.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Custom Column Sorting</h1>
7. <div class="note">  
8.     This page demonstrates how to implement custom sorting on a column, how
9.     to set the initial sort column, and how to disable sorting on a column.
10. </div>            
11. <p>
12.     This is our fourth pass at implementing the table using Tapestry components.
13.     Our third pass got the "look" of the page right, but we need to go back and
14.     address the <code>Birth Date</code> column sorting problem we noticed earlier.
15. </p><p>
16. <div class="note">
17.      <b>Note:</b>  We could avoid implementing a custom sort by simply returning a
18.     <code>Date</code> object from the underlying <code>DataItem.getBirthDate()</code>, 
19.     but I wanted to demonstrate custom column sorting.
20. </div>        
21. </p><p>
22.     By default, the sorting is based on the "type" of the data item rendered
23.     for each column.  Our <code>Birth Date</code> column contains <code>Strings</code> in MM/DD/YYYY format,
24.     so a simple string compare won't suffice.  The following table correctly sorts on the 
25.     <code>BirthDate</code> column: 
26. </p><p>
27.     <table class="mytable" jwcid="table@contrib:Table"
28.     source="ognl:dataItems"
29.     columns="SSN, !FirstName, LastName, 
30.         =birthDateColumn, Height, Weight"
31.     rowsClass="ognl:beans.evenOdd.next"
32.     pageSize="6"    
33.     initialSortColumn="BirthDate">
34.         <th>SSN</th>
35.         <th>First Name</th>
36.         <th>Last Name</th>
37.         <th>Birth Date</th>
38.         <th>Height</th>
39.         <th>Weight</th>
40.         <tr class="even">
41.             <td>123-44-5555</td>
42.             <td>John</td>
43.             <td>Reynolds</td>
44.             <td>10/01/2004</td>
45.             <td>5' 11"</td>
46.             <td>185</td>
47.         </tr>
48.         <tr class="odd">
49.             <td>123-44-5555</td>
50.             <td>John</td>
51.             <td>Reynolds</td>
52.             <td>10/01/2004</td>
53.             <td>5' 11"</td>
54.             <td>185</td>
55.         </tr>
56.         <tr class="even">
57.             <td>123-44-5555</td>
58.             <td>John</td>
59.             <td>Reynolds</td>
60.             <td>10/01/2004"</td>
61.             <td>5' 11"</td>
62.             <td>185</td>
63.         </tr>
64.         <tr class="odd">
65.             <td>123-44-5555</td>
66.             <td>John</td>
67.             <td>Reynolds</td>
68.             <td>10/01/2004</td>
69.             <td>5' 11"</td>
70.             <td>185</td>
71.         </tr>
72.         <tr class="even">
73.             <td>123-44-5555</td>
74.             <td>John</td>
75.             <td>Reynolds</td>
76.             <td>10/01/2004</td>
77.             <td>5' 11"</td>
78.             <td>185</td>
79.         </tr>
80.         <tr class="odd">
81.             <td>123-44-5555</td>
82.             <td>John</td>
83.             <td>Reynolds</td>
84.             <td>10/01/2004</td>
85.             <td>5' 11"</td>
86.             <td>185</td>
87.         </tr>
88.     </table>
89.     
90. </p><p>
91.     If you take a look at the files <code>FouthPass.html</code>, <code>FourthPass.page</code> 
92.     and <code>CustomSortColumnPage.java</code>, 
93.     you will see the changes made to get the <code>Birth Date</code> column to sort properly.
94. </p><p>
96.     Here is the relevent HTML snippet from <code>FourthPass.html</code> 
97.     that sets up this component:
98. <pre><code class="snippet">    
99.     <table class="mytable" jwcid="table@contrib:Table" 
100.     source="ognl:dataItems"
101.     columns="SSN, <code class="highlight">!FirstName</code>, LastName, <code class="highlight">=birthDateColumn</code>, Height, Weight"    
102.     rowsClass="ognl:beans.evenOdd.next"
103.     pageSize="6" 
104.     <code class="highlight">initialSortColumn="BirthDate"</code>>
105. </code>
106. </pre>        
107. </p><p>
108.     To demonstrate that you can disable sorting on a column I simply preceded the column ID <code>FirstName</code> with a '!'.
109. </p><p>
110.     To make it more obvious that sorting is working for this example, I set the 
111.     initial sort column to the birth date column by setting the following <code>Table</code> attribute:
112.     <code>initialSortColumn="BirthDate"</code> ("BirthDate" is the ID of the column).
113. </p><p>
114.     Custom sorting is a bit more involved.
115.     The expression <code>=birthDateColumn</code> tells Tapestry to get an ITableColumn
116.     object for this column from a method named
117.     <code>getBirthDateColumn()</code>.
118. </p><p>
119.     To define this object, we'll have to change the <code>BasePage</code> derivative
120.     that underlies our page.  This is accomplished by making the following change to
121.     <code>FourthPass.page</code>:
122. </p><p>
123. <code class="snippet">
124. <page-specification 
125.     <code class="highlight">class="tapestrytables.CustomSortColumnPage"</code>>
126. </code>    
127. </p><p>
128.     Up until this example, all of our pages have been using the same 
129.     <code>BasePage</code> derivative.  With the additional requirement to implement
130.     custom sorting for one of the columns, we need to add a bit of code.  
131.     <code>CustomSortColumnPage.java</code> is the result.
132. </p><p>
133.     Below is the code added to <code>CustomSortColumnPage.java</code> that provides custom 
134.     sorting on the <code>BirthDate</code> column:
135. </p><p>
136. <pre><code class="highlight">
137.     public ITableColumn getBirthDateColumn()
138.     {
139.         // The column value is extracted in a custom evaluator class
140.         SimpleTableColumn birthDateColumn =  
141.            new SimpleTableColumn("Birth Date", new BirthDateColumnEvaluator(), true);
142.         birthDateColumn.setColumnComparator(new BirthDateComparator());
143.         return birthDateColumn;
144.     }
146.     /**
147.      * A class defining the logic for getting the BirthDate from a DataItem
148.      */
149.     private static class BirthDateColumnEvaluator implements ITableColumnEvaluator
150.     {
151.         /**
152.          * @see org.apache.tapestry.contrib.table.model.simple.ITableColumnEvaluator#getColumnValue(ITableColumn, Object)
153.          */
154.         public Object getColumnValue(ITableColumn objColumn, Object objRow)
155.         {
156.             DataItem dataItem = (DataItem) objRow;
157.             return dataItem.getBirthDate();
158.         }
159.     }
160. </code></pre>    
161. </p><p>
162.     Not shown here is the custom comparator that I created to compare two 
163.     <code>BirthDate</code> strings.  My <code>BirthDateComparator.java</code> is an 
164.     embarrassing hack, but it's sufficient to make this example work.
165. </p><p>
166.     At this point, our read-only table is pretty much complete.  There are a few more
167.     tweaks we could perform, but it's probably more interesting to move on to embedding
168.     components for individual fields in the table.
170. </p><p>
171. <a href="#" jwcid="@PageLink" page="FifthPass">Simple Editable Column...</a>
173. </p><p>
174.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
175. </p>
176. </body>
177. </html>
178. <!--
179.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
180.  * This work is hereby released into the Public Domain. 
181.  * To view a copy of the public domain dedication, visit 
182.  * http://creativecommons.org/licenses/publicdomain/ 
183.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
184.  * Stanford, California 94305, USA.
185. -->

FourthPass.page

 

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="tapestrytables.CustomSortColumnPage">
16.         <context-asset name="stylesheet" path="css/style.css"/>
18.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
19.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
20.         
21. </page-specification>

FourthPass.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

Home.html

1. <html jwcid="@Shell" title="Using The Tapestry Table Control" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Using The Tapestry Table Control</h1> 
7. <div class="note">    
8.     by John Reynolds: Updated on October 26th 2004
9. </div>
10. <p>
11.     This application demonstrates some common ways to use the Tapestry Table components.  
12.     Thanks to
13.     Howard Lewis Ship and the many subscribers of the Tapestry Users List who offered 
14.     suggestions and guidance. 
15. </p><p>
16.     The Table component and its supporting cast of components are very powerful
17.     and very flexible.  This is a double-edged sword that can result in confusion 
18.     when first learning how to use these components.
19. </p><p>
20.     This application provides a series of pages that demonstrate one way of configuring
21.     the Table to produce desired behaviors.  The chosen techniques may not be optimal,
22.     but hopefully they will be understandable and will help you figure out how to reach
23.     your own objectives.    
24. </p><p>
25.     Below is a standard HTML table that will serve as the basis for all of the 
26.     examples.
27.     A guiding principal of Tapestry is to preserve the ability to view the HTML 
28.     templates in a standard browser.  In the spirit of this principal, I will use
29.     the following HTML table as the starting point for all that follows:
30. </p><p>
31.     <table class="mytable">
32.         <th>SSN</th>
33.         <th>First Name</th>
34.         <th>Last Name</th>
35.         <th>Birth Date</th>
36.         <th>Height</th>
37.         <th>Weight</th>
38.         <tr class="even">
39.             <td>123-44-5555</td>
40.             <td>John</td>
41.             <td>Reynolds</td>
42.             <td>06/02/1960</td>
43.             <td>5' 11"</td>
44.             <td>185</td>
45.         </tr>
46.         <tr class="odd">
47.             <td>123-44-5555</td>
48.             <td>John</td>
49.             <td>Reynolds</td>
50.             <td>06/02/1960</td>
51.             <td>5' 11"</td>
52.             <td>185</td>
53.         </tr>
54.         <tr class="even">
55.             <td>123-44-5555</td>
56.             <td>John</td>
57.             <td>Reynolds</td>
58.             <td>06/02/1960"</td>
59.             <td>5' 11"</td>
60.             <td>185</td>
61.         </tr>
62.         <tr class="odd">
63.             <td>123-44-5555</td>
64.             <td>John</td>
65.             <td>Reynolds</td>
66.             <td>06/02/1960</td>
67.             <td>5' 11"</td>
68.             <td>185</td>
69.         </tr>
70.         <tr class="even">
71.             <td>123-44-5555</td>
72.             <td>John</td>
73.             <td>Reynolds</td>
74.             <td>10/01/2004</td>
75.             <td>5' 11"</td>
76.             <td>185</td>
77.         </tr>
78.         <tr class="odd">
79.             <td>123-44-5555</td>
80.             <td>John</td>
81.             <td>Reynolds</td>
82.             <td>10/01/2004</td>
83.             <td>5' 11"</td>
84.             <td>185</td>
85.         </tr>
86.     </table>
87. </p><p>
88.     The previous table is representative of the input that a Tapestry developer might
89.     receive from an HTML designer.  The table reflects the desired layout of the 
90.     columns and demonstrates the desired "look
91.     and feel" by using a css style sheet to dictate the appearance of the
92.     table.
93. </p><p>
94.     The data displayed by the table on this page is hard-coded.  The "real" data will be supplied
95.     by a Java Bean, and the data set will contain many more rows then conveniently fit
96.     on a single page.  The final application will split the data into multiple pages and 
97.     allow sorting on any column of the table... but we're getting ahead of ourselves...
98. </p><p>
99. <a href="#" jwcid="@PageLink" page="FirstPass">Basic Paging and Sortable Table...</a>
100. </p><p>
101. <a href="#" jwcid="@PageLink" page="SecondPass">Column Headings...</a>
102. </p><p>
103. <a href="#" jwcid="@PageLink" page="ThirdPass">Alternating Row Colors...</a>
104. </p><p>
105. <a href="#" jwcid="@PageLink" page="FourthPass">Custom Column Sorting...</a>
106. </p><p>
107. <a href="#" jwcid="@PageLink" page="FifthPass">Simple Editable Column...</a>
108. </p><p>
109. <a href="#" jwcid="@PageLink" page="SixthPass">Editable Column with Implicit Submit...</a>
110. </p><p>
111. <a href="#" jwcid="@PageLink" page="SeventhPass">Editable Columns using Formal Parameter Coding Style...</a>
112. </p><p>
113. <a href="#" jwcid="@PageLink" page="EighthPass">Validating Editable Columns...</a>
114. </p><p>
115. <a href="#" jwcid="@PageLink" page="NinthPass">Combining Validation and Sorting...</a>
116. </p><p>
117. <a href="#" jwcid="@PageLink" page="DirectLinkColumn">Direct Link Columns...</a>
118. </p><p>
119. <a href="#" jwcid="@PageLink" page="ColumnChooser">Choosing and Ordering Columns...</a>
120. </p><p>
121. <a href="#" jwcid="@PageLink" page="TenthPass">Using TableView, TableColumns, and TableFormRows..</a>
122. <a href="#" jwcid="@PageLink" page="Test">.</a>
123. </p>
124. </body>
125. </html>
126. <!--
127.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/
128.  * October 2004
129.  * This work is hereby released into the Public Domain. 
130.  * To view a copy of the public domain dedication, visit 
131.  * http://creativecommons.org/licenses/publicdomain/ 
132.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
133.  * Stanford, California 94305, USA.
134. -->

Home.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="org.apache.tapestry.html.BasePage">
16.     <description><![CDATA[   This is the home page   ]]></description>
17.     <context-asset name="stylesheet" path="css/style.css"/>
18. </page-specification>

NinthPass.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Combining Validation and Sorting</h1>
7. <div class="note">
8.     This page demonstrates how to implement an editable column that must be validated
9.     and has custom sorting.
10. </div>            
11. <p>
12.     It's sometimes necessary to combine validation and custom sorting.  This is actually
13.     very easy to do, and it's demonstrated below by making the Birth Date column editable
14.     while preserving the earlier custom sorting:
15. </p><p>
16.     <form jwcid="form">
18.     <table class="mytable" jwcid="table">
19.         <span jwcid="BirthDateColumnValue@Block">
20.            <span jwcid="editableBirthDate"/>
21.         </span>
22.         <span jwcid="WeightColumnValue@Block">
23.            <span jwcid="editableWeight"/>
24.         </span>
25.         <th>SSN</th>
26.         <th>First Name</th>
27.         <th>Last Name</th>
28.         <th>Birth Date</th>
29.         <th>Height</th>
30.         <th>Weight</th>
31.         <tr class="even">
32.             <td>123-44-5555</td>
33.             <td>John</td>
34.             <td>Reynolds</td>
35.             <td>10/01/2004</td>
36.             <td>5' 11"</td>
37.             <td>185</td>
38.         </tr>
39.         <tr class="odd">
40.             <td>123-44-5555</td>
41.             <td>John</td>
42.             <td>Reynolds</td>
43.             <td>10/01/2004</td>
44.             <td>5' 11"</td>
45.             <td>185</td>
46.         </tr>
47.         <tr class="even">
48.             <td>123-44-5555</td>
49.             <td>John</td>
50.             <td>Reynolds</td>
51.             <td>10/01/2004"</td>
52.             <td>5' 11"</td>
53.             <td>185</td>
54.         </tr>
55.         <tr class="odd">
56.             <td>123-44-5555</td>
57.             <td>John</td>
58.             <td>Reynolds</td>
59.             <td>10/01/2004</td>
60.             <td>5' 11"</td>
61.             <td>185</td>
62.         </tr>
63.         <tr class="even">
64.             <td>123-44-5555</td>
65.             <td>John</td>
66.             <td>Reynolds</td>
67.             <td>10/01/2004</td>
68.             <td>5' 11"</td>
69.             <td>185</td>
70.         </tr>
71.         <tr class="odd">
72.             <td>123-44-5555</td>
73.             <td>John</td>
74.             <td>Reynolds</td>
75.             <td>10/01/2004</td>
76.             <td>5' 11"</td>
77.             <td>185</td>
78.         </tr>
79.     </table>
80.     <input type="submit" value="Update"/>
81.     <span class="inputerror"><span jwcid="errors"/></span>
82.     </form>
83.     
84. </p><p>
85. </p><p>
86.     If you take a look at the files <code>NinthPass.page</code> 
87.     and <code>ValidateEditableColumnPage2.page</code> 
88.     you will see the changes necessary to validate the user's input.
89. </p><p>
90.     Here are the relevent snippets from <code>NinthPass.page</code> 
91.     that sets up validation for the <code>BirthDate</code> using the 
92.     bundled <code>PatternValidator</code> class:
93. <pre>
94. <code class="highlight">
95.    <bean name="birthDateValidator" class="org.apache.tapestry.valid.PatternValidator" lifecycle="page">
96.        <set-property name="required" expression="true"/>
97.        <set-property name="clientScriptingEnabled" expression="true"/>
98.        <set-property name="patternString">"//d//d///d//d///d//d//d//d$"</set-property> <
99.        <set-property name="patternNotMatchedMessage">
100.            "Error: Date improperly formatted.  Should be like: MM/DD/YYYY"</set-property>
101.    </bean>
103.    <component id="editableBirthDate" type="ValidField">
104.        <static-binding name="displayName">Weight</static-binding>
105.        <binding name="value" expression="components.table.tableRow.BirthDate"/>
106.        <binding name="size" expression="4"/>
107.        <binding name="validator" expression='beans.birthDateValidator'/>
108.    </component>
109. </code>        
110. </pre>
111. </p><p>
112.     Here is the relevent snippet from <code>NinthPass.html</code> 
113.     that sets up validation for the <code>BirthDate</code>:
114. <pre>
115. <code class="snippet">
116.     <table class="mytable" jwcid="table">
117. <code class="highlight">        <span jwcid="BirthDateColumnValue@Block">
118.            <span jwcid="editableBirthDate"/>
119.         </span>
120. </code>        <span jwcid="WeightColumnValue@Block">
121.            <span jwcid="editableWeight"/>
122.         </span>
123. </code>        
124. </pre>    
125. </p><p>
126.     Finally, here is the relevent snippet from <code>ValidateEditableColumnPage2.java</code> 
127.     that picks up the <code>ValidField</code> component for the <code>BirthDate</code>:
128. <pre>
129. <code class="snippet">
130.     public ITableColumn getBirthDateColumn()
131.     {
132.         // The column value is extracted in a custom evaluator class
133.         SimpleTableColumn birthDateColumn =  new SimpleTableColumn("BirthDate", new BirthDateColumnEvaluator(), true);
134.         birthDateColumn.setColumnComparator(new BirthDateComparator());
136. <code class="highlight">        // Pick up any settings from the template and page
137.         birthDateColumn.loadSettings(this);
138. </code>
139.         return birthDateColumn;
140.     }
141. </code>    
142. </pre>
143. </p><p>
144.     The method <code>birthDateColumn.loadSettings(this)</code> picks up any relevent
145.     Blocks defined for <code>BirthDate</code> in the template of this page, exactly as if
146.     the column was defined in the standard way.
149. </p><p>
150. <a href="#" jwcid="@PageLink" page="DirectLinkColumn">Direct Link Columns...</a>
152. </p><p>
153.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
154. </p>
155. </body>
156. </html>
157. <!--
158.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
159.  * This work is hereby released into the Public Domain. 
160.  * To view a copy of the public domain dedication, visit 
161.  * http://creativecommons.org/licenses/publicdomain/ 
162.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
163.  * Stanford, California 94305, USA.
164. -->

NinthPass.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="tapestrytables.ValidateEditableColumnPage2">
16.         <context-asset name="stylesheet" path="css/style.css"/>
17.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
19.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
21.         <bean name="delegate" class="org.apache.tapestry.valid.ValidationDelegate"/>
22.         
23.         <bean name="numberValidator" class="org.apache.tapestry.valid.NumberValidator" lifecycle="page">
24.             <set-property name="required" expression="true"/>
25.             <set-property name="clientScriptingEnabled" expression="false"/>
26.         </bean>
28.         <bean name="birthDateValidator" class="org.apache.tapestry.valid.PatternValidator" lifecycle="page">
29.             <set-property name="required" expression="true"/>
30.             <set-property name="clientScriptingEnabled" expression="false"/>
31.             <set-property name="patternString">"//d//d///d//d///d//d//d//d$"</set-property> 
32.             <set-property name="patternNotMatchedMessage">
33.                 "Error: Date improperly formatted.  Should be like: MM/DD/YYYY"</set-property>
34.         </bean>
35.         
36.         <component id="form" type="Form">
37.             <binding name="listener" expression="listeners.formSubmit"/>
38.             <binding name="delegate" expression="beans.delegate"/>
39.         </component>
40.                 
41.         <component id="table" type="contrib:FormTable">
42.             <binding name="source" expression="dataItems"/>
43.             <binding name="convertor" expression="dataItemConvertor"/>
44.             <static-binding name="columns"
45.                 value="
46.                     SSN, 
47.                     FirstName, 
48.                     LastName, 
49.                     =birthDateColumn, 
50.                     Height, 
51.                     Weight"/>
52.             <binding name="rowsClass" expression="beans.evenOdd.next"/>
53.             <binding name="pageSize" expression="6"/>
54.             <static-binding  name="initialSortColumn" value="BirthDate"/>
55.         </component>
57.         <component id="editableBirthDate" type="ValidField">
58.             <static-binding name="displayName">Weight</static-binding>
59.             <binding name="value" expression="components.table.tableRow.BirthDate"/>
60.             <binding name="size" expression="10"/>
61.             <binding name="validator" expression='beans.birthDateValidator'/>
62.         </component>
64.         
65.         <component id="editableWeight" type="ValidField">
66.             <static-binding name="displayName">Weight</static-binding>
67.             <binding name="value" expression="components.table.tableRow.Weight"/>
68.             <binding name="size" expression="4"/>
69.             <binding name="validator" expression='beans.numberValidator'/>
70.         </component>
72.         <component id="errors" type="Delegator">
73.             <binding name="delegate" expression="beans.delegate.firstError"/>
74.         </component>
75. </page-specification>

NinthPass.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

SecondPass.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.         <h1>Column Headings</h1>
7. <div class="note">
8.     This page demonstrates how to get column names from a property file.
9. </div>            
10. <p>
11.     This is our second attempt to implement the table using Tapestry components.
12.     Our first pass was functionally awesome, but the "look" of the page left
13.     much to be desired.  In the table below, you will see that we've cleaned
14.     up the column names:
15. </p><p>
16.     <table class="mytable" jwcid="table@contrib:Table"
17.     source="ognl:dataItems"
18.     columns="SSN, FirstName, LastName, 
19.         BirthDate, Height, Weight">
20.         <th>SSN</th>
21.         <th>First Name</th>
22.         <th>Last Name</th>
23.         <th>Birth Date</th>
24.         <th>Height</th>
25.         <th>Weight</th>
26.         <tr class="even">
27.             <td>123-44-5555</td>
28.             <td>John</td>
29.             <td>Reynolds</td>
30.             <td>06/02/1960</td>
31.             <td>5' 11"</td>
32.             <td>185</td>
33.         </tr>
34.         <tr class="odd">
35.             <td>123-44-5555</td>
36.             <td>John</td>
37.             <td>Reynolds</td>
38.             <td>06/02/1960</td>
39.             <td>5' 11"</td>
40.             <td>185</td>
41.         </tr>
42.         <tr class="even">
43.             <td>123-44-5555</td>
44.             <td>John</td>
45.             <td>Reynolds</td>
46.             <td>06/02/1960"</td>
47.             <td>5' 11"</td>
48.             <td>185</td>
49.         </tr>
50.         <tr class="odd">
51.             <td>123-44-5555</td>
52.             <td>John</td>
53.             <td>Reynolds</td>
54.             <td>06/02/1960</td>
55.             <td>5' 11"</td>
56.             <td>185</td>
57.         </tr>
58.         <tr class="even">
59.             <td>123-44-5555</td>
60.             <td>John</td>
61.             <td>Reynolds</td>
62.             <td>06/02/1960</td>
63.             <td>5' 11"</td>
64.             <td>185</td>
65.         </tr>
66.         <tr class="odd">
67.             <td>123-44-5555</td>
68.             <td>John</td>
69.             <td>Reynolds</td>
70.             <td>06/02/1960</td>
71.             <td>5' 11"</td>
72.             <td>185</td>
73.         </tr>
74.     </table>
75.     
76. </p><p>
77.     If you take a look at the file <code>SecondPass.properties</code> 
78.     you will see what we had to do to improve the "look" of this page.
79.     The files <code>SecondPass.html</code> and <code>SecondPass.page</code>
80.     are just renamed copies of the files from the previous example.
81. </p><p>      
82.     When you create a properties file, 
83.     the properties defined in the file will override any column names defined in 
84.     the "page" or html "template".
85.     For example, the title for the <code>BirthDate</code> column on this page is coming from  
86.     <code>SecondPass.properties</code>.  
87.     The string '<code>BirthBirthDate = Birth Date</code>' overrides any setting in
88.     <code>SecondPass.html</code>. This is a very
89.     valuable technique, especially when you want to internationalize your applications.
90. </p><p>
91.     Here are the property definitions from <code>SecondPass.properties</code>:
92. <pre><code class="highlight">
93. SSNSSN = SSN
94. FirstFirstName = First Name
95. LastLastName = Last Name
96. BirthBirthDate = Birth Date
97. HeightHeight = Height
98. WeightWeight = Weight
99. </code></pre>    
100. </p><p>
101.     
102.     We still haven't achieved the "look" that we want, but we are getting closer.
103. </p><p>
104. <a href="#" jwcid="@PageLink" page="ThirdPass">Alternating Row Colors...</a>
105. </p><p>
106.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
107. </p>
108. </body>
109. </html>
110. <!--
111.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
112.  * This work is hereby released into the Public Domain. 
113.  * To view a copy of the public domain dedication, visit 
114.  * http://creativecommons.org/licenses/publicdomain/ 
115.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
116.  * Stanford, California 94305, USA.
117. -->

SecondPass.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="tapestrytables.FirstPass">
16.         <context-asset name="stylesheet" path="css/style.css"/>
18.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
19. </page-specification>

SecondPass.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

SeventhPass.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Editable Columns using Formal Parameter Coding Style</h1>
7. <div class="note">
8.     This page demonstrates how to use Tapestry's "formal" parameter style to 
9.     more cleanly divide the HTML from the component specifications.
10. </div>            
11. <p>        
12.     This page has the same functionality as the 
13.     <a href="#" jwcid="@PageLink" page="SixthPass">Editable Column with Implicit Submit</a>
14.     example, but I have
15.     switched from specifying details in the <code>html</code> file to specifying
16.     details in the <code>page</code> file.  This is referred to as using <code>formal</code>
17.     parameters.
18. </p><p>
19.     <form jwcid="form">
21.     <table class="mytable" jwcid="table">
22.         <span jwcid="WeightColumnValue">
23.            <span jwcid="editableWeight"/>
24.         </span>
25.         <th>SSN</th>
26.         <th>First Name</th>
27.         <th>Last Name</th>
28.         <th>Birth Date</th>
29.         <th>Height</th>
30.         <th>Weight</th>
31.         <tr class="even">
32.             <td>123-44-5555</td>
33.             <td>John</td>
34.             <td>Reynolds</td>
35.             <td>10/01/2004</td>
36.             <td>5' 11"</td>
37.             <td>185</td>
38.         </tr>
39.         <tr class="odd">
40.             <td>123-44-5555</td>
41.             <td>John</td>
42.             <td>Reynolds</td>
43.             <td>10/01/2004</td>
44.             <td>5' 11"</td>
45.             <td>185</td>
46.         </tr>
47.         <tr class="even">
48.             <td>123-44-5555</td>
49.             <td>John</td>
50.             <td>Reynolds</td>
51.             <td>10/01/2004"</td>
52.             <td>5' 11"</td>
53.             <td>185</td>
54.         </tr>
55.         <tr class="odd">
56.             <td>123-44-5555</td>
57.             <td>John</td>
58.             <td>Reynolds</td>
59.             <td>10/01/2004</td>
60.             <td>5' 11"</td>
61.             <td>185</td>
62.         </tr>
63.         <tr class="even">
64.             <td>123-44-5555</td>
65.             <td>John</td>
66.             <td>Reynolds</td>
67.             <td>10/01/2004</td>
68.             <td>5' 11"</td>
69.             <td>185</td>
70.         </tr>
71.         <tr class="odd">
72.             <td>123-44-5555</td>
73.             <td>John</td>
74.             <td>Reynolds</td>
75.             <td>10/01/2004</td>
76.             <td>5' 11"</td>
77.             <td>185</td>
78.         </tr>
79.     </table>
80.     <input type="submit" value="Update"/>
81.     </form>
82.     
83. </p><p>
84. </p><p>
85.     If you take a look at the files <code>SeventhPass.html</code>
86.     and <code>SeventhPass.page</code>, 
87.     you will notice significant changes from the earlier <code>html</code> and
88.     <code>page</code> files.  This is more a matter of style rather then substance,
89.     switching from the use of informal parameters to formal parameters.  Generally,
90.     more sophisticated pages benefit from formal parameters by reducing the "clutter"
91.     in the <code>html</code> file.
92. </p><p>
93.     Here are the relevent HTML snippets from <code>SeventhPass.html</code> 
94.     that sets up this component:
95. </p><p>
96.    
97. <code class="highlight">
98.     <form jwcid="form">
99. <br>        <table class="mytable" jwcid="table">
100. <br>        <span jwcid="WeightColumnValue">
101. <br>           <span jwcid="editableWeight"/>
102. <br>        </span>
103. </code>        
104. </p><p>
105.     As you can see, this is much less invasive.
106. </p><p>
107.     Here is the relevent snippets from <code>SeventhPass.page</code> 
108.     that sets up this component:
109. </p><p>
110.    
111. <code class="highlight">
112.     <pre>
113. <component id="form" type="Form">
114.     <binding name="listener" expression="listeners.formSubmit">
115. </component>
117. <component id="table" type="contrib:FormTable">
118.     <binding name="source" expression="dataItems"/>
119.     <binding name="convertor" expression="dataItemConvertor"/>
120.     <static-binding name="columns"
121.         value="
122.             SSN, 
123.             FirstName, 
124.             LastName, 
125.             =birthDateColumn, 
126.             Height, 
127.             Weight"/>
128.     <binding name="rowsClass" expression="beans.evenOdd.next"/>
129.     <binding name="pageSize" expression="6"/>
130.     <static-binding  name="initialSortColumn" value="BirthDate"/>
131. </component>
133. <component id="WeightColumnValue" type="Block"/>
135. <component id="editableWeight" type="TextField">
136.     <binding name="value" expression="components.table.tableRow.Weight"/>
137.     <binding name="size" expression="4"/>
138. </component>
139.     </pre>    
140. </code>
141. </p><p>
142.     As you can see, the world isn't quite perfect.  You must indicate on the
143.     <code>html</code> template whenever you wish to override the rendering of
144.     a column in a table even though the component is specified in the 
145.     <code>page</code> file.  Judging from the Tapestry Users List, this seems 
146.     to trip up newbies quite often.
147. </p><p>
148.     Now that we've changed coding styles, it's time to get back to adding 
149.     functionality.
152. </p><p>
153. <a href="#" jwcid="@PageLink" page="EighthPass">Validating Editable Columns...</a>
155. </p><p>
156.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
157. </p>
158. </body>
159. </html>
160. <!--
161.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
162.  * This work is hereby released into the Public Domain. 
163.  * To view a copy of the public domain dedication, visit 
164.  * http://creativecommons.org/licenses/publicdomain/ 
165.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
166.  * Stanford, California 94305, USA.
167. -->

SeventhPass.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
14. 
    
15. <page-specification class="tapestrytables.EditableColumnPage2">
16.         <context-asset name="stylesheet" path="css/style.css"/>
17.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
18.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
19. 
    
20.         <component id="form" type="Form">
21.             <binding name="listener" expression="listeners.formSubmit"/>
22.         </component>
23. 
    
24.         <component id="table" type="contrib:FormTable">
25.             <binding name="source" expression="dataItems"/>
26.             <binding name="convertor" expression="dataItemConvertor"/>
27.             <static-binding name="columns"
28.                 value="
29.                     SSN, 
30.                     FirstName, 
31.                     LastName, 
32.                     =birthDateColumn, 
33.                     Height, 
34.                     Weight"/>
35.             <binding name="rowsClass" expression="beans.evenOdd.next"/>
36.             <binding name="pageSize" expression="6"/>
37.             <static-binding  name="initialSortColumn" value="BirthDate"/>
38.         </component>
39. 
    
40.         <component id="WeightColumnValue" type="Block"/>
41.         <component id="editableWeight" type="TextField">
42.             <binding name="value" expression="components.table.tableRow.Weight"/>
43.             <binding name="size" expression="4"/>
44.         </component>
45. 
    
46. </page-specification>

SeventhPass.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

SixthPass.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Editable Column with Implicit Submit</h1>
7. <div class="note">
8.     This page demonstrates how to implement a table with an editable column
9.     that saves changes when "paging" or "sorting" the table.
10. </div>            
11. <p>        
12.     The first implementation of an editable column had a few drawbacks, one
13.     of which was the requirement to press the <code>Update</code> button
14.     to submit changes.
15. </p><p>
16.     The table below captures changes before changing the sort order or moving
17.     to another page:
18. </p><p>
19.     <form jwcid="@Form" listener="ognl:listeners.formSubmit"  >
21.     <table class="mytable" jwcid="table@contrib:FormTable"
22.     source="ognl:dataItems"
23.     convertor="ognl:dataItemConvertor"
24.     columns="SSN, FirstName, LastName, 
25.         =birthDateColumn, Height, Weight"
26.     rowsClass="ognl:beans.evenOdd.next"
27.     pageSize="6"
28.     initialSortColumn="BirthDate"    >
29.         <span jwcid="WeightColumnValue@Block">
30.            <span jwcid="editableWeight@TextField" value="ognl:components.table.tableRow.Weight" size="4"/>
31.         </span>
32.         <th>SSN</th>
33.         <th>First Name</th>
34.         <th>Last Name</th>
35.         <th>Birth Date</th>
36.         <th>Height</th>
37.         <th>Weight</th>
38.         <tr class="even">
39.             <td>123-44-5555</td>
40.             <td>John</td>
41.             <td>Reynolds</td>
42.             <td>10/01/2004</td>
43.             <td>5' 11"</td>
44.             <td>185</td>
45.         </tr>
46.         <tr class="odd">
47.             <td>123-44-5555</td>
48.             <td>John</td>
49.             <td>Reynolds</td>
50.             <td>10/01/2004</td>
51.             <td>5' 11"</td>
52.             <td>185</td>
53.         </tr>
54.         <tr class="even">
55.             <td>123-44-5555</td>
56.             <td>John</td>
57.             <td>Reynolds</td>
58.             <td>10/01/2004"</td>
59.             <td>5' 11"</td>
60.             <td>185</td>
61.         </tr>
62.         <tr class="odd">
63.             <td>123-44-5555</td>
64.             <td>John</td>
65.             <td>Reynolds</td>
66.             <td>10/01/2004</td>
67.             <td>5' 11"</td>
68.             <td>185</td>
69.         </tr>
70.         <tr class="even">
71.             <td>123-44-5555</td>
72.             <td>John</td>
73.             <td>Reynolds</td>
74.             <td>10/01/2004</td>
75.             <td>5' 11"</td>
76.             <td>185</td>
77.         </tr>
78.         <tr class="odd">
79.             <td>123-44-5555</td>
80.             <td>John</td>
81.             <td>Reynolds</td>
82.             <td>10/01/2004</td>
83.             <td>5' 11"</td>
84.             <td>185</td>
85.         </tr>
86.     </table>
87.     <input type="submit" value="Update"/>
88.     </form>
89.     
90. </p><p>
91. </p><p>
92.     If you take a look at the files <code>SixthPass.html</code>, <code>SixthPass.page</code> 
93.     and <code>EditableColumnPage2.java</code>, 
94.     you will see the changes made to submit the form before changing the sort order
95.     or paging.
96. </p><p>
97.     Here are the relevent HTML snippets from <code>SixthPass.html</code> 
98.     that sets up this component:
99. </p><p>
100.    
101. <code class="snippet"><pre>    
102.     <table class="mytable" <code class="highlight">jwcid="table@contrib:FormTable"</code> 
103.     source="ognl:dataItems"
104.     <code class="highlight">convertor="ognl:dataItemConvertor"</code>
105.     columns="SSN, FirstName, LastName, 
106.     =birthDateColumn, Height, Weight"
107.     rowsClass="ognl:beans.evenOdd.next"
108.     pageSize="6"    
109.     initialSortColumn="BirthDate" >
110.             
111.     <span jwcid="WeightColumnValue@Block">
112.     <span jwcid="editableWeight@TextField" value="ognl:components.table.tableRow.Weight" size="4"/>
113.     </span>
114. </pre></code>        
115. </p><p>
116.     There are some big changes here, the table is now based on <code>contrib:FormTable</code>
117.     rather then <code>contrib:Table</code>.  <code>FormTable</code> does many things for us, 
118.     including making sure that the form is submitted whenever the table is paged or the sort
119.     order is changed. 
120. </p><p>
121.     <code>FormTable</code> also stores data into the form itself
122.     using hidden fields to avoid a <code>StaleLinkException</code> if the data changes on
123.     the server before the form is submitted.  
124.     A side effect of this is that the default behavior of the <code>FormTable</code> is to modify 
125.     copies of the data rather then the source data itself.  Eventually we will need this behavior,
126.     but for this page we will force the <code>FormTable</code> to use the source objects directly.
127.     To do this
128.     we must implement an <code>IPrimaryKeyConvertor</code> and pass it to the <code>FormTable</code>.
129. </p><p>
130.     The line:<code>convertor="ognl:dataItemConvertor"</code> configures the <code>FormTable</code>
131.     to get each <code>DataItem</code> by calling <code>getDataItemConvertor().getValue(Object objPrimaryKey)</code>.
132.     To create an <code>IPrimaryKeyConvertor</code> to return the original source objects, we added
133.     the following to <code>EditableColumnPage2.java</code>.
134. </p><p>
135. <code class="highlight">
136. <pre>
137.     private IPrimaryKeyConvertor m_dataItemConvertor;
139.     public EditableColumnPage2()
140.     {
141.         super();
142.         // define a IPrimaryKeyConvertor that gets DataItems from the original list 
143.         m_dataItemConvertor = new IPrimaryKeyConvertor()
144.         {
145.             public Object getPrimaryKey(Object objValue)
146.             {
147.                 DataItem dataItem = (DataItem) objValue;
148.                 return dataItem.getSSN();
149.             }
151.             public Object getValue(Object objPrimaryKey)
152.             {
153.                 String SSN = (String)objPrimaryKey;
154.                 List list = getDataItems();
156.                 // find the item
157.                 int count = list.size();
158.                 for (int i = 0; i < count; i++)
159.                 {
160.                     DataItem item = (DataItem) list.get(i);
161.                     if (item.getSSN().equals(SSN)){
162.                         return item;
163.                     }
164.                 }
165.                 return new DataItem(); //Handle data item not found 
166.             }
167.         };
168.         
169.     }
171.     public IPrimaryKeyConvertor getDataItemConvertor()
172.     {
173.         return m_dataItemConvertor;
174.     }
175. </pre></code>    
176. </p><p>
177.     This looks like an aweful lot of work just to get the <code>FormTable</code> to
178.     update the original source objects rather then copies, but you would seldomly
179.     do things this way.  Generally, when users are updating values, you will want
180.     to validate the input.  We'll get to that soon.
182. </p><p>
183. <a href="#" jwcid="@PageLink" page="SeventhPass">Using Formal Parameter Coding Style...</a>
185. </p><p>
186.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
187. </p>
188. </body>
189. </html>
190. <!--
191.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
192.  * This work is hereby released into the Public Domain. 
193.  * To view a copy of the public domain dedication, visit 
194.  * http://creativecommons.org/licenses/publicdomain/ 
195.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
196.  * Stanford, California 94305, USA.
197. -->

SixthPass.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
14. 
    
15. <page-specification class="tapestrytables.EditableColumnPage2">
16.         <context-asset name="stylesheet" path="css/style.css"/>
17. 
    
18.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
19.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
20.         
21. </page-specification>

SixthPass.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

TapestryTables.application

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE application
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
14. 
    
15. 
    
16. <application name="TapestryTables" engine-class="org.apache.tapestry.engine.BaseEngine" >
17. 
    
18.     <description><![CDATA[   This application demonstrates the Tapestry Table components   ]]></description>
19.     <property name="org.apache.tapestry.visit-class">tapestrytables.TapestryTablesVisit</property>
20.     <library id="contrib" specification-path="/org/apache/tapestry/contrib/Contrib.library"/>
21.     <page name="Home" specification-path="Home.page"/>
22. </application>

TenthPass.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Using TableView, TableColumns, and TableFormRows</h1>
7. <div class="note">
8.     This page demonstrates how to implement a table using TableView, TableColumns, and TableFormRows.
9. </div>            
10. <p>
11.     The <code>Table</code> and <code>FormTable</code> components wrap several underlying components 
12.     to simplify common usage scenarios.  If you need to exert more control over the look of your table
13.     you can use these building blocks directly.  For example, you can control where the 
14.     "paging" component is displayed:
15. </p><p>
16.     <form jwcid="form">
17. 
    
18.     <table class="mytable" jwcid="tableView">
19.       <span jwcid="tableColumns"/>
20.       <span jwcid="tableRows">
21.           <span jwcid="BirthDateColumnValue@Block">
22.              <span jwcid="editableBirthDate"/>
23.           </span>
24.           <span jwcid="WeightColumnValue@Block">
25.              <span jwcid="editableWeight"/>
26.           </span>
27.           <span jwcid="tableValues@contrib:TableValues"/>
28.       </span>
29.       <tr>
30.          <td colspan="7" class="tablepager">
31.             <span jwcid="tablePages@contrib:TableFormPages"/>
32.          </td>   
33.       </tr>
34. <span jwcid="$remove$">
35.         <th>SSN</th>
36.         <th>First Name</th>
37.         <th>Last Name</th>
38.         <th>Birth Date</th>
39.         <th>Height</th>
40.         <th>Weight</th>
41.         <tr class="even">
42.             <td>123-44-5555</td>
43.             <td>John</td>
44.             <td>Reynolds</td>
45.             <td>10/01/2004</td>
46.             <td>5' 11"</td>
47.             <td>185</td>
48.         </tr>
49.         <tr class="odd">
50.             <td>123-44-5555</td>
51.             <td>John</td>
52.             <td>Reynolds</td>
53.             <td>10/01/2004</td>
54.             <td>5' 11"</td>
55.             <td>185</td>
56.         </tr>
57.         <tr class="even">
58.             <td>123-44-5555</td>
59.             <td>John</td>
60.             <td>Reynolds</td>
61.             <td>10/01/2004"</td>
62.             <td>5' 11"</td>
63.             <td>185</td>
64.         </tr>
65.         <tr class="odd">
66.             <td>123-44-5555</td>
67.             <td>John</td>
68.             <td>Reynolds</td>
69.             <td>10/01/2004</td>
70.             <td>5' 11"</td>
71.             <td>185</td>
72.         </tr>
73.         <tr class="even">
74.             <td>123-44-5555</td>
75.             <td>John</td>
76.             <td>Reynolds</td>
77.             <td>10/01/2004</td>
78.             <td>5' 11"</td>
79.             <td>185</td>
80.         </tr>
81.         <tr class="odd">
82.             <td>123-44-5555</td>
83.             <td>John</td>
84.             <td>Reynolds</td>
85.             <td>10/01/2004</td>
86.             <td>5' 11"</td>
87.             <td>185</td>
88.         </tr>
89. </span>        
90.     </table>
91.     <input type="submit" value="Update"/>
92.     <span class="inputerror"><span jwcid="errors"/></span>
93.     </form>
94.     
95. </p><p>
96. </p><p>
97.     If you take a look at the files <code>TenthPass.page</code> 
98.     and <code>TenthPass.html</code> 
99.     you will see the changes necessary to implement this table.
100. </p><p>
101.     Here are the relevent snippets from <code>TenthPass.page</code> 
102.     :
103. <pre>
104. <code class="highlight">
105.     <component id="tableView" type="contrib:TableView">
106.         <binding name="source" expression="dataItems"/>
107.         <static-binding name="columns"
108.             value="
109.                 SSN, 
110.                 FirstName, 
111.                 LastName, 
112.                 =birthDateColumn, 
113.                 Height, 
114.                 Weight"/>
115.         <binding name="pageSize" expression="6"/>
116.         <static-binding  name="initialSortColumn" value="BirthDate"/>
117.         <static-binding name="cellpadding" value="2"/> 
118.         <static-binding name="cellspacing" value="0"/>
119.     </component>
120. 
     
121.     <component id="tableColumns" type="contrib:TableColumns">
122.         <static-binding name="class" value="columnheader"/>
123.     </component>
124. 
     
125.     <component id="tableRows" type="contrib:TableFormRows">
126.         <binding name="convertor" expression="dataItemConvertor"/>
127.         <binding name="class" expression="beans.evenOdd.next"/>
128.     </component>
129. </code><code class="snippet">
130.     <component id="editableBirthDate" type="ValidField">
131.         <static-binding name="displayName">Weight</static-binding>
132.         <binding name="value" <code class="highlight">expression="components.tableRows.tableRow.BirthDate"</code>/>
133.         <binding name="size" expression="10"/>
134.         <binding name="validator" expression='beans.birthDateValidator'/>
135.     </component>
136. 
     
137.     <component id="editableWeight" type="ValidField">
138.         <static-binding name="displayName">Weight</static-binding>
139.         <binding name="value" <code class="highlight">expression="components.tableRows.tableRow.Weight"</code>/>
140.         <binding name="size" expression="4"/>
141.         <binding name="validator" expression='beans.numberValidator'/>
142.     </component>
143. </code>        
144. </pre>
145. </p><p>
146.     Here is the relevent snippet from <code>TenthPass.html</code> 
147.     that sets up the layout:
148. <pre>
149. <code class="highlight">
150.     <table class="mytable" jwcid="tableView">
151.       <span jwcid="tableColumns"/>
152.       <span jwcid="tableRows">
153.           <span jwcid="BirthDateColumnValue@Block">
154.              <span jwcid="editableBirthDate"/>
155.           </span>
156.           <span jwcid="WeightColumnValue@Block">
157.              <span jwcid="editableWeight"/>
158.           </span>
159.           <span jwcid="tableValues@contrib:TableValues"/>
160.       </span>
161.       <tr>
162.          <td colspan="7" class="tablepager">
163.             <span jwcid="tablePages@contrib:TableFormPages"/>
164.          </td>   
165.       </tr>
166. </code>        
167. </pre>    
168. </p><p>
169. <!--
170. </p><p>
171. <a href="#" jwcid="@PageLink" page="FourthPass">Fourth Pass...</a>
172. -->
173. </p><p>
174.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
175. </p>
176. </body>
177. </html>
178. <!--
179.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ - October 2004
180.  * This work is hereby released into the Public Domain. 
181.  * To view a copy of the public domain dedication, visit 
182.  * http://creativecommons.org/licenses/publicdomain/ 
183.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
184.  * Stanford, California 94305, USA.
185. -->

TenthPass.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
14. 
    
15. <page-specification class="tapestrytables.ValidateEditableColumnPage2">
16.         <context-asset name="stylesheet" path="css/style.css"/>
17.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
18. 
    
19.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
20. 
    
21.         <bean name="delegate" class="org.apache.tapestry.valid.ValidationDelegate"/>
22.         
23.         <bean name="numberValidator" class="org.apache.tapestry.valid.NumberValidator" lifecycle="page">
24.             <set-property name="required" expression="true"/>
25.             <set-property name="clientScriptingEnabled" expression="false"/>
26.         </bean>
27. 
    
28.         <bean name="birthDateValidator" class="org.apache.tapestry.valid.PatternValidator" lifecycle="page">
29.             <set-property name="required" expression="true"/>
30.             <set-property name="clientScriptingEnabled" expression="false"/>
31.             <set-property name="patternString">"//d//d///d//d///d//d//d//d$"</set-property> 
32.             <set-property name="patternNotMatchedMessage">
33.                 "Error: Date improperly formatted.  Should be like: MM/DD/YYYY"</set-property>
34.         </bean>
35.         
36.         <component id="form" type="Form">
37.             <binding name="listener" expression="listeners.formSubmit"/>
38.             <binding name="delegate" expression="beans.delegate"/>
39.         </component>
40.                 
41.         <component id="tableView" type="contrib:TableView">
42.             <binding name="source" expression="dataItems"/>
43.             <static-binding name="columns"
44.                 value="
45.                     SSN, 
46.                     FirstName, 
47.                     LastName, 
48.                     =birthDateColumn, 
49.                     Height, 
50.                     Weight"/>
51.             <binding name="pageSize" expression="6"/>
52.             <static-binding  name="initialSortColumn" value="BirthDate"/>
53.             <static-binding name="cellpadding" value="2"/> 
54.             <static-binding name="cellspacing" value="0"/>
55.         </component>
56. 
    
57.         <component id="tableColumns" type="contrib:TableColumns">
58.             <static-binding name="class" value="columnheader"/>
59.         </component>
60. 
    
61.         <component id="tableRows" type="contrib:TableFormRows">
62.             <binding name="convertor" expression="dataItemConvertor"/>
63.             <binding name="class" expression="beans.evenOdd.next"/>
64.         </component>
65. 
    
66.         <component id="editableBirthDate" type="ValidField">
67.             <static-binding name="displayName">Weight</static-binding>
68.             <binding name="value" expression="components.tableRows.tableRow.BirthDate"/>
69.             <binding name="size" expression="10"/>
70.             <binding name="validator" expression='beans.birthDateValidator'/>
71.         </component>
72. 
    
73.         
74.         <component id="editableWeight" type="ValidField">
75.             <static-binding name="displayName">Weight</static-binding>
76.             <binding name="value" expression="components.tableRows.tableRow.Weight"/>
77.             <binding name="size" expression="4"/>
78.             <binding name="validator" expression='beans.numberValidator'/>
79.         </component>
80. 
    
81.         <component id="errors" type="Delegator">
82.             <binding name="delegate" expression="beans.delegate.firstError"/>
83.         </component>
84. </page-specification>

TenthPass.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

Test.html

1. <html jwcid="@Shell" title="Test" stylesheet="ognl:assets.stylesheet">
2. <!--
3.   Released in the Public Domain by John Reynolds
4. -->
5. <head jwcid="@Block">
6.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
7. </head>
8. <body jwcid="@Body">
9.     <h1>Test</h1> This page is a work in progress
10. <p>
11.     <form jwcid="form">
12.     <table class="mytable" jwcid="tableView">
13.     <span jwcid="tablePages@contrib:TableFormPages" class="tablepager"/>
14.     <span jwcid="tableColumns"/>
15.     <span jwcid="tableRows">
16.         <span jwcid="SelectRowColumnValue@Block">
17.            <span jwcid="selectRow"/>
18.         </span>
19.         <span jwcid="SSNColumnValue@Block">
20.            <span jwcid="editableSSN"/>
21.         </span>
22.         <span jwcid="tableValues@contrib:TableValues"/>
23.     </span>
24.     </table>
25.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
26.     <input type="submit" value="Update"/>
27.     <span class="inputerror"><span jwcid="errors"/></span>
28. Columns: <span jwcid="@PropertySelection" model="ognl:@tapestrytables.TestPage@COLUMNS_MODEL" value="ognl:columnsString" submitOnChange="true" />
29.     </form>
30. </p><p>
31.     Here's a list of examples to add:
32.     <ul>
33.         <li>Create a checkbox per row, and a "select all" checkbox</li>
34.         <li>Demonstrate a custom  TableModel for handling a huge number of rows</li>
35.     </ul>
36. </p>    
37. </body>
38. </html>

Test.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. 
   
6. <page-specification class="tapestrytables.TestPage">
7.         <context-asset name="stylesheet" path="css/style.css"/>
8.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
9. 
   
10.         <property-specification name="columnsString" type="java.lang.String" persistent="yes"/>
11.         
12.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
13.         <bean name="delegate" class="org.apache.tapestry.valid.ValidationDelegate"/>
14.         <bean name="ssnValidator" class="org.apache.tapestry.valid.PatternValidator" lifecycle="page">
15.             <set-property name="required" expression="true"/>
16.             <set-property name="clientScriptingEnabled" expression="false"/>
17.             <set-property name="patternString">"//d//d//d-//d//d-//d//d//d//d$"</set-property> 
18.             <set-property name="patternNotMatchedMessage">
19.                 "Error: SSN improperly formatted."</set-property>
20.         </bean>
21. 
    
22.         <component id="form" type="Form">
23.             <binding name="listener" expression="listeners.formSubmit"/>
24.             <binding name="delegate" expression="beans.delegate"/>
25.         </component>
26. 
    
27.         <component id="tableView" type="contrib:TableView">
28.             <binding name="source" expression="dataItems"/>
29.             <binding name="columns" expression="ColumnsString" />
30.                 
31. <!--            
32.             <static-binding name="columns"
33.                 value="
34.                     !SelectRow,
35.                     SSN,
36.                     FirstName,
37.                     LastName" />
38. -->                    
39.             <binding name="pageSize" expression="12"/>
40.             <static-binding name="cellpadding" value="2"/> 
41.             <static-binding name="cellspacing" value="0"/>
42.             <static-binding name="initialSortColumn" value="LastName"/>
43. 
    
44.         </component>
45. 
    
46.         <component id="tableColumns" type="contrib:TableColumns">
47.             <static-binding name="class" value="columnheader"/>
48.         </component>
49. 
    
50.         <component id="tableRows" type="contrib:TableFormRows">
51.             <binding name="convertor" expression="dataItemConvertor"/>
52.             <binding name="class" expression="beans.evenOdd.next"/>
53.         </component>
54. 
    
55.         <component id="editableSSN" type="ValidField">
56.             <static-binding name="displayName">SSN</static-binding>
57.             <binding name="value" expression="components.tableRows.tableRow.SSN"/>
58.             <binding name="size" expression="9"/>
59.             <binding name="validator" expression="beans.ssnValidator"/>
60.         </component>
61. 
    
62.         
63.         <component id="selectRow" type="Checkbox">
64.             <binding name="selected" expression="components.tableRows.tableRow.Selected"/>
65.         </component>
66.             
67.         <component id="errors" type="Delegator">
68.             <binding name="delegate" expression="beans.delegate.firstError"/>
69.         </component> 
70. </page-specification>

Test.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight
7. ColumnsString = FirstName, LastName, SSN

ThirdPass.html

1. <html jwcid="@Shell" title="Tapestry Table Controls Example" stylesheet="ognl:assets.stylesheet">
2. <head jwcid="@Block">
3.     <link rel="stylesheet" type="text/css" href="../css/style.css"/>
4. </head>
5. <body jwcid="@Body">
6.     <h1>Alternating Row Colors</h1>
7. <div class="note">
8.     This page demonstrates how to implement a table with alternating row colors and
9.     set the number of rows displayed on a page.
10. </div>            
11. <p>        
12.     This is our third pass at implementing the table using Tapestry components.
13.     Our second pass looked better, but the "look" of the page still wasn't right.
14.     We weren't picking up the "styles" that our HTML designer specified.
15. </p><p>
16.     <table class="mytable" jwcid="table@contrib:Table"
17.     source="ognl:dataItems"
18.     columns="SSN, FirstName, LastName, 
19.         BirthDate, Height, Weight"
20.     rowsClass="ognl:beans.evenOdd.next"
21.     pageSize="6"    >
22.         <th>SSN</th>
23.         <th>First Name</th>
24.         <th>Last Name</th>
25.         <th>Birth Date</th>
26.         <th>Height</th>
27.         <th>Weight</th>
28.         <tr class="even">
29.             <td>123-44-5555</td>
30.             <td>John</td>
31.             <td>Reynolds</td>
32.             <td>10/01/2004</td>
33.             <td>5' 11"</td>
34.             <td>185</td>
35.         </tr>
36.         <tr class="odd">
37.             <td>123-44-5555</td>
38.             <td>John</td>
39.             <td>Reynolds</td>
40.             <td>10/01/2004</td>
41.             <td>5' 11"</td>
42.             <td>185</td>
43.         </tr>
44.         <tr class="even">
45.             <td>123-44-5555</td>
46.             <td>John</td>
47.             <td>Reynolds</td>
48.             <td>10/01/2004"</td>
49.             <td>5' 11"</td>
50.             <td>185</td>
51.         </tr>
52.         <tr class="odd">
53.             <td>123-44-5555</td>
54.             <td>John</td>
55.             <td>Reynolds</td>
56.             <td>10/01/2004</td>
57.             <td>5' 11"</td>
58.             <td>185</td>
59.         </tr>
60.         <tr class="even">
61.             <td>123-44-5555</td>
62.             <td>John</td>
63.             <td>Reynolds</td>
64.             <td>10/01/2004</td>
65.             <td>5' 11"</td>
66.             <td>185</td>
67.         </tr>
68.         <tr class="odd">
69.             <td>123-44-5555</td>
70.             <td>John</td>
71.             <td>Reynolds</td>
72.             <td>10/01/2004</td>
73.             <td>5' 11"</td>
74.             <td>185</td>
75.         </tr>
76.     </table>
77.     
78. </p><p>
79.     If you take a look at the files <code>ThirdPass.html</code> and <code>ThirdPass.page</code>, 
80.     you will see the changes made to improve the "look" of this page.  Tapestry includes
81.     a bean called <code>EvenOdd</code> that produces the alternating strings 
82.     "even" and "odd".  
83.     By binding the <code>rowsClass</code> attribute of the <code>Table</code> to the 
84.     <code>EvenOdd</code> Java Bean, we are able to specify alternating <code>class</code>
85.     attributes on each row of the table.  Coupled with the CSS style sheet, this gives
86.     us the altenating row colors that our HTML designer specified (Note: the CSS styles
87.     must be "even" and "odd" for this to work).
88. </p><p>
90.     Here is the relevent HTML snippet from <code>ThirdPass.html</code> 
91.     that sets up this component:
92. </p><p>
93.    
94. <code class="snippet">    
95.     <table class="mytable" jwcid="table@contrib:Table" 
96. <br>
97.     source="ognl:dataItems"
98. <br>
99.     columns="SSN, FirstName, LastName, BirthDate, Height, Weight"
100. <br>    
101.     <code class="highlight">rowsClass="ognl:beans.evenOdd.next"</code>
102. <br>    
103.     <code class="highlight">pageSize="6"</code> >
104. </code>        
105. </p><p>
106.     The <code>evenOdd</code> bean was added to this page's context in 
107.     <code>ThirdPass.page</code> by adding the following line:
108. </p><p>
109. <code class="highlight">    
110.     <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
111. </code>    
112. </p><p>
113.     To really understand what's going on you will have to delve deeper into the
114.     Tapestry documentation, but I think this illustrates that the effort is worthwhile.
115. </p><p>
116.     You may have also noticed that the table is now displaying a maximum of 6 rows 
117.     per page.  
118.     This was accomplished by setting the <code>pageSize</code> attribute of the Table.
119. </p><p>
120.     We're very close to being done.
122. </p><p>
123. <a href="#" jwcid="@PageLink" page="FourthPass">Custom Column Sorting...</a>
125. </p><p>
126.     <a href="#" jwcid="@PageLink" page="Home">Return to Home page</a>.
127. </p>
128. </body>
129. </html>
130. <!--
131.  * Released in the Public Domain by John Reynolds: http://weblogs.java.net/blog/johnreynolds/ 
132.  * October 2004
133.  * This work is hereby released into the Public Domain. 
134.  * To view a copy of the public domain dedication, visit 
135.  * http://creativecommons.org/licenses/publicdomain/ 
136.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
137.  * Stanford, California 94305, USA.
138. -->

ThirdPass.page

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE page-specification
3.       PUBLIC "-//Apache Software Foundation//Tapestry Specification 3.0//EN"
4.       "http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
15. <page-specification class="tapestrytables.FirstPass">
16.         <context-asset name="stylesheet" path="css/style.css"/>
18.         <property-specification name="dataItems" type="java.util.List" persistent="yes"/>
19.         <bean name="evenOdd" class="org.apache.tapestry.bean.EvenOdd"/>
20.         
21. </page-specification>

ThirdPass.properties

1. SSNSSN = SSN
2. FirstFirstName = First Name
3. LastLastName = Last Name
4. BirthBirthDate = Birth Date
5. HeightHeight = Height
6. WeightWeight = Weight

web.xml

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE web-app
3.       PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
4.       "http://java.sun.com/dtd/web-app_2_3.dtd">
5. <!-- generated by Spindle, http://spindle.sourceforge.net -->
6. <!--
7.  * Contributed by John Reynolds - October 2004
8.  * This work is hereby released into the Public Domain. 
9.  * To view a copy of the public domain dedication, visit 
10.  * http://creativecommons.org/licenses/publicdomain/ 
11.  * or send a letter to Creative Commons, 559 Nathan Abbott Way, 
12.  * Stanford, California 94305, USA.
13. -->
16. <web-app>
17.     <display-name>TapestryTables</display-name>
18.     <filter>
19.         <filter-name>redirect</filter-name>
20.         <filter-class>org.apache.tapestry.RedirectFilter</filter-class>
21.     </filter>
22.     <filter-mapping>
23.         <filter-name>redirect</filter-name>
24.         <url-pattern>/</url-pattern>
25.     </filter-mapping>
26.     <servlet>
27.         <servlet-name>TapestryTables</servlet-name>
28.         <servlet-class>org.apache.tapestry.ApplicationServlet</servlet-class>
29.         <load-on-startup>1</load-on-startup>
30.     </servlet>
31.     <servlet-mapping>
32.         <servlet-name>TapestryTables</servlet-name>
33.         <url-pattern>/app</url-pattern>
34.     </servlet-mapping>
35. </web-app>