共同编写 Smart 2.0 开发指南

2019独角兽企业重金招聘Python工程师标准>>>

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 代码生成器的安装与使用方法。

转载于:https://my.oschina.net/huangyong/blog/190605