Play Framework框架 JPA惯用注解

Play Framework框架 JPA经常使用注解 
一、@Entity(name=”EntityName”) 
必须 ,name 为可选 , 对应数据库中一的个表

二、@Table(name=”",catalog=”",schema=”") 
可选 , 一般和 @Entity 配合使用 , 只能标注在实体的 class 定义处 , 表示实体对应的数据库表的信息 
name: 可选 , 表示表的名称 . 默认地 , 表名和实体名称一致 , 只有在不一致的状况下才须要指定表名 
catalog: 可选 , 表示 Catalog 名称 , 默认为 Catalog(“”). 
schema: 可选 , 表示 Schema 名称 , 默认为 Schema(“”).

三、@id 
必须 
@id 定义了映射到数据库表的主键的属性 , 一个实体只能有一个属性被映射为主键 . 置于 getXxxx() 前 .

四、@GeneratedValue(strategy=GenerationType,generator=”") 
可选 
strategy: 表示主键生成策略 , 有 AUTO,INDENTITY,SEQUENCE 和 TABLE 4 种 , 分别表示让 ORM 框架自动选择 , 
根据数据库的 Identity 字段生成 , 根据数据库表的 Sequence 字段生成 , 以有根据一个额外的表生成主键 , 默认为 AUTO 
generator: 表示主键生成器的名称 , 这个属性一般和 ORM 框架相关 , 例如 ,Hibernate 能够指定 uuid 等主键生成方式 . 
示例 : 
@Id 
@GeneratedValues(strategy=StrategyType.SEQUENCE) 
public int getPk() { 
return pk; 
}

五、@Basic(fetch=FetchType,optional=true) 
可选 
@Basic 表示一个简单的属性到数据库表的字段的映射 , 对于没有任何标注的 getXxxx() 方法 , 默认即为 @Basic 
fetch: 表示该属性的读取策略 , 有 EAGER 和 LAZY 两种 , 分别表示主支抓取和延迟加载 , 默认为 EAGER. 
optional: 表示该属性是否容许为 null, 默认为 true 
示例 : 
@Basic(optional=false) 
public String getAddress() { 
return address; 
}

六、@Column 
可选 
@Column 描述了数据库表中该字段的详细定义 , 这对于根据 JPA 注解生成数据库表结构的工具很是有做用 . 
name: 表示数据库表中该字段的名称 , 默认情形属性名称一致 
nullable: 表示该字段是否容许为 null, 默认为 true 
unique: 表示该字段是不是惟一标识 , 默认为 false 
length: 表示该字段的大小 , 仅对 String 类型的字段有效 
insertable: 表示在 ORM 框架执行插入操做时 , 该字段是否应出现 INSETRT 语句中 , 默认为 true 
updateable: 表示在 ORM 框架执行更新操做时 , 该字段是否应该出如今 UPDATE 语句中 , 默认为 true. 对于一经建立就不能够更改的字段 , 该属性很是有用 , 如对于 birthday 字段 . 
columnDefinition: 表示该字段在数据库中的实际类型 . 一般 ORM 框架能够根据属性类型自动判断数据库中字段的类型 , 可是对于 Date 类型仍没法肯定数据库中字段类型到底是 DATE,TIME 仍是 TIMESTAMP. 此外 ,String 的默认映射类型为 VARCHAR, 若是要将 String 类型映射到特定数据库的 BLOB 或 TEXT 字段类型 , 该属性很是有用 . 
示例 : 
@Column(name=”BIRTH”,nullable=”false”,columnDefinition=”DATE”) 
public String getBithday() { 
return birthday; 
}

七、@Transient 
可选 
@Transient 表示该属性并不是一个到数据库表的字段的映射 ,ORM 框架将忽略该属性 . 
若是一个属性并不是数据库表的字段映射 , 就务必将其标示为 @Transient, 不然 ,ORM 框架默认其注解为 @Basic 
示例 : 
// 根据 birth 计算出 age 属性 
@Transient 
public int getAge() { 
return getYear(new Date()) – getYear(birth); 
}

八、@ManyToOne(fetch=FetchType,cascade=CascadeType ) 
可选 
@ManyToOne 表示一个多对一的映射 , 该注解标注的属性一般是数据库表的外键 
optional: 是否容许该字段为 null, 该属性应该根据数据库表的外键约束来肯定 , 默认为 true 
fetch: 表示抓取策略 , 默认为 FetchType.EAGER 
cascade: 表示默认的级联操做策略 , 能够指定为 ALL,PERSIST,MERGE,REFRESH 和 REMOVE 中的若干组合 , 默认为无级联操做 
targetEntity: 表示该属性关联的实体类型 . 该属性一般没必要指定 ,ORM 框架根据属性类型自动判断 targetEntity. 
示例 : 
// 订单 Order 和用户 User 是一个 ManyToOne 的关系 
// 在 Order 类中定义 
@ManyToOne() 
@JoinColumn(name=”USER”) 
public User getUser() { 
return user; 
}

九、@JoinColumn 
可选 
@JoinColumn 和 @Column 相似 , 介量描述的不是一个简单字段 , 而一一个关联字段 , 例如 . 描述一个 @ManyToOne 的字段 . 
name: 该字段的名称 . 因为 @JoinColumn 描述的是一个关联字段 , 如 ManyToOne, 则默认的名称由其关联的实体决定 . 
例如 , 实体 Order 有一个 user 属性来关联实体 User, 则 Order 的 user 属性为一个外键 , 
其默认的名称为实体 User 的名称 + 下划线 + 实体 User 的主键名称 
示例 : 
见 @ManyToOne

十、@OneToMany(fetch=FetchType,cascade=CascadeType) 
可选 
@OneToMany 描述一个一对多的关联 , 该属性应该为集体类型 , 在数据库中并无实际字段 . 
fetch: 表示抓取策略 , 默认为 FetchType.LAZY, 由于关联的多个对象一般没必要从数据库预先读取到内存 
cascade: 表示级联操做策略 , 对于 OneToMany 类型的关联很是重要 , 一般该实体更新或删除时 , 其关联的实体也应当被更新或删除 
例如 : 实体 User 和 Order 是 OneToMany 的关系 , 则实体 User 被删除时 , 其关联的实体 Order 也应该被所有删除 
示例 : 
@OneTyMany(cascade=ALL) 
public List getOrders() { 
return orders; 
}

十一、@OneToOne(fetch=FetchType,cascade=CascadeType) 
可选 
@OneToOne 描述一个一对一的关联 
fetch: 表示抓取策略 , 默认为 FetchType.LAZY 
cascade: 表示级联操做策略 
示例 : 
@OneToOne(fetch=FetchType.LAZY) 
public Blog getBlog() { 
return blog; 
}

十二、@ManyToMany 
可选 
@ManyToMany 描述一个多对多的关联 . 多对多关联上是两个一对多关联 , 可是在 ManyToMany 描述中 , 中间表是由 ORM 框架自动处理 
targetEntity: 表示多对多关联的另外一个实体类的全名 , 例如 :package.Book.class 
mappedBy: 表示多对多关联的另外一个实体类的对应集合属性名称 
示例 : 
User 实体表示用户 ,Book 实体表示书籍 , 为了描述用户收藏的书籍 , 能够在 User 和 Book 之间创建 ManyToMany 关联 
@Entity 
public class User { 
private List books; 
@ManyToMany(targetEntity=package.Book.class) 
public List getBooks() { 
return books; 
} 
public void setBooks(List books) { 
this.books=books; 
} 
}

@Entity 
public class Book { 
private List users; 
@ManyToMany(targetEntity=package.Users.class, mappedBy=”books”) 
public List getUsers() { 
return users; 
} 
public void setUsers(List users) { 
this.users=users; 
} 
} 
两个实体间相互关联的属性必须标记为 @ManyToMany, 并相互指定 targetEntity 属性 , 
须要注意的是 , 有且只有一个实体的 @ManyToMany 注解须要指定 mappedBy 属性

1三、@TransactionAttribute 
事务管理服务 
最有用的容器服务可能就是事务管理服务，当应用出现失败或异常时，它保证了数据库的完整性。你能够简单地将为一个 POJO 方法申明它的事务属性。这样容器就能够在合适的上下文中运行这个方法。最多见的事务是定义在 session bean 的方法上，方法中全部的数据库操做只有在方法正常退出时才会提交，若是方法抛出未捕获的异常，事务管理将回滚全部的变动。 
@TransactionAttribute 注释用做定义一个须要事务的方法。例如： 
@TransactionAttribute(TransactionAttributeType.REQUIRED) 
public void insertProduct(String name, Float price, boolean error) { 
… 
… 
} 
它能够有如下参数： 
a.         REQUIRED : 方法在一个事务中执行，若是调用的方法已经在一个事务中，则使用该事务，不然将建立一个新的事务。 
b.         MANDATORY : 方法必须在一个事务中执行，也就是说调用的方法必须已经有一个事务，不然新抛出一个错误（ ERROR ）。 
c.         REQUIRESNEW : 方法将在一个新的事务中执行，若是调用的方法已经在一个事务中，则暂停旧的事务。 
d.         SUPPORTS : 若是方法在一个事务中被调用，则使用该事务，不然不使用事务。 
e.         NOT_SUPPORTED ：若是方法在一个事务中被调用，将抛出一个错误（ ERROR ） 
若是没有指定参数， @TransactionAttribute 注释使用 REQUIRED 做为默认参数。

1四、@PersistenceContextType 
PersistenceContextType.EXTENDED。在默认状况下，EntityManagers用TRANSACTION的 PersistenceContextType来建立。这样作也就表示，只有当有活动的事务处理在进行时，实体才是可托管的。事务处理一结束，实体就与实体管理程序脱离，这样咱们就能够丢弃它。EXTENDED上下文类型表示这种脱离不会发生，即便在事务处理结束后实体仍然是可托管的。这就意味着你不须要担忧集合是否被暂缓取回，由于实体管理程序能够用来完成所须要的取回操做。当咱们想要保持和更新／合并实体，或者从数据库里删除实体的时候，咱们仍然须要得到EntityTransaction，例如咱们想要保存一个新的Application实体： 
public void saveApplication(Application a) { 
EntityTransaction tx=em.getTransaction(); 
tx.begin(); 
em.persist(a); 
tx.commit(); 
}

 

 

原文  http://www.anool.net/?p=959