Tagged articles
API versioning
32 articles · Page 1 of 1
This article analyzes microservice interface compatibility failures through real mall project incidents, defining forward/backward/bidirectional compatibility, detailing four DTO field iteration taboos with code examples, comparing three versioning strategies (URL path, request header, field adaptive), and prescribing a four-step deprecation process to eliminate technical debt.
API compatibilityAPI versioningDTO design
0 likes · 16 min read

The author demonstrates how Spring Boot 4's built-in API versioning via Spring MVC eliminates duplicated controller hierarchies by using header-based version routing, semantic version matching, and default version fallbacks, allowing per-endpoint versioning without copying unchanged endpoints.
@HttpExchangeAPI versioningController Refactoring
0 likes · 17 min read

A tiny field‑addition and rename in an order service caused a cascade failure in a three‑year‑old reconciliation job, illustrating how any incompatible change in a system handling tens of millions of QPS can trigger an avalanche, and the article explains why version management, compatible design, multi‑version coexistence, and disciplined governance are essential to keep such large‑scale services reliable.
API versioningService Governancecompatible design
0 likes · 18 min read

This article presents a comprehensive production-grade approach to API version management in Spring Boot, covering version identification strategies, custom routing via RequestCondition, DTO isolation with MapStruct, deprecation interceptors with Prometheus metrics, gateway-level traffic splitting using Spring Cloud Gateway and Nginx, and a lifecycle state machine with automated retirement rules.
API versioningMapStructOpenAPI
0 likes · 18 min read

Spring Boot 4.0 introduces a milestone upgrade that requires JDK 21, switches to jakarta.* packages, offers first‑class virtual‑thread support, a built‑in declarative HTTP client, native retry annotations, API versioning, and modular auto‑configuration, all aimed at higher cloud‑native performance.
API versioningDeclarative HTTP ClientJDK 21
0 likes · 11 min read


AI WakaApr 22, 2026 · Artificial Intelligence
The article analyzes the trade‑offs between packaging new agent functionality as a static Skill versus a dynamic MCP server, proposes a hybrid thin‑CLI approach that combines the ease of Skills with the up‑to‑date guarantees of MCP, and illustrates the design with concrete code examples.
API versioningCLI wrapperLLM agents
0 likes · 7 min read

This article shares a practical, AI‑assisted workflow for migrating a Spring Boot 3.5.11 project to Spring Boot 4, covering key framework upgrades, step‑by‑step migration planning, common pitfalls, maintainability tips, and verification of critical functionality.
AI-assistedAPI versioningJava 17
0 likes · 11 min read

The article explains how Spring Boot 4 introduces a built‑in ApiVersionStrategy that replaces custom interceptors and duplicated controllers with a single configuration property and a version attribute, dramatically cutting API versioning code from hundreds of lines to just three.
API versioningBackendJava
0 likes · 11 min read

Spring Boot 4.0, built on Spring Framework 7.0, introduces HTTP Service Clients, native API versioning, full JSpecify null‑safety, Java 25 support, upgraded dependencies, Gradle 9 compatibility, Redis static master‑replica configuration, and drops Undertow, with migration advice to move through 3.5 first.
API versioningGradle 9HTTP Service Clients
0 likes · 8 min read

Spring Boot 4 now natively supports API versioning with four strategies—Path Segment, Request Header, Query Parameter, and Media Type—offering intuitive configuration, smart routing, and seamless content negotiation, and the article provides detailed setup, code samples, and best‑practice guidance for reliable version control.
API versioningConfigurationJava
0 likes · 16 min read

This article reviews the major enhancements in Spring Boot 4 and Spring Framework 7, covering baseline requirements, performance boosts, native image support, modularization, new annotations, API versioning, declarative HTTP clients, resilient method support, multiple TaskDecorators, and null‑safety improvements, with practical code examples to help developers plan their migration.
API versioningGraalVMJava 17
0 likes · 19 min read

This comprehensive guide walks you through building robust Spring Boot backend APIs, covering environment setup, parameter validation with Validator and groups, custom validation, global exception handling, unified response structures, optional response wrapping, API version control via path and header, and essential security measures such as token authentication, timestamp checks, URL signing, replay protection, and HTTPS usage.
API validationAPI versioningGlobal Exception Handling
0 likes · 27 min read

This guide explains why API versioning is essential, compares URL‑based and Accept‑header approaches, and presents a practical modular strategy with code examples for organizing versioned controllers, models, and services in a PHP/Yii application.
API versioningURL versioningYii
0 likes · 7 min read

This article demonstrates how to implement multi‑version REST APIs in Spring Boot 3 by leveraging @RequestMapping attributes such as headers, params, and consumes, providing complete code examples, request screenshots, and a custom HttpMessageConverter for Content‑Type based versioning.
API versioningConsumesHeaders
0 likes · 10 min read

Spring Boot 4.0 (SNAPSHOT) introduces built‑in Spring Framework 7.0 support, elegant API versioning via @RequestMapping, flexible bean registration, virtual thread integration for massive concurrency, JSpecify null‑safety annotations, enhanced SPEL, Jackson 3.x migration, servlet upgrades, and native GraalVM image support, all illustrated with code samples.
API versioningJSpecifySpEL
0 likes · 7 min read

This article introduces Spring Boot 4.0.0 preview, built on Spring Framework 7, and walks through five major enhancements—including elegant API versioning, flexible bean registration, null‑safety with JSpecify, simplified HTTP proxy creation, plus several other upgrades and deprecations—complete with code samples and screenshots.
API versioningJavaNull Safety
0 likes · 8 min read

This article explains how Spring Framework 7, bundled in Spring Boot 4.0 snapshot, introduces native API version control via a new `version` attribute on `@RequestMapping`, demonstrates basic and advanced configuration examples, showcases common versioning strategies, and provides testing commands to help developers manage API evolution efficiently.
API versioningSpring BootSpring Framework 7
0 likes · 6 min read

This article explains how the @ApiVersion annotation in SpringBoot can automatically manage multiple API versions, reducing manual URL changes, eliminating duplicated code, and improving maintainability, with practical code examples and a discussion of advanced usage scenarios.
API versioningBackendJava
0 likes · 8 min read

This article explains why API versioning is essential for modern web development, outlines common versioning strategies such as URI, header, query‑parameter and content‑negotiation approaches, and demonstrates how Spring Framework 7.0 natively supports version‑specific routing on both server and client sides with practical code examples.
API versioningSpring FrameworkWebClient
0 likes · 9 min read

This article explains the importance of API version control, outlines common versioning strategies, and demonstrates how Spring Framework 7.0 introduces native support with a version attribute on @RequestMapping, custom resolvers, client usage examples, and best‑practice recommendations for managing multi‑version APIs.
API versioningJavaREST
0 likes · 10 min read

This article explains why API version control is essential for modern web services, outlines common versioning strategies such as URI, header, query‑parameter and content negotiation, and demonstrates how Spring Framework 7.0 natively supports versioned routing on both server and client sides with practical code examples.
API versioningweb development
0 likes · 11 min read

Explore the newly released Spring Boot 3 case collection and dive into a practical guide on implementing API version control in Spring 7.0.0‑M3, featuring step‑by‑step configuration, Maven setup, custom version resolver, and annotated controller examples, plus a promise of ongoing updates.
API versioningJavaMaven
0 likes · 8 min read

This article introduces a Spring Boot 3 case collection and details five practical methods—URL path, request parameter, request header, Accept header, and custom annotation—to implement API version control, complete with code examples and guidance for maintaining compatibility across multiple API versions.
API versioningJavaREST
0 likes · 8 min read

This article explains why RESTful API versioning is needed, presents four common versioning strategies (URI, request parameter, custom header, and media type), and provides complete Spring Boot code examples for each method along with factors to consider when choosing a strategy.
API versioningBackendHTTP
0 likes · 7 min read

The article shares practical experiences from evolving a mobile app store backend, comparing three API versioning models, detailing challenges of multi‑version client support, describing a two‑stage migration to compatible versioning, and offering design guidelines for scalable, maintainable service interfaces.
API versioningbackend architecturecompatibility
0 likes · 12 min read

The article recounts how Vivo’s App Store backend evolved from a monolith to a service‑cluster architecture while handling millions of daily users by adopting three API versioning strategies—no version, point‑to‑point, and compatible versioning—and progressively refactoring interfaces and services to maintain backward compatibility and improve stability, performance, and maintainability.
API versioningcompatible versioningservice design
0 likes · 13 min read

This tutorial explains why RESTful API versioning is needed, presents four versioning strategies (URI, request parameter, custom header, and media type), provides Spring Boot code examples for each, and discusses factors to consider when choosing a versioning approach.
API versioningBackendHTTP
0 likes · 10 min read


DevOpsApr 25, 2021 · Backend Development
The article examines the complexities of open banking API versioning, outlines two core principles—platform independence and service compatibility—and compares four practical versioning patterns, offering guidance on selecting flexible strategies to manage business and technical changes in API ecosystems.
API GovernanceAPI versioningBackend
0 likes · 15 min read

This article explains why API version control is essential for software iteration, outlines major and minor version strategies, compares URI, host, and header versioning methods, and demonstrates routing techniques—including Nginx configuration—to support parallel API versions.
API versioningBackendRESTful
0 likes · 6 min read

The article explains the challenges of API version control, introduces canary release as an alternative deployment strategy, and illustrates its practical implementation at ING Bank, highlighting benefits such as gradual rollout, easy rollback, and improved stability for continuously evolving APIs.
API versioningINGbackend development
0 likes · 9 min read

To refactor a versioned API plagued by nested guards, the article proposes the Responsibility Tree pattern—a hybrid of Chain of Responsibility and Strategy—that routes requests through hierarchical handlers based on parameters, yielding cleaner code, easier debugging, and scalable extension for future versions.
API versioningChain of ResponsibilityJava
0 likes · 12 min read

This article explains how to identify, design, and implement Java microservices—from domain‑driven modeling and service boundaries to RESTful API creation, documentation, proper HTTP verbs, and versioning strategies—using examples like an online retail store and the Game On! text adventure.
API versioningREST APISpring Boot
0 likes · 31 min read
