Hi,
I need to display the data table horizontally instead of vertically in my project. Based on my search on this forum, I need to write a custom renderer. I want to look at the implementation of the RepeaterRenderer example, can anyone please tell me where to find it?
thanks a lot.
kiki
Here is the source:
/*
* $Id: RepeaterRenderer.java,v 1.2.10.2 2004/02/05 19:12:36 rlubke Exp $
*/
/*
* Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or
* without modification, are permitted provided that the following
* conditions are met:
*
* - Redistributions of source code must retain the above copyright
*notice, this list of conditions and the following disclaimer.
*
* - Redistribution in binary form must reproduce the above
*copyright notice, this list of conditions and the following
*disclaimer in the documentation and/or other materials
*provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of
* contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any
* kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
* WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
* EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY
* DAMAGES OR LIABILITIES SUFFERED BY LICENSEE AS A RESULT OF OR
* RELATING TO USE, MODIFICATION OR DISTRIBUTION OF THIS SOFTWARE OR
* ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE
* FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT,
* SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER
* CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF
* THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS
* BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed, licensed or
* intended for use in the design, construction, operation or
* maintenance of any nuclear facility.
*/
package components.renderkit;
import javax.faces.component.UIColumn;
import javax.faces.component.UIComponent;
import javax.faces.component.UIData;
import javax.faces.context.FacesContext;
import javax.faces.context.ResponseWriter;
import java.io.IOException;
import java.util.Iterator;
/**
*
<code>Renderer</code> that supports generating markup for the per-row data
* associated with a <code>UIData</code> component. You can easily specialize
* the behavior of the <code>Renderer</code> by subclassing and overriding the
* <code>tableBegin()</code>, <code>rowBegin()</code>,
* <code>rowBody()</code>, <code>rowEnd()</code>, and <code>tableEnd()</code>
* methods. The default implementation renders an HTML table with
* headers and footers.
*/
public class RepeaterRenderer extends BaseRenderer {
// -- Renderer Methods
/**
*
Render the beginning of the table for our associated data.
*
* @param context<code>FacesContext</code> for the current request
* @param component <code>UIComponent</code> being rendered
*
* @throws IOException if an input/output error occurs
*/
public void encodeBegin(FacesContext context, UIComponent component)
throws IOException {
super.encodeBegin(context, component);
ResponseWriter writer = context.getResponseWriter();
UIData data = (UIData) component;
// Render the beginning of this table
data.setRowIndex(-1);
tableBegin(context, data, writer);
}
/**
*
Render the body rows of the table for our associated data.
*
* @param context<code>FacesContext</code> for the current request
* @param component <code>UIComponent</code> being rendered
*
* @throws IOException if an input/output error occurs
*/
public void encodeChildren(FacesContext context, UIComponent component)
throws IOException {
super.encodeChildren(context, component);
ResponseWriter writer = context.getResponseWriter();
UIData data = (UIData) component;
int processed = 0;
int rowIndex = data.getFirst() - 1;
int rows = data.getRows();
// Iterate over the specified rows of data
while (true) {
// Have we displayed the requested number of rows?
if ((rows > 0) && (++processed > rows)) {
break;
}
// Select the next row (if there is one)
data.setRowIndex(++rowIndex);
if (!data.isRowAvailable()) {
break;
}
// Render the beginning, body, and ending of this row
rowBegin(context, data, writer);
rowBody(context, data, writer);
rowEnd(context, data, writer);
}
}
/**
*
Render the ending of the table for our associated data.
*
* @param context<code>FacesContext</code> for the current request
* @param component <code>UIComponent</code> being rendered
*
* @throws IOException if an input/output error occurs
*/
public void encodeEnd(FacesContext context, UIComponent component)
throws IOException {
super.encodeEnd(context, component);
ResponseWriter writer = context.getResponseWriter();
UIData data = (UIData) component;
// Render the ending of this table
data.setRowIndex(-1);
tableEnd(context, data, writer);
}
/**
*
Return <code>true</code> to indicate that we do indeed wish to be
* responsible for rendering the children of the associated component.
*/
public boolean getRendersChildren() {
return (true);
}
// - Protected Methods
/**
*
Return the number of child components of type <code>UIColumn</code>
* are registered with the specified <code>UIData</code> component.
*
* @param data <code>UIData</code> component for which to count
*/
protected int getColumnCount(UIData data) {
int n = 0;
Iterator kids = data.getChildren().iterator();
while (kids.hasNext()) {
if (kids.next() instanceof UIColumn) {
n++;
}
}
return (n);
}
/**
*
Return the number of child components of type <code>UIColumn</code>
* are registered with the specified <code>UIData</code> component
* and have a facet named <code>footer</code>.
*
* @param data <code>UIData</code> component for which to count
*/
protected int getColumnFooterCount(UIData data) {
int n = 0;
Iterator kids = data.getChildren().iterator();
while (kids.hasNext()) {
UIComponent kid = (UIComponent) kids.next();
if ((kid instanceof UIColumn) &&
(kid.getFacet("footer") != null)) {
n++;
}
}
return (n);
}
/**
*
Return the number of child components of type <code>UIColumn</code>
* are registered with the specified <code>UIData</code> component
* and have a facet named <code>header</code>.
*
* @param data <code>UIData</code> component for which to count
*/
protected int getColumnHeaderCount(UIData data) {
int n = 0;
Iterator kids = data.getChildren().iterator();
while (kids.hasNext()) {
UIComponent kid = (UIComponent) kids.next();
if ((kid instanceof UIColumn) &&
(kid.getFacet("header") != null)) {
n++;
}
}
return (n);
}
/**
*
Render the markup for the beginning of the current body row. The
* default implementation renders <code><tr></code>.
*
* @param context <code>FacesContext</code> for the current request
* @param data<code>UIData</code> being rendered
* @param writer <code>ResponseWriter</code> to render to
*
* @excepton IOException if an input/output error occurs
*/
protected void rowBegin(FacesContext context, UIData data,
ResponseWriter writer) throws IOException {
writer.startElement("tr", data);
writer.writeText("\n", null);
}
/**
*
Render the markup for the content of the current body row. The
* default implementation renders the descendant components of each
* child <code>UIColumn</code>, surrounded by <code><td></code>
* and <code></td></code>.
*
* @param context <code>FacesContext</code> for the current request
* @param data<code>UIData</code> being rendered
* @param writer <code>ResponseWriter</code> to render to
*
* @excepton IOException if an input/output error occurs
*/
protected void rowBody(FacesContext context, UIData data,
ResponseWriter writer) throws IOException {
// Iterate over the UIColumn children of this UIData component
Iterator columns = data.getChildren().iterator();
while (columns.hasNext()) {
// Only process UIColumn children
UIComponent column = (UIComponent) columns.next();
if (!(column instanceof UIColumn)) {
continue;
}
// Create the markup for this column
writer.startElement("td", column);
Iterator contents = column.getChildren().iterator();
while (contents.hasNext()) {
encodeRecursive(context, (UIComponent) contents.next());
}
writer.endElement("td");
writer.writeText("\n", null);
}
}
/**
*
Render the markup for the ending of the current body row. The
* default implementation renders <code></tr></code>.
*
* @param context <code>FacesContext</code> for the current request
* @param data<code>UIData</code> being rendered
* @param writer <code>ResponseWriter</code> to render to
*
* @excepton IOException if an input/output error occurs
*/
protected void rowEnd(FacesContext context, UIData data,
ResponseWriter writer) throws IOException {
writer.endElement("tr");
writer.writeText("\n", null);
}
/**
*
Render the markup for the beginnning of an entire table. The
* default implementation renders:
* <ul>
* <li>A <code><table></code> element.</li>
* <li>If the <code>UIData</code> component has a facet named
* <code>header</code>, render it in a table row with a
* <code>colspan</code> set to span all the columns in the table.</li>
* <li>If any of the child <code>UIColumn</code> components has a facet
* named <code>header</code>, render them in a table row with a
* each header in a <code><th></code> element.</li>
* </ul>
*
* @param context <code>FacesContext</code> for the current request
* @param data<code>UIData</code> being rendered
* @param writer <code>ResponseWriter</code> to render to
*
* @excepton IOException if an input/output error occurs
*/
protected void tableBegin(FacesContext context, UIData data,
ResponseWriter writer) throws IOException {
// Render the outermost table element
writer.startElement("table", data);
String styleClass = (String) data.getAttributes().get("styleClass");
if (styleClass != null) {
writer.writeAttribute("class", styleClass, "styleClass");
} else {
writer.writeAttribute("border", "0", null);
writer.writeAttribute("cellspacing", "5", null);
}
writer.writeText("\n", null);
// Render the table and column headers (if any)
UIComponent header = data.getFacet("header");
int n = getColumnHeaderCount(data);
if ((header != null) || (n > 0)) {
writer.startElement("thead", header);
}
if (header != null) {
writer.startElement("tr", header);
writer.startElement("th", header);
writer.writeAttribute("colspan", "" + getColumnCount(data), null);
writer.writeText("\n", null);
encodeRecursive(context, header);
writer.writeText("\n", null);
writer.endElement("th");
writer.endElement("tr");
writer.writeText("\n", null);
}
if (n > 0) {
writer.startElement("tr", data);
writer.writeText("\n", null);
Iterator columns = data.getChildren().iterator();
while (columns.hasNext()) {
UIComponent column = (UIComponent) columns.next();
if (!(column instanceof UIColumn)) {
continue;
}
writer.startElement("th", column);
UIComponent facet = column.getFacet("header");
if (facet != null) {
encodeRecursive(context, facet);
}
writer.endElement("th");
writer.writeText("\n", null);
}
writer.endElement("tr");
writer.writeText("\n", null);
}
if ((header != null) || (n > 0)) {
writer.endElement("thead");
writer.writeText("\n", null);
}
// Render the beginning of the table body
writer.startElement("tbody", data);
writer.writeText("\n", null);
}
/**
*
Render the markup for the ending of an entire table. The
* default implementation renders:
* <ul>
* <li>If any of the child <code>UIColumn</code> components has a facet
* named <code>footer</code>, render them in a table row with a
* each footer in a <code><th></code> element.</li>
* <li>If the <code>UIData</code> component has a facet named
* <code>footer</code>, render it in a table row with a
* <code>colspan</code> set to span all the columns in the table.</li>
* <li>A <code></table></code> element.</li>
* </ul>
*
* @param context <code>FacesContext</code> for the current request
* @param data<code>UIData</code> being rendered
* @param writer <code>ResponseWriter</code> to render to
*
* @excepton IOException if an input/output error occurs
*/
protected void tableEnd(FacesContext context, UIData data,
ResponseWriter writer) throws IOException {
// Render the end of the table body
writer.endElement("tbody");
writer.writeText("\n", null);
// Render the table and column footers (if any)
UIComponent footer = data.getFacet("footer");
int n = getColumnFooterCount(data);
if ((footer != null) || (n > 0)) {
writer.startElement("tfoot", footer);
}
if (n > 0) {
writer.startElement("tr", data);
writer.writeText("\n", null);
Iterator columns = data.getChildren().iterator();
while (columns.hasNext()) {
UIComponent column = (UIComponent) columns.next();
if (!(column instanceof UIColumn)) {
continue;
}
writer.startElement("th", column);
UIComponent facet = column.getFacet("footer");
if (facet != null) {
encodeRecursive(context, facet);
}
writer.endElement("th");
writer.writeText("\n", null);
}
writer.endElement("tr");
writer.writeText("\n", null);
}
if (footer != null) {
writer.startElement("tr", footer);
writer.startElement("th", footer);
writer.writeAttribute("colspan", "" + getColumnCount(data), null);
writer.writeText("\n", null);
encodeRecursive(context, footer);
writer.writeText("\n", null);
writer.endElement("th");
writer.endElement("tr");
writer.writeText("\n", null);
}
if ((footer != null) || (n > 0)) {
writer.endElement("tfoot");
writer.writeText("\n", null);
}
// Render the ending of the outermost table element
writer.endElement("table");
writer.writeText("\n", null);
}
}
