原創 Ofbiz 入門教程
1.Ofbiz 介紹：
Ofbiz(http://www.ofbiz.org) 是 Open Source 的商務軟件系統，充分利用了各優秀的的Open Source 項目，
像 Tomcat, Ant, BeanShell, Jboss 等，構建了一個強大的系統平臺，Ofbiz 已經完成了大部分商務類軟件系統
都需要的部件，像用戶認證、工作流、商務規則處理等，Ofbiz 的核心技術在于 Entity Engine，其他的組件基本都
是基于它的。簡單來說 Entity Engine 的主要功能是將數據庫表創建、對象與數據表的映射、對象的查詢等做了強大
封裝，你可以在一個簡單的 XML 文件中定義數據庫表結構，Ofbiz 會自動幫你在數據庫建表，并動態生成映射對象，
你在程序中可以只考慮對 Object 的處理，Ofbiz 會自動通過事務邏輯更新到數據庫中。Ofbiz 宣稱的優點之一是用
很少的 Code 完成復雜的處理。
2.Ofbiz 下載與安裝
首先要安裝 J2SDK1.4，到 http://java.sun.com 上下載，安裝后設定 JAVA_HOME 環境變量為 J2SDK 的安裝目錄。
訪問網站 http://www.ofbiz.org，上面有下載的連接，請選擇 Complete 包，因為這個包中已經包含了運行 Ofbiz
的所有東西，下載下來解開后就可以運行了。
解開 Ofbiz 包到一個目錄下，假設是 “C:\ofbiz”，該目錄下將會有 catalina 和 ofbiz 兩個目錄， catalina
目錄是 Tomcat 的目錄，Ofbiz 對其配置做了修改，ofbiz 目錄是 Ofbiz 的程序代碼目錄。在命令行狀態下進入
“c:\ofbiz\catalina\bin” 目錄，運行“ ofbiz run”命令，就可以啟動 Ofbiz，啟動后你可以用瀏覽器訪問
“http://localhost:8080/ecommerce”，這可以訪問 Ofbiz 的電子商務模塊，通過頁面上面的連接你可以訪問到
其他模塊。
3.Ofbiz Schema 的創建
Ofbiz 應用入門：
以一個實例說明，假設我們需要建一個客戶資料表，起名為 StudyCustomer，各個段分別如下：
StudyCustomer {
customerId Integer,
customerName String,
customerNote String,
}
我們來實現基本的數據操作---增/刪/改/查詢，具體步驟如下：
1.在 XML 文件中定義數據 Schema：
需要用到三個文件，一個是我們要建的項目的 entitymodel_xxx.xml 和 entityengine.xml，還有
entitygroup.xml,
entitymodel_xxx.xml 是需要我們自己創建的，假設我們起名為 entitymodel_study.xml，放在
“c:\ofbiz\ofbiz\commonapp\entitydef”目錄下，
entityengine.xml 是 Ofbiz 已經有的，放在 “c:\ofbiz\commonapp\etc”目錄下，用來包含我們
定義的 entitymodel 文件。
entitygroup.xml 也是 Ofbiz 已經有的，跟 engityengine.xml 在同一目錄下，我們需要把我們的
Schema 定義加入到該文件中
entitymodel_study.xml 文件的定義格式如下：
<!--================================================================================-->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE entitymodel PUBLIC "-//OFBiz//DTD Entity Model//EN"
"http://www.ofbiz.org/dtds/entitymodel.dtd">
<entitymodel>
<title>Entity of an Open For Business Project Component</title>
<description>None</description>
<copyright>Copyright (c) 2002 The Open For Business Project - www.ofbiz.org</copyright>
<author>None</author>
<version>1.0</version>
<!-- ========================================================= -->
<!-- ======================== Data Model ===================== -->
<!-- The modules in this file are as follows: -->
<!-- - org.ofbiz.commonapp.study -->
<!-- ========================================================= -->
<!-- ========================================================= -->
<!-- org.ofbiz.commonapp.study -->
<!-- ========================================================= -->
<entity entity-name="StudyCustomer"
package-name="org.ofbiz.commonapp.study"
title="Study Customer Entity">
<field name="customerId" type="id-ne"></field>
<field name="customerName" type="long-varchar"></field>
<field name="customerNote" type="long-varchar"></field>
<prim-key field="customerId"/>
</entity>
</entitymodel>
<!--================================================================================-->
這個 XML 文件中的 Tag 基本是看得明白的，只是 field 的 type 是 Ofbiz 已經預定義好的，這
是為了保證數據庫間的遷移。
在 entityengine.xml 加入我們剛才定義的文件，加入一行在合適的位置：
<resource loader="mainfile" location="entitymodel_study.xml"/>
具體放的位置我們可以通過查看 entityengine.xml 找到，里面已經有加好的其他文件。
在 entitygroup.xml 加入我們的 Schema 定義，在后面加入一行
<entity-group group="org.ofbiz.commonapp" entity="StudyCustomer" />
這樣我們就定義好了 Schema，現在把 c:\ofbiz\commonapp\etc\entityengine.xml 拷貝到
c:\ofbiz\catalina\shared\classes 目錄下，這點要切記，我以前就因為沒有拷貝，最后 Schema
怎么也創建不了。
重新啟動 Ofbiz，訪問 URL: http://localhost:8080/webtools，點擊右上方的 "Login" 鏈接，
用 admin/ofbiz 登錄，登錄進入后選擇鏈接“Check/Update Database”，這時會出現 Check 的 Form，
該表單可以只檢驗 Schema 是否改變，默認的 GroupName 是“org.ofbiz.commonapp”，這個不需要變，
點擊“Check Only”按鈕，Ofbiz 會檢驗變動情況，顯示出一個完整的列表，你可以查一下是否有我們剛建的
"StudyCustomer"，如果沒有，可能是我們前面定義的有些問題，檢查一下再重新做。
在檢查到以后，可以再選擇“Check and Add Missing”，這是 Ofbiz 很強大的一個功能，你在 XML 中新
增了表，或在某個表中新增了段，它會自動映射到數據庫中，避免我們去直接操作數據庫。
現在已經完成了 StudyCustomer Schema 的創建,如果想檢驗一下是否有表創建，我們可以用編輯器打開
c:\ofbiz\data\ofbiz.script ，在里面查詢 CREATE TABLE StudyCustomer 的字樣，如果前面沒有
問題，我們可以找到的。
4.如何使用已經定義的 Schema
如何使用已經定義的 Schema
Ofbiz 遵循 MVC 的設計模式，在 View 端，即 JSP 端主要使用 Ofbiz 定義的 Tag 來顯示或
提取數據，Control 是一個 Controller Servlet，我們在 Controller Servlet 的 URI mapping
配置文件中定義各 URL 應該指向什么程序，這樣，通過這個 mapping 配置文件，可以保證我們各個頁面
及具體處理程序之間的獨立性，例我們可以通過修改這個配置文件就可以改變某個 Form 的 Post Action
的 URL，而不需要修改實際的 HTML 或 JSP 代碼。
Ofbiz 中定義了 Regions 的概念，即將一個 HTML 頁面分成幾個區域，像 Top, Left, Right, Main
等，通過這些 Regions 我們可以方便的組合 UI 界面，并且可以方便改變各部分所處的位置，如我們可以
把菜單很容易的從上方移到下方，只需要改變一個配置文件。Regions 類似于 HTML 中的 Frame，但它是
通過一個頁面來組合界面，Frame 是通過幾個頁面顯示在不同的幀中，Frame 的控制比較復雜，而且需要
改變相關的程序。
在 Ofbiz 中，我們可以直接在 JSP 中操作 Schema 定義的 Object，即我們剛定義的 StudyCustomer，
示例如下：
<%@ taglib uri="ofbizTags" prefix="ofbiz" %>
<%@ page import="java.util.*" %>
<%@ page import="org.ofbiz.core.util.*, org.ofbiz.core.pseudotag.*" %>
<%@ page import="org.ofbiz.core.entity.*" %>
<jsp:useBean id="delegator" type="org.ofbiz.core.entity.GenericDelegator" scope="request" />
<jsp:useBean id="security" type="org.ofbiz.core.security.Security" scope="request" />
<%if(security.hasEntityPermission("PARTYMGR", "_VIEW", session)) {%>
<%
try {
delegator.create("StudyCustomer",
UtilMisc.toMap("customerId","1","customerName","Cust1","customerNote","Customer Note 1"));
Iterator custs =
UtilMisc.toIterator(delegator.findAll("StudyCustomer",UtilMisc.toList("customerId","customerName","customerNote")));
while(custs.hasNext())
{
GenericValue cust = (GenericValue)custs.next();
out.println(cust.getString("customerId"));
out.println(cust.getString("customerName"));
out.println(cust.getString("customerNote"));
}
} catch(Exception e)
{
out.println(e.getMessage());
}
%>
<%}else{%>
<h3>You do not have permission to view this page. ("PARTYMGR_VIEW" or "PARTYMGR_ADMIN" needed)</h3>
<%}%>
這段程序挺容易理解，先是通過 delegator 創建一個 Object，該 Object 將會由 Ofbiz 自動同步到
數據庫中。然后通過 delegator 的 findAll 取到所有已保存的 Object，最后通過一個 Iterator 對象
顯示出來。
這個程序起名為 testofbiz.jsp，為簡單起見，我們放到 Ofbiz 已有的一個 Webapp 的目錄下，放到
c:\ofbiz\ofbiz\partymgr\webapp\party 目錄下。然后我們需要修改兩個配置文件：controller.xml
和 regions.xml，這兩個文件就是我們上面提到的 mapping 和 regions 配置文件。
這兩個文件都在：c:\ofbiz\ofbiz\partymgr\webapp\WEB-INF 下，在 controller.xml 中加入下面
<request-map uri="testofbiz">
<description>Test Ofbiz</description>
<security https="false" auth="false"/>
<response name="success" type="view" value="testofbiz"/>
</request-map>
和
<view-map name="testofbiz" type="region"/>
加入位置請參照 controller.xml 中已經有的配置。在 regions.xml 中加入：
<define id='testofbiz' region='MAIN_REGION'>
<put section='title'>Test Ofbiz</put>
<put section='content' content='/party/testofbiz.jsp'/>
</define>
具體加入位置請參考已有的配置。
配置完后，重新啟動 ofbiz，然后訪問 URL:
http://localhost:8080/partymgr/control/testofbiz
由于我們在 testofbiz.jsp 程序中使用了 Ofbiz 的安全控制機制，系統會提示現在沒有訪問
權限，需要登錄，點擊右邊的“Login” 用 admin/ofbiz 登錄后會看到我們程序 testofbiz.jsp
的運行結果。如果需要增加新記錄，請修改
UtilMisc.toMap("customerId","1","customerName","Cust1","customerNote","Customer Note 1"));
中的各個段的值，然后再訪問 http://localhost:8080/partymgr/control/testofbiz，如果不修改
而直接訪問那個 URL 時，系統會提示 Primary key 沖突。
5.按照顯示與邏輯分離的原則使用 Schema:
上篇講了如何在 JSP 中使用創建的 Schema 對象，這次我們來講述一下如何把程序
邏輯放到 JavaBeans 中，把顯示處理放到 JSP 中，并使用 controller.xml 將兩
部分整合起來。
首先我們來創建一個 JavaBeans，來完成Add/Get/Delete/Update Schema 對象
的操作，程序文件名為 TestOfbiz.java，放置在
c:\ofbiz\ofbiz\testOfbiz\com\geeyo\ofbiz 目錄下, 具體程序如下：
>=================================================================
package com.geeyo.ofbiz;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
import java.net.*;
import org.ofbiz.core.util.*;
import org.ofbiz.core.entity.*;
import org.ofbiz.core.service.*;
import org.ofbiz.core.security.*;
import org.ofbiz.core.stats.*;
public class TestOfbiz
{
public static void main(String[] args)
throws Exception
{
GenericDelegator delegator = GenericDelegator.getGenericDelegator("default");
delegator.create("StudyCustomer",UtilMisc.toMap("customerId","3","customerName","Kane3","customerNote","This is test customer.3"));
Iterator custs = UtilMisc.toIterator(delegator.findAll("StudyCustomer",UtilMisc.toList("customerId","customerName","customerNote")));
while(custs.hasNext())
{
GenericValue cust = (GenericValue)custs.next();
System.out.println(cust.getString("customerId"));
System.out.println(cust.getString("customerName"));
System.out.println(cust.getString("customerNote"));
}
}
public static String createNewRecord(HttpServletRequest request, HttpServletResponse response)
throws Exception
{
Map paras = UtilMisc.getParameterMap(request);
GenericDelegator delegator = GenericDelegator.getGenericDelegator("default");
delegator.create("StudyCustomer",paras);
return "success";
}
public static String lookAllRecords(HttpServletRequest request, HttpServletResponse response)
throws Exception
{
GenericDelegator delegator = GenericDelegator.getGenericDelegator("default");
Iterator custs = UtilMisc.toIterator(delegator.findAll("StudyCustomer",UtilMisc.toList("customerId","customerName","customerNote")));
Collection col = new ArrayList();
while(custs.hasNext())
{
GenericValue cust = (GenericValue)custs.next();
col.add(cust);
}
request.getSession().setAttribute("search_results",col);
return "success";
}
public static String findRecord(HttpServletRequest request, HttpServletResponse response)
throws Exception
{
String id = (String)request.getParameter("customerId");
GenericDelegator delegator = GenericDelegator.getGenericDelegator("default");
try {
GenericValue cust = delegator.findByPrimaryKey("StudyCustomer",UtilMisc.toMap("customerId",id));
request.getSession().setAttribute("edit_cust",cust);
} catch (GenericEntityException gee) {
Debug.logWarning(gee);
}
return "success";
}
public static String updateRecord(HttpServletRequest request, HttpServletResponse response)
throws Exception
{
Map paras = UtilMisc.getParameterMap(request);
GenericDelegator delegator = GenericDelegator.getGenericDelegator("default");
GenericValue cust = delegator.findByPrimaryKey("StudyCustomer",UtilMisc.toMap("customerId",paras.get("customerId")));
cust.setNonPKFields(paras);
cust.store();
request.getSession().setAttribute("edit_cust",cust);
return "success";
}
public static String removeRecord(HttpServletRequest request, HttpServletResponse response)
throws Exception
{
String strId = request.getParameter("id");
GenericDelegator delegator = GenericDelegator.getGenericDelegator("default");
GenericValue cust = delegator.findByPrimaryKey("StudyCustomer",UtilMisc.toMap("customerId",strId));
cust.remove();
return "success";
}
}
>=================================================================
程序中的處理大部分可以看懂的，其中有個功能，是
Map paras = UtilMisc.getParameterMap(request);
這是 Ofbiz 的一個有趣但非常有用的功能，它是把 request 中各段的名字和值映射到一個 Map
對象中，然后使用
cust.setNonPKFields(paras);
就可以賦給 Object cust 的各個段，免了我們使用 request.getParameter("name")來取各個
值，在值很多的時候這個功能可以大大減少冗余代碼量。
基本程序的邏輯是這樣的，
1.從 request 讀取傳來的值
2.使用 delegator 來處理，Add/Update/Delete/Query
3.將返回結果放到 Session 中傳給 JSP
我做了個 Ant build.xml 文件可以幫助編譯，把這個文件放在:
c:\ofbiz\ofbiz\testOfbiz\ 目錄下，然后在命令行窗口下進入該目錄，敲入 ant
來編譯（需要保證已經安裝 Ant），編譯后的 .class 會放在
c:\ofbiz\ofbiz\testOfbiz\com\geeyo\ofbiz 下，
拷貝 c:\ofbiz\ofbiz\testofbiz\com 目錄到 c:\ofbiz\ofbiz\partymgr\webapp\WEB-INF\classes
目錄下。
build.xml
>=============================================================================
<project name="TestOfbiz" default="dist" basedir=".">
<description>
Test ofbiz
</description>
<!--test cvs-->
<!-- set global properties for this build -->
<property name="src" location="."/>
<property name="build" location="."/>
<property name="lib_dir" location="c:/ofbiz/catalina/shared/lib"/>
<property name="lib1_dir" location="c:/ofbiz/catalina/common/lib"/>
<path id="project.class.path">
<fileset dir="${lib_dir}">
<include name="*.jar"/>
</fileset>
<fileset dir="${lib1_dir}">
<include name="*.jar"/>
</fileset>
</path>
<target name="init">
<!-- Create the time stamp -->
<tstamp/>
<!-- Create the build directory structure used by compile -->
<mkdir dir="${build}"/>
</target>
<target name="compile" depends="init"
description="compile the source " >
<!-- Compile the java code from ${src} into ${build} -->
<javac srcdir="${src}" destdir="${build}">
<classpath refid="project.class.path"/>
</javac>
</target>
<target name="dist" depends="compile"
description="generate the distribution" >
<!-- Create the distribution directory -->
</target>
<target name="clean"
description="clean up" >
<!-- Delete the ${build} and ${dist} directory trees -->
</target>
</project>
>=============================================================================
然后我們來創建 JSP 程序，JSP 程序全部放在
c:\ofbiz\ofbiz\partymgr\webapp\party 下面
1.listofbiz.jsp
>=============================================================================
<%@ taglib uri="ofbizTags" prefix="ofbiz" %>
<%@ page import="java.util.*, org.ofbiz.core.service.ModelService" %>
<%@ page import="org.ofbiz.core.util.*, org.ofbiz.core.pseudotag.*" %>
<%@ page import="org.ofbiz.core.entity.*" %>
<jsp:useBean id="security" type="org.ofbiz.core.security.Security" scope="request" />
<jsp:useBean id="delegator" type="org.ofbiz.core.entity.GenericDelegator" scope="request" />
<script language="JavaScript">
function confirmDelete()
{
return confirm("Are your sure to delete?");
}
</script>
<%if(security.hasEntityPermission("PARTYMGR", "_VIEW", session)) {%>
<table width="600" align="center">
<ofbiz:if name="search_results">
<tr><th>Id</th><th>Name</th><th>Note</th><th></th></tr>
<ofbiz:iterator name="cust" property="search_results">
<tr>
<td><ofbiz:entityfield attribute="cust" field="customerId"/></td>
<td><ofbiz:entityfield attribute="cust" field="customerName"/></td>
<td><ofbiz:entityfield attribute="cust" field="customerNote"/></td>
<td>
<a href='<ofbiz:url>/showtest?customerId=<ofbiz:entityfield attribute="cust" field="customerId"/></ofbiz:url>' class="buttontext">[Edit]</a>
<a href='<ofbiz:url>/removetest?customerId=<ofbiz:entityfield attribute="cust" field="customerId"/></ofbiz:url>' class="buttontext" onclick="return confirmDelete()">[Remove]</a>
</td>
</tr>
</ofbiz:iterator>
</ofbiz:if>
</table>
<table width="200" align="center">
<tr>
<td><a href='<ofbiz:url>/createTestForm</ofbiz:url>'>Create customer</a></td>
</tr>
</table>
<%}else{%>
<h3>You do not have permission to view this page. ("PARTYMGR_VIEW" or "PARTYMGR_ADMIN" needed)</h3>
<%}%>
>=============================================================================
上面程序中需要說明的是
<ofbiz:if name="search_results">
和
<ofbiz:iterator name="cust" property="search_results">，
<ofbiz:if name="search_results"> 是用來檢驗在 session 或 pageContext 對象
中是否包含 search_results 對象，該對象是由我們的程序放到 session 中的。
<ofbiz:iterator name="cust" property="search_results"> 是用來循環讀取對象
search_results（是個 Collection 對象）中存儲的各對象，并賦給cust，然后在循環體
中，我們就可以用 cust 對象來讀取各個段的值了。
2.createofbiz.jsp
>=============================================================================
<%@ taglib uri="ofbizTags" prefix="ofbiz" %>
<%@ page import="java.util.*, org.ofbiz.core.service.ModelService" %>
<%@ page import="org.ofbiz.core.util.*, org.ofbiz.core.pseudotag.*" %>
<%@ page import="org.ofbiz.core.entity.*" %>
<jsp:useBean id="security" type="org.ofbiz.core.security.Security" scope="request" />
<jsp:useBean id="delegator" type="org.ofbiz.core.entity.GenericDelegator" scope="request" />
<%if(security.hasEntityPermission("PARTYMGR", "_VIEW", session)) {%>
<form method="post" action="<ofbiz:url>/createTest</ofbiz:url>" name="createofbiz">
<table width="300" align="center">
<tr>
<td>Id</td><td><input type="text" name="customerId" size="20"></td>
</tr>
<tr>
<td>Name</td><td><input type="text" name="customerName" size="20"></td>
</tr>
<tr>
<td>Note</td><td><input type="text" name="customerNote" size="30"></td>
</tr>
<tr>
<td></td>
<td><input type="submit"></td>
</tr>
</table>
</form>
<%}else{%>
<h3>You do not have permission to view this page. ("PARTYMGR_VIEW" or "PARTYMGR_ADMIN" needed)</h3>
<%}%>
>=============================================================================
這個程序很容易理解，需要注意的是每個文本框的名字，要跟 Schema StudyCustomer 的各
個段一致，以使程序中跟容易處理。
3.showofbiz.jsp
>=============================================================================
<%@ taglib uri="ofbizTags" prefix="ofbiz" %>
<%@ page import="java.util.*, org.ofbiz.core.service.ModelService" %>
<%@ page import="org.ofbiz.core.util.*, org.ofbiz.core.pseudotag.*" %>
<%@ page import="org.ofbiz.core.entity.*" %>
<jsp:useBean id="security" type="org.ofbiz.core.security.Security" scope="request" />
<jsp:useBean id="delegator" type="org.ofbiz.core.entity.GenericDelegator" scope="request" />
<%if(security.hasEntityPermission("PARTYMGR", "_VIEW", session)) {%>
<form method="post" action="<ofbiz:url>/updateTest</ofbiz:url>" name="updateofbiz">
<table width="300" align="center">
<tr>
<td>Id</td><td><input type="text" name="customerId" size="20" value="<ofbiz:entityfield attribute="edit_cust" field="customerId"/>"></td>
</tr>
<tr>
<td>Name</td><td><input type="text" name="customerName" size="20" value="<ofbiz:entityfield attribute="edit_cust" field="customerName"/>"></td>
</tr>
<tr>
<td>Note</td><td><input type="text" name="customerNote" size="30" value="<ofbiz:entityfield attribute="edit_cust" field="customerNote"/>"></td>
</tr>
<tr>
<td></td>
<td><input type="submit"></td>
</tr>
</table>
</form>
<%}else{%>
<h3>You do not have permission to view this page. ("PARTYMGR_VIEW" or "PARTYMGR_ADMIN" needed)</h3>
<%}%>
>=============================================================================
這個程序中，主要是通過
<ofbiz:entityfield attribute="edit_cust" field="customerId"/>
把取到的對象的段顯示出來, 對象 edit_cust 是我們在程序中取到并放到 session 中的。
下面我們來配置 controller.xml 和 regions.xml, 在 controller.xml 中加入:
>=============================================================================
<request-map uri="createTestForm">
<description>Show the create form</description>
<security https="false" auth="false"/>
<response name="success" type="view" value="createTestForm"/>
</request-map>
<request-map uri="testofbiz">
<description>Test Ofbiz</description>
<security https="false" auth="false"/>
<response name="success" type="view" value="testofbiz"/>
</request-map>
<request-map uri="listtest">
<description>List all records</description>
<security https="false" auth="false"/>
<event type="java" path="com.geeyo.ofbiz.TestOfbiz" invoke="lookAllRecords" />
<response name="success" type="view" value="listAllTest"/>
</request-map>
<request-map uri="showtest">
<description>Show records</description>
<security https="false" auth="false"/>
<event type="java" path="com.geeyo.ofbiz.TestOfbiz" invoke="findRecord" />
<response name="success" type="view" value="showTest"/>
</request-map>
<request-map uri="createTest">
<security https="true" auth="true"/>
<event type="java" path="com.geeyo.ofbiz.TestOfbiz" invoke="createNewRecord"/>
<response name="success" type="request" value="listtest"/>
<response name="error" type="view" value="createTestForm"/>
</request-map>
<request-map uri="updateTest">
<description>update a record</description>
<security https="false" auth="false"/>
<event type="java" path="com.geeyo.ofbiz.TestOfbiz" invoke="updateRecord" />
<response name="success" type="request" value="listtest"/>
</request-map>
<request-map uri="removetest">
<description>remove a record</description>
<security https="false" auth="false"/>
<event type="java" path="com.geeyo.ofbiz.TestOfbiz" invoke="removeRecord" />
<response name="success" type="request" value="listtest"/>
</request-map>
<view-map name="listAllTest" type="region"/>
<view-map name="createTestForm" type="region"/>
<view-map name="showTest" type="region"/>
>=============================================================================
在 regions.xml 中加入：
>=============================================================================
<define id='createTestForm' region='MAIN_REGION'>
<put section='title'>Create Ofbiz</put>
<put section='content' content='/party/createofbiz.jsp'/>
</define>
<define id='listAllTest' region='MAIN_REGION'>
<put section='title'>List Ofbiz</put>
<put section='content' content='/party/listofbiz.jsp'/>
</define>
<define id='showTest' region='MAIN_REGION'>
<put section='title'>Show Ofbiz</put>
<put section='content' content='/party/showofbiz.jsp'/>
</define>
>=============================================================================
現在就完成了，我們重新啟動 Ofbiz，然后用 IE 訪問：
http://localhost:8080/partymgr/control/listtest，用admin/ofbiz 登錄后就可以
看到我們剛才的工作成果了，你現在可以增加/刪除/修改記錄。
6.Ofbiz 通過 XML 來完成數據庫操作（非常強大的功能）
這是 Ofbiz 的一個非常強大的功能，可能通過簡單的 XML 文件來完成數據增/刪/改的處理，
這些處理在數據庫應用中是非常多的，因為很多需要維護的數據，所以寫程序也是最花時間的，
Ofbiz 把這些操作通過 XML 來完成，不能不說是一大革命---使我們不用寫程序就可以完成大
部分處理，這是每個程序員都向往的終極目標。
我們下面舉例來講述一下，處理的數據還是利用我們前面創建的 StudyCustomer，使用 XML
配置文件來完成前面程序 TestOfbiz.java 的大部分操作。
在 c:\ofbiz\ofbiz\testOfbiz\com\geeyo\ofbiz 目錄下創建文件 TestOfbizServices.xml，
該文件的內容如下：
>=================================================================
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE simple-methods PUBLIC "-//OFBiz//DTD Simple Methods//EN" "http://www.ofbiz.org/dtds/simple-methods.dtd">
<simple-methods>
<!-- TestOfbiz methods -->
<simple-method method-name="createNewRecord" short-description="Create a new record">
<check-permission permission="STUDYCUSTOMER" action="_CREATE"><fail-message message="Security Error: to run createRecord you must have the STUDYCUSTOMER_CREATE permission"/></check-permission> <check-errors/>
<make-value entity-name="StudyCustomer" value-name="newEntity"/>
<set-pk-fields map-name="parameters" value-name="newEntity"/>
<set-nonpk-fields map-name="parameters" value-name="newEntity"/>
<create-value value-name="newEntity"/>
</simple-method>
<simple-method method-name="updateRecord" short-description="Update a record">
<check-permission permission="STUDYCUSTOMER" action="_UPDATE"><fail-message message="Security Error: to run updateRecord you must have the STUDYCUSTOMER_UPDATE permission"/></check-permission>
<check-errors/>
<make-value entity-name="StudyCustomer" value-name="lookupPKMap"/>
<set-pk-fields map-name="parameters" value-name="lookupPKMap"/>
<find-by-primary-key entity-name="StudyCustomer" map-name="lookupPKMap" value-name="lookedUpValue"/>
<set-nonpk-fields map-name="parameters" value-name="lookedUpValue"/>
<store-value value-name="lookedUpValue"/>
</simple-method>
<simple-method method-name="findRecord" short-description="lookup a record">
<check-errors/>
<make-value entity-name="StudyCustomer" value-name="lookupPKMap"/>
<set-pk-fields map-name="parameters" value-name="lookupPKMap"/>
<find-by-primary-key entity-name="StudyCustomer" map-name="lookupPKMap" value-name="edit_cust"/>
<field-to-session field-name="edit_cust"/>
</simple-method>
<simple-method method-name="removeRecord" short-description="Delete a record">
<check-permission permission="STUDYCUSTOMER" action="_DELETE"><fail-message message="Security Error: to run deleteRecord you must have the STUDYCUSTOMER_DELETE permission"/></check-permission>
<check-errors/>
<make-value entity-name="StudyCustomer" value-name="lookupPKMap"/>
<set-pk-fields map-name="parameters" value-name="lookupPKMap"/>
<find-by-primary-key entity-name="StudyCustomer" map-name="lookupPKMap" value-name="lookedUpValue"/>
<remove-value value-name="lookedUpValue"/>
</simple-method>
<simple-method method-name="lookAllRecords" short-description="lookup suitable records">
<check-errors/>
<find-by-and entity-name="StudyCustomer" list-name="search_results"/>
<field-to-session field-name="search_results"/>
</simple-method>
</simple-methods>
>=================================================================
上面的 XML 基本是不用解釋的，定義了
createNewRecord
updateRecord
lookAllRecords
removeRecord
findRecord
這幾個方法，而且都有對用戶權限的檢查，這幾個方法對應于前面 TestOfbiz.java 中的幾個方法，
這樣來做數據庫操作顯然比用 Java 程序寫要簡單得多，
下面還需要在 controller.xml（具體文件得位置請參照前面的教程）更改一下 mapping 的設置，
更改如下，以前使用 TestOfbiz.java 時的配置我以注釋的方式保留著以做參照：
>=================================================================
<request-map uri="createTestForm">
<description>Show the create form</description>
<security https="false" auth="false"/>
<response name="success" type="view" value="createTestForm"/>
</request-map>
<request-map uri="listtest">
<description>List all records</description>
<security https="false" auth="false"/>
<event type="simple" path="com/geeyo/ofbiz/TestOfbizServices.xml" invoke="lookAllRecords" />
<response name="success" type="view" value="listAllTest"/>
</request-map>
<request-map uri="showtest">
<description>Show records</description>
<security https="false" auth="false"/>
<event type="simple" path="com/geeyo/ofbiz/TestOfbizServices.xml" invoke="findRecord" />
<response name="success" type="view" value="showTest"/>
</request-map>
<request-map uri="createTest">
<security https="true" auth="true"/>
<event type="simple" path="com/geeyo/ofbiz/TestOfbizServices.xml" invoke="createNewRecord"/>
<response name="success" type="request" value="listtest"/>
<response name="error" type="view" value="createTestForm"/>
</request-map>
<request-map uri="updateTest">
<description>update a record</description>
<security https="false" auth="false"/>
<event type="simple" path="com/geeyo/ofbiz/TestOfbizServices.xml" invoke="updateRecord" />
<response name="success" type="request" value="listtest"/>
</request-map>
<request-map uri="removetest">
<description>remove a record</description>
<security https="false" auth="false"/>
<event type="simple" path="com/geeyo/ofbiz/TestOfbizServices.xml" invoke="removeRecord" />
<response name="success" type="request" value="listtest"/>
</request-map>
<view-map name="listAllTest" type="region"/>
<view-map name="createTestForm" type="region"/>
<view-map name="testofbiz" type="region"/>
<view-map name="showTest" type="region"/>
>=================================================================
配置該文件的方法請參照前面的教程，regions.xml 不需改動。
配置完后請用前面講過的方法訪問 URL: http://localhost:8080/partymgr/control/listtest
現在我們可以看到，Ofbiz 在 MVC 方面做得非常好，我們可以把后端的處理程序從 java 改
成用 XMl 控制，而其他部分（像 JSP）不需任何改動，這可以保證我們系統各部分的獨立性。