Can't ignore the type returned from method

[arinal]

Oftentimes, operation method returns wrapper classes which is not really important and should be filtered in the output swagger json/yaml. The example below uses scala akka-http and it's very common to return ToResponseMarshallable in every operation. This class is only a wrapper value to serialise the object its contain.

@GET 
@ApiResponse(responseCode = "200", /* details is omitted */ classOf[Employee])
def getEmployee(id: String): ToResponseMarshallable =
   ToResponseMarshallable(Employee("Michael Suyama"))

case class Employee(name: String)

The expected swagger output components.schemas is Employee without ToResponseMarshallable.

Executing ModelConverters.getInstance().addClassToSkip("ToResponseMarshallable") won't work since it only filters annotated type, while ToResponseMarshallable is deducted from method's type return value.

Has been analysing Reader.java, seems like the filter logic is pretty much hard coded.

[frantuma]

Thanks for reporting and working on this! implemented in #3107