Swagger가 각 요소에 대한 문서를 표시하지 않습니다.

Question

Swagger를 사용하여 Apache CXF RESTful API 용 설명서를 생성하고 있습니다. 나는 xsd를 가지고 있고 DTO는 xjd에서 생성된다. xjc plugin.I을 사용하여 xsd의 각 요소에 대한 문서를 Response Class - Model 섹션의 swagger 아래에 표시하고 싶다.

생성 된 DTO가 여러 프로젝트에서 공유되므로 제어 할 수 없습니다. 일부 예제에서 제안 된 것처럼 주석을 달기 위해 DTO 객체에 주석을 달 수는 없습니다.

Answer 1

나는 비슷한 문제가있다. 나는 response.ok (STRING) .build()를 반환 자원 자신감을 시도 할 때 :

@ApiOperation(value = "Something Resource", notes = "Support for Resource", response = String.class) 

을 그리고 내 swaggered 출력을 묶였던 : 을 나는 방법은 주석했다. 나는 그것을 제거하는 것을 끝내었다. 그리고 누구나는 좋았어도. 왜 그런지 정확히 모르겠지만, 만약 내가 당신이라면 올바르게 표시 될 때까지 몇 개의 ApiOpertions & ApiResponse를 주석 처리합니다.

행운을 빕니다!