<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>
<!--================================================================================-->
? 這個(gè) XML 文件中的 Tag 基本是看得明白的，只是 field 的 type 是 Ofbiz 已經(jīng)預(yù)定義好的，這
是為了保證數(shù)據(jù)庫(kù)間的遷移。
? 在 entityengine.xml 加入我們剛才定義的文件，加入一行在合適的位置：
?? <resource loader="mainfile" location="entitymodel_study.xml"/>
? 具體放的位置我們可以通過查看 entityengine.xml 找到，里面已經(jīng)有加好的其他文件。
? 在 entitygroup.xml 加入我們的 Schema 定義，在后面加入一行
?? <entity-group group="org.ofbiz.commonapp" entity="StudyCustomer" />
? 這樣我們就定義好了 Schema，現(xiàn)在把 c:\ofbiz\commonapp\etc\entityengine.xml 拷貝到
? c:\ofbiz\catalina\shared\classes 目錄下，這點(diǎn)要切記，我以前就因?yàn)闆]有拷貝，最后 Schema
? 怎么也創(chuàng)建不了。
? 重新啟動(dòng) Ofbiz，訪問 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"，如果沒有，可能是我們前面定義的有些問題，檢查一下再重新做。
? 在檢查到以后，可以再選擇“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)建，我們可以用編輯器打開
? c:\ofbiz\data\ofbiz.script ，在里面查詢 CREATE TABLE StudyCustomer 的字樣，如果前面沒有
? 問題，我們可以找到的。
?
4.如何使用已經(jīng)定義的 Schema
如何使用已經(jīng)定義的 Schema
?? Ofbiz 遵循 MVC 的設(shè)計(jì)模式，在 View 端，即 JSP 端主要使用 Ofbiz 定義的 Tag 來顯示或
?? 提取數(shù)據(jù)，Control 是一個(gè) Controller Servlet，我們?cè)?Controller Servlet 的 URI mapping
?? 配置文件中定義各 URL 應(yīng)該指向什么程序，這樣，通過這個(gè) mapping 配置文件，可以保證我們各個(gè)頁面
?? 及具體處理程序之間的獨(dú)立性，例我們可以通過修改這個(gè)配置文件就可以改變某個(gè) Form 的 Post Action
?? 的 URL，而不需要修改實(shí)際的 HTML 或 JSP 代碼。
?? Ofbiz 中定義了 Regions 的概念，即將一個(gè) HTML 頁面分成幾個(gè)區(qū)域，像 Top, Left, Right, Main
?? 等，通過這些 Regions 我們可以方便的組合 UI 界面，并且可以方便改變各部分所處的位置，如我們可以
?? 把菜單很容易的從上方移到下方，只需要改變一個(gè)配置文件。Regions 類似于 HTML 中的 Frame，但它是
?? 通過一個(gè)頁面來組合界面，F(xiàn)rame 是通過幾個(gè)頁面顯示在不同的幀中，F(xiàn)rame 的控制比較復(fù)雜，而且需要
?? 改變相關(guān)的程序。
?? 在 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 創(chuàng)建一個(gè) Object，該 Object 將會(huì)由 Ofbiz 自動(dòng)同步到
數(shù)據(jù)庫(kù)中。然后通過 delegator 的 findAll 取到所有已保存的 Object，最后通過一個(gè) Iterator 對(duì)象
顯示出來。
? 這個(gè)程序起名為 testofbiz.jsp，為簡(jiǎn)單起見，我們放到 Ofbiz 已有的一個(gè) Webapp 的目錄下，放到
c:\ofbiz\ofbiz\partymgr\webapp\party 目錄下。然后我們需要修改兩個(gè)配置文件：controller.xml
和 regions.xml，這兩個(gè)文件就是我們上面提到的 mapping 和 regions 配置文件。
? 這兩個(gè)文件都在：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"/>
?
? 加入位置請(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，然后訪問 URL:
? http://localhost:8080/partymgr/control/testofbiz
? 由于我們?cè)?testofbiz.jsp 程序中使用了 Ofbiz 的安全控制機(jī)制，系統(tǒng)會(huì)提示現(xià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è)段的值，然后再訪問 http://localhost:8080/partymgr/control/testofbiz，如果不修改
? 而直接訪問那個(gè) URL 時(shí)，系統(tǒng)會(huì)提示 Primary key 沖突。
5.按照顯示與邏輯分離的原則使用 Schema:
? 上篇講了如何在 JSP 中使用創(chuàng)建的 Schema 對(duì)象，這次我們來講述一下如何把程序
邏輯放到 JavaBeans 中，把顯示處理放到 JSP 中，并使用 controller.xml 將兩
部分整合起來。
? 首先我們來創(chuàng)建一個(gè) JavaBeans，來完成Add/Get/Delete/Update Schema 對(duì)象
的操作，程序文件名為 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";
? }
?
}
>=================================================================
程序中的處理大部分可以看懂的，其中有個(gè)功能，是
? Map paras = UtilMisc.getParameterMap(request);
這是 Ofbiz 的一個(gè)有趣但非常有用的功能，它是把 request 中各段的名字和值映射到一個(gè) Map
對(duì)象中，然后使用
? cust.setNonPKFields(paras);
就可以賦給 Object cust 的各個(gè)段，免了我們使用 request.getParameter("name")來取各個(gè)
值，在值很多的時(shí)候這個(gè)功能可以大大減少冗余代碼量。
? 基本程序的邏輯是這樣的，
? 1.從 request 讀取傳來的值
2.使用 delegator 來處理，Add/Update/Delete/Query
? 3.將返回結(jié)果放到 Session 中傳給 JSP
? 我做了個(gè) Ant build.xml 文件可以幫助編譯，把這個(gè)文件放在:
?? c:\ofbiz\ofbiz\testOfbiz\ 目錄下，然后在命令行窗口下進(jìn)入該目錄，敲入 ant
? 來編譯（需要保證已經(jīng)安裝 Ant），編譯后的 .class 會(huì)放在
?? 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>
>=============================================================================
然后我們來創(chuàng)建 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"> 是用來檢驗(yàn)在 session 或 pageContext 對(duì)象
中是否包含 search_results 對(duì)象，該對(duì)象是由我們的程序放到 session 中的。
?<ofbiz:iterator name="cust" property="search_results"> 是用來循環(huán)讀取對(duì)象
search_results（是個(gè) Collection 對(duì)象）中存儲(chǔ)的各對(duì)象，并賦給cust，然后在循環(huán)體
中，我們就可以用 cust 對(duì)象來讀取各個(gè)段的值了。
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>
<%}%>
>=============================================================================
? 這個(gè)程序很容易理解，需要注意的是每個(gè)文本框的名字，要跟 Schema StudyCustomer 的各
個(gè)段一致，以使程序中跟容易處理。
?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>
<%}%>
>=============================================================================
? 這個(gè)程序中，主要是通過
? <ofbiz:entityfield attribute="edit_cust" field="customerId"/>
? 把取到的對(duì)象的段顯示出來, 對(duì)象 edit_cust 是我們?cè)诔绦蛑腥〉讲⒎诺?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>
>=============================================================================
? 現(xiàn)在就完成了，我們重新啟動(dòng) Ofbiz，然后用 IE 訪問：
? http://localhost:8080/partymgr/control/listtest，用admin/ofbiz 登錄后就可以
看到我們剛才的工作成果了，你現(xiàn)在可以增加/刪除/修改記錄。
6.Ofbiz 通過 XML 來完成數(shù)據(jù)庫(kù)操作（非常強(qiáng)大的功能）
? 這是 Ofbiz 的一個(gè)非常強(qiáng)大的功能，可能通過簡(jiǎn)單的 XML 文件來完成數(shù)據(jù)增/刪/改的處理，
這些處理在數(shù)據(jù)庫(kù)應(yīng)用中是非常多的，因?yàn)楹芏嘈枰S護(hù)的數(shù)據(jù)，所以寫程序也是最花時(shí)間的，
Ofbiz 把這些操作通過 XML 來完成，不能不說是一大革命---使我們不用寫程序就可以完成大
部分處理，這是每個(gè)程序員都向往的終極目標(biāo)。
? 我們下面舉例來講述一下，處理的數(shù)據(jù)還是利用我們前面創(chuàng)建的 StudyCustomer，使用 XML
配置文件來完成前面程序 TestOfbiz.java 的大部分操作。
? 在 c:\ofbiz\ofbiz\testOfbiz\com\geeyo\ofbiz 目錄下創(chuàng)建文件 TestOfbizServices.xml，
該文件的內(nèi)容如下：
>=================================================================
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE simple-methods PUBLIC "-//OFBiz//DTD Simple Methods//EN" "
<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è)方法，
這樣來做數(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)用前面講過的方法訪問 URL: http://localhost:8080/partymgr/control/listtest
? 現(xiàn)在我們可以看到，Ofbiz 在 MVC 方面做得非常好，我們可以把后端的處理程序從 java 改
成用 XMl 控制，而其他部分（像 JSP）不需任何改動(dòng)，這可以保證我們系統(tǒng)各部分的獨(dú)立性。
posted on 2006-06-21 21:28
Kent 閱讀(1082)
評(píng)論(1) 編輯 收藏 所屬分類:
other open resources