插入前后的设置

优质

小牛编辑

128浏览

2023-12-01

在插入之前，你想通过一段 SQL 为你的 POJO 某一个字段设值。你可以通过 @Prev 属性

@Table("t_pet")
public class Pet{
    @Name
    private String name;

    @Column("photo")
    @Prev( @SQL("SELECT txt FROM t_pet_photo WHERE pname=@name") )
    private String photoPath;
...

@Prev 注解接受一组 @SQL 作为参数，它遵守如下约定：

@SQL 声明了一条 SQL 语句，支持动态占位符。
- 变量 - 形式如： $变量名
  - 其值由 org.nutz.dao.TableName 来设置，具体使用方式请参看动态表名
  - 特殊占位符不需要手工设值，Nutz.Dao 自动为你设置，它们是：
    - $view - 表示当前实体对象的视图名称
    - $field - 表示注解所在字段数据库名称
  - 其他特殊占位符，会被对象自身的同名属性值替换
- 参数 - 形式如：@参数名
  - 其值直接使用 POJO 自身的属性值
  - 比如上例，将会参考对象自身的 name 字段的值
如果 SQL 执行没有结果，即结果集合为空，将不会为相应字段设置
如果 SQL 执行的结果集包含多条记录，只有第一条记录的第一列的值会被使用
@SQL 更详细的语法规范请参看自定义 SQL

此外，@Prev 也支持传入 EL 表达式，详情请查看 @EL 的 javadoc

@Prev(els=@EL("$me.genID()"))
private String id;

public String genID(){
    return org.nutz.lang.random.R.UU16();
}

插入之后 - @Next

在插入之后，你想通过一段 SQL 为你的 POJO 某一个字段设值。你可以通过 @Next 属性

@Table("t_pet")
public class Pet{
    @Id
    @Next( @SQL("SELECT currval('t_pet_id_seq')") )
    private long id;
...

如上例，执行插入后，你的 Pet 对象的 id 会被数据库中新的值更新。

@Next 的规则和 @Prev 是一样的

拦截类注解 - @PrevInsert/@PrevUpdate@PrevDelete

与@Prev/@Next不同, 这几个注解不涉及SQL操作,这是最大的区别!

因为不涉及到sql操作, 所以不影响批量操作,尤其是批量插入.

先举个例子,生成uuid,说一下两者的区别:

@Name
@Prev(els={@EL("uuid()")} // 使用dao.fastInsert(list)会出现name为null,因为@Prev不执行
@PrevInsert(@EL("uuid()"} // 使用dao.fastInsert(list)依然正常,@PrevInsert会执行
private String name; // 一个字段上不要同时写@Prev和@PrevInsert,上述示例只是为了说明功能

@PrevUpdate(now=true) // 执行update时,自动设置为当前时间
private Date updateTime;

上述例子中,@PrevInsert可完美替代@Prev, 实现批量插入,而且可以简写为@PrevInsert(uu32=true)

以 @Prev 来举例

下面让我们举两个例子，详细说明一下变量和参数的异同点。

使用变量的例子

@Prev(@SQL("SELECT pet_name FROM t_user_pet WHERE ownm='$ownerName'"))
private String name;

在执行 dao.inert 操作时， Nutz.Dao 会预先执行这段 SQL, 执行之前，变量 $ownerName 会被对象本身的 ownerName 字段的值替
换，如果对象本身的 ownerName 字段的值恰好是 "zzh"，那么执行的 SQL 会变成：

SELECT pet_name FROM m_user_pet WHERE ownm='zzh';

这段 SQL 执行的结果会复制给对象的 name 字段。

使用参数的例子

@Prev(@SQL("SELECT pet_name FROM t_user_pet WHERE ownm=@ownerName"))
private String name;

在执行 dao.inert 操作时， Nutz.Dao 会预先执行这段 SQL, 执行之前，参数 @ownerName 会被 '?' 替换，并根据这段 SQL 生成
PreparedStatement 对象：

SELECT pet_name FROM m_user_pet WHERE ownm=?;

然后，根据对象本身的 ownerName 字段的值，为这个 PreparedStatement 设置参数，执行之后，这段 SQL 执行的结果会复制给对象的 name 字段。

数据库方言

无论是 @Prev 还是 @Next，你都是通过 @SQL 声明的数据库方言。但是，假设你并不确定你的 POJO 将会工作在哪一个数据
库上，比如你的项目有两个数据源，一个是 Oracle 一个是 Postgresql，那么你的 POJO 该如何写方言呢？

@Table("t_pet")
public class Pet{
    @Id
    @Next({
        @SQL(db = DB.PSQL,   value="SELECT currval('t_pet_id_seq')"),
        @SQL(db = DB.ORACLE, value="SELECT t_pet_id_seq.currval FROM dual"),
        @SQL(db = DB.OTHER,  value="SELECT MAX(id) FROM t_pet") 
    })
    private long id;
...

现在 Nutz.Dao 支持这些数据库. 其他未能识别的数据库将当成MySQL:

public enum DB {
    H2, DB2, PSQL, ORACLE, SQLSERVER, MYSQL, OTHER ...
}

特别说一下Oracle的seq, 不过,更推荐使用触发器模拟自增.

@Table("t_pet")
public class Pet{
    @Id(auto=false)
    @Prev({
        @SQL(db = DB.ORACLE, "SELECT t_pet_id_seq.nextval FROM dual")
    })
    private long id;
...