PrimeFaces Datatable - f:facet实际上在做什么

Question

在应用程序中浏览一些PrimeFaces代码时，我注意到以下行：

<f:facet name="header">#{trainSearch.trainCount} Trains</f:facet>

看起来它正在覆盖标题，这是有道理的，但是有人可以更详细地向我解释一下吗？

这行代码到底发生了什么？

下面列出了完整的代码：

           <p:dataTable id = "results" value = "#{trainSearch.trains}" var = "train"     rendered="#{not empty trainSearch.trains}" styleClass = "train-search-table horizontal-border">
                <f:facet name="header">#{trainSearch.trainCount} Trains</f:facet> 
                <p:column headerText = "Train ID">
                    <p:panelGrid columns="1" styleClass = "train-id-grid" layout = "grid">
                        <h:outputText styleClass = "train-id-label" value="#{train.trainI}"/>
                        <h:outputText value="#{train.originCityState} > #{train.destinationCityState}" />
                    </p:panelGrid>
                </p:column>
                <p:column headerText="Scheduled Departure">
                    <h:outputText value="#{train.formattedScheduledDepartureText}" />
                </p:column>
                <p:column headerText="Scheduled Arrival">
                    <h:outputText value="#{train.formattedScheduledArrivalText}" />
                </p:column>
                 <p:column headerText="Loco Count">
                    <h:outputText value="#{train.locoCount}" />
                </p:column>
                <p:column headerText="Car Count">
                    <h:outputText value="#{train.carCount}" />
                </p:column>
            </p:dataTable>

Answer 1

JSF 中的 Facets 用于自定义组件的呈现，而无需接触其代码，例如 datatable

中的标头 facet，您可以在其中将自定义代码放在 datatable 标头中，而无需接触实际的 PrimeFaces 数据表代码。

DataTableRenderer（编写数据表的 html 代码的类）获取您放入分面中的 xhtml 代码并将其呈现在div 中。

您可以在DataTableRenderer的方法encodeFacet中看到这一点：

protected void encodeFacet(FacesContext context, DataTable table, UIComponent facet, String styleClass) throws IOException {
    if(facet == null)
        return;
    ResponseWriter writer = context.getResponseWriter();
    writer.startElement("div", null);
    writer.writeAttribute("class", styleClass, null);
    facet.encodeAll(context);
    writer.endElement("div");
}

facet.encodeAll(context);行将你放在 facet 中的代码呈现为 html，RENDER_RESPONSE jsf 阶段。