外部 JAR 和类型映射

当公共模块处理程序/DTO 在源树之外时，使用反编译和自定义模式映射器.

按类添加 jar

java

var swaggerConfig = SwaggerJsonFileWatcher.Config.builder()
    .addDecompileJarClass(com.example.common.web.handler.ApiUploadHandler.class)
    .build();

在指定类的代码源中查找 jar 位置，并使用 CFR 反编译以扩展路由/处理程序/类型分析范围。还提供直接添加 jar 路径的 addDecompileJar。

custom type schema

java

var swaggerConfig = SwaggerJsonFileWatcher.Config.builder()
    .customTypeMapper((type, schema) -> {
      if (type == Long.class || type == BigDecimal.class || type == BigInteger.class) {
        schema.put("type", "integer");
        schema.put("format", "int64");
        return true;
      }
      return false;
    })
    .build();

当谓词返回 true 时，使用自定义映射处理该类型的模式。可用于项目中 JSON 序列化形式与 OpenAPI 模式不同的数字·日期包装。

sourceClasspath

当符号求解器无法找到外部源或编译类时，使用 addSourceClasspath 和 sourceClasspath。仅仅存在导入并不能使解析器解释所有泛型类型。