Jdon應用系統案例開發

jdon官方網站：http://www.jdon.com/jdonframework/app.htm

幾乎大部分軟件系統都有下面兩個基本功能:

  1. 新增/查詢/修改/刪除(CRUD);
  2. 批量查詢和分頁顯示

本文Step By Step詳細講解如何使用Jdon框架基于領域模型快速開發這兩個功能，通過Jdon框架的可以快速完成系統原型(ArcheType)，使得開發者將真正精力集中在每個項目系統的特殊業務處理。

本文檔源碼下載

增刪改查(CRUD)和批量分頁查詢是每個系統的基本功能，下面分這兩部分描述。

CRUD開發步驟

說明：每個應用系統中存在大量重復的CRUD開發流程，通過本框架可快速完成這些基本基礎工作量，將精力集中在特殊功能設計上。 CRUD快速開發主要簡化了表現層的流程，將其固化，或者是模板化，以配置替代代碼編制，靈活而快速。每個Model一套固化CRUD流程。

CRUD開發步驟分兩個部分：代碼編寫 、配置。

CRUD代碼：

代碼只需要三步：
1、域建模：建立sample.model.Message，如下：

public class Message extends Model {
???private Long messageId;
???private String name;

???public String getName() { return name; }
???public void setName(String name) { this.name = name; }

???.......
}

注意點：

  • 模型類Message必須繼承框架的com.jdon.controller.model.Model，或者實現com.jdon.controller.model.ModelIF接口。
  • 該模型類必須有一個能夠標識其對象唯一性的主鍵，如messageId，這個主鍵相當于數據表的主鍵。

2、建立Model組件服務：首先建立模型Message的服務接口sample.service. MessageService：

public interface MessageService {
???void createMessage(EventModel em);
???void updateMessage(EventModel em);
?? void deleteMessage(EventModel em);
?? Message getMessage(String messageId);
}

至于MessageService的具體實現子類可以在現在或者以后建立，可見源碼包中的sample.service.MessageServiceImp.

3、建立Model的表現層邊界模型：sample.web.MessageForm，必須繼承框架的ModelForm，如下：

public class MessageForm extends ModelForm {

???private String messageId;
???private String name;

???public String getName() { return name; }
???public void setName(String name) { this.name = name; }
}

表現層MessageForm內容基本上是從業務層模型Message類中拷貝過來的，主要是為了保持MessageForm和Message的字段一致，我們就可以通過框架內MessageForm和Message的相同字段的復制進行數據傳送，將業務層的Message數據傳送到表現層MessageForm；或將界面表現層MessageForm傳送到Message中。

一個模型Message有關CRUD實現的代碼工作到此結束，如果有其他模型，完全按照上述三個步驟再做一次，是不是不太費腦筋？有點模板化開發味道？下面談談CRUD實現第二組成部分：

CRUD配置：

兩個配置文件分別是：

  • 將前面三步編寫的類建立關系：jdonframework.xml
  • 配置界面流程：struts-config.xml

一、Jdon框架配置文件

首先我們將前面三步編寫的三個類：模型Message、服務MessageService和界面模型MessageForm建立起聯系，也就是告訴Jdon框架這三者是解決一個模型增刪改查CRUD功能實現的。 由于這個配置文件是告訴Jdon框架的，因此，我們取名為jdonframework.xml，當然你也可以取其他名稱，無論取什么名稱，都要告訴Jdon框架，在struts-config.xml中配置:

<plug-in className="com.jdon.strutsutil.InitPlugIn">
???<set-property property="modelmapping-config" ???????????????????????????value="jdonframework.xml" />
</plug-in>

jdonframework.xml配置內容如下：


<models>
<!-- the Model class is sample.model.Message, and the primary key of the Model class is messageId -->
???<model key="messageId" class ="sample.model.Message">
??????<!-- configuration about UI Form: MessageForm -->
??????<actionForm name="messageForm"/>
?????????<handler>
????????????<!-- configuration about the Model service : MessageService -->
????????????<service ref="messageService">
????????????<getMethod name="getMessage" />
????????????<createMethod name="createMessage" />
????????????<updateMethod name="updateMessage" />
????????????<deleteMethod name="deleteMessage" />
?????????</service>
???????</handler>
???</model>

???......
</models>
<services>
???<!-- the Ioc configuration about MessageService -->
???<pojoService name="messageService" class="sample.service.MessageServiceImp"/>

???......
</services>

以上配置是配置模型Message、模型服務MessageService和界面模型MessageForm三者關系的，下面詳細說明三個部分的配置：

1、模型Message的配置：
這是通過第一行中的class值來指定當前Model是sample.model.Message：

<model key="messageId" class ="sample.model.Message">

其中，Message模型的主鍵是messageId，這個messageId必須是Message類的一個字段；同時是用來唯一標識唯一的Message模型對象，也就是Object ID，或者可以認為是模型Message對應的數據表message的主鍵。

2、界面模型MessageForm配置：

<actionForm name="messageForm"/>

可能你已經注意到：這里并沒有寫界面模型完整類：sample.web.MessageForm，而好像是MessageForm類的名稱messageForm。 那么配置中messageForm名稱是從哪里來的呢？是struts-config.xml中ActionForm定義名稱，如下：

<struts-config>
???<form-beans>???
??????<form-bean name="messageForm" ???????????????????????????type="sample.web.MessageForm" />
??????……
???</form-beans>
…..
</struts-config>

可見我們的界面模型完整類sample.web.MessageForm是在struts-config.xml中form-beans中配置，并且命名為messageForm，而這個messageForm就是jdonframework.xml中的messageForm。

3、模型服務MessageService配置：
在jdonframework.xml中首先申明MessageService完整實現是類sample.service.MessageServiceImp，并且取名為messageService：
<pojoService name="messageService" class="sample.service.MessageServiceImp"/>
這樣，我們就可以詳細將我們自己編寫的messageService的CRUD方法名告訴Jdon框架了：


<handler>
???<!-- this will refer to service: messageService-->???
???<service ref="messageService">

?????????<!--getMessage is the method name of MessageService -->
?????????<getMethod name="getMessage" />

?????????<!--createMessage is the method name of MessageService -->
?????????<createMethod name="createMessage" />

?????????<!--updateMessage is the method name of MessageService -->
?????????<updateMethod name="updateMessage" />

????????? <!--deleteMessage is the method name of MessageService -->
?????????<deleteMethod name="deleteMessage" />

????? </service>
</handler>

黑體字部分正是messageService所指的類sample.service.MessageServiceImp所繼承的接口sample.service. MessageService四個方法，可見前面代碼步驟第二步。

二、界面流程配置

界面流程主要是配置CRUD界面流程，Jdon框架CRUD流程主要分兩個部分：第一是推出供用戶新增修改刪除的頁面；第二是接受用戶提交新增修改過的數據，以便遞交到業務層保存。
這部分配置主要是配置struts-config.xml：
1、配置推出CRUD頁面流程：


<action name="messageForm" path="/messageAction" ?????????type="com.jdon.strutsutil.ModelViewAction"
?????????scope="request" validate="false">
??????????????????<forward name="create" path="/message.jsp" />
??????????????????<forward name="edit" path="/message.jsp" />
</action>

其中com.jdon.strutsutil.ModelViewAction是Jdon框架類。只要客戶端瀏覽器調用http://localhost:8080/messageAction.do，通過上述配置將激活forward的name=”create”流程，就能得到一個空白表單的頁面message.jsp；如果客戶端瀏覽器調用http://localhost:8080/messageAction.do?action=edit&messageId=18，通過上述配置將激活forward name=”edit”流程，得到一個填滿數據的表單頁面，供用戶修改。

2、配置：接受用戶提交新增修改過的數據，以便遞交到業務層保存：


<html:form action="/messageSaveAction.do" method="POST" >

<html:hidden property="action"/> <!-- this is a rule -->

MessageId：<html:text property="messageId"/>
<br>Name：<html:text property="name"/>
<br><html:submit property="submit" value="Submit"/>
</html:form>

其實在上一步的message.jsp中已經使用到這一步的配置，在message.jsp的表單action值就是本步配置的path值：/messageSaveAction.do：


<action name="messageForm" path="/messageSaveAction" ????????type="com.jdon.strutsutil.ModelSaveAction"
????????scope="request" validate="true" input="/message.jsp">
????????????????<forward name="success" path="/result.jsp" />
????????????????<forward name="failure" path="/result.jsp" />
</action>

在上面message.jsp中一定要有<html:hidden property="action"/>一行。至此，模型Message的CRUD功能開發完畢。

?

?

批量分頁查詢實現

批量分頁查詢開發步驟也分兩個部分：代碼編寫 、配置。

批量查詢代碼實現：

代碼也分三步實現。
1、表現層編寫一個查詢Action，繼承Jdon框架的com.jdon.strutsutil.ModelListAction，該類名稱為sample.web. MessageListAction，完成getPageIterator和findModelByKey兩個方法。
其中getPageIterator方法內容是業務層MessageService的調用：


MessageService messageService = (MessageService) ?????????????????????????????????WebAppUtil.getService("messageService",request);
return messageService.getAllMessages(start, count);

所以MessageService接口中必須有getAllMessages這個方法，主要功能是返回PageIterator對象
findModelByKey方法內容也是業務層MessageService的調用：


MessageService messageService = (MessageService) ???????????????????????????????WebAppUtil.getService("messageService", request);
return messageService.getMessage((String)key);

essageService接口中必須有getMessage方法。

2、業務層實現MessageService接口方法getAllMessages內容，一般是直接調用持久層MessageDao方法。

3、持久層實現返回PageIterator對象：


public PageIterator getMessages(int start, int count) throws Exception {
????????String GET_ALL_ITEMS_ALLCOUNT =
??????????????? "select count(1) from testmessage ";
????????String GET_ALL_ITEMS =
???????????????"select messageId from testmessage ";
????????return pageIteratorSolver. getPageIterator (GET_ALL_ITEMS_ALLCOUNT,?GET_ALL_ITEMS, "",start, count);
}

如果有參數，可以如下查詢：


public PageIterator getMessages(Long categoryId, int start, int count) {
???????String GET_ALL_ITEMS_ALLCOUNT =
??????????????????"select count(1) from message where categoryId = ? ";
???????String GET_ALL_ITEMS =
???????????????????"select messageId from message where categoryId = ? ";
???????Collection params = new ArrayList(1);
???????params.add(categoryId);//paramters will be put into Collection
???????return pageIteratorSolver.getPageIterator(GET_ALL_ITEMS_ALLCOUNT, ?????????????????????????????????????????????????GET_ALL_ITEMS, params, start, count);
}

批量查詢配置

一、Jdon框架配置文件

本步驟主要是需要告訴jdonframework.xml我們的MessageService實現子類是什么，以及調用的MessageDao等組件，jdonframework.xml如下：


<services>
???????<pojoService name="messageService" ??????????????????????????????class="sample.service.MessageServiceImp"/>
???????<component name="messageDAO" ??????????????????????????????class="sample.dao.MessageDAO"/>
???????<component name="constants" class="sample.Constants">
??????????????<constructor value="java:/TestDS"/>
???????</component>
</services>

因為MessageServiceImp類中調用了MessageDAO，MessageDAO中又涉及JNDI名稱，所以它們之間依賴關系靠Jdon框架的IOC容器實現。MessageServiceImp必須有構造器如下：


public class MessageServiceImp implements MessageService{

???????private MessageDAO messageDAO;

???????public MessageServiceImp(MessageDAO messageDAO){

??????????????this.messageDAO = messageDAO;

???????}

}

二、界面流程配置

這一步主要是struts-config.xml配置，和通常struts的ActionForm和Action配置類似：


<form-beans>
……
<form-bean name="listForm" type="com.jdon.strutsutil.ModelListForm" />
</form-beans>

其中com.jdon.strutsutil.ModelListForm是框架批量查詢特別使用的類。


<action name="listForm" path="/messageListAction"
???????type="sample.web.MessageListAction" scope="request">
??????????????<forward name="success" path="/messageList.jsp" />
</action>

其中sample.web.MessageListAction是我們前面代碼編寫部分編寫的代碼。這樣，客戶端瀏覽器通過http://localhost:8080/ messageListAction.do就可以實現所有Message批量分頁查詢顯示。
注意，messageList.jsp中編碼和通常Struts的Jsp編碼是一樣的，需要使用logic:iterator從ActionForm為listForm的list字段中獲取單個的Message對象，然后顯示這些單個Message對象,，如下：


<logic:iterate indexId="i" id="message" name="listForm" property="list" >

???????<bean:write name="message" property="name" />

???????.........

</logic:iterate

在messageList.jsp中加入下面標簽庫可以自動顯示多頁，缺省一個頁面顯示30個條目。


<MultiPages:pager actionFormName="listForm" ??????page="/messageListAction.do">

???????<MultiPages:prev name="[Prev ]" />
???????<MultiPages:index displayCount="1" />
???????<MultiPages:next name="[Next ]" />
</MultiPages:pager>

模型Message的批量查詢功能已經全部完成。

?

以上是介紹基于開源Jdon框架開發軟件系統中的CRUD和批量查詢功能步驟，遵循模板化開發，開發人員使用起來輕松而不容易出錯，適合軟件生產和嚴格的項目管理。