插入之前 - @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;
...