EasyDBO配置文件easyjf-dbo.xml简介

EasyDBO是通过配置文件来配置相关数据源等，只有为EasyDBO提供正确的配置信息。EasyDBO才能正常工作，EasyDBO的配置信息写在easyjf-dbo.XML文件中，其发布到Web应用程序中的时候处于web-infclasses目录下面。只有存放位置正确、内容正确的easyjf-dbo.xml配置信息，才能体验EasyDBO简易、实用的对象关系映射系统(ORM)功能。

一、easyjf-dbo.xml文件的内容

首先我们看一下EasyDBO_0.4.1版本中的一个完整的配置文件，下面是EasyDBO_0.4.1源码中的easyjf-dbo.xml文件的全部内容，我们的测试数据库为本机(即127.0.0.1或localhost)的数据库，数据库名为easyjf，密码为easyjf，用户名为root。

easyjf-dbo.xml文件的全部内容：

<?xml version="1.0" encoding="utf-8"?>

<easyjf-dbo>

<property name="easydbo.connection.driver_class">com.microsoft.jdbc.sqlserver.SQLServerDriver</property>

<property name="easydbo.connection.passWord">easyjf</property>

<property name="easydbo.connection.url">jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=easyjf;SelectMethod=cursor</property>

<property name="easydbo.dialect">com.easyjf.dbo.sql.MSSQLServerQuery</property>

<!--

<property name="easydbo.connection.driver_class">org.gjt.mm.mysql.Driver</property>

<property name="easydbo.connection.password">easyjf</property>

<property name="easydbo.connection.url">jdbc:mysql://127.0.0.1:3306/easyjf</property>

<property name="easydbo.dialect">com.easyjf.dbo.sql.MySqlQuery</property>

-->

</datasource>

</id>

</property>

</property>

</property>

</property>

</property>

</class>

</tables>

</easyjf-dbo>

二、EasyDBO中数据源的配置说明

接下来，我们重点看看有关数据源datasource的说明。

数据源是EasyDBO执行数据库操作的时候，必须使用到的JDBC数据源。

EasyDBO考虑到项目中有时候需要连接几个不同的数据库的情况，因此一个数据库定义为一个datasource，每一个datasource有一个名字name，同时有一个表示数据源类型的type，默认的情况下都是使用的第一个datasource作为缺省数据源。而使用apache的数据库连接池dbcp.BasicDataSource作为默认连接池。

这一行在我们当前提供的所有示例中都可以不用修改。

下面来看datasource中的各property节点的配置说明：

<property name="easydbo.connection.driver_class">表示JDBC数据库驱动类，com.microsoft.jdbc.sqlserver.SQLServerDriver或者net.sourceforge.jtds.jdbc.Driver，而My SQL的驱动为：org.gjt.mm.mysql.Driver。

<property name="easydbo.connection.url">表示数据源的具体的访问地址，每一种驱动对应的写法不同，请参照相应的预支说明。如MS SQL的jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=easyjf;SelectMethod=cursor，或者用jtds作驱动的时候jdbc:jtds:sqlserver://127.0.0.1:1433;DatabaseName=easyjf;SelectMethod=cursor，My SQL对应的URL写法为：jdbc:mysql://127.0.0.1:3306/easyjf

<property name="easydbo.connection.username">节点表示数据库的访问用户名

<property name="easydbo.connection.password">节点表示数据库访问密码

上面四个属性都是jdbc连接数据库共同所需的，由各个驱动程序共同规范的。

<property name="easydbo.dialect">节点表示EasyDBO的数据库方言，这个是EasyDBO专用的。当前提供的三种方言，可以支持4种数据库类型。其中com.easyjf.dbo.sql.MSSqlServerQuery为MS SQL及Access皆可使用；而com.easyjf.dbo.sql.MySqlQuery适合My SQL使用;com.easyjf.dbo.sql.OracleQuery适合Oracle数据库使用。

<property name="easydbo.optimize">节点表示是否需要进行数据优化，这个可以随便设置。

<property name="esyydbo.show_sql">节点表示是否需要在日志中输出具体的SQL语句，若为true则会输出SQL语句，若为false则不输出。输出sql语句对于调试、观察程序的运行比较有用。正式发布的程序的时候为了提高效率，可以设置成为false。

使用JNDI方式获取数据源

很多时候，我们的数据源是存放在容器中的，如Weblogic，这时一般是通过JNDI的方式获得数据源，而数据源治理则交给具体的容器负责。若要通过使用JNDI方式获取数据源，则上面的<property name="easydbo.connection.driver_class">，<property name="easydbo.connection.url">两个属性不需要设置，而是通过<property name="easydbo.connection.jndiFactory">，<property name="easydbo.connection.jndi">两个属性来设置。

三、easyjf-dbo.xml文件中的其它设置

在easyjf-dbo.xml文件中，除了配置数据源以外，还可以配置具体的对象关系表映射，其中<tables><class>这一部分就是供大家直接通过配置文件的方式配置对象关系映射的，由于我们当前示例都是直接使用实现IObject接口方式写的PO，因此只有example中的TestMessage.Java演示了通过配置文件方式实现对象关系映射，这一部分的内容我们将会在以后重点讲述。

四、关于cache的配置

在easyjf-dbo.xml文件中，有<cache>这个节点，以后可通过他来配置数据库的缓存。当前的缓存是通过easyjf-cache.xml文件来配置的。

easyjf-cache.xml文件的全部内容如下：

<?xml version="1.0" encoding="utf-8"?>

<easyjf-cache>

</easyjf-cache>

若要使用cache功能，则在与easyjf-dbo.xml文件所在的目录中建一个easyjf-cache.xml文件，内容如上即可。

关于cache，我们会在以后作具体的介绍。