Springfox

External

• http://springfox.github.io/springfox/
• http://springfox.github.io/springfox/docs/current/
• https://github.com/springfox/springfox

Internal

• Generating Swagger/OpenAPI Specification from Spring Code

Overview

Springfox is a suite of Java libraries for automating the generation of machine and human readable specification for JSON APIs written with Spring Framework. Springfox works by examining an application, once, at runtime to infer API semantics based on Spring configurations, class structure and various compile time java annotations.

The primary API configuration mechanism is springfox.documentation.spring.web.plugins.Docket.

Gradle Dependencies

repositories {

   jcenter()
}

dependencies {

    compileOnly "io.springfox:springfox-swagger2:2.9.2"
}

Annotations

• @EnableSwagger2

Generating Swagger/OpenAPI Specification from Spring Code with Springfox

General Considerations

How is the artifact generated? Where?