[發(fā)明專利]一種提高開源代碼注釋率及注釋質(zhì)量的方法有效
| 申請?zhí)枺?/td> | 201810177965.6 | 申請日： | 2018-03-05 |
| 公開（公告）號： | CN108459873B | 公開（公告）日： | 2021-09-24 |
| 發(fā)明（設(shè)計）人： | 王懷民;王濤;於杰;尹剛;余躍;范強;曾令斌;張迅暉;李志星;曾雅蓉;王威;劉晉澤 | 申請（專利權(quán)）人： | 中國人民解放軍國防科技大學(xué) |
| 主分類號： | G06F8/73 | 分類號： | G06F8/73 |
| 代理公司： | 長沙國科天河知識產(chǎn)權(quán)代理有限公司 43225 | 代理人： | 董惠文 |
| 地址： | 410073 湖*** | 國省代碼： | 湖南;43 |
| 權(quán)利要求書： | 查看更多 | 說明書： | 查看更多 |
| 摘要： | |||
| 搜索關(guān)鍵詞： | 一種 提高 源代碼 注釋 質(zhì)量 方法 | ||
1.一種提高開源代碼注釋率及注釋質(zhì)量的方法，其特征在于，包括以下步驟：
步驟1、建立一個代碼數(shù)據(jù)服務(wù)器,從互聯(lián)網(wǎng)的主要代碼托管平臺中采集開源代碼，并對開源代碼進行預(yù)處理；
步驟2、對代碼片段的難易程度劃分等級，代碼等級分為簡單、中等、較難、很難四個等級；
步驟3、對用戶知識掌握程度劃分等級，用戶等級分為基礎(chǔ)、入門、熟悉、精通四個等級；
步驟4、將四個等級的代碼片段按照等級推送給相應(yīng)等級的用戶，讓用戶進行相應(yīng)操作；
步驟5、向用戶推送系統(tǒng)為該段代碼自動產(chǎn)生的問題，用戶進行回答，若回答正確，則顯示用戶回答正確，并高亮用戶答案；若回答不正確，則顯示用戶回答錯誤，并提供參考答案；
其中：步驟4具體包括：
步驟4.1、向用戶展示代碼片段，用戶選擇能否看懂代碼，若能，則執(zhí)行步驟4.2，若不能，則執(zhí)行步驟4.3；
步驟4.2、用戶對代碼進行注釋，然后系統(tǒng)向用戶展示其他用戶對該段代碼的注釋，轉(zhuǎn)步驟4.5；
步驟4.3、系統(tǒng)自動向看不懂用戶展示相關(guān)問題和好注釋，若有好注釋，則展示好注釋，轉(zhuǎn)步驟4.5，若沒有則執(zhí)行步驟4.4；
步驟4.4、用戶查看已有問題和答案是否解決疑惑，若解決疑惑，轉(zhuǎn)步驟4.5，若沒有，提出問題，查看是否有人回答問題，若有執(zhí)行步驟4.6，若沒有，則等待他人回答；
步驟4.5、用戶為回答執(zhí)行點贊、踩、采納行為，并將行為與問題和答案關(guān)聯(lián)；
步驟4.6、將問題與代碼關(guān)聯(lián)，轉(zhuǎn)步驟4.5。
2.如權(quán)利要求1所述的提高開源代碼注釋率及注釋質(zhì)量的方法，其特征在于，所述用戶等級與代碼等級的對應(yīng)關(guān)系是：基礎(chǔ)級用戶對應(yīng)簡單級代碼，入門級用戶對應(yīng)中等級代碼，熟悉級用戶對應(yīng)較難級代碼，精通級用戶對應(yīng)很難級代碼。
3.如權(quán)利要求1所述的提高開源代碼注釋率及注釋質(zhì)量的方法，其特征在于，所述步驟1中采用通用的Web爬蟲技術(shù)從互聯(lián)網(wǎng)的主要代碼托管平臺中采集開源代碼。
4.如權(quán)利要求1所述的提高開源代碼注釋率及注釋質(zhì)量的方法，其特征在于，所述步驟1中對開源代碼進行預(yù)處理，包括：去除代碼里的原始注釋、提取工程目錄結(jié)構(gòu)、提取每個代碼文件所包含的方法、提取方法之間的調(diào)用關(guān)系。
5.如權(quán)利要求1所述的提高開源代碼注釋率及注釋質(zhì)量的方法，其特征在于，所述步驟2對代碼片段的難易程度劃分等級，具體執(zhí)行以下步驟：
步驟2.1、冷啟動時所有代碼片段推送給入門級用戶，入門級用戶選擇能否看懂，記看懂用戶數(shù)量與看不懂用戶數(shù)量比率為Puser，若看懂用戶數(shù)量超過看不懂用戶數(shù)量，即Puser1+δ，δ0,δ的大小根據(jù)需求設(shè)定，則將代碼片段難度下降一級；若看不懂用戶數(shù)量超過看懂用戶數(shù)量，即Puser1-δ,則將代碼片段難度上升一級；若看懂用戶數(shù)量與看不懂用戶數(shù)量大致相當，即1-δ≤Puser≤1+δ，則維持該段代碼難度等級不變；
步驟2.2、將代碼片段推送給相應(yīng)等級用戶，用戶選擇能否看懂，若看懂用戶數(shù)量超過看不懂用戶數(shù)量，即Puser1+δ,則將代碼片段難度下降一級；若看不懂用數(shù)量超過看懂用戶數(shù)量，即Puser1-δ,則將代碼片段難度上升一級；若看懂用戶數(shù)量與看不懂用戶數(shù)量大致相當，即1-δ≤Puser≤1+δ，則維持該段代碼難度等級不變；
步驟2.3、一個代碼片段到達新的難度等級，重復(fù)執(zhí)行步驟2.2，直至各代碼片段難度等級維持不變。
該專利技術(shù)資料僅供研究查看技術(shù)是否侵權(quán)等信息，商用須獲得專利權(quán)人授權(quán)。該專利全部權(quán)利屬于中國人民解放軍國防科技大學(xué)，未經(jīng)中國人民解放軍國防科技大學(xué)許可，擅自商用是侵權(quán)行為。如果您想購買此專利、獲得商業(yè)授權(quán)和技術(shù)合作，請聯(lián)系【客服】
本文鏈接：http://www.szxzyx.cn/pat/books/201810177965.6/1.html，轉(zhuǎn)載請聲明來源鉆瓜專利網(wǎng)。
