2022年网站详细设计说明书 .pdf

《2022年网站详细设计说明书 .pdf》由会员分享，可在线阅读，更多相关《2022年网站详细设计说明书 .pdf（10页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Lyra Resource Platform 文档详细设计说明书1 详细设计说明书1.引言1.1 编写目的本详细设计说明书是针对网络信息体系结构的课程作业而编写。目的是对该项目进行详细设计， 在概要设计的基础上进一步明确系统结构，详细地介绍系统的各个模块，为进行后面的实现和测试作准备。本详细设计说明书的预期读者为本项目小组的成员以及对该系统感兴趣，在以后想对系统进行扩展和维护的人员。1.2 背景a. 待开发的系统的名称：Lyra Resource Platform; b. 本项目的任务提出者: 赵东，成富，陈良，窦文敏开发者：赵东，成富，陈良，窦文敏用户： 所有对该项目感兴趣，并想通过该项目的

2、产品提高资源检索速度和质量，方便的进行资源检索，预览，上传及下载的用户。2. 系统的结构uiclientpreviewsearchcommon名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 10 页 - - - - - - - - - Lyra Resource Platform 文档详细设计说明书2 ui ：系统界面部分， 负责接受用户输入，显示系统输出， 负责其他模块功能的协调调用，并含有站内搜索功能，即在用户指定的已打开的ftp站点中搜索用户需要的资源。ui部分调用

3、 common部分的功能读取xml 文件中保存的界面元素属性信息，用户最近访问过的 10 个 ftp信息，用户选择的下载的ftp内容列表及其他需要通过xml 文件保存的信息。client：实现 ftp客户端的功能，ftp连接， ftp上传及下载：上传或下载用户指定的资源，并返回相应的信息。search: 资源实时检索部分，根据用户输入的资源名称关键字，资源类型和选择的检索方式检索用户需要的资源，并验证资源的可用性，返回可用资源及其大小，速度等相关信息。preview ：资源预览部分，显示用户选择的资源的部分内容，以使用户决定是否需要该资源。 preview部分调用common部分读取属性文件的

4、内容亦显示预览资源内容的显示格式。3模块 1（ui ）设计说明3.1 模块描述实现用户界面的包，含有11 个文件 51 个类，是本系统中最复杂的代码。3.2 功能负责接受用户输入，显示系统输出，其他模块功能的协调调用，并含有站内搜索功能，即在用户指定的已打开的ftp站点中搜索用户需要的资源。3.3 交互的模块 client， search ，preview ，common 。3.4 模块设计该模块中的主要文件，文件中包含的主要类及其功能和与其它包的交互如下：MainFrame.java ：MainFrame 是含有主函数的类，也是lyra 客户端开始执行的类，它先后进行资源的初始化，显示主界面

5、等工作，根据屏幕大小设置界面大小，设置界面的观感。FtpFrame_AboutBox.java: 显示关于窗口的类，当用户点击帮助菜单中的关于菜单项时会弹出关于对话框。Tools.java：FileTools 是文件操作辅助类，可以实现文件的递归删除等。XMLController.java: JDOMTes 是操作 xml 文件的类，用JDOM 来操作 xml 文件，实现的功能有：（1）保存ftp 服务器的文件列表（站内搜索时使用），递归的从ftp 服务器读取列表，并存入一个xml 文件中（文件的命名方法是：ip+用户名 .xml）;以目录树的形式保存。（2）根据文件名在文件中查找文件，站内搜

6、索时使用。（3）保存 ftp 服务器的信息： ip，端口（默认端口21 不保存），用户名（默认 anonymous不保存），密码，最多存10 个；存在resourcesettings serversinfor.xml 文件中。（4）读取已存储的ftp 服务器信息。（5）从 type.xml 读取搜索的类型。Constants.java:放置系统运行时使用的一些常量，initcontent（）函数对所有常量进行初始化，这个函数在MainFrame 中被调用一次。iconHashMap 是 hash 表，用于存放文件的系统图标。CustomizedController.java ：包含自定义的控件

7、类，java 中的控件可能不能满足需求，名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 10 页 - - - - - - - - - Lyra Resource Platform 文档详细设计说明书3 需要自己定义某些属性。这些控件会在创建界面时使用。其中含有的类有：（1）CustomizedJTable 是表格类，设置表格的某些属性，如字体等。（2）CustomizedTableCellRenderer 是表格单元格绘制器类，主要用于显示文件的系统图标，和文件名。（3）

8、LeftPanel 类的父类是JTabbedPane ，用户显示主窗口左边的面板。（4）RightPanel 类的父类是JPanel，用户显示右边的主题部分，包括右上边的搜索及服务器选项，和中间的显示服务器文件的TabbedPane 。. （5）BottomPanel 类是右下放显示下载和服务器信息的JTabbedPane 。（6）CustomizedJButton 是定义按钮类，更改了按钮的字体，java 本身默认的字体不好看。（7）CustomizedTableModel 是表格类，实现单元格的不可编辑。（ 8 ） CustomizedTableCellRenderer_Remote类 是

9、 表 格 绘 制 器 ， 在 远 程 文 件 浏 览 器RemoteFilesPanel 使用，用于显示文件名和文件图标。（9）FontTableCellRenderer类是表格单元格绘制器，主要功能是设置字体。（10）FontListCellRenderer类是下拉列表框单元格绘制器，主要用于设置字体。（11）CustomizedJLabel类是自定义标签类，重新设置了标签的字体。（12）CustomizedJTextField类是自定义文本框类，主要用于设置文本框的显示属性。（13）CustomizedJMenu 类是自定义菜单类，重新设置了菜单的字体。（14）CustomizedJMen

10、uItem 类是自定义菜单项类，重新设置了菜单的字体。（15）CustomizedListCellRenderer类是 JComboBox即组合框单元格绘制器，用于在本地路径选择的下拉列表中显示磁盘图标。SearchResultReceiver.java, SearchResultReceiver 是一个接口，主要用于返回搜索结果。搜索完成后调用接口中的函数通知调用者。其中主要有两个函数：（1）OnSearchFinished(String keywords,ArrayList resultset);result 是一个10 维的数组表result10 ,resulti 是由类型为i 的资源组

11、成的数组。i：09，和类型列表框中的顺序一致。（2）OnSearchFinished(String keywords,ArrayList resultset);不分类型， 将所有资源放在一个数组表中。FtpFrame.java :FtpFrame 是程序主窗口类， 类型为 JFrame,是由三个分割窗口JSplitPane构成的。jSplitPane_Left 是左边的分割窗口，水平分割条上边显示本地文件框，下边是预览框；jSplitPane_Right 是右边的分割窗口，水平分割条上边是服务器选项和ftp 服务器文件显示的窗口，下边是下载和服务器信息显示窗口；jSplitPane_Whole

12、是 整 体 的 分 割 窗 口 ， 垂 直 分 割 条 ， 左 边 是jSplitPane_Lef ， 右 边 是jSplitPane_Right 。FtpFrame 把 LeftPanel，RightPanel，BottomPanel ，PreviewWrapperPanel 这几部分安装在相应的分割窗格中；LeftPanel，RightPanel，BottomPanel 是在 CustomizedController.Java 中定义的， PreviewWrapperPanel 是在 Preview 包中定义的。LeftPanelCtrl.java: LocalFilesPanel是本地文

13、件面板，用表格来显示本地文件的信息。上边是组合框， 显示了磁盘分区通过这里可以改变根目录。表格中显示了文件的信息，包括文件名，文件的系统图标，大小，最近修改日期，属性等。选中一个文件后可以执行上载和删除操作。文件夹会递归的删除。GetCurrentPath（）函数返回当前的路径。 DisplayPathFiles （）函数在列表中显示指定目录下的文件。RightPanlCtrl.java ：定义右上边的控件。含有的类有：（1）FtpServerOptionPanel 类是服务器连接选项面板，包含服务器地址，端口，用户名，密码等，还包括最上端的搜索选项。openRemoteFilesPanel（

14、）函数在下面的TabbedPane中打名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 10 页 - - - - - - - - - Lyra Resource Platform 文档详细设计说明书4 开一个新的服务器面板，连接服务器。（2） RemoteFilesPanel 类的主要功能是连接Ftp 服务器并显示文件。 这里会进行文件的上载，下载及预览等操作。 RemoteFilesPanel 的内部类TransferController 负责调用FtpClient 类提

15、供的功能与服务器进行交互，完成用户指定的文件操作。TransferController 还有三个内部类：ConnThread 类是负责连接服务器的线程（新开一个线程，目的是避免连接时阻塞），DownloadFileThread 类是下载文件的线程，UploadFileThread 类是上载文件的线程。（3 ）SearchResultPanel类 是显 示 搜 索结果的类 ，它有两个子类SearchResultPanelWithinSearchEngine类的功 能是在搜索引擎中搜索，SearchResultPanelWithinServer 类的功能是站内搜索。搜索引擎的搜索会调用search

16、 包中的程 序 ， 搜 索 引 擎 搜 索 完 成 后search包 通 过OnSearchFinished （ ） 来 通 知SearchResultPanelWithinSearchEngine 类，然后显示搜索结果。（4）RightTabbedPane 是显示 ftp 服务器文件表格的TabbedPane类。BottomPanelCtrl.java ：实现主窗口下部面板及控件，显示下载情况，服务器连接信息。包含的主要类有：（1）RemoteMessPanel 类是显示服务器连接信息的面板。需要显示ftp 服务器传回的信息，并在显示前进行编码转换，还需要显示本地的相关信息。（2）Downl

17、oadingMessPanel 类是显示资源下载信息的面板，显示下载资源的大小，下载速度，已用时间，剩余时间等信息。3.5 流程逻辑总体流程：MainFrame.class FtpFrame.class LeftPanel.class PreviewWrapperPanel RightPanel.class BottomPanel.class FtpClient.class search 上载预览显示下载信息名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 10 页 - -

18、 - - - - - - - Lyra Resource Platform 文档详细设计说明书5 3.6 简单类图4模块 2（client）设计说明4.1 模块描述实现 ftp客户端 FtpClient，有两个文件FtpClient.java和 FtpLoginException.java,前者具体实现了ftp协议，后者是为登录时可能抛出的异常而定义的类。4.2 功能实现 ftp客户端 FtpClient，实现了ftp协议，用于和ftp服务器通讯和数据传输。4.3 交互的模块 ui 4.4 模块设计该模块中的主要文件，文件中包含的主要类及其功能和与其它包的交互如下：FtpClient.java

19、 ：含有类FtpClient,，该类会被ui 包中的界面类调用，完成ftp 功能。其中要功能的实现有：名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 10 页 - - - - - - - - - Lyra Resource Platform 文档详细设计说明书6 在构造函数中根据ip 和 port 建立与服务器的连接；登录服务器login（） （用户名，密码） ；向服务器追加ascii 文件 appendAscii（） ；向服务器追加二进制文件appendBinary（）

20、 ；设置数据传输方式为二进制binary，ascii 码 scii（） ；改变工作目录cd（String newdirectory ） ；返回上一级目录cdup（） ；断开连接 closeserver（） ；删除文件delete（文件名）；删除文件夹rmdir（文件夹的名字） ；用 ascii 模式下载文件getAscii（文件名） ；用二进制方式下载文件getBinary（文件名）；取得服务器的响应字串getResponseString()；列举当前目录下的文件list（） ，指定目录下的文件list（文件名）；创建文件夹mkdir（文件夹名） ；上载 Ascii 文件 putAscii(

21、文件路径 )，二进制putBinary （） 。FtpLoginException.java ： 含有类 FtpLoginException ，定义登录时可能抛出的异常。5模块 3（common ）设计说明5.1 模块描述存放一些辅助类，系统启动时会从properties.xml 读取一些配置信息。可以通过手动修改配置信息来修改系统的某些显示属性如字体，字的大小等。5.2 功能存放一些辅助类，例如用于读取和存储系统配置属性的类。用于将“属性名属性值”对存储在properties.xml 文件中的类。5.3 交互的模块 ui 5.4 模块设计该模块中的主要文件，文件中包含的主要类及其功能和与其它

22、包的交互如下：Properties.java:含有类 Properties，这是读取和存储系统配置属性的类。其主要功能的实现如下：函数 getProperty（）根据属性名取得属性值，如果属性不存在返回null ；函数 getProperties（）根据属性名列表返回属性值列表，返回值为ArrayList，其中的每一个元素是PropertyValue对象；函数 setProperty（）设置单个属性值；函数 setProperties（）设置多个属性值；函数 readXMLFromFile （）读取xml 文件；函数 buildXML （）在 xml 文档中存入数据；PropertyValue

23、.java：含有类 PropertyValue，在 xml 文件中存储“属性名属性值”对。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 10 页 - - - - - - - - - Lyra Resource Platform 文档详细设计说明书7 6模块 4（search ）设计说明6.1 模块描述包 search 主要完成天网和百度两项搜索功能。它含有以下6 个类： NetResource，URLParser，ConnectionTester，SearchResul

24、tRetriever，EmbeddedFileRetriever ，HttpRetriever 。6.2 功能主要完成天网和百度两项搜索功能。6.3 交互的模块 ui 6.4 模块设计该模块中的主要文件，文件中包含的主要类及其功能和与其它包的交互如下：NetResource.java：含有类NetResource，NetResource 是对被天网索引的网络文件资源的抽象，其字段有：fileURL （文件资源的URL ，包括协议、主机字符串、路径、文件名） 、fileDate （天网将它编入索引的日期）、fileSize（文件的大小） 、responseTime（以毫秒计算的响应时间） 。函数

25、 smallerThan(NetResource nr) 比较本条资源的响应时间是否比nr 的响应时间小，因为规定响应时间小的NetResource 排在相应时间大的前面。URLParser.java：含有类 URLParser，URLParser 是一个工具箱类，它提供了若干静态方法，对一个文件资源的URL 进行解析。其实现的方法有：函数 getProtocol（） ：给定一个URL ，返回其协议名称；函数 getHostName（） ：给定一个URL ，返回主机字符串; 函数 getPath（） ：给定一个URL ，返回文件在主机中的存放路径; 函数 getFileName（） ：给定一个

26、URL ，返回文件名 ; 函数 getSuffix （） ：给定一个URL ，返回该URL 对应的文件资源的后缀名。ConnectionTester.java：含有类ConnectionTester，ConnectionTester 是用来对网络文件资 源 进 行 连 接 测 试 的 类 ， 它 实 现 了Runnable 接 口 。 SearchResultRetriever类 将ConnectionTester 类作为模板生成许多线程并发地对各文件资源进行连接并测试相应时间，以提高程序效率。每个网络文件都是用NetResource 类表示的。对于ftp 文件，ConnectionTeste

27、r 尝试以匿名方式连接。如果连接失败则丢弃该资源的URL ，若连接成功则根据连接它响应时间将其插入已排序的NetResource 列表中。对于http 文件，ConnectionTester 建立一个新的URLConnection ，并调用 connect 方法尝试连接。如果连接失败则丢弃该资源的URL ，若连接成功则根据连接它的响应时间将其插入已排序的NetResource 列表中。在构造ConnectionTester 类的对象时必须指定一个由NetResource类的对象组成的ArrayList ，其中每个NetResource 都需要测速。该类的功能主要由函数run()实现。Searc

28、hResultRetriever.java：含有类SearchResultRetriever，SearchResultRetriever 类根据给定的关键字和文件类型向天网文件搜索引擎发送请求，对各返回结果页面的源文件进行分析，将所有网络文件资源的URL 进行分类（利用天网的分类方法）并保存在10个 ArrayList 中。该类的函数如下：函数 test （）判断这个 下一页 对应的 URL 是否合法， 该问题仅在用程序访问天网时需要考虑函数 retrieve（）根据输入的关键字String tokens 向天网发出请求，取得返回的URL集合， ArrayList0 保存图片 imagefil

29、e； ArrayList1 保存音乐 soundfile；ArrayList2保名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页，共 10 页 - - - - - - - - - Lyra Resource Platform 文档详细设计说明书8 存电影videofile ； ArrayList3保存压缩zipfile ； ArrayList4保存文档docfile ；ArrayList5保存程序 programfile ；ArrayList6保存源码 srcfile；Arra

30、yList7保存网页webfile ；ArrayList8 保存目录 dirfile ；ArrayList9 保存其他 file。对每一个 ArrayList生成若干 ConnectionTester 线程进行响应时间测试，在这些线程返回后每一个ArrayList中的网络文件资源都已经按照响应时间递增的顺序排列，而无法连接的文件资源URL都已被丢弃。 SearchResultRetriever类的使用方式是调用它的函数retrieve （String tokens, int type） ，其中 tokens 为表示关键字的字符串数组；type 表明用户需要搜索什么类型的文件。该方法将上述10

31、个 ArrayList 组成一个数组并返回。EmbeddedFileRetriever.java ： 含有类EmbeddedFileRetriever ， EmbeddedFileRetriever类的作用是提取网页中文件链接，它实现了Runnable 接口。 HttpRetriever类将EmbeddedFileRetriever 类作为模板生成若干线程并发地提取不同网页内的文件链接，以提高程序效率。 EmbeddedFileRetriever 类维护了一个网页后缀名列表，由于程序只提取对应文件资源的URL ，我们需要分辨哪些后缀名是对应网页的从而及时将它们丢弃。在构造类 EmbeddedF

32、ileRetriever 的对象时必须指明从哪个网页URL 中提取文件URL ，以及这些 URL 保存在哪个ArrayList 中。函数 hasFileSuffix （）的功能是判断一个url 是否链向一个文件；函数 listFiles(String URLStr) 将 URLStr 对应页面中的所有文件加到ArrayList 中并返回。HttpRetriever.java ：含有类 HttpRetriever ，HttpRetriever 类的功能是根据给定的关键字向百度搜索引擎发送请求，抽取前20 个返回结果对应的网页URL。对每一个页面生成一个 EmbeddedFileRetriever

33、 对象提取其中对文件的链接，并添加到一个ArrayList 中。每个页面都处理完毕后返回这个ArrayList 。在利用搜索文件时，应当提供尽可能多的信息，如输入歌手姓名和“mp3”作为关键字。如果仅给定歌手名称则搜索效果不佳。这些功能都是由函数retrieve（）实现的。6.5 类图名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页，共 10 页 - - - - - - - - - Lyra Resource Platform 文档详细设计说明书9 7模块 5（preview

34、）设计说明7.1 模块描述系统的预览部分， 实现了不同类型资源的预览，并可以根据用户选择的格式显示资源的内容。7.2 功能各种类型资源的预览，可以根据用户的选择格式显示资源的内容，并可以存储用户选择的预览内容。7.3 交互的模块 ui 7.4 模块设计该模块中的主要文件，文件中包含的主要类及其功能和与其它包的交互如下：PreviewWrapperPanel.java:含有类 PreviewWrapperPanel ， 这是系统的预览部分最基本的类，它派生自 Jpanel 类， 主要由 3 部分组成，其中 PreviewPanel负责显示预览， StatusBarPanel负责显示预览文件的加载

35、进度，ControlButtonPanel负责和预览相关的控制。 在显示资源的预览内容前应该先判断该资源类型是否可以预览。PreviewPanel.java：含有类 PreviewPanel ，这是一个抽象类，负责资源内容的预览，有 5 个子类，这 5 个子类分别是PicturePreviewPanel类：负责图像文件的预览；PDFPreviewPanel类：负责 PDF文件的预览；TxtPreviewPanel 类：负责文本文件的预览；NoFileSelectedPreviewPanel类：负责当用户没有选项文件预览时显示提示信息；NoPreviewPanel 类：负责当用户选择的文件不能预

36、览时，显示提示信息。PreviewPanel 类实现的主要功能是构造预览窗口的实例，有两种构造方式：以默认大小构造或以指定大小构造。PreviewPanel 类的函数 preview() 是一个虚函数，系统可以根据不同的子类调用不同的预览函数。PicturePreviewPanel.java:含有类 PicturePreviewPanel， 它的主要功能是图像文件的预览，其中有4 个内部类，分别是：ImagePanel 类：这是显示图像的JPanel，主要功能是绘图；PopupListener 类：用户单击右键弹出菜单的类，右键功能是设置图像的显示是“适合窗口”还是“原始大小”；picPopu

37、pMenuListener 类：负责对右键菜单中事件的响应。PictureFromDiskLoader类：负责从磁盘上加载图像文件。TxtPreviewPanel.java: 含有类 TxtPreviewPanel ，它的主要功能是文本文件的预览，其中有5 个内部类，分别是：PopupListener 类：用户单击右键弹出菜单的类，txtPopupMenuListener类：负责对右键菜单中事件的响应；FileFromDiskLoader类：负责从磁盘加载文本文件；FontChooseDialog 类：字体选择对话框；名师资料总结 - - -精品资料欢迎下载 - - - - - - - - -

38、 - - - - - - - - - 名师精心整理 - - - - - - - 第 9 页，共 10 页 - - - - - - - - - Lyra Resource Platform 文档详细设计说明书10 FontDialogEditorMediator类：负责对话框选择的字体和预览区域显示的字体之间的更新。PDFPreviewPanel.java ： 含有类 PDFPreviewPanel,该类使用第三方的软件包JPedal 来实现 pdf 文件的预览。ControlButtonPanel.java:含有类 ControlButtonPanel， 该类的功能是根据用户的选择保存预览资源，即把预览的文件存放到用户选定的目录。他的功能主要由两个内部类来实现，分别是：saveAction 类：实现了接口 ActionListener，是对预览资源保存按钮的响应，实现预览资源保存功能，把预览的文件存放到用户选定的目录。ExampleFileFilter类：继承自类 FileFilter，实现用户选择文件保存目录的功能，即弹出文件选择对话框。7.5 类图名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 10 页，共 10 页 - - - - - - - - -