~怪^_*獸~

    JessMA（原名：Portal-Basic）是一套功能完備的高性能 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 / Guice，支持 Action Convention，能快速開發(fā)傳統(tǒng)風格和 RESTful 風格應(yīng)用程序，文檔和示例完善，非常容易學(xué)習。

    JessMA 官方網(wǎng)站：http://www.jessma.org
    JessMA 下載地址：http://www.oschina.net/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 的硬性指標，從每個模塊的設(shè)計到每行代碼的實現(xiàn)都力求簡潔高效。另外，Portal-Basi c并沒有對 JSP/Servet API 進行過多封裝，開發(fā)者仍然使用 JSP/Servet API 開發(fā)應(yīng)用程序，沒有過多的迂回，性能得到保證。 
    ★ 優(yōu)秀的使用體驗：JessMA 的設(shè)計目標之一是提供良好的開發(fā)體驗，盡量減少應(yīng)用程序開發(fā)者的工作，API 的設(shè)計力求簡單、完整、明確。同時，JessMA 為應(yīng)用開發(fā)提供了大量 Util 工具，用來處理應(yīng)用程序開發(fā)過程中通常會遇到的一般性問題，進一步減少應(yīng)用程序開發(fā)者的工作負擔。 
    ★ 平緩的學(xué)習曲線：學(xué)習使用 JessMA 只需掌握一定的 Core Java 與 JSP/Servlet 知識，本開發(fā)手冊會循序漸進闡述每個知識點，每個知識點都會結(jié)合完整的示例進行講述，知識點之間前后呼應(yīng)，確保學(xué)習者在學(xué)習時溫故知新，融會貫通。 
    ★ 完善的技術(shù)支持：除了提供完善的開發(fā)手冊和示例代碼以外，還提供博客和 QQ 群用于解答使用 JessMA 過程中碰到的所有問題，也可以訪問 JessMA 官方網(wǎng)站了解更多資訊。

* JessMA 總體架構(gòu)

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

    ● 基礎(chǔ)應(yīng)用框架

    基礎(chǔ)應(yīng)用框架加載應(yīng)用程序配置文件（默認：app-config.xml），監(jiān)聽應(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）。

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

JessMA 3.3.1 (Beta-1) 更新：

1、增強國際化功能

2、支持 JSR 303 Bean Validation 機制

3、其它更新/strong>

4、應(yīng)用程序升級說明

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 環(huán)境下使用 JessMA DAO 子框架
5) 示例工程 MyJessMA 增加 Guice 整合示例

    （注：通常情況下，應(yīng)用程序需要創(chuàng)建 GuiceInjectFilter 的子類并改寫 configModules() 方法，用于定義 Module 的綁定規(guī)則）
    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)
                {
                    // 配置綁定規(guī)則
                    // ......
                }
            });
            // ......
            // 加入第N個 Module
            modules.add(new Module()
            {
                @Override
                public void configure(Binder binder)
                {
                    // 配置綁定規(guī)則
                    // ......
                }
            });
            return modules;
        }
    }

2、Form Bean 支持聯(lián)級屬性注入

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

    （例如：下面的 Form 對應(yīng)的 Bean 中，b、x 和 y 為聯(lián)級 Bean）

    <form>
        <input name="a" value="...">
        <input name="b.c" value="...">
        <input name="b.d" value="...">
        <input name="x.y.z" value="...">
    </form>

3、規(guī)范“嵌套 DAO 方法”調(diào)用規(guī)則（詳情參考：開發(fā)手冊第 10.6 節(jié)）

1) 最外層的 DAO 對象必須由 FacadeProxy 創(chuàng)建
2) 內(nèi)層的 DAO 對象可以用 new 或 FacadeProxy 等任意方式創(chuàng)建
3) 最外層的 DAO 方法作為一個事務(wù)單元，并且不會有嵌套事務(wù)
4) 事務(wù)屬性由最外層的 DAO 方法指定，忽略所有內(nèi)層 DAO 方法的事務(wù)屬性

4、其它更新

1) 依賴庫 “jessma-lib” 中的所有 jar 包更新到最新版本
2) 依賴庫 “spring-lib” 中的所有 jar 包更新到最新版本
3) 增加 Guice 依賴庫 “guice-lib”
4) 更新開發(fā)手冊《JessMA Java Web 應(yīng)用開發(fā)框架 (v3.2.3)》

5、應(yīng)用程序升級說明

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

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ù)，也就是說當外部調(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 （可以使用 ‘new MyDaoB(mgr)’ 創(chuàng)建 DAO 對象）
                MyDaoB dao2 = Facade.create(MyDaoB.class, 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》