JadePool应用范例：查询与分页

实现民族管理很简单，可参照中国行政区划管理，这里重点介绍JadePool查询与Primefaces分页的实现。

一、参照中国行政区划管理修改模板IndexTemplate.xhtml菜单项
        将<p:menuitem value="民族" url="#" />修改为<p:menuitem value="中国民族" outcome="cn_people" />；
        创建cn_people.xhtml文件，因为使用的outcome属性，如果该文件不存在，则运行异常。

        cn_people.xhtml文件内容见附件1。

二、创建PeopleBean受管Bean

@ManagedBean@SessionScopedpublic class PeopleBean {  ...}

使用@ManagedBean注入，表明该类是JSF受管Bean，默认的变量名是peopleBean；可以通过@ManagedBean(name="minzu")将受管Bean的变量命名为"minzu"。
使用@SessionScoped注入，表明该类的变量的作用域在会话范围内。
PeopleBean.java的内容见附件2。

1、添加四个属性，并为这四个属性添加set、get方法

    private Map peopleMap = new LinkedHashMap();//民族记录    private Map peopleSelected = new LinkedHashMap();//被选择的民族记录    private List<Map> peopleList = new ArrayList();//民族记录列表，用于记录cn_people表的查询结果    private ListMapDataModel peopleModel = new  ListMapDataModel(peopleList,"people_id");//民族数据模型，"people_id"是cn_people数据库表的主键名

    为四个属性生成set、get方法（内容略）。
    这四个属性在MVC层面属于M(数据)。peopleMap相当于ORM中的实体Bean或者POJO Bean。在JadePool中，用Map代替一切实体Bean或者POJO Bean。

2、记录初始化
    创建初始化方法：

    private void init() {        Jade j=new Jade();        peopleList=j.query("select * from cn_people order by people_id");        peopleModel = new ListMapDataModel(peopleList, "people_id");        j.commit();    }

    在构造方法中调用init()。

3、导入民族记录
        同行政区划一样，民族记录被打包在jadepool-1.0-GBK中，可以调用China的people()方法导出，导出的记录以List<Map>类型存在，每条记录包含三个键名：minzu、pinxie、daima。在cn_people表中，有三个与导出记录同名字段，它们用来保存同名的导出记录字段。请把原cn_people表中的字段名zimu修改为daima。数据库结构信息修改后，需要重新运行应用程序，以保证JadePool使用的有限多列模式重新加载数据库的结构信息。

    public void guidePeople() {        China cn = new China();        List<Map> v=cn.people();        //for(Map m:v){            //System.out.println(m);//{minzu=汉族, pinxie=Han, daima=HA}//请把原cn_people表中的字段名zimu修改为字段名daima        //}        Jade j=new Jade();        j.delete("delete from cn_people");        j.insert("cn_people", v, true);//true，自动插入主键        peopleList = j.query("select * from cn_people order by people_id");//查询        peopleModel = new ListMapDataModel(peopleList, "people_id");//建立数据模型        j.commit();    }

三、完善cn_people.xhtml页面内容
在cn_people.xhtml页面中，添加Primefaces的p:tabView组件，创建两个tab，一个用于分页浏览，一个用于导入。
1、导入民族记录
在tab页初始化民族记录中，按钮的代码如下：
<p:commandButton value="初始化民族" action="#{peopleBean.guidePeople}" icon="ui-icon-disk" update="@form :bottomForm:bottomGrowl"/>  
点击“初始化民族”按钮会触发action事件，调用受管Bean的guidePeople方法。update属性调用ajax方法更新指定组件元素的显示，这里更新两个组件元素，@form和 :bottomForm:bottomGrowl，它们之间使用" "空格分开。其中，@form代表当前的表单，:bottomForm:bottomGrowl是指模板网页底部定义的<p:growl/>消息显示组件。

下图是初始化民族记录返回结果，提示消息由p:growl组件呈现。

2、浏览民族记录
浏览民族记录通过使用Primefaces的p:dataTable组件实现。这里，该组件呈现peopleModel数据模型。代码如下：

                    <p:dataTable id="peopleDataTable"                                 value="#{peopleBean.peopleModel}"                                   var="m"                                 paginator="true"                                 paginatorPosition="bottom"                                 rows="10"                                   paginatorTemplate="{CurrentPageReport}  {FirstPageLink} {PreviousPageLink} {PageLinks} {NextPageLink} {LastPageLink} {RowsPerPageDropdown}"                                   rowsPerPageTemplate="10,20,40,60"                                 selection="#{peopleBean.peopleSelected}"                                 selectionMode="single"                                 >                        <p:column headerText="主键" style="text-align: center;" sortBy="#{m.people_id}" >                            #{m.people_id}                        </p:column>                          <p:column headerText="民族" sortBy="#{m.minzu}" >                            #{m.minzu}                        </p:column>                          <p:column headerText="拼写" sortBy="#{m.pinxie}" >                            #{m.pinxie}                        </p:column>                          <p:column headerText="字母" sortBy="#{m.daima}" >                            #{m.daima}                        </p:column>                      </p:dataTable>  

代码注解：

        1、value属性连接数据模型，

        2、var属性用于每条记录，

        3、paginator="true"表明要显示导航条，

        4、paginatorPosition="bottom"将导航条放到底部，

        5、paginatorTemplate用来指定导航条中出现的按钮，

        6、rows="10"每页10条记录显示，

        7、rowsPerPageTemplate="10,20,40,60"分页方案，

        8、selection="#{peopleBean.peopleSelected}"将被选的记录保存到peopleSelected属性中，

        9、selectionMode="single"单行选择。

在表的主体部分p:column组件的sortBy用来指定排序的字段。

民族分页效果图，黄色记录是被选记录

附件1：cn_people.xhtml

<?xml version='1.0' encoding='GBK' ?><!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><ui:composition xmlns:ui="http://java.sun.com/jsf/facelets"                template="./IndexTemplate.xhtml"                xmlns:p="http://primefaces.org/ui"                xmlns:f="http://java.sun.com/jsf/core"                xmlns:c="http://java.sun.com/jsp/jstl/core"                xmlns:h="http://java.sun.com/jsf/html">    <ui:define name="content">        <h:form id="form">            <p:tabView id="tv" widgetVar="tv" dynamic="true">                <p:tab title="中国的民族">                    <p:dataTable id="peopleDataTable"                                 value="#{peopleBean.peopleModel}"                                   var="m"                                 paginator="true"                                 paginatorPosition="bottom"                                 rows="10"                                   paginatorTemplate="{CurrentPageReport}  {FirstPageLink} {PreviousPageLink} {PageLinks} {NextPageLink} {LastPageLink} {RowsPerPageDropdown}"                                   rowsPerPageTemplate="10,20,40,60"                                 selection="#{peopleBean.peopleSelected}"                                 selectionMode="single"                                 >                        <p:column headerText="主键" style="text-align: center;" sortBy="#{m.people_id}" >                            #{m.people_id}                        </p:column>                          <p:column headerText="民族" sortBy="#{m.minzu}" >                            #{m.minzu}                        </p:column>                          <p:column headerText="拼写" sortBy="#{m.pinxie}" >                            #{m.pinxie}                        </p:column>                          <p:column headerText="字母" sortBy="#{m.daima}" >                            #{m.daima}                        </p:column>                      </p:dataTable>                  </p:tab>                <p:tab title="初始化民族记录">                    <div  style="padding: 40px;text-align: center;">                        <p:commandButton value="初始化民族" action="#{peopleBean.guidePeople}" icon="ui-icon-disk" update="@form :bottomForm:bottomGrowl"/>                      </div>                </p:tab>            </p:tabView>        </h:form>    </ui:define></ui:composition>

附件2：PeopleBean.java

/* * PeopleBean.java * 2013-03-31 * 胡开明 */package china;import cn.jadepool.sql.Jade;import cn.jadepool.util.China;import java.util.ArrayList;import java.util.LinkedHashMap;import java.util.List;import java.util.Map;import javax.faces.application.FacesMessage;import javax.faces.bean.ManagedBean;import javax.faces.bean.SessionScoped;import javax.faces.context.FacesContext;/** * 实现中国民族管理 * * @author hkm */@ManagedBean@SessionScopedpublic class PeopleBean {    private Map peopleMap = new LinkedHashMap();//民族记录    private Map peopleSelected = new LinkedHashMap();//被选择的民族记录    private List<Map> peopleList = new ArrayList();//民族记录列表，用于记录cn_people表的查询结果    private ListMapDataModel peopleModel = new ListMapDataModel(peopleList, "people_id");//民族数据模型，"people_id"是cn_people数据库表的主键名    /**     * Creates a new instance of PeopleBean     */    public PeopleBean() {        init();    }    public Map getPeopleMap() {        return peopleMap;    }    public void setPeopleMap(Map peopleMap) {        this.peopleMap = peopleMap;    }    public Map getPeopleSelected() {        return peopleSelected;    }    public void setPeopleSelected(Map peopleSelected) {        this.peopleSelected = peopleSelected;    }    public List<Map> getPeopleList() {        return peopleList;    }    public void setPeopleList(List<Map> peopleList) {        this.peopleList = peopleList;    }    public ListMapDataModel getPeopleModel() {        return peopleModel;    }    public void setPeopleModel(ListMapDataModel peopleModel) {        this.peopleModel = peopleModel;    }    /**     * 初始化民族记录     */    private void init() {        Jade j = new Jade();        peopleList = j.query("select * from cn_people order by people_id");        peopleModel = new ListMapDataModel(peopleList, "people_id");        j.commit();    }    public void guidePeople() {        China cn = new China();        List<Map> v = cn.people();        //for(Map m:v){        //System.out.println(m);//{minzu=汉族, pinxie=Han, daima=HA}        //}        Jade j = new Jade();        j.delete("delete from cn_people");        j.insert("cn_people", v, true);//true，自动插入主键        peopleList = j.query("select * from cn_people order by people_id");        peopleModel = new ListMapDataModel(peopleList, "people_id");        j.commit();        FacesContext.getCurrentInstance().addMessage(null, new FacesMessage("导入", "导入民族记录" + peopleList.size() + "条！"));    }    }