代碼對(duì)比器設(shè)計(jì)文檔

本文格式為Word版，下載可任意編輯——代碼對(duì)比器設(shè)計(jì)文檔

哈爾濱學(xué)院軟件學(xué)院

課程設(shè)計(jì)說(shuō)明書(shū)

題目：HSCodeComToolKit—哈軟代碼比較工具

院（系）軟件學(xué)院專(zhuān)業(yè)年級(jí)姓名指導(dǎo)教師

張晶

軟件工程09-3張鳴雷

王克朝

學(xué)號(hào)09033333職稱(chēng)

2023年8月20日

哈軟代碼比較工具是一款實(shí)用的小軟件，具有文本比較功能，和文件夾比較的功能，文本比較：比較兩個(gè)文本文件的內(nèi)容。假使兩個(gè)文件完全一致，則打印“TheTwoFilesareidentical!〞；假使不完全一致，則顯示不同處所在的行號(hào)及不同點(diǎn)；比較結(jié)果顯示在屏幕的同時(shí)，寫(xiě)入文件。文件夾比較：比較兩個(gè)文件夾內(nèi)對(duì)應(yīng)文件的異同。假使對(duì)應(yīng)的兩個(gè)文件完全一致，則顯示任何信息；假使不完全一致，則顯示文件名、不同處所在的行號(hào)及不同點(diǎn)，比較結(jié)果顯示在屏幕的同時(shí)，寫(xiě)入文件。此文檔記錄了制作本軟件的全過(guò)程，包括需求分析，概要設(shè)計(jì)，詳細(xì)設(shè)計(jì)，和源代碼。開(kāi)發(fā)此軟件，為本人增加了經(jīng)驗(yàn)，得到了鍛煉。為大家提供了一款很不錯(cuò)的軟件，但還有一些功能不夠完善，希望大家多提一些建議，一起將此軟進(jìn)一步完善。

關(guān)鍵字：文檔，源代碼，分析，算法

Taketo

Hasoftcodecomparisontoolisasmallutilitysoftware,withtextcomparisonfunctions,andfoldercomparisonfunction,textcomparison:acomparisonoftwothecontentsofatextfile.Ifthetwofilesareidentical,thenprintTheTwoFilesareidentical!;ifnotidentical,displaysadifferentplaceinthelinenumberanddifferentpoints;comparetheresultsdisplayedonthescreenatthesametime,writetothefile.Foldercomparison:acomparisonoftwofolderscorrespondingdocumentsimilaritiesanddifferences.Ifthetwofilesareidentical,showinganyinformation;ifnotidentical,showthefilename,linenumberanddifferentindifferentplaces,comparetheresultsdisplayedonthescreenatthesametime,writetothefile.Thisdocumentrecordstheproductionofthewholeprocessofthesoftware,includingneedsanalysis,outlinedesign,detaileddesign,andsourcecode.Developmentofthissoftware,forIhaveincreasedexperience,getexercise.Weprovideaverygoodsoftware,buttherearesomefunctionisnotperfect,Ihopeeveryoneadvice,thissofttofurtherimprove.Keywords:documentation,sourcecode,analysis,algorithm

前言

隨著通信和計(jì)算機(jī)技術(shù)的快速發(fā)展，以及經(jīng)濟(jì)全球化的推動(dòng)，互聯(lián)萬(wàn)表現(xiàn)出了極大的使用便利性和信息傳遞的快捷性，使得人們對(duì)信息網(wǎng)絡(luò)的依靠程度越來(lái)越大，人們?cè)趥鬟f信息的同時(shí)，又有大量的信息一致，但名稱(chēng)不同，浪費(fèi)空間，和時(shí)間。

所以有好多人想知道文件是否一致，以及文件夾的比較是否一致，為此學(xué)校組織編寫(xiě)了這款小軟件，即小又實(shí)用，此軟件開(kāi)發(fā)完成，但還有一些未知的功能需要完善，為此編寫(xiě)此文檔，便利用戶(hù)使用，在開(kāi)發(fā)人員的開(kāi)發(fā)，對(duì)軟件進(jìn)行好的管理，與應(yīng)用。

目錄

第一章需求分析

1.1引言

1.1.1編寫(xiě)目的

對(duì)于HSCodeComToolKit—哈軟代碼比較工具而言，其作用是實(shí)現(xiàn)文本文件的比較，隨著互聯(lián)網(wǎng)的發(fā)展，越來(lái)越多的文本文件在網(wǎng)絡(luò)中傳播，有些文件文件名不同，內(nèi)容卻是一致的，有時(shí)自己建立的文件也可能是內(nèi)容一致，名不同，為了找出這些內(nèi)容一致的文件，將重復(fù)的刪除，以節(jié)省空間，開(kāi)發(fā)這款代碼比較器，比較文本文件是否一致以及文件夾中的內(nèi)容是否一致。

此規(guī)格說(shuō)明書(shū)在詳細(xì)的調(diào)查了客戶(hù)現(xiàn)有的應(yīng)用模塊和基本的操作流程后進(jìn)行編寫(xiě)，對(duì)HSCodeComToolKit—哈軟代碼比較工具以及其功能進(jìn)行了詳細(xì)的規(guī)劃、設(shè)計(jì)，明確了軟件開(kāi)發(fā)中應(yīng)具有的功能、性能使得系統(tǒng)的開(kāi)發(fā)人員和維護(hù)人員能夠詳細(xì)明白的了解軟件是如何開(kāi)發(fā)和進(jìn)行維護(hù)的，并在此基礎(chǔ)上進(jìn)一步提出概要設(shè)計(jì)說(shuō)明書(shū)和完成后續(xù)設(shè)計(jì)與開(kāi)發(fā)工作。

本規(guī)格說(shuō)明書(shū)的預(yù)期讀者包括客戶(hù)、業(yè)務(wù)或需求分析人員、測(cè)試人員、用戶(hù)文檔編寫(xiě)者、項(xiàng)目管理人員等。

1.1.2項(xiàng)目背景

軟件產(chǎn)品名稱(chēng)：哈軟代碼比較工具。代碼：HSCodeComToolKit

1.2項(xiàng)目概述

1.2.1待開(kāi)發(fā)軟件的一般描述

(1)項(xiàng)目目標(biāo)

①、文本比較：比較兩個(gè)文本文件的內(nèi)容。假使兩個(gè)文件完全一致，則打印“TheTwoFilesareidentical!〞；假使不完全一致，則顯示不同處所在的行號(hào)及不同點(diǎn)；比較結(jié)果顯示在屏幕的同時(shí)，寫(xiě)入文件。

②、文件夾：比較兩個(gè)文件夾內(nèi)對(duì)應(yīng)文件的異同。假使對(duì)應(yīng)的兩個(gè)文件完全一致，則顯示任何信息；假使不完全一致，則顯示文件名、不同處所在的行號(hào)及不同點(diǎn)，比較結(jié)果顯示在屏幕的同時(shí)，寫(xiě)入文件（2）應(yīng)交付成果

在項(xiàng)目開(kāi)發(fā)完成后，交付內(nèi)容有編譯后的代碼比較器，應(yīng)用程序，開(kāi)發(fā)文檔，設(shè)計(jì)說(shuō)明書(shū)（3）項(xiàng)目開(kāi)發(fā)環(huán)境

操作系統(tǒng)為Windows2023以上均可，使用集成開(kāi)發(fā)工具vc6.0

（4）項(xiàng)目驗(yàn)收方式與依據(jù)

項(xiàng)目驗(yàn)收分為內(nèi)部驗(yàn)收和外部驗(yàn)收兩種方式。在項(xiàng)目開(kāi)發(fā)完成后，首先進(jìn)行內(nèi)部驗(yàn)收，有測(cè)試人員根據(jù)用戶(hù)需求和項(xiàng)目目標(biāo)進(jìn)行驗(yàn)收，項(xiàng)目在通過(guò)內(nèi)部驗(yàn)收后，交給客戶(hù)進(jìn)行驗(yàn)收，驗(yàn)收的主要依據(jù)為需求規(guī)格說(shuō)明書(shū)

1.2.2待開(kāi)發(fā)軟件的主要功能

層次方塊圖

圖1流程圖

圖

2

圖5

1.2.3用戶(hù)特征

需要比較文本文件異同或文件夾異同的人

1.2.4運(yùn)行環(huán)境

硬件環(huán)境

486或更高檔PC臺(tái)式機(jī)，筆記本電腦；運(yùn)行時(shí)占用內(nèi)存：1MB；安裝所需硬盤(pán)：5MB；軟件環(huán)境

可選軟件平臺(tái)：中文Windows95

Windows95、WindowsNT4.0或更高版本；Windowsxp及更高版本

1.3功能需求

1.3.1功能劃分

（1）文本文件比較（2）文件夾比較

1.3.2功能描述

（1）、文本比較：

比較兩個(gè)文本文件的內(nèi)容。假使兩個(gè)文件完全一致，則打印“TheTwoFilesareidentical!〞；假使不完全一致，則顯示不同處所在的行號(hào)及不同點(diǎn)；比較結(jié)果顯示在屏幕的同時(shí)，寫(xiě)入文件。（2）、文件夾比較：

比較兩個(gè)文件夾內(nèi)對(duì)應(yīng)文件的異同。假使對(duì)應(yīng)的兩個(gè)文件完全一致，則顯示任何信息；假使不完全一致，則顯示文件名、不同處所在的行號(hào)及不同點(diǎn)，比較結(jié)果顯示在屏幕的同時(shí)，寫(xiě)入文件。

1.4外部接口和需求

用戶(hù)界面

采用dos界面驅(qū)動(dòng)方式，對(duì)用戶(hù)友好。

1.查詢(xún)要求：查詢(xún)界面一目了然

2.信息列表：分類(lèi)明確，字體明了好認(rèn)，能快速的看到重要信息3.操作要求：能夠響應(yīng)用戶(hù)命令請(qǐng)求

輸入輸出格式

輸入：根據(jù)提醒輸入，輸入確鑿，主界面輸入1或2或3選擇比較

還是退出，輸入文件路徑必需帶擴(kuò)展名，文件夾不需要擴(kuò)展名。

輸出：明了輸出比較結(jié)果

1.5軟件屬性需求

①正確性:高②可靠性：高③效率：高

④易使性：

要求具有較強(qiáng)的容錯(cuò)處理能力，以保證軟件的可適用性，在用戶(hù)誤操作的狀況下系統(tǒng)應(yīng)給出相應(yīng)的提醒信息，高數(shù)用戶(hù)如何進(jìn)行恢復(fù)操作，避免無(wú)法挽回的損失⑤可維護(hù)性：

為了保證系統(tǒng)的可維護(hù)性，要求具有詳細(xì)的系統(tǒng)設(shè)計(jì)文檔資料，提供全部的系統(tǒng)源程序，并盡量采用面向?qū)ο蟮某绦蛟O(shè)計(jì)方法，以提高系統(tǒng)的可靠性。同時(shí)要求系統(tǒng)的功能在一定程度上可擴(kuò)展，以滿(mǎn)足業(yè)務(wù)變動(dòng)的需求⑥可移植性：

本系統(tǒng)開(kāi)發(fā)完成后，要能運(yùn)行于任何由windows2000/nt/98級(jí)以上版本操作系統(tǒng)所構(gòu)成的計(jì)算機(jī)單機(jī)環(huán)境下運(yùn)行

其次章開(kāi)發(fā)工具介紹及數(shù)據(jù)庫(kù)設(shè)計(jì)

2.1系統(tǒng)開(kāi)發(fā)工具介紹

Dev-C++是一個(gè)Windows下的C和C++程序的集成開(kāi)發(fā)環(huán)境。它使用MingW32/GCC編譯器，遵循C/C++標(biāo)準(zhǔn)。開(kāi)發(fā)環(huán)境包括多頁(yè)面窗口、工程編輯器以及調(diào)試器等，在工程編輯器中集合了編輯器、編譯器、連接程序和執(zhí)行程序，提供高亮度語(yǔ)法顯示的，以減少編輯錯(cuò)誤，還有完善的調(diào)試功能，能夠適合初學(xué)者與編程高手的不同需求，是學(xué)習(xí)C或C++的首選開(kāi)發(fā)工具！多國(guó)語(yǔ)言版中包含簡(jiǎn)繁體中文語(yǔ)言界面及技巧提醒，還有英語(yǔ)、俄語(yǔ)、法語(yǔ)、德語(yǔ)、意大利語(yǔ)等二十多個(gè)國(guó)家和地區(qū)語(yǔ)言提供選擇。

第三章概要設(shè)計(jì)

3.1引言

3.1.1編寫(xiě)目的

在系統(tǒng)項(xiàng)目的前一階段，也就是需求分析階段中，已經(jīng)將系統(tǒng)用戶(hù)對(duì)本系統(tǒng)的需求做了詳細(xì)的闡述本階段已在系統(tǒng)的需求分析的基礎(chǔ)上，對(duì)哈軟代碼比較工具系統(tǒng)做概要設(shè)計(jì)。主要解決了實(shí)現(xiàn)該系統(tǒng)需求的程序模塊設(shè)計(jì)問(wèn)題。包括如何把該系統(tǒng)劃分成若干個(gè)模塊、決定各個(gè)模塊之間的接口、模塊之間傳遞的信息，以及數(shù)據(jù)結(jié)構(gòu)、模塊結(jié)構(gòu)的設(shè)計(jì)等。在以下的概要設(shè)計(jì)報(bào)告中將對(duì)在本階段中對(duì)系統(tǒng)所做的所有概要設(shè)計(jì)進(jìn)行詳細(xì)的說(shuō)明。在下一階段的詳細(xì)設(shè)計(jì)中，程序設(shè)計(jì)員可參考此概要設(shè)計(jì)報(bào)告，在概要設(shè)計(jì)對(duì)機(jī)票預(yù)定系統(tǒng)所做的模塊結(jié)構(gòu)設(shè)計(jì)的基礎(chǔ)上，對(duì)系統(tǒng)進(jìn)行詳細(xì)設(shè)計(jì)。在以后的軟件測(cè)試以及軟件維護(hù)階段也可參考此說(shuō)明書(shū)，以便于了解在概要設(shè)計(jì)過(guò)程中所完成的各模塊設(shè)計(jì)結(jié)構(gòu)，或在修改時(shí)找出在本階段設(shè)計(jì)的不足或錯(cuò)誤。

3.2任務(wù)概述

3.2.1目標(biāo)

項(xiàng)目目標(biāo)應(yīng)當(dāng)符合SMART原則，項(xiàng)目要完成的工作用明了的語(yǔ)言描述出來(lái)，校友錄系統(tǒng)項(xiàng)目目標(biāo)如下：（1）、文本比較：

比較兩個(gè)文本文件的內(nèi)容。假使兩個(gè)文件完全一致，則打印“TheTwoFilesareidentical!〞；假使不完全一致，則顯示不同處所在的行號(hào)及不同點(diǎn)；比較結(jié)果顯示在屏幕的同時(shí)，寫(xiě)入文件。（2）、文件夾比較：

比較兩個(gè)文件夾內(nèi)對(duì)應(yīng)文件的異同。假使對(duì)應(yīng)的兩個(gè)文件完全一致，則顯示任何信息；假使不完全一致，則顯示文件名、不同處所在的行號(hào)及不同點(diǎn)，比較結(jié)果顯示在屏幕的同時(shí)，寫(xiě)入文件。

3.2.2運(yùn)行環(huán)境

客戶(hù)端：

操作系統(tǒng)：MicrosoftWindows98簡(jiǎn)體中文版或以上

3.2.3需求概述

代碼比較器主要實(shí)現(xiàn)文本文件的比較，與文件夾的比較

3.3總體設(shè)計(jì)

3.3.1基本設(shè)計(jì)概念和處理流程

圖6

3.4運(yùn)行設(shè)計(jì)

運(yùn)行模塊組合

哈軟代碼比較工具1.文本文件比較輸入文件1的路徑輸入文件2的路徑

輸入比較結(jié)果存放的路徑2.文件夾比較輸入文件夾1的路徑輸入文件夾2的路徑

輸入比較結(jié)果文件存放的路徑3.退出

第四章詳細(xì)設(shè)計(jì)

4.1引言

4.1.1編寫(xiě)目的

該詳細(xì)設(shè)計(jì)說(shuō)明書(shū)的目的在于根據(jù)哈軟代碼比較工具需求說(shuō)明與概要設(shè)計(jì)說(shuō)明提出該系統(tǒng)的詳細(xì)設(shè)計(jì)，即系統(tǒng)的詳細(xì)架構(gòu)，主要包括程序系統(tǒng)的結(jié)構(gòu)以及各層次中每個(gè)程序的設(shè)計(jì)考慮。預(yù)期讀者為指導(dǎo)老師。

4.2軟件結(jié)構(gòu)

4.2.1需求概述

1．文本文件比較2.文件夾比較

4.2.2軟件結(jié)構(gòu)

圖7

4.3程序設(shè)計(jì)說(shuō)明

4.3.1輸入項(xiàng)

4.3.2輸出項(xiàng)

比較結(jié)果輸出

4.3.3算法

（1）.文本文件比較算法

分別讀取文本1，文本2和比較結(jié)果寫(xiě)入的文本的路徑，以只讀的方式開(kāi)啟

問(wèn)文本1和文本2，以只寫(xiě)的方式開(kāi)啟寫(xiě)入比較結(jié)果文本，假使文件開(kāi)啟失敗，輸出提醒，返回，開(kāi)啟成功則同時(shí)從文件1與文件2中讀取字符，并設(shè)置行標(biāo)記i，假使讀取字符為換行，i++，假使讀取字符為EOF則比較終止，讀取來(lái)的字符進(jìn)行比較是否一致，假使不一致，輸出文件1文件2此行的內(nèi)容，假使一個(gè)文件到達(dá)行尾另一個(gè)沒(méi)有到達(dá)則，到達(dá)的中止讀入，未到達(dá)的讀到行尾，假使一個(gè)到達(dá)文件尾另一個(gè)未到達(dá)，則未到達(dá)的繼續(xù)讀取，假使一致，輸出一致，同時(shí)寫(xiě)入文件，假使不同，相識(shí)不同的行號(hào)，和此行內(nèi)容，并寫(xiě)入比較結(jié)果文本。

（2）.文件夾比較算法

分別讀取文件夾1，文件夾2和文件夾比較結(jié)果寫(xiě)入文本的路徑，調(diào)用system命令dir，將文件夾1和文件夾2中的內(nèi)容寫(xiě)入到file1和file2中，再將file1，file2的前五行去掉，然后寫(xiě)入到wfile1和wfile2，從wfile1和wfile2中分別讀取時(shí)間，大小或DIR，文件名存到不同的數(shù)組中，從wfile1中讀取一條記錄，與wfile2中的所有記錄比較，假使類(lèi)型一致，文件名一致，并且不是文件夾類(lèi)型，調(diào)用文本比較函數(shù)1比較是否一致，將結(jié)果存入以此文件名.txt的文件中，在屏幕上顯示是否一致，是文件夾時(shí)不調(diào)用文本比較函數(shù)輸出兩個(gè)文件夾都有，假使在文件夾2中找不到，則輸出時(shí)間，大小，文件名，和只有文件夾1有，wfile1中的內(nèi)容比較終止后，用同樣的方法比較wfile2，找出只有wfile2有的。將比較結(jié)果顯示到屏幕，并寫(xiě)入到比較結(jié)果文本，刪除file1file2，wfile1，wfile2。

4.3.4程序規(guī)律

圖8

4.3.4解釋設(shè)計(jì)

①在每一個(gè)模塊首部的解釋?zhuān)忉尡灸８髯兞康墓δ?，范圍，缺省條件等所加的解釋

②必要地方對(duì)各變量的功能，范圍，缺省條件等所加的解釋③對(duì)使用的規(guī)律所加的解釋等

4.3