[发明专利]一种API文档生成方法、装置、设备、存储介质

权利要求书

1.一种API文档生成方法，其特征在于，包括：

基于API文档生成请求获取需要生成API文档的Java文件；

对所述Java文件进行解析，以获取包含与Psi对象的名称和Psi对象的参数对应的英文字符串；

基于翻译策略对所述英文字符串进行中文翻译，以得到相应的翻译结果；

对所述翻译结果进行拼接，生成相应的API文档。

2.根据权利要求1所述的API文档生成方法，其特征在于，所述对所述Java文件进行解析，以获取包含与Psi对象的名称和Psi对象的参数对应的英文字符串，包括：

通过IDE接口将所述Java文件解析成Psi树结构；

从所述Psi树结构中获取Psi类，并获取所述Psi类的名称对应的英文字符串；

遍历所述Psi类中所有Psi属性和Psi方法，以获取对应的英文字符串。

3.根据权利要求2所述的API文档生成方法，其特征在于，所述遍历所述Psi类中所有Psi方法，以获取对应的英文字符串，包括：

遍历所有所述Psi方法，获取所述Psi方法的名称的英文字符串、所有参数的英文字符串和返回值类型的英文字符串。

4.根据权利要求3所述的API文档生成方法，其特征在于，所述基于翻译策略对所述英文字符串进行中文翻译，以得到相应的翻译结果，包括：

调用翻译接口功能并基于翻译策略对所述Psi方法的名称的英文字符串、所述参数的英文字符串和返回值类型的英文字符串进行中文翻译，以得到相应的翻译结果。

5.根据权利要求4所述的API文档生成方法，其特征在于，所述基于翻译策略对所述英文字符串进行中文翻译，以得到相应的翻译结果之前，还包括：

预先定义包含将英文字符串翻译为中文字符串的翻译方法的翻译接口类，并通过各种翻译服务实现翻译接口功能。

6.根据权利要求1至5任一项所述的API文档生成方法，其特征在于，所述基于翻译策略对所述英文字符串进行中文翻译，以得到相应的翻译结果之前，还包括：

基于翻译策略从服务列表中确定目标翻译服务，利用所述目标翻译服务对所述英文字符串进行中文翻译，以得到相应的翻译结果。

7.根据权利要求6所述的API文档生成方法，其特征在于，所述基于翻译策略对所述英文字符串进行中文翻译，以得到相应的翻译结果之前，还包括：

对所有翻译服务进行排序，并通过历史翻译情况对所述翻译服务进行权重分配，以得到包含所述翻译服务优先级的服务列表。

8.一种API文档生成装置，其特征在于，包括：

文件生成模块，用于基于API文档生成请求获取需要生成API文档的Java文件；

字符串获取模块，用于对所述Java文件进行解析，以获取包含与Psi对象的名称和Psi对象的参数对应的英文字符串；

翻译模块，用于基于翻译策略对所述英文字符串进行中文翻译，以得到相应的翻译结果；

结果拼接模块，用于对所述翻译结果进行拼接，生成相应的API文档。

9.一种电子设备，其特征在于，包括：

存储器，用于保存计算机程序；

处理器，用于执行所述计算机程序，以实现如权利要求1至7任一项所述的API文档生成方法的步骤。

10.一种计算机可读存储介质，其特征在于，用于存储计算机程序；其中，所述计算机程序被处理器执行时实现如权利要求1至7任一项所述的API文档生成方法的步骤。