Потрясающие! Спасибо за публикацию и ответ! Это действительно фантастика.
равитсяSwagger
потому что это делает ваш API очень удобным для пользователя. я используюSwagger
аннотации, такие как
На конечных точках, параметрах запроса, параметрах запроса, теле запроса и так далее.
Я люблю держатьPOJO
классы чистые и вообще я стараюсь изо всех сил следоватьDRY
Правило однако, когда дело доходит до чванства, я заметил, что я продолжаюповторяющий я снова и снова, как показано ниже
@ApiOperation(value = "Retrieve object by id")
@ApiResponses(value = {
@ApiResponse(code = 200, message = "OK"),
@ApiResponse(code = 404, message = "Not Found"),
@ApiResponse(code = 400, message = "Bad Request"),
@ApiResponse(code = 500, message = "ISE")
})
public Response retrieveById(@ApiParam(value = "Some id") @PathParam("sid") int id) {
}
@ApiOperation(value = "Create object")
@ApiResponses(value = {
@ApiResponse(code = 201, message = "Created"),
@ApiResponse(code = 404, message = "Not Found"),
@ApiResponse(code = 400, message = "Bad Request"),
@ApiResponse(code = 500, message = "ISE")
})
public Response create(@ApiParam(value = "Request body") RequestBody body) {
}
Как избежать повторения себя сSwagger annotations
?