Swagger / OpenAPI

يتم إعادة كتابة JSON OpenAPI فقط عند تغيير مصدر RouterFunction والمعالج.


وضع نقطة النهاية الوظيفية

ApiAccountRouter.java
java
@Bean
public RouterFunction<ServerResponse> apiAccount(ApiAccountHandler handler) {
  return route()
      .nest(path("/api/account"), builder -> builder
          .nest(path("/search"), search -> search
              .GET("/get-detail/{accountName}", handler::getDetail)
              .GET("/get-list", handler::getList)))
      .build();
}

تكوين نقطة النهاية من خلال دمج المسار المتداخل وطريقة HTTP ومرجع طريقة المعالج. يقوم محلل المعالج باستنتاج نوع جسم الطلب وناشر الاستجابة.

SwaggerJsonFileWatcher.Config

watchDirectory

src/main/java الافتراضي

swaggerOutputFile

الافتراضي src/main/resources/static/swagger.json

projectMode

الافتراضي FUNCTIONAL_ENDPOINT، الخيار MVC

addDecompileJar / addDecompileJarClass

تحليل مصدر نوع jar الخارجي

addSourceClasspath

source/classpath لتحديد الرموز

customTypeMapper

استقبال خريطة الفئة والمخطط لتطبيق مخطط مخصص

تعديل الاستدلال بواسطة التعليق التوضيحي

java
@SelectedRequestParam(
    key = "pageSize",
    required = false,
    nullable = true,
    type = Integer.class
)
Integer pageSize = request.queryParam("pageSize").map(Integer::valueOf).orElse(null);

@SelectedResponseBody(type = MemberDetailResponse.class)
Mono<MemberDetailResponse> response = service.getDetail(accountName);

اكتب فقط في حالة التغيير

إذا كانت نتيجة التوليد مماثلة لـ JSON الحالي، فلن يتم تغيير طابع الملف الزمني بشكل غير ضروري. هذا مفيد في تقليل حلقة إعادة التوليد في هيكل يكتشف فيه المراقب تغييرات ملف swagger.

© 2026 بيولناريم. جميع الحقوق محفوظة.مقدمةسياسة معالجة المعلومات الشخصية