常言笑的家

1.Ofbiz 介紹：

Ofbiz(http://www.ofbiz.org/) 是 Open Source 的商務(wù)軟件系統(tǒng)，充分利用了各優(yōu)秀的的Open Source 項(xiàng)目，
像 Tomcat, Ant, BeanShell, Jboss 等，構(gòu)建了一個(gè)強(qiáng)大的系統(tǒng)平臺(tái)，Ofbiz 已經(jīng)完成了大部分商務(wù)類軟件系統(tǒng)
都需要的部件，像用戶認(rèn)證、工作流、商務(wù)規(guī)則處理等，Ofbiz 的核心技術(shù)在于 Entity Engine，其他的組件基本都
是基于它的。簡(jiǎn)單來(lái)說(shuō) Entity Engine 的主要功能是將數(shù)據(jù)庫(kù)表創(chuàng)建、對(duì)象與數(shù)據(jù)表的映射、對(duì)象的查詢等做了強(qiáng)大
封裝，你可以在一個(gè)簡(jiǎn)單的 XML 文件中定義數(shù)據(jù)庫(kù)表結(jié)構(gòu)，Ofbiz 會(huì)自動(dòng)幫你在數(shù)據(jù)庫(kù)建表，并動(dòng)態(tài)生成映射對(duì)象，
你在程序中可以只考慮對(duì) Object 的處理，Ofbiz 會(huì)自動(dòng)通過(guò)事務(wù)邏輯更新到數(shù)據(jù)庫(kù)中。Ofbiz 宣稱的優(yōu)點(diǎn)之一是用
很少的 Code 完成復(fù)雜的處理。

2.Ofbiz 下載與安裝

首先要安裝 J2SDK1.4，到 http://java.sun.com/ 上下載，安裝后設(shè)定 JAVA_HOME 環(huán)境變量為 J2SDK 的安裝目錄。

訪問(wèn)網(wǎng)站 http://www.ofbiz.org，上面有下載的連接，請(qǐng)選擇/ Complete 包，因?yàn)檫@個(gè)包中已經(jīng)包含了運(yùn)行 Ofbiz
的所有東西，下載下來(lái)解開(kāi)后就可以運(yùn)行了。

解開(kāi) Ofbiz 包到一個(gè)目錄下，假設(shè)是 “C:ofbiz”，該目錄下將會(huì)有 catalina 和 ofbiz 兩個(gè)目錄， catalina
目錄是 Tomcat 的目錄，Ofbiz 對(duì)其配置做了修改，ofbiz 目錄是 Ofbiz 的程序代碼目錄。在命令行狀態(tài)下進(jìn)入
“c:ofbizcatalinain” 目錄，運(yùn)行“ ofbiz run”命令，就可以啟動(dòng) Ofbiz，啟動(dòng)后你可以用瀏覽器訪問(wèn)
“http://localhost:8080/ecommerce”，這可以訪問(wèn) Ofbiz 的電子商務(wù)模塊，通過(guò)頁(yè)面上面的連接你可以訪問(wèn)到
其他模塊。


3.Ofbiz Schema 的創(chuàng)建

Ofbiz 應(yīng)用入門(mén)：

以一個(gè)實(shí)例說(shuō)明，假設(shè)我們需要建一個(gè)客戶資料表，起名為 StudyCustomer，各個(gè)段分別如下：
StudyCustomer {
customerId Integer,
customerName String,
customerNote String,
}

我們來(lái)實(shí)現(xiàn)基本的數(shù)據(jù)操作---增/刪/改/查詢，具體步驟如下：


1.在 XML 文件中定義數(shù)據(jù) Schema：
需要用到三個(gè)文件，一個(gè)是我們要建的項(xiàng)目的 entitymodel_xxx.xml 和 entityengine.xml，還有
entitygroup.xml,
entitymodel_xxx.xml 是需要我們自己創(chuàng)建的，假設(shè)我們起名為 entitymodel_study.xml，放在
“c:ofbizofbizcommonappentitydef”目錄下，
entityengine.xml 是 Ofbiz 已經(jīng)有的，放在 “c:ofbizcommonappetc”目錄下，用來(lái)包含我們
定義的 entitymodel 文件。
entitygroup.xml 也是 Ofbiz 已經(jīng)有的，跟 engityengine.xml 在同一目錄下，我們需要把我們的
Schema 定義加入到該文件中

entitymodel_study.xml 文件的定義格式如下：
<!--================================================================================-->

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE entitymodel PUBLIC "-//OFBiz//DTD Entity Model//EN"

"" target="_blank">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 - http://feed.bmforum.com/art/month200611/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>

<!--================================================================================-->

這個(gè) XML 文件中的 Tag 基本是看得明白的，只是 field 的 type 是 Ofbiz 已經(jīng)預(yù)定義好的，這
是為了保證數(shù)據(jù)庫(kù)間的遷移。

在 entityengine.xml 加入我們剛才定義的文件，加入一行在合適的位置：
<resource loader="mainfile" location="entitymodel_study.xml"/>
具體放的位置我們可以通過(guò)查看 entityengine.xml 找到，里面已經(jīng)有加好的其他文件。

在 entitygroup.xml 加入我們的 Schema 定義，在后面加入一行
<entity-group group="org.ofbiz.commonapp" entity="StudyCustomer" />

這樣我們就定義好了 Schema，現(xiàn)在把 c:ofbizcommonappetcentityengine.xml 拷貝到
c:ofbizcatalinasharedclasses 目錄下，這點(diǎn)要切記，我以前就因?yàn)闆](méi)有拷貝，最后 Schema
怎么也創(chuàng)建不了。

重新啟動(dòng) Ofbiz，訪問(wèn) URL: http://localhost:8080/webtools，點(diǎn)擊右上方的 "Login" 鏈接，
用 admin/ofbiz 登錄，登錄進(jìn)入后選擇鏈接“Check/Update Database”，這時(shí)會(huì)出現(xiàn) Check 的 Form，
該表單可以只檢驗(yàn) Schema 是否改變，默認(rèn)的 GroupName 是“org.ofbiz.commonapp”，這個(gè)不需要變，
點(diǎn)擊“Check Only”按鈕，Ofbiz 會(huì)檢驗(yàn)變動(dòng)情況，顯示出一個(gè)完整的列表，你可以查一下是否有我們剛建的
"StudyCustomer"，如果沒(méi)有，可能是我們前面定義的有些問(wèn)題，檢查一下再重新做。

在檢查到以后，可以再選擇“Check and Add Missing”，這是 Ofbiz 很強(qiáng)大的一個(gè)功能，你在 XML 中新
增了表，或在某個(gè)表中新增了段，它會(huì)自動(dòng)映射到數(shù)據(jù)庫(kù)中，避免我們?nèi)ブ苯硬僮鲾?shù)據(jù)庫(kù)。

現(xiàn)在已經(jīng)完成了 StudyCustomer Schema 的創(chuàng)建,如果想檢驗(yàn)一下是否有表創(chuàng)建，我們可以用編輯器打開(kāi)
c:ofbizdataofbiz.script ，在里面查詢 CREATE TABLE StudyCustomer 的字樣，如果前面沒(méi)有
問(wèn)題，我們可以找到的。



4.如何使用已經(jīng)定義的 Schema

如何使用已經(jīng)定義的 Schema

Ofbiz 遵循 MVC 的設(shè)計(jì)模式，在 View 端，即 JSP 端主要使用 Ofbiz 定義的 Tag 來(lái)顯示或
提取數(shù)據(jù)，Control 是一個(gè) Controller Servlet，我們?cè)?Controller Servlet 的 URI mapping
配置文件中定義各 URL 應(yīng)該指向什么程序，這樣，通過(guò)這個(gè) mapping 配置文件，可以保證我們各個(gè)頁(yè)面
及具體處理程序之間的獨(dú)立性，例我們可以通過(guò)修改這個(gè)配置文件就可以改變某個(gè) Form 的 Post Action
的 URL，而不需要修改實(shí)際的 HTML 或 JSP 代碼。

Ofbiz 中定義了 Regions 的概念，即將一個(gè) HTML 頁(yè)面分成幾個(gè)區(qū)域，像 Top, Left, Right, Main
等，通過(guò)這些 Regions 我們可以方便的組合 UI 界面，并且可以方便改變各部分所處的位置，如我們可以
把菜單很容易的從上方移到下方，只需要改變一個(gè)配置文件。Regions 類似于 HTML 中的 Frame，但它是
通過(guò)一個(gè)頁(yè)面來(lái)組合界面，F(xiàn)rame 是通過(guò)幾個(gè)頁(yè)面顯示在不同的幀中，F(xiàn)rame 的控制比較復(fù)雜，而且需要
改變相關(guān)的程序。

在 Ofbiz 中，我們可以直接在 JSP 中操作 Schema 定義的 Object，即我們剛定義的 StudyCustomer，
示例如下：


<% at taglib uri="ofbizTags" prefix="ofbiz" %>

<%@ page import="java dot util.*" %>
<% at page import="org dot ofbiz.core.util.*, org.ofbiz.core.pseudotag.*" %>
<% at page import="org dot 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>
<% }%>


這段程序挺容易理解，先是通過(guò) delegator 創(chuàng)建一個(gè) Object，該 Object 將會(huì)由 Ofbiz 自動(dòng)同步到
數(shù)據(jù)庫(kù)中。然后通過(guò) delegator 的 findAll 取到所有已保存的 Object，最后通過(guò)一個(gè) Iterator 對(duì)象
顯示出來(lái)。

這個(gè)程序起名為 testofbiz.jsp，為簡(jiǎn)單起見(jiàn)，我們放到 Ofbiz 已有的一個(gè) Webapp 的目錄下，放到
c:ofbizofbizpartymgrwebappparty 目錄下。然后我們需要修改兩個(gè)配置文件：controller.xml
和 regions.xml，這兩個(gè)文件就是我們上面提到的 mapping 和 regions 配置文件。

這兩個(gè)文件都在：c:ofbizofbizpartymgrwebappWEB-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"/>

加入位置請(qǐng)參照 controller.xml 中已經(jīng)有的配置。在 regions.xml 中加入：
<define id='testofbiz' region='MAIN_REGION'>
<put section='title'>Test Ofbiz</put>
<put section='content' content='/party/testofbiz.jsp'/>
</define>
具體加入位置請(qǐng)參考已有的配置。

配置完后，重新啟動(dòng) ofbiz，然后訪問(wèn) URL:
http://localhost:8080/partymgr/control/testofbiz

由于我們?cè)?testofbiz.jsp 程序中使用了 Ofbiz 的安全控制機(jī)制，系統(tǒng)會(huì)提示現(xiàn)在沒(méi)有訪問(wèn)
權(quán)限，需要登錄，點(diǎn)擊右邊的“Login” 用 admin/ofbiz 登錄后會(huì)看到我們程序 testofbiz.jsp
的運(yùn)行結(jié)果。如果需要增加新記錄，請(qǐng)修改

UtilMisc.toMap("customerId","1","customerName","Cust1","customerNote","Customer Note 1"));

中的各個(gè)段的值，然后再訪問(wèn) http://localhost:8080/partymgr/control/testofbiz，如果不修改
而直接訪問(wèn)那個(gè) URL 時(shí)，系統(tǒng)會(huì)提示 Primary key 沖突。


5.按照顯示與邏輯分離的原則使用 Schema:

上篇講了如何在 JSP 中使用創(chuàng)建的 Schema 對(duì)象，這次我們來(lái)講述一下如何把程序
邏輯放到 JavaBeans 中，把顯示處理放到 JSP 中，并使用 controller.xml 將兩
部分整合起來(lái)。

首先我們來(lái)創(chuàng)建一個(gè) JavaBeans，來(lái)完成Add/Get/Delete/Update Schema 對(duì)象
的操作，程序文件名為 TestOfbiz.java，放置在
c:ofbizofbiz estOfbizcomgeeyoofbiz 目錄下, 具體程序如下：

>=================================================================
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";
}

}


>=================================================================


程序中的處理大部分可以看懂的，其中有個(gè)功能，是
Map paras = UtilMisc.getParameterMap(request);
這是 Ofbiz 的一個(gè)有趣但非常有用的功能，它是把 request 中各段的名字和值映射到一個(gè) Map
對(duì)象中，然后使用
cust.setNonPKFields(paras);
就可以賦給 Object cust 的各個(gè)段，免了我們使用 request.getParameter("name")來(lái)取各個(gè)
值，在值很多的時(shí)候這個(gè)功能可以大大減少冗余代碼量。

基本程序的邏輯是這樣的，
1.從 request 讀取傳來(lái)的值
 2.使用 delegator 來(lái)處理，Add/Update/Delete/Query
3.將返回結(jié)果放到 Session 中傳給 JSP

我做了個(gè) Ant build.xml 文件可以幫助編譯，把這個(gè)文件放在:
c:ofbizofbiz estOfbiz 目錄下，然后在命令行窗口下進(jìn)入該目錄，敲入 ant
來(lái)編譯（需要保證已經(jīng)安裝 Ant），編譯后的 .class 會(huì)放在
c:ofbizofbiz estOfbizcomgeeyoofbiz 下，
拷貝 c:ofbizofbiz estofbizcom 目錄到 c:ofbizofbizpartymgrwebappWEB-INFclasses
目錄下。

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>


>=============================================================================

然后我們來(lái)創(chuàng)建 JSP 程序，JSP 程序全部放在
c:ofbizofbizpartymgrwebappparty 下面

1.listofbiz.jsp
>=============================================================================

<% at taglib uri="ofbizTags" prefix="ofbiz" %>

<%@ page import="java dot util.*, org.ofbiz.core.service.ModelService" %>
<% at page import="org dot ofbiz.core.util.*, org.ofbiz.core.pseudotag.*" %>
<% at page import="org dot 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>
<% }%>

>=============================================================================

上面程序中需要說(shuō)明的是
<ofbiz:if name="search_results">
和
<ofbiz:iterator name="cust" property="search_results">，

<ofbiz:if name="search_results"> 是用來(lái)檢驗(yàn)在 session 或 pageContext 對(duì)象
中是否包含 search_results 對(duì)象，該對(duì)象是由我們的程序放到 session 中的。
<ofbiz:iterator name="cust" property="search_results"> 是用來(lái)循環(huán)讀取對(duì)象
search_results（是個(gè) Collection 對(duì)象）中存儲(chǔ)的各對(duì)象，并賦給cust，然后在循環(huán)體
中，我們就可以用 cust 對(duì)象來(lái)讀取各個(gè)段的值了。


2.createofbiz.jsp
>=============================================================================

<% at taglib uri="ofbizTags" prefix="ofbiz" %>

<%@ page import="java dot util.*, org.ofbiz.core.service.ModelService" %>
<% at page import="org dot ofbiz.core.util.*, org.ofbiz.core.pseudotag.*" %>
<% at page import="org dot 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>
<% }%>
>=============================================================================

這個(gè)程序很容易理解，需要注意的是每個(gè)文本框的名字，要跟 Schema StudyCustomer 的各
個(gè)段一致，以使程序中跟容易處理。

3.showofbiz.jsp
>=============================================================================

<% at taglib uri="ofbizTags" prefix="ofbiz" %>

<%@ page import="java dot util.*, org.ofbiz.core.service.ModelService" %>
<% at page import="org dot ofbiz.core.util.*, org.ofbiz.core.pseudotag.*" %>
<% at page import="org dot 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>
<% }%>

>=============================================================================

這個(gè)程序中，主要是通過(guò)
<ofbiz:entityfield attribute="edit_cust" field="customerId"/>
把取到的對(duì)象的段顯示出來(lái), 對(duì)象 edit_cust 是我們?cè)诔绦蛑腥〉讲⒎诺?session 中的。

下面我們來(lái)配置 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>

>=============================================================================

現(xiàn)在就完成了，我們重新啟動(dòng) Ofbiz，然后用 IE 訪問(wèn)：
http://localhost:8080/partymgr/control/listtest，用admin/ofbiz 登錄后就可以
看到我們剛才的工作成果了，你現(xiàn)在可以增加/刪除/修改記錄。


6.Ofbiz 通過(guò) XML 來(lái)完成數(shù)據(jù)庫(kù)操作（非常強(qiáng)大的功能）

這是 Ofbiz 的一個(gè)非常強(qiáng)大的功能，可能通過(guò)簡(jiǎn)單的 XML 文件來(lái)完成數(shù)據(jù)增/刪/改的處理，
這些處理在數(shù)據(jù)庫(kù)應(yīng)用中是非常多的，因?yàn)楹芏嘈枰S護(hù)的數(shù)據(jù)，所以寫(xiě)程序也是最花時(shí)間的，
Ofbiz 把這些操作通過(guò) XML 來(lái)完成，不能不說(shuō)是一大革命---使我們不用寫(xiě)程序就可以完成大
部分處理，這是每個(gè)程序員都向往的終極目標(biāo)。

我們下面舉例來(lái)講述一下，處理的數(shù)據(jù)還是利用我們前面創(chuàng)建的 StudyCustomer，使用 XML
配置文件來(lái)完成前面程序 TestOfbiz.java 的大部分操作。

在 c:ofbizofbiz estOfbizcomgeeyoofbiz 目錄下創(chuàng)建文件 TestOfbizServices.xml，
該文件的內(nèi)容如下：

>=================================================================

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE simple-methods PUBLIC "-//OFBiz//DTD Simple Methods//EN" "" target="_blank">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

這幾個(gè)方法，而且都有對(duì)用戶權(quán)限的檢查，這幾個(gè)方法對(duì)應(yīng)于前面 TestOfbiz.java 中的幾個(gè)方法，
這樣來(lái)做數(shù)據(jù)庫(kù)操作顯然比用 Java 程序?qū)懸?jiǎn)單得多，

下面還需要在 controller.xml（具體文件得位置請(qǐng)參照前面的教程）更改一下 mapping 的設(shè)置，
更改如下，以前使用 TestOfbiz.java 時(shí)的配置我以注釋的方式保留著以做參照：

>=================================================================

<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"/>

>=================================================================

配置該文件的方法請(qǐng)參照前面的教程，regions.xml 不需改動(dòng)。

配置完后請(qǐng)用前面講過(guò)的方法訪問(wèn) URL: http://localhost:8080/partymgr/control/listtest

現(xiàn)在我們可以看到，Ofbiz 在 MVC 方面做得非常好，我們可以把后端的處理程序從 java 改
成用 XMl 控制，而其他部分（像 JSP）不需任何改動(dòng)，這可以保證我們系統(tǒng)各部分的獨(dú)立性。

http://www.cnpoint.com/mvnforum/mvnforum/viewthread?thread=65