在SpringBoot中实现断点续传的实例代码

 更新时间:2024年07月05日 08:48:25   作者:一只爱撸猫的程序猿  
在 Spring Boot 或任何其他 web 开发框架中,断点续传是一种技术,允许文件的传输在中断后可以从中断点重新开始,而不是从头开始,种技术在处理大文件或在不稳定的网络环境中尤为重要,本文给大家介绍了SpringBoot中实现断点续传的实例代码,需要的朋友可以参考下

前言

在 Spring Boot 或任何其他 web 开发框架中,断点续传是一种技术,允许文件的传输在中断后可以从中断点重新开始,而不是从头开始。这种技术在处理大文件或在不稳定的网络环境中尤为重要。使用断点续传可以提高数据传输的效率和可靠性。

概念讲解

实现断点续传的关键点:

  • 客户端支持:客户端必须能够记录已下载的数据量,并在传输中断后,能够请求从上一个已接收的数据块之后继续传输。

  • 服务器支持:服务器必须能识别客户端发送的续传请求,并从文件的相应位置开始发送数据。通常这涉及到解析 HTTP 请求中的 Range 头,这个头信息指明了客户端希望从哪个字节开始接收数据。

  • 状态管理:在客户端和服务器之间必须维护一致的状态信息,以便正确处理续传逻辑。

在 Spring Boot 中实现断点续传

在 Spring Boot 应用程序中实现断点续传通常涉及以下几个步骤:

  • 处理 HTTP Range 请求:当客户端通过 HTTP Range 头请求特定范围的数据时,你的服务器需要正确解析这个请求,并返回相应范围内的数据。

  • 设置响应头:服务器需要在响应中正确设置 Content-RangeAccept-Ranges 头,告知客户端支持范围请求和响应的数据范围。

  • 读取和发送文件的指定部分:服务器需要能够从文件中读取指定范围的数据并发送给客户端。

简单实例

让我们考虑一个视频流媒体服务的场景,用户可以通过网页或应用程序查看或下载大型视频文件。由于视频文件通常较大,支持断点续传对于优化用户体验非常重要,尤其是在网络条件不稳定的情况下。

场景描述

假设你是一个流媒体服务的开发者,需要实现一个视频文件的下载功能,该功能允许用户在中断后继续下载而不是重新开始。这不仅可以节省带宽,也可以提高用户满意度。

实例代码

以下是使用 Spring Boot 编写的一个简单的视频文件下载服务,支持 HTTP 范围请求,从而实现断点续传功能:

import org.springframework.core.io.Resource;
import org.springframework.core.io.UrlResource;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;
import java.io.File;
import java.io.RandomAccessFile;
import java.nio.file.Path;
import java.nio.file.Paths;

@RestController
public class VideoDownloadController {

    private static final String VIDEO_BASE_PATH = "/path/to/your/videos";

    @GetMapping("/video/{filename}")
    public ResponseEntity<Resource> downloadVideo(@PathVariable String filename, HttpServletRequest request) {
        try {
            Path videoPath = Paths.get(VIDEO_BASE_PATH, filename);
            Resource video = new UrlResource(videoPath.toUri());

            if (video.exists()) {
                long fileLength = video.contentLength();
                String range = request.getHeader("Range");
                long start = 0, end = fileLength - 1;

                if (range != null) {
                    String[] ranges = range.replace("bytes=", "").split("-");
                    start = Long.parseLong(ranges[0]);
                    end = ranges.length > 1 ? Long.parseLong(ranges[1]) : end;
                }

                // Set the content type and attachment header.
                String contentType = request.getServletContext().getMimeType(video.getFile().getAbsolutePath());
                HttpHeaders headers = new HttpHeaders();
                headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + video.getFilename() + "\"");
                headers.add(HttpHeaders.ACCEPT_RANGES, "bytes");
                headers.add(HttpHeaders.CONTENT_RANGE, "bytes " + start + "-" + end + "/" + fileLength);
                headers.add(HttpHeaders.CONTENT_LENGTH, String.valueOf(end - start + 1));
                headers.setContentType(MediaType.parseMediaType(contentType));

                // Create resource that represents the part of the video file.
                RandomAccessFile raf = new RandomAccessFile(video.getFile(), "r");
                raf.seek(start);
                Resource partialVideo = new InputStreamResource(new CustomFileInputStream(raf, end - start + 1));

                return ResponseEntity.status(HttpStatus.PARTIAL_CONTENT)
                                     .headers(headers)
                                     .body(partialVideo);
            } else {
                return ResponseEntity.notFound().build();
            }
        } catch (Exception e) {
            return ResponseEntity.internalServerError().build();
        }
    }

    private static class CustomFileInputStream extends InputStream {
        private final RandomAccessFile raf;
        private final long end;

        public CustomFileInputStream(RandomAccessFile raf, long end) {
            this.raf = raf;
            this.end = end;
        }

        @Override
        public int read() throws IOException {
            if (raf.getFilePointer() <= end) {
                return raf.read();
            }
            return -1;
        }

        @Override
        public int read(byte[] b, int off, int len) throws IOException {
            if (raf.getFilePointer() <= end) {
                return raf.read(b, off, len);
            }
            return -1;
        }

        @Override
        public void close() throws IOException {
            raf.close();
        }
    }
}

说明

这段代码中,我们首先检查请求中是否包含 Range 头。如果包含,则解析该头以确定请求的视频文件的起始和结束字节。接着,使用 RandomAccessFile 从文件中的指定位置开始读取数据,这使得我们可以只发送客户端请求的部分文件,而不是整个文件。这种方法特别适用于大型文件和视频内容,可以显著提升用户在网络环境不稳定时的体验。

到此这篇关于在SpringBoot中实现断点续传的实例代码的文章就介绍到这了,更多相关SpringBoot断点续传内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java Stream流与使用操作指南

    Java Stream流与使用操作指南

    Stream不是数据结构,而是一种高级的数据处理工具,允许你以声明式的方式处理数据集合,类似于SQL语句操作数据库,本文给大家介绍Java Stream流与使用操作指南,感兴趣的朋友一起看看吧
    2025-08-08
  • Java实现带图形界面的聊天程序

    Java实现带图形界面的聊天程序

    这篇文章主要为大家详细介绍了Java实现带图形界面的聊天程序,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-06-06
  • Springboot启动扩展点超详细教程小结

    Springboot启动扩展点超详细教程小结

    这篇文章主要介绍了Springboot启动扩展点超详细教程小结,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-07-07
  • SpringBoot中创建bean的7种方式总结

    SpringBoot中创建bean的7种方式总结

    Spring是一款广泛应用于企业级应用程序开发的Java框架,其 IOC 和 DI 特性可以有效地管理应用程序中的对象,提高了应用程序的可维护性和可扩展性,那你知道spring有哪些方式将bean放入容器嘛,今天就给大家总结一下
    2023-07-07
  • springboot如何通过自定义注解对方法参数进行拦截验证

    springboot如何通过自定义注解对方法参数进行拦截验证

    这篇文章主要介绍了springboot如何通过自定义注解对方法参数进行拦截验证问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-04-04
  • Spring实现文件上传功能

    Spring实现文件上传功能

    本篇文章主要介绍了Spring实现文件上传功能,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-01-01
  • Java项目中实现使用traceId跟踪请求全流程日志

    Java项目中实现使用traceId跟踪请求全流程日志

    这篇文章主要介绍了Java项目中实现使用traceId跟踪请求全流程日志方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-08-08
  • mybatis foreach 循环 list(map)实例

    mybatis foreach 循环 list(map)实例

    这篇文章主要介绍了mybatis foreach 循环 list(map)实例,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-03-03
  • Map集合中获取key-value值的实现方法

    Map集合中获取key-value值的实现方法

    这篇文章主要介绍了Map集合中获取key-value值的实现方法,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-03-03
  • java中throws与try...catch的区别点

    java中throws与try...catch的区别点

    在本篇文章里小编给大家整理了一篇关于java中throws与try...catch的区别点的内容,需要的朋友们跟着学习下。
    2020-02-02

最新评论