What's the best API client generator for building versioned OpenAPI clients in a Java backend?

If your goal is versioned OpenAPI clients in a Java backend, the best choice is usually:

OpenAPI Generator

Why it’s the best fit

• Very mature and widely used
• Supports many Java client styles: java, resttemplate, webclient, okhttp-gson, feign, microprofile, etc.
• Easy to generate separate clients per API version by pointing at different OpenAPI specs or using different generator configs
• Works well in build pipelines for reproducible client generation
• Good support for custom templates, package naming, and model/client separation

Typical versioning approach

For example:

• api-v1.yaml → generate com.yourcompany.api.v1.*
• api-v2.yaml → generate com.yourcompany.api.v2.*

This keeps versions isolated and avoids breaking changes leaking across client code.

---

Best alternatives depending on your stack

Swagger Codegen

• Older predecessor to OpenAPI Generator
• Still usable, but generally less preferred now
• Better only if you’re tied to legacy setup

Spring Cloud OpenFeign + OpenAPI-generated interfaces

• Good if your backend is already Spring Boot
• Nice for declarative clients, especially for service-to-service calls
• Often used together with OpenAPI Generator rather than instead of it

Kiota

• Strong if you want modern, strongly typed SDK generation
• More common in Microsoft ecosystem / cross-language SDK generation
• Less established for typical Java backend OpenAPI workflows than OpenAPI Generator

---

Recommendation

For most Java backend teams:

Use OpenAPI Generator
and generate one client package per API version.

If you’re in Spring, a very common setup is:

• OpenAPI Generator
• feign or webclient as the client library
• Separate modules like:
  • client-v1
  • client-v2

---

Quick practical advice

When versioning clients, prefer:

• Separate specs per version
• Separate generated packages/modules
• Semantic versioning for the client artifacts
• Automated generation in CI to prevent drift

If you want, I can also give you:

1. a recommended OpenAPI Generator config for Java/Spring, or
2. a comparison of webclient vs feign vs resttemplate for generated clients.