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

1、Subversion代碼統(tǒng)計(jì)及取源代碼工具設(shè)計(jì)方案文件編號：FH/GYSJ/XX/XXXX-XXX文件版本：0.0.1擬 制：何永剛 2010年1月22日審 核：年月日批 準(zhǔn)：年月日修改記錄序號版本號生效日期變更理由/變更內(nèi)容變更人備注12345目錄目錄31.術(shù)語與縮寫解釋42.系統(tǒng)概述42.1背景42.2功能目標(biāo)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è)計(jì)126.參考資料錯誤！未定義書簽。1. 術(shù)語與縮寫解釋縮寫、術(shù)語解釋REPOS_PATHSubversion Repository Path，Sub

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

3、，任務(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)計(jì)模塊。DataAnalyze該模塊分析處理從Subversion數(shù)據(jù)掘取模塊獲取的查詢用戶信息，進(jìn)行查詢結(jié)果統(tǒng)計(jì)：源代碼文件，代碼量。文

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

5、History從Subversion庫（REPOS_PATH）獲取該庫的版本歷史信息，將其保存為一個版本列表 ReversionList：如圖4.2.1所示圖4.2.12、 Info根據(jù)版本號_reversion獲取該版本的信息：作者、時間、提交日志； 由此可以得出 <Author, ReversionNo> 數(shù)據(jù)對。圖4.2.23、 Chaged根據(jù)版本號_reversion獲取該版本的修改信息（針對版本目錄的），由此獲得版本號、修改文件列表：如下圖示，由此得出<ReversionNo, FileList>數(shù)據(jù)對圖4.2.34、 代碼統(tǒng)計(jì)方法之一：Diff 根據(jù)版本號

6、_reversion獲取版本目錄下該版本所有修改文件的修改內(nèi)容（見圖4.2.4）：分析該文件可獲取代碼修改量，代碼修改內(nèi)容，差異文件版本號：<FileName, AuthorName, Reversion, PreReversion, FileChanged>。根據(jù)前面History、Info、Change獲取的文件信息<FileName, Reversion, AuthorName>, 判定差異版本是否屬于同一作者，如果非同一作者，代碼量計(jì)入結(jié)果；同一作者則不計(jì)。取源代碼文件到本地時, 取Rversion版本到New文件夾，PreReversion版本到Old文件夾。

7、Reversion為1時，取文件到Create文件夾。圖4.2.45、 代碼統(tǒng)計(jì)方法之二：根據(jù)History、Info、Changed獲取的數(shù)據(jù)：<Repos_path, ReversionList><Reversion, AuthorName, Date><Reversion, FileList >處理后可獲得: <AuthorName, Date，F(xiàn)ileName, ReversionNo>, 已滿足代碼量統(tǒng)計(jì)的基本條件，以文件名為關(guān)鍵字，遍歷文件的各個版本獲取信息：<作者名，作者版本，前一版本> （前一版本為最近的不屬于該作者的

8、版本；版本由作者創(chuàng)建且一直維護(hù)則前一版本為0）<AuthorName, Reversion, PreReversion>通過Cat命令獲取對應(yīng)版本號的文件內(nèi)容：<Reversion，F(xiàn)ileContent>調(diào)用VManager的文件比較模塊CmpMngr，比較兩個版本的差異，進(jìn)行代碼量統(tǒng)計(jì)。存儲Reversion文件于New文件夾，存儲PreReversion文件于Old文件夾。PreReversion為0的，存Reversion于Create文件夾。圖：3.1 系統(tǒng)處理流程5.模塊設(shè)計(jì)5.1 界面模塊功能：（1） 任務(wù)制定、讀取入口：接收用戶輸入，調(diào)用任務(wù)制定模塊；開

9、始、停止選定任務(wù)。（2） 顯示當(dāng)前任務(wù)列表：已執(zhí)行任務(wù)、未執(zhí)行任務(wù)。（3） 顯示當(dāng)前任務(wù)處理進(jìn)度。（4） 提供配置選項(xiàng)如：統(tǒng)計(jì)文件類型選擇、多線程處理等。（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子進(jìn)程，執(zhí)行svnlook程序，參數(shù)：option History | info | changed | di

10、ff -r repos_pathoptioncat r repos_path filePath_inRepos（2） 通過創(chuàng)建管道Pipe，從cmd子進(jìn)程讀取svnlook程序的執(zhí)行結(jié)果。（3） 簡單分析svnlook返回?cái)?shù)據(jù)，主要數(shù)據(jù)說明見下文。（4） 提供取文件接口給外部使用主要數(shù)據(jù)說明：以數(shù)據(jù)處理順序說明從subversion數(shù)據(jù)庫取出處理的信息：ReposInfo：（目錄歷史信息）<Repos_path, ReversionList>Repository_pathversionsn.321ReversionInfo: (目錄版本信息)<Reversion, Autho

11、r, FileList >ReversionAuthorNameDateTimeFileListFile1File2File3UserInfo：(作者信息)<AuthorName, FileList> , <AuthorName，ReversionNo，DateTime>FileInfo: （文件信息）<FileName, Reversion, AuthorName>：FileNamern_author*_dateTime._r3_author*_dateTime_r2_authou*_dateTime_r1_author*_dateTimeFileC

12、hangeInfo：（文件修改信息）統(tǒng)計(jì)方法 一<AuthorName, Files, <Reversion, PreReversion, LinesCanged>>FileNameReversion1Preversion1LinesChanged1Reversion2Preversion2LinesChanged2.Reversion_nPreversion_nLinesChanged_n主要流程：接口設(shè)計(jì)對外接口， ReadFileFromDB(Repos_Path, FilePathInRepos，Reversion);參數(shù)：指定的版本庫路徑Repos_Path,

13、 文件在版本庫中的絕對路徑FilePathInRepos，版本號Reversion。根據(jù)參數(shù)調(diào)用cmd子進(jìn)程，運(yùn)行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ù)信息進(jìn)行分析：統(tǒng)計(jì)方法一： 分析FileChangedInfo數(shù)據(jù)結(jié)構(gòu)， 統(tǒng)計(jì)指定用戶的總代碼修改量；根據(jù)<Reversion, PreReversion>，調(diào)用SVN數(shù)據(jù)庫讀取模塊提供的取文件接口，獲取對應(yīng)版本的文件內(nèi)容，調(diào)用存儲模塊存儲到本地；統(tǒng)計(jì)方法二： 分析ReversionInfo、FileInfo數(shù)據(jù)結(jié)構(gòu)，獲取統(tǒng)計(jì)所需信息：<FileName, Reversoin, DateTime, Aut