Spring Framework 7

A versão 7.0 do Spring Framework marca um avanço significativo na plataforma Java, trazendo mudanças estruturais de plataforma, reestruturação de APIs, novos recursos e várias depreciações que exigem atenção. Esta versão aponta claramente para a modernização do ecossistema Spring e exige que desenvolvedores revisem ambientes, dependências e código. Neste artigo, apresento os pontos mais relevantes da página oficial de Release Notes do Spring Framework 7.0.

Atualização de Plataforma (Baseline Upgrades)

A nova versão estabelece requisitos mínimos em recursos importantes:

• JDK 17 como requisito mínimo e recomendação para JDK 25 (LTS).
• Adoção de Jakarta EE 11 como base.
• Servlet 6.1 (Tomcat 11.0, Jetty 12.1), JPA 3.2 (Hibernate ORM 7.1/7.2), Bean Validation 3.1, GraalVM 25, Netty 4.2 e Kotlin 2.2.

Por que importa:
Projetos que utilizam tecnologias antigas precisarão de atualização de ambiente para seguir compatíveis com o Spring 7.

APIs Removidas (Removed APIs)

Diversas APIs foram removidas ou substituídas. Esse ponto merece atenção caso seus projetos façam uso delas e você queira realizar a atualização para o Spring Framework 7:

• Remoção do módulo spring-jcl em favor do Apache Commons Logging 1.3.
• Remoção completa do suporte às antigas anotações javax.annotation e javax.inject.
• Fim do suporte ao contêiner Undertow e remoção de opções antigas de mapeamento de paths.
• Remoções adicionais: ListenableFuture, WebJars antigos, suporte exclusivo ao OkHttp3, temas (Theme), mudanças em JdbcOperations.queryForObject, entre outras.

Por que importa:
Projetos precisarão substituir APIs removidas para evitar falhas de compilação ou execução.

Incompatibilidades (Breaking Changes)

O Spring Framework 7.0 introduz algumas mudanças incompatíveis com versões anteriores, exigindo atenção durante a migração. Embora não sejam numerosas, elas afetam pontos fundamentais da infraestrutura.

Principais destaques:

• Atualizações de requisitos mínimos: a nova versão depende de versões mais recentes do Java, Jakarta EE e servidores de aplicação, o que significa que ambientes antigos podem não ser mais compatíveis.
• Ajustes em APIs e comportamentos antigos: métodos e componentes considerados ultrapassados foram removidos ou refatorados para manter o framework mais coerente, moderno e alinhado aos padrões atuais.
• Mudanças estruturais internas: algumas decisões de projeto foram revisadas para melhorar desempenho, segurança e manutenção, o que pode resultar em diferenças no funcionamento em relação ao Spring 6.

Algumas dessas incompatibilidades podem ser encontradas em:

• A API HttpHeaders foi revisada na versão 7.0. Esta classe não estende mais o contrato MultiValueMap.
• A extensão SpringExtension, que integra o framework Spring TestContext ao JUnit Jupiter, agora utiliza um ExtensionContext com escopo de método de teste.Embora essa alteração permita uma semântica de injeção de dependência consistente em hierarquias de classes de teste anotadas com @Nested, ela pode representar uma alteração incompatível com implementações personalizadas de TestExecutionListener.

Essas alterações pavimentam o caminho para uma plataforma mais enxuta, eficiente e preparada para as tecnologias emergentes, mas exigem que os desenvolvedores revisem suas aplicações antes de atualizar.

Recursos Depreciados (Deprecations)

Alguns componentes serão removidos em breve:

• RestTemplate está oficialmente depreciado e será removido na versão 7.1;
• O namespace XML <mvc:*> está obsoleto; a configuração Java é o padrão recomendado;
• Jackson 2.x foi depreciado para a entrada em uso do Jackson 3.x;
• O uso de PathMatcher no Spring MVC agora está depreciado.

Revise documentação oficial e veja a lista completa de depreciações.

Por que importa:
Migrar desde já evita problemas quando a remoção definitiva ocorrer.

Segurança de Nulos (Null Safety)

O Spring Framework passou de JSR 305 para JSpecify em suas anotações de nulidade.

Por que importa:
O novo modelo permite uma análise mais precisa de nulabilidade, especialmente útil em projetos com Kotlin ou que adotam padrões mais estritos de null safety.

Suporte a Servlet 6.1 e WebSocket 2.2

A versão exige contêineres compatíveis com Jakarta Servlet 6.1.

Por que importa:
Servidores antigos, como Tomcat 9 ou 10, precisam ser atualizados para que a aplicação continue funcional. Aplicações geradas com o Spring Framework 7 não será compatível com servidores ou containers baseados em versões anteriores ao Jakarta Servlet 6.1.

JPA 3.2 e Hibernate ORM 7.1/7.2

O Spring Framework 7.0 traz aprimoramentos importantes para quem trabalha com JPA e Hibernate, alinhando o ecossistema às versões mais recentes do Hibernate ORM e reforçando padrões modernos da especificação Jakarta Persistence.

Principais pontos de destaque:

• Compatibilidade com novas versões do Hibernate
  O framework agora é otimizado para as versões atuais do Hibernate 6.x, que introduzem mudanças profundas em áreas como SQL AST, geração de consultas, metamodelo e tratamento de tipos. Isso garante maior desempenho, consistência e uma base mais robusta para aplicações que usam JPA.
• Aprimoramentos de integração no Spring
  A integração entre Spring e Hibernate foi ajustada para lidar melhor com o novo mecanismo de transformação de queries, melhorias nos lazy loadings e comportamentos revisados no gerenciamento de sessões. Essas atualizações tornam o ciclo de persistência mais previsível e menos propenso a problemas sutis.
• Adesão total à migração para Jakarta
  Após a mudança do namespace javax.persistence para jakarta.persistence, o Spring 7 consolida essa transição, eliminando elementos legados e alinhando-se definitivamente ao modelo Jakarta EE 10+. Isso dá continuidade ao processo iniciado no Spring 6.
• Melhor suporte a recursos avançados
  O framework facilita o uso de funcionalidades modernas como:
  • mapeamento mais refinado de tipos complexos,
  • melhorias na execução de consultas multivaloradas,
  • suporte mais estável para métodos de projection,
  • preparação para futura integração com novos padrões de especificação.

Por que importa:
Essas mudanças tornam o desenvolvimento com JPA e Hibernate mais consistente e preparado para aplicações de grande porte que exigem estabilidade, desempenho e alinhamento com as tecnologias mais atuais. O upgrade afeta integrações com JPA/Hibernate, exigindo atenção a detalhes de configuração e anotações Jakarta.

Jackson 3.x, Kotlinx.Serialization e Gson (WebFlux)

O Spring Framework 7.0 reforça sua posição como plataforma moderna para desenvolvimento empresarial ao aprimorar sua integração com tecnologias contemporâneas e padrões emergentes. Entre os destaques estão suporte a runtimes modernos, ajustes na comunicação reativa e melhorias estruturais que impactam positivamente a experiência dos desenvolvedores.

Entre os destaques temos:

• Melhorias no uso de Kotlinx.Serialization.
• Suporte a Gson no WebFlux via GsonEncoder e GsonDecoder.

Por que importa:
Serialização é um ponto central em APIs modernas; essas mudanças afetam diretamente aplicações REST e reativas.

GraalVM Native e AOT

O Spring Framework 7 adota o novo formato unificado de reachability metadata do GraalVM, reorganizando hints e padrões de configuração.

Por que importa:
Quem produz native images com Spring ganha mais consistência e clareza, mas precisa adaptar configurações antigas.

Aprimoramentos no JMS Destination Handling

O Spring Framework 7.0 introduz melhorias na forma como destinos JMS são resolvidos e manipulados. A intenção é tornar o envio e consumo de mensagens mais previsível e com menos ambiguidade, especialmente em aplicações que utilizam filas e tópicos definidos dinamicamente ou configurados em múltiplos ambientes.

Além disso, o novo comportamento de resolução de destinos reduz problemas comuns de configuração, como nomes divergentes entre ambientes ou conflitos entre destinos físicos e lógicos. Essas melhorias tornam a integração com provedores JMS mais robusta, facilitam o monitoramento e simplificam o uso de anotações como @JmsListener.

Alguns novos destaques

Outros destaques apresentados pelo Spring Framework 7 ficam por conta de:

• Melhorias em SpEL com Optional e operador Elvis.
• Avanços no mapeamento de URL via PathPattern.
• Suporte oficial ao versionamento de APIs em MVC e WebFlux.
• Nova configuração para clientes HTTP via @ImportHttpServices.
• Novo RestTestClient para testes REST não reativos.
• Correções na propagação de contexto para coroutines Kotlin.

Por que importa:
Essas melhorias ampliam o poder da plataforma e refinam áreas essenciais para aplicações modernas.

Conclusão

O Spring Framework 7.0 representa uma modernização ampla da plataforma: novos requisitos, remoções importantes, melhorias de segurança e desempenho e recursos que alinham o Spring às tecnologias mais recentes do ecossistema Java e Kotlin. A migração requer atenção, mas traz benefícios significativos para projetos novos e existentes.

Referência

Spring Framework 7.0 Release Notes