~怪^_*獸~

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

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

    ★ 功能全面：內(nèi)置穩(wěn)定高效的 MVC 基礎架構(gòu)和 DAO 框架，支持 Action 攔截、Form Bean / Dao Bean / Spring Bean 裝配和聲明式事務，提供國際化、文件上傳下載、緩存和頁面靜態(tài)化等常用Web組件，能滿足絕大部分 Web 應用的需要。 
    ★ 高度擴展：JessMA 通過的 plug-in 機制可以靈活擴展，JessMA 發(fā)布包中自帶的 jessma-ext-rest 和 jessma-ext-spring 均以插件的形式提供，用戶可根據(jù)需要加載或卸載這些插件。應用程序開發(fā)者也可以根據(jù)實際需要編寫自定義插件來擴展 JessMA。 
    ★ 強大的整合能力：JessMA 是一個 Full-Stack 框架，同時也是一個開放式框架，可以以非常簡單的方式整合第三方組件。本開發(fā)手冊會詳細闡述如何在 JessMA 中整合 Freemarker、 Velocity 、 Urlrewrite、 EHCache-Web 、 Spring 、 Hibernate 和 Mybaits 等常用框架和組件。 
    ★ 高性能：性能要求是 JessMA 的硬性指標，從每個模塊的設計到每行代碼的實現(xiàn)都力求簡潔高效。另外，Portal-Basi c并沒有對 JSP/Servet API 進行過多封裝，開發(fā)者仍然使用 JSP/Servet API 開發(fā)應用程序，沒有過多的迂回，性能得到保證。 
    ★ 優(yōu)秀的使用體驗：JessMA 的設計目標之一是提供良好的開發(fā)體驗，盡量減少應用程序開發(fā)者的工作，API 的設計力求簡單、完整、明確。同時，JessMA 為應用開發(fā)提供了大量 Util 工具，用來處理應用程序開發(fā)過程中通常會遇到的一般性問題，進一步減少應用程序開發(fā)者的工作負擔。 
    ★ 平緩的學習曲線：學習使用 JessMA 只需掌握一定的 Core Java 與 JSP/Servlet 知識，本開發(fā)手冊會循序漸進闡述每個知識點，每個知識點都會結(jié)合完整的示例進行講述，知識點之間前后呼應，確保學習者在學習時溫故知新，融會貫通。 
    ★ 完善的技術支持：除了提供完善的開發(fā)手冊和示例代碼以外，還提供博客和 QQ 群用于解答使用 JessMA 過程中碰到的所有問題，也可以訪問 JessMA 官方網(wǎng)站了解更多資訊。

* JessMA 總體架構(gòu)

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

    ● 基礎應用框架

    基礎應用框架加載應用程序配置文件（默認：app-config.xml），監(jiān)聽應用程序的生命周期事件，并向上層應用發(fā)送應用程序啟動和關閉通知，應用程序可以處理這些通知進行額外的初始化或清理工作。基礎應用框架在org.jessma.app包中是實現(xiàn)。

    ● MVC框架

    MVC框架加載MVC配置文件（默認：mvc-config.xml），通過前端控制器ActionDispatcher接收和解析所有的客戶HTTP請求，然后交由相應的Action進行處理，最后生成相應的視圖返回給客戶端。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ā)送等），這些類與框架無關，可在任何應用程序中使用。公共組件在以下包中實現(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核心框架基礎上的功能延伸，不是JessMA的必要組件。可由應用程序開發(fā)人員根據(jù)需要自行定制。JessMA發(fā)行包中也自帶了一些擴展插件（如：jessma-ext-spring和jessma-ext-rest）。

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

JessMA 3.3.1 (Beta-1) 更新：

1、增強國際化功能

2、支持 JSR 303 Bean Validation 機制

3、其它更新/strong>

4、應用程序升級說明

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 整合示例

    （注：通常情況下，應用程序需要創(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 對應的 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 方法作為一個事務單元，并且不會有嵌套事務
4) 事務屬性由最外層的 DAO 方法指定，忽略所有內(nèi)層 DAO 方法的事務屬性

4、其它更新

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

5、應用程序升級說明

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í)行自定義事務

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

    （示例）
    public static void serviceMethod()
    {
        // 獲取 SessionMgr
        HibernateSessionMgr mgr = (HibernateSessionMgr)AppConfig.getSessionManager("mgr-1");
        // 執(zhí)行自定義事務
        FacadeProxy.executeCustomTransaction(mgr, new HibernateTransaction(){
        // 實現(xiàn)自定義事務方法
            @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> 別名配置應用范圍

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) 更新開發(fā)手冊《JessMA 高效 Java MVC & REST 開發(fā)框架 (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》