WebSphere 4.0 中的 EJB 元数据: 第 1 部分：四个文件的故事

JavaBeans 1.1//EN" "http://java.sun.com/j2ee/dtds/ejb-jar_1_1.dtd">

 
   
      personEJB
      com.ibm.demo.ejbs.personHome
      com.ibm.demo.ejbs.person
      com.ibm.demo.ejbs.personBean
      Container
      java.lang.Integer
      False
      id
      name
      age
      educationLevel
      id
   
 
 
   
      
          Everyone can gain access to this EJB.
      
     everyone
   
   
     everyone
     
         personEJB
         *
     
   
   
     
        personEJB
        *
     
     Required
   
 

    

/META-INF
   ejb-jar.xml
   MANIFEST.MF
   Map.mapxmi
   Table.ddl
   /Schema/schema.dbxmi
    

   
      
         personEJB
         com.ibm.demo.ejbs.personHome
         com.ibm.demo.ejbs.person
         com.ibm.demo.ejbs.personBean
         Container
         java.lang.Integer
         False
         
            id
         
         
            name
         
         
            age
         
         
            educationLevel
         
         id
      
   
   _

    

CREATE TABLE pERSONEJB
  (ID INTEGER NOT NulL,
   NAME VARCHAR(250),
   AGE INTEGER,
   EDUCATIONLEVEL INTEGER);
ALTER TABLE pERSONEJB
  ADD CONSTRAINT pERSONEJBpK pRIMARY KEY (ID);
        

xmlns:RDBSchema="RDBSchema.xmi">
    tableGroup="RDBTable_1">
    
  
    primaryKey="SQLReference_1" database="RDBDatabase_1">
        group="SQLReference_1">
            xmi:id="SQLExactNumeric_1">
                href="UDBV7_primitives.xmi#SQLExactNumeric_1"/>
      
    
    
            xmi:id="SQLCharacterStringType_1" length="250">
                href="JavatoDB2UDBNT_V71TypeMaps.xmi#SQLCharacterStringType_250"/>
      
    
    
            xmi:id="SQLExactNumeric_2">
                href="UDBV7_primitives.xmi#SQLExactNumeric_1"/>
      
    
    
            xmi:id="SQLExactNumeric_3">                href="UDBV7_primitives.xmi#SQLExactNumeric_1"/>
      
    
        xmi:id="SQLReference_1"
    name="pERSONEJBpK" members="RDBColumn_1" table="RDBTable_1"
    constraint="Constraint_pERSONEJBpK"/>
        type="pRIMARYKEY" primaryKey="SQLReference_1"/>
  

    

tableGroup="RDBTable_1">
   

    

xmlns:xmi="http://www.omg.org/XMI"
xmlns:ejbrdbmapping="ejbrdbmapping.xmi" xmlns:ejb="ejb.xmi"
xmlns:RDBSchema="RDBSchema.xmi" xmlns:Mapping="Mapping.xmi"
xmi:id="EjbRdbDocumentRoot_1" outputReadOnly="false" topToBottom="true">
    xmi:id="RdbSchemaproperies_1" primitivesDocument="DB2UDBNT_V71">
        href="RdbVendorConfigurations.xmi#DB2UDBNT_V71_Config"/>
  
  
    href="META-INF/Schema/Schema.dbxmi#RDBDatabase_1"/>
  
        xmi:id="primaryTableStrategy_1">
      

    href="META-INF/ejb-jar.xml#ContainerManagedEntity_1"/>
        href="META-INF/Schema/Schema.dbxmi#RDBTable_1"/>
    
            href="META-INF/ejb-jar.xml#CMpAttribute_1"/>
            href="META-INF/Schema/Schema.dbxmi#RDBColumn_1"/>
            href="JavatoDB2UDBNT_V71TypeMaps.xmi#Integer-INTEGER"/>
    
    
            href="META-INF/ejb-jar.xml#CMpAttribute_2"/>
            href="META-INF/Schema/Schema.dbxmi#RDBColumn_2"/>
            href="JavatoDB2UDBNT_V71TypeMaps.xmi#String-VARCHAR"/>
    
    
            href="META-INF/ejb-jar.xml#CMpAttribute_3"/>
            href="META-INF/Schema/Schema.dbxmi#RDBColumn_3"/>
            href="JavatoDB2UDBNT_V71TypeMaps.xmi#int-INTEGER"/>
    
    
            href="META-INF/ejb-jar.xml#CMpAttribute_4"/>
            href="META-INF/Schema/Schema.dbxmi#RDBColumn_4"/>
            href="JavatoDB2UDBNT_V71TypeMaps.xmi#int-INTEGER"/>
    
  
    href="JavatoDB2UDBNT_V71TypeMaps.xmi#Java_to_DB2UDBNT_V71_TypeMaps"/>

    
 
      
      
要
在这篇短小的介绍性文章中全面解释这个文件，就要讲很多，但对于理解 WebSphere EJB 到 RDB 的映射工作，有几点很关键：
我的目的并不是告诉您如何从头生成这个文件，而是想说明它做什么工作，这样您就能够对这个文件（和其它我们已讨论过的文件）做一些小的更改来应对使用
WebSphere 进行 CMp 映射过程中的简单问题。
      
      
让我们从文件中下面几行代码开始：
 
      
      
  href="META-INF/ejb-jar.xml#ContainerManagedEntity_1"/>
  href="META-INF/Schema/Schema.dbxmi#RDBTable_1"/>
    

 
      
      
这里，我们得到了第一个暗示：正在发生什么事情。您可以看到，这两行代码将 
        
        ejb-jar.xml
文件中的一个特定的 EJB
引用（ContainerManagedEntity_1，它是我们先前看到的“personEJB”的标识）和模式中定义的一张特定的数据库表
（RDBTable_1，它是我们先前在模式文件中看到的 pERSONEJB
表）链接在一起。实际上，如果这是个多表映射（一些列来自两个或多个表的映射），您会看到多个  标记，每个标记都引用一个不同的模式文件和文件
        
        
        
        
          
          1
        
        中的表。这个原则同样适用于其余的文件，如下一部分指出的那样：
      
      
 
      
      

      href="META-INF/ejb-jar.xml#CMpAttribute_1"/>
      href="META-INF/Schema/Schema.dbxmi#RDBColumn_1"/>
   

    

 
      
      
在这个代码段中，您看到了 
        
        ejb-jar.xml
文件中定义的、特定的容器管理字段（CMpAttribute_1 是字段标识）与模式中定义的、特定的数据库列（RDBColumn_1 是 ID
列）之间的连接。定义了输入和输出映射后，困惑我们的最后一点是类型映射 ? 您可以看到，它将 Java
类型（Integer）映射到关系数据库类型（INTEGER）。EJB 中的所有 CMp 字段都会重复这类映射。 
      
      
如果您熟悉 VisualAge® for JavaEJB Support 中的转换器，知道使用 
        
         标记选择缺省的转换器就可以了。如果您需要一个与指定转换不同的转换（假设一个知道如何将特定的字符串“Yes”和“No”转换为布尔值的专门的转换器），您可以在这里通过 
        
         标记指定它。
      
      
      
      
下图 2 显示了这三个主要的 XML 文件与它们的成分部件之间的交互。
      
      
        
        
图 2. 元数据文件关系

        
        
      
      

      
      

回页首


简单的元数据技巧
      
      
既然您了解了这些 XML 文件的存在、结构和相互关系，问题是，您要用它们来做什么呢？首先，让我们来阐明您
        
        不应
该用它来做什么。您不应该为了执行自己的自底向上或复杂的中间相遇映射而试图创建这些文件。原因是由于这些文件本意是让 WebSphere 工具集
? VisualAge for Java 4.0，特别是 WebSphere Studio Application Developer 
        
        
          
          2
        
        ?
来生成和编辑，所以没有在 WebSphere 文档中充分说明底层模式。实际上，Application Developer
文档包含这些文件使用的 XMI 对象模型的内部表示的最好描述。如果您是一个工具构建者，想用这些信息生成自己的实体 EJB
，那么请考虑使用文档中有的 Application Developer 工具 ApI 来构建这些文件，而不要试图从 XML
反向设计一个对象模型。 
      
      
另一方面，还有一些例子，在这些例子中，直接更改 XML 可以作为更新 EJB
的最容易的方法。例如，许多企业环境建立了不同的数据库表来支持开发、测试和生产。在某些情况下，这些数据库可能在 DB2 或 Oracle
的相同实例上被托管，它们只是模式名不同（可能是 DEV.pERSONEJB、TEST.pERSONEJB 和
pROD.pERSONEJB）。您将怎样写自己的代码使其完全不依赖于环境？对于 CMp 实体 EJB，WebSphere
使这项工作变得很简单。您只需在模式标记中更改模式名称，然后将 EJB JAR 文件部署到用于三种环境的不同 WebSphere
实例。例如，对于 DEV，您的标记可能看起来是这样的：
 
      
      
name="DEV" tableGroup="RDBTable_1">
    

 
      
      
而对于 pROD，您的标记可能看起来是这样的：
 
      
      
name="pROD" tableGroup="RDBTable_1">
    

 
      
      
关
于这个简单的替代方法的很不错的一点是您可以使用工具（如 AWK、SED 或者甚至 ANT）使其自动化，这些工具也可以用于调用适当的
WebSphere 命令行工具（ 高级单服务器版上的 SEAppInstall 或高级版上的 WSCp）来生成部署代码和安装结果应用程序。
      
      
在这种情况下，您将从一个未部署的 EJB JAR 文件开始，将它一次部署好，然后将上面描述的元数据文件复制回您的工程的构建树，这样它们就变成了未部署 JAR 文件的一部分。当您部署 JAR 时，WebSphere 适当地选择一些元数据文件并生成部署代码。
      
      
您可以执行的另一个简单更改是当 EJB 定义或数据库模式发生更改时更新 XML 来执行最小的中间相遇映射。例如，假设您后来决定在工程中将 educationLevel CMp 字段的名称更改为 edLevel。您只需更新 
        
        ejb-jar.xml 文件来更改字段，如下所示：
      
      
 
      
      

   edLevel>/field-name>

    

 
      
      
请保持 id 不变，因为（就象我们先前看到的）这个id 实际上是用于将 CMp 字段映射到模式中相应的列。您可以想象得到，数据库中相应的更改将保持 
        
        ejb-jar.xml 不变，同时适当地更新 
        
        schema.dbxmi 文件。再次说明，不管在哪种情况下，编辑过 XML 后都要重新部署 EJB jar 文件。
      
      
      
      

回页首


总结
      
      
本
文已经研究了在 WebSphere 4.0 和 Application Developer 中映射到关系数据库的 CMp EJB
的一些隐藏的部分。它稍微描述了一下
ejb-jar、模式和映射文件如何进行互操作，以及操作这些文件的工具如何发挥作用。这些信息有助于您更好地使用用于 CMp 的
WebSphere 工具，并有助于规划出用来处理涉及到 CMp 的自动配置和部署问题的最好方法。本文的 第 2 部分将研究这些文件的其它一些功能，比如关联、继承、转换器和编写器，还要研究 ejb-jar 扩展文件，这种扩展文件在 CMp EJB 的定制查找程序方法中被使用。
      
      
        
    
    
    

        

            

                [转载]WebSphere 4.0 中的 EJB 元数据: 第 2 部分：关联            
            

                [转载]最佳实践: 向 WebSphere Application Server 的 EJB 环境迁移            
        
    


		





    

        
分享到
        

        

            
新浪微博

            
 QQ空间
        
        
  请使用浏览器的分享功能分享到微信等