Top ↑
无匹配结果,请重新输入
插入前后的设置
Jun 18, 2019 1:04:19 PM

插入之前 - @Prev

在插入之前,你想通过一段 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;
...

本页面的文字允许在知识共享 署名-相同方式共享 3.0协议GNU自由文档许可证下修改和再使用。