高效 Java Web 开发框架 JessMA v3.2.2 即将发布

JessMA（原名：Portal-Basic）是一套功能完备的高性能 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 在线示例：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 总体架构



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.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、其它更新

1) 修改 org.jessma.util.PackageHelper，加入包扫描相关方法

2) 依赖库 “jessma-lib” 中的所有 jar 包更新到最新版本

3) 更新开发手册《JessMA 高效 Java MVC & REST 开发框架 (v3.2)》

5、应用程序升级说明

1) JessMA 3.2.1 升级到 JessMA 3.2.2：完全兼容，可直接升级

2) Portal-Basic 3.1.1 及更早版本升级到 JessMA 3.2.2：（参考 JessMA 3.2.1 的升级说明）

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