Как указать значения параметра пути в спецификации swagger? [Дубликат]

Поскольку этот поток немного разветвился в общем обсуждении текущих реализаций с плавающей запятой, я бы добавил, что есть проекты по исправлению их проблем.

Взгляните на https: // posithub.org/, который демонстрирует тип номера, называемый posit (и его предшественник unum), который обещает предложить лучшую точность с меньшим количеством бит. Если мое понимание верное, оно также фиксирует проблемы в вопросе. Весьма интересный проект, человек, стоящий за ним, является математиком Dr. Джон Густафсон . Все это с открытым исходным кодом, с множеством реализаций в C / C ++, Python, Julia и C # ( https://hastlayer.com/arithmetics ).

7
задан Esko Piirainen 27 April 2016 в 11:35
поделиться

2 ответа

Первый случай правильный, и в наши дни swagger-ui генерирует выбор значений перечислимого числа с множественным выбором.

4
ответ дан Esko Piirainen 25 August 2018 в 07:14
поделиться

Это будет зависеть от того, что вы хотите перечислить:

Каждое значение перечисления ДОЛЖНО быть описанного типа объекта

  • в первом случае a String
  • во втором массиве Array of String

Первые синтаксические средства Это возможные значения String в этом массиве

AnArray:
  type: array
  items:
    type: string
    enum:
      - MALE
      - FEMALE
      - WORKER

Этот массив может содержать несколько строк, но каждая строка должна иметь значение MALE, FEMALE или WORKER.

Rendering in Swagger UI: You have to put mouse pointer on the value to see enum [/g2]

Второй означает . Это возможные значения этого массива

AnotherArray:
  type: array
  items:
    type: string
  enum:
    - 
      - FEMALE
      - WORKER
    -
      - MALE
      - WORKER

Каждое значение перечисления является массивом. В этом примере этот массив может иметь только возможное значение ["FEMALE", "WORKER"] и ["MALE", "WORKER"].

К сожалению, даже если этот синтаксис действителен, показаны в интерфейсе Swagger.

3
ответ дан Arnaud Lauret 25 August 2018 в 07:14
поделиться
Другие вопросы по тегам:

Похожие вопросы: