高效 Java Web 開發框架 JessMA v3.5.1

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

    JessMA 官方網站：http://www.jessma.org
    OSChina 項目主頁：http://www.oschina.net/p/portal-basic
    Github 下載地址：https://github.com/ldcsaa/JessMA
    在線示例：http://demo.jessma.org
    在線 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 的硬性指標，從每一個模塊的設計到每行代碼的實現都力求簡潔高效。另外，Portal-Basi c並無對 JSP/Servet API 進行過多封裝，開發者仍然使用 JSP/Servet API 開發應用程序，沒有過多的迂迴，性能獲得保證。 
    ★ 優秀的使用體驗：JessMA 的設計目標之一是提供良好的開發體驗，儘可能減小應用程序開發者的工做，API 的設計力求簡單、完整、明確。同時，JessMA 爲應用開發提供了大量 Util 工具，用來處理應用程序開發過程當中一般會遇到的通常性問題，進一步減小應用程序開發者的工做負擔。 
    ★ 平緩的學習曲線：學習使用 JessMA 只需掌握必定的 Core Java 與 JSP/Servlet 知識，本開發手冊會按部就班闡述每一個知識點，每一個知識點都會結合完整的示例進行講述，知識點之間先後呼應，確保學習者在學習時溫故知新，融會貫通。 
    ★ 完善的技術支持：除了提供完善的開發手冊和示例代碼之外，還提供博客和 QQ 羣用於解答使用 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.util
    ▪ org.jessma.util.archive
    ▪ org.jessma.util.http
    ▪ org.jessma.util.mail

    ● 擴展插件

    擴展差插件是基於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.5.1 更新：

一、JessMA 3.5.1 使用 Maven 進行構建和發佈管理

1) JessMA core

<dependency>
	<groupId>org.jessma</groupId>
	<artifactId>jessma-core</artifactId>
	<version>3.5.1</version>
</dependency>

2) JessMA RESTful 擴展

<dependency>
	<groupId>org.jessma</groupId>
	<artifactId>jessma-ext-rest</artifactId>
	<version>3.5.1</version>
</dependency>

3) JessMA Guice 擴展

<dependency>
	<groupId>org.jessma</groupId>
	<artifactId>jessma-ext-guice</artifactId>
	<version>3.5.1</version>
</dependency>

4) JessMA Spring 擴展

<dependency>
	<groupId>org.jessma</groupId>
	<artifactId>jessma-ext-spring</artifactId>
	<version>3.5.1</version>
</dependency>

二、日誌組件使用 slf4j 替代  Log4j
1) JessMA Logger 對象獲取方式：org.jessma.util.LogUtil.getJessMALogger()
2) 其它 Logger 對象獲取方式：org.jessma.util.LogUtil.getLogger()

三、其它更新
1) 依賴包更新到最新版本
2) 增長 Maven 示例工程 jessma-sample-hello 和 jessma-sample-set
3) 更新開發手冊《JessMA Java Web 應用開發框架 (v3.5.1)》

---

JessMA 3.4.1 更新：

一、升級 Log4J 到 2.x 版本
1) Log4J 默認配置文件爲 log4j2.xml
2) 默認 Logger 對象獲取方式：org.jessma.util.LogUtil.getDefaultLogger(...)
3) 其它 Logger 對象獲取方式：org.apache.logging.log4j.LogManager.getLogger(...)

二、其它更新
1) 依賴庫 「jessma-lib」 中的全部 jar 包更新到最新版本
2) 依賴庫 「spring-lib」 中的全部 jar 包更新到最新版本
3) 更新開發手冊《JessMA Java Web 應用開發框架 (v3.4.1)》

---

JessMA 3.3.1 更新：

一、加強國際化功能

1) 支持設置應用程序器默認 Locale 和默認 Bundle
    A) 若是不配置器默認 Locale 則使用系統原來的默認 Locale
    B) 若是不配置默認 Bundle，則默認 Bundle 爲 'res.application-message'

        （參考：下面的 MVC 配置文件條目）
        <!--
            default-locale：應用程序默認語言選項（默認：與當前操做系統一致）
            default-bundle：應用程序默認 Bundle（默認：res.application-message）
        -->
        <i18n default-locale="en_US" default-bundle="com.bruce.res.application-message" />

2) 支持基於 URL、Cookie 或瀏覽器語言選項的國際化方式
    A) org.jessma.mvc.i18n.URLI18nFilter        ：基於 URL 請求參數的國際化攔截器
    B) org.jessma.mvc.i18n.CookieI18nFilter   ：基於 Cookie 的國際化攔截器
    C) org.jessma.mvc.i18n.BrowserI18nFilter：基於瀏覽器語言選項的國際化攔截器
    D) JessMA 默認基於 Session 實現國際化，但能夠經過配置上述攔截器改成相應的實現方式
    E) 上述攔截器的國際化屬性是基於 Request Attribute 的，所以會屏蔽 Session 的國際化設置
    F) 上述攔截器能夠組合使用，通常順序爲：URL -> Cookie -> Browser

        （例如：下面同時配置了 URL、Cookie 和 Browser 三個國際化攔截器）
        <action-filters>
            <!-- 優先檢查客戶請求中是否帶有名稱爲 '__locale' 的請求參數 -->
            <filter class="org.jessma.mvc.i18n.URLI18nFilter"/>
            <!-- 而後檢查請求是否帶有名稱爲 '__locale' 的 Cookie -->
            <filter class="org.jessma.mvc.i18n.CookieI18nFilter"/>
            <!-- 最後根據客戶端瀏覽器的語言選項設置當前請求的語言屬性 -->
            <filter class="org.jessma.mvc.i18n.BrowserI18nFilter"/>
        </action-filters>

二、支持 JSR 303 Bean Validation 機制

1) 若是開啓了Bean Validation 機制，應用程序可對由 @FormBean 註解的 Form Bean 執行自動驗證
2) @FormBean 註解增長 'validate()' 和 'groups()' 兩個屬性，分別指示是否對 Form Bean 執行自動驗證，以及自動驗證的驗證組
3) 若是自動驗證成功則轉入 Action 的 validate() 方法繼續執行，不然會把錯誤信息寫入 Action 的 errors 集合並跳轉到 Action 的 INPUT 視圖
4) 應用程序還能夠隨時調用 ActionSupport 的 validateBean() / validateBeanAndAddErrors() 方法驗證其它任何 Bean
5) 增長錯誤信息輸出標籤 <p:err/>，支持多種方式和格式展現錯誤信息（參考：<p:err/> 及其實現類 org.jessma.tag.Error 相關注釋）

        （參考：下面的 MVC 配置文件條目）
        <!--
            enable ：是否開啓 Bean Validation 機制（默認：開啓）
            bundle：驗證文本消息的 Bundle（默認：res.validation-message）
            validator：驗證器類（默認：org.jessma.mvc.validation.HibernateBeanValidator）
        -->
        <bean-validation
            enable="true"
            bundle="com.bruce.res.validation-message"
            validator="org.jessma.mvc.validation.HibernateBeanValidator"
        />

三、其它更新

1) org.jessma.ext.dao.* 包中的類移到 org.jessma.dao
2) 應用程序默認 Bundle 由 「res.message-resource」 改成 「res.application-message」
3) 修改 MVC 主/從配置文件、應用程序配置文件以及 REST 配置文件的 Sechema 引用（參考 MyJessMA 測試工程）
4) 更新開發手冊《JessMA Java Web 應用開發框架 (v3.3.1)》
5) 整理依賴庫 「jessma-lib」，刪除多餘的 jar 包4) 事務屬性由最外層的 DAO 方法指定，忽略全部內層 DAO 方法的事務屬性

 

---

JessMA 3.2.3 更新：

一、增長 Guice 支持

1) 增長  Guice 插件包 jessma-ext-guice-3.2.3.jar 用於整合 Guice
2) Action 經過 @GuiceBean/@GuiceBeans 註解聲明 Guice Bean
3) Action 經過攔截器 com.bruce.ext.guice.GuiceInjectFilter 解析 @GuiceBean/@GuiceBeans 註解並注入 Guice Bean
4) 能夠在 Guice Bean 中注入 JessMA DAO 對象，從而能在 Guice 環境下使用 JessMA DAO 子框架
5) 示例工程 MyJessMA 增長 Guice 整合示例

    （注：一般狀況下，應用程序須要建立 GuiceInjectFilter 的子類並改寫 configModules() 方法，用於定義 Module 的綁定規則）
    public class MyGuiceInjectFilter extends GuiceInjectFilter
    {
        @Override
        protected Collection<Module> configModules()
        {
            Set<Module> modules = new HashSet<Module>();
            // 加入第一個 Module
            modules.add(new Module()
            {
                @Override
                public void configure(Binder binder)
                {
                    // 配置綁定規則
                    // ......
                }
            });
            // ......
            // 加入第N個 Module
            modules.add(new Module()
            {
                @Override
                public void configure(Binder binder)
                {
                    // 配置綁定規則
                    // ......
                }
            });
            return modules;
        }
    }

二、Form Bean 支持聯級屬性注入

1) @FormBean 註解支持注入聯級屬性
2) org.jessma.util.BeanHelper 的 createBean(...) / setPropertiesOrFieldValues(...) 系列方法支持聯級裝配 Bean

    （例如：下面的 Form 對應的 Bean 中，b、x 和 y 爲聯級 Bean）
    <form>
        <input name="a" value="...">
        <input name="b.c" value="...">
        <input name="b.d" value="...">
        <input name="x.y.z" value="...">
    </form>

---

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>

三、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 （可使用 ‘new MyDaoB(mgr)’ 建立 DAO 對象）
                MyDaoB dao2 = Facade.create(MyDaoB.class, 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>