docker部署springboot項(xiàng)目文件上傳路徑過(guò)程
一、問(wèn)題
解決通過(guò)docker部署springboot項(xiàng)目，文件上傳的路徑該怎么設(shè)置？
用docker部署后，在服務(wù)器上面怎么看到自己上傳的文件，文件需不需要掛載等問(wèn)題，下面直接使用springboot+docker簡(jiǎn)單搭建一個(gè)文件服務(wù)器
二、環(huán)境
以下是本人此次搭建的環(huán)境
- 部署方式：docker
- 服務(wù)器：linux服務(wù)器
- 服務(wù)器操作系統(tǒng)：CentOS 8.2
- jdk:1.8
三、創(chuàng)建springboot項(xiàng)目
創(chuàng)建springboot項(xiàng)目upload-demo，先在本地進(jìn)行測(cè)試，確保本地的項(xiàng)目可以進(jìn)行文件上傳和下載
pom
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.7.0</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.zqcn</groupId>
<artifactId>upload_demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>upload_demo</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
application.yml
upload: # 部署服務(wù)器時(shí)的服務(wù)上文件存放地址 # path: /upload-demo/upload # 本地的文件存放地址 path: D:\zqcn\data\upload-demo\upload server: port: 8082
為了方便直觀的看到效果，這里就簡(jiǎn)單寫(xiě)了兩個(gè)html頁(yè)面進(jìn)行測(cè)試
upload-page.html（文件上傳頁(yè)面）
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>File Upload</title>
</head>
<body>
<form enctype="multipart/form-data" method="post" action="/file/receive">
<div>
File Choose:
<input type="file" name="file"></div>
<div>
<input type="submit" value="Submit"/>
</div>
</form>
</body>
</html>
download-page.html（文件下載頁(yè)面）
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>File Upload</title>
</head>
<body>
<form action="/file/fetch" method="post">
下載文件名：<input type="text" name="fileName" maxlength="500" style="width:400px;">
<input type="submit" value="提交">
</form>
</body>
</html>
最后編寫(xiě)對(duì)應(yīng)的controller即可
FileController
package com.zqcn.upload_demo.controller;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;
/**
* @ClassName : FileController
* @Description :
* @Author : CJH
* @Date: 2022-06-15 09:37
*/
@Controller
@RequestMapping("/file")
public class FileController {
@Value("${upload.path}")
private String uploadPath;
/**
* 文件上傳頁(yè)面
* @param request
* @return
*/
@RequestMapping("/upload")
public String uploadPage(HttpServletRequest request){
return "upload-page";
}
/**
* 文件下載頁(yè)面
* @param request
* @return
*/
@RequestMapping("/download")
public String downloadPage(HttpServletRequest request){
return "download-page";
}
/**
* 文件上傳接口
* @param file
* @param request
* @return
* @throws Exception
*/
@ResponseBody
@RequestMapping(value="/receive", method = RequestMethod.POST)
public Map receiveFile(@RequestParam("file") MultipartFile file, HttpServletRequest request) throws Exception{
if(file.isEmpty()){
return new HashMap<String,Object>(){{
put("code",500);
put("msg","沒(méi)有選中任何文件");
put("status",false);
put("data",null);
}};
}
File uploadFileSaveDir = new File(uploadPath);
System.out.println("上傳文件的存放目錄："+uploadFileSaveDir.getAbsolutePath());
if(!uploadFileSaveDir.exists()){
// 遞歸生成文件夾
uploadFileSaveDir.mkdirs();
}
// 拿到文件名
String filename = file.getOriginalFilename();
// 構(gòu)建真實(shí)的文件路徑
File uploadFile = new File(uploadFileSaveDir.getAbsolutePath() + File.separator + filename);
System.out.println("文件上傳到：" + uploadFile.getAbsolutePath());
//文件寫(xiě)到服務(wù)器，
file.transferTo(uploadFile);
return new HashMap<String,Object>(){{
put("code",200);
put("msg","文件上傳成功");
put("status",true);
put("data",null);
}};
}
/**
* 文件下載接口
* @param fileName
* @param response
* @return
* @throws Exception
*/
@ResponseBody
@RequestMapping(value = "/fetch", method = RequestMethod.POST)
public Map fileDownload(@RequestParam() String fileName, HttpServletResponse response)throws Exception{
File downloadFile = new File(uploadPath + File.separator + fileName);
System.out.println("下載文件的完整路徑："+downloadFile.getAbsolutePath());
if(!downloadFile.exists()){
System.out.println("要下載的文件不存在："+downloadFile.getAbsolutePath());
return new HashMap<String,Object>(){{
put("code",500);
put("msg","文件不存在，下載失敗");
put("status",false);
put("data",null);
}};
}else {
//第二讀取文件
InputStream in = new FileInputStream(downloadFile);
//設(shè)置響應(yīng)頭，對(duì)文件進(jìn)行url編碼
fileName = URLEncoder.encode(fileName, "UTF-8");
response.setHeader("Content-Disposition", "attachment;filename="+fileName);
response.setContentLength(in.available());
//第三步：讀文件寫(xiě)入http響應(yīng)
OutputStream out = response.getOutputStream();
byte[] b = new byte[1024];
int len = 0;
while((len = in.read(b))!=-1){
out.write(b, 0, len);
}
out.flush();
out.close();
in.close();
return new HashMap<String,Object>(){{
put("code",200);
put("msg","文件下載成功");
put("status",true);
put("data",null);
}};
}
}
}
啟動(dòng)項(xiàng)目，先用postman測(cè)試一下上傳接口
再測(cè)試一下下載接口
接口測(cè)試沒(méi)問(wèn)題，下面可以測(cè)一下那兩個(gè)頁(yè)面
都是正常的，本地項(xiàng)目創(chuàng)建成功
四、docker部署項(xiàng)目
（1）構(gòu)建鏡像
關(guān)于linux服務(wù)器和docker的基礎(chǔ)知識(shí)這里就不贅述了，自行百度即可，下面直接進(jìn)入部署流程，先把項(xiàng)目的文件上傳路徑改成部署環(huán)境的上傳地址
再本地進(jìn)行jar打包
創(chuàng)建Dockerfile文件
FROM java VOLUME /tmp ADD upload_demo.jar upload_demo.jar EXPOSE 8082 ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/upload_demo.jar"]
- FROM java：表示安裝的java鏡像
- VOLUME /tmp：創(chuàng)建/tmp目錄并持久化到Docker數(shù)據(jù)文件夾
- ADD upload_demo.jar upload_demo.jar：將生成的jar包（第一個(gè)）復(fù)制并重命名到upload_demo.jar（第二個(gè)）
- EXPOSE 8082：對(duì)外暴露的接口，也是訪問(wèn)的接口，接口的端口號(hào)需要根據(jù)springboot項(xiàng)目配置的端口號(hào)來(lái)設(shè)置
- ENTRYPOINT：固定寫(xiě)法，用來(lái)運(yùn)行jar包，相當(dāng)于java -jar xxx.jar一樣
最后將jar和Dockerfile通過(guò)xftp一起上傳到服務(wù)器上面，最好找個(gè)文件夾統(tǒng)一放在一起，例如
再通過(guò)xshell進(jìn)入jar和Dockerfile所在的目錄，并且輸入構(gòu)建鏡像的命令
docker build -t upload-demo .
構(gòu)建成功后，先隨便創(chuàng)建
（2）啟動(dòng)容器
為了更清楚的理解docker部署的項(xiàng)目文件上傳路徑，這里分兩種方式啟動(dòng)容器，一種不掛載文件，一種掛載文件，兩種方式，簡(jiǎn)單分析一下文件的上傳路徑
（1）不掛載文件啟動(dòng)容器
命令如下:
sudo docker run -d --name upload-demo01 -p 8082:8082 upload-demo
容器啟動(dòng)成功后，用postman進(jìn)行文件上傳測(cè)試，上傳了1.jpeg文件
上傳也是成功了，那么怎么看到上傳的圖片呢，還有就springboot項(xiàng)目配置的文件上傳地址體現(xiàn)在哪里，要想知道這些答案，就需要進(jìn)入容器內(nèi)部看了，命令
docker exec -it upload-demo01 /bin/bash
進(jìn)入里面后查看當(dāng)前目錄下的文件，就會(huì)發(fā)現(xiàn)upload-demo，這個(gè)就springboot配置的上傳地址
再進(jìn)入upload-demo文件里面看看
就會(huì)發(fā)現(xiàn)里面有一個(gè)文件夾upload，再深入里面看看，就會(huì)發(fā)現(xiàn)里面有一張圖片1.jpeg，就是我們上傳的圖片了
總結(jié)一下容器里面的路徑地址就是：/upload-demo/upload，這個(gè)路徑就是springboot配置的文件上傳地址
至此為止，整體容器啟動(dòng)后，文件上傳和下載都是正常的，唯一不足的就是，如果要看這個(gè)圖片上傳在哪里，就需要進(jìn)入容器里面看，下面推薦第二種方式，啟動(dòng)容器后，并且把容器里面的圖片掛載出來(lái)
（2）掛載文件啟動(dòng)容器
先在服務(wù)器上創(chuàng)建一個(gè)目錄，用于存放掛載出來(lái)的圖片，本人的路徑是/home/cainiao/upload-demo/upload
下面執(zhí)行以下命令啟動(dòng)容器：
sudo docker run -d --name upload-demo02 -p 8083:8082 -v /home/cainiao/upload-demo/upload:/upload-demo/upload upload-demo
注意：
- /home/cainiao/upload-demo/upload：是你要掛載到容器外面的服務(wù)器圖片路徑
- /upload-demo/upload：是容器里面圖片地址
容器啟動(dòng)成功，現(xiàn)在用postman進(jìn)行接口上傳測(cè)試，文件2.jpeg上傳成功
現(xiàn)在去服務(wù)器上面的/home/cainiao/upload-demo/upload里面，刷新一下，看一下發(fā)現(xiàn)圖片已經(jīng)掛載出來(lái)了
現(xiàn)在試一下圖片下載
可以看到圖片，經(jīng)過(guò)測(cè)試，圖片可以完成下載
三、補(bǔ)充
正常部署的話，建議采用第二種采用掛載文件的形式進(jìn)行啟動(dòng)
四、總結(jié)
以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。
相關(guān)文章
深入了解docker(docker鏡像、容器、倉(cāng)庫(kù)的基本概念)
本文重點(diǎn)給大家介紹docker鏡像、容器、倉(cāng)庫(kù)的基本概念，感興趣的朋友跟著小編一起學(xué)習(xí)吧2016-10-10
使用Docker Compose創(chuàng)建LAMP環(huán)境的詳細(xì)步驟
現(xiàn)如今,通過(guò) Docker 容器化部署環(huán)境已經(jīng)逐漸成為主流,特別是在部署像 LAMP 這樣的復(fù)雜環(huán)境時(shí),本教程旨在帶您完成使用 Docker-Compose 建立 LAMP 環(huán)境的整個(gè)過(guò)程,同時(shí)還包括定制 PHP 環(huán)境的步驟,需要的朋友可以參考下2024-12-12
Docker啟動(dòng)MySQL報(bào)錯(cuò)：/etc/mysql/conf.d目錄缺失的解決方案
這篇文章主要介紹了MySQL容器啟動(dòng)失敗的原因及解決方法,MySQL在啟動(dòng)時(shí)會(huì)讀取/etc/mysql/conf.d/目錄下的配置文件,若該目錄不存在或未正確掛載,會(huì)導(dǎo)致初始化失敗,解決方法包括通過(guò)掛載目錄、使用Dockerfile創(chuàng)建目錄或臨時(shí)繞過(guò)檢查等,需要的朋友可以參考下2026-03-03
Docker安裝RabbitMQ并安裝延時(shí)隊(duì)列插件
本文主要介紹了Docker安裝RabbitMQ并安裝延時(shí)隊(duì)列插件，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2022-05-05
Docker可視化ui管理工具Portainer安裝及使用解析
這篇文章主要介紹了Docker可視化ui管理工具Portainer安裝及使用解析,文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-11-11
這篇文章主要介紹了Docker如何掛載mysql問(wèn)題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2023-03-03
這篇文章主要為大家詳細(xì)介紹了Ubuntu Docker 安裝教程,具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2016-11-11
簡(jiǎn)述Docker安裝Tomcat鏡像并部署web項(xiàng)目
這篇文章主要介紹了簡(jiǎn)述Docker安裝Tomcat鏡像并部署web項(xiàng)目，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-10-10
這篇文章主要介紹了基于docker的redis集群的搭建方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-11-11
5款超好用的開(kāi)源 Docker工具強(qiáng)烈推薦
這篇文章主要介紹了5款超好用的開(kāi)源 Docker工具強(qiáng)烈推薦，這5個(gè)工具非常實(shí)用，有需要同學(xué)可以學(xué)習(xí)下2021-03-03