Skip to content

SpringFlow v0.1.1 - Swagger Fixes

Choose a tag to compare

@tky0065 tky0065 released this 23 Dec 08:26
· 143 commits to main since this release

🐛 Corrections Swagger UI

Cette version corrige les problèmes d'affichage dans Swagger UI identifiés dans la version 0.1.0.

Fixed

  • ✅ Paths dupliqués corrigés - /api/api/categories → /api/categories
  • ✅ Configuration OpenAPI server URL - Changé de /api à / pour éviter la concaténation de paths
  • ✅ "No operations defined in spec!" - Les endpoints générés dynamiquement apparaissent maintenant dans Swagger UI
  • ✅ Récupération des métadonnées - Fix de SpringFlowOpenApiCustomizer pour accéder aux métadonnées via factory beans

Changed

  • Intégration OpenAPI customizer - Passage de la détection automatique de beans à l'intégration directe avec GroupedOpenApi.builder()
  • Génération des paths de contrôleurs - ControllerGenerator retourne maintenant les paths spécifiques aux entités sans le base path global
  • Amélioration de la documentation OpenAPI avec operation IDs, summaires et descriptions appropriés

Installation

Maven:
```xml

io.github.tky0065
springflow-starter
0.1.1

```

Gradle:
```gradle
implementation 'io.github.tky0065:springflow-starter:0.1.1'
```

Vérification

Swagger UI est maintenant disponible avec tous les endpoints correctement documentés à /swagger-ui.html!

Détails Techniques

  • OpenApiConfiguration.java:98 - Server URL changé de properties.getBasePath() à /
  • SpringFlowOpenApiCustomizer.java - Ajout de la méthode getMetadataFromFactory() pour accéder aux métadonnées des factory beans
  • ControllerGenerator.java:85 - Génération du base path retourne "/" + plural au lieu de "/api/" + plural

📦 Disponibilité: Cette version sera disponible sur Maven Central dans 10-30 minutes, et totalement synchronisée dans 2-4 heures.

🔗 Liens: