com.sun.faces.renderkit.html_basic.TableRenderer Maven / Gradle / Ivy
/*
* Copyright (c) 1997, 2020 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0, which is available at
* http://www.eclipse.org/legal/epl-2.0.
*
* This Source Code may also be made available under the following Secondary
* Licenses when the conditions for such availability set forth in the
* Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
* version 2 with the GNU Classpath Exception, which is available at
* https://www.gnu.org/software/classpath/license.html.
*
* SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
*/
package com.sun.faces.renderkit.html_basic;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import com.sun.faces.renderkit.Attribute;
import com.sun.faces.renderkit.AttributeManager;
import com.sun.faces.util.Util;
import jakarta.faces.component.UIColumn;
import jakarta.faces.component.UIComponent;
import jakarta.faces.component.UIData;
import jakarta.faces.context.FacesContext;
import jakarta.faces.context.ResponseWriter;
/**
*
* Render a {@link UIData} component as a two-dimensional table.
*
*/
public class TableRenderer extends BaseTableRenderer {
private static final Attribute[] ATTRIBUTES = AttributeManager.getAttributes(AttributeManager.Key.DATATABLE);
// ---------------------------------------------------------- Public Methods
@Override
public void encodeBegin(FacesContext context, UIComponent component) throws IOException {
rendererParamsNotNull(context, component);
if (!shouldEncode(component)) {
return;
}
UIData data = (UIData) component;
data.setRowIndex(-1);
// Render the beginning of the table
ResponseWriter writer = context.getResponseWriter();
renderTableStart(context, component, writer, ATTRIBUTES);
// Render the caption (if any)
renderCaption(context, data, writer);
// Render column groups (if any)
renderColumnGroups(context, data);
// Render the header facets (if any)
renderHeader(context, component, writer);
// Render the footer facets (if any)
renderFooter(context, component, writer);
}
@Override
public void encodeChildren(FacesContext context, UIComponent component) throws IOException {
rendererParamsNotNull(context, component);
if (!shouldEncodeChildren(component)) {
return;
}
UIData data = (UIData) component;
ResponseWriter writer = context.getResponseWriter();
// Check if any columns are being rendered, if not
// render the minimal markup and exit
TableMetaInfo info = getMetaInfo(context, data);
if (info.columns.isEmpty()) {
renderEmptyTableBody(writer, data);
return;
}
// Iterate over the rows of data that are provided
int processed = 0;
int rowIndex = data.getFirst() - 1;
int rows = data.getRows();
List bodyRows = getBodyRows(context.getExternalContext().getApplicationMap(), data);
boolean hasBodyRows = bodyRows != null && !bodyRows.isEmpty();
boolean wroteTableBody = false;
if (!hasBodyRows) {
renderTableBodyStart(context, component, writer);
}
boolean renderedRow = false;
while (true) {
// Have we displayed the requested number of rows?
if (rows > 0 && ++processed > rows) {
break;
}
// Select the current row
data.setRowIndex(++rowIndex);
if (!data.isRowAvailable()) {
break; // Scrolled past the last row
}
// render any table body rows
if (hasBodyRows && bodyRows.contains(data.getRowIndex())) {
if (wroteTableBody) {
writer.endElement("tbody");
}
writer.startElement("tbody", data);
wroteTableBody = true;
}
// Render the beginning of this row
renderRowStart(context, component, writer);
// Render the row content
renderRow(context, component, null, writer);
// Render the ending of this row
renderRowEnd(context, component, writer);
renderedRow = true;
}
// fill an empty tbody, if no row has been rendered
if (!renderedRow) {
renderEmptyTableRow(writer, data);
}
renderTableBodyEnd(context, component, writer);
// Clean up after ourselves
data.setRowIndex(-1);
}
@Override
public void encodeEnd(FacesContext context, UIComponent component) throws IOException {
rendererParamsNotNull(context, component);
if (!shouldEncode(component)) {
return;
}
clearMetaInfo(context, component);
((UIData) component).setRowIndex(-1);
// Render the ending of this table
renderTableEnd(context, component, context.getResponseWriter());
}
@Override
public boolean getRendersChildren() {
return true;
}
// ------------------------------------------------------- Protected Methods
private List getBodyRows(Map appMap, UIData data) {
List result = null;
String bodyRows = (String) data.getAttributes().get("bodyrows");
if (bodyRows != null) {
String[] rows = Util.split(appMap, bodyRows, ",");
if (rows != null) {
result = new ArrayList<>(rows.length);
for (String curRow : rows) {
result.add(Integer.valueOf(curRow));
}
}
}
return result;
}
protected void renderColumnGroups(FacesContext context, UIComponent table) throws IOException {
UIComponent colGroups = getFacet(table, "colgroups");
if (colGroups != null) {
encodeRecursive(context, colGroups);
}
}
@Override
protected void renderFooter(FacesContext context, UIComponent table, ResponseWriter writer) throws IOException {
TableMetaInfo info = getMetaInfo(context, table);
UIComponent footer = getFacet(table, "footer");
// check if any footer has to be rendered
if (footer == null && !info.hasFooterFacets) {
return;
}
String footerClass = (String) table.getAttributes().get("footerClass");
writer.startElement("tfoot", table);
writer.writeText("\n", table, null);
if (info.hasFooterFacets) {
writer.startElement("tr", table);
writer.writeText("\n", table, null);
for (UIColumn column : info.columns) {
String columnFooterClass = (String) column.getAttributes().get("footerClass");
writer.startElement("td", column);
if (columnFooterClass != null) {
writer.writeAttribute("class", columnFooterClass, "columnFooterClass");
} else if (footerClass != null) {
writer.writeAttribute("class", footerClass, "footerClass");
}
UIComponent facet = getFacet(column, "footer");
if (facet != null) {
writer.writeText("", table, null);
encodeRecursive(context, facet);
}
writer.endElement("td");
writer.writeText("\n", table, null);
}
renderRowEnd(context, table, writer);
}
if (footer != null) {
writer.startElement("tr", footer);
writer.startElement("td", footer);
if (footerClass != null) {
writer.writeAttribute("class", footerClass, "footerClass");
}
if (info.columns.size() > 1) {
writer.writeAttribute("colspan", String.valueOf(info.columns.size()), null);
}
encodeRecursive(context, footer);
writer.endElement("td");
renderRowEnd(context, table, writer);
}
writer.endElement("tfoot");
writer.writeText("\n", table, null);
}
@Override
protected void renderHeader(FacesContext context, UIComponent table, ResponseWriter writer) throws IOException {
TableMetaInfo info = getMetaInfo(context, table);
UIComponent header = getFacet(table, "header");
// check if any header has to be rendered
if (header == null && !info.hasHeaderFacets) {
return;
}
String headerClass = (String) table.getAttributes().get("headerClass");
writer.startElement("thead", table);
writer.writeText("\n", table, null);
if (header != null) {
writer.startElement("tr", header);
writer.startElement("th", header);
if (headerClass != null) {
writer.writeAttribute("class", headerClass, "headerClass");
}
if (info.columns.size() > 1) {
writer.writeAttribute("colspan", String.valueOf(info.columns.size()), null);
}
writer.writeAttribute("scope", "colgroup", null);
encodeRecursive(context, header);
writer.endElement("th");
renderRowEnd(context, table, writer);
}
if (info.hasHeaderFacets) {
writer.startElement("tr", table);
writer.writeText("\n", table, null);
for (UIColumn column : info.columns) {
String columnHeaderClass = (String) column.getAttributes().get("headerClass");
writer.startElement("th", column);
if (columnHeaderClass != null) {
writer.writeAttribute("class", columnHeaderClass, "columnHeaderClass");
} else if (headerClass != null) {
writer.writeAttribute("class", headerClass, "headerClass");
}
writer.writeAttribute("scope", "col", null);
UIComponent facet = getFacet(column, "header");
if (facet != null) {
encodeRecursive(context, facet);
}
writer.endElement("th");
writer.writeText("\n", table, null);
}
renderRowEnd(context, table, writer);
}
writer.endElement("thead");
writer.writeText("\n", table, null);
}
@Override
protected void renderRow(FacesContext context, UIComponent table, UIComponent child, ResponseWriter writer) throws IOException {
// Iterate over the child UIColumn components for each row
TableMetaInfo info = getMetaInfo(context, table);
info.newRow();
for (UIColumn column : info.columns) {
// Render the beginning of this cell
boolean isRowHeader = false;
Object rowHeaderValue = column.getAttributes().get("rowHeader");
if (null != rowHeaderValue) {
isRowHeader = Boolean.valueOf(rowHeaderValue.toString());
}
if (isRowHeader) {
writer.startElement("th", column);
writer.writeAttribute("scope", "row", null);
} else {
writer.startElement("td", column);
}
final String tableColumnStyleClass = info.getCurrentColumnClass();
final String columnStyleClass = (String) column.getAttributes().get("styleClass");
if (tableColumnStyleClass != null) {
if (columnStyleClass != null) {
throw new IOException("Cannot define both columnClasses on a table and styleClass on a column");
}
writer.writeAttribute("class", tableColumnStyleClass, "columnClasses");
}
if (columnStyleClass != null) {
if (tableColumnStyleClass != null) {
throw new IOException("Cannot define both columnClasses on a table and styleClass on a column");
}
writer.writeAttribute("class", columnStyleClass, "styleClass");
}
// Render the contents of this cell by iterating over
// the kids of our kids
for (Iterator gkids = getChildren(column); gkids.hasNext();) {
encodeRecursive(context, gkids.next());
}
// Render the ending of this cell
if (isRowHeader) {
writer.endElement("th");
} else {
writer.endElement("td");
}
writer.writeText("\n", table, null);
}
}
// ------------------------------------------------------- Private Methods
private void renderEmptyTableBody(final ResponseWriter writer, final UIComponent component) throws IOException {
writer.startElement("tbody", component);
renderEmptyTableRow(writer, component);
writer.endElement("tbody");
}
private void renderEmptyTableRow(final ResponseWriter writer, final UIComponent component) throws IOException {
writer.startElement("tr", component);
List columns = getColumns(component);
for (UIColumn column : columns) {
if (column.isRendered()) {
writer.startElement("td", component);
writer.endElement("td");
}
}
writer.endElement("tr");
}
/**
*
* Return an Iterator over the UIColumn children of the specified UIData that have a
* rendered property of true.
*
*
* @param table the table from which to extract children
*
* @return the List of all UIColumn children
*/
private List getColumns(UIComponent table) {
int childCount = table.getChildCount();
if (childCount > 0) {
List results = new ArrayList<>(childCount);
for (UIComponent kid : table.getChildren()) {
if (kid instanceof UIColumn && kid.isRendered()) {
results.add((UIColumn) kid);
}
}
return results;
} else {
return Collections.emptyList();
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy