Portal-Basic v3.1.1 beta-1 示例工程发布

  portal-basic 3.1.1 已开发完成，正在编写帮助文档，将于近期发布。现在先发布 portal-basic 3.1.1-BETA-1 的示例工程供大家下载试用，体验新特性。同时希望收集一些意见反馈。谢谢 *_^

    注：本示例工程增加了 “异步 Action” 和 “异步 REST Action” 示例。

---

 

Portal-Basic Java Web应用开发框架（简称 Portal-Basic）是一套功能完备的高性能Full-Stack Web应用开发框架，内置稳定高效的MVC基础架构和DAO框架（已内置Hibernate、MyBatis和JDBC支持），集成 Action拦截、Form Bean / Dao Bean / Spring Bean装配、国际化、文件上传下载和缓存等基础Web应用组件，提供高度灵活的纯 Jsp/Servlet API 编程模型，完美整合 Spring，支持Action Convention“零配置”，能快速开发传统风格和RESTful风格的Web应用程序，文档和代码清晰完善，非常容易学习。

Portal-Basic 源码、示例及文档资源：请访问 google code 项目 ^_*

Portal-Basic在设计之初就充分注重功能、性能与使用体验。Portal-Basic主要特点：

1) 功能全面：内置稳定高效的MVC基础架构和DAO框架，支持Action拦截、Form Bean / Dao Bean / Spring Bean装配和声明式事务，提供国际化、文件上传下载、缓存和页面静态化等常用Web组件，能满足绝大部分Web应用的需要。

2) 高度扩展：Portal- Basic通过的plug-in机制可以灵活扩展，Portal-Basic发布包中自带的portal-basic-ext-rest和portal- basic-ext-spring均以插件的形式提供，用户可根据需要加载或卸载这些插件。应用程序开发者也可以根据实际需要编写自定义插件来扩展 Portal-Basic。

3) 强大的整合能力：Portal- Basic是一个Full-Stack框架，同时也是一个开放式框架，可以以非常简单的方式整合第三方组件。本开发手册会详细阐述如何在Portal- Basic中整合FreeMarker、Velocity、UrlRewrite、EHCache-Web、Spring、Hibernate和 MyBaits等常用框架和组件。

4) 高性能：性 能要求是Portal-Basic的硬性指标，从每个模块的设计到每行代码的实现都力求简洁高效。另外，Portal-Basic并没有对 JSP/Servet API进行过多封装，开发者仍然使用JSP/Servet API开发应用程序，没有过多的迂回，性能得到保证。

5) 优秀的使用体验：Portal- Basic的设计目标之一是提供良好的开发体验，尽量减少应用程序开发者的工作，API的设计力求简单、完整、明确。同时，Portal-Basic为应 用开发提供了大量Util工具，用来处理应用程序开发过程中通常会遇到的一般性问题，进一步减少应用程序开发者的工作负担。

6) 平缓的学习曲线：平缓的学习曲线：学习使用Portal-Basic只需掌握一定的Core Java与JSP/Servlet知识，本开发手册会循序渐进阐述每个知识点，每个知识点都会结合完整的示例进行讲述，知识点之间前后呼应，确保学习者在学习时温故知新，融会贯通。

7) 完善的技术支持：除了提供完善的开发手册和示例代码以外，还提供博客和QQ群用于解答使用Portal-Basic过程中碰到的所有问题。接下来，将计划建设一个Portal-Basic技术论坛。

---

Portal-Basic 3.1.1 更新：

1、支持异步 Action（“异步处理” 是 Servlet 3.0 的新特性之一）：

1) com.bruce.mvc 包中增加异步任务接口 AsyncTask 及实现类 AbstractAsyncTask、ActionTask
2) com.bruce.mvc.ActionSupport 增加异步处理相关方法：startAsync(...)

2、支持异步 REST Action（在 portal-basic-exe-rest-3.1.1 插件中实现）：

1) com.bruce.ext.rest 包中增加 REST 异步任务实现类 RestActionTask
2) com.bruce.ext.rest.RestActionSupport 增加异步处理支持

3、增加两个 JDBC SessionMgr：

1) com.bruce.dao.jdbc.DruidSessionMgr ：使用 Druid 连接池连接数据库
2) com.bruce.dao.jdbc.JndiSessionMgr  ：使用 JNDI 连接池连接数据库

 4、其它更新：

1) 测试工程 MyPortal 加入异步处理 Action 请求和异步 Rest Action 请求示例
2) 测试工程 MyPortal 的所有 Hibernate 和 JDBC 示例都使用 Druid 取代原来的 Proxool 连接池
3) 开发手册《Portal-Basic Java Web 应用开发框架(v3.1.20130420)》加入 “异步 Action” 章节
4) Portal-Basic 的依赖库 “portal-basic-lib” 和 “spring-lib” 中的所有 jar 包更新到最新版本

 5、应用程序升级说明：

1) Portal-Basic 3.1.1 的 “异步处理” 功能只适用于支持 Servlet 3.0 的应用环境（如：JaveEE 6 / Tomcat 7）
2) 如果应用环境不支持 Servlet 3.0（如：JaveEE 5 / Tomcat 6），则只能使用原有功能
3) Portal-Basic 3.1.1 不再提供 JDK 1.5 的兼容版本
4) Portal-Basic 3.1.1 完全兼容 Portal-Basic 3.0.1 （非 JDK 1.5 版本）

---

 Portal-Basic 3.0.1 更新：

1、增加 Action Convention，支持“Action 零配置”：

1) 根据 Action 请求的地址信息自动加载 Action，并调用相应的入口方法处理请求
2) 根据 Action 请求的地址信息和 Action Result 自动组合出输出页面的地址并转发
3) 通过 @Result/@Results 和 @ExceptionMapping/@ExceptionMappings 注解自定义 Result 和 Exception 处理策略

2、增加 REST 支持：

1) 增加 REST 插件包 portal-basic-ext-rest-3.0.1.jar 用于支持 REST
2) portal-basic-ext 通过 com.bruce.ext.rest.RestDispatcher 过滤器把 REST 请求转换为 Action 请求
3) portal-basic-ext 提供 com.bruce.ext.rest.RestActionSupport 作为处理 REST 请求的 Action 基类
4) Action 的 REST 请求处理方法通过声明 @Get/@Post/@Put/@Delete 注解来匹配 REST 地址格式，并注入参数
5) 内置 Rails-style REST 标准方法
6) 同时支持 HTML/XML/JSON 三种视图格式，应用程序也可以扩展自己的视图格式
7) portal-basic-ext 与 Action Convention 结合使用能实现“零配置”处理 REST 请求