What’s New in Spring Framework 6.0? Key Changes and Migration Guide

Java EE Migration

Oracle donated Java EE to the Eclipse Foundation; the name changed to Jakarta EE, and package prefixes changed from

javax

to

jakarta

, e.g.,

javax.persistence

→

jakarta.persistence

.

Core Containers

JSR‑250 and JSR‑330 packages are moving to Jakarta EE.

Persistence Layer

Jakarta EE persistence specifications are updated;

javax.persistence

and

jakarta.validation

are implemented by Hibernate ORM 5.6.x and Hibernate Validator 7.0.x.

Web Applications

Servlet Middleware Baseline

Due to Jakarta EE migration, servlet containers are upgraded. Tomcat 10, Jetty 11, or Undertow 2.2.14 with

undertow-servlet-jakarta

are the baseline.

Removal of Deprecated APIs

Commons FileUpload component removed.

Tiles layout components such as FreeMarker and JSP are no longer supported; Spring now focuses on Restful Web architecture.

Controller Scanning Changes

Spring MVC and Spring WebFlux no longer treat a class annotated only with

@RequestMapping

as a controller. After 6.0, a class must be annotated with

@Controller

or

@RestController

. The previous AOP‑based proxy mechanism is disabled; enable class‑based proxies for such controllers.

<code>/** 6.0之前
 * @author felord.cn
 */
@Component
@RequestMapping("/foo")
public class FooController {
    @GetMapping("/hello")
    public Map<String, String> hello() {
        return Collections.singletonMap("hello", "world");
    }
}
</code>

After 6.0, a controller must be annotated with @Controller or @RestController .

HttpMethod

Before 6.0,

HttpMethod

was a Java enum. It has been replaced by a final class implementing

Comparable

and

Serializable

.

<code>public enum HttpMethod {
    GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE;
    // resolve and matches methods omitted for brevity
}
</code>

<code>public final class HttpMethod implements Comparable<HttpMethod>, Serializable {
    public static final HttpMethod GET = new HttpMethod("GET");
    public static final HttpMethod HEAD = new HttpMethod("HEAD");
    public static final HttpMethod POST = new HttpMethod("POST");
    public static final HttpMethod PUT = new HttpMethod("PUT");
    // other constants and implementation omitted for brevity
}
</code>

Other Frontiers

The second milestone of Spring Framework 6.0 and the first milestone of Spring Boot 3.0 are expected in January 2022.