swagger-api / swagger-core

Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API
http://swagger.io
Apache License 2.0
7.39k stars 2.18k forks source link

ApiImplicitParam and ApiImplicitParams for Swagger 2.X #2998

Open pavlos163 opened 6 years ago

pavlos163 commented 6 years ago

In Swagger 1.5, there was support for the following annotations:

Is there a similar thing for Swagger 2.X?

pjfanning commented 5 years ago

import io.swagger.v3.oas.annotations.{Operation, Parameter} - Operation parameters are the v2.0 annotation equivalent.

https://github.com/pjfanning/swagger-akka-http-sample is written for swagger 2.0 but there is a swagger-1.5 branch with similar code that uses swagger 1.5 annotations. You can compare the 2 implementations to see how the annotations differ between swagger 1.5 and 2.0.

javaHelper commented 4 years ago

Look like this doesn't works with Pageable.

pavansinguluri commented 4 years ago

it is possible to define @ApiImplicitParam and @ApiImplicitParams on class level so it is applied to all methods in that class. @Parameters, @Parameter only works on method level. Is there any work around to fix adding it to every method and define @Parameter only once per class?