- 論壇徽章:
- 0
|
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，
示例如下：
<%@ 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>
<%}%>
這段程序挺容易理解，先是通過(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:\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，然后訪問(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:\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")來(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:\ofbiz\ofbiz\testOfbiz\ 目錄下，然后在命令行窗口下進(jìn)入該目錄，敲入 ant
來(lái)編譯（需要保證已經(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>
>=============================================================================
然后我們來(lái)創(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>
<%}%>
>=============================================================================
上面程序中需要說(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
>=============================================================================
<%@ 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è)程序中，主要是通過(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)在可以增加/刪除/修改記錄。 |
|
免費(fèi)注冊(cè)
發(fā)表于 2010-07-16 14:43