概要设计基于qt的邮箱收发系统的设计与实现Word文档下载推荐.docx

1、2.2.2 ClientSocket模块.82.2.3 ServerSocket模块.92.2.4 DataBase模块.102.3 模块动作时序.113 接口说明.123.1 数据结构定义.123.2 函数.123.2.1 模块间接口函数.123.2.2 模块内接口函数.191 文档概述1.1 文档目的和范围该文档主要完成的是对整个项目模块的划分和模块间接口的设计，为项目开发人员的详细设计提供依据。1.2 术语/缩略语序号术语/缩略语说明Socket通常也称作套接字，用于描述IP地址和端口，是一个通信链的句柄。2UI_Control界面交互模块3ClientSocket客户端模块4Serve

2、rSocket服务器模块5Database数据库模块，存储相关数据1.3 参考文档文档名作者时间版本基于QT的邮箱收发系统需求分析报告书吴奎2013-12-16Ver 0.1.02 模块概述本项目是用比较常见的B/S架构来设计的，分为客户端和服务器两大模块。其中客户端又分为界面交互模块和客户端通信模块，服务器模块分为服务器通信模块和数据库模块。界面交互模块负责界面的显示以及与用户的交互；客户端通信模块负责将用户操作产生的消息传送至服务器上以及接收服务器传来的消息；服务器通信模块负责接收客户端传送的消息并且根据消息类型进行相应的处理，再将处理的结果传送给对应的客户端。数据库模块负责存储和提供系统

3、中生成的信息，并对这些信息进行管理。2.1 模块功能定义2.1.1 UI_Control模块功能点功能点详细内容登录界面用户通过登录界面通过输入用户名和密码登录邮箱注册界面新用户注册新的邮箱账号邮箱主界面显示邮箱的主要信息，包括收件箱、发件箱、垃圾箱等编写邮件界面用户编写新的邮件查看邮件界面查看完整的邮件信息6添加附件在邮件中添加文档、图片、声音、视频等7管理邮件用户对自己邮箱内的邮件进行增删查改等操作8邮件搜索可以查找用户需要查看的邮件9最近联系人显示最近来往的邮箱号，方便发送邮件10名片设置用户设置自己的信息以便好友了解11字体设置设置字体的颜色和大小12添加表情编写邮件内容可以插入动态的

4、表情13界面换肤更改界面的主题和背景色2.1.2 ClientSocket模块登录邮箱输入账号和密码登录邮箱，登录的信息将发送至服务器并接受返回结果。注册邮箱建注册的信息发送至服务器并等待服务器返回的结果收取邮件接收服务器返回的已读和未读邮件标题等相关信息发送邮件将邮件内容和收件人地址等信息发送至服务器并接收返回结果查看邮件将帐号和邮件ID等信息发送至服务器并接收返回的邮件内容等信息将名片中修改的内容项发送至服务器并接收返回的结果将帐号和搜索关键字等信息发送至服务器并接收返回的搜索结果内容删除邮件将要删除或彻底删除的帐号和邮件ID等信息发送至服务器并接收返回的结果，彻底删除的不会进垃圾箱。恢复

5、邮件将垃圾箱中未彻底删除的邮件恢复的信息发送至服务器并接收返回的结果2.1.3 ServerSocket模块接收信息接收客户端的请求，比如登录、注册、收取邮件、删除邮件等发送信息对客户端发送来的消息进行相应的处理并返回结果给客户端2.1.4 Database模块登录检测用户登录时检测用户的账号和密码是否正确用户状态变换用户登录或退出时，更换数据库表中用户的当前状态增加用户将新注册的用户信息加入数据库表将邮件的所有相关信息存储到数据库表中转发邮件若数据库中邮件被取出，并已经发送，做标记删除没有用的邮件，节约存储空间更改用户IP和端口当用户登陆时存储用户ip和端口，用于与服务器通信保存附件当有附件

6、时，建立文件夹存储附件并记录其与邮件id的关联2.2 模块结构2.2.1 UI_Control模块模块名称模块类型概要说明MessagePack内部模块对发送的消息进行打包MessageUnpack对接收到的消息进行解包ReceiveMsg接收服务器信息ThreadProcess线程处理接收到的信息2.2.2 ClientSocket模块ClientSend接口客户端通信发送函数ClientReceive客户端通信接收函数ClientInitSocket初始化SetSender_Msg设置发送方IP和端口SetReceiver_Msg设置接收方IP和端口2.2.3 ServerSocket模块

7、ServerSend服务器端通信发送函数ServerReceive服务器端通信接收函数ServerInit服务器端处理函数GetServerIp获取服务器IP2.2.4 DataBase模块AddMailInfo增加邮件信息AddUserInfo增加用户信息DeleteMailInfo删除邮件信息setUserOnline设置用户状态CheckUserPwd检查用户密码DataBaseInit初始化数据库ModifyUserInfo修改用户信息SetMailFlag修改邮件标志2.3 模块动作时序3 接口说明3.1 数据结构定义#define INT8U quint8#define INT16

8、U quint16#define INT64U quint64#define STRING QString#define SUCC 1#define ERR 0#define SYS_ON 11#define SYS_OFF 12#define SYS_LOGIN_SUCC 13#define SYS_LOGIN_ERR 14#define SYS_REGISTER_SUCC 15#define SYS_REGISTER_ERR 16#define SYS_REQUEST 17#define USR_LOGIN 31#define USR_REGISTER 32#define USR_GETM

9、AIL 33#define USR_NOTREAD_MAIL 34#define USR_RECEIVE_MAIL 35#define USR_SENDED_MAIL 36#define USR_DELETED_MAIL 373.2 函数3.2.1 模块间接口函数3.2.1.1 ClientSend函数名文件名./ClientSocket.cpp功能概要客户端发送信息记述形式INT8U ClientSocket:ClientSend（ QByteArray *datagram, STRING ReceiverIP, INT16U ReceiverPort）参数类型变量名I/OQByteArra

10、ydatagram-传入的数据数组指针STRINGReceiverIP传入的服务器IPINT16UReceiverPort传入的服务器端口返回值INT8U值SUCC发送成功ERR发送失败详细说明客户端发送信息函数，给用户界面交互时使用使用注意事项无3.2.1.2 ClientReceiveClientReceive 客户端信息接收函数INT8U ClientSoclet:ClientReceive（QByteArray *datagram）存储接收到的数据接收成功接收失败接收函数给客户端界面交互调用，接收的数据再被处理3.2.1.3 AddMailInfo./DataBase.cppbool

11、DataBase:AddMailInfo（Mail mail）Mailmail传入Mail类对象booltrue正常结束false异常结束当服务器收到发送邮件标志时处理函数调用该函数传入参数的类型3.2.1.4 AddUserInfoAddUserInfo（User user）Useruser传入用户信息类对象当服务器收到新用户注册标志时处理函数调用该函数3.2.1.5 DeleteMailInfoDeleteMailInfo（INT16U mailId）mailId邮件标志fasle服务器处理删除邮件时调用该函数3.2.1.6 SetUserOnlineSetUserOnline更改用户在线

12、状态SetUserOnline（ STRING userName, INT8U userStatususerName传入用户邮箱帐号userStatus传入状态值当收到用户登陆成功信息时调用该函数3.2.1.7 CheckUserPwd./ DataBase.cpp验证用户帐号和密码 CheckUserPwd （ STRING passwordpassword传入用户邮箱密码用户登陆时服务器进行验证3.2.1.8 DataBaseInit数据库初始化 DataBaseInit （）服务器启动开始调用该函数3.2.1.9 ModifyUserInfo ModifyUserInfo （ STRIN

13、G username, User newUsernewUser传入用户信息对象用户更改名片操作时数据库模块调用该函数处理3.2.1.10 SetMailFlag更改邮件标志SetMailFlag （ INT8U mailStatusmailStatus传入邮件标志邮件已转发送至用户邮箱，更改邮件标志3.2.2 模块内接口函数3.2.2.1 MessagePack./Message.cpp打包要发送的消息INT8U Message:MessagePack（QByteArray *datagram）QByteArray *I打包后存储的数据数组指针将要传送的数据全部打包在一起发送3.2.2.2 MessageUnpack解包要接收到的消息MessageUnpack（QByteArray *datagram）传入需要解包的数据数组指针从包中解出需要的单个数据域3.2.2.3 ClientThreadProcessrun./ThreadProcess.cpp客户端接收处理函数void ThreadProcess:run（）void客户端接收处理函数,注意与服务器端的区分3.2.2.4 ReceiveMsg./xmailmainwidget.cpp客户端接收信息void xmailMainWidget:ReceiveMsg（）客户端接收的信息