Foxnic-SQL (10) —— DAO 特性 : 生成序列

概述

在数据库层面，各个数据库对序列的支持是不一样的。大多数数据库可以为表指定一个自增的字段，但这种自增字段却很不利于数据的迁移。类似 Oracle 的数据库有专门的序列对象，但这种方式太独特，也不利于在产品层面的多数据库适配。基于这样的考虑，Foxnic-SQL 单独实现了基于存储过程的序列。
本文中的示例代码均可在 https://gitee.com/LeeFJ/foxnic-samples 项目中找到。

手动定义序列

获取序列的定义可以有两种方式：界面配置和程序配置。界面配置在系统管理->系统配置-> 序列管理进行配置，如图所示：

其中，序列的 key 一旦指定，不再可随意修改，再编程取数时会用到这个 key 值。长度是指序列值字符数，如果不足则补0，如果数值过大，则溢出，长度值加1。取值个数是指每次向数据库请求的序列值的个数，由于请求序列值都需要向数据库请求，这样就会有额外的开销，为了减少开销，可以一次请求取回多个值，以获得更好的并发性能。

程序定义序列

程序定义序列是指通过程序的方式创建序列，如下代码所示：

// 创建DAO
DAO dao=DBInstance.DEFAULT.dao();
String name="my-sample-demo";
DBSequence sequence=dao.getSequence(name);
// 如果不存在就创建
if(!sequence.exists()) {
    // 创建序列
    sequence.create(SequenceType.AI,10,4);
}

上面的例子中，首先使用 DAO 得到序列对象，接着判断是否已经存在，如果不存在就创建。

序列取数

序列取数时可以获得 Long 类型的值和字符串类型的值，字符串值当长度不足时自动不0。序列取数使用 DBSequence 类的 nextLong() 方法或 next() 方法。以下是完整的示例代码：

public static void main(String[] args) {
    // 创建DAO
    DAO dao=DBInstance.DEFAULT.dao();
    String name="my-sample-demo";
    DBSequence sequence=dao.getSequence(name);
    // 如果不存在就创建
    if(!sequence.exists()) {
        // 创建序列
        sequence.create(SequenceType.AI,10,4);
    }
    // 循环取数
    for (int i = 0; i < 100; i++) {
        // 获取 Long 值
        System.out.println(i+" = "+sequence.nextLong());
        // 获得 String 值
        System.out.println(i+" = "+sequence.next());
    }
}

小结

本节主要介绍了在 Foxni-SQL 中两种序列的创建方式，分别是手工创建和程序创建，以及如何通过 DBSequence 取得下一个序列值。

官方文档

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

Foxnic-SQL (10) —— DAO 特性 : 生成序列