中山大学软件工程专业初级实训-会议议程管理Agenda
刚刚经历了两个星期的中级实训，那么这次实训的话毫无疑问地比大一初级实训简单了。在这里的话呢，还要感谢许多前辈给的神器。这里首先感谢@卡帕kalper前辈和@jayjiahua前辈。下面给出两个中级实训的神器。那么经历了一次相对来说比较轻松的实训之后呢，感觉大一时候的初级实训真是太辛苦了，而且的话缺少神器。所以决定向以上两位大神学习，给迷茫中的学弟学妹们一些指引，这里借用前辈的一句话，因为平时在完成一些任务的时候，深刻感受到前人经验带给自己的便利，在此我也分享下自己的东西，希望能给后人乘荫吧～！
http://blog.csdn.net/zkp0601/article/details/38564501
https://github.com/jayjiahua/GridWorld
实训具体内容请戳http://my.ss.sysu.edu.cn/wiki/pages/viewpage.action?pageId=430538815
我们初级实训主要使用C++语言写出一个会议议程管理系统Agenda。由于时间过去比较久了记忆不太清楚了，而且写码时间不长（只写了一天），因为写的比较仓促，所以声明和实现都写在一个文件里了，可能的话会还有一些些的Bug，而且没有什么注释，大家阅读起来可能比较困难，如果对源码有疑问或者有帮我找出Bug的同学，欢迎给我发邮件，邮箱：[email protected]
想自己学习代码的同学请直接往下滑，或者戳下面的链接：
https://github.com/yang20150928/Agenda/tree/master/src
下面给出会议议程管理系统Agenda需求文档和三层架构介绍，github链接中给出了本次实训所有头文件。
http://my.ss.sysu.edu.cn/wiki/download/attachments/304840949/xuqiu.pdf?version=1&modificationDate=1404036510000
http://blog.csdn.net/hanxuemin12345/article/details/8544957
https://github.com/ss14agenda/Agenda/tree/master/src
接下来我们来说第一阶段。那么第一阶段的话呢我们就是要完成Date 类，User 类，Meeting 类，Storage类的代码实现，下面给出这其中几个类的UML图（缺少Date类的UML图）和需求链接和Date类的需求，这里的Storage类我按照当时大一的要求，使用的是JSON的存储格式，由于C++没有JSON的库，所以这部分代码写起来比较麻烦（也花了我很多时间）。
http://my.ss.sysu.edu.cn/wiki/download/attachments/167936064/%E5%8F%82%E9%98%85%E8%B5%84%E6%96%99_User+class+diagram+and+code.pdf?version=1&modificationDate=1343288053000
http://my.ss.sysu.edu.cn/wiki/download/attachments/167936064/%E5%8F%82%E9%98%85%E8%B5%84%E6%96%99_Meeting+class+diagram.pdf?version=1&modificationDate=1343617818000
http://my.ss.sysu.edu.cn/wiki/download/attachments/304840949/Storage.png?version=3&modificationDate=1403996090000
http://my.ss.sysu.edu.cn/wiki/download/attachments/167936064/%E5%AF%B9%E4%BA%8E%E4%BC%9A%E8%AE%AE%E6%97%B6%E9%97%B4%E6%98%BE%E7%A4%BA%E7%9A%84%E9%A2%9D%E5%A4%96%E8%A1%A5%E5%85%85.pdf?version=2&modificationDate=1378093428000
我们这一阶段主要实现三层架构中的数据访问层。首先来看User类，User类的话有四个私有属性name, password, email, phone, User类的方法就是对这些属性的set和get。Meeting类也是类似。Date类的话还有三个静态函数实现起来比较麻烦，而且还需要运算符重载。
Storage类中通过操作系统文件的读写完成数据的存储。Storage类采用单例模式设计，只有一个实例，也就是所谓的Singonton。他有一个instance指针实例变量，而且构造函数就是私有的，只能通过getInstance()方法取回实例，所以getInstance()方法思路大致如下：如果属性instance为空，instance就new一个Storage实例，否则返回instance。Storage还有两个list属性用于存储user和meeting。由于在会议议程管理系统Agenda启动时，要从文件中读取数据，所以Storage类的构造函数中调用readFromFile()方法，readFromFile()方法从文件中读取数据，sync是同步的缩写，所以在sync()方法中我们进行数据的同步，也是将内存中的数据写入磁盘中的文件，所以调用writeToFile()方法。其余的query，update，delete方法就是根据传入filter函数进行处理。由于我们不需要在Storage类中进行逻辑判断，所以在create方法中我们直接调用list中的push_back()方法。query方法遍历整个list，如果filter返回值为真，就插入新list中，最好返回新list。update方法也是遍历整个list，如果filter返回值为真，就用switcher函数进行更新，返回更新的数目。delete方法也是遍历整个list，如果filter返回值为真，调用list中erase()方法删除，返回删除的数目。
下面给出实现这四个类的代码：
#ifndef __USER_H__
#define __USER_H__
#include #ifndef __DATE_H__
#define __DATE_H__
#include #ifndef __MEETING_H__
#define __MEETING_H__
#include "Date.h"
using namespace std;
class Meeting {
public:
Meeting() {}
Meeting(std::string sponsor, std::string participator,
Date startTime, Date endTime, std::string title) {
sponsor_ = sponsor;
participator_ = participator;
startDate_ = startTime;
endDate_ = endTime;
title_ = title;
}
std::string getSponsor(void) const {
return sponsor_;
}
void setSponsor(std::string sponsor) {
sponsor_ = sponsor;
}
std::string getParticipator(void) const {
return participator_;
}
void setParticipator(std::string participator) {
participator_ = participator;
}
Date getStartDate(void) const {
return startDate_;
}
void setStartDate(Date startTime) {
startDate_ = startTime;
}
Date getEndDate(void) const {
return endDate_;
}
void setEndDate(Date endTime) {
endDate_ = endTime;
}
std::string getTitle(void) const {
return title_;
}
void setTitle(std::string title) {
title_ = title;
}
private:
std::string sponsor_;
std::string participator_;
Date startDate_;
Date endDate_;
std::string title_;
};
#endif#ifndef __STORAGE_H__
#define __STORAGE_H__
#define DISALLOW_COPY_AND_ASSIGN(TypeName) \
TypeName(const TypeName&); \
void operator=(const TypeName&)
#include
#include 那么阶段二的话呢，我们就要完成完成AgendaService类（应用逻辑实体）和AgendaUI类（终端交互界面）的实现了。下面给出代码实现。这里要注意的是lambda函数的运用还有就是
1会议的title是唯一的。
2不允许创建会议为一个时间点，比如从8点到8点
3关于找出一个时间段内的会议，只要有时间点重叠，都要算上去。
AgendaService类中的私有属性是Storage的实例，所有在startAgenda()方法中取回实例，那么在quitAgenda()进行数据更新，所以分别在构造函数和析构函数中调用他们。至于其他的list, query, create, delete等的方法我们通过lambda函数给定自己的filter，然后调用Storage类中相关方法就行了。
下面先给出Agenda的接口约束：
http://my.ss.sysu.edu.cn/wiki/pages/viewpage.action?pageId=431849490
AgendaUI类中，有三个私有属性，userName, userPassword, 和一个AgendaService对象，userName和userPassword应该就是当前用户的姓名和密码了，所以我们在userLogIn()和userRegister()方法中对他们复制，由于只有用户登录之后才能进行管理操作，所以我们在userLogIn()和userRegister()中加入以下的这个语句while(executeOperation(getOperation()));
用来循环处理管理操作，由于用户登出以及用户删除自己之后不能在进行管理操作，所以在executeOperation()方法中调用这些行为并且返回false。这样的话我们在OperationLoop()方法中只处理登录前的循环操作就可以了。其余的方法大致就是先向用户请求输入，然后调用AgendaService中的方法就行了。
#ifndef __AGENDASERVICE_H__
#define __AGENDASERVICE_H__
#include "Storage.h"
#include
#include #ifndef __AGENDAUI_H__
#define __AGENDAUI_H__
#include "AgendaService.h"
#include 最后给出cpp文件的源码
#include "AgendaUI.h"
AgendaUI aui;
int main() {
aui.OperationLoop();
return 0;
}
由于这次写码和写文时间比较仓促，有很多代码没有经过测试，所以仅供大家参考，不过正常的run还是可以的，而且可能有代码可读性差的问题。另外我最后测试也没能解决的一个Bug，就是创建会议的时候参与者是不存在的用户也能成功创建，希望有大神同学能帮我解决。