JAR externe & Mappage de type

Utilise la décompilation et le mappage de schéma personnalisé lorsque le gestionnaire/DTO du module commun se trouve en dehors de l'arbre source.

Ajouter un jar basé sur la classe

java

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

Trouver l'emplacement du jar dans la source de code de la classe spécifiée et décompiler avec CFR pour élargir l'analyse des routes/gestionnaires/types. Fournit également addDecompileJar pour ajouter directement le chemin du 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 le prédicat renvoie true, le schéma de ce type est traité par un mappage personnalisé. Peut être utilisé pour des wrappers numériques et de date où la forme de sérialisation JSON du projet diffère du schéma OpenAPI.

sourceClasspath

Lorsque le résolveur de symboles ne trouve pas de source externe ou de classe compilée, utilisez addSourceClasspath et sourceClasspath. Il ne suffit pas que l'importation existe pour que le parseur puisse interpréter tous les types génériques.