Portal-Basic Java Web 应用开发框架：应用篇（十三） —— REST Convention

 

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

---

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 请求

---