[REQ] Form parameters with additionalProperties

[joelvdw]

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

I have a POST route in my openapi specification with a form-urlencoded body. The schema of this body is composed of some known properties that are defined, but also should accept other arbitrary properties as a Map that will be passed to the service without prior validation. To do this, I have an object type with the additionalProperties property to true.

Currently, it generates this error :
Form parameters with additionalProperties are not supported by OpenAPI Generator. Please report the issue to https://github.com/openapitools/openapi-generator if you need help.

Describe the solution you'd like

I would like the generator to generate a method signature with the known parameters as classic parameters, with an additional parameter with a Map<String, Object> or Map<String, String> type

public ResponseEntity<ResponseDTO> postRoute(Boolean param1, String param2,
            @RequestParam Map<String, Object> additionalParameters) {
    ...
}

Describe alternatives you've considered

I have not thought of a better way to do this. Currently, I need to remove the @Override modifier because I need this Map.

I can't change the content type or define all the parameters, because I don't control the client that will call this route (a webhook).

Additional context

Here is my openapi specification for the requestBody I need :

  requestBody:
    required: true
    content:
      application/x-www-form-urlencoded:
        schema:
          type: object
          properties:
            param1:
              type: boolean
              default: false
            param2:
               type: string
          additionalProperties: true

[Mattias-Sehlstedt]

A lot of generators are supported, so you will need to specify what exact generator that you are using in order for someone to understand what you are attempting to generate.

Preferably you could share you gradle/maven plugin definition, or your cli-call.

[joelvdw]

Thank you for your response. Sorry, I forgot some details.

I work on a Java 21 project, with spring-boot 3.4.4, using the maven plugin. Here is its definition :

<plugin>
	<groupId>org.openapitools</groupId>
	<artifactId>openapi-generator-maven-plugin</artifactId>
	<version>7.12.0</version>
	<executions>
		<execution>
			<goals>
				<goal>generate</goal>
			</goals>
			<configuration>
				<inputSpec>${project.basedir}/src/main/resources/api/api.yaml</inputSpec>
				<generatorName>spring</generatorName>
				<apiPackage>my.project.api</apiPackage>
				<modelPackage>my.project.api.model</modelPackage>
				<supportingFilesToGenerate>
              			    ApiUtil.java
				</supportingFilesToGenerate>
				<configOptions>
					<interfaceOnly>true</interfaceOnly>
					<dateLibrary>java8</dateLibrary>
					<openApiNullable>false</openApiNullable>
					<hideGenerationTimestamp>true</hideGenerationTimestamp>
					<useJakartaEe>true</useJakartaEe>
				</configOptions>
			</configuration>
		</execution>
	</executions>
</plugin>