docker部署springboot项目 之 文件上传

最近在做项目的时候,有一个文件上传的需求,领导又让直接上传到服务器,在网上看到这篇文章很全面,特此记录。

一、问题

解决通过docker部署springboot项目,文件上传的路径该怎么设置?用docker部署后,在服务器上面怎么看到自己上传的文件,文件需不需要挂载等问题,下面直接使用springboot+docker简单搭建一个文件服务器。

二、环境

以下是本人此次搭建的环境

部署方式:docker
服务器:linux服务器
服务器操作系统:CentOS 8.2
jdk:1.8

三、创建springboot项目

创建springboot项目upload-demo,先在本地进行测试,确保本地的项目可以进行文件上传和下载
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:
#  部署服务器时的服务上文件存放地址  
#  path: /upload-demo/upload 
  
# 本地的文件存放地址  
  path: D:\zqcn\data\upload-demo\upload

server:
  port: 8082

为了方便直观的看到效果,这里就简单写了两个html页面进行测试
upload-page.html(文件上传页面)

<!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(文件下载页面)

<!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;"><br/>

    <input type="submit" value="提交">
</form>
</body>
</html>

最后编写对应的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;


    /**
     * 文件上传页面
     * @param request
     * @return
     */
    @RequestMapping("/upload")
    public String uploadPage(HttpServletRequest request){
        return "upload-page";
    }


    /**
     * 文件下载页面
     * @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","没有选中任何文件");
                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();
        // 构建真实的文件路径
        File uploadFile = new File(uploadFileSaveDir.getAbsolutePath() + File.separator + filename);
        System.out.println("文件上传到:" + uploadFile.getAbsolutePath());
        //文件写到服务器,
        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);
            //设置响应头,对文件进行url编码
            fileName = URLEncoder.encode(fileName, "UTF-8");
            response.setHeader("Content-Disposition", "attachment;filename="+fileName);
            response.setContentLength(in.available());

            //第三步:读文件写入http响应
            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);
            }};
        }
    }
}

启动项目,先用postman测试一下上传接口

在这里插入图片描述
再测试一下下载接口

在这里插入图片描述
接口测试没问题,下面可以测一下那两个页面
在这里插入图片描述
在这里插入图片描述

都是正常的,本地项目创建成功

四、docker部署项目

(1)构建镜像

关于docker部署springboot项目,可以参考本人的另一篇博客 菜鸟的Docker部署SpringBoot项目

关于linux服务器和docker的基础知识这里就不赘述了,自行百度即可,下面直接进入部署流程,先把项目的文件上传路径改成部署环境的上传地址
在这里插入图片描述

再本地进行jar打包
在这里插入图片描述

创建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:创建/tmp目录并持久化到Docker数据文件夹 ADD

upload_demo.jar:将生成的jar包(第一个)复制并重命名到upload_demo.jar(第二个) EXPOSE

8082:对外暴露的接口,也是访问的接口,接口的端口号需要根据springboot项目配置的端口号来设置

ENTRYPOINT:固定写法,用来运行jar包,相当于java -jar xxx.jar一样

最后将jar和Dockerfile通过xftp一起上传到服务器上面,最好找个文件夹统一放在一起,例如
在这里插入图片描述

再通过xshell进入jar和Dockerfile所在的目录,并且输入构建镜像的命令

docker build -t upload-demo . 

在这里插入图片描述

构建成功后,先随便创建

(2)启动容器

为了更清楚的理解docker部署的项目文件上传路径,这里分两种方式启动容器,一种不挂载文件,一种挂载文件,两种方式,简单分析一下文件的上传路径

(1)不挂载文件启动容器
命令如下:

sudo docker run -d --name upload-demo01 -p 8082:8082  upload-demo

在这里插入图片描述

容器启动成功后,用postman进行文件上传测试,上传了1.jpeg文件
在这里插入图片描述

上传也是成功了,那么怎么看到上传的图片呢,还有就springboot项目配置的文件上传地址体现在哪里,要想知道这些答案,就需要进入容器内部看了,命令

docker exec -it upload-demo01 /bin/bash

进入里面后查看当前目录下的文件,就会发现upload-demo,这个就springboot配置的上传地址
在这里插入图片描述

再进入upload-demo文件里面看看
在这里插入图片描述

就会发现里面有一个文件夹upload,再深入里面看看,就会发现里面有一张图片1.jpeg,就是我们上传的图片了
在这里插入图片描述

总结一下容器里面的路径地址就是:/upload-demo/upload,这个路径就是springboot配置的文件上传地址
在这里插入图片描述

至此为止,整体容器启动后,文件上传和下载都是正常的,唯一不足的就是,如果要看这个图片上传在哪里,就需要进入容器里面看,下面推荐第二种方式,启动容器后,并且把容器里面的图片挂载出来

(2)挂载文件启动容器
先在服务器上创建一个目录,用于存放挂载出来的图片,本人的路径是/home/cainiao/upload-demo/upload
在这里插入图片描述

下面执行以下命令启动容器:

 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:是你要挂载到容器外面的服务器图片路径
/upload-demo/upload:是容器里面图片地址

在这里插入图片描述

容器启动成功,现在用postman进行接口上传测试,文件2.jpeg上传成功
在这里插入图片描述

现在去服务器上面的/home/cainiao/upload-demo/upload里面,刷新一下,看一下发现图片已经挂载出来了
在这里插入图片描述

现在试一下图片下载
在这里插入图片描述

可以看到图片,经过测试,图片可以完成下载

三、补充

正常部署的话,建议采用第二种采用挂载文件的形式进行启动

四、读者问题

这样是不是意味着存了两份文件?
回答:好问题!
是的,但是不影响,也不建议上传过多或过大文件到容器中,因为会同步到你的宿主机上。除非你宿主机的硬盘够大,或者你有文件存储服务器。docker容器默认根据你宿主机的硬盘和内存大小来分配,项目中上传的文件累计到大过你的宿主机硬盘大小会导致容器无法运行,也会降低性能。
个人建议:云存储,阿里云、华为云、百度云等等,实在私密就整文件存储服务器。

  • 2
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: 要在Docker部署Spring Boot项目,需要执行以下步骤: 1. 构建项目并生成可执行的JAR文件。 2. 创建一个Dockerfile,在其中指定基础镜像、工作目录、拷贝JAR文件到容器中、启动项目的命令。 3. 构建Docker镜像,使用命令 "docker build -t image-name ."。 4. 在本地运行容器,使用命令 "docker run -p host-port:container-port image-name"。 5. 可以使用 "docker ps" 查看容器运行状态, 使用 "docker logs container-id"查看日志 6. 上传镜像到远程镜像库(如docker hub), 可以在其它机器上直接下载运行 注意: - 本地和运行环境需要安装Docker - 构建镜像时,确保Dockerfile和jar文件在同一目录下 - 如果需要持久化数据,需要使用docker volume 或者 bind mount - 如果需要暴露多个端口,需要使用-p参数多次指定 - 如需进入容器进行操作,可以使用 "docker exec -it container-id /bin/bash" ### 回答2: Docker是一种容器化技术,可以将应用程序及其依赖项封装到一个独立的容器中,并进行跨平台部署。下面是使用Docker部署Spring Boot项目的步骤: 1. 在本地开发环境中,首先需要编写好Spring Boot项目的代码,并确保项目能够运行成功。 2. 在项目根目录下创建一个Dockerfile文件,该文件用于定义Docker镜像的构建规则。可以使用一个基础的Java或者Spring Boot镜像作为基础镜像,并将项目打包成一个可执行的jar文件。 3. 在Dockerfile中,使用适当的命令下载、安装Java和Maven等依赖项,并将项目代码复制到镜像中。使用Maven构建工具构建项目,并将项目打包成一个可执行的jar文件。 4. 在Dockerfile中,定义容器启动时的命令,例如运行Java命令执行可执行的jar文件。 5. 使用Docker命令构建镜像,可以通过运行`docker build -t <镜像名> .`命令构建镜像。镜像名可以自定义,`.`代表Dockerfile所在的当前目录。 6. 构建成功后,使用`docker images`命令查看构建好的镜像。 7. 可以通过运行`docker run -p <主机端口>:<容器端口> <镜像名>`命令启动容器,将主机端口映射到容器端口,使得可以从主机访问Spring Boot应用程序。 8. 访问http://localhost:<主机端口>,即可查看Spring Boot应用程序运行结果。 9. 如果需要在容器外部更新代码,可以使用`docker cp`命令将更新后的代码复制到运行中的容器中,然后重新启动容器即可。 使用Docker进行Spring Boot项目部署,可以保证环境的一致性,并提供了良好的可移植性,便于在不同的开发和生产环境中部署和迁移应用程序。 ### 回答3: Docker是一种轻量级容器技术,可以用于快速部署和管理应用程序。下面我将介绍如何使用Docker部署Spring Boot项目。 首先,确保您已经安装了Docker并且可以正常运行。您可以通过在终端中运行`docker version`命令来检查Docker的安装情况。 接下来,准备好您的Spring Boot项目。确保项目已经构建并生成可执行的jar文件。 然后,创建一个Dockerfile文件,用于定义Docker镜像的构建过程。在Dockerfile中,您需要指定基础镜像、将可执行的jar文件复制到镜像中的位置以及项目的启动命令。以下是一个示例Dockerfile的内容: ``` FROM openjdk:8-jdk-alpine COPY target/myproject.jar /app/myproject.jar WORKDIR /app CMD ["java", "-jar", "myproject.jar"] ``` 接下来,使用`docker build`命令来构建镜像。在终端中,切换至包含Dockerfile的目录,并执行以下命令: ``` docker build -t myproject-image . ``` 其中,`myproject-image`为您指定的镜像名称。 构建完成后,使用`docker run`命令来创建并运行容器。执行以下命令: ``` docker run -p 8080:8080 myproject-image ``` 其中,`8080`为您项目中的端口号,`myproject-image`为镜像名称。 现在,您的Spring Boot项目已经在Docker容器中成功部署了。您可以通过访问`http://localhost:8080`来验证项目是否正确运行。 通过使用Docker,可以隔离应用程序和其依赖项,简化部署和管理过程,并提供更高的可移植性和可扩展性。希望以上内容对您有所帮助!

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值