论文部分内容阅读
开源软件被应用得越来越广泛,但因为开发模式的松散性,开源软件通常缺乏完善的文档和注释,想要完整的理解并深入定制和应用开源软件难度较大。在重用开源代码前,开发人员通常会对代码进行较为系统的分析和验证,撰写源代码分析注释。源代码分析注释是一种以注释形式存在的代码分析报告,以开放、协作的方式撰写而成,是辅助代码理解及后续的重用的有效手段。已有的代码注释的研究大多集中在通过发掘注释与代码的不一致性来寻找软件的缺陷上,系统的评价代码注释质量的研究仍然较少。另一方面,源代码分析注释与代码注释并不完全相同,代码注释的质量评价方法也不能全面的评价源代码分析注释的质量。因此,虽然源代码分析注释的质量对开源软件代码分析以及重用而言影响重大,但是仍然缺乏有效的质量评价方法。 为了更好的评价源代码分析注释的质量,快速有效的发现源代码分析注释中存在的质量问题,保证源代码分析工作的效果,本文结合源代码分析注释的特点提出了一种更为全面而且有效的质量评价方法。该方法从软件质量评价,代码注释质量评价和信息质量评价三个领域进行了综合分析,提出了一种综合考虑客观质量属性和主观质量属性的质量评价框架。本文的质量评价框架充分考虑了源代码分析注释内容的富文本性和目的相关性,通过对质量属性客观和主观的分拆,平衡了质量评价的效率和效果。考虑到源代码分析注释开放协作编辑的特点,框架不仅从制品维度,而且从过程维度设计了质量属性,使评价更为全面。结合源代码分析注释的数据特点,本文对每一个质量属性都给出了详细的分析度量方法。为了验证框架的有效性,本文还针对国家核高基课题中收集的Linux内核源代码分析注释数据做了质量分析。结果表明,本文的方法可以更有效的检测出注释中的冗余以及无关内容,也从注释编辑过程中发现了相关质量问题,有较好的应用价值。此外,本文还根据质量评价框架设计了用来搜集度量信息,并辅助质量评价过程的原型工具,以进一步提高质量评价的效率。