这是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. -->

  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"/>

  20.         <component id="form" type="Form">
  21.             <binding name="listener" expression="listeners.formSubmit"/>
  22.         </component>

  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>

  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>

  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. -->

  15. <page-specification class="tapestrytables.EditableColumnPage2">
  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>
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. -->


  16. <application name="TapestryTables" engine-class="org.apache.tapestry.engine.BaseEngine" >

  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">

  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>

  121.     <component id="tableColumns" type="contrib:TableColumns">
  122.         <static-binding name="class" value="columnheader"/>
  123.     </component>

  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>

  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. -->

  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="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>

  57.         <component id="tableColumns" type="contrib:TableColumns">
  58.             <static-binding name="class" value="columnheader"/>
  59.         </component>

  61.         <component id="tableRows" type="contrib:TableFormRows">
  62.             <binding name="convertor" expression="dataItemConvertor"/>
  63.             <binding name="class" expression="beans.evenOdd.next"/>
  64.         </component>

  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>

  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>

  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">

  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"/>

  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>

  22.         <component id="form" type="Form">
  23.             <binding name="listener" expression="listeners.formSubmit"/>
  24.             <binding name="delegate" expression="beans.delegate"/>
  25.         </component>

  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"/>

  44.         </component>

  46.         <component id="tableColumns" type="contrib:TableColumns">
  47.             <static-binding name="class" value="columnheader"/>
  48.         </component>

  50.         <component id="tableRows" type="contrib:TableFormRows">
  51.             <binding name="convertor" expression="dataItemConvertor"/>
  52.             <binding name="class" expression="beans.evenOdd.next"/>
  53.         </component>

  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>

  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>

Logo
开放原子开发者工作坊

开放原子开发者工作坊旨在鼓励更多人参与开源活动，与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动，如meetup、训练营等，主打技术交流，干货满满，真诚地邀请各位开发者共同参与！

更多推荐

以智能 致世界 | 操作系统大会2024议程全览

avatar 开放原子开发者工作坊

开放原子开源基金会新增捐赠人（2024年9月）

2024年9月，新增以下单位成为开放原子开源基金会及旗下项目捐赠人。

avatar 开放原子开发者工作坊

2024开放原子开发者大会议题征集正式开启

2024开放原子开发者大会（以下简称“大会”）将于12月中旬重磅来袭,2024开放原子开发者大会议题征集正式开启!

avatar 开放原子开发者工作坊