共同编写 Smart 2.0 开发指南

1         工具

1.1    准备开发工具

描述开发 Smart 应用所须要的开发工具及其安装步骤，包括：IDE、JDK、Maven、Git 等。 有必要时可以使用截图，但不要大量使用。 需突出开发工具的版本号，以避免误导用户使用不兼容的软件。

1.2    搭建开发环境

描述搭建开发环境的操做步骤及其注意事项。 对于操做步骤可以使用截图与文字进行描述。 分别针对 Eclipse 与 IDEA 进行说明。

 

2         入门

用一个 Hello World 示例让读者学会如何使用 Smart 开发应用。 前端使用认识度较高的 JSP 技术进行展示，使用 jQuery 与 Bootstrap，可参考 Smart Bootstrap 项目。 不要大量使用的 Smart 功能特性，目标仅在于让读者能够跟着步骤自行搭建 Smart 应用开发框架。

 

3         架构

3.1    技术选型

使用表格的方式展示 Smart 框架使用到的开源项目。 简要说明每项选型的选择缘由。

3.2    项目依赖

经过一张图来展示 Smart 框架所使用的程序包之间的依赖关系。 经过一张表格来展示依赖程序包的详细状况，包括：文件大小、版本号、最后更新日期等。 在表格下方需给出依赖程序包的总文件大小。

3.3    系统架构

给出一张系统架构图，列举出最重要特性，以及框架与插件之间的关系。 使用“类图”描绘框架的静态结构。 使用“时序图”描绘一个请求的生命周期。 经过一张图来展示插件的生命周期，并简要描述插件的开发过程。

 

4         特性

经过代码片断与文字描述的方式，分别对框架的每种特性进行说明。 可以使用   Smart   Sample 中相关代码。 可在代码片断中增长必要性的代码注释。 可在文字描述中引用外部连接，如：博客地址、相关参考文档等。

4.1    MVC

4.2    IOC

4.3    AOP

4.4    ORM

4.5    DAO

4.6    事务控制

4.7    异常处理

4.8    单元测试

 

5         插件

代码片断加文字描述的方式，分别对每一个插件的基本用法进行说明。 可以使用   Smart   Sample 中相关代码。 需对插件所使用的开源技术进行说明。 可引用相关参考资料，如：博客地址、开源项目官网等。

5.1    Cache

5.2    WebService

5.3    Mail

5.4    I18N

5.5    Job

5.6    Hessian

 

6         附录

6.1    经常使用 API

对平常开发过程当中用户使用较为频繁的 API 进行描述。 使用表格的方式对 API 进行汇总。 使用 Cookbook 的方式展现 API 的使用方法。

6.1.1        Result

6.1.2        Page

6.1.3        DataSet

6.1.4        DataContext

6.2    代码生成器

描述 Smart 代码生成器的安装与使用方法。