kodo是bea公司收购solarmetric公司后获得的持久层框架项目，以前只是支持jdo标准，2006年2月13日，bea公司宣布发布kodo项目的最新版本--kodo 4.0.0 early access 4，kodo 4.0.0 ea4支持ejb3和jdo2两个标准，本文中，我们将首先学习和了解kodo ejb，了解如何使用kodo ejb完成开发工作。

　　我们将按照两种不同的情况讲述如何使用kodo ejb进行开发，一种是通过命令行工具，另外一种是在eclipse中使用ant任务。

　　关于ejb3和jdo2的更多内容请大家查看文章最后参考资源中的相关内容。

　　为什么使用kodo ejb

　　在kodo ejb框架中，对象和关系数据库之间的映射（对象-表，对象属性-字段等）都是使用jdk5.0中的最新特性―注释（annotation）来提供，不再需要提供额外的配置文件。

　　根据ejb3规范的要求，kodo ejb除了支持在ejb容器中使用满足重量级企业应用的需求之外，也支持在普通java应用中采用，提供轻量级的持久层框架。只不过当我们在ejb容器中使用kodo ejb时我们需要更多的工作以便满足ejb容器的要求。

　　下载、安装kodo

　　准备工作

　　由于kodo是基于注释机制的框架，我们必须使用jdk5.0完成开发工作。所以下载、安装kodo之前，请确保您已经下载和安装了jdk5.0。

　　为了演示的需要，我们选择mysql数据库作为持久化的目标数据库，请大家自己到www.mysql.com下载最新的mysql数据库后安装。

　　下载、安装kodo

　　kodo的最新版本是kodo 4.0.0 early access 4，目前大家可以到http://www.solarmetric.com/去下载试用版本，下载时需要注册，你会得到30天的license。

　　将下载的压缩文件解压到c:/kodo4目录下(后面将使用%kodo_home%来引用这个目录)，打开%kodo_home%/bin/kodocmd.cmd文件，将其中的kododir设置为您的kodo的安装目录，将jdkhome设置为java的安装目录。

　　kodo ejb实例

　　上面的工作完成以后，我们就可以开发kodo ejb应用了，下面的例子将主要讲述如何开发一个轻量级的kodo ejb例子，支持在java应用中的调用，而不依赖于ejb容器，关于如何在ejb容器中配置使用kodo ejb是一个大的课题，作者将另外撰文详细论述。

　　下面我们将用一个简单的例子来说明创建kodo ejb应用的典型步骤，实例中我们将创建名为book的持久化对象，该对象将被持久化到本地的mysql数据库中。

　　请大家注意的是，下面的说明都基于windows 2000操作系统，如果您使用其它操作系统，可能需要做出相应的变更。

1. 建立工程目录

   　　在c:盘根目下创建名为kodoexamples的目录，我们所有的类文件和配置都放在这个目录下。

2. 创建持久化类
   
   　　新创建持久化类book，为了说明的简单，该类只有两个属性:id和name，其中id是书的编号（编号由mysql数据库自动生成），name属性表示书的名称。持久化类的全部代码、注释和说明如下：

   ackage org.vivianj.kodo.examples.beans; import javax.persistence.basic; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.generationtype; import javax.persistence.id; import javax.persistence.inheritance; import javax.persistence.inheritancetype; import javax.persistence.table; /**  * book 用于表征系统中的书籍对象，他有两个属性id - 书籍编号，书籍编号将由mysql数据库自动生成name - 书名 */ /* entity注释表示该类是持久化类，的name属性是该实体在查询中对应的唯一名称，默认是类名 */ (name = "book") /* table注释的name属性指定该持久化类对应的数据表的名称，默认数据表名和类名保持一致，为了增强代码的可移植性，建议大家在name属性中使用大写英文字母 */ (name = "books") /* inheritance注释的strategy确定了持久化对象和数据表之间的关系，可选择项包括single_table、joined和table_per_class，我们这里采用table_per_class */ (strategy = inheritancetype.table_per_class) public class book {  /* id注释表示该字段是标识字段 */    /* generatedvalue注释定义了该标识字段的产生方式，我们的演示系统中id由mysql数据库字段自动生成，因此选择generationtype.identity */  (strategy = generationtype.identity)  /* column注释的name属性定义了该类属性对应的数据字段的名称，为了最大限度保持系统和数据库之前的独立性，建议使用大写字符 */  (name = "id")  public int id;  /* basic注释表示该属性是基本属性 */    /* column注释的name属性定义了该类属性对应的数据字段的名称，为了最大限度保持系统和数据库之前的独立性，建议使用大写字符 */  (name = "name")  public string name = null; 

3. 准备数据库

   　　在mysql数据库中新建名为kodo的数据库。

4. 准备配置文件

   　　在c:kodoexamples新建meta-inf目录，随后在该目录下新建kodo.xml和persistence.xml文件。

   a) kodo.xml文件中提供访问数据库所需要的细节信息、使用kodo所需要的授权(license)内容、kodo运行时的日志管理等。 ＜?xml version="1.0"?＞ ＜persistence＞  ＜persistence-unit name=""＞   ＜properties＞    ＜!-- kodo的序列号，请输入您下载或者购买kodo时得到的license --＞    ＜property name="kodo.licensekey"     value="093d-bf3f-c10e-0f8f-0f00" /＞    ＜!-- 以下是访问数据库时需要提供的信息 --＞    ＜property name="kodo.connectionurl"     value="jdbc:mysql://localhost/kodo" /＞    ＜property name="kodo.connectiondrivername"     value="org.gjt.mm.mysql.driver" /＞    ＜property name="kodo.connectionusername" value="root" /＞    ＜property name="kodo.connectionpassword" value="root" /＞ ＜!-- 设置kodo运行过程中的日志级别 --＞    ＜property name="kodo.log"     value="defaultlevel=warn, runtime=info, tool=debug" /＞   ＜/properties＞  ＜/persistence-unit＞ ＜/persistence＞ b) persistence.xml提供ejb实体管理所需要的信息，比如确定使用哪种持久化管理器和需要被管理的持久化类。 ＜?xml version="1.0"?＞ ＜persistence＞  ＜persistence-unit name=""＞   ＜provider＞kodo.persistence.persistenceproviderimpl＜/provider＞   ＜!-- 需要被kodo ejb管理的持久化类 --＞   ＜class＞org.vivianj.kodo.examples.beans.book＜/class＞  ＜/persistence-unit＞ ＜/persistence＞

5. 编译持久化类

   　　打开一个命令行窗口，进入%kodo_home%/bin目录下，执行kodocmd.cmd命令，然后将mysql的驱动文件使用set classpath=%classpath%;c:/mysql-connector-java-3.1.8-bin.jar这样的方式加入到classpath中。

   　　执行javac c:kodoexamplesorgvivianjkodoxampleseans*.java编译持久化类。

6. 加强（enhancer）持久化类

   　　kodo中使用加强工具(enhancer)对持久化类进行调整，支持性能优化、懒惰式装载等特性。

   　　我们可以使用kodoc c:kodoexamplesorgvivianjkodoxampleseans*.java这样的命令来完成持久化类的加强工作。

7. 生成数据库表

   　　kodo中提供了专门的mappingtool工具，能够自动的根据持久化类及他们之间的关系为我们生成创建数据库所需要的sql语句或者直接创建数据表。

   　　演示实例中，我们使用kodoc c:kodoexamplesorgvivianjkodoxampleseans*.java完成数据表的创建，命令执行完成后，我们访问mysql中的kodo数据库，可以看到里面已经创建了名为books的数据表。

8. 测试一下

　　现在，所有的工作都已经完成，我们可以编写一段代码测试一下上面的工作是否有效，在c:kodoexamples目录下新建test.java，然后输入如下内容：

import javax.persistence.entitymanager; import javax.persistence.entitymanagerfactory; import javax.persistence.persistence; import javax.persistence.persistencecontexttype; import org.vivianj.kodo.examples.beans.book; public class test {  public static void main(string[] args) {   /* 获得ejb的实体管理器 */   entitymanagerfactory emf = persistence.createentitymanagerfactory(null);   entitymanager em = emf     .createentitymanager(persistencecontexttype.extended);   /* 开始事务 */   em.gettransaction().begin();      /* 创建新的持久化对象 */   book book = new book();   /* 设置book对象的name属性 */   book.name = "kodo入门";   /* 持久化对象 */   em.persist(book);   /* 结束事务 */   em.gettransaction().commit();   em.close();   emf.close();  } } 

　　执行test类，执行完后会发现books表中已经增加了一条新的记录。

　　在eclipse中开发kodo ejb

　　上面的步骤都是基于命令行的，操作起来不是很方便，因此我们需要考虑将kodo的开发过程和eclipse开发工具进行集成。

　　分析上面开发kodo ejb的整个过程，只有步骤 5)加强（enhancer）持久化类和 6）生成数据表和字段无法在eclipse中直接实现，查看kodo的帮助文档，发现kodo的发布包中已经提供了对应命令的ant任务脚本，因此我们可以使用ant来完成eclipse和kodo的集成。

　　我们仍然使用上面的例子来演示如何在eclipse中开发kodo ejb，我们打开eclipse，新建立kodoexamples工程，将%kodo_home%ib下面所有jar文件加入到该工程的引用中，将您所使用的数据库的jdbc驱动jar文件也加入到该工程的引用中。然后请大家参考上面的说明完成前5步工作，下面我们主要描述如何完成ant配置文件。

1. 基本配置内容

   　　在工程的当前目录下，新建build.xml文件，输入如下内容：

   ＜project name="kodo enhance" basedir="." default="enhance"＞ ＜!― 请将value的值设置为您安装kodo时选择的目录 --＞  ＜property name="kodo_home" value="c:kodo4" /＞  ＜property name="src" value="." /＞  ＜property name="classes" value="." /＞  ＜!--  准备公用的classpath路径 ?  ＜path id="build_classpath"＞   ＜pathelement location="" /＞   ＜pathelement location="" /＞   ＜!―此处请输入数据库驱动文件的路径，作者使用的mysql数据库驱动 ?   ＜pathelement location="c:/ mysql-connector-java-3.1.8-bin.jar" /＞   ＜fileset dir="/lib"＞    ＜include name="**/*.jar" /＞   ＜/fileset＞  ＜/path＞  ＜/project＞ 

2. 编写完成步骤 6)加强(enhance)持久化类所需要的任务

   　　和这个步骤对应的任务是kodo.ant.pcenhancertask类，在%kodo_home%srckodont下面我们可以看到pcenhancertask类的源代码。首先使用taskdef加入新的任务类型kodoc，然后调用该任务完成工作。

   　　在build.xml文件中增加如下内容：

   ＜target name="enhance"＞   ＜!--  引入新的ant任务 ?   ＜taskdef name="kodoc" classname="kodo.ant.pcenhancertask"＞    ＜!--  引用上面步骤中定义的build_classpath作为classpath ?    ＜classpath refid="build_classpath" /＞   ＜/taskdef＞      ＜kodoc jdoenhance="true"＞    ＜fileset dir="."＞     ＜!--  指定需要被加强的持久化类，可以使用通配符* ?     ＜include name="**/book.java" /＞    ＜/fileset＞    ＜!--  引用上面步骤中定义的build_classpath作为classpath ?    ＜classpath refid="build_classpath" /＞   ＜/kodoc＞  ＜/target＞ 

3. 编写完成步骤 7)生成数据库表所需要的任务

　　kodo包中为这个任务提供的任务类kodo.jdbc.ant.mappingtooltask在eclipse中执行时有点问题，我将它修改了一下，主要是修改执行该任务时使用的classloader，现在可以满足要求了。

　　在当前工程中新建kodo.jdbc.ant.mappingtooltask类（目录中的类比lib文件中的类有更高的执行级别），类的代码可以在%kodo_home%/src/kodo/jdbc/ant目录下找到。在类源代码中找到这两行。

if (!mappingtool.run (conf, files, flags, loader)) throw new buildexception (_loc.get ("bad-conf", "mappingtooltask")); 将它修改为： if (!mappingtool.run (conf, files, flags, mappingtool.class.getclassloader ()))    throw new buildexception (_loc.get ("bad-conf", "mappingtooltask"));    现在，我们在build.xml文件中增加如下内容就可以完成项目中生成持久化类对应的数据库表了：  ＜target name="create-schema"＞   ＜!--  引入新的ant任务 ?   ＜taskdef name="mappingtool" classname="kodo.jdbc.ant.mappingtooltask"＞    ＜!--  引用上面步骤中定义的build_classpath作为classpath ?    ＜classpath refid="build_classpath" /＞   ＜/taskdef＞   ＜mappingtool action="refresh"＞    ＜!--  引用上面步骤中定义的build_classpath作为classpath ?    ＜classpath refid="build_classpath" /＞    ＜fileset dir=""＞     ＜!--  指定需要生成数据表的持久化类，可以使用通配符* ?     ＜include name="**/book.java" /＞    ＜/fileset＞   ＜/mappingtool＞  ＜/target＞ 

　　现在你可以将打开eclipse中的ant视图，然后再其中执行enhance和create-schema任务，完成加强持久化类和创建数据库表的工作，最后，你可以使用同样的测试代码完成代码的测试工作。

　　总结

　　kodo是bea最新发布的持久层框架，屏蔽了开发者访问数据库的众多细节，为开发者提供了更加简单的编程模式，大大较少了开发量，目前kodo支持ejb3和jdo2标准。bea承诺在不久的将来将kodo的核心代码开源。

　　本文中，作者通过一个简单的例子，详细地讲解了如何完成kodo ejb的开发工作，同时讲解了如何在eclipse中集成kodo完成开发的步骤，并且解决了集成过程中还存在的一个小问题，希望能够帮助大家更好的学习和使用kodo.