高效 Java Web 應用開發框架 JessMA v3.2.2 正式發佈

 

JessMA（原名：Portal-Basic）是由 JessMA Open Source 開發的一套高效 Java Full-Stack Web 應用開發框架，內置可擴展的 MVC Web 基礎架構和 DAO 數據庫訪問組件（內部已提供了 Hibernate、MyBatis 與 JDBC DAO 組件），集成了 Action 攔截、Form / Dao / Spring Bean 裝配、國際化、文件上傳下載和頁面靜態化等基礎 Web 應用組件，提供高效靈活的純 Jsp/Servlet API 編程模型，可完美整合 Spring，支持 Action Convention，能快速開發傳統風格和 RESTful 風格應用程序，文檔和示例完善，很是容易學習。

　　JessMA 官方網站：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在設計之初就充分注重功能、性能與使用體驗。JessMA主要特色：

★ 功能全面：內置穩定高效的MVC基礎架構和DAO框架，支持Action攔截、Form Bean / Dao Bean / Spring Bean裝配和聲明式事務，提供國際化、文件上傳下載、緩存和頁面靜態化等經常使用Web組件，能知足絕大部分Web應用的須要。

★ 高度擴展：JessMA經過的plug-in機制能夠靈活擴展，JessMA發佈包中自帶的jessma-ext-rest和jessma-ext-spring均以插件的形式提供，用戶可根據須要加載或卸載這些插件。應用程序開發者也能夠根據實際須要編寫自定義插件來擴展JessMA。

★ 強大的整合能力：JessMA是一個Full-Stack框架，同時也是一個開放式框架，能夠以很是簡單的方式整合第三方組件。本開發手冊會詳細闡述如何在JessMA中整合FreeMarker、Velocity、UrlRewrite、EHCache-Web、Spring、Hibernate和MyBaits等經常使用框架和組件。

★ 高性能：性能要求是JessMA的硬性指標，從每一個模塊的設計到每行代碼的實現都力求簡潔高效。另外，JessMA並無對JSP/Servet API進行過多封裝，開發者仍然使用JSP/Servet API開發應用程序，沒有過多的迂迴，性能獲得保證。

★ 優秀的使用體驗：JessMA的設計目標之一是提供良好的開發體驗，儘可能減小應用程序開發者的工做，API的設計力求簡單、完整、明確。同時，JessMA爲應用開發提供了大量Util工具，用來處理應用程序開發過程當中一般會遇到的通常性問題，進一步減小應用程序開發者的工做負擔。

★ 平緩的學習曲線：平緩的學習曲線：學習使用JessMA只需掌握必定的Core Java與JSP/Servlet知識，本開發手冊會按部就班闡述每一個知識點，每一個知識點都會結合完整的示例進行講述，知識點之間先後呼應，確保學習者在學習時溫故知新，融會貫通。

★ 完善的技術支持：除了提供完善的開發手冊和示例代碼之外，還提供博客和Q~Q~羣用於解答使用JessMA過程當中碰到的全部問題，也能夠訪問 JessMA 官方網站了解更多資訊。

* JessMA 整體架構

 　　JessMA主要包括如下5個部分：

　　● 基礎應用框架

　　基礎應用框架加載應用程序配置文件（默認：app-config.xml），監聽應用程序的生命週期事件，並向上層應用發送應用程序啓動和關閉通知，應用程序能夠處理這些通知進行額外的初始化或清理工做。基礎應用框架在org.jessma.app包中是實現。

　　● MVC框架

　　MVC框架加載MVC配置文件（默認：mvc-config.xml），經過前端控制器ActionDispatcher接收和解析全部的客戶HTTP請求，而後交由相應的Action進行處理，最後生成相應的視圖返回給客戶端。MVC框架在org.jessma.mvc包中實現。

　　● DAO框架

　　DAO框架封裝了全部的數據庫訪問操做，內置JDBC、Hibernate和MyBaits數據庫訪問組件以及Druid、Proxool、JNDI等鏈接池。DAO框架是可擴展的，用戶能夠經過擴展org.jessma.dao.AbstractFacade和org.jessma.dao.AbstractSessionMgr實現本身的數據庫訪問組件。DAO框架在如下包中實現：
　　▪ org.jessma.dao
　　▪ org.jessma.dao.hbn
　　▪ org.jessma.dao.jdbc
　　▪ org.jessma.dao.mybatis
　　▪ org.jessma.ext.dao

　　● 公共組件

　　公共組件提供多種通用功能幫助類（如：字符串處理、類型轉換、分頁算法、壓縮/解壓、加解密、郵件發送等），這些類與框架無關，可在任何應用程序中使用。公共組件在如下包中實現：
　　▪ org.jessma.util
　　▪ org.jessma.util.archive
　　▪ org.jessma.util.cache
　　▪ org.jessma.util.http
　　▪ org.jessma.util.mail
　　▪ org.jessma.dao（DAO框架也可由看做爲一個相對較大的公共組件）

　　● 擴展插件

　　擴展差插件是基於JessMA核心框架基礎上的功能延伸，不是JessMA的必要組件。可由應用程序開發人員根據須要自行定製。JessMA發行包中也自帶了一些擴展插件（如：jessma-ext-spring和jessma-ext-rest）。

* JessMA 應用程序依賴關係

　　基礎應用框架、MVC框架和DAO框架都依賴於公共組件，其中基礎應用框架同時依賴於DAO框架，所以，MVC框架和DAO框架能脫離JessMA單獨使用（固然，要附帶上公共組件）。例如：能夠把MVC框架和DAO框架用於JessMA以外的其它Web項目；也能夠把DAO框架用於非Web項目（如：Swing / SWT桌面應用）。

---

JessMA 3.2.2 更新：

(注：本次更新的主要內容是升級 DAO 組件)

一、org.jessma.dao.hbn.HibernateSessionMgr 支持自動掃描實體對象

　1) 實體對象用 @Entity 註解取代 *.hbm.xml 映射文件（同時也沒必要在 hibernate.cfg.xml 中配置 ‘mapping’）
　2) app-config.xml 中配置 HibernateSessionMgr 時，用第二個可選參數以正則表達式的格式指定實體對象所在包

　　（例如：實體對象位於 ‘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>

二、org.jessma.dao.mybatis.MyBatisSessionMgr 支持自動掃描 SQL Mapper 接口

　1) 沒必要在 mybatis.cfg.xml 中配置 ‘mapper’
　2) app-config.xml 中配置 MyBatisSessionMgr 時，用第三個可選參數以正則表達式的格式指定 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>

三、全部 JDBC Session Manager 均取消 ‘isXml’ 配置參數，改成根據配置文件的擴展名自動識別配置文件類型

　1) 受影響的 Session Manager：DruidSessionMgr、JdbcSessionMgr、JndiSessionMgr、ProxoolSessionMgr

四、org.jessma.dao.FacadeProxy 增長方法 executeCustomTransaction(...) 支持執行自定義事務

　1) JessMA 的事務是 DAO 層事務，也就是說當外部調用某個 DAO 方法時，該方法做爲一個事務單元執行。 但在一些特殊情形下可能須要在 DAO 外部執行 Service 層事務（例如：事務須要調用多個 DAO 對象的多個方法）， 此時須要建立一個自定義事務（CustomTransaction），並調用 FacadeProxy 的 executeCustomTransaction(...) 來執行該自定義事務。
　2) 增長自定義事務相關接口：
　　A) CustomTransaction　　: 自定義事務基接口
　　B) JdbcTransaction　　　  : JDBC 自定義事務接口
　　C) MyBatisTransaction　　: MyBatis自定義事務接口
　　D) HibernateTransaction　: Hibernate 自定義事務接口

　　（示例）

　　public static void serviceMethod()
　　{
　　　　// 獲取 SessionMgr
　　　　HibernateSessionMgr mgr = (HibernateSessionMgr)AppConfig.getSessionManager("mgr-1");
　　　　// 執行自定義事務
　　　　FacadeProxy.executeCustomTransaction(mgr, new HibernateTransaction(){
　　　　// 實現自定義事務方法
　　　　@Override
　　　　public void execute(HibernateSessionMgr mgr) throws DAOException
　　　　{
　　　　　　// 建立 dao1 （不能使用 FacadeProxy 建立 DAO 對象）
　　　　　　MyDaoA dao1 = new MyDaoA(mgr);
　　　　　　// 建立 dao2 （不能使用 FacadeProxy 建立 DAO 對象）
　　　　　　MyDaoB dao2 = new MyDaoB(mgr);

　　　　　　// 執行 DAO 方法
　　　　　　dao1.methodXxx();
　　　　　　dao2.methodYyy();
　　　　　　dao1.methodZzz();
　　　　　　dao2.methodNnn();
　　　　}});
　　}

五、擴大 mvc-confing.xml 中 <result-path-aliases> 別名配置應用範圍

　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>

六、其它更新

　1) 修改 org.jessma.util.PackageHelper，加入包掃描相關方法
　2) 依賴庫 「jessma-lib」 中的全部 jar 包更新到最新版本
　3) 更新開發手冊《JessMA 高效 Java MVC & REST 開發框架 (v3.2.2)》
　4) 增長一個 JessMA 項目模板工程：HelloJessMA

七、應用程序升級說明

　1) JessMA 3.2.1 升級到 JessMA 3.2.2：徹底兼容，可直接升級
　2) Portal-Basic 3.1.1 及更早版本升級到 JessMA 3.2.2：（參考 JessMA 3.2.1 的升級說明）

八、JessMA 3.2.1 歷史更新：《JessMA 3.2.1 Release》

---

CodeProject