交通政务详细设计说明书基础数据查询服务.docx
《交通政务详细设计说明书基础数据查询服务.docx》由会员分享，可在线阅读，更多相关《交通政务详细设计说明书基础数据查询服务.docx（26页珍藏版）》请在冰豆网上搜索。
交通政务详细设计说明书基础数据查询服务
文件编号：
CVICSE/DZ0183/07-00
分册号：
07/19
页码：
24
密级：
A
山东省交通政务信息系统（二期）
详细设计说明书
数据中心卷
基础数据查询服务
山东省交通厅
山东中创软件工程股份有限公司
二ОО四年十一月
文件变更记录
*A–增加M–修改D–删节
变更版本
日期
图表、表格、段落号
A/M/D
原因与修改情况描述
修订人
审核人
目录
1引言1
1.1编写目的1
1.2背景1
1.3定义1
1.4参考资料1
2系统说明与子系统结构1
3基础数据查询维护2
3.1维护数据目录3
3.2维护数据目录源表、字段和条件5
3.2.1维护目录源表6
3.2.2维护数据目录字段8
3.2.3维护数据目录查询条件12
3.5数据目录访问权限维护15
4基础数据查询18
5性能24
6限制条件24
1引言
1.1编写目的
本阶段的主要任务是根据概要说明书的设计要求，进一步细化设计目标，描述确定最适合的设计方法。
在概要设计系统功能划分的基础上，确定每个模块的具体功能和界面，确定模块之间的调用关系，细化模块之间的接口以及接口的信息结构。
本说明书的编写目的是对本次软件开发的详细设计、约定及相关内容做出具体描述，说明对程序系统的设计考虑，包括其处理流程，组织结构、模块划分、功能分配、接口设计、运行设计，便于指导和帮助编码人员进行编码工作，并作为本项目开发人员、测试人员的指导性文件，作为他们工作的依据之一。
该详细说明书的预期读者主要有评审专家、交通厅领导、事业部分管领导、监理人员、项目组成员、QA人员、测试人员及其他相关人员等。
1.2背景
A、软件系统的名称:
数据中心基础数据查询服务。
B.开发的软件系统的最终用户或适用的领域:
本系统的最终用户为厅机关、厅直单位、17地市交通局。
1.3定义
基础数据查询服务：
基础数据查询的数据范围为数据中心中存储的所有数据。
数据中心对数据层次按主题进行划分，建立数据目录库，完备严格的权限管理机制，提供统一的基础数据查询访问，进一步消除信息孤岛，为交通行业各级部门便捷地查询到所需要的数据提供服务。
1.4参考资料
A.《需求分析说明书—数据中心平台及服务功能》
B.概要设计说明书－基础数据查询服务
C.基础数据查询－数据库设计
2系统说明与子系统结构
基础数据查询服务分为，基础数据查询和基础数据查询维护两部分，其中基础数据查询维护又可以分为，数据目录维护、数据源表维护、数据字段维护、查询条件维护、查询参数维护。
基础数据查询服务的系统结构如下：
模块名称
模块入口
JavaBean
JSP
基础数据查询
/2q_deptapp/sjzx/datasearch/dept/datasearch_manage.jsp
DataSearch.java
DataList.java
DataTable.java
DataField.java
DataWhere.java
DataVar.java
datasearch_manage.jsp
datasearch_inputVar.jsp
datasearch_display.jsp③
基础数据查询维护
数据目录维护
/2q_deptapp/sjzx/datasearch/dept/datalist_manage.jsp
DataSearch.java
DataList.java
数据目录源表维护
/2q_deptapp/sjzx/datasearch/dept/datatable_edit.jsp
DataList.java
DataTable.java
DataField.java
datatable_input.jsp
数据目录字段维护
/2q_deptapp/sjzx/datasearch/dept/datafield_edit.jsp
DataList.java
DataTable.java
DataField.java
datafield_input.jsp①
数据目录查询条件维护
/2q_deptapp/sjzx/datasearch/dept/datawhere_edit.jsp
DataList.java
DataTable.java
DataField.java
DataWhere.java
DataVar.java
datavar_manage.jsp①
数据目录访问权限维护
/2q_deptapp/sjzx/datasearch/dept/dataaccess_manage.jsp
DataACL.java
DataList.java
dataaccess_manage.jsp①
dataaccess_edit.jsp②
3基础数据查询维护
提供对基础数据查询服务进行数据目录的维护、数目目录源表的维护、数据目录字段的维护、数据目录查询条件的维护。
3.1维护数据目录
界面及功能描述
数据目录维护页面1（datalist_manage.jsp）
进入到数据目录维护界面，显示已有的数据目录，用户可以对已有的数据目录进行编辑、删除，也可以添加新的数据目录。
点击目录名称，可以进入到数据目录维护页面2，并传递数据目录id.
录入项要求：
名称
可空
限制说明
数目目录名称
非空
手工录入。
30个字符以内。
状态标志
非空
选择录入，1－有效；0－无效
时序图/协作图
读写表
修改表：
数据目录表（dc2_0_search_datalist）。
主要类及方法说明
数据目录管理对象：
DataList.java
主要方法
处理说明
DataList（intaDataListId）
根据数据目录id，实例化一个数据目录对象
getSql（）
得到与当前数据目录对应的SQL语句
getResultSet（）
得到与当前数据目录对应的结果集
getDataTables（）
得到与数据目录对应的数据源表
getDataFields（）
得到与数据目录对应的数据字段
getDataWhere（）
得到与数据目录对应的数据查询条件
3.2维护数据目录源表、字段和条件
如下图：
数据目录维护页面2
3.2.1维护目录源表
界面及功能描述
数据目录源表录入维护页面datatable_input.jsp
在数据目录维护页面2，在表维护块内，用户可以对已有的数据目录源表进行编辑、删除，也可以添加新的数据目录源表。
点击添加、进入数据目录源表录入维护页面datatable_input.jsp，可以增加需要的表。
录入项要求：
名称
可空
文本说明
数据目录源表
非空
选择录入，将可用的数据源表以列表形式显示出来。
源表引用别名
非空
手工录入，30个字以内。
时序图/协作图
读写表
修改表：
数据目录源表（dc2_0_search_datasource）。
只读表：
表目录表（dc2_0_table），数据目录表（dc2_0_search_datalist）。
主要类及方法说明
数据目录源表管理对象：
DataTable.java
主要方法
处理说明
DataTable（intpkid）
根据id，实例化一个与id对应的数据目录源表管理对象。
getAliasName（）
得到数据目录源表的引用名。
getSrcTableCode（）
得到当前数据目录源表的表代码。
getSrcTableName（）
得到当前数据目录源表的表名称。
3.2.2维护数据目录字段
界面及功能描述
数据目录字段维护页面datafield_edit.jsp
在数据目录维护页面2，在字段维护模块中，用户可以根据需要对已有的字段进行编辑÷删除，点击“添加”、进入到数据目录字段维护界面（上图），并传递数据目录id和数据目录源表id，根据数据目录id和数据目录源表id，列出已有的数据目录字段，用户可以根据需要添加新的数据目录字段。
录入项要求：
名称
可空
限制说明
数据源表
可空
选择录入，从已有的数据源表中选择。
数据源字段
可空
选择录入，从已有的数据源表的字段中选择
字段描述
可空
手工录入，30个字以内
计算公式
可空
手工录入，100个字以内。
显示顺序
可空
手工录入，10个字以内
时序图/协作图
读写表
修改表：
数据目录字段表（dc2_0_search_datafield）。
只读表：
表字段表（dc2_0_field），表目录表（dc2_0_table），数据目录表（dc2_0_search_datalist），数据目录源表（dc2_0_search_datasource）。
主要类及方法说明
数据目录字段管理对象：
DataField.java
主要方法
处理说明
DataField（intpkid）
根据数据目录字段id，实例化一个数据目录字段对象
getExpress（）
得到当前字段的计算公式
getSortNum（）
得到当前字段的顺序
getSrcFieldCode（）
得到当前字段的字段代码
getFieldNote（）
得到当前字段的字段描述
getDataListId（）
得到当前字段的数据目录id
3.2.3维护数据目录查询条件
界面及功能描述
查询参数维护页面datavar_manage.jsp②
查询条件测试界面
在数据目录维护页面2，“查询条件”文本框内可以进行查询条件编辑；用户可以对已有的数据目录查询条件和数据目录查询参数进行编辑，也可以添加、删除数据目录查询参数。
条件编辑完成后，可以点击在数据目录维护页面2中的“测试sql语句”进行条件的测试。
录入项要求：
名称
可空
文本说明
查询条件
非空
手工录入，400个字以内。
查询参数名称
非空
手工录入，30个字以内。
查询参数描述
非空
手工录入，30个字以内。
时序图/协作图
读写表
修改表：
数据目录查询条件表（dc2_0_search_datawhere），数据目录查询参数表（dc2_0_search_var）。
只读表：
数据目录表（dc2_0_search_datalist）。
主要类及方法说明
1、查询条件管理对象：
DataWhere.java
主要方法
处理说明
DataWhere（intpkid）
根据查询条件id，实例化一个与id对应的查询条件管理对象。
getAllDataVar（）
得到当前查询条件所有的查询参数。
getDataListId（）
得到数据目录id。
2、查询参数管理对象：
DataVar.java
主要方法
处理说明
DataVar（intpkid）
根据查询参数id，实例化一个与id对应的查询参数管理对象。
getVarName（）
得到当前查询参数的名称。
getVarNote（）
得到当前查询参数的描述。
getVarValue（）
得到当前查询参数的值。
3.5数据目录访问权限维护
界面及功能描述
数据目录访问权限维护页面dataaccess_manage.jsp
用户数据目录访问权限维护页面dataaccess_edit.jsp②
在数据目录访问权限维护页面，点击“添加”或“权限”、进入到用户数据目录访问权限维护界面，并传递用户id。
在用户数据目录访问权限维护界面，显示用户已经分配的数据目录，也可以添加、删除新的数据目录。
录入项要求：
名称
可空
文本说明
用户帐户
非空
选择录入
数据目录
非空
选择录入
时序图/协作图
读写表
修改表：
数据目录访问权限表dc2_0_search_acl。
只读表：
数据目录表（dc2_0_search_datalist）。
主要类及方法说明
数据目录权限管理对象：
DataACL.java
主要方法
处理说明
DataACL（intpkid）
根据数据目录权限id，实例化一个数据目录权限对象
getAllDataListForRyid（intryid）
得到与ryid相对应的数目目录访问权限。
addDataACL（intadataid,intaryid）
为用户分配新的数据目录访问权限。
deleteDataACL（intapkid）
删除数据目录访问权限。
4基础数据查询
界面及功能描述
基础数据查询页面datasearch_manage.jsp
查询参数录入页面（datasearch_inputVar.jsp）
查询结果显示界面（datasearch_display.jsp）③
当用户进入到基础数据查询页面
时，显示当前用户访问权限范围内的所有数据目录。
点击想要查看的数据目录右边的“查看”按钮，则进入查询参数录入页面②，如果，当前要查看的数据目录不需要用户输入查询参数，则直接进入到查询结果显示页面③，否则要等待用户输入查询参数之后，才能进入到查询结果显示页面③。
录入项要求：
查询参数录入（根据数据目录的不同，查询参数可能有多个）
名称
可空
限制说明
查询参数
非空
手工录入
时序图/协作图
读写表
只读表：
数据目录访问权限表dc2_0_search_acl，数据目录表dc2_0_search_datalist、数据目录源表dc2_0_search_datasource、数据目录字段表dc2_0_search_datafield、数据目录查询条件表dc2_0_search_datawhere、数据目录查询参数表dc2_0_search_var
主要类及方法说明
1、数据目录管理对象：
DataList.java
主要方法
处理说明
DataList（intaDataListId）
根据数据目录id，实例化一个数据目录对象
getSql（）
得到与当前数据目录对应的SQL语句
getResultSet（）
得到与当前数据目录对应的结果集
getDataTables（）
得到与数据目录对应的数据源表
getDataFields（）
得到与数据目录对应的数据字段
getDataWhere（）
得到与数据目录对应的数据查询条件
2、数据目录权限管理对象：
DataACL.java
主要方法
处理说明
DataACL（intpkid）
根据数据目录权限id，实例化一个数据目录权限对象
getAllDataListForRyid（intryid）
得到与ryid相对应的数目目录访问权限。
addDataACL（intadataid,intaryid）
为用户分配新的数据目录访问权限。
deleteDataACL（intapkid）
删除数据目录访问权限。
5性能
在网络正常的情况下，信息的录入、更新、查询的响应时间在10秒以内；批处理的响应时间在1分钟以内。
6限制条件
浏览器至少是InternetExplorer6.0，分辨率推荐使用800*600。
升级会员 