JPA注解

  @NotFound(action=NotFoundAction.IGNORE)

使用hibernate
注解配置实体类的关联关系，在many-to-one,one-to-one关联中，一边引用自另一边的属性，如果属性值为某某的数据在数据库不存在了，hibernate默认会抛出异常。解决此问题，加上如下注解就可以了：

@NotFound(action=NotFoundAction.IGNORE)，意思是找不到引用的外键数据时忽略，NotFound默认是exception

cascade = CascadeType.REFRESH，cascade=CascadeType.ALL

cascade表示级联操作  

   CascadeType.MERGE级联更新：若items属性修改了那么order对象保存时同时修改items里的对象。对应EntityManager的merge方法

 
   CascadeType.PERSIST级联刷新：获取order对象里也同时也重新获取最新的items时的对象。对应EntityManager的refresh(object)方法有效。即会重新查询数据库里的最新数据  
  

  CascadeType.REFRESH级联保存：对order对象保存时也对items里的对象也会保存。对应EntityManager的persist方法  
  

  CascadeType.REMOVE级联删除：对order对象删除也对items里的对象也会删除。对应EntityManager的remove方法  

CascadeType.PERSIST只有A类新增时，会级联B对象新增。若B对象在数据库存（跟新）在则抛异常（让B变为持久态）

CascadeType.MERGE指A类新增或者变化，会级联B对象（新增或者变化）

CascadeType.REMOVE只有A类删除时，会级联删除B类；

CascadeType.ALL包含所有；

CascadeType.REFRESH没用过。

综上：大多数情况用CascadeType.MERGE就能达到级联跟新又不报错，用CascadeType.ALL时要斟酌下CascadeType.REMOVE

@Fetch:

定义了加载关联关系的获取策略. FetchMode 可以是

SELECT (在需要加载关联的时候触发select操作),     SUBSELECT(只对集合有效,使用了子查询策略,详情参考Hibernate参考文档)

JOIN (在加载主实体(owner entity)的时候使用SQL JOIN来加载关联关系).

JOIN 将覆写任何延迟属性 (通过 JOIN策略加载的关联将不再具有延迟性).

fetch=FetchType.LAZY

Hibernate的数据加载方式：
1.即时加载 immediately loading

       实体加载完成后，立即加载其关联的数据。
2.延迟加载lazy loading

       实体相关联的数据在第一次访问时再进行读取。
3.预先加载 eager loading

        与immediately loading类似，但实体和相关联的数据是通过 一条sql同时读取。
4.批量加载 batch loading

        ？

EntityManager 的API
下面是EntityManager的一些主要的接口方法：
void persist(Object entity)
      通过调用EntityManager的persist()方法，新实体实例将转换为受控状态。这意谓着当persist()方法所在的事务提交时，实体的数据将保存到数据库中。如果实体已经被持久化，那么调用persist()操作不会发生任何事情。如果对一个已经删除的实体调用persist()操作，删除态的实体又转变为受控态。如果对游离状的实体执行persist()操作，将抛出IllegalArgumentException。 在一个实体上调用persist()操作，将广播到和实体关联的实体上，执行相应的级联持久化操作；

void remove(Object entity)
      通过调用remove()方法删除一个受控的实体。如果实体声明为级联删除(cascade=REMOVE 或者cascade=ALL )，被关联的实体也会被删除。在一个新建状态的实体上调用remove()操作，将被忽略。如果在游离实体上调用remove()操作，将抛出IllegalArgumentException，相关的事务将回滚。如果在已经删除的实体上执行remove()操作，也会被忽略；

void flush()
      将受控态的实体数据同步到数据库中；

T merge(T entity)
      将一个游离态的实体持久化到数据库中，并转换为受控态的实体；

T find(Class entityClass, Object primaryKey)
      以主键查询实体对象，entityClass是实体的类，primaryKey是主键值，如以下的代码查询Topic实体： Topic t = em.find(Topic.class,1); Query createQuery(String qlString) 根据JPA的查询语句创建一个查询对象Query，如下面的代码：
Query q= em.createQuery(""SELECT t FROM Topic t WHERE t.topicTitle LIKE :topicTitle")"); Query createNativeQuery(String sqlString) 

使用本地数据库的SQL语句创建一个Query对象，Query通过getResultList()方法执行查询后，返回一个List结果集，每一行数据对应一个Vector。

核心提示：JPA 注解的几个要点 1.设置Pojo为实体 @Entity //标识这个pojo是一个jpa实体 public class Users implements Serializable{ } 2.设置表名 @Entity @Table (name= users ) //指定表名为users public class Users implements Serializable{ } 3.设置主键 public
JPA 注解的几个要点

1.设置Pojo为实体


@Entity //标识这个pojo是一个jpa实体     
public class Users implements Serializable {     
}    


2.设置表名


@Entity     
@Table(name = "users") //指定表名为users     
public class Users implements Serializable {     
}    


3.设置主键


public class Users implements Serializable {     
@Id     
private String userCode;    


4. 设置字段类型
通过@Column注解设置，包含的设置如下
.name：字段名
.unique：是否唯一
.nullable：是否可以为空
.inserttable：是否可以插入
.updateable：是否可以更新
.columnDefinition: 定义建表时创建此列的DDL
.secondaryTable: 从表名。如果此列不建在主表上（默认建在主表），该属性定义该列所在从表的名字。


@Column(name = "user_code", nullable = false, length=32)//设置属性userCode对应的字段为user_code，长度为32，非空     
private String userCode;     
@Column(name = "user_wages", nullable = true, precision=12, scale=2)//设置属性wages对应的字段为user_wages，12位数字可保留两位小数，可以为空     
private double wages;     
@Temporal(TemporalType.DATE)//设置为时间类型     
private Date joinDate;    



5.字段排序
在加载数据的时候可以为其指定顺序，使用@OrderBy注解实现


@Table(name = "USERS")     
public class User {     
@OrderBy(name = "group_name ASC, name DESC")     
private List books = new ArrayList();     
}    


6.主键生成策略


public class Users implements Serializable {     
@Id     
@GeneratedValue(strategy=GenerationType.IDENTITY)//主键自增，注意，这种方式依赖于具体的数据库，如果数据库不支持自增主键，那么这个类型是没法用的     
@Column(name = "user_id", nullable = false)     
private int userId;     
   
   
public class Users implements Serializable {     
@Id     
@GeneratedValue(strategy=GenerationType.TABLE)//通过一个表来实现主键id的自增，这种方式不依赖于具体的数据库，可以解决数据迁移的问题     
@Column(name = "user_code", nullable = false)     
private String userCode;     
   
   
public class Users implements Serializable {     
@Id     
@GeneratedValue(strategy=GenerationType.SEQUENCE)//通过Sequence来实现表主键自增，这种方式依赖于数据库是否有SEQUENCE，如果没有就不能用     
@SequenceGenerator(name="seq_user")     
@Column(name = "user_id", nullable = false)     
private int userId;    



7.一对多映射关系
有T_One和T_Many两个表，他们是一对多的关系，注解范例如下
主Pojo


@Entity     
@Table(name = "T_ONE")     
public class One implements Serializable {     
private static final long serialVersionUID = 1L;     
@Id     
@Column(name = "ONE_ID", nullable = false)     
private String oneId;     
@Column(name = "DESCRIPTION")     
private String description;     
@OneToMany(cascade = CascadeType.ALL, mappedBy = "oneId")//指向多的那方的pojo的关联外键字段     
private Collection<Many> manyCollection;     


子Pojo


@Entity     
@Table(name = "T_MANY")     
public class Many implements Serializable {     
private static final long serialVersionUID = 1L;     
@Id     
@Column(name = "MANY_ID", nullable = false)     
private String manyId;     
@Column(name = "DESCRIPTION")     
private String description;     
   
@JoinColumn(name = "ONE_ID", referencedColumnName = "ONE_ID")//设置对应数据表的列名和引用的数据表的列名     
@ManyToOne//设置在“一方”pojo的外键字段上     
private One oneId;     



8.多对多映射关系
貌似多对多关系不需要设置级联，以前用hibernate的时候着实为多对多的级联头疼了一阵子，JPA的多对多还需要实际的尝试一下才能有所体会。
估计JPA的多对多也是可以转换成两个一对多的。

第一个Pojo


@Entity     
@Table(name = "T_MANYA")     
public class ManyA implements Serializable {     
private static final long serialVersionUID = 1L;     
@Id     
@Column(name = "MANYA_ID", nullable = false)     
private String manyaId;     
@Column(name = "DESCRIPTION")     
private String description;     
@ManyToMany     
@JoinTable(name = "TMANY1_TMANY2", joinColumns = {@JoinColumn(name = "MANYA_ID", referencedColumnName = "MANYA_ID")}, inverseJoinColumns = {@JoinColumn(name = "MANYB_ID", referencedColumnName = "MANYB_ID")})     
private Collection<ManyB> manybIdCollection;     


第二个Pojo


@Entity     
@Table(name = "T_MANYB")     
public class ManyB implements Serializable {     
private static final long serialVersionUID = 1L;     
@Id     
@Column(name = "MANYB_ID", nullable = false)     
private String manybId;     
@Column(name = "DESCRIPTION")     
private String description;     
@ManyToMany(mappedBy = "manybIdCollection")     
private Collection<ManyA> manyaIdCollection;     



9.一对一映射关系
主Pojo


@Entity     
@Table(name = "T_ONEA")     
public class OneA implements Serializable {     
private static final long serialVersionUID = 1L;     
@Id     
@Column(name = "ONEA_ID", nullable = false)     
private String oneaId;     
@Column(name = "DESCRIPTION")     
private String description;     
@OneToOne(cascade = CascadeType.ALL, mappedBy = "oneA")//主Pojo这方的设置比较简单，只要设置好级联和映射到从Pojo的外键就可以了。     
private OneB oneB;    

从Pojo


@Entity     
@Table(name = "T_ONEB")     
public class OneB implements Serializable {     
private static final long serialVersionUID = 1L;     
@Id     
@Column(name = "ONEA_ID", nullable = false)     
private String oneaId;     
@Column(name = "DESCRIPTION")     
private String description;     
@JoinColumn(name = "ONEA_ID", referencedColumnName = "ONEA_ID", insertable = false, updatable = false)//设置从方指向主方的关联外键，这个ONEA_ID其实是表T_ONEA的主键     
@OneToOne     
private OneA oneA;     



10 大字段


@Lob //对应Blob字段类型     
@Column(name = "PHOTO")     
private Serializable photo;     
@Lob //对应Clob字段类型     
@Column(name = "DESCRIPTION")     
private String description;    



11.瞬时字段
不需要与数据库映射的字段，在保存的时候不需要保存倒数据库


@Transient     
private int tempValue;     
   
public int getTempValue(){     
get tempValue;     
}     
   
public void setTempValue(int value){     
this.tempValue = value;     
}