/**
持久化服务
1.托管与非托管实体
Persistener context是由一组受托管的实体对象实例所构成的集合,他受entity manager的管理.一旦persistent context被关闭,所有的实体对象都会脱离EntityManager而成为非托管对象.JPA中有两种类型的persistent context,分别是
i.transaction-scoped persistence
他只能在事物范围内存在着,他们会在事务结束后被关闭,transaction-scope persistent将被销毁,托管实体对象实例也将处于只有受服务器管理的persistent context才可以是事物范围的,换言之,必须被注解@PersistentContext表示的EntityManager实列才可以是事务管理的.看代码.
*/
@persistenceContext(UnitName="EntityName")
EntityManager entityManager;
@TransactionAttribute(REQUIRED)
public Customer someMethod(){
Customer cust = entityManager.find(Customer.class,new Integer(1));
cust.setName("new name");
return cust;
}
/**
由entityManager返回的Customer实例会在整个JTA事物内保持存在姿态,当JTA事务完成后,有setName调用引起的数据更改会被同步到数据库中.entityManager对象将会被销毁,改对象不在托管了.
ii.Extented persistent context
我们也可以将persistent context配置成超出事务的范围,与Extented persistent context向关联的对象会一直保持托管状态,甚至在事务提交后也是如此,在某些场景下特别有用,你想保持数据库连接,又不希望使用长事务,因为长事务会在占用JDBC连接,这样的数据宝贵资源.
2.为persistent Unit打包
每个EntityManager负责将一定数量的一组类映射到数据库中,这组类就叫做persistent Unit.它是在persistent.xml文件中定义的,根据JPA标准的要求,改部署文件是必须的.一个persistent.xml可以定义一个或多个persistent unit.他被放在各类的文件的meta-inf目录中.
每个persistent unit只能关联一个且仅一个数据源,在javaEE环境中,我们通过persistent.xml文件来配置,下面我们来分析下persistent.xml文件的格式.
<?xml version="1.0" encoding="GBK"?>
<persistence>
<persistence-unit name="" transaction-type="">
<description></description>
<provider></provider>
<class></class>
<mapping-file />
<jar-file />
<property name=""></property>
</persistence-unit>
</persistence>
参看上面的代码,name定义了unit的引用名,,提供注入用注解.该属性是必须的.属性transaction-type指明了你是希望persistent unit受JavaEE事务管理并与之集成,还是使用resource-local来管理.后者在JavaSE环境中使用.provider指定了实现javax.persistence.PersistenceProvider接口的类的全局限定名称.property元素定义了一组厂商的专有属性.建议使用class元素来定义需要映射到关系数据库中的类.
3.获得EntityManager
如果是在EJB环境中应用JPA,强烈建议使用@PersistenceContext注解或等价的XML描述.看代码:
*/
@Stateless
public class MySessionBean implements MySessionRemote{
@PersistenceContext(unitName="titan")
private EntityManager entitymanager;
...
}
/**
需要注意的是:默认情况下,在使用@PersistenceContext注解时,容器会将一个transaction-scoped类型的persistent context注入EJB.类型为Extended的Entity Manager只能注入到statefull session bean中.看代码:
*/
@Stateful
public class MyStatefulBean implements MyStatefulRemote{
@PersistenceContext(unitName="titan", type=PersistenceContextType.EXTENDED)
private EntityManager entitymanager;
...
}
4.操作EntityManager
i.持久化实体:就是将对象插入到数据库中,你所持久化的还是未曾保持到数据库中的实体,要持久化实体,首先要为实体分配内存,然后设置成员属性,并设置好与其他对象可能存在的任何关联关系,最后你就可以调用EntityManager.persist()方法来保持该实体了.
*/
Customer cust = new Customer();
cust.setName("Bill");
entityManager.persist(cust);
/**
当调用persist()方法后,EntityManager会将Customer添加到等待数据库插入的队列中,对象实例即处于托管状态,实际的操作要看:如果实在事务范围内调用,插入操作可能马上就执行,也可能在事务提交时执行,这依赖于flush模式,任何时候你都可以通过flush操作在一个事务内强制插入操作.
ii.查找实体:提供了2种方法:find(),getReference().
*/
public interface EntityManager{
T find(Class entityClass, Object primayKey);
T getReference(Class entityClass, Object primarykey);
}
/**
2个方法都接受实体的class和代表实体主键的对象作为参数,区别是如果找不到指定实体时,find方法会返回null,getReference方法会抛出javax.persistent.EntityNotFound Exception,并且该方法并不保证实例的内部状态不会被初始化.若是transaction-scope persistence contenxt,则返回游离对象(记住是在事务范围之外调用这2个方法).
*/
Customer cust = entityManager.find(Customer.class,1);
/**
我们还可以使用EJB QL来查询,使用CreateNativeQuery()来创建Query对象来进行查询.
*/
Query query = entityManager.CreateQuery("FROM Customer c WHERE id=2");
Customer cust = (Customer)query.getSingleResult();
/**
由于你一旦调用了find(),getResource()方法,或使用查询对象执行了一次查询,所得的entity bean 在persisten测 context关闭前仍将处于托管状态,在此期间,你可以像其他对象那样随便更改entity bean实例的状态,任何更改都将自动过手动地同步到数据库中.
iii.合并实体:你可以使用EntityManager的meger()方法,将游离实体的状态合并到数据库中,假设有一个Swing客户端,它调用了TravleAgent Session bean的远程方法,用以查找数据库中的cabinet实体.看代码:
*/
@persistenceContext EntityManager entityManager;
@TransactionAttribute(REQUIRED)
public Cabin findCabin(int pid){
return entityManager.find(Cabin.class, pid);
}
/**
在findCabin()结束后,persistence context被销毁,entity bean 处于非托管状态,当Cabin实例被序列化,并被送到远程的Swing客户端,此时,该Cabin实例是一个普通的Java对象.Swing客户端更改了这一Cabin实例的状态,然后将其重新送回服务器.看代码:
*/
Cabin cabin = trvalAgent.findCabin(1);
cabin.setBedCount(4);
trvalAgent.updateCabin(cabin);
//--------------------------------------------//
@persistenceContext EntityManager entityManager;
@TransactionAttribute(REQUIRED)
public void updateCabin(Cabin cabin){
Cabin copy = entityManager.merge(cabin);
}
/**
需要注意2中情况:
1.若EntityManager未曾管理与传入的cabin参数有着相同的Cabin实例,则merge()方法会创建该参数的一份完整拷贝做为方法的返回值,该拷贝受entityManager对象的管理,并且任何针对该份操作做的更改,而传入的cabin参数仍将保持游离状态,不受托管.
2.若拥有与传入的Cabin参数有着相同的Cabin实例,则托管到托管的对象实例中,其余的同上操作.
责任编辑：小草
