來源:juejin.cn/post/7026372482110079012
前言
互聯(lián)網(wǎng)的連接速度慢且不穩(wěn)定,有可能由于網(wǎng)絡(luò)故障導(dǎo)致斷開連接。
在客戶端下載一個大對象時,因網(wǎng)絡(luò)斷開導(dǎo)致上傳下載失敗的概率就會變得不可忽視。
客戶端在GET
對象請求時通過設(shè)置Range
頭部來告訴接口服務(wù)需要從什么位置開始輸出對象的數(shù)據(jù)。
判斷是否支持斷點下載,根據(jù)文檔:14.35.1 Byte Rangeshttps://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html
// 直接判斷是否有 Accept-Ranges = bytes
boolean support = urlConnection.getHeaderField("Accept-Ranges").equals("bytes");
System.out.println("Partial content retrieval support = " + (support ? "Yes" : "No));
例如:
donald@donald-pro:~$ curl -i --range 0-9 http://localhost:8080/file/chunk/download
HTTP/1.1 206
Accept-Ranges: bytes
Content-Disposition: inline;filename=pom.xml
Content-Range: bytes 0-9/13485
Content-Length: 10
Date: Mon, 01 Nov 2021 09:53:25 GMT
直接判斷頭部 HEAD
,例如:
HeadObject
接口用于獲取某個文件(Object
)的元信息。使用此接口不會返回文件內(nèi)容。
HEAD /ObjectName HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
需知,對應(yīng) HTTP
狀態(tài)碼:
-
206 Partial Content
:HTTP Range
請求成功 -
416 Requested Range Not Satisfiable status
:HTTP Range
請求超出界限 -
200 OK
:不支持范圍請求
小結(jié)如下:
-
HTTP
范圍請求:需要HTTP/1.1
及之上支持,如果雙端某一段低于此版本,則認為不支持。 - 通過響應(yīng)頭中的
Accept-Ranges
來確定是否支持范圍請求。 - 通過在請求頭中添加
Range
這個請求頭,來指定請求的內(nèi)容實體的字節(jié)范圍。 - 在響應(yīng)頭中,通過
Content-Range
來標(biāo)識當(dāng)前返回的內(nèi)容實體范圍,并使用 Content-Length 來標(biāo)識當(dāng)前返回的內(nèi)容實體范圍長度。 - 在請求過程中,可以通過
If-Range
來區(qū)分資源文件是否變動,它的值來自ETag
或者Last-Modifled
。如果資源文件有改動,會重新走下載流程。
生產(chǎn)實戰(zhàn)
開發(fā)也得依靠依據(jù),設(shè)定好邊界,才能掌控全局。
有現(xiàn)成的文檔,來看阿里云文檔https://help.aliyun.com/document_detail/39571.html
-
Range: bytes=0-499
:表示第0~499字節(jié)范圍的內(nèi)容。 -
Range: bytes=500-999
:表示第500~999字節(jié)范圍的內(nèi)容。 -
Range: bytes=-500
:表示最后500字節(jié)的內(nèi)容。 -
Range: bytes=500-
:表示從第500字節(jié)開始到文件結(jié)束部分的內(nèi)容。 -
Range: bytes=0-
:表示第一個字節(jié)到最后一個字節(jié),即完整的文件內(nèi)容。
HTTP Range
是否合法對應(yīng)處理:
- 如果
HTTP Range
請求合法,響應(yīng)返回值為 206 并在響應(yīng)頭中包含Content-Range
- 如果
HTTP Range
請求不合法,或者指定范圍不在有效區(qū)間,會導(dǎo)致Range
不生效,響應(yīng)返回值為200,并傳送整個Object
內(nèi)容。
如下為
HTTP Range
請求不合法的示例及錯誤說明: 假設(shè)Object
資源大小為1000字節(jié),Range
有效區(qū)間為0~999
Range: byte=0-499
:格式錯誤,byte
應(yīng)為bytes
。Range: bytes=0-1000
:末字節(jié)1000
超出有效區(qū)間。Range: bytes=1000-2000
:指定范圍超出有效區(qū)間。Range: bytes=1000-
:首字節(jié)超出有效區(qū)間。Range: bytes=-2000
:指定范圍超出有效區(qū)間。
舉一些栗子:
# 正常范圍下載
donald@donald-pro:~$ curl -i --range 0-9 http://localhost:8080/file/chunk/download
HTTP/1.1 206
Accept-Ranges: bytes
Content-Disposition: inline;filename=Screen_Recording_20211101-162729_Settings.mp4
Content-Range: bytes 0-9
Content-Type: application/force-download;charset=UTF-8
Content-Length: 16241985
Date: Wed, 03 Nov 2021 09:50:50 GMT
服務(wù)端 - 業(yè)務(wù)開發(fā)
這里以 SpringBoot
為栗子,Spring Boot 基礎(chǔ)就不介紹了,推薦看這個實戰(zhàn)項目:
https://github.com/javastacks/spring-boot-best-practice
- 對外支持
range
下載 - 底層存儲:使用
ceph
-
Controller
如下:
@Slf4j
@RestController
public class Controller {
@Autowired
private FileService fileService;
/**
* 下載文件
*
* 對外提供
*
* @param fileId 文件Id
* @param token token
* @param accountId 帳號Id
* @param response 響應(yīng)
*/
@GetMapping("/oceanfile/download")
public void downloadOceanfile(@RequestParam String fileId,
@RequestHeader(value = "Range") String range,
HttpServletResponse response) {
this.fileService.downloadFile(fileId, response, range);
}
}
-
Service
如下:
@Slf4j
@Service
public class FileService {
@Autowired
private CephUtils cephUtils;
/**
* 直接下載文件
*
* Tips: 支持斷點下載
* @param fileId 文件Id
* @param response 返回
* @param range 范圍
*/
public void downloadFile(String fileId, HttpServletResponse response, String range) {
// 根據(jù) fileId 獲取文件信息
FileInfo fileInfo = getFileInfo(fileId);
String bucketName = fileInfo.getBucketName();
String relativePath = fileInfo.getRelativePath();
// 處理 range,范圍信息
RangeDTO rangeInfo = executeRangeInfo(range, fileInfo.getFileSize());
// rangeInfo = null,直接下載整個文件
if (Objects.isNull(rangeInfo)) {
cephUtils.downloadFile(response, bucketName, relativePath);
return;
}
// 下載部分文件
cephUtils.downloadFileWithRange(response, bucketName, relativePath, rangeInfo);
}
private RangeDTO executeRangeInfo(String range, Long fileSize) {
if (StringUtils.isEmpty(range) || !range.contains("bytes=") || !range.contains("-")) {
return null;
}
long startByte = 0;
long endByte = fileSize - 1;
range = range.substring(range.lastIndexOf("=") + 1).trim();
String[] ranges = range.split("-");
if (ranges.length <= 0 || ranges.length > 2) {
return null;
}
try {
if (ranges.length == 1) {
if (range.startsWith("-")) {
//1. 如:bytes=-1024 從開始字節(jié)到第1024個字節(jié)的數(shù)據(jù)
endByte = Long.parseLong(ranges[0]);
} else if (range.endsWith("-")) {
//2. 如:bytes=1024- 第1024個字節(jié)到最后字節(jié)的數(shù)據(jù)
startByte = Long.parseLong(ranges[0]);
}
} else {
//3. 如:bytes=1024-2048 第1024個字節(jié)到2048個字節(jié)的數(shù)據(jù)
startByte = Long.parseLong(ranges[0]);
endByte = Long.parseLong(ranges[1]);
}
} catch (NumberFormatException e) {
startByte = 0;
endByte = fileSize - 1;
}
if (startByte >= fileSize) {
log.error("range error, startByte >= fileSize. " +
"startByte: {}, fileSize: {}", startByte, fileSize);
return null;
}
return new RangeDTO(startByte, endByte);
}
}
以上內(nèi)容,大家可以收藏起來,如果以后遇到這樣的場景,分分鐘搞定!
近期熱文推薦:
1.1,000+ 道 Java面試題及答案整理(2022最新版)
2.勁爆!Java 協(xié)程要來了。。。
3.Spring Boot 2.x 教程,太全了!
4.別再寫滿屏的爆爆爆炸類了,試試裝飾器模式,這才是優(yōu)雅的方式??!
5.《Java開發(fā)手冊(嵩山版)》最新發(fā)布,速速下載!文章來源:http://www.zghlxwxcb.cn/news/detail-604483.html
覺得不錯,別忘了隨手點贊+轉(zhuǎn)發(fā)哦!文章來源地址http://www.zghlxwxcb.cn/news/detail-604483.html
到了這里,關(guān)于Spring Boot 實現(xiàn)文件斷點下載,實戰(zhàn)來了!的文章就介紹完了。如果您還想了解更多內(nèi)容,請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持TOY模板網(wǎng)!