
JessMA(原名:Portal-Basic)是由 JessMA Open Source 開發(fā)的一套高效 Java Full-Stack Web 應(yīng)用開發(fā)框架,內(nèi)置可擴展的 MVC Web 基礎(chǔ)架構(gòu)和 DAO 數(shù)據(jù)庫訪問組件(內(nèi)部已提供了 Hibernate、MyBatis 與 JDBC DAO 組件),集成了 Action 攔截、Form / Dao / Spring Bean 裝配、國際化、文件上傳下載和頁面靜態(tài)化等基礎(chǔ) Web 應(yīng)用組件,提供高效靈活的純 Jsp/Servlet API 編程模型,可完美整合 Spring,支持 Action Convention,能快速開發(fā)傳統(tǒng)風(fēng)格和 RESTful 風(fēng)格應(yīng)用程序,文檔和示例完善,非常容易學(xué)習(xí)。
JessMA 官方網(wǎng)站:http://www.jessma.org
JessMA 下載地址:https://code.google.com/p/portal-basic/
JessMA 在線示例:http://demo.jessma.org
JessMA 在線 API 文檔:http://www.jessma.org/doc/
JessMA在設(shè)計之初就充分注重功能、性能與使用體驗。JessMA主要特點:
★ 功能全面:內(nèi)置穩(wěn)定高效的MVC基礎(chǔ)架構(gòu)和DAO框架,支持Action攔截、Form Bean / Dao Bean / Spring Bean裝配和聲明式事務(wù),提供國際化、文件上傳下載、緩存和頁面靜態(tài)化等常用Web組件,能滿足絕大部分Web應(yīng)用的需要。
★ 高度擴展:JessMA通過的plug-in機制可以靈活擴展,JessMA發(fā)布包中自帶的jessma-ext-rest和jessma-ext-spring均以插件的形式提供,用戶可根據(jù)需要加載或卸載這些插件。應(yīng)用程序開發(fā)者也可以根據(jù)實際需要編寫自定義插件來擴展JessMA。
★ 強大的整合能力:JessMA是一個Full-Stack框架,同時也是一個開放式框架,可以以非常簡單的方式整合第三方組件。本開發(fā)手冊會詳細闡述如何在JessMA中整合FreeMarker、Velocity、UrlRewrite、EHCache-Web、Spring、Hibernate和MyBaits等常用框架和組件。
★ 高性能:性能要求是JessMA的硬性指標(biāo),從每個模塊的設(shè)計到每行代碼的實現(xiàn)都力求簡潔高效。另外,JessMA并沒有對JSP/Servet API進行過多封裝,開發(fā)者仍然使用JSP/Servet API開發(fā)應(yīng)用程序,沒有過多的迂回,性能得到保證。
★ 優(yōu)秀的使用體驗:JessMA的設(shè)計目標(biāo)之一是提供良好的開發(fā)體驗,盡量減少應(yīng)用程序開發(fā)者的工作,API的設(shè)計力求簡單、完整、明確。同時,JessMA為應(yīng)用開發(fā)提供了大量Util工具,用來處理應(yīng)用程序開發(fā)過程中通常會遇到的一般性問題,進一步減少應(yīng)用程序開發(fā)者的工作負擔(dān)。
★ 平緩的學(xué)習(xí)曲線:平緩的學(xué)習(xí)曲線:學(xué)習(xí)使用JessMA只需掌握一定的Core Java與JSP/Servlet知識,本開發(fā)手冊會循序漸進闡述每個知識點,每個知識點都會結(jié)合完整的示例進行講述,知識點之間前后呼應(yīng),確保學(xué)習(xí)者在學(xué)習(xí)時溫故知新,融會貫通。
★ 完善的技術(shù)支持:除了提供完善的開發(fā)手冊和示例代碼以外,還提供博客和Q~Q~群用于解答使用JessMA過程中碰到的所有問題,也可以訪問 JessMA 官方網(wǎng)站了解更多資訊。
* JessMA 總體架構(gòu)

JessMA主要包括以下5個部分:
● 基礎(chǔ)應(yīng)用框架
基礎(chǔ)應(yīng)用框架加載應(yīng)用程序配置文件(默認:app-config.xml),監(jiān)聽?wèi)?yīng)用程序的生命周期事件,并向上層應(yīng)用發(fā)送應(yīng)用程序啟動和關(guān)閉通知,應(yīng)用程序可以處理這些通知進行額外的初始化或清理工作。基礎(chǔ)應(yīng)用框架在org.jessma.app包中是實現(xiàn)。
● MVC框架
MVC框架加載MVC配置文件(默認:mvc-config.xml),通過前端控制器ActionDispatcher接收和解析所有的客戶HTTP請求,然后交由相應(yīng)的Action進行處理,最后生成相應(yīng)的視圖返回給客戶端。MVC框架在org.jessma.mvc包中實現(xiàn)。
● DAO框架
DAO框架封裝了所有的數(shù)據(jù)庫訪問操作,內(nèi)置JDBC、Hibernate和MyBaits數(shù)據(jù)庫訪問組件以及Druid、Proxool、JNDI等連接池。DAO框架是可擴展的,用戶可以通過擴展org.jessma.dao.AbstractFacade和org.jessma.dao.AbstractSessionMgr實現(xiàn)自己的數(shù)據(jù)庫訪問組件。DAO框架在以下包中實現(xiàn):
▪ org.jessma.dao
▪ org.jessma.dao.hbn
▪ org.jessma.dao.jdbc
▪ org.jessma.dao.mybatis
▪ org.jessma.ext.dao
● 公共組件
公共組件提供多種通用功能幫助類(如:字符串處理、類型轉(zhuǎn)換、分頁算法、壓縮/解壓、加解密、郵件發(fā)送等),這些類與框架無關(guān),可在任何應(yīng)用程序中使用。公共組件在以下包中實現(xiàn):
▪ org.jessma.util
▪ org.jessma.util.archive
▪ org.jessma.util.cache
▪ org.jessma.util.http
▪ org.jessma.util.mail
▪ org.jessma.dao(DAO框架也可由看作為一個相對較大的公共組件)
● 擴展插件
擴展差插件是基于JessMA核心框架基礎(chǔ)上的功能延伸,不是JessMA的必要組件。可由應(yīng)用程序開發(fā)人員根據(jù)需要自行定制。JessMA發(fā)行包中也自帶了一些擴展插件(如:jessma-ext-spring和jessma-ext-rest)。
* JessMA 應(yīng)用程序依賴關(guān)系

基礎(chǔ)應(yīng)用框架、MVC框架和DAO框架都依賴于公共組件,其中基礎(chǔ)應(yīng)用框架同時依賴于DAO框架,因此,MVC框架和DAO框架能脫離JessMA單獨使用(當(dāng)然,要附帶上公共組件)。例如:可以把MVC框架和DAO框架用于JessMA之外的其它Web項目;也可以把DAO框架用于非Web項目(如:Swing / SWT桌面應(yīng)用)。
JessMA 3.2.2 更新:
(注:本次更新的主要內(nèi)容是升級 DAO 組件)
1、org.jessma.dao.hbn.HibernateSessionMgr 支持自動掃描實體對象
1) 實體對象用 @Entity 注解取代 *.hbm.xml 映射文件(同時也不必在 hibernate.cfg.xml 中配置 ‘mapping’)
2) app-config.xml 中配置 HibernateSessionMgr 時,用第二個可選參數(shù)以正則表達式的格式指定實體對象所在包
(例如:實體對象位于 ‘com.bruce.<任意子包>.model’ 中)
<manager name="mgr-1" class="org.jessma.dao.hbn.HibernateSessionMgr">
<initialize-args>
<arg></arg>
<arg>com\.bruce\..+\.model</arg>
</initialize-args>
</manager>
2、org.jessma.dao.mybatis.MyBatisSessionMgr 支持自動掃描 SQL Mapper 接口
1) 不必在 mybatis.cfg.xml 中配置 ‘mapper’
2) app-config.xml 中配置 MyBatisSessionMgr 時,用第三個可選參數(shù)以正則表達式的格式指定 SQL Mapper 接口所在包
(例如:SQL Mapper 接口位于 ‘com.bruce.<任意子包>.mapper’ 中)
<manager name="mgr-2" class="org.jessma.dao.mybatis.MyBatisSessionMgr">
<initialize-args>
<arg></arg>
<arg></arg>
<arg>com\.bruce\..+\.mapper</arg>
</initialize-args>
</manager>
3、所有 JDBC Session Manager 均取消 ‘isXml’ 配置參數(shù),改為根據(jù)配置文件的擴展名自動識別配置文件類型
1) 受影響的 Session Manager:DruidSessionMgr、JdbcSessionMgr、JndiSessionMgr、ProxoolSessionMgr
4、org.jessma.dao.FacadeProxy 增加方法 executeCustomTransaction(...) 支持執(zhí)行自定義事務(wù)
1) JessMA 的事務(wù)是 DAO 層事務(wù),也就是說當(dāng)外部調(diào)用某個 DAO 方法時,該方法作為一個事務(wù)單元執(zhí)行。 但在一些特殊情形下可能需要在 DAO 外部執(zhí)行 Service 層事務(wù)(例如:事務(wù)需要調(diào)用多個 DAO 對象的多個方法), 此時需要創(chuàng)建一個自定義事務(wù)(CustomTransaction),并調(diào)用 FacadeProxy 的 executeCustomTransaction(...) 來執(zhí)行該自定義事務(wù)。
2) 增加自定義事務(wù)相關(guān)接口:
A) CustomTransaction : 自定義事務(wù)基接口
B) JdbcTransaction : JDBC 自定義事務(wù)接口
C) MyBatisTransaction : MyBatis自定義事務(wù)接口
D) HibernateTransaction : Hibernate 自定義事務(wù)接口
(示例)
public static void serviceMethod()
{
// 獲取 SessionMgr
HibernateSessionMgr mgr = (HibernateSessionMgr)AppConfig.getSessionManager("mgr-1");
// 執(zhí)行自定義事務(wù)
FacadeProxy.executeCustomTransaction(mgr, new HibernateTransaction(){
// 實現(xiàn)自定義事務(wù)方法
@Override
public void execute(HibernateSessionMgr mgr) throws DAOException
{
// 創(chuàng)建 dao1 (不能使用 FacadeProxy 創(chuàng)建 DAO 對象)
MyDaoA dao1 = new MyDaoA(mgr);
// 創(chuàng)建 dao2 (不能使用 FacadeProxy 創(chuàng)建 DAO 對象)
MyDaoB dao2 = new MyDaoB(mgr);
// 執(zhí)行 DAO 方法
dao1.methodXxx();
dao2.methodYyy();
dao1.methodZzz();
dao2.methodNnn();
}});
}
5、擴大 mvc-confing.xml 中 <result-path-aliases> 別名配置應(yīng)用范圍
1) 支持在 <result-path-aliases> 配置中引用前面定義的別名
(示例:下面配置中 ${index} 的實際路徑為 '/jsp/test/index.jsp')
<result-path-aliases>
<alias name="jsp_base" path="/jsp/test"/>
<alias name="index" path="${jsp_base}/index.jsp"/>
</result-path-aliases>
2) 允許在 <action-convention> 的 'dispatch-file-path' 和 'dispatch-file-path' 配置中使用別名
(示例:下面配置中 'dispatch-file-path' 的實際路徑為 '/jsp')
<action-convention
dispatch-file-path="${ac_path}"
<!-- 其它配置(略)... -->
/>
<result-path-aliases>
<alias name="ac_path" path="/jsp"/>
</result-path-aliases>
6、其它更新
1) 修改 org.jessma.util.PackageHelper,加入包掃描相關(guān)方法
2) 依賴庫 “jessma-lib” 中的所有 jar 包更新到最新版本
3) 更新開發(fā)手冊《JessMA 高效 Java MVC & REST 開發(fā)框架 (v3.2.2)》
4) 增加一個 JessMA 項目模板工程:HelloJessMA
7、應(yīng)用程序升級說明
1) JessMA 3.2.1 升級到 JessMA 3.2.2:完全兼容,可直接升級
2) Portal-Basic 3.1.1 及更早版本升級到 JessMA 3.2.2:(參考 JessMA 3.2.1 的升級說明)
8、JessMA 3.2.1 歷史更新:《JessMA 3.2.1 Release》
原文出處:怪獸的博客 怪獸的微博 怪獸樂園Q群