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映射,代理机制,支持多态性和映射继承)  
我们希望该文档会对你有帮助,欢迎提出意见建议。   
 
  |