PersistenceManager
PersistenceManager可以说是JDO中使用非常频繁的一个类。很多对持久化对象的操作（就是对数据库的操作）都是通过这个类进行的，今天我把这个类中主要方法的使用和说明作一个简单的讲解，希望对大家学习JDO有所帮助。
上图显示的是PersistenceManager接口的常用方法和属性，它包含很多标准的JavaBean属性方法setter和getter，其中方法的参数中包含很多省略号的方法说明他们有多种重载的实现，完整的PersistenceManager接口可以参考JDO的JavaDoc。
PersistenceManager接口是开发人员在应用程序中与JDO进行交换的主要接口。每一个PersistenceManager接口控制着一系列的持久化对象和传输对象并且关联唯一的一个Transaction对象。
PersistenceManager接口的方法从功能上可以划分为以下几个部分：
l 用户对象的关联
l 配置属性
l Transaction的关联
l 可持久化生命周期的控制
l JDO一致性控制
l Query工厂
l Extent工厂
l 关闭方法
1、 用户对象关联
public Object getUserObject ();
public void setUserObject (Object obj);
PersistenceManager的UserObject允许为每一个PersistenceManager关联任意的对象。这个对象不会被JDO实现使用。
2、 配置属性
public boolean getMultithreaded ();
public void setMultithreaded (boolean threaded);
public boolean getIgnoreCache ();
public void setIgnoreCache (boolean ignore);
PersistenceManager的配置属性有两个：Multithreaded和Ignore。分别设置它是否可以被线程共享和是否忽略持久化对象状态的变化，具体的细节已经在上一节中讲过了，这里就不在重复了。
3、 Transaction关联
public Transaction currentTransaction ();
每一个PersistenceManager都对应一个唯一的Transaction对象。实际上很多厂商使用一个类来实现PersistenceManager和Transaction接口。如果你需要多个Transaction对象就需要多个PersistenceManager。你可以通过上面的方法获得当前PersistenceManager的Transaction。
4、 可持久化生命周期的控制
PersistenceManager通过几个动作来控制持久化对象的生命周期。每一种动作都有多个方法来实现。比如，makePersistent接收一个持久化对象，而makePersistentAll接收一系列持久化对象的集合。
public void makePersistent (Object pc);
public void makePersistentAll (Collection pcs);
public void makePersistentAll (Object[] pcs);
上面的方法用于一个活动的处理构成，当一个处理过程被提交之后新的数据就会被写入到数据库中。
public void deletePersistent (Object pc);
public void deletePersistentAll (Collection pcs);
public void deletePersistentAll (Object[] pcs);
上面的方法在持久化对象删除的时候调用。
public void makeTransient (Object pc);
public void makeTransientAll (Collection pcs);
public void makeTransientAll (Object[] pcs);
上面的方法会把持久化对象转换为瞬时对象，这样这个对象将和PersistenceManager和JDO一致性失去关联，因此对象的改变将不会影响到数据库。
public void makeTransactional (Object pc);
public void makeTransactionalAll (Collection pcs);
public void makeTransactionalAll (Object[] pcs);
上面的方法可以把非持久化对象放到当前的处理会话中，以便进行处理。
public void makeNontransactional (Object pc);
public void makeNontransactionalAll (Collection pcs);
public void makeNontransactionalAll (Object[] pcs);
将瞬时清楚对象转换为瞬时对象，将持久清楚对象转换为持久化非处理对象。如果在一个已经“脏化”的对象上调用这个方法会抛出一个JDOUserException异常。
public void evict (Object pc);
public void evictAll (Collection pcs);
public void evictAll (Object[] pcs);
public void evictAll ();
取出一个对象，它告诉PersistenceManager应用程序已经不再需要这个对象了。
public void refresh (Object pc);
public void refreshAll (Collection pcs);
public void refreshAll (Object[] pcs);
public void refreshAll ();
使用上面的方法保持持久化对象与数据库中的数据同步。
public void retrieve (Object pc);
public void retrieveAll (Collection pcs);
public void retrieveAll (Object[] pcs);
public void retrieveAll (Collection pcs, boolean dfgOnly);
public void retrieveAll (Object[] pcs, boolean dfgOnly);
从数据库中获得持久化对象的数据值。
5、 一个生命周期的例子
1） 处理对象
// 创建对象
Magazine mag = new Magazine ("1B78-YU9L", "JavaWorld");
Company pub = new Company ("Weston House");
pub.setRevenue (1750000D);
mag.setPublisher (pub);
pub.addMagazine (mag);
Article art = new Article ("JDO Rules!", "Transparent Object Persistence");
art.setAuthor (new Person ("Fred", "Hoyle"));
mag.addArticle (art);
//获得PersistenceManager对象
PersistenceManager pm = pmFactory.getPersistenceManager ();
pm.currentTransaction ().begin ();
pm.makePersistent (mag);
pm.currentTransaction ().commit ();
//关闭PersistenceManager对象
pm.close ();
2） 更新对象
// 假设我们已经通过getObjectId获得了一个对象
Object oid = ...;
//创建PersistenceManager并获得Mahazine对象
PersistenceManager pm = pmFactory.getPersistenceManager ();
Magazine mag = (Magazine) pm.getObjectById (oid, false);
Company pub = mag.getPublisher ();
// 更新数据并提交到数据库
pm.currentTransaction ().begin ();
mag.setIssue (23);
company.setRevenue (1750000D);
pm.currentTransaction ().commit ();
//关闭PersistenceManager对象，释放资源。
pm.close ();
3） 删除对象
// 假设我们已经通过getObjectId获得了一个对象
Object oid = ...;
//创建PersistenceManager并获得Mahazine对象
PersistenceManager pm = pmFactory.getPersistenceManager ();
Magazine mag = (Magazine) pm.getObjectById (oid, false);
// 删除对象中的数据并提交到数据库
pm.currentTransaction ().begin ();
pm.deletePersistentAll (mag.getArticles ());
pm.currentTransaction ().commit ();
//关闭PersistenceManager对象，释放资源。
pm.close ();
6、 JDO一致性控制
每个PersistenceManager负责维护当前持久化对象的JDO一致性。下面的代码使你能够控制JDO的一致性：
public Class getObjectIdClass (Class pcClass);
下面的方法通过getObjectId获得持久化对象并根据给定的一致性字符字段维护JDO一致性
public Object getObjectId (Object pc);
public Object newObjectIdInstance (Class pcClass, String identityString);
7、 Extent工厂
public Extent getExtent (Class pcClass, boolean includeSubclasses);
Extent是一个给定的持久化对象实例的逻辑表示，它可以通过PersistenceManager的getExtent()方法获得。这个方法有两个参数：第一个是持久化类，第二个是一个boolean值代表是否包含这个持久化类的子类。
如果这个方法中的持久化类的元数据中requires-extent为false那么你将无法获得这个持久化类的Extent。
8、 Query工厂
public Query newQuery ();
public Query newQuery (Class candidateClass);
public Query newQuery (Extent candidates);
public Query newQuery (Class candidateClass, Collection candidates);
public Query newQuery (Class candidateClass, String filter);
public Query newQuery (Class candidateClass, Collection candidates, String filter);
public Query newQuery (Extent candidates, String filter);
public Query newQuery (String language, Object serialized);
public Query newQuery (Object serialized);
Query对象用于从持久化对象查询匹配的数据，你可以通过PersistenceManager的一系列newQery方法获得Query对象，有关Query对象的使用我会在后面详细讲述。
9、 关闭方法
public boolean isClosed ();
public void close ();
当一个PersistenceManager对象不再使用的时候你应该调用它colose方法把它关闭，这样就释放了这个PersistenceManager对象的资源。这是由这个PersistenceManager控制的其他对象也无法使用，如果你调用这个PersistenceManager的方法时（除了isClosed）或抛出一个JDOUserException异常。
版权声明：
我写的有关JDO的所有文章都可以任意转载，但转载文章中请务必保留作者信息,谢谢。
作者：刘国栋
Mail:wafd@hotmail.com
Qq:282099538
