Foxnic-SQL (8) —— DAO 特性 : 数据查询

<a name="imPZx"></a>

Foxnic-SQL (8) —— DAO 特性 : 数据查询

<a name="b21Xx"></a>

概述

  Foxnic-SQL 的 DAO 对象包含了非常丰富的查询功能，可以查询记录、数据实体(Po对象)、单值。针对不同的数据库 DAO 对象已经实现了默认的分页功能。DAO 中所有的查询方法都支持 SQL 字符串查询、SQL 对象查询。下面我们来具体看一下这些功能。<br />  本文中的示例代码均可在 https://gitee.com/LeeFJ/foxnic-samples 项目中找到。 <a name="zzXAs"></a>

查询记录集

  默认情况下，JDBC 查询返回的是 ResultSet(游标)，由于打开的 ResultSet 会占用资源，所以 DAO 会先把数据转存至 RcdSet 。RcdSet 就是记录集，在没有 Po 模型时，直接使用 RcdSet 是非常方便的。本节并不对 RcdSet 进行展开，我们后面的章节会单独讲解 RcdSet 的使用方法。<br />记录集查询包含分页和不分页两种查询的模式，我们先来看看常规的不分页的查询模式：

1/**
2* 1、查询不分页记录集
3* */
4public static void queryRcdSetNoPage() {
5    // 通过 DBInstance 拿到 DAO 对象
6    Date date= DateUtil.addDays(new Date(),-1000);
7    DAO dao= DBInstance.DEFAULT.dao();
8    // 执行查询
9    RcdSet rs=dao.query("select * from sys_role where create_time>?",date);
10    int i=0;
11    // 遍历数据
12    for (Rcd r : rs) {
13        System.out.println(i+" - "+r.toJSONObject());
14        i++;
15    }
16
17    // DAO 创建查询语句进行查询
18    rs=dao.select().from("sys_role").where("create_time>?",date).top().query();
19    i=0;
20    // 遍历数据
21    for (Rcd r : rs) {
22        System.out.println(i+" - "+r.toJSONObject());
23        i++;
24    }
25}

  下面的例子是分页查询记录集：

1/**
2* 2、查询分页记录集
3* */
4public static void queryRcdSetPaginated() {
5    // 通过 DBInstance 拿到 DAO 对象
6    Date date= DateUtil.addDays(new Date(),-1000);
7    DAO dao= DBInstance.DEFAULT.dao();
8    // 指定分页大小
9    Integer pageSize=10;
10    // 模拟翻页动作：常规方式查询
11    for (int pageIndex = 0; pageIndex < 10; pageIndex++) {
12        // 执行分页查询
13        RcdSet rs=dao.queryPage("select * from sys_resourze where create_time>?",pageSize,pageIndex,date);
14        int i=0;
15        // 遍历数据
16        for (Rcd r : rs) {
17            System.out.println("page "+pageIndex+"."+i+" - "+r.toJSONObject());
18            i++;
19        }
20        // 输出分页信息
21        System.out.println("total rows = "+rs.getTotalRowCount()+" ; total pages = "+rs.getPageCount()+"; pageIndex = "+rs.getPageIndex()+" ; pageSize = "+rs.getPageSize());
22    }
23
24    // 模拟翻页动作，QueryableSQL 方式查询
25    for (int pageIndex = 0; pageIndex < 10; pageIndex++) {
26        // 执行分页查询，QueryableSQL 方式
27        RcdSet rs=dao.expr("select * from sys_resourze where create_time>?",date).queryPage(pageSize,pageIndex);
28        int i=0;
29        // 遍历数据
30        for (Rcd r : rs) {
31            System.out.println("page "+pageIndex+"."+i+" - "+r.toJSONObject());
32            i++;
33        }
34        // 输出分页信息
35        System.out.println("total rows = "+rs.getTotalRowCount()+" ; total pages = "+rs.getPageCount()+"; pageIndex = "+rs.getPageIndex()+" ; pageSize = "+rs.getPageSize());
36    }
37}

  上面的两个例子中都是用了 QueryableSQL 方式查询，QueryableSQL 是一个可查询的 SQL 对象接口，所有实现 QueryableSQL 接口的类，均可执行与查询相关的方法。 <a name="BTg4C"></a>

查询单记录

  很多场合下，我们需要查询单个记录，例如按ID查询。DAO 对象在查询单个记录时，如果 SQL 语句返回多行，则默认第一行返回。示例如下：

1/**
2* 3、查询单个记录
3* */
4public static void querySingleRcd() {
5    // 通过 DBInstance 拿到 DAO 对象
6    DAO dao= DBInstance.DEFAULT.dao();
7    String roleId="631081950060216320";
8    // 常规方式查询
9    Rcd r=dao.queryRecord("select * from sys_role where id=?",roleId);
10    System.out.println("role-1 = "+r.toJSONObject());
11    // QueryableSQL 方式查询
12    r=dao.select().from("sys_role").where("id=?",roleId).top().queryRecord();
13    System.out.println("role-2 = "+r.toJSONObject());
14}

<a name="ukMij"></a>

查询单一值

  除了返回单个记录，有些时候我们也希望返回单个值，例如 count 统计等。DAO 对象在查询单个值时，如果 SQL 语句返回多行多列，则默认第一行第一列的值。示例如下：

1/**
2* 4、查询单个值
3* */
4public static void querySingleValue() {
5    // 通过 DBInstance 拿到 DAO 对象
6    DAO dao= DBInstance.DEFAULT.dao();
7    String roleId="631081950060216320";
8    // 常规方式查询
9    Integer count=dao.queryInteger("select count(1) from sys_role where id=?",roleId);
10    System.out.println("count-1 = "+count);
11    // QueryableSQL 方式查询
12    count=dao.select().select("count(1)").from("sys_role").where("id=?",roleId).top().queryInteger();
13    System.out.println("count-2 = "+count);
14}

<a name="mhr7r"></a>

查询实体集

  如果，项目里已经创建了Po对象(手动或自动均可)，那么就直接通过 DAO 查询 Po 会显得更加方便和易于使用。当然 Po 对象和记录比各有优势，Po 是固化的模型，利于编程，记录则主要体现它的动态性，适合一些配置复杂的场景，大家可按实际场景选择。<br />实体查询同样支持分页和不分页，我们先来看看不分页的查询：

1/**
2* 5、查询不分页实体集
3* */
4public static void queryPoListNoPage() {
5    // 通过 DBInstance 拿到 DAO 对象
6    Date date= DateUtil.addDays(new Date(),-1000);
7    DAO dao= DBInstance.DEFAULT.dao();
8    // 执行查询
9    List<Address> list=dao.queryEntities(Address.class,"select * from example_address where create_time>?",date);
10    int i=0;
11    // 遍历数据
12    for (Address address : list) {
13        System.out.println(i+" - "+ JSON.toJSONString(address));
14        i++;
15    }
16
17    // DAO 创建查询语句进行查询
18    list=dao.select().from("example_address").where("create_time>?",date).top().queryEntities(Address.class);
19    i=0;
20    // 遍历数据
21    for (Address address : list) {
22        System.out.println(i+" - "+ JSON.toJSONString(address));
23        i++;
24    }
25}

  下面的例子是分页查询实体集：

1/**
2* 6、查询分页实体集
3* */
4public static void queryPoListPaginated() {
5    // 通过 DBInstance 拿到 DAO 对象
6    Date date= DateUtil.addDays(new Date(),-1000);
7    DAO dao= DBInstance.DEFAULT.dao();
8    // 指定分页大小
9    Integer pageSize=10;
10    // 模拟翻页动作：常规方式查询
11    for (int pageIndex = 0; pageIndex < 10; pageIndex++) {
12        // 执行分页查询
13        PagedList<Address> list=dao.queryPagedEntities(Address.class,pageSize,pageIndex,"select * from sys_resourze where create_time>?",date);
14        int i=0;
15        // 遍历数据
16        for (Address address : list) {
17            System.out.println(i+" - "+ JSON.toJSONString(address));
18            i++;
19        }
20        // 输出分页信息
21        System.out.println("total rows = "+list.getTotalRowCount()+" ; total pages = "+list.getPageCount()+"; pageIndex = "+list.getPageIndex()+" ; pageSize = "+list.getPageSize());
22    }
23
24    // 模拟翻页动作，QueryableSQL 方式查询
25    for (int pageIndex = 0; pageIndex < 10; pageIndex++) {
26        // 执行分页查询，QueryableSQL 方式
27        IPagedList<Address> list=dao.expr("select * from sys_resourze where create_time>?",date).queryPagedEntities(Address.class,pageSize,pageIndex);
28        int i=0;
29        // 遍历数据
30        for (Address address : list) {
31            System.out.println(i+" - "+ JSON.toJSONString(address));
32            i++;
33        }
34        // 输出分页信息
35        System.out.println("total rows = "+list.getTotalRowCount()+" ; total pages = "+list.getPageCount()+"; pageIndex = "+list.getPageIndex()+" ; pageSize = "+list.getPageSize());
36    }
37}

<a name="t5GGA"></a>

查询单实体

  单实体查询和单记录查询相似，直接上代码：

1/**
2* 7、查询单个实体
3* */
4public static void querySinglePo() {
5    // 通过 DBInstance 拿到 DAO 对象
6    DAO dao= DBInstance.DEFAULT.dao();
7    String addressId="651345265952817152";
8    // 常规方式查询
9    Address address=dao.queryEntityById(Address.class,addressId);
10    System.out.println("address-1 = "+JSON.toJSONString(address));
11    // QueryableSQL 方式查询
12    address=dao.select().from("sys_role").where("id=?",addressId).top().queryEntity(Address.class);
13    System.out.println("address-2 = "+JSON.toJSONString(address));
14    // Sample 方式查询
15    address=new Address();
16    address.setId(addressId);
17    address=dao.queryEntity(address);
18    System.out.println("address-3 = "+JSON.toJSONString(address));
19}

<a name="DJyzU"></a>

小结

  本节主要介绍了 Foxnic-SQL 中使用 DAO 对象查询记录、实体、单一值的方法。同时，DAO 已适配不同数据库的分页查询。记录集(RcdSet)是 DAO 查询最初的数据载体，关于 RcdSet 更多特性，将在后续章节进行介绍。 <a name="VZBg5"></a>

相关项目

  https://gitee.com/LeeFJ/foxnic<br />  https://gitee.com/LeeFJ/foxnic-web<br />  https://gitee.com/lank/eam<br />  https://gitee.com/LeeFJ/foxnic-samples

官方文档

  http://foxnicweb.com/docs/doc.html