# springfox/springfox

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/springfox-springfox).**

5,931 stars · 1,518 forks · Java · Apache-2.0

## Links

- GitHub: https://github.com/springfox/springfox
- Homepage: http://springfox.io
- awesome-repositories: https://awesome-repositories.com/repository/springfox-springfox.md

## Topics

`java` `oai` `openapi` `spring` `spring-boot` `spring-data-rest` `springfox` `swagger`

## Description

Springfox is a Java library that automatically generates OpenAPI-compliant documentation for Spring-based REST services. It scans Spring controller annotations and model classes at runtime to produce machine-readable API specifications, and bootstraps an interactive Swagger UI interface on application startup for browsing and testing documented endpoints.

The project provides a migration path from Swagger 2 to OpenAPI 3, replacing legacy annotations and dependencies with OpenAPI 3 equivalents through a starter dependency and configuration change. It integrates with Spring's application context and request mapping infrastructure to discover endpoints without manual configuration, and leverages Spring Boot's auto-configuration mechanism for minimal setup.

Springfox uses Java reflection to inspect model fields, types, and annotations for generating accurate API schemas, and converts the internal documentation model into standard OpenAPI JSON structures using Jackson or similar serialization libraries. The library supports both Spring MVC and WebFlux endpoints, producing documentation automatically from annotated controllers without requiring manual specification writing.

## Tags

### Development Tools & Productivity

- [OpenAPI Specification Generators](https://awesome-repositories.com/f/development-tools-productivity/openapi-configurations/documentation-generators/openapi-specification-generators.md) — Produces OpenAPI-compliant JSON documentation by inspecting Spring MVC and WebFlux endpoints at runtime.
- [Runtime Endpoint Inspectors](https://awesome-repositories.com/f/development-tools-productivity/openapi-configurations/documentation-generators/openapi-specification-generators/openapi-document-downloads/runtime-endpoint-inspectors.md) — Inspects Spring MVC and WebFlux endpoints at runtime to produce OpenAPI JSON documentation. ([source](https://cdn.jsdelivr.net/gh/springfox/springfox@master/README.md))

### Software Engineering & Architecture

- [Automated API Documentation](https://awesome-repositories.com/f/software-engineering-architecture/automated-api-documentation.md) — Generates interactive API documentation automatically from Spring controller annotations without manual specification writing.
- [Spec-from-Annotation Generators](https://awesome-repositories.com/f/software-engineering-architecture/metadata-attachments/code-annotations/spec-from-annotation-generators.md) — Scans Spring controller annotations to automatically produce an OpenAPI-compliant specification. ([source](http://springfox.io/))
- [Interactive Documentation Bootstrappers](https://awesome-repositories.com/f/software-engineering-architecture/spring-boot-integrations/interactive-documentation-bootstrappers.md) — Bootstraps an interactive Swagger UI interface on application startup for browsing and testing REST endpoints.
- [Annotation Migration Bridges](https://awesome-repositories.com/f/software-engineering-architecture/architectural-design-patterns/state-management/change-detection/breaking-change-detectors/openapi/annotation-migration-bridges.md) — Replaces legacy Swagger 2 annotations and dependencies with OpenAPI 3 equivalents through a starter dependency.
- [Annotation Migration Bridges](https://awesome-repositories.com/f/software-engineering-architecture/model-generators/swagger/annotation-migration-bridges.md) — Provides a migration path from Swagger 2 annotations to OpenAPI 3 equivalents via starter dependency. ([source](https://cdn.jsdelivr.net/gh/springfox/springfox@master/README.md))
- [Documentation Bootstrappers](https://awesome-repositories.com/f/software-engineering-architecture/spring-boot-integrations/auto-configuration-mechanisms/documentation-bootstrappers.md) — Leverages Spring Boot auto-configuration to bootstrap Swagger UI and documentation endpoints with minimal setup.
- [Endpoint Discovery Hooks](https://awesome-repositories.com/f/software-engineering-architecture/spring-boot-integrations/endpoint-discovery-hooks.md) — Hooks into Spring's application context and request mapping to discover endpoints without manual configuration.

### Web Development

- [API Documentation Tools](https://awesome-repositories.com/f/web-development/api-documentation-tools.md) — Generates machine-readable API specifications from Spring annotations without requiring manual documentation effort.
- [Interactive API Documentation UIs](https://awesome-repositories.com/f/web-development/interactive-api-documentation-uis.md) — Bootstraps an interactive Swagger UI interface for browsing and testing REST endpoints. ([source](https://cdn.jsdelivr.net/gh/springfox/springfox@master/README.md))

### Part of an Awesome List

- [API Schema Introspection](https://awesome-repositories.com/f/awesome-lists/devtools/introspection-and-reflection/api-schema-introspection.md) — Uses Java reflection to inspect model fields and annotations for generating accurate API schemas.