JessMA（原 名：Portal-Basic）是一套功能完備的高效能 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
JessMA 下載地址：http://code.google.com/p/portal-basic
JessMA 線上示例：http://demo.jessma.org
JessMA 線上 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主要包括以下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.ext.dao
● 公共元件
公共元件提供多種通用功能幫助類（如：字串處理、型別轉換、分頁演算法、壓縮/解壓、加解密、郵件傳送等），這些類與框架無關，可在任何應用程式中使用。公共元件在以下包中實現：
▪ 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的必要元件。可由應用程式開發人員根據需要自行定製。JessMA發行包中也自帶了一些擴充套件外掛（如：jessma-ext-spring和jessma-ext-rest）。
基 礎應用框架、MVC框架和DAO框架都依賴於公共元件，其中基礎應用框架同時依賴於DAO框架，因此，MVC框架和DAO框架能脫離JessMA單獨使用 （當然，要附帶上公共元件）。例如：可以把MVC框架和DAO框架用於JessMA之外的其它Web專案；也可以把DAO框架用於非Web專案 （如：Swing / SWT桌面應用）。
JessMA 3.2.3 (beta-2) 更新：
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>
3、規範“巢狀 DAO 方法”呼叫規則（詳情參考：開發手冊第 10.6 節）
1) 最外層的 DAO 物件必須由 FacadeProxy 建立
2) 內層的 DAO 物件可以用 new 或 FacadeProxy 等任意方式建立
3) 最外層的 DAO 方法作為一個事務單元，並且不會有巢狀事務
4) 事務屬性由最外層的 DAO 方法指定，忽略所有內層 DAO 方法的事務屬性
4、其它更新
1) 依賴庫 “jessma-lib” 中的所有 jar 包更新到最新版本
2) 依賴庫 “spring-lib” 中的所有 jar 包更新到最新版本
3) 增加 Guice 依賴庫 “guice-lib”
4) 更新開發手冊《JessMA Java Web 應用開發框架 (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 更新：
(注：本次更新的主要內容是升級 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、所有 JDBC Session Manager 均取消 ‘isXml’ 配置引數，改為根據配置檔案的副檔名自動識別配置檔案型別
1) 受影響的 Session Manager：DruidSessionMgr、JdbcSessionMgr、JndiSessionMgr、ProxoolSessionMgr
4、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();
}});
}
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) 更新開發手冊《JessMA 高效 Java MVC & REST 開發框架 (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》