软件开发设计文档实用实用模板.doc
wordI / 11软件开发设计文档软件开发设计文档文档管理信息表文档管理信息表主题主题web 服务器版本版本1.0内容内容可响应客户端发送文件请求的 web 服务器关键字关键字套接字，请求报文，响应报文，tcp 编程参考文档参考文档创建时间创建时间创建人创建人最新发布日期最新发布日期文档变更纪录文档变更纪录更改人更改人日期日期更改容更改容目目 录录1 开发规划开发规划 11.1 开发人员 11.2 开发计划 21.3 开发环境和工具 31.4 开发规 32 总体设计总体设计 42.1 概念术语描述 42.1.12.1.1 术语1.42.1.22.1.2 术语2.4wordII / 112.3 主要界面流程描述 72.3.12.3.1 功能1界面流程72.3.22.3.2 功能2界面流程72.4 模块列表 83 数据结构数据结构 94 接口规接口规 104.1 .104.1.14.1.1Interface1.104.1.24.1.2Interface2.104.2 .114.3 .114.4.115 模块设计模块设计 125.1MODULE1 设计 125.1.15.1.1 模块设计描述125.1.25.1.2 模块界面描述125.2MODULE2 设计 136 附录附录 146.1 第三方组件 146.2 参考资料 156.3 附加文档 15word1 / 11开发规划开发人员开发人员角角 色色主要职责主要职责负责模块负责模块人员人员备注备注何鑫负责编写窗口界面创建通信套接字建立连接获取 http 请求，解析请求报文封装文件到 http 响应报文中，并发送该响应报文软件的测试与优化xxx 模块xxx开发环境和工具开发环境和工具开发工具工具工具作用作用Microsoft visual studio 2010web 服务器，窗口界面总体设计概念术语描述概念术语描述术语 1静态文本框word2 / 11术语 2请求报文响应报文基本设计描述基本设计描述 1.传入一个与某个浏览器通信的套接字 2.启动一个线程来监听浏览器接收到的数据 recive 3.如果监听浏览器的请求报文了，要： 3.1 要将请求报文显示在服务器软件的文本框中 3.2 要分析浏览器发来的请求报文 3.3 要根据请求报文处理浏览器的请求页面 4.生成响应报文，并输出到浏览器 T 5.关闭当前连接主要界面功能流程描述主要界面功能流程描述功能 1 界面流程1.使用 vs2010 创建一个基于 c#的窗体程序2.使用静态文本框，按钮等元素布置界面3.添加显示文本框用来显示“ip”,“端口号” ，和“日志”3.给两个按钮的 text 重命名并在 name 里给其命名4.最终窗体界面如图所示：word3 / 11（注：我们默认服务器的 ip 地址为 127.0.0.1，端口号为 5004）功能 2 创建浏览器和服务器的通信流程数据结构数据库表列表表名表名作用作用endpoint网络节点对象，用来传入网络节点对象，用来传入 ip 号和端口号号和端口号adress用来获得用来获得 IP 这个文本框里面的容，为将套接字绑定到端口号这个文本框里面的容，为将套接字绑定到端口号中做准备中做准备threadwatch创建负责调用套接字监听的线程word4 / 11sokwatch负责监听浏览器的套接字sokconnection接收浏览器请求并生成相应的通信套接字对象isrunning用来控制监听循环是否退出模块列表模块名称模块名称(英文英文)功能功能备注备注模块 1sokwatch.Bind(endpoint)将套接字绑定到指定的端口号上模块 2sokwatch.Listen(10)设置监听队列（监听套接字能够同时处理的浏览器连接请求最大个数）模块 3 void watchConnectt()监听浏览器的连接请求模块 4threadwatch = new Thread(watchConnectt)实例化线程模块 5threadwatch.Start()启动线程模块 6void showmsg(string msg)用来在 txtmsglog 文本框中显示相应的连接信息功能 3 接收请求报文流程模块列表模块名称模块名称(英文英文)功能功能备注备注模块 1 public delegate void DGshowmsg(string msg)用来在控件上显示消息的委托类型新建类Dataconnection模块 2public delegate void 用来在控件上显示消息的委托类型新建类Gshowmsg，并用委托类型word5 / 11DGshowmsg(string msg)模块 3public Dataconnection(Socket sokconnection,DGshowmsg dgshow)在 Dataconnection 类里，通过在构造函数传入参数的方式来传入与某个浏览器通信的套接字和线程模块 4this.threadconnection = new Thread(recmsg);直接在部来创建通信线程对象模块 5this.threadconnection.IsBackground = true; this.threadconnection.Start();启动该线程，并将其设置为后台线程arrmsg模块 6length = sokconnection.Receive(arrmsg);将浏览器发来的数据装入缓存区，并获得真实的数据长度模块 7TryCatch调用委托对象来在文本框中打印异常消息模块 8dgshow(recmsg);在文本框中显示消息数据结构数据库表列表表名表名作用作用conn创建 Dataconnection 类对象，并传入当前套接字和线程arrmsg字节数组，当做缓存区length用来存放浏览器发来的数据的长度 recmsg用来存储已转换成字符串类型的数据word6 / 11功能 4 分析请求报文流程模块列表模块名称模块名称(英文英文)功能功能备注备注模块 1public HttpRequestmodel(string requeststr)生成请求报文实体对象，并分析请求报文字符串，将每个语义字符都次实体类的相应属性中新建类HttpRequestmodel模块 2string arrequest=requeststr.Replace(rn,籀).Split(籀);这里表示的是将rn转换成籀 ，便于处理，并分割字符新建类Gshowmsg，并用委托类型模块 3string firstrow = arrequest0.Split( );按照控件将已经分割好的字符再分割模块 4给路径赋值数据结构数据库表列表表名表名作用作用path定义页面路径字符串功能 5 读取文件流程模块列表word7 / 11模块名称模块名称(英文英文)功能功能备注备注模块 1 dataDir = System.IO.Directory.GetParent(dataDir).Parent.Parent.FullName;获得浏览器请求文件的物理路径默认该请求文件在工程目录下模块 2Switch()Case:Case:根据请求文件的后缀名不同来做出不同的判断模块 3 void ProcessstaticPage(string path)该方法用来专门处理静态文件模块 4using(FileStream fs=new FileStream(path,FileMode.Open)使用文件流的方式来读取文件前提是要为FileStream 导入命名空间数据结构数据库表列表表名表名作用作用requestModel在 dataconnecton 类里创建请求报文实体对象dataDir用来存放当前执行程序的物理路径fileDir存储请求文件的物理路径extentionName存储请求文件的后缀名功能 6 生成响应报文流程模块列表word8 / 11模块名称模块名称(英文英文)功能功能备注备注模块 1public byte GetHttpResponseHeader()返回响应报文头字符串默认该请求文件在工程目录下模块 2 return System.Text.Encoding.UTF8.GetBytes(sbResponse .ToString ();返回请求文件的字节数组模块 3sokconnection.Send(model.GetHttpResponseHeader();利用套接字来将响应报文头发送回去模块 4使用文件流的方式来读取文件前提是要为FileStream 导入命名空间数据结构数据库表列表表名表名作用作用arrfile以二进制形式存储的文件数据contentType默认的响应容的类型sbResponse用来显示响应报文头model生成响应报文头对象附录第三方组件第三方组件使用的命名空间：using System;using System.Collections.Generic;using System.ponentModel;using System.Data;word9 / 11using System.Drawing;using System.Linq;using System.Text;using System.Windows.Forms;using System.Net.Sockets;using System.Net;using System.Threading;参考资料参考资料自己动手写 web 服务器（视频版）
