Skip to content

Phase 3 Complete: Spring Boot 3.2.10 Migration

Date: October 13, 2025
Status: ✅ COMPLETE

Summary

Successfully migrated the Spring Boot application from version 2.7.18 to 3.2.10, including all necessary code changes for Java 21 and jakarta.* namespace migration.

Version Changes

Component Before After Status
Gradle 8.11.1 8.11.1 ✅ (9.1 doesn't exist yet)
Java Source/Target 17 21 ✅
Spring Boot 2.7.18 3.2.10 ✅
OpenAPI 1.7.0 2.3.0 ✅
Guava 29.0-jre 33.0.0-jre ✅
Gson 2.8.6 2.10.1 ✅
Commons IO 2.7 2.15.1 ✅
Commons Lang3 3.11 3.14.0 ✅
Lombok (unversioned) 1.18.30 ✅
Mockito 1.9.5 5.8.0 ✅
REST Assured 4.3.1 5.4.0 ✅

Major Changes

1. Spring Boot 3.2.10 Upgrade ✅

  • Updated build.gradle to use Spring Boot 3.2.10
  • Migrated to Spring Boot 3.x dependency management

2. Jakarta Namespace Migration ✅

Files Updated: - MainConfig.java: javax.servlet.Filter → jakarta.servlet.Filter - ActuatorEndpointsTest.java: javax.servlet.ServletContext → jakarta.servlet.ServletContext - Removed deprecated WebMvcConfigurerAdapter, now implements WebMvcConfigurer

3. Security Configuration Modernization ✅

File: BasicSecConfiguration.java - Removed deprecated WebSecurityConfigurerAdapter - Implemented modern SecurityFilterChain bean approach - Updated to Lambda DSL style (Spring Security 6.x)

@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    http
        .csrf(csrf -> csrf.disable())
        .authorizeHttpRequests(auth -> auth.anyRequest().permitAll());
    return http.build();
}

4. OpenAPI/Swagger Migration ✅

File: OpenApiConfig.java - Updated from springdoc-openapi-ui:1.7.0 to springdoc-openapi-starter-webmvc-ui:2.3.0 - Fixed import: org.springdoc.core.GroupedOpenApi → org.springdoc.core.models.GroupedOpenApi

5. Hystrix Removal ✅

Reason: Hystrix is not compatible with Spring Boot 3.x and is deprecated

Files Modified: - Bootstrap.java: Removed @EnableCircuitBreaker annotation - CircuitBreakerHystrixConfig.java: Renamed to .deprecated (preserved for reference) - ControllerLoggingAspect.java: Replaced Hystrix circuit breaker with direct try-catch - SBUtil.java: Renamed parseHystrixException() to parseException(), removed Hystrix-specific logic - build.gradle: Commented out Hystrix dependency

TODO: Consider replacing with Resilience4j for circuit breaker functionality

6. Test Framework Updates ✅

  • Migrated from JUnit 4 to JUnit 5 (Jupiter)
  • Updated test annotations:
  • @RunWith(SpringRunner.class) → removed (not needed in JUnit 5)
  • @Before → @BeforeEach
  • @Ignore → @Disabled
  • @Test from JUnit 4 → JUnit 5
  • Updated assertions: org.junit.Assert.* → org.junit.jupiter.api.Assertions.*
  • Updated Mockito: MockitoAnnotations.initMocks() → MockitoAnnotations.openMocks()
  • Enabled JUnit Platform in build.gradle: test { useJUnitPlatform() }

7. Dependency Updates ✅

Updated Libraries: - Apache Commons Lang: org.apache.commons.lang.StringUtils → org.apache.commons.lang3.StringUtils - Removed old Jackson dependency (jackson-core-asl:1.1.0) - Updated all test dependencies to Spring Boot 3.x compatible versions

Build Configuration Changes

build.gradle Updates

  1. Spring Boot plugin: 2.7.18 → 3.2.10
  2. Java compatibility: VERSION_17 → VERSION_21
  3. OpenAPI dependency updated for Spring Boot 3.x
  4. JUnit 5 enabled with useJUnitPlatform()
  5. Test dependencies updated to latest versions
  6. Hystrix dependency commented out

Compilation Status

✅ BUILD SUCCESSFUL 

./gradlew clean compileJava
BUILD SUCCESSFUL in 1s

Known Issues & TODOs

1. Circuit Breaker Functionality

  • Status: Hystrix removed
  • Impact: No circuit breaker protection currently
  • TODO: Implement Resilience4j as replacement
  • Files Affected: ControllerLoggingAspect.java

2. Test Execution

  • Status: Not yet tested
  • Expected Issues: MongoDB connection failures (as noted in previous phases)
  • TODO: Run full test suite and fix any Spring Boot 3.x compatibility issues

3. Deprecated Hystrix Configuration

  • File: CircuitBreakerHystrixConfig.java.deprecated
  • Action: Preserved for reference, can be deleted after Resilience4j implementation

Files Modified

  1. build.gradle - Spring Boot 3.2.10, dependencies updated
  2. src/main/java/com/anr/Bootstrap.java - Removed Hystrix annotations
  3. src/main/java/com/anr/config/BasicSecConfiguration.java - Modern Security config
  4. src/main/java/com/anr/config/MainConfig.java - Jakarta servlet imports, WebMvcConfigurer
  5. src/main/java/com/anr/config/OpenApiConfig.java - Updated OpenAPI imports
  6. src/main/java/com/anr/common/SBUtil.java - Removed Hystrix exception handling
  7. src/main/java/com/anr/logging/ControllerLoggingAspect.java - Direct execution instead of Hystrix
  8. src/test/java/com/anr/controller/ActuatorEndpointsTest.java - JUnit 5 migration, Jakarta imports
  9. src/main/java/com/anr/config/CircuitBreakerHystrixConfig.java - Renamed to .deprecated

Verification Steps Completed

  • ✅ Gradle 8.11.1 confirmed (9.1 doesn't exist)
  • ✅ Java 21 source/target compatibility set
  • ✅ Spring Boot 3.2.10 dependencies resolved
  • ✅ Jakarta namespace migration complete
  • ✅ Security configuration modernized
  • ✅ OpenAPI dependencies updated
  • ✅ Hystrix removed successfully
  • ✅ Clean compilation successful

Next Steps

Immediate (Phase 4)

  1. Run full test suite: ./gradlew test
  2. Fix any test failures related to Spring Boot 3.x changes
  3. Implement Resilience4j to replace Hystrix circuit breaker
  4. Update application.properties/yml for Spring Boot 3.x if needed

Future Enhancements

  1. Consider upgrading to Spring Boot 3.3.x (latest)
  2. Implement Resilience4j with proper configuration
  3. Review and update actuator endpoints for Spring Boot 3.x
  4. Update any custom auto-configuration for Spring Boot 3.x

Rollback Plan

If issues arise: 1. Revert build.gradle to Spring Boot 2.7.18 2. Restore Hystrix dependencies 3. Revert Jakarta → javax namespace changes 4. Restore old Security configuration 5. Run: git checkout HEAD -- build.gradle src/

Performance Notes

  • Configuration cache working perfectly
  • Build time: ~1 second (with cache)
  • No performance degradation observed

Success Indicators

✅ Application compiles successfully with Spring Boot 3.2.10
✅ Java 21 source/target compatibility working
✅ Jakarta namespace migration complete
✅ Modern Security configuration in place
✅ OpenAPI 3.x compatible
✅ No Hystrix dependencies
✅ JUnit 5 test framework ready

Migration Status: Phase 3 COMPLETE ✅
Overall Progress: ~75% of total upgrade plan
Ready for: Phase 4 (Testing & Resilience4j implementation)