spring-boot - Spring Boot 多部分/相关 MIME 类型支持

Question

我需要使用一个内容类型为 multipart/related 的请求。请求将包含图像、json 负载和二进制内容。我试图找到一些关于如何在 Spring 引导应用程序中处理此类请求的示例，我找到了一些关于如何处理多部分/表单数据请求但与多部分/相关 mime 类型无关的引用。

请求是这样的:

POST /upload
Content-Type: multipart/related; boundary="123asdf234"
--123asdf234
Content-Type: application/json; charset=UTF-8
Content-Disposition: form-data
{
    "json": "payload"

}
—-123asdf234
Content-Type: application/zip
Content-Disposition: file-data; filename="some.zip"; size=123456;
<binary-attachment-content>
—-123asdf234
Content-Type: image/png
Content-Disposition: file-data; filename="image1.png"; size=123456;
<binary-attachment-content>
—-123asdf234-—

有人能告诉我如何在 Spring boot 应用程序中处理这个请求吗？我正在使用 JaxRS。

Answer 1

为了解决这个问题，我首先引用了 http://cxf.apache.org/docs/jax-rs-multiparts.html正确理解与 JAX-RS 相关的 multipart/related。接下来我在 JAX-RS 上引用了 Spring 文档并选择使用Jersey依赖来解决。然后引用Jersey documentation我构建了以下测试项目:https://github.com/ShawnTuatara/stackoverflow-38838926 .主要例子是:

package ca.tuatara.stackoverflow;

import javax.ws.rs.Consumes;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

import org.glassfish.jersey.media.multipart.BodyPart;
import org.glassfish.jersey.media.multipart.FormDataParam;
import org.glassfish.jersey.media.multipart.MultiPart;
import org.glassfish.jersey.media.multipart.MultiPartFeature;
import org.glassfish.jersey.server.ResourceConfig;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.stereotype.Component;

@SpringBootApplication
public class Stackoverflow38838926Application {
    public static void main(String[] args) {
        SpringApplication.run(Stackoverflow38838926Application.class, args);
    }

    @Component
    public class JerseyConfig extends ResourceConfig {
        public JerseyConfig() {
            register(MultiPartFeature.class);
            register(MultipartHandler.class);
            register(MultipartPartsHandler.class);
        }
    }

    @Component
    @Path("/upload")
    @Consumes("multipart/*")
    @Produces("text/text")
    public class MultipartHandler {
        @POST
        public String upload(MultiPart request) {
            StringBuffer response = new StringBuffer();
            for (BodyPart part : request.getBodyParts()) {
                if (MediaType.APPLICATION_JSON_TYPE.isCompatible(part.getMediaType())) {
                    response.append(part.getEntityAs(JsonModel.class));
                } else if (MediaType.APPLICATION_XML_TYPE.isCompatible(part.getMediaType())) {
                    response.append(part.getEntityAs(XmlModel.class));
                }
                response.append(System.lineSeparator());
            }
            return response.toString();
        }
    }

    @Component
    @Path("/uploadParts")
    @Consumes("multipart/*")
    @Produces("text/text")
    public class MultipartPartsHandler {
        @POST
        public String upload(@FormDataParam("json") JsonModel json, @FormDataParam("xml") XmlModel xml) {
            return json + System.lineSeparator() + xml;
        }
    }
}

测试展示了如何发送多部分请求。我保留了一些 DEBUG 日志记录，这样您就可以在测试运行时准确地看到网络上发生了什么。

您的原始 POST 负载存在一些问题，无法正确解析。内容必须在标题和内容之间有一个换行符。如果您没有为 Content-Disposition 提供“名称”属性，那么您只能使用第一个示例(“/upload”)。如果您确实命名了表单数据，那么您可以使用第二个示例(“/uploadParts”)。我没有用图像或文件上传来做这个例子，但如果你阅读 Jersey 多部分页面，你会发现在请求方法上添加参数输入很简单。