Play Framework Java：文件字节反序列化为DTO及fileBody类型确定

我有一个POST请求，请求体是如下JSON数据：

{
   "fileType": "excel",
   "fileBody": "dasdasomdaojawd"
}

项目中定义了如下DTO类：

public class Import {
  String fileType;
  String fileBody;
}

由于fileBody对应的是文件字节，请问应为其指定何种类型，才能让Play Framework正确将该字节流反序列化为我的DTO？

在Spring Boot中我会使用MultipartFile类型，但Play Framework并无此选项。当前从请求中获取文件的标准方式如下：

Http.MultipartFormData body = req.body().asMultipartFormData();
Http.MultipartFormData.FilePart fileItem = body.getFile("fileBody");

我能否以某种形式直接将文件反序列化为DTO？或许可先以String形式存储，再转换为Http.MultipartFormData.FilePart？

情况1：请求体为JSON格式（fileBody是Base64编码的字节字符串） #

如果你的请求确实是JSON格式，fileBody是文件字节的Base64编码字符串，可按以下方式处理：

• 修改DTO的fileBody类型为byte[]：

  public class Import {
    String fileType;
    byte[] fileBody;
  }
  

• Play Framework默认基于Jackson的JSON解析器会自动将Base64字符串反序列化为byte[]，无需额外配置。若有特殊编码需求，可通过Jackson注解自定义：

  import com.fasterxml.jackson.annotation.JsonFormat;
  
  public class Import {
    String fileType;
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "Base64")
    byte[] fileBody;
  }
  

• 之后即可在控制器方法中直接绑定DTO：

  public Result importFile() {
    Import importDto = request().body().asJson().as(Import.class);
    // 处理byte[]类型的fileBody
    return ok();
  }
  

情况2：使用multipart/form-data格式上传文件 #

如果是通过表单上传文件（即你提到的MultipartFormData方式），Play无法直接将其自动反序列化为DTO，但可手动封装逻辑：

• 调整DTO结构，用java.io.File或byte[]存储文件内容：

  public class Import {
    String fileType;
    File fileBody;
    // 或者使用 byte[] fileBody;
  }
  

• 在控制器中提取MultipartFormData内容，手动组装DTO：

  public Result importFile() {
    Http.MultipartFormData body = request().body().asMultipartFormData();
    Http.MultipartFormData.FilePart fileItem = body.getFile("fileBody");
    String fileType = body.asFormUrlEncoded().get("fileType")[0];
  
    Import importDto = new Import();
    importDto.setFileType(fileType);
    if (fileItem != null) {
      File file = fileItem.getFile();
      importDto.setFileBody(file);
      // 若需要byte[]，可读取文件内容转换：
      // byte[] fileBytes = Files.readAllBytes(file.toPath());
      // importDto.setFileBody(fileBytes);
    }
    return ok();
  }
  

• 若想实现自动绑定，可自定义BodyParser，但简单场景下手动组装更高效。

关于String转FilePart的疑问 #

Http.MultipartFormData.FilePart是Play封装上传文件的对象，包含文件元数据（文件名、类型）和临时文件，无法直接从String转换而来。如果是JSON请求，建议用情况1的byte[]方式处理；如果是表单上传，直接从MultipartFormData提取即可。

内容的提问来源于stack exchange，提问作者fckNewbee