JAVA数据对象应用程序接口Castor使用参考

　　exolab旗下的castor是目前流行的、开放源码的JDO实现包。 它主要用来实现O/R Mapping。运用该软件包可以大大减轻程序员在处理对象-关系数据库的负担。本文介绍了Castor的基本用法, 并用有大量代码实例进行解释。
　　
　　
　　
　　
　　
　　内容提要：
　　
　　
　　
　　· 打开JDO数据库 Client应用
　　
　　
　　
　　· J2EE应用
　　
　　
　　
　　· 使用JDO数据库对象
　　
　　
　　
　　· 区别瞬时JDO对象和持久JDO对象
　　
　　
　　
　　· OQLQuery
　　
　　
　　
　　· 创建与更新和删除
　　
　　
　　
　　· 使用JDO和XML
　　
　　
　　
　　
　　
　　打开JDO数据库
　　
　　
　　
　　Castor JDO支持两种类型的环境，Client应用和J2EE服务器。 Client应用被用来负责配置数据库连接和明确地管理事务。 J2EE应用使用JNDI来获得预先设好的数据库连接并利用UserTransaction或容器管理事务(CMT)来处理事务。 如果你曾经在这两种环境中使用过JDBC，那么应该比较熟悉这两种模型和他们之间的区别。
　　
　　
　　
　　
　　
　　Client应用
　　
　　
　　
　　Client应用负责定义JDO数据库配置，和明确地管理事务处理。 数据库通过一个单独的XML文件被配置 并连接到一个Mapping文件。 在例子代码中我将数据库文件命名为database.xml，但是你可以使用任何别的名称。 更多信息参见Castor JDO数据库配置。
　　
　　
　　
　　
　　
　　org.exolab.castor.jdo.JDO定义数据库名称和属性并且被用来打开数据库连接。 在上
　　
　　
　　
　　
　　
　　可以通过设置setConfiguration文件的URL来要求JDO层装载哪个数据库配置。 注意：Castor JDO在建立多个用同样的配置的JDO对象的情况下，将会仅仅只执行一次装载数据库配置。
　　
　　
　　
　　
　　
　　org.exolab.castor.jdo.Database对象代表数据库的一个打开的连接。
　　
　　
　　
　　
　　
　　线程 JDO对象定义不是线程安全的,因此不应该在并发多线程中使用JDO对象。还有，建立多个JDO对象仅仅 需要少量额外工作，而JDBC连接在每个事务处理中仅仅打开一次。这样处理的模式能够大大提高性能。
　　
　　
　　
　　
　　
　　下列的代码片断展示了在Client应用中很常用的组合：“打开数据库，执行SQL，关闭数据库。”
　　
　　
　　
　　JDO jdo;
　　
　　
　　
　　Database db;
　　
　　
　　
　　
　　
　　// 定义JDO对象
　　
　　
　　
　　jdo = new JDO();
　　
　　
　　
　　jdo.setDatabaseName( "mydb" );
　　
　　
　　
　　jdo.setConfiguration( "database.xml" );
　　
　　
　　
　　jdo.setClassLoader( getClass().getClassLoader() );
　　
　　
　　
　　
　　
　　// 打开一个新的数据库连接
　　
　　
　　
　　db = jdo.getDatabase();
　　
　　
　　
　　// 开始处理事务
　　
　　
　　
　　db.begin();
　　
　　
　　
　　// 以下是一些业务逻辑
　　
　　
　　
　　. . .
　　
　　
　　
　　// 提交事务处理，并且关闭数据库
　　
　　
　　
　　db.commit();
　　
　　
　　
　　db.close();
　　
　　
　　
　　J2EE应用
　　
　　
　　
　　前提： 假设我们的J2EE容器内嵌支持Castor。
　　
　　
　　
　　J2EE应用依赖于J2EE容器(Servlet，EJB，等等)构成数据库关连和使用JNDI找到它，使用它。 J2EE应用模型允许应用部署从一个中央的地方构成数据库中心，并且提供了J2EE容器能够管理横跨多重的数据源的分布式的处理能力。
　　
　　
　　
　　
　　
　　在J2EE环境中，应用程序使用JNDI lookup代替org.exolab.castor.jdo.JDO 来构造JDO对象。 专家一般推荐把JDO对象的JNDI放在java:comp/env/jdo 之下的命名空间，这样可兼容JDBC资源列表的规定。
　　
　　
　　
　　下列的代码片断使用JNDI来查询数据库对象,并且使用UserTransaction来管理事务处理
　　
　　
　　
　　InitialContext ctx;
　　
　　
　　
　　UserTransaction ut;
　　
　　
　　
　　Database db;
　　
　　
　　
　　
　　
　　// 用JNDI的查询得到databse对象
　　
　　
　　
　　ctx = new InitialContext();
　　
　　
　　
　　db = (Database) ctx.lookup( "java:comp/env/jdo/mydb" );
　　
　　
　　
　　
　　
　　// 开始处理事务
　　
　　
　　
　　ut = (UserTransaction) ctx.lookup( "java:comp/UserTransaction" );
　　
　　
　　
　　ut.begin();
　　
　　
　　
　　// 以下是一些业务逻辑
　　
　　
　　
　　. . .
　　
　　
　　
　　// 提交事务处理，并且关闭数据库
　　
　　
　　
　　ut.commit();
　　
　　
　　
　　db.close();
　　
　　
　　
　　
　　
　　如果事务是由容器来管理, 比如 EJB Bean在特别是实体 Bean中时，不需要明确地与指明事务的开始和结束提交；应用服务器将会照料那些正在进行的处理的事务，并在适当的时间的提交或会滚数据库请求下列的代码片断展示了如何利用依赖于容器管理事务：
　　
　　
　　
　　InitialContext ctx;
　　
　　
　　
　　UserTransaction ut;
　　
　　
　　
　　Database db;
　　
　　
　　
　　
　　
　　// 用JNDI的查询得到databse对象
　　
　　
　　
　　ctx = new InitialContext();
　　
　　
　　
　　db = (Database) ctx.lookup( "java:comp/env/jdo/mydb" );
　　
　　
　　
　　
　　
　　// 业务逻辑
　　
　　
　　
　　. . .
　　
　　
　　
　　// 关闭数据库
　　
　　
　　
　　db.close();
　　
　　
　　
　　使用JDO数据库对象
　　
　　
　　
　　区别瞬时JDO对象和持久JDO对象
　　
　　
　　
　　所有JDO操作在事务处理的上下文之内发生。
　　
　　
　　
　　JDO通过把数据库中的数据装载到内存中的对象，并允许应用程序修改对象，然后存储对象的新的状态到数据库中去当应用程序提交事务时。
　　
　　
　　
　　所有对象只可能有两种状态： 瞬时或者持久（Transient / Persistent）
　　
　　
　　
　　瞬时： 瞬时JDO对象，当应用程序提交事务时，其状态将不被保存到的数据库。瞬时JDO对象的变化将不在数据库中反映出来。
　　
　　
　　
　　持久：持久JDO对象当应用程序提交事务时，其状态将被保存的任何对象数据库。持久JDO对象的变化将在数据库中反映出来。
　　
　　
　　
　　一个对象可以有两种途径变成为持久JDO对象： 它是由查询产生的，(该查询不是被设置为只读方式)或者 否则它用create(java.lang.Object)或者update(java.lang.Object)方法来存入数据库。
　　
　　
　　
　　· 所有不是持久JDO对象的对象是瞬时JDO对象。
　　
　　
　　
　　· 当应用程序提交事务或者回滚时，所有持久JDO对象自动变回得瞬时JDO对象。 在Client应用中，我们可以使用begin()，commit()和rollback()管理事务。 但是在J2EE应用中，依赖于容器的JDO对象或者是隐含地(基于Bean的事务属性)或者是明确地使用javax.transaction.UserTransaction接口来管理事务。
　　
　　
　　
　　如果一个持久JDO对象在处理期间被修改，在应用程序提交事务时相关的修改被存入数据库。 一旦事务回滚，将不会有任何相关的修改存入数据库。
　　
　　
　　
　　一旦事务处理完成，对象将再一次变回瞬时JDO对象。为了在两种不同的事务处理中使用相同的对象，你必须再一次提交查询来生成它。
　　
　　
　　
　　一个JDO对象是属于瞬时JDO对象还是持久JDO对象取决于当时的数据库处理是处在那个事务处理中。在实际环境中，往往会发现一个JDO对象在一个的数据库连接中属于持久JDO对象，而在另一个数据库连接将返回调用isPersistent(java.lang.Object)却返回false（就是说它是瞬时JDO对象)。这使得可以让一个JDO对象同时在2个数据库连接属于持久态：在一个数据库连接查询它在另一个数据库连接创建它。
　　
　　
　　
　　OQL查询
　　
　　
　　
　　OQL查询通常用于在数据库中查找并创建一个JDO对象. OQL查询盒类似于SQL查询，不过用对象名称而不是 SQL名称并且不支持join子句。 例如，如果所装载的对象是TestObject类，OQL查询将从TestObject加载，而不管数据库的实际的表名称是test,test_object还是任何其它名称。如果相关的对象需要join操作，Castor将自动地执行join操作。 下列的代码片断使用OQL查询来将所有对象装载在一个给定的组中。 注意，产品表和产品组表是相关的对象，JDBC查询包括了join操作：
　　
　　
　　
　　OQLQuery oql;
　　
　　
　　
　　QueryResults results;
　　
　　
　　
　　
　　
　　// Construct a new query and bin