SpringMVC流式传输媒体数据

借助Spring的ResourceHttpRequestHandler可以实现媒体数据的传输，比如在线播放视频、预览图片等。

目前已知Spring Boot传输视频流的方法

• 读取整个视频文件，然后把文件流写入HttpServletResponse的OutputStream。
  （此方法可行，但是需要消耗较多的服务器资源，且客户端需要下载整个视频才能播放）
  
• 使用HTTP的Range实现分片加载，但是需要手动实现，比较麻烦。
  
• 使用Spring自带的ResourceHttpRequestHandler是最佳实践。
  

思路

ResourceHttpRequestHandler是Spring Boot用于加载静态资源的一个类，默认用于从"classpath:/static"等目录读取静态资源，以便前端访问。我们可以继承它自定义一个实现。
使用方法

在项目的config包（推荐）继承ResourceHttpRequestHandler并重写getResource方法，使其返回所需要呈现给前端的资源（org.springframework.core.io.Resource）

1. package com.example.server.config;
3. import jakarta.servlet.http.HttpServletRequest;
4. import org.springframework.core.io.Resource;
5. import org.springframework.core.io.UrlResource;
6. import org.springframework.lang.NonNull;
7. import org.springframework.stereotype.Component;
8. import org.springframework.web.servlet.resource.ResourceHttpRequestHandler;
10. import java.net.MalformedURLException;
11. import java.nio.file.Path;
12. import java.util.List;
14. @Component
15. public class CustomResourceHttpRequestHandler extends ResourceHttpRequestHandler {
16.     private Resource resource;
18.     @Override
19.     protected Resource getResource(@NonNull HttpServletRequest request) {
20.         return this.resource;
21.     }
23.     public void setResource(Path filePath) throws MalformedURLException {
24.         this.resource = new UrlResource(filePath.toUri());
25.         setLocations(List.of(this.resource));
26.     }
27. }

复制代码

控制层注入CustomResourceHttpRequestHandler，并向setResource方法传入文件路径（java.nio.file.Path），设置请求头，最后让customResourceHttpRequestHandler处理请求。

1. import org.springframework.beans.factory.annotation.Autowired;
2. import org.springframework.http.HttpHeaders;
3. import org.springframework.http.HttpStatus;
4. import org.springframework.http.ResponseEntity;
5. import org.springframework.stereotype.Controller;
6. import org.springframework.web.bind.annotation.GetMapping;
7. import org.springframework.web.bind.annotation.PathVariable;
8. import org.springframework.web.bind.annotation.RequestMapping;
10. import javax.servlet.http.HttpServletRequest;
11. import javax.servlet.http.HttpServletResponse;
12. import java.nio.file.Path;
13. import java.nio.file.Paths;
15. @Controller
16. @RequestMapping("/files")
17. public class FileController {
19.     @Autowired
20.     private CustomResourceHttpRequestHandler resourceHttpRequestHandler;
22.     @GetMapping("/{filename}")
23.     public ResponseEntity<?> getFile(@PathVariable String filename, HttpServletRequest request, HttpServletResponse response) {
24.         try {
25.             // 解析文件路径
26.             Path filePath = Paths.get("D:/StorageService").resolve(filename).normalize();
28.             // 检查文件是否存在
29.             if (!filePath.toFile().exists()) {
30.                 return new ResponseEntity<>(HttpStatus.NOT_FOUND);
31.             }
33.             // 设置资源路径
34.             resourceHttpRequestHandler.setResource(filePath);
36.             // 设置响应头，inline 会在浏览器中显示或播放文件
37.             response.setHeader(HttpHeaders.CONTENT_DISPOSITION, "inline; filename="" + filename + """);
39.             // 让 CustomResourceHttpRequestHandler 处理请求
40.             resourceHttpRequestHandler.handleRequest(request, response);
41.             return new ResponseEntity<>(HttpStatus.OK);
42.         } catch (Exception e) {
43.             return new ResponseEntity<>(HttpStatus.INTERNAL_SERVER_ERROR);
44.         }
45.     }
46. }

复制代码

注意点

控制层返回值需要ResponseEntity类型（org.springframework.http.ResponseEntity），且try-catch不能省略，否则可能会不断抛出异常（AsyncRequestNotUsableException和IOException）但不影响正常使用。
其他方案

如果有条件也可以使用MinIO，或者视频云点播VOD。他们提供了现成的解决方案，通过调用API可以获取视频等文件的直链。
参考资料

springboot+vue播放视频流（无需下载视频，可以拖动进度、倍速播放）

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！