为什么这个 openapi 模式会生成不可用的 java/kotlin 客户端?

如何解决为什么这个 openapi 模式会生成不可用的 java/kotlin 客户端?

向全世界展示我是否错误地使用了 openapi(通过 micronaut kotlin 注释)。我的服务器生成的架构如下

openapi: 3.0.1
info:
  title: WhyLabs Songbird
  description: WhyLabs API that enables end-to-end AI observability
  termsOfService: 'https://whylabs.ai/terms-of-use'
  contact:
    name: WhyLabs
    url: 'https://whylabs.ai'
    email: support@whylabs.ai
  license:
    name: Apache License 2.0
    url: 'https://www.apache.org/licenses/LICENSE-2.0'
  version: '0.1'
paths:
  '/v0/notification-settings/{org_id}':
    get:
      tags:
        - Internal
        - Notification Settings
      summary: Get notification settings for an org
      description: Get notification settings for an org
      operationId: GetNotificationSettings
      parameters:
        - name: org_id
          in: path
          required: true
          schema:
            type: string
      responses:
        default:
          description: GetNotificationSettings default response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetNotificationSettingsResponse'
      security:
        - ApiKeyAuth: []
    post:
      tags:
        - Internal
        - Notification Settings
      summary: Update notification settings for an org
      description: Update notification settings for an org
      operationId: UpdateNotificationSettings
      parameters:
        - name: org_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NotificationSettings'
        required: true
      responses:
        default:
          description: UpdateNotificationSettings default response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationSettings'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    NotificationSqsMessageCadence:
      type: string
      description: How often to deliver messages.
      enum:
        - DAILY
        - WEEKLY
        - INDIVIDUAL
    DailySchedule:
      type: object
      properties:
        cadence:
          $ref: '#/components/schemas/NotificationSqsMessageCadence'
        enabled:
          type: boolean
        local24HourOfDay:
          type: integer
          format: int32
        localMinuteOfHour:
          type: integer
          format: int32
        localTimezone:
          type: string
      description: A schedule that delivers all notifications as they come.
    IndividualSchedule:
      type: object
      properties:
        cadence:
          $ref: '#/components/schemas/NotificationSqsMessageCadence'
        enabled:
          type: boolean
      description: A schedule that delivers all notifications as they come.
    NotificationSettingsDay:
      type: string
      enum:
        - SUNDAY
        - MONDAY
        - TUESDAY
        - WEDNESDAY
        - THURSDAY
        - FRIDAY
        - SATURDAY
    WeeklySchedule:
      type: object
      properties:
        cadence:
          $ref: '#/components/schemas/NotificationSqsMessageCadence'
        enabled:
          type: boolean
        dayOfWeek:
          $ref: '#/components/schemas/NotificationSettingsDay'
        local24HourOfDay:
          type: integer
          format: int32
        localMinuteOfHour:
          type: integer
          format: int32
        localTimezone:
          type: string
      description: A weekly schedule for how often to deliver notifications.
    NotificationSchedule:
      type: object
      description: A schedule for how often to deliver notifications.
      discriminator:
        propertyName: cadence
        mapping:
          WEEKLY: '#/components/schemas/WeeklySchedule'
          DAILY: '#/components/schemas/DailySchedule'
          INDIVIDUAL: '#/components/schemas/IndividualSchedule'
      oneOf:
        - $ref: '#/components/schemas/WeeklySchedule'
        - $ref: '#/components/schemas/DailySchedule'
        - $ref: '#/components/schemas/IndividualSchedule'
    NotificationSettings:
      type: object
      properties:
        emailSettings:
          $ref: '#/components/schemas/NotificationSchedule'
        slackSettings:
          $ref: '#/components/schemas/NotificationSchedule'
      description: Settings that control how and when notifications are delivered.
    GetNotificationSettingsResponse:
      required:
        - items
      type: object
      properties:
        notificationSettings:
          $ref: '#/components/schemas/NotificationSettings'
      description: Response for getting notification settings
    SubscriptionTier:
      type: string
      enum:
        - FREE
        - PAID
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: X-API-Key
      in: header

如果您将其粘贴到 https://editor.swagger.io/ 处的在线 swagger 编辑器中,则相应的休息界面看起来很棒。有一个 UpdateNotificationSettings api 接受 NotificationSettings,其字段可以是以下三项之一:DailyScheduleWeeklyScheduleIndividualSchedule

生成的打字稿客户端看起来不错。它直接将 NotificationSchedule 转换为联合类型,它实际上是。 java/kotlin 生成的客户端实际上无法使用,因为它们创建了子类型实际上并未继承的基本 NotificationSchedule,这意味着您实际上无法使用 api。

我在规范中做错了什么还是这实际上是一个错误?

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


使用本地python环境可以成功执行 import pandas as pd import matplotlib.pyplot as plt # 设置字体 plt.rcParams['font.sans-serif'] = ['SimHei'] # 能正确显示负号 p
错误1:Request method ‘DELETE‘ not supported 错误还原:controller层有一个接口,访问该接口时报错:Request method ‘DELETE‘ not supported 错误原因:没有接收到前端传入的参数,修改为如下 参考 错误2:cannot r
错误1:启动docker镜像时报错:Error response from daemon: driver failed programming external connectivity on endpoint quirky_allen 解决方法:重启docker -> systemctl r
错误1:private field ‘xxx‘ is never assigned 按Altʾnter快捷键,选择第2项 参考:https://blog.csdn.net/shi_hong_fei_hei/article/details/88814070 错误2:启动时报错,不能找到主启动类 #
报错如下,通过源不能下载,最后警告pip需升级版本 Requirement already satisfied: pip in c:\users\ychen\appdata\local\programs\python\python310\lib\site-packages (22.0.4) Coll
错误1:maven打包报错 错误还原:使用maven打包项目时报错如下 [ERROR] Failed to execute goal org.apache.maven.plugins:maven-resources-plugin:3.2.0:resources (default-resources)
错误1:服务调用时报错 服务消费者模块assess通过openFeign调用服务提供者模块hires 如下为服务提供者模块hires的控制层接口 @RestController @RequestMapping("/hires") public class FeignControl
错误1:运行项目后报如下错误 解决方案 报错2:Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile (default-compile) on project sb 解决方案:在pom.
参考 错误原因 过滤器或拦截器在生效时,redisTemplate还没有注入 解决方案:在注入容器时就生效 @Component //项目运行时就注入Spring容器 public class RedisBean { @Resource private RedisTemplate<String
使用vite构建项目报错 C:\Users\ychen\work>npm init @vitejs/app @vitejs/create-app is deprecated, use npm init vite instead C:\Users\ychen\AppData\Local\npm-
参考1 参考2 解决方案 # 点击安装源 协议选择 http:// 路径填写 mirrors.aliyun.com/centos/8.3.2011/BaseOS/x86_64/os URL类型 软件库URL 其他路径 # 版本 7 mirrors.aliyun.com/centos/7/os/x86
报错1 [root@slave1 data_mocker]# kafka-console-consumer.sh --bootstrap-server slave1:9092 --topic topic_db [2023-12-19 18:31:12,770] WARN [Consumer clie
错误1 # 重写数据 hive (edu)> insert overwrite table dwd_trade_cart_add_inc > select data.id, > data.user_id, > data.course_id, > date_format(
错误1 hive (edu)> insert into huanhuan values(1,'haoge'); Query ID = root_20240110071417_fe1517ad-3607-41f4-bdcf-d00b98ac443e Total jobs = 1
报错1:执行到如下就不执行了,没有显示Successfully registered new MBean. [root@slave1 bin]# /usr/local/software/flume-1.9.0/bin/flume-ng agent -n a1 -c /usr/local/softwa
虚拟及没有启动任何服务器查看jps会显示jps,如果没有显示任何东西 [root@slave2 ~]# jps 9647 Jps 解决方案 # 进入/tmp查看 [root@slave1 dfs]# cd /tmp [root@slave1 tmp]# ll 总用量 48 drwxr-xr-x. 2
报错1 hive> show databases; OK Failed with exception java.io.IOException:java.lang.RuntimeException: Error in configuring object Time taken: 0.474 se
报错1 [root@localhost ~]# vim -bash: vim: 未找到命令 安装vim yum -y install vim* # 查看是否安装成功 [root@hadoop01 hadoop]# rpm -qa |grep vim vim-X11-7.4.629-8.el7_9.x
修改hadoop配置 vi /usr/local/software/hadoop-2.9.2/etc/hadoop/yarn-site.xml # 添加如下 <configuration> <property> <name>yarn.nodemanager.res