<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" "
<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）不需任何改動，這可以保證我們系統各部分的獨立性。
posted on 2006-06-21 21:28
Kent 閱讀(1082)
評論(1) 編輯 收藏 所屬分類:
other open resources