这篇文章，我将重点放在专为企业级java orm应用设计的自动框架上。下一节，我将提到几个流行的orm框架和ejb 3.0中几个关键的革新。

      orm 框架

      ejb 实体bean是java ee中“官方”的orm解决方案。但是，在ejb1.x和2.x中，实体bean的难以使用是出了名的，原因如下：

      ●ejb 1.x和2.x实体bean必须遵守一种严格的组件模型。每一个bean类必须实现一个home接口和一个商业接口。它们必须从某种抽象类中继承，而且必须实现其所有方法，即使它们多数为空。这样的一种严格组件模型使得想从ejb 1.x和2.x的实体bean中构建面向对象的数据模型几乎变得不可能了。
      ●ejb 1.x和2.x容器需要特别冗长的xml配置文件来建立实体bean与关系型数据库中的表映射。那些文件是非常单调乏味和容易出错的。

      简而言之，ejb 1.x和2.x实体bean是一个设计拙劣的orm框架。它既没有满足java数据对象模型的需求，也没有满足关系表数据模型的需求。出于对ejb 1.x和2.x实体bean的不满，开发者开始寻找其它的orm方案。实际使用中，开源的hibernate(jboss开发)和oracle公司的toplink是最成功的两个pojo orm框架。hibernate和toplink都是基于pojo的。它们不依赖于任何预定义的组件模型。作为替代，它们使用pojo数据对象(简单的javabean式的)，自动地解读出如何映射它们，以及它们之间的关系（关系型数据库）。通常，javabean类映射到一张数据库表，并根据数据库表中的外键映射出类之间的关系。你可以在一个简单直接的xml配置文件中指明orm的配置信息，比如javabean类对应的表名和属性对应的列名。你可以通过框架中的工具（如：hibernate中的session类）来对那些pojo进行操作(如：存储、获取和查找)。

      ejb 3.0是建立在hibernate和toplink的思想和成功之上。它为java ee提供了一个标准的pojo orm框架。另外，ejb 3.0有两个超越现今所有持久化解决方案的关键革新：

      ●没有使用xml文件来指明orm配置信息, ejb 3.0允许开发者直接在pojo代码中注释出映射信息。举例来说，你可以用注释来指明每个javabean属性对应的关系型表列。在这篇文章的后面，你将看到更多的例子。注释使得映射更直接，更容易维护了。
      ●ejb 3.0为实体bean定义了一个新的归档格式。每个档案使用一组独立的，为后端数据库和orm行为所专用的配置集来定义一个持久化上下文。在这篇文章的后面，我会讨论持久化上下文。

      现在，让我们通过几个简单的例子来看一下ejb 3.0是如何完成pojo orm的。

      映射一个简单的对象

      在ejb 3.0中，每个实体bean都是一个简单的javabean式的类。为了告诉ejb 3.0容器这个类应该为持久化进行映射，你应该用@entity来注释这个类。

      每一个实体bean类映射到一个关系型数据库表。默认地，表名对应类名。你可以用@table来为类指定另一个表。每一个javabean属性映射到表的列上，同样的，默认列名就是属性名。你可以用@column注释在属性的setter方法上来改变这种默认关系。下面是一个ejb 3.0的简单例子：

@entity
// @table (name="alternativetablename")
public class person implements serializable {
 
  protected int id;
  protected string name;
  protected date dateofbirth;
 
  public void setid (int id) {
    this.id = id;
  }
 
  @id(generate = generatortype.auto)
  public int getid () {
    return id;
  }
 
  public void setname (string name) {
    this.name = name;
  }
 
  // @column (name="alternativecolumnname")
  public string getname () {
    return name;
  }
 
  public void setdateofbirth (date dateofbirth) {
    this.dateofbirth = dateofbirth;
  }
 
  public date getdateofbirth () {
    return dateofbirth;
  }
}

      当容器把person类映射到person sql数据库表以后，每一个person实例就是表中的一条数据记录。

      映射一个简单的javabean类是容易的。但自动orm框架真正闪光之处在于映射互相关联的对象。下一节中，我们看一下ejb 3.0如何操作对象间的关系。

      关系

      在一个数据模型里面，一般来说类相互之间都会有某种联系。比如，一个person(个人)对象可以和一个resume(确认)对象相关联，反过来也一样（一对一关系）；一个person对象可以和多个creditcard(信用卡)对象相关，而一个creditcard对象只能和一个person对象相关（一对多关系）。多个person对象可以和一个address(地址)对象相关，而一个person对象只能对应一个address对象（多对一关系）。(译者注：此处原著笔误, person与address位置颠倒了；编者注：我看两者是多对多的关系。一家人住在同一个地方，这个地址对于这一家人来说是一对多的关系；房主在别的地方又买了一套房，房主与地址的关系是一对多的关系。)

     在一个数据模型中，对象指针用来操作那些关系。举例来说，一个person对象可以有一个属性（也就是域）指向一个resume对象。而另一个属性是creditcard对象的集合。为了告知ejb 3.0容器对象间的关系，你只需简单地在pojo中注释javabean属性。

@entity
public class person implements serializable {

  // ... ...
  protected resume resume;
  protected creditcard [] cards;
  protected address addr;
 
  // ... ...
   
  @onetoone
  public resume getresume () {
    return resume;
  }
 
  // ... ...
 
  @manytoone
  // @joincolumn (name="mycustomid")
  public address getaddr () {
    return addr;
  }
 
  // ... ...
 
  @onetomany
  public collection <creditcard> getcards () {
    return cards;
  }
}

      在关系型数据库中，那些关系自动地被ejb 3.0容器使用外键来重建了。举例来说，person表有一个外键包含了resume表中相应的主键。运行时，ejb 3.0容器加强了一对一的关系：它保证了resume键值对于person表中的每一行是唯一的。为了启用resume表到person表的双向查询，你可以resume表中定义一个person属性，并把它也加上@onetoone注释。

      person表中也有一个外键包含了address表中相应行的主键。这种情况下，相同的address主键可以出现在多个person行中，这是多对一关系。对于一对多的关系，映射稍有一点复杂，因为外键列是定义在多对一表中的。于是，在creditcard类中，你必须用@manytoone来定义一个person属性。
改变外部键字段名

      orm中使用的外部键字段的名字是由容器自动决定的或者由@joincolumn注释来显式的指定。

      上面讨论的关系只是实体bean之间关系的一种类型，实体类之间另外一种重要关系是继承。

      继承

      面向对象设计方法的一个关键概念是继承。使用继承，你可以创建一个复杂的对象树而不需要重复的代码。举例来说，consultant(顾问)是提供有偿服务的一个人，那么在我们的数据模型中，consultant类就从person(个人)类中继承，并增加了一个价格属性。不幸的是，当今的关系型数据库并不存在继承的概念。orm框架主要通过以下两个手段来模仿这种行为：

      ●框架可以为每一个类生成一个单独的表。子类的表重复了那些从父类的字段。子类和父类都存储为各自对应的表。
      ●框架可以使用包含了所有子类属性的表。两种类(父类和子类)的实例都存储于同一张表―父类中不存在的字段(也就是，子类的字段)取null值。为了使继承映射更为强壮，表也可以有一个“区别”列，它存储的标记表明该行数据映射到哪一个类。

      ejb 3.0实体bean支持上述两种映射策略，默认是单表映射策略。你可以简单地用注释指明子类的继承策略和区别字段的名字。下面是consultant类的例子，它从person类中继承：

@entity
@inheritance(discriminatorvalue="c")
@discriminatorcolumn(name="person_type")
public class consultant extends person {

  protected double rate;
 
  public void setrate (double rate) {
    this.rate = rate;
  }
 
  public double getrate () {
    return rate;
  }
}

      从上面的例子中，容器使用默认策略将consultant类映射到person类对应的同一张表中。如果表中的person_type字段的值为c,那么那一行数据就代表了一个顾问类。否则，当前行代表的是一个普通的person类。

      持久化档案

      现在你的数据模型有了一组使用了注释ejb 3.0实体bean的类，你可以将它们捆绑在一起布署到服务器环境中。ejb 3.0为实体bean定义了一种特殊的归档格式，叫做持久化档案(文件后缀名为.par)。

      一个.par文件是一组实体bean类文件加上一个简单的配置文件meta-inf/persistence.xml的jar打包文件。persistence.xml文件定义了持久化上下文，它告知ejb 3.0哪一个后端数据库(数据源)与这一组实体bean相对应。persistence.xml也包含了配置属性的细节。举例来说，jboss ejb 3.0是在hibernate 3.0之上实现的，于是你可以通过persistence.xml传递任意的hibernate配置选项。这有一个范例persistence.xml文件，它包含了jboss和hibernate专用的配置属性，包括sql 方言(dialect)和二级缓存。

<entity-manager>
  <name>cal</name>
  <jta-data-source>java:/defaultds</jta-data-source>
  <properties>
    <property name="hibernate.dialect" 
            value="org.hibernate.dialect.mysqldialect" />
    <property name="hibernate.cache.provider_class"
            value="org.jboss.ejb3.entity.treecacheproviderhook"/>
    <property name="hibernate.treecache.mbean.object_name"
            value="jboss.cache:service=ejb3entitytreecache"/>
  </properties>
</entity-manager>

      实体管理器

      一旦你部署了实体bean, 你必须通过ejb 3.0的实体管理器的api来访问和操作它们。ejb 3.0容器为每个部署的持久化上下文(也就是，.par文件)提供了一个实体管理器对象。从一个ejb 3.0 session bean pojo(参看第一部分)中 ，你可以通过@persistencecontext注释将实体管理器对象注入，并传入上下文的名字。

@stateless
public class managerbean implements manager {

  @persistencecontext (unitname="cal")
  protected entitymanager em;
 
  // use "em"
// 使用“em”
  // ... ...
}

      基本操作

      要创建一个数据对象并把它存入数据库中，你只需简单地使用java的new关键字来创建pojo，并把它传给entitymanager.persist()方法。

person p = new person ();
p.setname ("a new baby");
p.setdateofbirth (new date ());
em.persist (p);

      要从数据库中取得对象，你可以使用ejb 3.0查询语言来搜索数据库。下面的例子演示了如何将person表中的所有行作为person java对象的集合来返回。
// 得到所有人的对象

collection <person> persons = (collection <person>)
    em.createquery("from person p").getresultlist();

      可管理的pojo

      通过实体管理器保存和获取的对象是被管理在持久化上下文中的。这意味着如果对象后来被改变了，那这种改变将会被自动检测并持久化到数据库中。在下面的例子中，我们更新了一个可管理的pojo的一个属性。这个改变会被ejb 3.0容 器自动检测到并发送给了数据。

person p = em.find(person.class, personid);
p.setname ("another name");

//p会在当前事务结束时被自动地更新到数据库中去。
// 并没用更多的api调用

      既然ejb 3.0实体仅只是pojo,那么它们就可以能够被序列化并通过网络传递。如果一个对象不是被容器创建的(也就是说，它是从网络连接中传递过来的或者是某一个远程调用返回的结果)，那么持久化上下文并不会管理它。不过，你可以通过调用entitymanager.merge()方法将一个非管理的pojo合并到持久化上下文中。下面是将一个解序列化的pojo合并入当前持久化上下文中的例子。

inputstream in;
// 初始化输入流
person p = util.deserialize (in);

// ... ...
em.merge (p);

// p现在是一个可管理的对象了。p的任何改变将会被自动检测并持久化
p.setname ("another name");

      数据库同步

      当实体管理器对象在一个session bean中使用时，它是和服务器的事务上下文绑定的。实体管理器在服务器的事务提交时提交并且同步它的内容。在一个session bean中，服务器的事务默认地会在调用堆栈的最后提交。当然，你也可以通过注释来为每个商务方法指定具体的事务属性。下面的例子展示了如何为一个session bean的方法声明一个新的事务。

@transactionattribute(transactionattributetype.requiresnew)
public void update () {

// 这个方法更新person对象
// 更新将会在这个方法的末尾被提交和刷新到数据库中

      批处理中刷新数据库操作

      为了只在当事务提交时才将改变更新到数据库中，容器将所有数据库操作集中到一个批处理中，这样就减少了代价昂贵的与数据库的交互。

      如果你需要在事务提交之前将更新刷新到数据库中，你可以直接地调用entitymanager.flush()方法。或者你可以将一个方法注释为@flushmode(flushmodetype.never),于是事务管理器将不会在方法的结尾(也就是事务的结尾)处刷新更新到数据库中。这种情况下，你可以手工地来刷新数据库以获得对数据库操作的最大控制。

      总结

      ejb 3.0 提供了一种简单有效的框架将java pojo映射到sql数据库中的关系型表中。它基于java类中的名字和结构进行智能的默认映射策略。但你也可以用一组简单的注释重载所有的默认值，来处理复杂的对象关系。