
JessMA(原名:Portal-Basic)是由 JessMA Open Source 開發的一套高效 Java Full-Stack Web 應用開發框架,內置可擴展的 MVC Web 基礎架構和 DAO 數據庫訪問組件(內部已提供了 Hibernate、MyBatis 與 JDBC DAO 組件),集成了 Action 攔截、Form / Dao / Spring Bean 裝配、國際化、文件上傳下載和頁面靜態化等基礎 Web 應用組件,提供高效靈活的純 Jsp/Servlet API 編程模型,可完美整合 Spring,支持 Action Convention,能快速開發傳統風格和 RESTful 風格應用程序,文檔和示例完善,非常容易學習。
JessMA 官方網站:http://www.jessma.org
JessMA 下載地址:https://code.google.com/p/portal-basic/
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的硬性指標,從每個模塊的設計到每行代碼的實現都力求簡潔高效。另外,JessMA并沒有對JSP/Servet API進行過多封裝,開發者仍然使用JSP/Servet API開發應用程序,沒有過多的迂回,性能得到保證。
★ 優秀的使用體驗:JessMA的設計目標之一是提供良好的開發體驗,盡量減少應用程序開發者的工作,API的設計力求簡單、完整、明確。同時,JessMA為應用開發提供了大量Util工具,用來處理應用程序開發過程中通常會遇到的一般性問題,進一步減少應用程序開發者的工作負擔。
★ 平緩的學習曲線:平緩的學習曲線:學習使用JessMA只需掌握一定的Core Java與JSP/Servlet知識,本開發手冊會循序漸進闡述每個知識點,每個知識點都會結合完整的示例進行講述,知識點之間前后呼應,確保學習者在學習時溫故知新,融會貫通。
★ 完善的技術支持:除了提供完善的開發手冊和示例代碼以外,還提供博客和Q~Q~群用于解答使用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.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)。
* JessMA 應用程序依賴關系

基礎應用框架、MVC框架和DAO框架都依賴于公共組件,其中基礎應用框架同時依賴于DAO框架,因此,MVC框架和DAO框架能脫離JessMA單獨使用(當然,要附帶上公共組件)。例如:可以把MVC框架和DAO框架用于JessMA之外的其它Web項目;也可以把DAO框架用于非Web項目(如:Swing / SWT桌面應用)。
JessMA 3.2.1 更新:
1、Portal-Basic 框架正式更名為 JessMA
1) JessMA 的版本號沿用 Portal-Basic 的版本號
2) 包名稱 com.bruce.* 統一改為 org.jessma.*
2、mvc-confing.xml 中增加 <base-path> 配置項,支持自定義 ${__base} 變量
1) base-path.type 有三種類型:'auto','manual','none',其中 'auto' 為默認類型
2) 'auto':根據當前請求的路徑信息自動設置 ${__base}(${__base} 保存在 Request Attribute 中)
${__base} = {scheme}://{server_name}:{server_port}/{app_context}
3) 'manual':在 MVC 配置文件中手工設置 ${__base}(${__base} 保存在 Application Attribute 中)
4) 'none':不設置 ${__base}
3、mvc-confing.xml 中增加 <result-path-aliases> 配置項,支持用別名置換 Action Result 的路徑
例如:
<result-path-aliases>
<alias name="index" path="/jsp/index.jsp"/>
<alias name="jsp_base" path="/jsp/test"/>
</result-path-aliases>
以下的幾個配置是等效的:
1) 不使用別名
<result>/jsp/index.jsp</result> 或注解 @Result(path="/jsp/index.jsp")
<result>/jsp/test/my.jsp</result> 或注解 @Result(path="/jsp/test/my.jsp")
2) 使用別名
<result>${index}</result> 或注解 @Result(path="${index}")
<result>${jsp_base}/my.jsp</result>或注解 @Result(path="${jsp_base}/my.jsp")
4、支持在不重啟服務器的情況下,動態更新應用程序配置
1) 更新 MVC 配置。org.jessma.mvc.ActionDispatcher 增加方法:
A) reload(delay)更新 MVC 配置
B) pause() 暫停 MVC 組件
C) resume() 恢復 MVC 組件
D) 以上三個方法配合使用:pause() -> reload(delay) -> resume()
2) 更新 REST 配置。org.jessma.ext.rest.RestDispatcher 增加方法:
A) reload(delay)更新 REST 配置
B) pause() 暫停 REST 組件
C) resume() 恢復 REST 組件
D) 以上三個方法配合使用:pause() -> reload(delay) -> resume()
3) 更新應用程序配置文件(app-config.xml)的 <user> 節點。org.jessma.app.AppConfig 增加方法:
A) reloadUserConfig(delay)調用由 <system>/<user-config-parser> 節點定義的 UserConfigParser 的 parse(user) 方法重新加載 <user> 節點的配置信息
B) 執行更新前通常需要暫停 MVC 組件 或 REST 組件(調用它們的 pause() 方法)
5、修改 org.jessma.util.Logger,使 Logger 類更通用
1) 默認日志記錄器:應用程序默認日志記錄器的名稱為 'JessMA',可以調用 Logger.getDefaultLogger() 獲取默認日志記錄器
2) 其他日志記錄器:應用程序可以在任何地方調用 new Logger("<logger_name>") 獲取在 log4j.properties 中配置的其他日志記錄器
6、增加一個 JDBC SessionMgr
1) org.jessma.dao.jdbc.JdbcSessionMgr :沒有使用連接池的 JDBC SessionMgr
7、其它更新
1) 原測試工程 MyPortal 改為 MyJessMA
2) 原依賴庫 portal-basic-lib 改為 jessma-lib
3) 依賴庫 “jessma-lib” 和 “spring-lib” 中的所有 jar 包更新到最新版本
4) 更好地支持在 GAE、BAE 和 OpenShift 等云平臺中部署 JessMA 應用程序
5) 更新開發手冊《JessMA 高效 Java MVC & REST 開發框架 (v3.2)》
6) 官方網站 www.jessma.org 將陸續提供各項技術支持
8、應用程序升級說明
JessMA 3.2.1 在功能方面完全兼容 Portal-Basic 3.1.1,原有應用程序升級到 JessMA 3.2.1 需做以下工作:
1) 應用程序中所有用到 com.bruce.* 的地方都改為 org.jessma.*
2) 修改 XML 配置文件的 XSD Schema 引用(參考 MyJessMA 測試工程)
3) 如果應用程序用到 org.jessma.util.Logger,則獲取日志記錄器對象的代碼要作一些調整(參考 MyJessMA 測試工程)
4) 如果應用程序用到 base.jsp,則用 JessMA 3.2.1 的 jessma-base.jsp 替換原來的 base.jsp
JessMA 更新歷史:ChangLog.txt
開發文檔目錄:

CodeProject
原文出處:怪獸的博客 怪獸的微博 怪獸樂園Q群