A Controller method that does not return a response body still documents a schema, media type, etc

[leoherbie]

@GetMapping("/health")
@ResponseStatus(HttpStatus.OK)
fun check() { }

This function only returns a status code and nothing more. I would expect the generated documentation to reflect this. Thank you.

[leoherbie]

Note that @ResponseStatus(HttpStatus.NO_CONTENT) doesn't make a difference either

Hi,

The library supports java and not kotlin. You will have to replace in the example fun by void to test it.
It will be possible to return only the status code, starting from v1.1.22.

[leoherbie]

We are developing a 100% kotlin project and your library is working great. Figured you might want feedback related to alternative languages. I will attempt to mess with the return type to see what happens.

[leoherbie]

FYI. I did try:
@GetMapping("/health")
@ResponseStatus(HttpStatus.OK)
fun check() : ResponseEntity<Void> = ResponseEntity.of(Optional.empty())

Which generated the same result

[leoherbie]

Also tried adding @ApiResponse(content = [Content(schema = Schema(hidden = true))])

[onacit]

It seems work with following code.

    @ApiResponse(content = {@Content(schema = @Schema(implementation = void.class, hidden = true))})