JAR Externo & Mapeamento de Tipo

Usa decompilação e mapeador de esquema personalizado quando o handler/DTO do módulo comum está fora da árvore de código-fonte.

Adicionar jar baseado na classe

java

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

Encontra a localização do jar na fonte de código da classe especificada e decompila com CFR para ampliar a análise de rota/manipulador/tipo. Também oferece addDecompileJar para adicionar diretamente o caminho do 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();

Se o predicado retornar true, o esquema do tipo correspondente é tratado com mapeamento personalizado. Pode ser usado para wrappers numéricos e de data que diferem entre a forma de serialização JSON do projeto e o esquema OpenAPI.

sourceClasspath

Quando o solucionador de símbolos não consegue encontrar fontes externas ou classes compiladas, use addSourceClasspath e sourceClasspath. Apenas ter um import não garante que o parser possa interpretar todos os tipos genéricos.