Svn代碼統(tǒng)計(jì)和取源代碼工具設(shè)計(jì)方案

1、Subversion代碼統(tǒng)計(jì)及取源代碼工具設(shè)計(jì)方案文件編號(hào)：FH/GYSJ/XX/XXXX-XXX文件版本：0.0.1 擬 制：何永剛 2010年1月22日審 核： 年 月 日批 準(zhǔn)： 年 月 日18 / 18文檔可自由編輯打印修改記錄序號(hào)版本號(hào)生效日期變更理由/變更內(nèi)容變更人備注12345目 錄目 錄31.術(shù)語(yǔ)與縮寫(xiě)解釋42.系統(tǒng)概述42.1背景42.2功能目標(biāo)43.系統(tǒng)總體結(jié)構(gòu)43.1模塊劃分結(jié)構(gòu)圖44.數(shù)據(jù)流程說(shuō)明64.1數(shù)據(jù)流程圖64.2數(shù)據(jù)處理流程：74.3主要數(shù)據(jù)說(shuō)明：105.模塊設(shè)計(jì)126.參考資料錯(cuò)誤！未定義書(shū)簽。1. 術(shù)語(yǔ)與縮寫(xiě)解釋縮寫(xiě)、術(shù)語(yǔ)解釋REPOS_PATHSubve

2、rsion Repository Path，Subversion 數(shù)據(jù)倉(cāng)庫(kù)路徑2. 系統(tǒng)概述2.1背景部門(mén)決定更換版本控制工具，從Visual SourceSafe更換至Subversion，版本控制工具相關(guān)外圍工具也需要隨之更換。版本控制器對(duì)外接口改變，原VSS代碼統(tǒng)計(jì)工具VManager不能在Subversion中使用，因此需要針對(duì)Subversion提供的接口進(jìn)行開(kāi)發(fā)。2.2功能目標(biāo)獲取指定源代碼文件提交時(shí)間端內(nèi)，指定作者所屬的代碼修改量。獲取指定作者新建、維護(hù)的源代碼，新建文件存放于Create文件夾，維護(hù)代碼文件分New（修改后的源碼文件）和Old（修改前的源碼文件）兩個(gè)文件夾存放3

3、. 系統(tǒng)總體結(jié)構(gòu)3.1模塊劃分結(jié)構(gòu)圖圖3.1.1用戶(hù)數(shù)據(jù)輸入，任務(wù)制定、讀取模塊 TaskDefine該模塊重用自VManager的TaskDefineDlg，存儲(chǔ)和讀取查詢(xún)?nèi)蝿?wù)信息：查詢(xún)用戶(hù)名AuthorName，時(shí)間段、版本庫(kù)路徑REPOS_PATH等。Subversion數(shù)據(jù)庫(kù)連接、數(shù)據(jù)掘取模塊；DBReader該模塊連接Subversion數(shù)據(jù)庫(kù)，由用戶(hù)界面調(diào)用，以用戶(hù)界面從任務(wù)讀取模塊獲取的查詢(xún)?nèi)蝿?wù)信息為參數(shù), 獲取對(duì)應(yīng)查詢(xún)用戶(hù)（作者）的源代碼文件信息：版本，日期，獲取對(duì)應(yīng)源代碼文件內(nèi)容等。中間數(shù)據(jù)處理、統(tǒng)計(jì)模塊。DataAnalyze該模塊分析處理從Subversion數(shù)據(jù)掘取模塊

4、獲取的查詢(xún)用戶(hù)信息，進(jìn)行查詢(xún)結(jié)果統(tǒng)計(jì)：源代碼文件，代碼量。文件、統(tǒng)計(jì)結(jié)果存儲(chǔ)模塊 SaveResult該模塊重用自VManager的Display模塊，存儲(chǔ)數(shù)據(jù)處理模塊的輸出信息：需存儲(chǔ)源代碼內(nèi)容、存放路徑。（有取代碼需求時(shí)存儲(chǔ)），代碼量統(tǒng)計(jì)結(jié)果。用戶(hù)操作界面用戶(hù)界面，用戶(hù)可通過(guò)界面操作進(jìn)行任務(wù)制定、執(zhí)行，并監(jiān)視查詢(xún)?nèi)蝿?wù)的執(zhí)行狀態(tài)4.數(shù)據(jù)流程說(shuō)明4.1數(shù)據(jù)流程圖圖4.1.1流程圖中灰色部分是基本流程模塊， 黃色部分和綠色部分為二選一模塊；黃色模塊使用Subversion自帶的文件比較工具進(jìn)行代碼修改量統(tǒng)計(jì)，綠色模塊使用VManager代碼統(tǒng)計(jì)工具中的文件比較模塊進(jìn)行代碼修改量的統(tǒng)計(jì)，兩種方式的

5、執(zhí)行效率及精確程度需要完成后比較。4.2數(shù)據(jù)處理流程：1、 History從Subversion庫(kù)（REPOS_PATH）獲取該庫(kù)的版本歷史信息，將其保存為一個(gè)版本列表 ReversionList：如圖4.2.1所示圖4.2.12、 Info根據(jù)版本號(hào)_reversion獲取該版本的信息：作者、時(shí)間、提交日志； 由此可以得出 數(shù)據(jù)對(duì)。圖4.2.23、 Chaged根據(jù)版本號(hào)_reversion獲取該版本的修改信息（針對(duì)版本目錄的），由此獲得版本號(hào)、修改文件列表：如下圖示，由此得出數(shù)據(jù)對(duì)圖4.2.34、 代碼統(tǒng)計(jì)方法之一：Diff 根據(jù)版本號(hào)_reversion獲取版本目錄下該版本所有修改文件的

6、修改內(nèi)容（見(jiàn)圖4.2.4）：分析該文件可獲取代碼修改量，代碼修改內(nèi)容，差異文件版本號(hào)：。根據(jù)前面History、Info、Change獲取的文件信息, 判定差異版本是否屬于同一作者，如果非同一作者，代碼量計(jì)入結(jié)果；同一作者則不計(jì)。取源代碼文件到本地時(shí), 取Rversion版本到New文件夾，PreReversion版本到Old文件夾。Reversion為1時(shí)，取文件到Create文件夾。 圖4.2.45、 代碼統(tǒng)計(jì)方法之二：根據(jù)History、Info、Changed獲取的數(shù)據(jù)：處理后可獲得: , 已滿(mǎn)足代碼量統(tǒng)計(jì)的基本條件，以文件名為關(guān)鍵字，遍歷文件的各個(gè)版本獲取信息： （前一版本為最近的不

7、屬于該作者的版本；版本由作者創(chuàng)建且一直維護(hù)則前一版本為0）通過(guò)Cat命令獲取對(duì)應(yīng)版本號(hào)的文件內(nèi)容：調(diào)用VManager的文件比較模塊CmpMngr，比較兩個(gè)版本的差異，進(jìn)行代碼量統(tǒng)計(jì)。存儲(chǔ)Reversion文件于New文件夾，存儲(chǔ)PreReversion文件于Old文件夾。PreReversion為0的，存Reversion于Create文件夾。圖4.2.5：3.1 系統(tǒng)處理流程5.模塊設(shè)計(jì)5.1 界面模塊功能：（1） 任務(wù)制定、讀取入口：接收用戶(hù)輸入，調(diào)用任務(wù)制定模塊；開(kāi)始、停止選定任務(wù)。（2） 顯示當(dāng)前任務(wù)列表：已執(zhí)行任務(wù)、未執(zhí)行任務(wù)。（3） 顯示當(dāng)前任務(wù)處理進(jìn)度。（4） 提供配置選項(xiàng)如：

8、統(tǒng)計(jì)文件類(lèi)型選擇、多線(xiàn)程處理等。（5） 任務(wù)制定界面，任務(wù)要素輸入：Author、DateTime、Repos_path, LoginUser, LoginPwd.。（6） 提供結(jié)果顯示界面，以TreeView形式顯示版本庫(kù)及各目錄、子目錄對(duì)應(yīng)的代碼文件行數(shù)。界面示圖：類(lèi)似于VManager的Frame-View示圖5.2 SVN數(shù)據(jù)讀取模塊功能：（1） 創(chuàng)建cmd子進(jìn)程，執(zhí)行svnlook程序，參數(shù)：option History | info | changed | diff -r repos_pathoptioncat r repos_path _inRepos（2） 通過(guò)創(chuàng)建管道Pipe

9、，從cmd子進(jìn)程讀取svnlook程序的執(zhí)行結(jié)果。（3） 簡(jiǎn)單分析svnlook返回?cái)?shù)據(jù)，主要數(shù)據(jù)說(shuō)明見(jiàn)下文。（4） 提供取文件接口給外部使用主要數(shù)據(jù)說(shuō)明：以數(shù)據(jù)處理順序說(shuō)明從subversion數(shù)據(jù)庫(kù)取出處理的信息：ReposInfo：（目錄歷史信息）Repository_pathversionsn.321ReversionInfo: (目錄版本信息)ReversionAuthorNameDateTimeFile1File2File3UserInfo：(作者信息) , : （文件信息）：rn_author*_dateTime._r3_author*_dateTime_r2_authou*_d

10、ateTime_r1_author*_dateTime：（文件修改信息）統(tǒng)計(jì)方法 一AuthorName, Files, Reversion1Preversion1LinesChanged1Reversion2Preversion2LinesChanged2.Reversion_nPreversion_nLinesChanged_n主要流程：接口設(shè)計(jì)對(duì)外接口， Read(Repos_Path, ，Reversion);參數(shù)：指定的版本庫(kù)路徑Repos_Path, 文件在版本庫(kù)中的絕對(duì)路徑，版本號(hào)Reversion。根據(jù)參數(shù)調(diào)用cmd子進(jìn)程，運(yùn)行svnlook程序，參數(shù)cat r Reversion Repos_path 獲取到指定文件指定版本的文件內(nèi)容。5.3 數(shù)據(jù)分析處理模塊功能：（1） 接收svn數(shù)據(jù)庫(kù)讀取模塊返回的數(shù)據(jù)結(jié)構(gòu)，ReversionInfo、; .（2） 對(duì)接收的數(shù)據(jù)信息進(jìn)行分析：統(tǒng)計(jì)方法一： 分析數(shù)據(jù)結(jié)構(gòu)， 統(tǒng)計(jì)指定用戶(hù)的總代碼修改量；根據(jù)，調(diào)用SVN數(shù)據(jù)庫(kù)讀取模塊提供的取文件接口，獲取對(duì)應(yīng)版本的文件內(nèi)容，調(diào)用存儲(chǔ)模塊存儲(chǔ)到本地；統(tǒng)計(jì)方法二： 分析ReversionInfo、數(shù)據(jù)結(jié)構(gòu)