接口设计方案

接口设计方案

一、设计方案

由甲方调用监控模块,控制监控模块的启停、设置策略等，通过甲方调用监控模块DLL 的接口将监控策略告知监控模块，由监控模块监控相关操作行为，并根据策略配置调用甲方提供的文件容检查模块，对相关文件进行文件容筛查，来确定文件是否是涉密文件。同时通过甲方程序调用乙方监控模块DLL接口获取监控结果。

一、接口部分（监控模块DLL,乙方提供）

************************************

Function:Init

Description:初始化操作

Input:无

Output:无

Return：true：成功，false：失败

Other:

***********************************

1、bool Init();

************************************

Function:SetRule

Description:设置监控规则

Input:char* pRule：监控规则，XML格式，见附1

Output:无

Return：true：成功，false：失败

Other:

***********************************

2、bool SetRule(char* pRule);

************************************

Function:Start

Description:设置完规则，启动监控规则生效

Input:无

Output:无

Return：true：成功，false：失败

Other:

***********************************

3、bool Start();

************************************

Function:WaitData

Description:实时等待获取监控数据可以是一条可以是多条。返回监控结果见附2

Input:无

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.成功获取数据pData[0]、pData[1]、……

1.结束/ 停止（其他地方调用Stop停止）Return;

}

FreeData(pData);

}

}

************************************

Function:FreeData

Description:释放数据存接口，对应WaitData函数Input:int nCount 要释放的元素数量，char**要释放的数据Output:无

Return：无

Other:

***********************************

5、FreeData (int nCount ,char** pData);

************************************

Function:Stop

Description:停止监控，监控规则失效

Input:无

Output:无

Return：true：成功，false：失败

Other:

***********************************

6、bool Stop();

************************************

Function:UnInit

Description:程序退出

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)头文件如下----------------------------- #pragmaonce

structTipsFileBlock

{

char *pKeyWords;//关键字

char *pSecretLevel; //密级:秘密、、绝密中的一个

char*pFileBlock; //片段

};

classIFileChecker

{

public:

virtualvoid Init(constchar *pKeyWords) = 0;