在应用程序中将OJB作为一个存储层使用（六）

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映射，代理机制，支持多态性和映射继承）

我们希望该文档会对你有帮助，欢迎提出意见建议。