Socket通信模块详细设计.doc

密级：秘密文件编号：D0000-PPCMT012Socket通信模块详细设计版本：0.8.0-0.0.02010-9-9东软集团股份有限公司 人才实训中心(版权所有，翻版必究)总页数正文附录生效日期编制批准文件修改控制修改编号版本修改条款及内容修改日期10.8.0-0.0.0创建2009-11-9详细设计报告 版本：0.0.0-2.0.1 第14页文档编号： D0000-PPC-项目编号-PDD-年份目 录1文档概述31.1文档目的和范围31.2术语/缩略语31.3参考文档32模块功能描述32.1数据结构定义32.1.1数据类型定义42.1.2全局变量定义42.1.3常量定义42.2类模块功能实现42.2.1类数据成员52.2.2类成员函数51 文档概述1.1 文档目的和范围本文描述了使用Socket通信模块类客户端与服务器端如何进行交互1.2 术语/缩略语序号术语/缩略语说明1gEDM案内静止数据制作模块2CSocket通信模块1.3 参考文档序号文档名作者时间版本1VC+技术内幕潘爱民1999年1月第四版（清华版）2深入浅出+MFC_侯俊杰1996年8月简体版3Neusoft Media Player项目要求书胡本仁2009-02-04Ver1.22 Socket通信模块功能描述此Socket通信模块旨在通过用户给定的IP地址与服务器建立连接。通过基于对话框的链接界面进行上传工作。2.1 自定义数据类型结构体、联合体、枚举2.1.1 类型定义 XXXXEnum CClientDlg enum IDD = IDD_CLIENT_DIALOG;AFX_DATA(CCLientDlg)枚举CClient类型对象；CServerenum IDD = IDD_SERVER_DIALOG ;AFX_DATA(CServerDlg枚举CSverver类型对象。2.1.2 常量定义Client：#define IDD_CLIENT_DIALOG 102#define IDR_MAINFRAME 128#define IDC_IPADDRESS1 1000#define IDC_EDIT_NPORT 1001#define IDC_EDIT_FILE 1002#define IDC_BUTTON_BROWSER 1003#define IDC_PROGRESS1 1004#define IDC_STATIC_STATE 1005Server：#define ID_STOP 3#define IDD_SERVER_DIALOG 102#define IDR_MAINFRAME 128#define IDC_EDIT_PORT 1000#define IDC_RADIO_FILE 1001#define IDC_RADIO_BUF 1002#define IDC_STATIC_IMAGE 1003#define IDC_PROGRESS1 1004#define IDC_STATIC_STATE 10052.2 Socket通信模块类功能实现客户端：1. 采集IP地址（输入服务器IP地址）：保存用户输入的IP地址2. 连接服务器：连接保存的IP地址所指向的服务器；3. 文件上传：将文件转为流媒体，并上传至服务器。用户通过输入服务器地址与端口（服务器）连接到服务器，浏览本地文件，点击发送后，客户端通过IP地址连接到服务器端。服务器端：1. 服务器端文件保存：将接受到的文件保存到指定的物理路径（绝对路径）。服务器启动服务，接收客户端文件。2.2.1 类数据成员Client.h：SOCKET m_hSocket;/访问 TCP 和 UDP 网络服务的方便途径CString m_strFileName; /文件名称HICON m_hIcon; /可执行文件的图标Server.h:SOCKET m_hSocket; /访问 TCP 和 UDP 网络服务的方便途径CString m_strFilePath;/文件路径char* pBuffer;/存储缓存区地址int m_iSize;/缓存区大小bool bAppend;/判断是否连接成功HICON m_hIcon;/可执行文件的图标2.2.2 类成员函数Client：void OnPaint();HCURSOROnQueryDragIcon();void OnOK();voidOnButtonBrowser();void OnCancel();Server:void InitSock();bool GetCurSelMode();void ShowPIC();void ShowPIC(char* buf,int iSize);void RevFile(const SOCKET& s); CFunctionName(函数名称)【函数式样】表2-1函数名OnPaint函数作用范围protected文件名ClientDlg.h功能概要添加一个最小化按钮处理信息记述形式void OnPaint();参数类型变量名I/O说明None返回值类型说明值详细说明1添加一个图标按钮，获取图标的位置坐标和可执行文件图标。使用注意事项【函数式样】表2-2函数名OnQueryDragIcon函数作用范围Protected文件名Client,h功能概要访问获取可执行图标的光标资源句柄记述形式HCURSOR OnQueryDragIcon();参数类型变量名I/O说明None返回值类型HCURSOR说明值m_hIcon可执行图标详细说明1调用该函数时返回一个可执行图标的光标资源句柄型对象使用注意事项【函数式样】表2-3函数名OnOK函数作用范围Protected文件名Client.h功能概要检索文件记述形式void OnOK( )参数类型变量名I/O说明None返回值类型说明值None详细说明1. 创建一个线程发送文件并给出相应提醒2. 在此增加额外的认可3. 对通信数据进行初始化4. 若文件路径有误则发送消息提醒使用注意事项使用指针传递【函数式样】表2-4函数名OnButtonBrowser函数作用范围Protected文件名Client.h功能概要发送文件记述形式voidOnButtonBrowser()参数类型变量名I/O说明None返回值类型说明值None详细说明1发送各种图片类型文件使用注意事项【函数式样】表2-5函数名OnCancel函数作用范围Protected文件名Client.h功能概要取消此次文件发送记述形式void OnCancel();参数类型变量名I/O说明None返回值类型None说明值详细说明1 在此处添加一个额外清除2 关闭通信发送线程3 对客户端填充内容进行清除使用注意事项【函数式样】表2-6函数名InitSock函数作用范围public文件名Server.h功能概要装HTTP 断点续传记述形式void InitSock();参数类型变量名I/O说明None返回值类型说明值None详细说明1 如果已经创建线程，则先关闭2 在INT上通信3 绑定数据4 监听线程数据使用注意事项【函数式样】表2-7函数名GetCurSelMode函数作用范围public文件名Server.h功能概要判断按钮是否被检测到记述形式bool GetCurSelMode()参数类型变量名I/O说明None返回值类型bool说明值True按钮点击被检测到False按钮电钮没有被检测到详细说明1用IsDlgButtonChecked(IDC_RADIO_BUF)函数判断按钮是否被检测到使用注意事项【函数式样】表2-8函数名ShowPIC函数作用范围public文件名Server.h功能概要显示图片记述形式void ShowPIC()参数类型变量名I/O说明None返回值类型说明值None详细说明1判断文件路径是否为空，如为空，则返回一个空值，跳出该函数2如不为空，则按照一定得闻之数据显示图片使用注意事项【函数式样】表2-9函数名ShowPIC函数作用范围public文件名Server.h功能概要显示图片的一个函数重载记述形式void ShowPIC(char* buf,int iSize)参数类型变量名I/O说明char*buf,I缓存区地址intiSizeI缓存区大小返回值类型说明值None详细说明1判断缓存区地址是否为空，或者大小是否为0，如为空，则返回一个空值，跳出该