高效 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 組件)

 1、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>

2、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>

3、所有 JDBC Session Manager 均取消 ‘isXml’ 配置參數，改為根據配置文件的擴展名自動識別配置文件類型

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

4、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();
　　　　}});
　　}

5、擴大 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>

6、其它更新

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

7、應用程序升級說明

　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》