局域网简易聊天服务器＆客户端

软件功能

服务端软件

以后台进程运行，
既作为服务器接收客户端发来的请求，
对客户请求做出响应，并发回处理结果．
又作为MySQL服务器客户端，
使用MySQL服务器的数据存储和检索服务．

作为服务端软件，支持的客户端请求有：
１．支持客户端注册请求．
先检查后台数据库user表中用户是否存在，
不存在时，允许注册，数据存储到MySQL服务器的表，
向客户返回处理结果．
２．支持客户端登录请求．
验证从客户发来的密码，用户名是否和后台数据库中某用户匹配，
向客户返回处理结果．
且服务器维护所有在线用户的记录．
３．支持客户端添加好友请求．
验证要添加的好友id是否在后台数据库user表中存在，
若存在，在以用户id命名的数据库的friends表中添加一项．
向客户返回处理结果．
４．支持客户端返回好友列表请求．
从客户id命名的数据库的friends表中检索出所有项，打包发回给客户．
５．支持客户端离线请求．
依据客户端id，清除服务器维护的在线用户信息中的该用户的项．
６．支持客户端ｔ请求取得所有给其发了信息但信息尚未被自己接收的用户列表的请求．
每次客户ａ给客户ｂ发消息时，
客户ａ把消息发给服务器，
服务器在数据库chatmessages中设置一个表a_b记录ab间的消息，
每个项包含消息内容，消息方向，时间戳，消息是否已被对方接收标志信息．
服务器同时在以ｂ的id命名数据库的needtoproecssfriends中将ａ的ｉｄ插入．
这样，	从以ｔ的id命名的数据库的needtoprocessfriends中取出所有项，
打包发回给客户即可．
７．处理客户端聊天请求．
客户端聊天包含聊天内容，消息发送者a，消息接收者b．
服务器在数据库chatmessages中设置一个表a_b记录ab间的消息，
每个项包含消息内容，消息方向，时间戳，消息是否已被对方接收标志信息．
服务器同时在以ｂ的id命名数据库的needtoproecssfriends中将ａ的ｉｄ插入．
若ｂ此时在线，
服务器给客户端ｂ发一个　新消息到达通知消息．
通知客户端ｂ有新消息到达．
８．处理客户端获取与某个指定对端需要但尚未被处理消息请求．
如客户端ａ请求获取与客户端ｂ的未被处理消息，
服务器在chatmessage数据库的a_b表中检索出所有被对方接收标志为否的消息，
打包作为响应返回给ａ．
此外，
服务器将chatmessage数据库的a_b表中被取出项的接收标志修改为是．
从以ａ的id命名的数据库的needtoprocessfriends中删除b．

客户端软件

客户端软件的形态为普通的聊天软件客户端，有可视的UI界面

用户注册

－　注册成功
注册成功，注册信息被记录到后台数据库的数据表．

－　注册失败
注册的用户已经注册
后台MySQL服务器未开启
与聊天服务器的网络通知故障
上述情形会导致注册失败

用户登录

－　成功登录
输入的用户名和密码在后台数据库找到匹配时，可成功登录
登录后显示主UI界面
UI划分３块．
１．Friend List
好友列表，显示所有好友用户名
双击好友列表中一项，可以和指定好友进行一对一聊天
２．NeedToProcessUsers
待处理用户列表，
此列表显示给你发了信息，
但信息未被你接收显示的用户列表
３．聊天窗口
标题部分在一对一聊天时，显示a to b chat window
内容部分显示双方间聊天的历史记录
编辑部分，用于编辑要发给对方的聊天内容
发送按钮，将聊天请求进行发送

－　登录失败
在输入的用户名和密码在后台数据库中找不到匹配时，
在后台数据库未启动时，
在与聊天服务器网络连接故障时，
上述情形会导致登录失败．

添加好友

－　成功添加

－　添加失败
输入的用户id在后台数据库不存在，
后台数据库关闭，
与聊天服务器的连接故障，
上述情形会导致添加失败

好友间聊天

１．双击好友列表某个好友进入与其聊天窗口＆编辑聊天信息

２．点击发送，发出聊天内容

新消息提醒

上面xu1给ben发了消息，发送时ben尚未登录．
现在ben登录，登录后所见如下

needtoprocessusers中包含xu1，
表明xu1给ben发了信息，但信息未被ben收到．
这里有表现出本聊天软件好友添加机制的一个特点．
对a和b．
ａ可以将ｂ添加为其好友．
添加后，ａ可向ｂ发消息，ｂ显示在ａ的好友列表．
对ｂ，
收到ａ的消息且消息未被其接收时，
在ｂ的needtoprocessuser表可见ａ．
但由于ａ不是ｂ的好友，
ａ不在ｂ的好友列表．ｂ也无法打开与ａ的聊天窗口接收消息．
如ｂ想接收ａ的消息，ｂ可添加ａ为好友．
然后打开与ａ的聊天窗口，则将显示ａ发来的消息．

这里，ben为了接收xu1的消息，添加xu1为其好友

好友列表双击xu1，打开与xu1的聊天窗口，接收聊天消息

登录好友间的聊天

技术层面

代码模块及其功能

１． 网络通信模块
网络通信模块采用我进行注释＆说明，结构调整后的mymuduo库．
关于mymuduo库具体说明参考
https://github.com/xubenhao/MyMuduo
在ChatMe应用中
mymuduo库放在MyMuduo文件件，
被客户端和服务器共同使用，来提供基于TCP/IP的局域网通信功能

２．MySql数据库访问模块
采用mysql提供的c api进行与mysql服务器的交互．
提供一个c++类MySqlAgent来封装对mysql提供的c api的使用
通过该类在服务端我们作为一个mysql客户端，
使用后台mysql服务器提供的数据存储，数据检索，数据处理服务．

３．应用层通信协议设计
客户端到服务器方向会发出的消息目前有８种类别，
每种类别及响应字节流打包／解包协议如下
ａ．注册
４字节长度＋２字节消息类别
＋１字节用户id长度＋用户id内容＋１字节密码长度＋密码内容
ｂ．登录
４字节长度＋２字节消息类别
＋１字节用户id长度＋用户id内容＋１字节密码长度＋密码内容
ｃ．添加好友
４字节长度＋２字节消息类别
＋１字节添加方用户id长度
＋用户id内容＋１字节被添加方用户id长度＋用户id内容
ｄ．获取好友列表
４字节长度＋２字节消息类别
＋１字节用户id长度＋用户id内容
ｅ．离线
４字节长度＋２字节消息类别
＋１字节用户id长度＋用户id内容＋８字节登录时间戳
ｆ．获取需要处理用户列表
４字节长度＋２字节消息类别＋１字节用户id长度＋用户id内容
ｇ．聊天
４字节长度＋２字节消息类别
＋１字节发送方用户id长度＋用户id内容
＋１字节接收方用户id长度＋用户id内容＋聊天内容长度＋聊天内容
ｈ．获取客户间未被处理消息
４字节长度＋２字节消息类别
＋１字节发送方用户id长度＋用户id内容
＋１字节对端用户id长度＋用户id内容


服务器到客户端方向会发出的消息目前有８种类别，
每种类别及响应字节流打包／解包协议如下
ａ．注册回复
４字节长度＋２字节消息类别＋１字节注册结果
ｂ．登录回复
４字节长度＋２字节消息类别
＋１字节登录结果＋８字节登录时间戳
ｃ．添加好友回复
４字节长度＋２字节消息类别＋１字节添加结果
ｄ．获取好友列表回复
４字节长度＋２字节消息类别
＋１字节好友数量＋１字节好友id长度
＋id内容［如此重复好友数量次，以发回所有好友信息］
ｅ．获取需要处理用户列表回复
４字节长度＋２字节消息类别＋１字节好友数量
＋１字节好友id长度
＋id内容［如此重复好友数量次，以发回所有用户信息］
ｆ．聊天回复
４字节长度＋２字节消息类别＋１字节聊天处理结果
ｇ．新消息通知
４字节长度＋２字节消息类别＋１字节发送方用户id长度＋用户id内容
ｈ．得到客户间未被处理消息回复
４字节长度＋２字节消息类别
＋２待处理消息数量＋１字节消息方向
＋２字节消息长度＋消息内容＋８字节消息时间戳
［如此重复待处理消息数量次，以发回所有未处理消息］