OFBiz 開發需要用到的幾個重要（配置）文件

摘要: OFBiz有很多的配置文件，知道這些配置文件和意義對於OFBiz開發非常重要。

OFBiz是一個非常好的企業級開發框架，實現了多層的鬆耦合結構，其中一部分鬆耦合就是通過配置文件實現的，這裏就要提到一些配置文件和開發文件。

1、首先是entityengine.xml文件，這個文件是配置數據源的，也包括數據庫連接池、事務實現類的配置和字段類型配置文件。企業級系統的開發一般都離不開數據庫，那麼在OFBiz中，數據庫的配置就在這個配置文件裏面，先配置一個group-map，然後配置其對應的數據源：

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

--><delegator name="default" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main"
   distributed-cache-clear-enabled="false">
        <group-map group-name="org.ofbiz" datasource-name="ofbiz"/>
        <group-map group-name="com.aicent" datasource-name="portal"/>
    </delegator>

    <datasource name="ofbiz"
            helper-class="org.ofbiz.entity.datasource.GenericHelperDAO"
            field-type-name="mysql"
            check-on-start="false"
            add-missing-on-start="false"
            check-pks-on-start="false"
            use-foreign-keys="true"
            join-style="ansi-no-parenthesis"
            alias-view-columns="false"
            drop-fk-use-foreign-key-keyword="true"
            table-type="InnoDB"
            character-set="latin1"
            collate="latin1_swedish_ci">
        <read-data reader-name="seed"/>
        <read-data reader-name="seed-initial"/>
        <read-data reader-name="demo"/>
        <read-data reader-name="ext"/>
        <inline-jdbc
                jdbc-driver="com.mysql.jdbc.Driver"
        jdbc-uri="jdbc:mysql://localhost/ofbiztrunk"
                jdbc-username="root"
                jdbc-password="123456"
                isolation-level="ReadCommitted"
                pool-minsize="2"
                pool-maxsize="20"/>
        <!-- <jndi-jdbc jndi-server-name="localjndi" jndi-name="java:/MySqlDataSource" isolation-level="Serializable"/> -->
    </datasource>

datasource配置裏面有一個field-type-name="mysql"，到entitymodel.xml配置文件就知道是幹嗎用的了。

2.entitymodel.xml & entitygroup.xml
  OFBiz本質上來說還是面向數據庫的設計，entitymodel.xml的配置entity的，entity實體對應數據庫裏面的table，實體的field對應數據庫裏面的字段,如下是一個entity配置：

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

--><entity entity-name="Customerinfo" package-name="com.aicent.ccb" no-auto-stamp="true"
        title="customerinfo">
        <field name="id" type="int10" ></field>
        <field name="name" type="varchar128"></field>
        <field name="customernameshort" type="varchar16"></field>
        <field name="country" type="varchar64"></field>
        <field name="businessaddr" type="text"></field>
        <field name="mailaddr" type="text"></field>
        <field name="billaddr" type="text"></field>
        <field name="phone" type="varchar32"></field>
        <field name="fax" type="varchar32"></field>
        <field name="website" type="varchar128"></field>
        <field name="note" type="text"></field>
</entity>

裏面有一個type，這個type對應數據庫字段的類型（日期型，字符串型，整型等），這個對於關係在哪裏呢？就在剛纔說的field-type-name裏面配置，如果配置爲mysql，那麼entitygengine.xml中mysql的
field-type指向的文件是：

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

--><field-type name="mysql" loader="fieldfile" location="fieldtypemysql.xml"/>

在fieldtypemysql.xml中，就可以找到如int10,varchar128表示的實際mysql字段類型了：

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

--> <fieldtypemodel xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="http://ofbiz.apache.org/dtds/fieldtypemodel.xsd">
    <!-- ===================== field-type-def ==================== -->
    <!-- General Types -->
     <field-type-def type="blob" sql-type="BLOB" java-type="java.sql.Blob"></field-type-def>

     <field-type-def type="date-time" sql-type="DATETIME" java-type="java.sql.Timestamp"></field-type-def>
     <field-type-def type="date" sql-type="DATE" java-type="java.sql.Date"></field-type-def>
     <field-type-def type="time" sql-type="TIME" java-type="java.sql.Time"></field-type-def>

     <field-type-def type="currency-amount" sql-type="DECIMAL(18,2)" java-type="java.math.BigDecimal"><validate method="isSignedDouble" /></field-type-def>
     <field-type-def type="currency-precise" sql-type="DECIMAL(18,3)" java-type="java.math.BigDecimal"><validate method="isSignedDouble" /></field-type-def>
     <field-type-def type="fixed-point" sql-type="DECIMAL(18,6)" java-type="java.math.BigDecimal"><validate method="isSignedDouble" /></field-type-def>
     <field-type-def type="floating-point" sql-type="DECIMAL(18,6)" java-type="Double"><validate method="isSignedDouble" /></field-type-def>
     <field-type-def type="numeric" sql-type="DECIMAL(20,0)" java-type="Long"><validate method="isSignedLong" /></field-type-def>
     <field-type-def type="integer" sql-type="INTEGER" java-type="Integer"></field-type-def>

     <field-type-def type="id" sql-type="VARCHAR(20)" java-type="String"></field-type-def>
     <field-type-def type="id-long" sql-type="VARCHAR(60)" java-type="String"></field-type-def>
     <field-type-def type="id-vlong" sql-type="VARCHAR(250)" java-type="String"></field-type-def>

     <field-type-def type="indicator" sql-type="CHAR(1)" java-type="String"></field-type-def>
     <field-type-def type="very-short" sql-type="VARCHAR(10)" java-type="String"></field-type-def>
     <field-type-def type="short-varchar" sql-type="VARCHAR(60)" java-type="String"></field-type-def>
     <field-type-def type="long-varchar" sql-type="VARCHAR(255)" java-type="String"></field-type-def>
     <field-type-def type="very-long" sql-type="LONGTEXT" java-type="String"></field-type-def>

     <field-type-def type="comment" sql-type="VARCHAR(255)" java-type="String"></field-type-def>
     <field-type-def type="description" sql-type="VARCHAR(255)" java-type="String"></field-type-def>
     <field-type-def type="name" sql-type="VARCHAR(100)" java-type="String"></field-type-def>
     <field-type-def type="value" sql-type="VARCHAR(255)" java-type="String"></field-type-def>

     <!-- customize field type definitions for ccb -->
     <field-type-def type="text" sql-type="TEXT" java-type="String"></field-type-def>

     <field-type-def type="char" sql-type="CHAR(1)" java-type="String"></field-type-def>
     <field-type-def type="char125" sql-type="CHAR(125)" java-type="String"></field-type-def>
     <field-type-def type="varchar16" sql-type="VARCHAR(16)" java-type="String"></field-type-def>
     <field-type-def type="varchar20" sql-type="VARCHAR(20)" java-type="String"></field-type-def>
     <field-type-def type="varchar24" sql-type="VARCHAR(24)" java-type="String"></field-type-def>
     <field-type-def type="varchar50" sql-type="VARCHAR(50)" java-type="String"></field-type-def>
     <field-type-def type="varchar64" sql-type="VARCHAR(64)" java-type="String"></field-type-def>
     <field-type-def type="varchar128" sql-type="VARCHAR(128)" java-type="String"></field-type-def>
</fieldtypemodel>

OFBiz這裏爲什麼不在entitymodel裏面直接使用字段在數據庫中的類型，而這麼繞呢？我想至少有兩個目的：首先是公司企業開發時可以針對使用的字段類型有一個規範，所有的字段都採用這個配置文件中的字段類型，而不是開發人員自己隨意定義數據庫字段的類型；第二是爲了使用不同Vendor的數據庫，如果想從mysql換成oracle，只需要定義另一份fieldtypeoracle.xml，field-type-def中sql-type不變，而sql-tye換成oracle的類型即可。

entitygroup.xml配置文件時用於配置entitymodel.xml中配置的entity是屬於哪個group的，這個group對應entityengine.xml中的group-name，如果忘記在entitygroup.xml中配置，那麼在OFBiz 9之前，這個entity就無法使用，不會創建相應的table，OFBiz 9以後，默認的group name是org.ofbiz。

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

--><entitygroup xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="http://www.ofbiz.org/dtds/entitygroup.xsd">


    <entity-group group="com.aicent" entity="Customerextra" />
    <entity-group group="com.aicent" entity="Customerinfo" />

</entitygroup>

3.ofbiz-containers.xml 裏面配置了各種容器類，經常修改的容器就是name爲catalina-container的容器，使用的是embeded tomcat，裏面可以修改各種tomcat的配置項，就像我們修改tomcat的配置文件server.xml一樣，在裏面修改端口等信息。

4.log4j.xml 日誌配置文件

5.component-load.xml 這個文件在幾個文件夾中都存在，如framework,applications,specialpurpose中。OFBiz將一個個應用實現爲component，這些componnet是就好像tomcat中webapps中的一個個web應用。每次是否加載這個component可以在component-load.xml配置，如果不想加載，註釋掉就可以。

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

--><component-loader xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="http://ofbiz.apache.org/dtds/component-loader.xsd">
    <load-component component-location="commonext"/><!-- common component used by most other components -->
    <load-component component-location="securityext"/>
    <!--
    <load-component component-location="party"/>
    <load-component component-location="content"/>
    <load-component component-location="workeffort"/>
    <load-component component-location="product"/>
    <load-component component-location="manufacturing"/>
    <load-component component-location="accounting"/>
    <load-component component-location="humanres"/>
    <load-component component-location="order"/>
    <load-component component-location="marketing"/>
    -->
</component-loader>

到底哪些目錄下的component-load.xml有效呢，這個目錄在framework/base/config/component-load.xml進進行配置：

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

--><component-loader xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="http://ofbiz.apache.org/dtds/component-loader.xsd">
    <load-components parent-directory="framework"/>
    <load-components parent-directory="themes"/>
    <load-components parent-directory="applications"/>
    <load-components parent-directory="specialpurpose"/>
    <load-components parent-directory="hot-deploy"/>
</component-loader>

6.general.properties 這裏面配置的東西很多，大家自己去看吧。

7.cache.properties 配置OFBiz中的緩存，配置這個文件需要對OFBiz中的緩存有所瞭解，這個在後續文章中進行分析。

其他還有一些比較配置的文件，就不一一說明了