OFBiz是一個非常好的企業級開發框架,實現了多層的松耦合結構,其中一部分松耦合就是通過配置文件實現的,這里就要提到一些配置文件和開發文件。
1、首先是entityengine.xml文件,這個文件是配置數據源的,也包括數據庫連接池、事務實現類的配置和字段類型配置文件。企業級系統的開發一般都離不開數據庫,那么在OFBiz中,數據庫的配置就在這個配置文件里面,先配置一個group-map,然后配置其對應的數據源:
<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配置:
<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指向的文件是:
<field-type name="mysql" loader="fieldfile" location="fieldtypemysql.xml"/>
在fieldtypemysql.xml中,就可以找到如int10,varchar128表示的實際mysql字段類型了:
1 <fieldtypemodel xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
2 xsi:noNamespaceSchemaLocation="http://ofbiz.apache.org/dtds/fieldtypemodel.xsd">
3 <!-- ===================== field-type-def ==================== -->
4 <!-- General Types -->
5 <field-type-def type="blob" sql-type="BLOB" java-type="java.sql.Blob"></field-type-def>
6
7 <field-type-def type="date-time" sql-type="DATETIME" java-type="java.sql.Timestamp"></field-type-def>
8 <field-type-def type="date" sql-type="DATE" java-type="java.sql.Date"></field-type-def>
9 <field-type-def type="time" sql-type="TIME" java-type="java.sql.Time"></field-type-def>
10
11 <field-type-def type="currency-amount" sql-type="DECIMAL(18,2)" java-type="java.math.BigDecimal"><validate method="isSignedDouble" /></field-type-def>
12 <field-type-def type="currency-precise" sql-type="DECIMAL(18,3)" java-type="java.math.BigDecimal"><validate method="isSignedDouble" /></field-type-def>
13 <field-type-def type="fixed-point" sql-type="DECIMAL(18,6)" java-type="java.math.BigDecimal"><validate method="isSignedDouble" /></field-type-def>
14 <field-type-def type="floating-point" sql-type="DECIMAL(18,6)" java-type="Double"><validate method="isSignedDouble" /></field-type-def>
15 <field-type-def type="numeric" sql-type="DECIMAL(20,0)" java-type="Long"><validate method="isSignedLong" /></field-type-def>
16 <field-type-def type="integer" sql-type="INTEGER" java-type="Integer"></field-type-def>
17
18 <field-type-def type="id" sql-type="VARCHAR(20)" java-type="String"></field-type-def>
19 <field-type-def type="id-long" sql-type="VARCHAR(60)" java-type="String"></field-type-def>
20 <field-type-def type="id-vlong" sql-type="VARCHAR(250)" java-type="String"></field-type-def>
21
22 <field-type-def type="indicator" sql-type="CHAR(1)" java-type="String"></field-type-def>
23 <field-type-def type="very-short" sql-type="VARCHAR(10)" java-type="String"></field-type-def>
24 <field-type-def type="short-varchar" sql-type="VARCHAR(60)" java-type="String"></field-type-def>
25 <field-type-def type="long-varchar" sql-type="VARCHAR(255)" java-type="String"></field-type-def>
26 <field-type-def type="very-long" sql-type="LONGTEXT" java-type="String"></field-type-def>
27
28 <field-type-def type="comment" sql-type="VARCHAR(255)" java-type="String"></field-type-def>
29 <field-type-def type="description" sql-type="VARCHAR(255)" java-type="String"></field-type-def>
30 <field-type-def type="name" sql-type="VARCHAR(100)" java-type="String"></field-type-def>
31 <field-type-def type="value" sql-type="VARCHAR(255)" java-type="String"></field-type-def>
32
33 <!-- customize field type definitions for ccb -->
34 <field-type-def type="text" sql-type="TEXT" java-type="String"></field-type-def>
35
36 <field-type-def type="char" sql-type="CHAR(1)" java-type="String"></field-type-def>
37 <field-type-def type="char125" sql-type="CHAR(125)" java-type="String"></field-type-def>
38 <field-type-def type="varchar16" sql-type="VARCHAR(16)" java-type="String"></field-type-def>
39 <field-type-def type="varchar20" sql-type="VARCHAR(20)" java-type="String"></field-type-def>
40 <field-type-def type="varchar24" sql-type="VARCHAR(24)" java-type="String"></field-type-def>
41 <field-type-def type="varchar50" sql-type="VARCHAR(50)" java-type="String"></field-type-def>
42 <field-type-def type="varchar64" sql-type="VARCHAR(64)" java-type="String"></field-type-def>
43 <field-type-def type="varchar128" sql-type="VARCHAR(128)" java-type="String"></field-type-def>
44 </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。
<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配置,如果不想加載,注釋掉就可以。
<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進進行配置:
<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中的緩存有所了解,這個在后續文章中進行分析。
其他還有一些比較配置的文件,就不一一說明了。