[发明专利]一种Java API程序异常与文档的描述不一致自动检测方法

摘要

本发明公开一种Java API程序异常与文档的描述不一致自动检测方法，步骤是：提取源代码中每个方法的执行代码部分以及注释文档部分，分别进行分析；遍历当前分析目标的所有方法，提取每个方法的抛出异常类型及其触发条件，并建立目标工程源代码各方法之间的调用关系库；再次分析目标工程提取出的数据，对于每一个方法，首先分析当前的异常触发条件，然后根据调用关系，递归分析调用方法中的异常触发条件；对于目标工程中的每个方法，利用启发式方法分析其注释文档，将提取出的异常信息与步文档描述信息进行比对，进而检测出两者不一致的问题。此种检测方法可提高Java API文档对抛出异常描述的准确性，进而提高软件质量。

主权项

1.一种Java API程序异常与文档的描述不一致自动检测方法，其特征在于包括如下步骤：(1)提取源代码中每个方法的执行代码部分以及注释文档部分，分别进行分析；所述步骤(1)中，注释文档指每个Java API方法对应的Javadoc Annotation注释文档，这是一种具有半结构特征的文档；(2)遍历当前分析目标的所有方法，提取每个方法的抛出异常类型及其触发条件，并建立目标工程源代码各方法之间的调用关系库；(3)再次分析目标工程通过步骤(2)中提取出的数据，对于每一个方法，首先分析当前的异常触发条件，然后根据调用关系，递归分析调用方法中的异常触发条件；(4)对于目标工程中的每个方法，利用启发式方法分析其注释文档；所述步骤(4)中，启发式方法指对于某个异常信息，逐个查看注释文档中的特定条目，针对当前异常条件中所涉及到的参数，检查这些文档条目是否将所有参数名称描述完整，从而判断文档中是否对当前异常进行描述；(5)对于目标工程中的每个方法，将步骤(3)中提取出的异常信息与步骤(4)中提取出的文档描述信息进行比对，进而检测出两者不一致的问题。