Spring Boot 4.0 마이그레이션 — Jakarta EE 11과 주요 변경점

// Java 21의 Virtual Threads — Boot 4.0에서 기본 지원
// 별도 설정 없이도 활용 가능
@Bean
public TomcatProtocolHandlerCustomizer<?> protocolHandler() {
    return handler -> handler.setExecutor(
        Executors.newVirtualThreadPerTaskExecutor()
    );
}

// Before — Boot 3.x (Jackson 2.x)
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.core.JsonProcessingException;

// After — Boot 4.0 (Jackson 3.0)
import tools.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.annotation.JsonProperty;  // 어노테이션은 유지
import tools.jackson.core.JsonProcessingException;

// Jackson 3.0에서 ObjectMapper 생성 방식 변경
// Before — 기본 생성자 사용
ObjectMapper mapper = new ObjectMapper();

// After — Builder 패턴 권장
ObjectMapper mapper = JsonMapper.builder()
    .enable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES)
    .build();

// 1. 기존 Criteria API 일부 제거 — JPA 표준으로 통합
// Before (제거됨!)
Session session = entityManager.unwrap(Session.class);
Criteria criteria = session.createCriteria(User.class);

// After (JPA 표준 Criteria)
CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<User> query = cb.createQuery(User.class);
query.select(query.from(User.class));

// 2. @Type 어노테이션 변경
// Before — @Type(type = "json")
// After — @JdbcTypeCode(SqlTypes.JSON)  // 타입 안전한 방식

// HTTP Interface Client — Boot 4.0 개선 사항
public interface UserClient {

    // 기존 기능 — 선언적 HTTP 클라이언트
    @GetExchange("/users/{id}")
    User getUser(@PathVariable Long id);

    // Boot 4.0 — 에러 핸들링 개선
    @GetExchange("/users/{id}")
    ResponseEntity<User> getUserWithStatus(@PathVariable Long id);

    // Boot 4.0 — 리액티브 지원 강화
    @GetExchange("/users")
    Flux<User> getAllUsers();

    // Boot 4.0 — 멀티파트 요청 지원
    @PostExchange("/users/{id}/avatar")
    void uploadAvatar(
        @PathVariable Long id,
        @RequestPart("file") Resource file
    );
}

// 클라이언트 빈 등록 — HttpServiceProxyFactory로 프록시 생성
@Bean
public UserClient userClient(RestClient.Builder builder) {
    RestClient restClient = builder.baseUrl("https://api.example.com").build();
    return HttpServiceProxyFactory
        .builderFor(RestClientAdapter.create(restClient))
        .build()
        .createClient(UserClient.class);
}

// 제거되는 대표적인 API들

// 1. WebSecurityConfigurerAdapter — 이미 3.x에서 deprecated
// Before (제거됨!)
@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .antMatchers("/api/**").authenticated();
    }
}

// After — SecurityFilterChain 빈 방식
@Configuration
public class SecurityConfig {
    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http.authorizeHttpRequests(auth -> auth
            .requestMatchers("/api/**").authenticated()
        );
        return http.build();
    }
}

// 2. spring.factories 기반 자동 설정 — 완전 제거
// Before (META-INF/spring.factories) — 제거됨!
// org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
//   com.example.MyAutoConfiguration

// After (META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports)
// com.example.MyAutoConfiguration

// Boot 4.0의 Auto-Configuration 표준 방식

@AutoConfiguration(
    after = DataSourceAutoConfiguration.class,  // 순서 지정
    before = JpaRepositoriesAutoConfiguration.class
)
@ConditionalOnClass(DataSource.class)
@ConditionalOnProperty(
    prefix = "app.feature",
    name = "enabled",
    havingValue = "true"
)
public class MyFeatureAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public MyFeatureService myFeatureService() {
        return new MyFeatureService();
    }
}

# 파일 위치 (Boot 4.0에서 유일한 방식)
src/main/resources/META-INF/spring/
  org.springframework.boot.autoconfigure.AutoConfiguration.imports

# 파일 내용 — 한 줄에 하나씩
com.example.MyFeatureAutoConfiguration
com.example.AnotherAutoConfiguration

# application.yml — Virtual Threads 활성화
spring:
  threads:
    virtual:
      enabled: true  # 이 한 줄이면 끝

// 주의 1: synchronized 대신 ReentrantLock 사용
// Before — Virtual Thread가 pin될 수 있음
public synchronized void updateCounter() {
    this.counter++;
}

// After — pinning 방지
private final ReentrantLock lock = new ReentrantLock();
public void updateCounter() {
    lock.lock();
    try { this.counter++; }
    finally { lock.unlock(); }
}

// 주의 2: ThreadLocal 대신 ScopedValue 고려
// Before — Virtual Thread마다 복사되어 메모리 낭비
private static final ThreadLocal<UserContext> context = new ThreadLocal<>();
// After — Java 21+ ScopedValue
private static final ScopedValue<UserContext> CONTEXT = ScopedValue.newInstance();

# deprecated 경고 전부 해결 — 이게 가장 중요합니다
./gradlew compileJava 2>&1 | grep -i "deprecated"
# 또는 Maven
mvn compile -Dmaven.compiler.showDeprecation=true

// build.gradle
plugins { id 'org.springframework.boot' version '4.0.0' }
java { toolchain { languageVersion = JavaLanguageVersion.of(21) } }