Использование аннотаций Swagger для генерации XML информации о пространстве имен - PullRequest
1 голос
/ 24 января 2020

Мой XML запрос выглядит следующим образом:

   <ns1: MyRequest ns1="http://example.com/api/2.0">:
        <reference>A request to my endpoint</reference>
   </ns1:MyRequest>

Я считаю, что он должен быть смоделирован в Swagger / OpenAPI 3 spe c следующим образом:

MyRequest:
  type: object
  properties:
    reference:
      type: string
      xml:
        name: reference
  xml:
    prefix: ns1
    namespace: https://example.com/api/2.0

Это так? можно соответствующим образом аннотировать мой класс MyRequest. java, используя аннотации JAXB или Swagger для получения префикса и записей пространства имен в сгенерированном OpenAPI spe c?

Я попытался установить атрибут пространства имен в @XmlRootElement, как показано ниже , но пространство имен не отображается в сгенерированном OpenAPI spe c. Кроме того, я не могу использовать эту аннотацию XmlRootElement для указания префикса.

@XmlRootElement(namespace = "https://example.com/api/2.0")
public class MyRequest{
  //omitted
}
...