* Adapt textual content body to support primitive types.
* Regenerate source codes.
* Move `content` variable into `when`.
* Accept also `Char` as a possible text body.
* Add folder description
* Generate samples
* Refactor test to avoid relying on endpoints order
* Address cubic-dev comments
* Refactor test to avoid relying on endpoints order
* spring-http-interface: introduce `springHttpClientAdapter`, fix `paramDoc.mustache`
---
### What
- Introduce `springHttpClientAdapter` for `spring-http-interface`
- This property is used for selecting HTTP client implementation in Spring HTTP interfaces, with separate templates for each client configuration
- Added an `spring-http-interface`-specific **empty** `paramDoc.mustache`
---
### Why
- Enable selecting different HTTP client implementations when generating Spring HTTP client interfaces
- Provides additional flexibility for users who want to generate non-reactive Spring Boot applications.
---
### How
- `springHttpClientAdapter`: Allows users to choose between different HTTP client implementations used in `HttpInterfacesAbstractConfigurator`:
- `web-client` (set by default, to ensure **backward compatibility**)
- `rest-client`
- `rest-template`
- Separate templates for each `HttpInterfacesAbstractConfigurator` implementation:
- `httpInterfacesRestClientConfiguration.mustache`
- `httpInterfacesRestTemplateConfiguration.mustache`
- `httpInterfacesWebClientConfiguration.mustache`
- Log warning for configuration mismatch
- When `reactive: false` is used in combination with the reactive `web-client`, it warns users of potential configuration mismatches, and suggests switching to `rest-template` or `rest-client` for non-reactive configurations.
- Remove unnecessary paramDoc
- Added an `spring-http-interface`-specific **empty** `paramDoc.mustache` in `JavaSpring/libraries/spring-http-interface/paramDoc.mustache`
- This prevents inheriting the `@Parameter` annotations from the default Spring template located at `JavaSpring/paramDoc.mustache`.
- Otherwise, the generated code includes `@Parameter` annotations on request body parameters, which were causing compile errors due to missing imports
---
### Testing Done
- **Manual testing**: Verified that the generated code uses `WebClient`, `RestTemplate`, or `RestClient` based on the value of the `springHttpClientAdapter` property.
- **Tested different configurations**:
- **`reactive: false` & `web-client`**: Logs a warning, suggesting the use of `rest-client` or `rest-template`.
- **`springHttpClientAdapter: rest-template`**: Generates code with `RestTemplateAdapter` using the `httpInterfacesRestTemplateConfiguration.mustache`.
- **`springHttpClientAdapter: web-client` (default)**: Generates code using `WebClientAdapter` from `httpInterfacesWebClientConfiguration.mustache` and ensures backward compatibility.
- **Tested `paramDoc.mustache` change**: Verified that the empty `paramDoc.mustache` prevents the generation of `@Parameter` annotations on request body parameters and resolves the compile errors caused by missing imports.
---
### PR checklist
- [ ] Read the [contribution guidelines](https://github.com/openapitools/openapi-generator/blob/master/CONTRIBUTING.md).
- [ ] Pull Request title clearly describes the work in the pull request and Pull Request description provides details about how to validate the work. Missing information here may result in delayed response from the community.
- [ ] Run the following to [build the project](https://github.com/OpenAPITools/openapi-generator#14---build-projects) and update samples:
```
./mvnw clean package
./bin/generate-samples.sh ./bin/configs/*.yaml
./bin/utils/export_docs_generators.sh
```
(For Windows users, please run the script in [Git BASH](https://gitforwindows.org/))
Commit all changed files.
This is important, as CI jobs will verify _all_ generator outputs of your HEAD commit as it would merge with master.
These must match the expectations made by your contribution.
You may regenerate an individual generator by passing the relevant config(s) as an argument to the script, for example `./bin/generate-samples.sh bin/configs/java*`.
IMPORTANT: Do **NOT** purge/delete any folders/files (e.g. tests) when regenerating the samples as manually written tests may be removed.
- [ ] File the PR against the [correct branch](https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches): `master` (upcoming `7.x.0` minor release - breaking changes with fallbacks), `8.0.x` (breaking changes without fallbacks)
- [ ] If your PR is targeting a particular programming language, @mention the [technical committee](https://github.com/openapitools/openapi-generator/#62---openapi-generator-technical-committee) members, so they are more likely to review the pull request.
* fix imports
* Update SpringCodegen.java
* fix docs and default value
* fix docs and default value
* revert to HttpServiceProxyFactory.builder for backward compatibility
* spring-http-interface: introduce `useHttpServiceProxyFactoryInterfacesConfiguration` config
* spring-http-interface: introduce `useHttpServiceProxyFactoryInterfacesConfigurator` config
* spring-http-interface: introduce `useHttpServiceProxyFactoryInterfacesConfigurator` config
* spring-http-interface: fix generated files
* remove unnecessary imports from httpServiceProxyFactoryInterfacesConfigurator.mustache and parentOverrides from spring-http-interface-useHttpServiceProxyFactoryInterfacesConfiguration.yaml
* remove unnecessary paramDoc.mustache, update `useHttpServiceProxyFactoryInterfacesConfigurator` parameter docs of `spring-http-interface` library
* [java][spring] Spring HTTP Interface library: Validate Spring Boot version (3 or 4) and fail early if unsupported
* Set `useSpringBoot3: "true"` for all sample configs using `library: spring-http-interface`
* Regenerate samples using `library: spring-http-interface`
* Update "spring-http-interface" docs "Spring 6 HTTP interfaces (testing)" -> "Spring 6 HTTP interfaces (testing). Requires Spring Boot 3 or 4." in java-camel.md and spring.md
---------
Co-authored-by: Bragolgirith <6455473+Bragolgirith@users.noreply.github.com>
* add jackson 3 support to java native
* upgrade to jackson 3.0.4, fix whitespaces
* remove importMapping.put section
* require Java 17 for Jackson 3
* fix cubic-dev-ai issues, fix unit tests
* fix more cubic-dev-ai findings, includes a solution for missing jackson-databind-nullable
* use SerializationContext instead of SerializerProvider
* use JsonMapper instead of ObjectMapper for Jackson 3
* also fix Mapper in JSON.java for Jackson 3
* update samples
* fix mapper.copy()
* add JacksonException handling
* remove IOException where not thrown anymore
* Update jackson_annotations_version in build.gradle.mustache
* update samples after rebase
* fix FakeApi integration test
* add native-jackson3 to samples-java-client-jdk17 workflow
* fix compile errors
* update samples and docs
* update Jackson to v3.1.0, use {{jacksonPackage}}
* update docs and samples
* Update Jackson 3 compatibility note in documentation
Clarify the incompatibility of Jackson 3 with openApiNullable in the documentation.
* update the correct documentation
* Update docs/generators/java-microprofile.md once again
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
* fail when an unsupported combination of parameters is used
* update docs
* add openApiNullable=false
* fix resttemplate and webclient
* sync docs: incompatible with openApiNullable
* update resttemplate/webclient with ai magic
---------
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
* [cpp-qt-client]Fix variable redeclarations in the api-body.mustache
* [cpp-qt-client]Utilize enum for OauthMethod flow
* [cpp-qt-clien]Suffix token variables in OAuth with meaningful state names instead of numeric indexes
* use custom serializer for non string enums for multiplatform library
* add missing imports
* add tests for enum integers
---------
Co-authored-by: rlnt <relentless@rlnt.dev>
* [Python] Use pydantic_core.to_jsonable_python to convert non-standard data types
* [Python] Add test for UUID serialization
* update python samples
---------
Co-authored-by: Espen Haugsdal <espen.haugsdal@gmail.com>
* Fix fix that child constructor was invalid when having readonly field in parent
* add classType field
* fix test
* update samples
---------
Co-authored-by: bdurca <rca@bankdata.dk>
* feat(kotlin): add Jackson 3 infrastructure to AbstractKotlinCodegen
* feat(kotlin-spring): add useSpringBoot4 and useJackson3 flags
* feat(kotlin-spring): update template selection for Spring Boot 4
* feat(kotlin-spring): add SB4 templates for all libraries
* test(kotlin-spring): add tests for Spring Boot 4 and Jackson 3 support
* feat(kotlin-spring): add kotlin-springboot-4 sample with Jackson 3
* docs(kotlin-spring): document useSpringBoot4 and useJackson3 options
* fix(kotlin-spring): update Gradle templates to Kotlin 2.2 JvmTarget DSL and bump CI Gradle
- Replace deprecated kotlinOptions.jvmTarget with kotlin.compilerOptions DSL
- Upgrade Gradle wrapper to 8.14 for Kotlin 2.2 compatibility
- Add kotlin-springboot-4 sample to JDK17 CI matrix
- Regenerate sample with updated templates
* fix(kotlin-spring): register useJackson3 CLI option and use Gradle 8.14 for SB4
- Add addSwitch for useJackson3 in KotlinSpringServerCodegen so it
appears in auto-generated docs
- Update gradle-wrapper.properties.mustache templates to use Gradle 8.14
when useSpringBoot4 is enabled (required minimum for Spring Boot 4)
* fix(kotlin-client): fix Jackson 3 package imports and add ktor/spring-restclient support
Replace hardcoded com.fasterxml.jackson imports with {{jacksonPackage}} template
variable across all kotlin-client templates so generated code compiles correctly
when useJackson3=true. Also fix trailing space in OAuth Bearer header, enable
useJackson3 for jvm-ktor (Ktor 3.4.0) and jvm-spring-restclient (Spring Boot 4),
and add conditional Jackson 3 dependencies in build.gradle.
* Revert "fix(kotlin-client): fix Jackson 3 package imports and add ktor/spring-restclient support"
Block useJackson3 for kotlin-client with a clear error until client
template support is added in a follow-up PR.
* ci: retrigger CI checks
* fix(kotlin-spring): replace legacy oauth2 starter and add Jackson exclusivity tests
Replace deprecated spring-cloud-starter-oauth2:2.2.5.RELEASE with
spring-boot-starter-oauth2-client in SB4 templates, as the legacy
starter is pre-Jakarta and incompatible with Spring Boot 4.
Add negative assertions to Jackson dependency tests to ensure Jackson 2
and Jackson 3 artifacts are mutually exclusive.
* feat(kotlin-spring): default to Jackson 3 when Spring Boot 4 is enabled
Spring Boot 4 ships with Jackson 3 out of the box, so useJackson3 now
defaults to true when useSpringBoot4 is enabled and the user hasn't
explicitly set useJackson3.
* fix(kotlin-spring): declare springdoc version property regardless of useSwaggerUI
The springdoc-openapi.version Maven property was only declared when
useSwaggerUI=true, but the springdoc core dependency (used when
useSwaggerUI=false) also references it, causing an undefined property.
* fix(kotlin-spring): use modern OAuth2 client config for Spring Boot 4 spring-cloud library
Add useSpringBoot4 conditionals to clientConfiguration.mustache so SB4
uses OAuth2AuthorizedClientManager instead of legacy OAuth2FeignRequestInterceptor
and *ResourceDetails classes that don't exist in Spring Boot 4.
* fix(kotlin-spring): default Jackson 3 when Spring Boot 4 set via setter or additionalProperties
The Jackson 3 defaulting logic only checked additionalProperties map,
so calling setUseSpringBoot4(true) via the Java API skipped the default.
Now checks both the field value and the map.
* fix(kotlin-spring): add trailing newline to clientConfiguration template
* Trigger CI
* clean up conditions
* fix(kotlin-spring): remove SB4+Jackson2 test since SB4 unconditionally implies Jackson 3
Spring Boot 4 ships with Jackson 3 — there is no supported SB4+Jackson2
combination, so the test was asserting an invalid scenario.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* [cpp-qt-client]Optimize generated code
- Use const references at function parameters
- Do not perform useless initialization of QStrings
- Use qDeleteAll
* - Do not change signal arguments to const in public API as it breaks API
- Fix whitespace typo
* Regenerate tests
