关于后端:FoxnicSQL-8-DAO-特性-数据查询

Foxnic-SQL (8) —— DAO 个性 : 数据查问

概述

  Foxnic-SQL 的 DAO 对象蕴含了十分丰盛的查问性能，能够查问记录、数据实体(Po对象)、单值。针对不同的数据库 DAO 对象曾经实现了默认的分页性能。DAO 中所有的查询方法都反对 SQL 字符串查问、SQL 对象查问。上面咱们来具体看一下这些性能。
本文中的示例代码均可在 https://gitee.com/LeeFJ/foxnic-samples 我的项目中找到。

查问记录集

  默认状况下，JDBC 查问返回的是 ResultSet(游标)，因为关上的 ResultSet 会占用资源，所以 DAO 会先把数据转存至 RcdSet 。RcdSet 就是记录集，在没有 Po 模型时，间接应用 RcdSet 是十分不便的。本节并不对 RcdSet 进行开展，咱们前面的章节会独自解说 RcdSet 的应用办法。
  记录集查问蕴含分页和不分页两种查问的模式，咱们先来看看惯例的不分页的查问模式：

/*** 1、查问不分页记录集* */public static void queryRcdSetNoPage() {    // 通过 DBInstance 拿到 DAO 对象    Date date= DateUtil.addDays(new Date(),-1000);    DAO dao= DBInstance.DEFAULT.dao();    // 执行查问    RcdSet rs=dao.query("select * from sys_role where create_time>?",date);    int i=0;    // 遍历数据    for (Rcd r : rs) {        System.out.println(i+" - "+r.toJSONObject());        i++;    }    // DAO 创立查问语句进行查问    rs=dao.select().from("sys_role").where("create_time>?",date).top().query();    i=0;    // 遍历数据    for (Rcd r : rs) {        System.out.println(i+" - "+r.toJSONObject());        i++;    }}

  上面的例子是分页查问记录集：

/*** 2、查问分页记录集* */public static void queryRcdSetPaginated() {    // 通过 DBInstance 拿到 DAO 对象    Date date= DateUtil.addDays(new Date(),-1000);    DAO dao= DBInstance.DEFAULT.dao();    // 指定分页大小    Integer pageSize=10;    // 模仿翻页动作：惯例形式查问    for (int pageIndex = 0; pageIndex < 10; pageIndex++) {        // 执行分页查问        RcdSet rs=dao.queryPage("select * from sys_resourze where create_time>?",pageSize,pageIndex,date);        int i=0;        // 遍历数据        for (Rcd r : rs) {            System.out.println("page "+pageIndex+"."+i+" - "+r.toJSONObject());            i++;        }        // 输入分页信息        System.out.println("total rows = "+rs.getTotalRowCount()+" ; total pages = "+rs.getPageCount()+"; pageIndex = "+rs.getPageIndex()+" ; pageSize = "+rs.getPageSize());    }    // 模仿翻页动作，QueryableSQL 形式查问    for (int pageIndex = 0; pageIndex < 10; pageIndex++) {        // 执行分页查问，QueryableSQL 形式        RcdSet rs=dao.expr("select * from sys_resourze where create_time>?",date).queryPage(pageSize,pageIndex);        int i=0;        // 遍历数据        for (Rcd r : rs) {            System.out.println("page "+pageIndex+"."+i+" - "+r.toJSONObject());            i++;        }        // 输入分页信息        System.out.println("total rows = "+rs.getTotalRowCount()+" ; total pages = "+rs.getPageCount()+"; pageIndex = "+rs.getPageIndex()+" ; pageSize = "+rs.getPageSize());    }}

  下面的两个例子中都是用了 QueryableSQL 形式查问，QueryableSQL 是一个可查问的 SQL 对象接口，所有实现 QueryableSQL 接口的类，均可执行与查问相干的办法。

查问单记录

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

/*** 3、查问单个记录* */public static void querySingleRcd() {    // 通过 DBInstance 拿到 DAO 对象    DAO dao= DBInstance.DEFAULT.dao();    String roleId="631081950060216320";    // 惯例形式查问    Rcd r=dao.queryRecord("select * from sys_role where id=?",roleId);    System.out.println("role-1 = "+r.toJSONObject());    // QueryableSQL 形式查问    r=dao.select().from("sys_role").where("id=?",roleId).top().queryRecord();    System.out.println("role-2 = "+r.toJSONObject());}

查问繁多值

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

/*** 4、查问单个值* */public static void querySingleValue() {    // 通过 DBInstance 拿到 DAO 对象    DAO dao= DBInstance.DEFAULT.dao();    String roleId="631081950060216320";    // 惯例形式查问    Integer count=dao.queryInteger("select count(1) from sys_role where id=?",roleId);    System.out.println("count-1 = "+count);    // QueryableSQL 形式查问    count=dao.select().select("count(1)").from("sys_role").where("id=?",roleId).top().queryInteger();    System.out.println("count-2 = "+count);}

查问实体集

  如果，我的项目里曾经创立了Po对象(手动或主动均可)，那么就间接通过 DAO 查问 Po 会显得更加不便和易于应用。当然 Po 对象和记录比各有劣势，Po 是固化的模型，利于编程，记录则次要体现它的动态性，适宜一些配置简单的场景，大家可按理论场景抉择。
实体查问同样反对分页和不分页，咱们先来看看不分页的查问：

/*** 5、查问不分页实体集* */public static void queryPoListNoPage() {    // 通过 DBInstance 拿到 DAO 对象    Date date= DateUtil.addDays(new Date(),-1000);    DAO dao= DBInstance.DEFAULT.dao();    // 执行查问    List<Address> list=dao.queryEntities(Address.class,"select * from example_address where create_time>?",date);    int i=0;    // 遍历数据    for (Address address : list) {        System.out.println(i+" - "+ JSON.toJSONString(address));        i++;    }    // DAO 创立查问语句进行查问    list=dao.select().from("example_address").where("create_time>?",date).top().queryEntities(Address.class);    i=0;    // 遍历数据    for (Address address : list) {        System.out.println(i+" - "+ JSON.toJSONString(address));        i++;    }}

  上面的例子是分页查问实体集：

/*** 6、查问分页实体集* */public static void queryPoListPaginated() {    // 通过 DBInstance 拿到 DAO 对象    Date date= DateUtil.addDays(new Date(),-1000);    DAO dao= DBInstance.DEFAULT.dao();    // 指定分页大小    Integer pageSize=10;    // 模仿翻页动作：惯例形式查问    for (int pageIndex = 0; pageIndex < 10; pageIndex++) {        // 执行分页查问        PagedList<Address> list=dao.queryPagedEntities(Address.class,pageSize,pageIndex,"select * from sys_resourze where create_time>?",date);        int i=0;        // 遍历数据        for (Address address : list) {            System.out.println(i+" - "+ JSON.toJSONString(address));            i++;        }        // 输入分页信息        System.out.println("total rows = "+list.getTotalRowCount()+" ; total pages = "+list.getPageCount()+"; pageIndex = "+list.getPageIndex()+" ; pageSize = "+list.getPageSize());    }    // 模仿翻页动作，QueryableSQL 形式查问    for (int pageIndex = 0; pageIndex < 10; pageIndex++) {        // 执行分页查问，QueryableSQL 形式        IPagedList<Address> list=dao.expr("select * from sys_resourze where create_time>?",date).queryPagedEntities(Address.class,pageSize,pageIndex);        int i=0;        // 遍历数据        for (Address address : list) {            System.out.println(i+" - "+ JSON.toJSONString(address));            i++;        }        // 输入分页信息        System.out.println("total rows = "+list.getTotalRowCount()+" ; total pages = "+list.getPageCount()+"; pageIndex = "+list.getPageIndex()+" ; pageSize = "+list.getPageSize());    }}

查问单实体

  单实体查问和单记录查问类似，间接上代码：

/*** 7、查问单个实体* */public static void querySinglePo() {    // 通过 DBInstance 拿到 DAO 对象    DAO dao= DBInstance.DEFAULT.dao();    String addressId="651345265952817152";    // 惯例形式查问    Address address=dao.queryEntityById(Address.class,addressId);    System.out.println("address-1 = "+JSON.toJSONString(address));    // QueryableSQL 形式查问    address=dao.select().from("sys_role").where("id=?",addressId).top().queryEntity(Address.class);    System.out.println("address-2 = "+JSON.toJSONString(address));    // Sample 形式查问    address=new Address();    address.setId(addressId);    address=dao.queryEntity(address);    System.out.println("address-3 = "+JSON.toJSONString(address));}

小结

  本节次要介绍了 Foxnic-SQL 中应用 DAO 对象查问记录、实体、繁多值的办法。同时，DAO 已适配不同数据库的分页查问。记录集(RcdSet)是 DAO 查问最后的数据载体，对于 RcdSet 更多个性，将在后续章节进行介绍。

相干我的项目

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