Web平台开发手册.docxVIP

修订记录 日期 版本 修订目的描述 修订章节 作者 审核 文档初建 黄秀伟 文档内容完善 黄秀伟  目录 \ \ \ \ \ 修订记录 \ \ 说明 \ \ 概述 \ \ 子系统命名 \ \ 资源准备 \ \ 项目发布 \ \ 模块化开发 \ \ 开发协作方式 \ \ 工程目录规范 \ \ 目录： \ \ 目录 \ \ 目录 \ \ 目录 \ \ 配置文件统一管理 \ \ 开发步骤 \ \ 导入项目 \ \ 配置菜单 \ \ 新建模块 \ \ 功能开发 \ \ 模型 \ \ 权限配置 \ \ 菜单配置 \ \ 操作配置 \ \ 权限注解 \ \ 角色授权 \ \ 支持 \ \ 概念 \ \ 开发 \ \ 操作日志记录 \ \ 实现原理 \ \ 使用方法 \ \ 表单验证 \ \ 图表 \ \ 简介 \ \ 使用方法 \ \ 报表模块 \ \ 简介 \ \ 使用方法 \ \ 系统变量 \ \ 用户首选项 \ \ 打包部署 \ \ 进阶配置 \ 说明 概述 本文档是平台开发手册，根据项目需要，结合泰合对项目级系统开发平台的要求而编写的，面向项目开发人员，包括开发规范及开发流程等。 平台将提供给用户开发手册、工程及项目使用的软件包。 子系统命名 我们需要各子系统确定英文简称，因为项目开发中的权限控制注解、菜单、数据库名、项目发布名都要用到子系统简称。参见下表： 子系统名称 子系统简称 门户子系统 工作流系统 数据子系统 解析子系统 批处理子系统 ？ 资源准备 项目开发在 位系统上，部署在系统上。 为了避免一些兼容性问题，请使用我们的提供的软件包进行开发，包括、、、 、等。 本框架使用的组件及版本如下表： 组件名称 版本号 项目发布 由于各组之间的项目发布名称不能重复，故规定发布的项目名称为子系统英文简称，各组拿到项目后首先要将发布名称修改为自己的子系统简称。参见子系统统命名章节。 修改方法如下： 项目导入后，右键项目名称—选择 – ?将 内容改为子系统简称。 模块化开发 开发协作方式 采用协作开发方式，平台与其他系统做协作开发，我们会将平台本身的功能打成包形式，其他组不允许修改平台的源码，只能在现有平台上按照规范开发自己系统的功能。 工程目录规范 工程要严格按照框架要求进行开发。 目录： 用来存放开发模块的类及部分配置文件。在目录的的包下新建模块。 格式：.模块名 在模块下面建包，包名称要严格按照以下规范命名： 包：存放自己的访问控制层，因为要通过扫描所有的方法名来记录日志，所以命名必须为，。 包：存放实体类 包：存放自己的接口，在存放实现类 包：存放的接口，在下存放自己的实现类 目录 目录存放脚本、样式、图片等静态资源。 分别在，，下建子文件夹（要求文件夹名称与模块名相同）存放各个模块的，，文件。 目录 目录中存放页面。 在文件加下建子文件夹（要求文件夹名称与模块名相同）存放各个模块的文件。 目录 在文件夹或包名是的目录，存放的是平台所用的组件，其中目录下存放的是通用组件。 由于框架升级原因不允许对下的目录做任何操作，（升级时会覆盖这个目录下的文件，如果有需要请联系架构组人员）。 配置文件统一管理 框架对配置文件进行统一管理，必须按照以下配置文件名称命名。 基础配置文件：必须功能 ：菜单配置文件，存放在下的目录下，为了初始化时提供一个界面，如果没有配置系统则会自动加载中的菜单。 后台表单数据校验的配置文件，存放在下，后台校验必须要有。 高级进阶配置文件：非必须功能。参见进阶配置章节。 开发步骤 导入项目 我们会给出一个工程，拿到工程后首先导入，在数据库中创建数据库，库名称为子系统简称。 在根目录下的文件夹中建脚本文件，名称为”子系统简称” （非必须, 如果没有脚本可以省略）。 手动初始化，执行下的脚本导入数据库（打包不打进去），启动无报错后进行下一步。 配置菜单 导入项目后第一件事就是确定配置系统的菜单，菜单是通过文件配置的。该文件存放在：子系