EasyDBO配置文件easyjf-dbo.xml簡(jiǎn)介

2019-11-18 13:56:56

字體：大中小

供稿：網(wǎng)友

EasyDBO是通過(guò)配置文件來(lái)配置相關(guān)數(shù)據(jù)源等，只有為EasyDBO提供正確的配置信息。EasyDBO才能正常工作，EasyDBO的配置信息寫(xiě)在easyjf-dbo.xml文件中，其發(fā)布到Web應(yīng)用程序中的時(shí)候處于web-infclasses目錄下面。只有存放位置正確、內(nèi)容正確的easyjf-dbo.xml配置信息，才能體驗(yàn)EasyDBO簡(jiǎn)易、實(shí)用的對(duì)象關(guān)系映射系統(tǒng)(ORM)功能。

一、easyjf-dbo.xml文件的內(nèi)容

　  首先我們看一下EasyDBO_0.4.1版本中的一個(gè)完整的配置文件，下面是EasyDBO_0.4.1源碼中的easyjf-dbo.xml文件的全部?jī)?nèi)容，我們的測(cè)試數(shù)據(jù)庫(kù)為本機(jī)(即127.0.0.1或localhost)的數(shù)據(jù)庫(kù)，數(shù)據(jù)庫(kù)名為easyjf，密碼為easyjf，用戶(hù)名為root。

easyjf-dbo.xml文件的全部?jī)?nèi)容：
<?xml version="1.0" encoding="utf-8"?>
<easyjf-dbo>
<datasource name="bbs" type="org.apache.commons.dbcp.BasicDataSource">

<<property name="easydbo.connection.pass Word">easyjf</property>
<property name="easydbo.connection.url">jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=easyjf;SelectMethod=cursor</property>
<property name="easydbo.connection.username">root</property>
<property name="easydbo.dialect">com.easyjf.dbo.sql.MSSQLServerQuery</property>






<property name="easydbo.optimize">true</property>
<property name="esyydbo.show_sql">true</property>
</datasource>
<tables>
<class name="com.easyjf.dbo.example.TestMessage" table="Message" schema="dbo" catalog="test">
        <id name="cid" type="string">
        <column name="cid" length="16" not-null="true" />
        <generator class="com.easyjf.dbo.RandomIdGenerator" />
        </id>
        <property name="title" type="string">
            <column name="title" length="50" not-null="true" />
        </property>
        <property name="content1" type="string">
            <column name="content"  />
        </property>
        <property name="status" type="integer">
            <column name="status" length=""  />
        </property>
        <property name="inputUser" type="string">
            <column name="inputUser" length="23" />
        </property>
        <property name="inputTime" type="date">
            <column name="inputTime" length="8" />
        </property>
    </class>
</tables>
<cache name="EasyDBO" storePolicy="LRU" maxElements="1000"  eXPiredInterval="1000" type="com.easyjf.cache.EasyCache" />
</easyjf-dbo>

二、EasyDBO中數(shù)據(jù)源的配置說(shuō)明

  　　接下來(lái)，我們重點(diǎn)看看有關(guān)數(shù)據(jù)源datasource的說(shuō)明。

  　　數(shù)據(jù)源是EasyDBO執(zhí)行數(shù)據(jù)庫(kù)操作的時(shí)候，必須使用到的JDBC數(shù)據(jù)源。

　　 <datasource name="bbs" type="org.apache.commons.dbcp.BasicDataSource">

　　 EasyDBO考慮到項(xiàng)目中有時(shí)候需要連接幾個(gè)不同的數(shù)據(jù)庫(kù)的情況，因此一個(gè)數(shù)據(jù)庫(kù)定義為一個(gè)datasource，每一個(gè)datasource有一個(gè)名字name，同時(shí)有一個(gè)表示數(shù)據(jù)源類(lèi)型的type，默認(rèn)的情況下都是使用的第一個(gè)datasource作為缺省數(shù)據(jù)源。而使用apache的數(shù)據(jù)庫(kù)連接池dbcp.BasicDataSource作為默認(rèn)連接池。
  這一行在我們當(dāng)前提供的所有示例中都可以不用修改。

  　　下面來(lái)看datasource中的各property節(jié)點(diǎn)的配置說(shuō)明：

　　 <property name="easydbo.connection.driver_class">表示JDBC數(shù)據(jù)庫(kù)驅(qū)動(dòng)類(lèi)，com.microsoft.jdbc.sqlserver.SQLServerDriver或者net.sourceforge.jtds.jdbc.Driver，而My SQL的驅(qū)動(dòng)為：org.gjt.mm.mysql.Driver。
　　<property name="easydbo.connection.url">表示數(shù)據(jù)源的具體的訪(fǎng)問(wèn)地址，每一種驅(qū)動(dòng)對(duì)應(yīng)的寫(xiě)法不同，請(qǐng)參照相應(yīng)的預(yù)支說(shuō)明。如MS SQL的jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=easyjf;SelectMethod=cursor，或者用jtds作驅(qū)動(dòng)的時(shí)候jdbc:jtds:sqlserver://127.0.0.1:1433;DatabaseName=easyjf;SelectMethod=cursor，My SQL對(duì)應(yīng)的URL寫(xiě)法為：jdbc:mysql://127.0.0.1:3306/easyjf
　　 <property name="easydbo.connection.username">節(jié)點(diǎn)表示數(shù)據(jù)庫(kù)的訪(fǎng)問(wèn)用戶(hù)名
　　<property name="easydbo.connection.password">節(jié)點(diǎn)表示數(shù)據(jù)庫(kù)訪(fǎng)問(wèn)密碼
    上面四個(gè)屬性都是jdbc連接數(shù)據(jù)庫(kù)共同所需的，由各個(gè)驅(qū)動(dòng)程序共同規(guī)范的。

　　 <property name="easydbo.dialect">節(jié)點(diǎn)表示EasyDBO的數(shù)據(jù)庫(kù)方言，這個(gè)是EasyDBO專(zhuān)用的。當(dāng)前提供的三種方言，可以支持4種數(shù)據(jù)庫(kù)類(lèi)型。其中com.easyjf.dbo.sql.MSSqlServerQuery為MS SQL及Access皆可使用；而com.easyjf.dbo.sql.MySqlQuery適合My SQL使用;com.easyjf.dbo.sql.OracleQuery適合Oracle數(shù)據(jù)庫(kù)使用。

　　<property name="easydbo.optimize">節(jié)點(diǎn)表示是否需要進(jìn)行數(shù)據(jù)優(yōu)化，這個(gè)可以隨便設(shè)置。

　　<property name="esyydbo.show_sql">節(jié)點(diǎn)表示是否需要在日志中輸出具體的SQL語(yǔ)句，若為true則會(huì)輸出SQL語(yǔ)句，若為false則不輸出。輸出sql語(yǔ)句對(duì)于調(diào)試、觀察程序的運(yùn)行比較有用。正式發(fā)布的程序的時(shí)候?yàn)榱颂岣咝剩梢栽O(shè)置成為false。


　　使用JNDI方式獲取數(shù)據(jù)源

　　很多時(shí)候，我們的數(shù)據(jù)源是存放在容器中的，如Weblogic，這時(shí)一般是通過(guò)JNDI的方式獲得數(shù)據(jù)源，而數(shù)據(jù)源治理則交給具體的容器負(fù)責(zé)。若要通過(guò)使用JNDI方式獲取數(shù)據(jù)源，則上面的<property name="easydbo.connection.driver_class">，<property name="easydbo.connection.url">兩個(gè)屬性不需要設(shè)置，而是通過(guò)<property name="easydbo.connection.jndiFactory">，<property name="easydbo.connection.jndi">兩個(gè)屬性來(lái)設(shè)置。

三、easyjf-dbo.xml文件中的其它設(shè)置

　　在easyjf-dbo.xml文件中，除了配置數(shù)據(jù)源以外，還可以配置具體的對(duì)象關(guān)系表映射，其中<tables><class>這一部分就是供大家直接通過(guò)配置文件的方式配置對(duì)象關(guān)系映射的，由于我們當(dāng)前示例都是直接使用實(shí)現(xiàn)IObject接口方式寫(xiě)的PO，因此只有example中的TestMessage.java演示了通過(guò)配置文件方式實(shí)現(xiàn)對(duì)象關(guān)系映射，這一部分的內(nèi)容我們將會(huì)在以后重點(diǎn)講述。

四、關(guān)于cache的配置
　　在easyjf-dbo.xml文件中，有<cache>這個(gè)節(jié)點(diǎn)，以后可通過(guò)他來(lái)配置數(shù)據(jù)庫(kù)的緩存。當(dāng)前的緩存是通過(guò)easyjf-cache.xml文件來(lái)配置的。

　　easyjf-cache.xml文件的全部?jī)?nèi)容如下：
  <?xml version="1.0" encoding="utf-8"?>
<easyjf-cache>

<cache name="EasyDBO" storePolicy="LRU" maxElements="1000"  expiredInterval="1000" type="com.easyjf.cache.EasyCache"/>
</easyjf-cache>

　　若要使用cache功能，則在與easyjf-dbo.xml文件所在的目錄中建一個(gè)easyjf-cache.xml文件，內(nèi)容如上即可。
  關(guān)于cache，我們會(huì)在以后作具體的介紹。

上一篇：DOM文檔操作和XML文件互相轉(zhuǎn)換的java實(shí)現(xiàn)

下一篇：DOM文檔操作和XML文件互換java實(shí)現(xiàn)