ADF Faces Table 元件 Detail Stamp 動態顯示與單一展開控制實作

前言

Oracle ADF Faces <af:table> 提供 detailStamp 面板支援主從式明細展開。本文示範如何透過 disclosureListener 控制明細顯示邏輯，並進階實作「單一展開」：展開新行時自動關閉前一行。

基礎 JSPX 頁面結構

<af:table value="#{tableTest.allData}" var="data"
          disclosureListener="#{tableTest.showDetails}"
          varStatus="vs" banding="none">
  <af:column sortable="true" formatType="icon" ...>
    <f:facet name="header"><af:outputText value="NO."/></f:facet>
    <af:outputText value="#{data.column1}"/>
  </af:column>
  <af:column ...><f:facet name="header"><af:outputText value="Last Name"/></f:facet>
    <af:outputText value="#{data.column2}"/></af:column>
  <af:column ...><f:facet name="header"><af:outputText value="First Name"/></f:facet>
    <af:outputText value="#{data.column3}"/></af:column>

  <f:facet name="detailStamp">
    <af:panelGroup layout="vertical">
      <af:outputText rendered="#{tableTest.showDetail}" value="#{data.detail}"/>
      <af:outputText rendered="#{tableTest.showDetail}" value="#{data.detail}"/>
      <af:outputText rendered="#{tableTest.showDetail}" value="#{data.detail}"/>
    </af:panelGroup>
  </f:facet>
</af:table>

Backing Bean 基礎實作

public class TableDataBackBean {
    private List<TableData> allData = new ArrayList<>();
    private boolean showDetail = false;

    public TableDataBackBean() {
        allData.add(new TableData("1","vincent","ma","vincent ma detail"));
        allData.add(new TableData("2","barry","fan","barry fan detail"));
        // ... 更多測試資料
    }

    public void showDetails(DisclosureEvent event) {
        if (event.isExpanded()) this.showDetail = true;
    }
    // getter/setter 省略
}

進階：單一展開邏輯 (展開一行自動關閉其他)

private String oldValue = "";

public void showDetails(DisclosureEvent disclosureEvent) {
    CoreTable table = (CoreTable) disclosureEvent.getComponent();
    if (disclosureEvent.isExpanded()) this.showDetail = true;

    RowKeySet rowKeySet = table.getDisclosureState();
    Set<Object> keySet = rowKeySet.getKeySet();
    Iterator<Object> iter = keySet.iterator();

    if (keySet.size() == 2) { // 使用者剛展開第二行
        while (iter.hasNext()) {
            String temp = (String) iter.next();
            if (!temp.equals(oldValue)) { // 找到新展開的行
                oldValue = temp;
                break;
            }
        }
        keySet.clear();
        keySet.add(oldValue); // 只保留新行
    } else if (keySet.size() == 1) { // 單行展開或收合後剩一行
        while (iter.hasNext()) oldValue = (String) iter.next();
        keySet.add(oldValue);
    }
    table.setDisclosureState(rowKeySet);
}

關鍵 API 說明

注意事項

• detailStamp 內組件使用 rendered="#{bean.showDetail}" 控制可見性，需配合 listener 更新旗標
• 單一展開邏輯假設行鍵為 String，實際專案請依主鍵類型調整
• 大量資料時建議啟用 rowBandingInterval 與 fetchSize 優化渲染