JAR Externo y Mapeo de Tipos

Utiliza decompilación y un mapeador de esquema personalizado cuando el handler/DTO del módulo común está fuera del árbol de source.

Agregar jar basado en clase

java

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

Encuentra la ubicación del jar en la fuente de código de la clase especificada y decompila con CFR para ampliar el alcance del análisis de ruta/manejador/tipo. También se proporciona addDecompileJar para agregar directamente la ruta del jar.

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();

Si el predicado devuelve true, se maneja el esquema de ese tipo con un mapeo personalizado. Se puede usar para números y envolturas de fecha donde la forma de serialización JSON del proyecto difiere del esquema OpenAPI.

sourceClasspath

Cuando el solucionador de símbolos no puede encontrar fuentes externas o clases compiladas, se utilizan addSourceClasspath y sourceClasspath. No es suficiente que simplemente exista una importación para que el parser pueda interpretar todos los tipos genéricos.