~怪^_*獸~

    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）。

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

JessMA 3.5.1 更新：

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>

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

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

JessMA 3.4.1 更新：

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

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

JessMA 3.3.1 更新：

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" />

3、其它更新

JessMA 3.2.3 更新：

1、增加 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;
        }
    }

2、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 組件)

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

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