软件设计说明书-图书管理系统

1、.图书管理系统设计说明书编写：校对：审核：.目录1引言 .32程序系统的结构 . .33程序（标识符）设计说明 . .44还书模块 .95图书查询模块 .136系统操作模块 .16参考资料 .37.1 引言1. 1 目的根据需求规格说明书 、概要设计说明书 ，在仔细考虑讨论之后，我们对图书管理系统软件的功能划分、数据结构、软件总体结构的实现有了进一步的想法。我们将这些想法记录下来，作为详细设计说明书，为进一步设计软件、编写代码打下基础。1.2 概述随着社会信息量的与日俱增，作为信息存储的主要媒体之一图书，数量、规模比以往任何时候都大的多，不论个人还是图书管理部门都需要使用方便而有效的方式来管理

2、自己的书籍。在计算机日益普及的今天， 对个人而言若采用一套行之有效的图书管理系统来管理自己的书籍，会方便许多。对图书管理部门而言，以前单一的手工检索已不能满足人们的要求，为了便于图书资料的管理需要有效的图书管理软件。本图书管理系统软件是一套功能比较完善的数据管理软件，具有数据操作方便高效迅速等优点。该软件采用功能强大的数据库软件开发工具进行开发，具有很好的可移植性，可在应用范围较广的 dos、 windows系列等操作系统上使用1.3 定义文档中采用的专门术语的定义及缩略词简要如下：lms： library management system，图书管理系统2 程序系统的结构系 统 操 作 模

3、块图书查询读 者 查系统操作询输输更改图书库读者库数据系统数据数据入出口令操作操作统计设置备份恢复.3 程序（标识符）设计说明3.1 主模块功能初始化建立与数据库连接获取系统设置运行主对话框根据输入调用子模块借还图系退出系统时断开与数据库的连接书书书统输入项目模模查查用户鼠标点击输入块块询询模模程序逻辑块块见右图存储分配内部数据：数据库连接m_pconnection_connectionptr数据库连接指针m_isconnectedbool数据库连接指示系统设置m_maxlbnumint可借图书数上限m_maxlbdayint借书天数上限子对话框m_bookoutdlgcbookoutdlg借

4、书对话框m_bookindlgcbookindlg还书对话框m_bookquirydlgcbookquirydlg图书查询对话框m_sysdlgcsysdlg系统操作对话框测试要点数据库连接情况：正常情况，数据库文件缺少，外部系统异常。系统设置获取：正常情况，外部系统异常。对用户输入的响应：合法输入，能够正常调用子模块；非法输入，系统能否辨别，并作出响应( 提出警告 ) ；子模块的异常状况，系统能否及时做出响应。3.2 借书模块功能查验输入的读者证号运行借书对话框获取该读者的相关信息查验输入的图书号登记借书输入项目读者证号、图书书号( 用户输入 )输出项目读者信息 ( 姓名 ) ；读者已借图书

5、信息 ( 书名、借书日期 ) ；程序逻辑.对话框初始化操作取消输入读者证号查 验输入不合理借书对话框点击返回查验出错借书登记更新相关信息及显示关闭对话框接口调用形式： void cbookdlg:lendbook(const _connectionptr pconnection,const int maxlbnum)传入参数： pconnection数据库连接指针maxlbnum 系统参数 ( 可借图书上限 )传出参数：无存储分配内部数据：数据库m_pconnection_connectionptr数据库连接指针用户界面m_strreadername cstring读者姓名m_strlbinf

6、cstring已借图书信息m_strlbnumcstring已借图书数显示m_lbookidlong欲借图书书号内部参数m_lreaderidlong当前读者证号m_maxlbnumint可借图书数上限测试要点模块正常运行流程用户输入数据检查 ( 读者证号、图书书号 ) ，包括数据合理性检查，以及合法性检查数据库操作数据库连接异常时的响应情况.3.2.1读者查验模块功能查验输入的读者证号是否合法( 即是否存在与该读者证号对应的读者记录)输入项目读者证号 ( 整型常数 ) ，读者姓名 ( 引用型字符串)输出项目查验结果 (bool值 )程序逻辑生成数据库查询语句调用数据库查询模块if 返回结果集

7、为空( 不存在该读者证号)置读者姓名字符串为空返回”非法读者证号”else置读者姓名字符串返回”合法读者证号”接口调用形式： bool checkreader(const long readerid,cstring &strreadername)传入参数： readerid( 常量参数传入 )待查验的读者证号m_pconnection(借书模块内的全局变量 )数据库连接指针传出参数：读者证号存在/ 不存在标志 ( 返回值 )strreadername(传入的引用参数 ) 读者证号对应的读者姓名( 读者证号不存在时置为空 )存储分配局部变量：数据库preader_recordsetptr数据库查

8、询结果集指针查询参数vtquiry_variant_t查询命令vnull_variant_t查询连接类型转换strquirycstring查询命令类型转换vtemp_variant_t查询结果类型转换测试要点数据库连接正常时输入合理合法参数输入参数不合理输入参数不合法数据库连接异常；数据库数据异常( 读者姓名为空)3.2.2图书查验模块功能查验输入的图书书号是否合法输入项目图书书号 ( 整型常量 )输出项目查验结果 (bool值 )程序逻辑生成数据库查询语句.调用数据库查询模块if 返回结果集为空( 不存在该图书书号)返回”非法图书书号”else返回”合法图书书号”接口调用形式 :bool c

9、heckbook(const long bookid)传入参数 :bookid( 整型常量 )带查验的图书书号传出参数 :书号合法 / 不合法标志 ( 返回值 )查验结果存储分配局部变量 :数据库pbook_recordsetptr数据库查询结果集指针查询参量vtquiry_variant_t查询字符串vnull_variant_t查询连接参量类型转换strquirycstring查询命令类型转换测试要点数据库连接正常数据库数据正常输入的书号合理合法输入的书号不合理输入的书号不合法数据库数据异常数据库连接异常3.2.3相关信息获取模块功能获取合法读者的借书记录输入项目合法读者证号( 整型常量

10、) ；读者已借图书信息( 引用型字符串 )输出项目查询操作结果(bool值 )程序逻辑生成数据库查询语句调用数据库查询模块if操作成功while 查询结果集未读至文件尾读取各项值置入读者已借图书信息字符串返回”操作成功”else置空读者已借图书信息字符串返回”操作失败”接口调用形式： bool getlbinf(const long readerid,cstring &strlbinf)传入参量： readerid( 整型常量 )查询参数strlbinf(引用型字符串 )返回用的格式化的查询信息.传出参量：查询成功 / 失败标志 (bool值 ) 查询操作结果信息存储分配局部变量 :数据库pr

11、ecords_recordsetptr数据库查询结果集指针查询参数vtquiry_variant_t查询命令字符串vnull_variant_t查询连接参量类型转换strquirycstring查询命令类型转换测试要点数据库连接正常数据库数据正常输入正常 ( 读者证号合法)输入异常 ( 读者证号非法)数据库数据异常数据库连接异常3.2.4借书登记模块功能登录借书信息输入项目读者证号 ( 整型常量 ) ；图书书号 ( 整型常量 )输出项目操作结果 (bool值 )程序逻辑生成数据库操作命令调用数据库操作模块if操作成功返回”操作成功”else返回”操作失败”接口调用形式： bool writeb

12、lrecord(const long readerid,const long bookid)传入参数： readerid( 整型常量 )操作参数 ( 借阅者读者证号 )bookid(整型常量 )操作参数 ( 借阅图书书号 )传出参数：操作成功/ 失败标志 ( 返回值 )存储分配局部变量 :操作命令参数vrecsaffected_variant_t操作影响vtcommand_variant_t操作命令类型转换strcommandcstring操作命令类型转换strtodaycstring借书日期类型转换oletodaycoledatetime借书日期测试要点数据库连接正常数据库操作正常输入参数合

13、法.输入参数非法数据库操作异常数据库连接异常4 还书模块功能运行还书对话框查验输入的图书书号对合法输入登录还书信息显示相关信息( 本次还书操作信息，尚未归还图书的相关信息，读者信息)输入项目图书书号 ( 用户输入 )输出项目相关信息 ( 本次还书操作信息，尚未归还的图书信息，读者信息)程序逻辑初始对话框点击退出出错返回借书记录查验模块登记还书更新还书信息及显示关闭对话框接口调用形式： cbookindlg:returnbook(const _connectionptr pconnection,const int maxlbday)传入参量： pconnection(数据库连接指针常量)提供数据

14、库连接maxlbday( 整型常量 )系统参数 ( 借书天数上限 )传出参量：无存储分配内部变量：数据库m_pconnection_connectionptr数据库连接指针m_precords_recordsetptr数据库查询结果集指针用户界面m_lbookidlong欲还图书书号m_strlenderidcstring借阅者图书证号显示m_strlendercstring借阅者姓名m_strrbinfcstring已还图书信息显示m_strnrbinfcstring未还图书信息显示.m_strrbnumcstring已还图书数显示m_strnrbnumcstring未还图书数显示内部参数m

15、_lcurridlong当前还书者读者证号m_intrbnumint已还图书计数m_maxlbdayint借书天数上限测试要点模块正常工作流程对输入的查验，包括输入值的合法性与合理性检验数据库连接异常能否做出适当处理数据库数据异常时能否判断并给予适当处理4.1借书记录查验模块功能查验借书记录是否存在( 即是否存在与指定书号相对应的借书记录)输入项目图书书号 ( 传入参数 )输出项目查验结果 ( 返回值 ) ；查询结果集 ( 图书书号、书名、状态、出借日期)程序逻辑生成数据库查询语句调用数据库查询模块if操作成功if 查询结果集不为空( 存在该借书记录)返回”记录存在”else警告”记录不存在”

16、else警告”查询失败”返回”记录不存在”接口调用形式： bool checkblrcord(const long bookid)传入参量： bookid( 整型常量 )传出参量：书号合法/ 非法标志 (bool型 )存储分配局部变量：查询参数vtquiry_variant_t查询命令vnull_variant_t查询连接类型转换strquirycstring查询命令类型转换引用的全局变量：m_pconnection_connectionptr使用m_precords_recordsetptr写 ( 打开 )测试要点数据库连接正常数据库数据正常合法的图书书号返回“真”查验结果.不合法的图书书号

17、返回“假”查验结果，给出警告提示数据库数据异常返回“假”查验结果，给出数据异常警告数据库连接异常返回“假”查验结果，给出数据库连接异常警告4.2相关信息获取模块功能获取指定读者 ( 读者证号 ) 的借书记录，获取的信息包括所借图书书名，借书日期以及所借图书的总本数。输入项目读者证号 ( 传入参数 ) ；相关 ( 借书 ) 信息 ( 公共变量 )输出项目已借图书数 ( 返回值 )程序逻辑生成数据库查询命令if操作成功初始化 ( 相关信息字符串置为空已借图书计数置为0)while 未读至查询结果集尾置相关信息字符串计数累加返回计数值else置相关信息字符串为”操作异常”返回”失败标志”(-1)接口

18、调用形式： int getlbinf(const long readerid)传入参数： readerid( 整型常量 )指定的读者证号传出参数：获取的相关记录数( 整型 )如发生异常，返回值置为负存储分配局部变量：查询参数vtquiry_variant_t查询命令vnull_variant_t查询连接类型转换strquirycstring查询命令类型转换vtemp_variant_t查询结果类型转换oledatecoledatetime借书时间类型转换记录计数countint计算获取的记录数引用的全局变量: m_pconnection_connectionptr使用m_precords_re

19、cordsetptr写 ( 打开、关闭 )m_strnrbinfcstring写测试要点数据库连接正常数据库数据正常可获取的借书记录数为零返回结果为0，引用字符串置空可获取的借书记录数不为零返回记录数， 并将相关信息记录在引用字符串中数据库数据异常返回异常指示，给出警告数据库连接异常返回异常指示，给出警告.4.4还书信息记录模块功能记录本次还书操作的信息，包括图书书名，超期天数。输入项目包含相关信息( 书名、借书日期) 的查询结果集( 公共变量 )输出项目更新后的格式化还书信息( 公共变量 )程序逻辑while 传入的查询结果集未读至文件尾读取书名 , 置入还书信息字符串读取借书日期计算超期天

20、数置入还书信息字符串光标移至下一个记录接口调用形式： void saverbinf(void)传入参数：无传出参数：无存储分配局部变量：类型转换vtemp_variant_t查询结果类型转换strexcesscstring超期天数类型转换计算变量oledatecoledatetime借书日期oleexcesscoledatetimespan超期天数intexcessint超期天数引用的全局变量： m_precords_recordsetptr读 ( 关闭记录集 )m_strrbinfcstring更新m_maxlbdayint读测试要点查询结果集正常查询结果集异常4.5还书登记模块功能登记还书

21、 ( 删除借书记录，更新图书状态)输入项目图书书号 ( 输入参数 )输出项目操作成功 / 失败标志 ( 返回值 )程序逻辑生成数据库操作命令( 更新 )if操作成功生成数据库操作命令( 删除 ).if操作成功返回”操作成功”返回”操作失败”接口调用形式： bool delblrecord(const long bookid)传入参数： bookid( 整型常量 )返还图书书号传出参数：操作成功/ 失败标志 (bool值 )存储分配局部变量：操作参数vtcommand_variant_t操作命令vrecsaffected_variant_t操作影响参数类型转换strcommandcstring操

22、作命令类型转换引用的全局变量：m_pconnection_connectionptr使用测试要点数据库连接正常图书书号合法图书书号不合法数据库连接异常5 图书查询模块功能根据给定查询条件，查询数据库，获取图书信息输入项目查询方式指定以及查询关键字输出项目查询结果列表显示程序逻辑初始化对话框查询生成查询命令查询数据库显示结果列表退出.接口调用形式： cbookquirydlg:quirybook(const _connectionptr pconnection)传入参数： pconnection(数据库连接指针)传出参数：无存储分配内部变量：数据库m_pbooks_recordsetptr数据库

23、查询结果集指针用户界面m_strauthorcstring作者关键字m_bauthorbool作者查询选择状态m_strbooknamecstring书名关键字m_bbooknamebool书名查询选择状态m_strpublishercstring出版社关键字m_bpublisherbool出版社查询选择状态m_intyear1int出版时间关键字m_intyear2int出版时间关键字m_intmonth1int出版时间关键字m_intmonth2int出版时间关键字m_bpubtimebool出版时间查询选择状态m_inttimetypeint出版时间查询方式选择局部变量：查询参数vtqu

24、iry_variant_t查询命令vnull_variant_t查询连接类型转换strquirycstring查询命令类型转换测试要点数据库连接正常数据库数据正常获得正确的查询结果并显示数据库数据异常给出警告数据库连接异常给出警告5.1查询命令生成模块功能根据用户界面的输入生成查询命令输入项目用户界面的输入值( 公共变量 )输出项目查询命令 ( 返回值 )程序逻辑读取各复选框的值if选中 and 关键字不为空生成查询条件生成数据库查询命令返回生成的查询命令接口调用形式： cstring getquirystring()传入参数：无.传出参数：查询命令(cstring)存储分配局部变量：strq

25、uirycstring查询命令字符串strtempcstring临时字符串测试要点用户输入合理用户输入不合理( 没有指定查询方式，没有输入查询关键字)5.2数据库查询模块功能根据输入的查询命令查询数据库输入项目查询命令 ( 传入参数 )输出项目数据库查询结果( 返回值 ) ；数据库查询结果集( 公共变量 )程序逻辑查询数据库if操作成功返回”操作成功”else返回”操作失败”接口调用形式： bool dbquiry(const cstring strquiry)传入参数： strquiry(字符串型常量 )数据库查询命令传出参数：查询操作成功/ 失败标志 (bool值 )存储分配局部变量：查询

26、参数vtquiry_varaint_tvrecsaffected_variant_t引用的全局变量：m_pconnection_connectionptrm_pbooks_recordsetptr数据库查询命令数据库查询连接使用读测试要点数据库连接正常输入查询命令合法获取非空查询结果集返回“真”返回值，查询结果保存在查询结果集中获取空查询结果集返回“真”返回值，查询结果集为空输入查询命令不合法返回“假”返回值，查询结果集指针指向空，给出警告数据库连接异常5.3数据显示模块功能按一定格式列表显示查询结果，并根据用户要求重排列输入项目查询结果集 ( 传入参数 ) ；输出项名称( 传入参数 ) ；查

27、询结果表参数，包括行数、列数( 传入参数 ).输出项目用户界面显示程序逻辑初始化 ( 设置行数、列数、列名称，载入输入的查询结果集内的数据)显示列表while 用户未输入“返回”if用户拖动列的标题栏重新设置列的位置排序刷新显示返回接口调用形式： clistshowdlg:showlist(const _recordsetptr precords,cstring *strarray,const int cols,const int rows)传入参数： precords( 数据库查询结果集指针)需要显示的查询结果strarray( 字符串数组头指针)显示项的名称( 列名 )cols( 整型常量

28、 )列表列数rows( 整型常量 )列表行数传出参数：无存储分配内部数据：数据库m_precords_recordsetptr数据库查询结果集内部参数m_strarraycstring20列名存储数组m_intcolsint列表列数m_introwsint列表行数m_cltfgridcmsflexgrid列表控件m_imousecolint用户鼠标所在列测试要点查询结果正常查询结果集为空显示消息框提示查询结果集不为空正常显示结果列表，并根据用户输入调整输出查询结果异常显示警告6 系统操作模块功能验证输入的系统操作员账号以及口令，完成权限管理运行系统操作对话框，根据用户输入调用各子模块，完成：图

29、书库操作 ( 浏览、修改、增加、删除) ；读者库操作 ( 浏览、修改、增加、删除) ；数据统计；更改口令；系统管理( 修改系统设置，浏览、修改、增加、删除系统操作员) ；输入项目.数据库连接 ( 传入参数 )输出项目无程序逻辑初始化图书操作模块要求输入账号口令读者操作模块返回操作取消数据统计模块系统操作权限查验模块警告系统设置模块账号口令错误 ?返回数据备份初始化系统操作对话框数据恢复until输入 ”返回 ”更改口令关闭对话框接口调用形式： csysdlg:managesys(const _connectionptr pconnection)传入参数： pconnection (数据库连接指

30、针)传出参数：无存储分配内部数据：数据库m_pconnection_connectionptr数据库连接指针子模块m_bookdlgcbookdlg图书库操作子模块m_readerdlgcreaderdlg读者库操作子模块m_quirydlgcquirydlg数据统计子模块m_syssettingdlg csyssettingdlg系统设置子模块内部参数m_strcurrusercstring当前操作者账号m_rightlevelint操作权限局部变量：输入pwddlgcpassworddlg账号口令输入对话框测试要点数据库连接正常正常执行过程输入的账号口令合法根据权限进行显示控制，正常调用各

31、子模块输入的账号口令不合法警告数据库连接异常6.1系统操作权限查验模块功能查验输入的系统操作员账号以及口令是否合法，并返回合法操作员的权限级别输入项目.系统操作员口令( 传入参数 )输出项目操作员权限级别( 返回值 )程序逻辑生成数据库查询命令查询数据库if操作成功if查询结果集非空返回权限级别else显示警告”非法的账号或口令”返回 -1else显示警告”不能查询数据库”返回 -1接口调用形式： checkright(const cstring oldpwd)传入参数： oldpwd( 字符串常量 )待查验的系统操作员口令传出参数：系统操作权限( 整型 ,0-7)如口令非法，置为 -1存储分

32、配局部变量：数据库ptemp_recordsetptr数据库查询结果集指针查询参数vnull_variant_t数据库查询连接vtquiry_variant_t数据库查询命令类型转换strquirycstring查询命令类型转换内部参数resultint权限级别引用的全局变量： m_pconnection_connectionptr数据库连接指针m_strcurrusercstring当前操作员账号测试要点数据库连接正常数据库数据正常合法的账号口令获取相应的权限级别非法的账号口令返回错误指示，给出警告数据库数据异常数据库连接异常6.2 图书库操作模块功能根据输入提供对图书库的浏览、数据修改、增

33、加、删除记录等操作增加记录时，提供对生成的图书书号的唯一性验证删除记录时，提供对所删除记录的相关性检验输入项目数据库连接 ( 传入参数 )输出项目无.程序逻辑初始化 ( 获取数据库连接, 显示对话框 )while 用户未输入退出if用户输入”下一个”更新当前记录移动至下一个记录刷新显示if用户输入”上一个”更新当前记录移动至上一个记录刷新显示if用户输入”移动到”更新当前记录要求输入图书书号if该书号存在移动到指定的记录刷新显示else显示警告”该图书书号不存在”if用户输入”加入”更新当前记录要求输入图书书号if该书号已存在显示警告”该书号已存在”else插入指定图书书号的新记录记录总数加一

34、光标移动至新记录处if用户输入”删除”更新当前记录给出警告”确定继续”if用户确认继续if 该图书借出给出警告”删除相关借书记录”if用户确认删除相关借书记录else中止操作删除该图书记录记录总数减一if 最后一条记录被删除移动至前一条记录else移动至下一条记录.显示刷新更新记录接口调用形式： cbookdlg:managebooks(const _connectionptr pconnection)传入参数： pconnection(数据库连接指针)传出参数：无存储分配内部数据：数据库m_pconnection_connectionptr数据库连接指针m_prs_recordsetptr数

35、据库查询结果集指针用户界面m_lbookidlong当前记录中书号项m_strauthorcstring当前记录中作者项m_strbooknamecstring当前记录中书名项m_strpublishercstring当前记录中出版社项m_upublishyearuint当前记录中出版年项m_upublishmonth uint当前记录中出版月项m_intstatusint当前记录中状态项m_fbookpricefloat当前记录中单价项m_strcurrentbookcstring当前记录位置显示m_strtotalbookcstring记录总数显示内部参数m_intpositionint当

36、前记录位置计数m_lrecordcountlong记录总数计数测试要点数据库连接正常记录集为空是否工作状态正常记录集非空对各种用户输入的响应数据库连接异常6.2.1获取图书记录集模块功能获取所有图书记录，置记录总数以及当前位置的初始值输入项目操作成功 / 失败标志 ( 返回值 )输出项目图书记录集 ( 公共变量 ) ；记录总数 ( 公共变量 ) ；当前位置 ( 公共变量 )程序逻辑生成数据库查询命令查询数据库if操作成功返回”成功”else返回”失败”接口调用形式： bool openrecords()传入参数：无传出参数：操作成功/ 失败标志 (bool值 ).引用的全局变量：m_prs_r

37、ecordsetptr写 ( 打开 )m_intpositionint写m_lrecordcountlong写存储分配局部变量：查询参数vnull_variant_t查询连接vtquiry_variant_t查询命令类型转换strquirycstring查询命令类型转换测试要点数据库连接正常图书记录集为空图书记录集非空数据库连接异常6.2.2更新显示模块功能更显当前显示输入项目图书记录集 ( 公共变量 ) ；用户界面显示字符串( 公共变量 )输出项目更新后的用户界面显示字符串( 公共变量 )程序逻辑逐项读取记录中的数据域置入显示字符串中if当前记录为第一条禁止”前一个”按钮if当前记录为最后一

38、条禁止”后一个”按钮if记录总数为0禁止”加入”以外的所有按钮刷新显示界面接口调用形式： void refreshdataview()传入参数：无传出参数：无引用的全局变量：m_prs_recordsetptr读m_lbookidlong写m_strauthorcstring写m_strbooknamecstring写m_strpublishercstring写m_upublishyearuint写m_upublishmonth uint写m_intstatusint写m_fbookpricefloat写m_strcurrentbookcstring写m_strtotalbookcstring

39、写.存储分配局部变量：类型转换vtemp_variant_t记录集数据域类型转换测试要点记录集正常记录集为空记录集非空记录集异常6.2.3更新当前记录模块功能根据用户界面的输入更新当前记录输入项目用户界面的输入，即用户界面各显示变量的值( 公共变量 )输出项目数据库中更新后的图书记录( 存储文件 ) ；操作成功 / 失败标志 ( 返回值 )程序逻辑保存当前图书书号读入界面的值if书号发生变化给出警告”不能更改图书书号”恢复图书书号的值生成数据库更新语句if更新操作成功重新获取记录集光标移动到原位置返回”成功”else给出警告”操作失败”返回”失败”接口调用形式： bool refreshdata()传入参数：无传出参数：操作成功/ 失败标志 (bool值 )引用的全局变量：m_pconnection_connectionptr使用m_prs_recordsetptr写m_lbookidlong读写m_strauthorcstring读m_strbooknamecstring读m_strpublishercstring读m_upublishyearuint读m_upublishmonth uint读m_intstatusint读m_fbookpricefloat读m_strcurrentbookc