Product映射:
现在我们要开始讲解从Product类到数据库表PRODUCT的映射。通常这种映射都不是通过
编程实现,而是通过定义一个xml文件。DescriptorRepository类提供了一些方法来读取
xml文件并进行初始化。结果就能在以后的编程中被使用(也可以通过纯编程来实现)。
我们已经写好了我们的映射关系,文件放置在src/test/ojb/repository.xml,中,xml
文件如下所示:
<?xml version="1.0" encoding="UTF-8"?>
<!-- This is a sample metadata repository for the ObJectBridge System.
Use this file as a template for building your own mappings-->
<!-- defining entities for include-files -->
<!DOCTYPE descriptor-repository SYSTEM "repository.dtd" [
<!ENTITY user SYSTEM "repository_user.xml">
<!ENTITY junit SYSTEM "repository_junit.xml">
<!ENTITY internal SYSTEM "repository_internal.xml">
]>
<descriptor-repository version="0.9.1"
isolation-level="read-uncommitted">
<!-- The Default JDBC Connection. If a class-descriptor does not
specify its own JDBC Connection,
the Connection specified here will be used. -->
<jdbc-connection-descriptor
platform="Hsqldb"
jdbc-level="2.0"
driver="org.hsqldb.jdbcDriver"
protocol="jdbc"
subprotocol="hsqldb"
dbalias="/samples/hsql/OJB"
username="sa"
password=""
/>
<!-- include user defined mappings here -->
&user;
<!-- include mappings for JUnit tests and sample apps here -->
&junit;
<!-- include ojb internal mappings here -->
&internal;
</descriptor-repository>
文件含有很多的信息:
1. Xml文件通过repository.dtd来验证其有效性。这就保证的xml文件语法的正确性。
确保将dtd文件放在和xml文件一样的目录,否则xml解析器将会报出找不到DTD的错误
2. 映射包含一个缺省的JDBCConnectDescriptor。该描述包含了在存储操作中所用到的
JDBC连接。对于那些没有定义特殊的JDBCConnectionDescriptor的类来说,都使用该描
述中的缺省JDBC连接。
在我们的例子中,描述申明了所有的操作都是靠JsqlDb JDBC驱动的,相应的数据库放在
相应的目录下面。
3. OJB映射回归测试。通过包含repository_junit.xml中的XML entity&junit。该ent
ity被定义在一个包含的文件中:
<!ENTITY junit SYSTEM "repository_junit.xml">
4. OJB内部的映射。OJB需要一些内部表来进行一次阿操作,如维持数据库锁,自动增
长,ODMG的collections和Maps。相应的映射也在这里实现。他们都正确的操作起重要作
用,应该不能被修改。
这些内部映射通过包含repository_internal.xml中的XML entity&internal来定义
5. 用户定义的映射。用户定义的映射包含所有对存储类做的对象/关系映射信息。缺省
的,实例程序的映射在这里定义。这些映射通过包含repository_user.xml的XML entit
y&user来定义。
现在让我们来看一下Product类,我把相应的映射放在repository_user.xml中,这样我们很
容
易找到。从文件的开头我们可以看到有一个对Product类的类描述:
<!-- Definitions for org.apache.ojb.broker.Product -->
<class-descriptor
class="org.apache.ojb.broker.Product"
table="PRODUCT"
>
<field-descriptor
name="id"
column="ID"
jdbc-type="INTEGER"
primarykey="true"
autoincrement="true"
/>
<field-descriptor
name="name"
column="NAME"
jdbc-type="VARCHAR"
/>
<field-descriptor
name="price"
column="PRICE"
jdbc-type="DOUBLE"
/>
<field-descriptor
name="stock"
column="STOCK"
jdbc-type="INTEGER"
/>
</class-descriptor>
类描述给出了和RDBMS表相映射的类名称。
对于每个存储类的属性,我们定义一个field-descriptor,对应存储在数据库中的每一
列.对于主键,我们有一个特别的标记:primarykey="true".主键也相应地被设为autoi
ncrement="true",这就告诉了OJB给这个属性分配一个唯一的ID。这些都是通过一个Se
quenceManager工具类实现的。
Field-descriptor既可以声明primitive data型,也可以声明相应的封装类。
如果你的存储类中含有其他存储类的实例,你可以通过reference-descriptor来定义它
们之间的关系。如果存储类中有array-或是collection-属性,你可以使用collection-
descriptor属性。你可以在org.apache.ojb.broker包中找到一些例子,相应的描述在r
epository.xml中。
工具支持:
一般说来,有三种建立O/R映射的方式:
1. Forward engineering。通过给出Java类(或是UML模型),生成SQL DDL和映射关系
。我们可以使用一个工具从repository.xml生成一个数据库。执行build[.sh] forword
-db可以看到forward engineering的工作过程。
2. Reverse engineering。给出SQL DDL或者数据库,产生Java类和映射。执行build[
.sh] reverse-db可以看到reverse engineering的工作过程。
3. Mapping proper。给出Java类和SQL DDL,产生映射。我们现在还没有进行果测试,
但是已经列入下一步的计划中。
结论:
在本文中,我们学习了怎样给一个简单的类建立OJB对象/关系映射,在类的实例上通过
OJB PersistenceBroker API进行存储操作。
接着还有三篇文档,介绍了如何使用OJB ODMG API,OJB JDO API和高级O/R映射(包括
1-1,1-n映射,代理机制,支持多态性和映射继承)
我们希望该文档会对你有帮助,欢迎提出意见建议。
本文地址:http://com.8s8s.com/it/it17168.htm