Swagger / OpenAPI

Reescribe el JSON de OpenAPI solo cuando se cambian el RouterFunction y la fuente del manejador.

Modo de endpoint funcional

ApiAccountRouter.java

java

Combina la ruta anidada, el método HTTP y la referencia del método manejador para construir el endpoint. El parser del manejador infiere el tipo del cuerpo de la solicitud y el publicador de respuesta.

SwaggerJsonFileWatcher.Config

directorioDeObservación

src/main/java por defecto

swaggerOutputFile

src/main/resources/static/swagger.json por defecto

projectMode

FUNCTIONAL_ENDPOINT por defecto, MVC opcional

addDecompileJar / addDecompileJarClass

análisis de fuente de tipo jar externo

addSourceClasspath

fuente/classpath para resolución de símbolos

customTypeMapper

Recibe clases y mapas de esquemas para aplicar esquemas personalizados.

Anotación que corrige inferencias

java

Escribir solo si ha cambiado

Si el resultado de la generación es igual al JSON existente, no se cambiará innecesariamente la marca de tiempo del archivo. Esto es beneficioso para reducir el bucle de regeneración en una estructura donde el watcher del frontend detecta cambios en el archivo swagger.