Support for kotlin.Deprecated

Hi, using SpringFox in a Kotlin project.

When an endpoint is marked with java.lang.Deprecated, then SpringFox shows it as deprecated in the GUI (as expected).

For Kotlin projects, it would be good to have the same support for when the annotation kotlin.Deprecated is used. This would be particularly useful with IntelliJ, as java.lang.Deprecated is itself deprecated in Kotlin, and IntelliJ flags all of its usages (with warnings to rather replace it with kotlin.Deprecated)

[dilipkrish]

This can be easily implemented as a plugin. Perhaps the long term solution is to create a Kotlin module that configures the defaults for Kotlin. Please +1 this issue if you’d like to see a fix for this or would like to create a Kotlin module

[fzyzcjy]

Here is a workaround:

/**
 * Support [kotlin.Deprecated], when the original Springfox only supports [java.lang.Deprecated]
 * modified from: https://github.com/springfox/springfox/blob/master/springfox-spring-web/src/main/java/springfox/documentation/spring/web/readers/operation/OperationDeprecatedReader.java
 * see more at https://github.com/springfox/springfox/issues/2551
 */
@Component
@Order(Ordered.HIGHEST_PRECEDENCE)
class SwaggerKotlinOperationDeprecatedReader : OperationBuilderPlugin {
    override fun apply(context: OperationContext) {
        val annotationOnMethod = context.findAnnotation(Deprecated::class.java)
        val annotationOnController = context.findControllerAnnotation(Deprecated::class.java)
        val deprecated = annotationOnMethod.isPresent || annotationOnController.isPresent
        context.operationBuilder().deprecated(if (deprecated) "true" else null)
    }

    override fun supports(delimiter: DocumentationType): Boolean = true
}