Svn代码统计和取源代码工具设计方案

1、Subversion代码统计及取源代码工具设计方案文件编号：FH/G YSJ/XX/XXXX-XXX文件版本：0.0.1拟 制：何永刚2010年1月22日审 核：年 月曰批 准:年 月曰修改记录序号版本号生效日期变更理由/变更内容变更人备注12345目 录31. 术语与缩写解释42. 系统概述42.1背景42.2功能目标43. 系统总体结构53.1模块划分结构图54. 数据流程说明74.1数据流程图74.2数据处理流程：84.3主要数据说明： 115. 模块设计146. 参考资料 错误!未定义书签。1. 术语与缩写解释缩写、术语解释REPOS_PATHSubversion Repository

2、 Path , Subversion 数据仓库路径2. 系统概述2.1背景部门决定更换版本控制工具，从Visual SourceSafe更换至Subversion，版本控制工具相关外围工具也需要随之更换。版本控制器对外接口改变，原VSS代码统计工具 VMa nager不能在Subversion中使用，因此需要针对Subversion提供的接口进行开发。2.2功能目标获取指定源代码文件提交时间端内，指定作者所属的代码修改量。获取指定作者新建、维护的源代码，新建文件存放于Create文件夹，维护代码文件分New （修改后的源码文件）和 Old （修改前的源码文件）两个文件夹存放3. 系统总体结构3

3、.1模块划分结构图Svn服务器工作站图 3.1.1用户数据输入，任务制定、读取模块TaskDefi ne该模块重用自VManager的TaskDefineDIg，存储和读取查询任务信息：查询用户名AuthorName，时间段、版本库路径REPOS_PATH 等。Subversion数据库连接、数据掘取模块；DBReader该模块连接Subversion数据库，由用户界面调用，以用户界面从任务读取模块获取的查询 任务信息为参数，获取对应查询用户(作者)的源代码文件信息：版本，日期，获取对应源代 码文件内容等。中间数据处理、统计模块。DataA nalyze该模块分析处理从 Subversion数

4、据掘取模块获取的查询用户信息，进行查询结果统计：源 代码文件，代码量。文件、统计结果存储模块SaveResult该模块重用自VManager的Display模块，存储数据处理模块的输出信息：需存储源代码内容、存放路径。（有取代码需求时存储），代码量统计结果。用户操作界面用户界面，用户可通过界面操作进行任务制定、执行，并监视查询任务的执行状态4. 数据流程说明4.1数据流程图Subversion DBREPOS PATHREPOS_PATHREPOS_PATHREPOS_PATHTTHistory4Info/ChangedDiff/ _reversion_reversion_reversion7

5、/It£_XL_ItLIEL图 4.1.1流程图中灰色部分是基本流程模块，黄色部分和绿色部分为二选一模块；黄色模块使用Subversion自带的文件比较工具进行代码修改量统计，绿色模块使用VManager代码统计工具中的文件比较模块进行代码修改量的统计，两种方式的执行效率及精确程度需要完成后比较。4.2数据处理流程:1、History从Subversion库(REPOS_PATH)获取该库的版本历史信息，将其保存为一个版本列表 ReversionList :如图 4.2.1 所示刊 SYI败代码-SVWToolkit立件电扁需视圈®帮助DoS H議昌豎C：VWI ND 0&

6、#165;K systemS 2 cmd. exe /C fvnlook history 0- 7S. 1 1. &ro ot.T e st ProjectAppro aching progress i n Thread, Please waitIndex:1Name: f爱订飯baIndex:2Name:-Index：3Name；S3fInder:4Name:52IIndex:5Name:51iIndex:Name:SOfInd&x:7Name：40fIndex：£Name-4StIndex:9Name;47IIndex:1 0Name：46fIndex:1 1Na

7、me:45fIndex；12Name;44fIndex;13Name;4?iIndx：14Name:42fIndex:：1 5Name：41fIndex:1岳Name?40t图 4.2.12、Info根据版本号.reversion获取该版本的信息:作者、时间、提交日志;由此可以得出<Author,ReversionNo> 数据对。图4223、Chaged根据版本号.reversion获取该版本的修改信息（针对版本目录的），由此获得版本号、修改文件列表：如下图示，由此得出vReversionNo, FileList>数据对图4234、代码统计方法之一：Diff根据版本号.rev

8、ersion获取版本目录下该版本所有修改文件的修改内容（见图424）：分析该文件可获取代码修改量，代码修改内容，差异文件版本号：vFileName, AuthorName, Revers ion, PreRevers ion, FileCha nged>。根据前面 History、Info、Change 获取的文件信息 <FileName, Reversion, AuthorName>,判定 差异版本是否属于同一作者，如果非同一作者，代码量计入结果；同一作者则不计。取源代码文件到本地时,取Rversion版本到New文件夹，PreReversion版本到Old文件夹。Reve

9、rsion为1时，取文件到 Create文件夹。:% 取代码 - SVKToolkitid牛（E）编慢（1）视图电）帮勖C7WINDOWSsystern 3 2 cmd. exe /C Evnloolt diff ir 41 0 _ 78,11 9 Sswnro otte stproj ectApproar hi ngprogress inThread, Please w&it.Index:1Name己修改Display.hIndex:2Namt.Index:3Naimie：一-Display.200-08-1 03=09:20 UTC (rev 3)Index:4Name+ 4-4-

10、 Display.h2009-03-19 03:10:28 UTC (rev 4)Index;5Name: -45,4 +45,380 暑Index:6Namt.Citring m_strMeAd;Index:7Nairine：CStrinq m_Eabl eManriE保存表名)CZIndex;8Name:)Index:9Name:+uunuiiiuuuiunuiunuuuuuuuHnuuinuuuiIndex;10+/Difplav.h : interface of the CDis口 1己丫 classIndex;11Name+Index;12N&me;+Index:13Name

11、.+#if !derined(AFX_DISPLAY_H_A8EC85C_F99E_4C7 5_9C86_l 23452 41Index:14Name;+#define ARX_DISPLAY_H_A48EC8 5C_F&&E_4075_9C86_ 1 2 345241 1 E6Index;15Name：+Index;16N&me;+#if -MSC.VER A 1000Index:17Name:+#prajgma onceIndex：18Name:+Wendif / _MSC_VER > 1 000Index：19Name:+和n匚lude s；afxdb.hz

12、Index:20Name:include < odbeinst. h>Index:21Name.+iff include <io.h>Index:22Name：+include -llserlnfo.t)-Index：23Name:+Index:24Name:+typedef std: vector-< GUserlnfos* LIserlnfoList;Index:25Name.+Irirlfnr ? ANftm r"-Ikrlac c PHitril air图4245、代码统计方法之二：根据History、Info、Changed获取的数据：<

13、Repos_path, Revers ion List>< Revers ion, AuthorName, Date><Revers ion, FileList >处理后可获得：<AuthorName, Date ， FileName, ReversionNo>,已满足代码量统计的基本条件，以文件名为关键字，遍历文件的各个版本获取信息：<作者名，作者版本，前一版本 > （前一版本为最近的不属于该作者的版本；版本由作者创建且一直维护则前一版本为0)<AuthorName, Revers ion, PreRevers ion>通过C

14、at命令获取对应版本号的文件内容：(Reversion， FileContent>调用VManager的文件比较模块 CmpMngr，比较两个版本的差异，进行代码量统计。存储 Reversion文件于 New文件夹，存储 PreReversion文件于 Old文件夹。PreReversion 为0的，存Reversion于Create文件夹。svw代码-SVKToollit文件編辑0)视国辺帮助QPD；C:WlNIOOWSsY5tem32cmd.EKE /C 5vnlook cat -r 1 10,78.1 1.95svprootTestProject TaskListView.Appr

15、o achi nqprogress in Thread, Please waitIndex; 1Name; fffUUHHIUHtHUIHfffHUHfffHUifffHfHlffllUiflHUUiftfUUIndex: 2Name: ff Ta.skLi5tView.h : interface of the CTa.skListView classIndex:3Nami ffIndex:4Name:Index; 5Name; ffif !definedCAFX_TASKLI5TVIEW_H_0AEB91 2 5_378B_IDO.A5DA_B241 DB8Index: 6Name: def

16、ine AFX_TASKLISTVIEW_H_0ABB912 5_3 70E_44DO_A5DA_821 DE87EECIndex:1Nam: #if -MSC.VER > 1 000Index:8Name： pragma onceIndex; 9Name; ffendif " .MSC.VER > 1000Index: 10Name: ff TaskListView.h : header fileIndex: 11Name: ffIndex; 12Name： include Task.h"Index; 13Name; fffUUUHUHiHfHUifflHni

17、UffHUUHflfHltniUUtHmUfffHUIndex: 14Name: ff CTask List ViewIndex: 15Name：亡In站 CTaskListView : public CListViewIndex; 16Name： Index; 17Name; protecled:Index: 18Name: CTAskListViewO；./ prorected constructor used bv dynamic creatioIndex： 19Name： DECLARE_DYNC R EATE(CTaS kUstView)Index; 20Name： ff Attri

18、butesIndex; 21Ndme; public:Index: 22Name: T as k List m .taskList;Index： 23Name： T askPtrList m.taskSelectList;Index; 24Name： CT ask m_ tasks el;Index; 25Ndme; int miTaskSel;Index: 26Name: ff OperationsIndex： 27Name： public：图 4.2.5 :3.1系统处理流程1rUserinput1f开始AccessSvnIn formatio nGetInformationAnalyze

19、FSaveFile ?；丫"GetFilesToLocalSaveResult5. 模块设计5.1界面模块功能：（1）任务制定、读取入口：接收用户输入，调用任务制定模块；开始、停止选定任务。（2）显示当前任务列表：已执行任务、未执行任务。（3）显示当前任务处理进度。（4）提供配置选项如：统计文件类型选择、多线程处理等。（5）任务制定界面，任务要素输入：Author、DateTime、Repos_path, LoginUser,Log in Pwd.。（6）提供结果显示界面，以TreeView形式显示版本库及各目录、子目录对应的代码文件行数。界面示图：类似于 VManager的Fram

20、e-View示图5.2 SVN数据读取模块功能：（1）创建cmd子进程，执行 svnlook程序，参数：opti on History | info | cha nged | diff -r repos_pathoptioncat - repos_path filePath_in Repos（2）通过创建管道 Pipe,从cmd子进程读取svnlook程序的执行结果。（3）简单分析svnlook返回数据，主要数据说明见下文。（4）提供取文件接口给外部使用主要数据说明：以数据处理顺序说明从subversion数据库取出处理的信息:ReposInfo :(目录历史信息)<Repos_path

21、, Revers ion List>Repository_pathvers ionsn321Reversionlnfo:（目录版本信息） vRevers ion. Author, FileList >Revers ionAuthorNameDateTimeFileLis tFilelFile2File3UserInfo :（作者信息）<AuthorName, FileList, <AuthorName , ReversionNo , DateTime>File Info:（文件信息）vFileName, Revers ion, AuthorName> :FileNamern_author*_dateTime._r3_author*_dateTime_r2_authou*_dateTimer1author*dateTimeFileChangeInfo :（文件修改信息）统计方法一<AuthorName, Files, vRevers ion, PreRevers ion, Lin esCa nged>>FileNameRevers ion1Prevers ion1Lin esCha nged1Revers ion2Preversi on2Lin esCha nged2Revers ion_nPreversio n_nLin