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

1、fh/qr/design/002subversion代碼統(tǒng)計及取源代碼工具設(shè)計方案文件編號：fh/gysj/xx/xxxx-xxx文件版本：0.0.1 擬 制：何永剛 2010年1月22日審 核： 年 月 日批 準： 年 月 日fh/qr/design/002修改記錄序號版本號生效日期變更理由/變更內(nèi)容變更人備注12345目 錄目 錄31.術(shù)語與縮寫解釋42.系統(tǒng)概述42.1背景42.2功能目標43.系統(tǒng)總體結(jié)構(gòu)43.1模塊劃分結(jié)構(gòu)圖44.數(shù)據(jù)流程說明64.1數(shù)據(jù)流程圖64.2數(shù)據(jù)處理流程：74.3主要數(shù)據(jù)說明：105.模塊設(shè)計126.參考資料錯誤！未定義書簽。1. 術(shù)語與縮寫解釋縮寫、術(shù)語解

2、釋repos_pathsubversion repository path，subversion 數(shù)據(jù)倉庫路徑2. 系統(tǒng)概述2.1背景部門決定更換版本控制工具，從visual sourcesafe更換至subversion，版本控制工具相關(guān)外圍工具也需要隨之更換。版本控制器對外接口改變，原vss代碼統(tǒng)計工具vmanager不能在subversion中使用，因此需要針對subversion提供的接口進行開發(fā)。2.2功能目標獲取指定源代碼文件提交時間端內(nèi)，指定作者所屬的代碼修改量。獲取指定作者新建、維護的源代碼，新建文件存放于create文件夾，維護代碼文件分new（修改后的源碼文件）和old（修

3、改前的源碼文件）兩個文件夾存放3. 系統(tǒng)總體結(jié)構(gòu)3.1模塊劃分結(jié)構(gòu)圖圖3.1.1用戶數(shù)據(jù)輸入，任務(wù)制定、讀取模塊 taskdefine該模塊重用自vmanager的taskdefinedlg，存儲和讀取查詢?nèi)蝿?wù)信息：查詢用戶名authorname，時間段、版本庫路徑repos_path等。subversion數(shù)據(jù)庫連接、數(shù)據(jù)掘取模塊；dbreader該模塊連接subversion數(shù)據(jù)庫，由用戶界面調(diào)用，以用戶界面從任務(wù)讀取模塊獲取的查詢?nèi)蝿?wù)信息為參數(shù), 獲取對應(yīng)查詢用戶（作者）的源代碼文件信息：版本，日期，獲取對應(yīng)源代碼文件內(nèi)容等。中間數(shù)據(jù)處理、統(tǒng)計模塊。dataanalyze該模塊分析處理從

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

5、進行代碼修改量的統(tǒng)計，兩種方式的執(zhí)行效率及精確程度需要完成后比較。4.2數(shù)據(jù)處理流程：1、 history從subversion庫（repos_path）獲取該庫的版本歷史信息，將其保存為一個版本列表 reversionlist：如圖4.2.1所示圖4.2.12、 info根據(jù)版本號_reversion獲取該版本的信息：作者、時間、提交日志； 由此可以得出 數(shù)據(jù)對。圖4.2.23、 chaged根據(jù)版本號_reversion獲取該版本的修改信息（針對版本目錄的），由此獲得版本號、修改文件列表：如下圖示，由此得出數(shù)據(jù)對圖4.2.34、 代碼統(tǒng)計方法之一：diff 根據(jù)版本號_reversion獲

6、取版本目錄下該版本所有修改文件的修改內(nèi)容（見圖4.2.4）：分析該文件可獲取代碼修改量，代碼修改內(nèi)容，差異文件版本號：。根據(jù)前面history、info、change獲取的文件信息, 判定差異版本是否屬于同一作者，如果非同一作者，代碼量計入結(jié)果；同一作者則不計。取源代碼文件到本地時, 取rversion版本到new文件夾，prereversion版本到old文件夾。reversion為1時，取文件到create文件夾。 圖4.2.45、 代碼統(tǒng)計方法之二：根據(jù)history、info、changed獲取的數(shù)據(jù)：處理后可獲得: , 已滿足代碼量統(tǒng)計的基本條件，以文件名為關(guān)鍵字，遍歷文件的各個版本

7、獲取信息： （前一版本為最近的不屬于該作者的版本；版本由作者創(chuàng)建且一直維護則前一版本為0）通過cat命令獲取對應(yīng)版本號的文件內(nèi)容：調(diào)用vmanager的文件比較模塊cmpmngr，比較兩個版本的差異，進行代碼量統(tǒng)計。存儲reversion文件于new文件夾，存儲prereversion文件于old文件夾。prereversion為0的，存reversion于create文件夾。圖4.2.5：3.1 系統(tǒng)處理流程5.模塊設(shè)計5.1 界面模塊功能：（1） 任務(wù)制定、讀取入口：接收用戶輸入，調(diào)用任務(wù)制定模塊；開始、停止選定任務(wù)。（2） 顯示當(dāng)前任務(wù)列表：已執(zhí)行任務(wù)、未執(zhí)行任務(wù)。（3） 顯示當(dāng)前任務(wù)處

8、理進度。（4） 提供配置選項如：統(tǒng)計文件類型選擇、多線程處理等。（5） 任務(wù)制定界面，任務(wù)要素輸入：author、datetime、repos_path, loginuser, loginpwd.。（6） 提供結(jié)果顯示界面，以treeview形式顯示版本庫及各目錄、子目錄對應(yīng)的代碼文件行數(shù)。界面示圖：類似于vmanager的frame-view示圖5.2 svn數(shù)據(jù)讀取模塊功能：（1） 創(chuàng)建cmd子進程，執(zhí)行svnlook程序，參數(shù)：option history | info | changed | diff -r repos_pathoptioncat r repos_path filepa

9、th_inrepos（2） 通過創(chuàng)建管道pipe，從cmd子進程讀取svnlook程序的執(zhí)行結(jié)果。（3） 簡單分析svnlook返回數(shù)據(jù)，主要數(shù)據(jù)說明見下文。（4） 提供取文件接口給外部使用主要數(shù)據(jù)說明：以數(shù)據(jù)處理順序說明從subversion數(shù)據(jù)庫取出處理的信息：reposinfo：（目錄歷史信息）repository_pathversionsn.321reversioninfo: (目錄版本信息)reversionauthornamedatetimefilelistfile1file2file3userinfo：(作者信息) , fileinfo: （文件信息）：filenamern_au

10、thor*_datetime._r3_author*_datetime_r2_authou*_datetime_r1_author*_datetimefilechangeinfo：（文件修改信息）統(tǒng)計方法 一authorname, files, filenamereversion1preversion1lineschanged1reversion2preversion2lineschanged2.reversion_npreversion_nlineschanged_n主要流程：接口設(shè)計對外接口， readfilefromdb(repos_path, filepathinrepos，rever

11、sion);參數(shù)：指定的版本庫路徑repos_path, 文件在版本庫中的絕對路徑filepathinrepos，版本號reversion。根據(jù)參數(shù)調(diào)用cmd子進程，運行svnlook程序，參數(shù)cat r reversion repos_path filepathinrepos獲取到指定文件指定版本的文件內(nèi)容。5.3 數(shù)據(jù)分析處理模塊功能：（1） 接收svn數(shù)據(jù)庫讀取模塊返回的數(shù)據(jù)結(jié)構(gòu)，reversioninfo、fileinfo; filechangedifo.（2） 對接收的數(shù)據(jù)信息進行分析：統(tǒng)計方法一： 分析filechangedinfo數(shù)據(jù)結(jié)構(gòu)， 統(tǒng)計指定用戶的總代碼修改量；根據(jù)，調(diào)用svn數(shù)據(jù)庫讀取模塊提供的取文件接口，獲取對應(yīng)版本的文件內(nèi)容，調(diào)用存儲模塊存儲到本地；統(tǒng)計方法二： 分析reversioninfo、fileinfo數(shù)據(jù)結(jié)構(gòu)，獲取統(tǒng)計所需信息：，用vmanager相同統(tǒng)