org.noear.solon.ai.skills.restapi.resolver

类 AbsOpenApiResolver

java.lang.Object

org.noear.solon.ai.skills.restapi.resolver.AbsOpenApiResolver

所有已实现的接口:

ApiResolver

直接已知子类:

OpenApiV2Resolver, OpenApiV3Resolver

@Preview(value="3.9.1")
public abstract class AbsOpenApiResolver
extends java.lang.Object
implements ApiResolver

OpenAPI 解析器抽象基类

提供了对 $ref 引用的递归解析能力，并支持自动提取 API 基础信息

从以下版本开始:

3.9.1

构造器概要

构造器

构造器和说明
AbsOpenApiResolver()

方法概要

限定符和类型	方法和说明
protected java.lang.String	extractDescription(org.noear.snack4.ONode detail) 提取 API 描述信息
protected java.lang.String	generateName(org.noear.snack4.ONode detail, java.lang.String method, java.lang.String path) 生成工具名称：优先使用 operationId，否则根据 method 和 path 生成
protected boolean	isValidMethod(java.lang.String method) 过滤无效或不常用的 HTTP 方法
protected java.lang.String	resolveRef(org.noear.snack4.ONode root, org.noear.snack4.ONode node) 解析引用节点
protected org.noear.snack4.ONode	resolveRefNode(org.noear.snack4.ONode root, org.noear.snack4.ONode node, java.util.Set<java.lang.String> visited) 递归解析 $ref 节点，并处理循环引用

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.noear.solon.ai.skills.restapi.ApiResolver

getName, resolve

构造器详细资料

AbsOpenApiResolver

public AbsOpenApiResolver()

方法详细资料

resolveRef

protected java.lang.String resolveRef(org.noear.snack4.ONode root,
                                      org.noear.snack4.ONode node)

解析引用节点

参数:

node - 包含 $ref 的节点或原始 Schema 节点

resolveRefNode

protected org.noear.snack4.ONode resolveRefNode(org.noear.snack4.ONode root,
                                                org.noear.snack4.ONode node,
                                                java.util.Set<java.lang.String> visited)

递归解析 $ref 节点，并处理循环引用

参数:

visited - 记录已访问的引用路径，防止死循环

isValidMethod

protected boolean isValidMethod(java.lang.String method)

过滤无效或不常用的 HTTP 方法

generateName

protected java.lang.String generateName(org.noear.snack4.ONode detail,
                                        java.lang.String method,
                                        java.lang.String path)

生成工具名称：优先使用 operationId，否则根据 method 和 path 生成

extractDescription

protected java.lang.String extractDescription(org.noear.snack4.ONode detail)

提取 API 描述信息