What

Makes generated Spring controllers actually usable for multipart/form-data request bodies. Closes #388.

Each part of the form-data schema is now exposed as its own @RequestPart parameter, files are typed as MultipartFile / List<MultipartFile>, and the endpoint declares consumes = MediaType.MULTIPART_FORM_DATA_VALUE. The unused immutable wrapper DTO is no longer generated.

Why

Previously the whole multipart body was collapsed into one immutable @Value wrapper DTO passed as a bare @Valid parameter — no @RequestPart/@RequestParam, no consumes, and unbindable by Spring at runtime (see #388).

Change

• template.ftlh: when the request is form-data, emit one @RequestPart(value = "<part>", required = <req>) per schema property; add consumes = {MediaType.MULTIPART_FORM_DATA_VALUE} to @RequestMapping; import MultipartFile when a file part is present; stop importing the wrapper type.
• OpenApiUtil.processRequestBody: skip generating a wrapper model for multipart/form-data bodies.

Before / after

// before
@RequestMapping(method = RequestMethod.GET, value = "/test", produces = {"application/json"})
default ResponseEntity<Void> testMultipart(@Valid InlineObjectTestMultipart inlineObjectTestMultipart)

// after
@RequestMapping(method = RequestMethod.GET, value = "/test",
    produces = {"application/json"}, consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
default ResponseEntity<Void> testMultipart(
    @RequestPart(value = "someFile", required = false) MultipartFile someFile,
    @RequestPart(value = "someFiles", required = false) List<MultipartFile> someFiles,
    @RequestPart(value = "someString", required = false) String someString)

Test

• Extended the testFormDataMultipartGeneration fixture with a someFiles file-array part and updated the golden TestApi.java.
• Full engine suite green: Tests run: 118, Failures: 0, Errors: 0.

Version

Bumps 6.6.1 → 6.6.2 across engine, Maven plugin and Gradle plugin.

Note

Builds on #387 (List<MultipartFile> array mapping, now merged); the someFiles file-array part in the test relies on that fix. Rebased onto main, so this PR contains only its own two commits.

🤖 Generated with Claude Code