Ссылки Hypermedia в пользовательском интерфейсе Swagger с использованием Springfox

Question

Я создаю API RESTful, используя библиотеку spring-hateoas для реализации гипермедиа. Ответом моих конечных точек является application/hal + json (My DTO расширяет ResourceSupport).

Я использую Swagger для документирования конечных точек и использования Springfox для автоматического создания swagger-ui.

Проблема в том, что сгенерированная документация неверна.

как запрос на конечную точку POST, интерфейс устанавливает раздел _links от моего DTO как часть полезной нагрузки, так это то, что я вижу, я должен отправить в качестве параметра для моей конечной точки POST:

{ 
    "category": "string", 
    "creator": "string", 
    "description": "string", 
    "id": 0, 
    "links": [ 
    { 
     "href": "string", 
     "rel": "string", 
     "templated": true 
    } 
    ], 
    "period": 0, 
    "recipient": 0, 
    "title": "string", 
    "type": 0 
} 

Итак, мой вопрос: есть ли способ заставить springfox знать о приложении/hal + json в качестве типа содержимого параметра? Если нет, существует ли способ скрытия раздела _links от запроса?

Answer 1

Таким образом, единственный способ, которым я нашел скрывать раздел ссылки был переопределить метод Setlinks в моем DTO простирающуюся ResourceSupport и набор спрятанный истина следующим образом:

@ApiModelProperty(hidden = true) 
public void setLinks(final Link... links) { 
    super.add(links); 
}