[REQ][Kotlin][jvm-spring-webclient] Support for useSpringBoot4 and useJackson3

Abierto
  • ¿Algo no está bien?
#25,078 0 comentarios 1 reacción 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
45/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
kotlin, spring, spring-boot
Área
tooling

Línea de trabajo

Start at the Kotlin generator path for library=jvm-spring-webclient and inspect how useSpringBoot3, Jackson types, WebClient codecs, and generated build dependencies are selected. Compare the existing Spring Boot 3 handling with the requested useSpringBoot4 and useJackson3 options, then verify generated code and dependencies for both flags and their defaults.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Enhancement: Feature
Is your feature request related to a problem? Please describe.

Spring Boot 4 (Spring Framework 7) is now GA and uses Jackson 3 (tools.jackson.*) as its default JSON library, while Jackson 2 support in Spring Framework 7 is deprecated.

The Kotlin client generator with library=jvm-spring-webclient currently offers only useSpringBoot3. The generated code is tied to Spring Boot 3 and Jackson 2, so it uses:

  • com.fasterxml.jackson.databind.ObjectMapper and related com.fasterxml.jackson.databind.* types
  • Jackson2JsonEncoder / Jackson2JsonDecoder for WebClient codecs
  • com.fasterxml.jackson.module:jackson-module-kotlin and jackson-datatype-jsr310 in the generated build files

This causes problems when the generated client is used in a Spring Boot 4 application:

  • Two Jackson major versions end up on the classpath (Jackson 2 for the generated client and Jackson 3 for the application).
  • The application's auto-configured JsonMapper and its customizations can't be reused by the generated client.
  • The generated code depends on deprecated Spring APIs (Jackson2JsonEncoder / Jackson2JsonDecoder), which will likely be removed in a future Spring release.

I'm always frustrated when I have to post-process generated sources or maintain custom templates just to make the client compile cleanly and work with Spring Boot 4.

Describe the solution you'd like

Add two new options for the Kotlin client generator with library=jvm-spring-webclient:

  1. useSpringBoot4 (default false): generates code and build files targeting Spring Boot 4 / Spring Framework 7.
  2. useJackson3 (default false, possibly implied by useSpringBoot4): generates code using Jackson 3, including:
    • tools.jackson.databind.json.JsonMapper (immutable, built via builder) instead of ObjectMapper
    • JacksonJsonEncoder / JacksonJsonDecoder instead of Jackson2JsonEncoder / Jackson2JsonDecoder
    • the tools.jackson.module:jackson-module-kotlin dependency
    • no separate jackson-datatype-jsr310, since Java time support is built into Jackson 3 core
    • annotations kept as com.fasterxml.jackson.annotation.*, which Jackson 3 still uses

The generated client would then be able to accept a JsonMapper from the application context, as it can with an ObjectMapper today.

Example configuration:

generatorName: kotlin
library: jvm-spring-webclient
additionalProperties:
  useSpringBoot4: true
  useJackson3: true
  serializationLibrary: jackson

Describe alternatives you've considered

  • Keeping Jackson 2 alongside Jackson 3: this works for now, but it duplicates dependencies, splits mapper configuration, and relies on deprecated Spring APIs.
  • Custom templates (templateDir): this is possible, but every user has to maintain a fork of the templates and keep it in sync with upstream changes.
  • Switching to kotlinx_serialization: this means a large change to the existing models and doesn't fit projects standardized on Jackson.
  • Using a different library (e.g. jvm-spring-restclient): this isn't an option for reactive code based on WebClient.

Additional context

Component Version
OpenAPI Generator 7.x.x
Spring Boot 4.0.x
Kotlin 2.x

Question: Is this on the roadmap, and roughly when could support for useSpringBoot4 / useJackson3 in jvm-spring-webclient be expected?

If it helps, I'm happy to contribute a PR given some guidance on the preferred approach:

  • Should useJackson3 be a separate flag, or implied by useSpringBoot4?
  • Should the implementation be aligned with how other Spring-based generators handle Spring Boot 4 / Jackson 3?
Lenguaje dominante
Java
Estrellas
26.9k
Forks
7.8k
Merge medio
2 d 10 h
PR fusionados (30 d)
180

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de OpenAPITools/openapi-generator

Todos los issues de OpenAPITools/openapi-generator

Issues similares

Más issues de Java

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.