~/talk

API Versioning In Spring Framework 7

Talkat Spring I/O 2025 · 2025-05-22..05-23· [api-design]
slides:none on file

Spring Framework 7 adds first-class API versioning: server-side config declares where versions live (header, query, path-segment and header strategies or a pluggable resolver), request mappings carry version annotations with support for semantic-version parsing, baseline ranges (highest compatible below a requested version), required/default versions, and custom parsers (example: date→version mapping like Microsoft’s grouping). Client libraries (WebClient, RestTemplate/Rest client, HTTP services) insert versions automatically and testing helpers include WebTestClient and MockMvcTester integrations. Deprecation header support is discussed but not yet implemented.

AI-written summary · about

  1. 0:00API versioning intro
  2. 1:08Why API versioning matters
  3. 3:16Roy Fielding’s view
  4. 8:39Path vs header versioning
  5. 16:52Industry versioning practices
  6. 17:12Spring 7 versioning support
  7. 18:58Demo: Versioned endpoints
  8. 25:21Demo: Version ranges
  9. 29:31Demo: Path-based versioning
  10. 32:22Semantic versions in Spring
  11. 33:54Custom date-based parsing
  12. 35:42Advanced versioning customizations
  13. 37:06Client-side versioning
  14. 40:36Testing versioned APIs
  15. 44:50Reference documentation and resources
  16. 45:17Q&A: Deprecation headers
  17. 46:44Q&A: Type safety
  18. 49:56Q&A: OpenAPI docs
~/search
type to search 6,249 conferences, 138,987 speakers and 185,172 talks
~/help
cmdctrl k
search every conference, speaker and series
/
focus the filter search
h
home
c
conferences
s
speakers
e
series
t
light / dark — the status bar button does the same
?
this help
esc
close this, then clear every filter — or just the search, while you are typing in it

Ignored while you are typing. Pages without a filter rail have no search to focus.