文章目录

  • 一、传统上传方式
  • 1.jar包准备
  • 2. 前端页面准备
  • 2.1代码
  • 2.2效果
  • 3.后端代码
  • 4.项目的两种不同部署方式带来的上传文件位置的不同
  • 4.1 项目名:war
  • 4.2 项目名:war exploded
  • 二、SpingMVC方式文件上传
  • 1.原理
  • 2.配置文件解析器
  • 3.上传代码
  • 3.1注意事项
  • 3.2测试
  • 三、跨服务器文件上传
  • 1.应用场景
  • 2.文件服务器环境搭建
  • 2.1web.xml配置中允许该服务器接收文件
  • 2.2target目录下创建uploads目录
  • 2.3配置效果
  • 3.跨服务器上传的jar包
  • 4.应用服务器代码编写
  • 4.1注意点
  • 5.效果


一、传统上传方式

1.jar包准备

  • 这种方式依赖于两个jar包
<dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.3.1</version>
    </dependency>

    <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
      <version>2.4</version>
    </dependency>

2. 前端页面准备

2.1代码

<h3>传统文件上传方式</h3>
    <form action="user/fileupload1" method="post" enctype="multipart/form-data">
        选择文件:<input type="file" name="upload" />
        <br/>
        <input type="submit" value="上传" />
    </form>

2.2效果

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_服务器

3.后端代码

注意到代码里把文件位置打印出来了,这是为了后面厘清web项目不同的部署方式带来的问题

@RequestMapping("/fileupload1")
    //首先前端上传的文件肯定都是存在request中的,所以肯定需要获取到这个对象
    public String fileupload1(HttpServletRequest request) throws Exception {
        System.out.println("文件正在上传....");
        //首先获取上传位置,注意这里是部署在工作空间的
        String path = request.getSession().getServletContext().getRealPath("/uploads/");
        //判断该路径是否存在,若不存在,则创建
        File file = new File(path);
        if (!file.exists()){
            file.mkdirs();
        }
        System.out.println("文件上传地址为:" + path);
        //文件夹确认好了
        //开始解析request对象 开始文件上传
        DiskFileItemFactory factory = new DiskFileItemFactory();
        ServletFileUpload upload = new ServletFileUpload(factory);
        //解析request
        List<FileItem> items = upload.parseRequest(request);
        //遍历
        for (FileItem item : items) {
            if (item.isFormField()){
                //说明只是普通表单,不是文件

            }else {
                //获取上传文件项的名称
                String filename = item.getName();
                //设置文件前缀唯一的id值
                String uuid = UUID.randomUUID().toString().replace("-", "");
                filename = uuid + "_" + filename;
                //完成文件上传 文件写入磁盘
                item.write(new File(path,filename));
                //删除临时文件 上传过程中会出现临时文件在内存中
                item.delete();
            }
        }
        return "success";
    }

4.项目的两种不同部署方式带来的上传文件位置的不同

这里本质上是项目的工作空间不同,正好在文件上传这里体现出来了,觉得有必要讲一下

4.1 项目名:war

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_文件上传_02

4.2 项目名:war exploded

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_文件上传_03

二、SpingMVC方式文件上传

1.原理

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_文件上传_04

2.配置文件解析器

在springmvc.xml中配置

!--配置文件解析器-->
        <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
            <!--value的基本单位是字节-->
            <property name="maxUploadSize" value="10486760"></property>
        </bean>
  • 注意点就是id的命名必须是固定的

3.上传代码

@RequestMapping("/fileupload2")
    //首先前端上传的文件肯定都是存在request中的,所以肯定需要获取到这个对象
    public String fileupload2(HttpServletRequest request, MultipartFile upload) throws Exception {
        System.out.println("springMVC文件正在上传....");
        //首先获取上传位置,注意这里是部署在工作空间的
        String path = request.getSession().getServletContext().getRealPath("/uploads/");
        //判断该路径是否存在,若不存在,则创建
        File file = new File(path);
        if (!file.exists()){
            file.mkdirs();
        }
        //获取上传文件项的名称
        String filename = upload.getName();
        //设置文件前缀唯一的id值
        String uuid = UUID.randomUUID().toString().replace("-", "");
        filename = uuid + "_" + filename;
        //完成文件上传 文件写入磁盘
        upload.transferTo(new File(path,filename));
        return "success";
    }

3.1注意事项

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_文件上传_05

3.2测试

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_文件上传_06

三、跨服务器文件上传

1.应用场景

  • 在实际开发中,我们会有很多处理不同功能的服务器。例如: 应用服务器:负责部署我们的应用 数据库服务器:运行我们的数据库 缓存和消息服务器:负责处理大并发访问的缓存和消息 文件服务器:负责存储用户上传文件的服务器。
  • 所以一般需要把应用服务器收到的图片再发给专门存储图片的服务器

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_上传_07

2.文件服务器环境搭建

  • 再搭建一个web项目,部署到tomcat中,注意端口号不要和上述项目冲突就好

2.1web.xml配置中允许该服务器接收文件

<servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
      <param-name>debug</param-name>
      <param-value>0</param-value>
    </init-param>
    <init-param>
      <param-name>readonly</param-name>
      <param-value>false</param-value>
    </init-param>
    <init-param>
      <param-name>listings</param-name>
      <param-value>false</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
2.2target目录下创建uploads目录

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_文件上传_08

2.3配置效果

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_文件上传_09

3.跨服务器上传的jar包

<dependency>
      <groupId>com.sun.jersey</groupId>
      <artifactId>jersey-core</artifactId>
      <version>1.18.1</version>
    </dependency>
    <dependency>
      <groupId>com.sun.jersey</groupId>
      <artifactId>jersey-client</artifactId>
      <version>1.18.1</version>
    </dependency>

4.应用服务器代码编写

@RequestMapping("/fileupload3")
    public String fileuoload3(MultipartFile upload) throws Exception {
        System.out.println("跨服务器文件上传...");

        // 定义上传文件服务器路径
        String path = "http://localhost:9090/fileuploadserver_war_exploded/uploads/";

        // 说明上传文件项
        // 获取上传文件的名称
        String filename = upload.getOriginalFilename();
        // 把文件的名称设置唯一值,uuid
        String uuid = UUID.randomUUID().toString().replace("-", "");
        filename = uuid+"_"+filename;

        // 创建客户端的对象
        Client client = Client.create();

        // 和图片服务器进行连接
        WebResource webResource = client.resource(path + filename);

        // 上传文件
        webResource.put(upload.getBytes());

        return "success";
    }

4.1注意点

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_上传_10

5.效果

创建一个springmvc项目 API 上传图片 springmvc文件上传详解_服务器_11