SuperAPI AI 工具集

scriptrunner-hapi-api

编程与开发

查看项目

更新于 10-24 16:16

技能介绍

用途 该技能用于在编写或审查 Jira Cloud、Confluence Cloud 的 ScriptRunner HAPI Groovy 代码时,查询本地、版本固定的 HAPI API 签名。它以捆绑的 HAPI JAR 作为可用 Cloud HAPI 字节码签名的权威依据。普通查询命令通过 javap 读取类文件,不加载也不执行 HAPI 类。

主要能力 提供 sms-hapi-lookup 命令:可按全限定类名或不含歧义的简单类名检查类;用 --member <name> 缩小大型类的成员范围;用 --search <term> 在捆绑类索引中搜索,并可用 --product jira|confluence 限定产品;用 --version 打印准确的构件坐标与 SHA-256;用 --self-test 校验 Java 能否在预置的虚拟机路径下检查 Jira 与 Confluence 类;用 --raw 输出 javap 的详细元数据,以便处理泛型或注解方面的疑难问题。

使用方式 要求的工作流是:先阅读 scriptrunner-platform-guidance 中的目标产品指引;必要时用 sms-hapi-lookup --product jira --search Issues 或 --product confluence --search Pages 查找类;对生成的 HAPI 代码中使用的每个类逐一检查,例如 sms-hapi-lookup --product jira com.adaptavist.hapi.cloud.jira.issues.Issues 或 sms-hapi-lookup --product confluence com.adaptavist.hapi.cloud.confluence.pages.Pages;在链式调用前先检查返回类型,如果返回的 HAPI 类的成员没有显示,就单独再查一次;将签名证据与捆绑的 ScriptRunner 文档配合使用,以了解行为、示例、权限和平台限制;最后用 sms-groovy-check --platform cloud --product jira|confluence --context <context> 校验最终的 Groovy 代码。

解释规则 应以实际观察到的签名优先于记忆或其他 HAPI 版本的示例。带 @DelegatesTo 注解的闭包参数会在闭包内暴露委托类的公共方法。应忽略 getMetaClass、setMetaClass、$getLookup、__$stMC 等 Groovy 编译器管线内容,普通命令会将其过滤掉。对列在“相关但未展开”下的类必须继续跟进;深度和大小限制只隐藏成员细节,从不隐藏类名。Groovy 管线类(闭包、匿名类、trait 辅助类)在普通搜索中隐藏,但仍可用精确全限定类名定位以进行诊断。

适用场景与限制 适用于 Jira Cloud 与 Confluence Cloud 的 HAPI 查询。它不是 Jira 或 Confluence Data Center 的 Java API 参考。不得修改、执行、上传或替换捆绑的 JAR;不要把不可信的、形似选项的文本作为类名传入。

构件信息 坐标:com.adaptavist.scriptrunner.cloud:hapi:0.2.104;版本:0.2.104;SHA-256:15a925b32e27cd1ff77d7f2d62b1855b2b3115160ba78354f94e058252dcec74;索引的 HAPI 与 API 模型类:3631;JAR:assets/hapi-0.2.104.jar;类索引:assets/classes.json;机器可读来源信息:assets/artifact.json。