实体注释(Entity)修订版本.docxVIP

专栏首页 → Java编程 → Java综合 → 专栏: nutz 专栏 → 章节:数据持久化 -- Nutz.Dao Nutz.Dao 实体注释(Entity Annotation)一览表 Nutz.Dao 实体注释(Entity Annotation)一览表 Annotation 描述 @Table @View @Column @Id 类对象声明，表示一个 POJO 为一个 Nutz.Dao 可接受的对象，可以对 应数据表或者视图 @Table(表或者视图名) 如果不声明值，那么 Nutz.Dao 将把该对象的 getClass().getSimpleName().toLowerCase() 作为数据表的名称 声明一个实体的时候，有些时候你需要将它存在某一个 Table 中，但是 你却希望从一个 View 中获取。 这么做通常是希望 View 可以帮你做一 些数据的统计方面的工作。 Nutz.Dao 支持你为一个实体 声明一个 @Table 的同时也声明一个 @View，对于一个对象， Nutz.Dao 的“增, 删,改”操作将针对 Table，而“查”操作将针对 View。 实际上，如 果你没有声明 @View， 那么你声明的@Table 将作为@View 的默认设 置。 字段声明，表示当前字段可以被映射到数据库中， @Column(字段名) 可以指定到特定的数据库字段, 如果不指定，那么将采用 field.getName()作为名字，大小写是否敏感将依各个不同的数据库来 定。 字段声明，告诉 Nutz.Dao 本字段将作为一个 ID 来使用。默认的， Nutz.Dao 将在每次向数据库中插入一个对象后，更新一下 Id 字段的 值，因为它认为@Id 字段是默认自动增长的。如果想消除这个特性，由 你自己来控制@ 你自己来控制@Id 字段的值，请这样 @Id(IdType.STATIC) 来声明你的 ID 字段 @Name @NotNull @Default @Readonly @One @Many 字段声明，告诉 Nutz.Dao 本字段将作为一个 Name 来使用。一个实体 的@Name 一般在数据表中都会做了唯一性约束。 所以当你依靠 @Name 来获取一个对象的时候，相当于 Sql 代码 1. SELECT*FROMtableWHEREname=...; SELECT * FROM table WHERE name=...; 字段声明, 如果你试图 Nutz.Dao 插入或者更新一个对象，给该字段赋 null 值将导致一个 com.zzh.dao.FailToMakeSQLException 字段声明，告诉 Nutz.Dao 本字段默认的值。 @Default(你的默认值 ) 这个默认值你可以写成动态的，比如 @Default(${name}@) 当你插入的对象包括一个 name 属性， 这个属性值会替换 ${name} 否则会用 (空串) 来替换 ${name} 声明成 Readonly 的字段在插入和更新时将被忽略 在一个字段上声明一条一对一映射，这个声明需要你输入两个参数: 1. target: 你的这个字段对应的实体类。通常，这个类得是你的字段 的一个子类或者实现类。或者它能够顺利的通过 Nutz.castor 转换成 你的字段。 (在 Nutz.Lang Book 里，我们将详细讨论 Nutz 为你提供 的这个崭新的转换框架。在 Nutz.Dao 中，这个框架几乎对你是透明 的，只有极特殊的时候有可能你需要关心它) 2. field: 参考字段名，这个字段必须存在当前对象上。 声明一条多对多映射，这个声明需要你输入三个参数，其中一个是可选 的: 1. target: 对应的实体类名，意义和@One 一样 2. field: 参考字段名，同 @One 不同，这个参考字段是 target 类中 的字段。 3. key: 当你的字段类型是个 Map 的时候，这个参数就有作用了。 因 为 @Many 通常会被你加在一个数组字段，或者一个 Collection 字段 上，当你打算将 @Many 加在一个 Map 字段上， Nutz.Dao 通过这个参 数就可以知道，你的 Map 打算用目标对象的哪一个属性作为 key，从 而正确为你的建立 Map。 注意， @Many 是一个略微让人疑惑的名称，你可能会想，你声明 @Many 的字段必须是一个容器或者数组，其实，它也可以是一个单个对 象。对于 Nutz.Dao 来说， @Many 字段确切的意义是说：参考字段 (@Many.field) 是存放在 target 对象里的，而 @One 则表示参考字段 是存放在当前对象的。 所以@