ADF_074：Table 组件使用指南之四：使用CheckBox组件保存和显示Boolean类型字段

本文最后一次修改时间：2012-03-17。
运行环境：JDeveloper 11.1.2.1.0 + Oracle Database 10g Express Edition 10.2.0.1。

实验介绍：数据库字段类型没有Boolean类型，一般使用'Y'或’N'来表示true或false。
而Java数据类型有Boolean类型，因此保存时需要把Boolean类型转换为String类型，而显示时要把String类型转换为Boolean类型。
af:selectBooleanCheckbox组件可以自动转换Boolean类型<->String类型，使用起来非常方便。
（1）主页面

（2）全选IsPartTime，并Commit。

（3）查看数据库，发现IsPartTime字段值全部为'Y'。

（4）全不选IsPartTime，并Commit。

（3）查看数据库，发现IsPartTime字段值全部为'N'。


重要步骤说明：
1. 创建数据库表：JOBS_CheckBox
在Jobs表的基础上创建一个新表JOBS_CheckBox表，增加一个字段：IS_Parttime。
CREATE TABLE JOBS_CheckBox as select * from Jobs;
ALTER TABLE JOBS_CHECKBOX ADD (IS_Parttime VARCHAR2(1) );
ALTER TABLE JOBS_CHECKBOX ADD CONSTRAINT JOBS_CHECKBOX_PK PRIMARY KEY ( JOB_ID )ENABLE;

2. IsPartTime列页面代码
（1）从Data Control中拖放IsParttime到IsPartTime列，选择生成“ADF Boolean CheckBox..."

CheckBox选中则赋值‘Y’，没选中赋值'N'：

（2）“全选和全不选”实现原理和《Table 组件使用指南之三：一次删除Table多行记录》一样，请参考其说明。

<af:column sortProperty="#{bindings.JobsCheckboxView1.hints.IsParttime.name}" filterable="true"
           sortable="false" headerText="#{bindings.JobsCheckboxView1.hints.IsParttime.label}"
           align="center" id="c5">
    <f:facet name="header">
        <af:selectBooleanCheckbox id="selectAllCheckBox" autoSubmit="true" label="IsPartTime">
            <af:clientListener method="clickOnSelectAllCheckBox" type="valueChange"/>
            <af:serverListener type="SelectAllCheckBoxClickEvent"
                               method="#{backingBeanScope.myBackingBean.handleSelectAllCheckboxClick}"/>
        </af:selectBooleanCheckbox>
    </f:facet>
    <af:selectBooleanCheckbox value="#{row.bindings.IsParttime.inputValue}"
                              label="#{row.bindings.IsParttime.label}"
                              shortDesc="#{bindings.JobsCheckboxView1.hints.IsParttime.tooltip}"
                              id="sbc1" autoSubmit="true"/>
</af:column>

这里有一个小问题，就是点击SelectAllCheckBox时，虽然我设置了autoSubmit="true"，但是Commit/Rollback按钮并没有被Enable。
而点击每一行的CheckBox时，就可以Enable Commit/Rollback按钮。
难道原因是因为SelectAllCheckBox只是一个纯页面上的组件，没有映射到模型层，对应到一个字段？待查。

3. Managed Bean的主要方法

public void handleSelectAllCheckboxClick(ClientEvent clientEvent) {
    boolean isSelectAllChecked = (Boolean)clientEvent.getParameters().get("params");
    RichTable rt = this.getJobsTable();
    for (int i = 0; i < rt.getRowCount(); i++) {
        JUCtrlHierNodeBinding rowData = (JUCtrlHierNodeBinding)rt.getRowData(i);
        Row row = rowData.getRow();
        if (isSelectAllChecked) {
            row.setAttribute("IsParttime", "Y");
        } else {
            row.setAttribute("IsParttime", "N");
        }
    }
}

Project 下载：ADF_CheckBox_Boolean.7z