Kotlin Spring项目中OpenAPI生成MultipartFile列表参数的方法

你可以通过给openapi-generator的kotlin-spring模块添加useMultipartFile=true配置项，让生成的Controller参数从List<org.springframework.core.io.Resource>改为List<org.springframework.web.multipart.MultipartFile>，具体配置方式根据你的构建工具不同分为以下几种：

1. Maven插件配置 #

在openapi-generator-maven-plugin的配置中添加该属性：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>请替换为最新稳定版本</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
                <generatorName>kotlin-spring</generatorName>
                <additionalProperties>
                    <additionalProperty>useMultipartFile=true</additionalProperty>
                    <!-- 可添加其他自定义配置 -->
                </additionalProperties>
            </configuration>
        </execution>
    </executions>
</plugin>

2. Gradle Kotlin DSL配置 #

在openapiGenerate任务中设置该属性：

plugins {
    id("org.openapi.generator") version "请替换为最新稳定版本"
}

openapiGenerate {
    generatorName.set("kotlin-spring")
    inputSpec.set(file("src/main/resources/openapi.yaml").absolutePath)
    additionalProperties.set(mapOf(
        "useMultipartFile" to "true",
        // 可添加其他自定义配置
    ))
}

3. 命令行调用配置 #

使用openapi-generator-cli直接生成时，添加对应的参数：

openapi-generator-cli generate -i openapi.yaml -g kotlin-spring -o generated-code --additional-properties useMultipartFile=true

完成配置后重新执行代码生成，Controller中attachedFiles参数的类型就会自动切换为List<org.springframework.web.multipart.MultipartFile>。

内容的提问来源于stack exchange，提问作者antho.dev