接口设计方案

接口设计方案一、设计方案由甲方调用监控模块,控制监控模块的启停、设置策略等，通过甲方调用监控模块DLL的接口将监控策略告知监控模块，由监控模块监控相关操作行为，并根据策略配置调用甲方提供的文件内容检查模块，对相关文件进行文件内容筛查，来确定文件是否是涉密文件。同时通过甲方程序调用乙方监控模块DLL接口获取监控结果。甲方文件内容检查模块甲方程序监控监控模块DLL一、接口部分（监控模块DLL,乙方提供）*Function:InitDescription:初始化操作Input:无Output:无Return：true：成功，false：失败Other:*1、bool Init();*Function:SetRuleDescription:设置监控规则Input:char* pRule：监控规则，XML格式，见附1Output:无Return：true：成功，false：失败Other:*2、bool SetRule(char* pRule);*Function:StartDescription:设置完规则，启动监控规则生效Input:无Output:无Return：true：成功，false：失败Other:*3、bool Start();*Function:WaitDataDescription:实时等待获取监控数据可以是一条可以是多条。返回监控结果见附2Input:无Output:int &nCount返回总条数，char*&pData返回数据。Return：-1.异常0.成功获取数据1.结束 / 停止（其他地方调用Stop接口停止）Other:建议乙方内部实现用信号、内核事件等处理方式。*4、int WaitData(int &nCount, char*& pData);甲方调用伪代码：ThreadFunc()/实时线程While(TRUE) char* pData = NULL; int nCount = 0; int nRet = WaitData(nCount,pData);/等待一条或多条数据时返回,没有数据就等待。 switch(nRet) -1.异常continue;0.成功获取数据 pData0、pData1、1.结束 / 停止（其他地方调用Stop停止） Return;FreeData(pData);*Function:FreeDataDescription:释放数据内存接口，对应WaitData函数Input:int nCount 要释放的元素数量，char*要释放的数据Output:无Return：无Other:*5、FreeData (int nCount ,char* pData);*Function:StopDescription:停止监控，监控规则失效Input:无Output:无Return：true：成功，false：失败Other:*6、bool Stop();*Function:UnInitDescription:程序退出Input:无Output:无Return：true：成功，false：失败Other:*7、UnInit();二、文件检查模块/*接口说明*/创建文件检查实例void (*PCreateFileCheckerObject)(IFileChecker *pObject);/释放文件检查实例void (*PReleaseFileCheckerObject)(IFileChecker *pObject);多规则多种关键字组合，则创建多个实例- IFileChecker-/初始化void Init(const char *pName, const char *pKeyWords);pName:实例名称随意。但多个实例并行时不能重复;pKeyWords: 关键词组。格式：机密;秘密;绝密;/结束调用void UnInit();/获取文件信息bool GetFileInfo(const char *pFilePath, TipsFileBlock *pTFB);pFilePath：文件路径pTFB：返回数据结构/释放文件信息void FreeFileInfo(TipsFileBlock * pTFB);pTFB：需要释放的数据结构/停止当前的文件检查void StopCheck();*/-(.h)头文件如下-#pragmaoncestructTipsFileBlockchar *pKeyWords;/关键字char *pSecretLevel;/密级:秘密、机密、绝密中的一个char*pFileBlock;/片段;classIFileCheckerpublic:virtualvoidInit(constchar *pKeyWords) = 0;virtualboolGetFileInfo(constchar *pFilePath, TipsFileBlock *pTFB) = 0;virtualvoidFreeFileInfo(TipsFileBlock * pTFB) = 0;virtualvoidUnInit() = 0;virtualvoidStopCheck() = 0;typedefvoid (*PCreateFileCheckerObject)(IFileChecker *pObject);typedefvoid (*PReleaseFileCheckerObject)(IFileChecker *pObject);/-头文件 end-/示例/-获取接口类-HMODULE hDll = LoadLibrary(_T(TipsFileChecker.dll);if (NULL =hDll) return;PCreateFileCheckerObjectpCreateFileChecker = (PCreateFileCheckerObject)GetProcAddress(hDll,CreateFileCheckerObject);PReleaseFileCheckerObjectpReleaseFileChecker = (PReleaseFileCheckerObject)GetProcAddress(hDll,ReleaseFileCheckerObject);if (NULL = pCreateFileChecker | NULL = pReleaseFileChecker) return;IFileChecker* pFileChecker = NULL;pCreateFileChecker(&pFileChecker);/-初始化提供关键字-CStringAstrName = FeiMi1;/多个实例名称任意，但不同。例如：FeiMi2、FeiMi3、CStringAstrKeyWords = 秘密;机密;绝密; ;pFileChecker-Init(strName,strKeyWords);/-文件命中片段提取-CStringAstrFilePath = C:123.docx;TipsFileBlockfb;pFileChecker-GetFileInfo(strFilePath,&fb);/.pFileChecker-FreeFileInfo(&fb);/-结束释放-pFileChecker-StopCheck();pFileChecker-UnInit();pReleaseFileChecker(&pFileChecker);FreeLibrary(hDll);三、附附1：规则XML：解释:TipsType Type = Rule为规则xmlIsMon:是否监控 1监控 0不监控MonPath：监控文件夹，采用分号拼接，如果为空表示全盘监控MonFileType：监控文件类型，采用分号拼接，如果为空表示不限类型IsBa