~怪^_*獸~

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

    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è)計(jì)之初就充分注重功能、性能與使用體驗(yàn)。JessMA 主要特點(diǎn)：

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

* JessMA 總體架構(gòu)

JessMA主要包括以下5個(gè)部分：

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

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

    ● MVC框架

    MVC框架加載MVC配置文件（默認(rèn)：mvc-config.xml），通過(guò)前端控制器ActionDispatcher接收和解析所有的客戶HTTP請(qǐng)求，然后交由相應(yīng)的Action進(jìn)行處理，最后生成相應(yīng)的視圖返回給客戶端。MVC框架在org.jessma.mvc包中實(shí)現(xiàn)。

    ● DAO框架

    DAO框架封裝了所有的數(shù)據(jù)庫(kù)訪問(wèn)操作，內(nèi)置JDBC、Hibernate和MyBaits數(shù)據(jù)庫(kù)訪問(wèn)組件以及Druid、Proxool、JNDI等連接池。DAO框架是可擴(kuò)展的，用戶可以通過(guò)擴(kuò)展org.jessma.dao.AbstractFacade和org.jessma.dao.AbstractSessionMgr實(shí)現(xiàn)自己的數(shù)據(jù)庫(kù)訪問(wèn)組件。DAO框架在以下包中實(shí)現(xiàn)：
    ▪ org.jessma.dao
    ▪ org.jessma.dao.hbn
    ▪ org.jessma.dao.jdbc
    ▪ org.jessma.dao.mybatis
    ▪ org.jessma.ext.dao

    ● 公共組件

    公共組件提供多種通用功能幫助類（如：字符串處理、類型轉(zhuǎn)換、分頁(yè)算法、壓縮/解壓、加解密、郵件發(fā)送等），這些類與框架無(wú)關(guān)，可在任何應(yīng)用程序中使用。公共組件在以下包中實(shí)現(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框架也可由看作為一個(gè)相對(duì)較大的公共組件）

    ● 擴(kuò)展插件

    擴(kuò)展差插件是基于JessMA核心框架基礎(chǔ)上的功能延伸，不是JessMA的必要組件。可由應(yīng)用程序開(kāi)發(fā)人員根據(jù)需要自行定制。JessMA發(fā)行包中也自帶了一些擴(kuò)展插件（如：jessma-ext-spring和jessma-ext-rest）。

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

JessMA 3.3.1 (Beta-1) 更新：

1、增強(qiáng)國(guó)際化功能

2、支持 JSR 303 Bean Validation 機(jī)制

3、其它更新/strong>

4、應(yīng)用程序升級(jí)說(shuō)明

JessMA 3.2.3 更新：

1、增加 Guice 支持

1) 增加  Guice 插件包 jessma-ext-guice-3.2.3.jar 用于整合 Guice
2) Action 通過(guò) @GuiceBean/@GuiceBeans 注解聲明 Guice Bean
3) Action 通過(guò)攔截器 com.bruce.ext.guice.GuiceInjectFilter 解析 @GuiceBean/@GuiceBeans 注解并注入 Guice Bean
4) 可以在 Guice Bean 中注入 JessMA DAO 對(duì)象，從而能在 Guice 環(huán)境下使用 JessMA DAO 子框架
5) 示例工程 MyJessMA 增加 Guice 整合示例

    （注：通常情況下，應(yīng)用程序需要?jiǎng)?chuàng)建 GuiceInjectFilter 的子類并改寫(xiě) configModules() 方法，用于定義 Module 的綁定規(guī)則）
    public class MyGuiceInjectFilter extends GuiceInjectFilter
    {
        @Override
        protected Collection<Module> configModules()
        {
            Set<Module> modules = new HashSet<Module>();
            // 加入第一個(gè) Module
            modules.add(new Module()
            {
                @Override
                public void configure(Binder binder)
                {
                    // 配置綁定規(guī)則
                    // ......
                }
            });
            // ......
            // 加入第N個(gè) Module
            modules.add(new Module()
            {
                @Override
                public void configure(Binder binder)
                {
                    // 配置綁定規(guī)則
                    // ......
                }
            });
            return modules;
        }
    }

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

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

    （例如：下面的 Form 對(duì)應(yīng)的 Bean 中，b、x 和 y 為聯(lián)級(jí) 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ī)則（詳情參考：開(kāi)發(fā)手冊(cè)第 10.6 節(jié)）

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

4、其它更新

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

5、應(yīng)用程序升級(jí)說(shuō)明

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

JessMA 3.2.2 更新：

(注：本次更新的主要內(nèi)容是升級(jí) DAO 組件)

1、org.jessma.dao.hbn.HibernateSessionMgr 支持自動(dòng)掃描實(shí)體對(duì)象

1) 實(shí)體對(duì)象用 @Entity 注解取代 *.hbm.xml 映射文件（同時(shí)也不必在 hibernate.cfg.xml 中配置 ‘mapping’）
2) app-config.xml 中配置 HibernateSessionMgr 時(shí)，用第二個(gè)可選參數(shù)以正則表達(dá)式的格式指定實(shí)體對(duì)象所在包

    （例如：實(shí)體對(duì)象位于 ‘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 支持自動(dòng)掃描 SQL Mapper 接口

1) 不必在 mybatis.cfg.xml 中配置 ‘mapper’
2) app-config.xml 中配置 MyBatisSessionMgr 時(shí)，用第三個(gè)可選參數(shù)以正則表達(dá)式的格式指定 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ù)配置文件的擴(kuò)展名自動(dòng)識(shí)別配置文件類型

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

4、org.jessma.dao.FacadeProxy 增加方法 executeCustomTransaction(...) 支持執(zhí)行自定義事務(wù)

1) JessMA 的事務(wù)是 DAO 層事務(wù)，也就是說(shuō)當(dāng)外部調(diào)用某個(gè) DAO 方法時(shí)，該方法作為一個(gè)事務(wù)單元執(zhí)行。 但在一些特殊情形下可能需要在 DAO 外部執(zhí)行 Service 層事務(wù)（例如：事務(wù)需要調(diào)用多個(gè) DAO 對(duì)象的多個(gè)方法）， 此時(shí)需要?jiǎng)?chuàng)建一個(gè)自定義事務(wù)（CustomTransaction），并調(diào)用 FacadeProxy 的 executeCustomTransaction(...) 來(lái)執(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(){
        // 實(shí)現(xiàn)自定義事務(wù)方法
            @Override
            public void execute(HibernateSessionMgr mgr) throws DAOException
            {
                // 創(chuàng)建 dao1 （可以使用 FacadeProxy 創(chuàng)建 DAO 對(duì)象）
                MyDaoA dao1 = new MyDaoA(mgr);
               // 創(chuàng)建 dao2 （可以使用 ‘new MyDaoB(mgr)’ 創(chuàng)建 DAO 對(duì)象）
                MyDaoB dao2 = Facade.create(MyDaoB.class, mgr);

                // 執(zhí)行 DAO 方法
                dao1.methodXxx();
                dao2.methodYyy();
                dao1.methodZzz();
                dao2.methodNnn();
            }});
    }

5、擴(kuò)大 mvc-confing.xml 中 <result-path-aliases> 別名配置應(yīng)用范圍

1) 支持在 <result-path-aliases> 配置中引用前面定義的別名

    （示例：下面配置中 ${index} 的實(shí)際路徑為 '/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' 的實(shí)際路徑為 '/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) 依賴庫(kù) “jessma-lib” 中的所有 jar 包更新到最新版本
3) 更新開(kāi)發(fā)手冊(cè)《JessMA 高效 Java MVC & REST 開(kāi)發(fā)框架 (v3.2.2)》
4) 增加一個(gè) JessMA 項(xiàng)目模板工程：HelloJessMA

7、應(yīng)用程序升級(jí)說(shuō)明

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

8、JessMA 3.2.1 歷史更新：《JessMA 3.2.1 Release》