JAR Eksternal & Pemetaan Tipe

Menggunakan decompile dan custom schema mapper ketika handler/DTO modul umum berada di luar pohon sumber.

Tambahkan jar berdasarkan kelas

java

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

Mencari lokasi jar dari sumber kode kelas yang ditentukan dan mendekompilasi dengan CFR untuk memperluas analisis route/handler/type. Juga menyediakan addDecompileJar untuk menambahkan jalur jar secara langsung.

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

Jika predicate mengembalikan true, schema tipe tersebut diproses dengan pemetaan kustom. Dapat digunakan untuk membungkus angka dan tanggal yang berbeda antara bentuk serialisasi JSON dan schema OpenAPI.

sourceClasspath

Ketika symbol solver tidak dapat menemukan sumber eksternal atau kelas yang dikompilasi, gunakan addSourceClasspath dan sourceClasspath. Hanya dengan adanya import tidak cukup bagi parser untuk menginterpretasikan semua tipe generik.