在实际开发过程中,尤其是web项目开发,文件上传和下载的需求的功能非常场景,比如说用户头像、商品图片、邮件附件等等。其实文件上传下载的本质都是通过流的形式进行读写操作,而在开发中不同的框架都会对文件上传和下载有或多或少的封装,这里就以Spring MVC环境中文件的上传为例,讲解Spirng MVC环境下的文件上传功能实现。

一、客户端编程

      由于多数文件上传都是通过表单形式提交给后台服务器的,因此,要实现文件上传功能,就需要提供一个文件上传的表单。同时该表单必须满足以下3个条件:

  • form表单的method属性设置为post;
  • form表单的enctype属性设置为multipart/form-data;
  • 提供<input type="file" name="fileName" />的文件上传输入框。

在HTML5之前,如果想要上传多个文件,必须使用多个<input>元素。但是在HTML5中,在<input>元素配置multiple属性即可进行多个文件的上传。在HTML5中编写以下任意一行代码,便可生成一个按钮供选择多个文件:

  • <input type="file" name="fileName" multiple />
  • <input type="file" name="images" multiple="multiple" />
  • <input type="file" name="images" multiple="" />

具体代码示例如下:

<form action="uploadUrl" method="post" enctype="multipart/form-data"> 
    <input type="file" name="images" multiple="multiple" /> 
    <input type="submit" value="文件上传" /> 
</form>

二、springmvc-config.xml配置文件配置

      当客户端form表单的enctype属性为multipart/form-data时,浏览器就会采用二进制流的方式来处理表单数据,而对于文件上传的处理则涉及在服务器端解析原始的HTTP请求。Spring MVC为文件上传提供了直接的支持,这种支持是用即插即用的MultipartResolver实现的。

在Sring MVC中使用MultipartResolver也非常简单,只需要在Spring MVC配置文件springmvc-config.xml中定义MultipartResolver接口实现类即可,示例如下:

<!-- 配置文件上传类型解析器 multipartResolver--> 
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> 
    <!-- 设置上传文件最大尺寸,单位为B --> 
    <property name="maxUploadSize" value="5242880" /> 
</bean>

    注意:

由于MultipartResolver实现类CommonsMultipartResolver内部是引用multipartResolver字符串获取该实现类对象并完成文件上传操作的,所以在配置CommonsMultipartResolver时必须指定该bean的id为multipartResolver。另外由于MultipartResolver实现类CommonsMultipartResolver是Spring MVC内部通过Apache Commons FileUpload技术实现的。因此Spirng MVC的文件上传还需要依赖Apache Commons FileUpload的组件,即需要导入支持文件上传和下载的JAR包,具体如下:

  •  commons-fileupload.jar
  •  commons-io.jar

三、后台文件下载实现(MultipartFile接口介绍)

当完成上述客户端代码的编写及文件上传组件的配置后,在Spring MVC中处理已经上传的文件就十分容易了,上传到Spring MVC程序中的文件会被封装到一个MultipartFile对象中,然后开发者通过该对象的方法就可以进行后续相关处理了。

 编写后台文件上传控制器类及方法,具体示例如下:

/** 
 * 向文件上传页面跳转 
 */ 
@RequestMapping("/toFileUpload") 
public String toFileUpload( ){ 
    return "fileUpload"; 
} 
/** 
 * 接收文件上传请求 
 */ 
@RequestMapping("/fileUpload") 
public String fileUpload(List<MultipartFile> images){ 
    //对上传图像进行解析操作 
    if(images !=null && images.size()>0){ 
        for (MultipartFile image : images) { 
            //获取上传文件的原始名称 
            String originalFilename = image.getOriginalFilename(); 
            //设置上传文件的保存地址目录 
            String dirPath="D:\\fileUpload\\"; 
            File file =new File(dirPath); 
            //如果保存文件的地址不存在,就先创建目录 
            if(!file.exists()){ 
                file.mkdirs(); 
            } 
            //使用UUID重新命名上传的文件名称(看公司需求,也可以用日期时间) 
            String newFilename= UUID.randomUUID()+originalFilename.substring(originalFilename.lastIndexOf(".")); 
            try { 
                //使用MultipartFile接口的方法完成文件上传到指定位置 
                image.transferTo(new File(dirPath+newFilename)); 
                //文件上传成功后,需要将文件存放路径存入数据库中 
                //TODO,省略 
            } catch (Exception e) { 
                e.printStackTrace(); 
                //当文件上传出现异常,则重定向到文件上传页面 
                return "redirect:toFileUpload"; 
            }  
        } 
    } 
    //文件上传成功后,跳转到成功页面 
    return "success"; 
}

四、效果演示(读者可以自己编写项目和jsp页面)

    部署并启动web服务器,在浏览器地址啦输入地址:http://localhost:8080/webname/toFileUpload后(读者根据自己的项目和路径进行访问),浏览器的显示效果如下图所示

   上面我选择了上传2个文件,然后点击提交后,即可完成上传。读者操作后可自行到指定上传位置进行验证。

   至此,Sring MVC环境下文件上传功能代码即已实现。

 

 

 

 

 

 

发布评论

分享到:

IT虾米网

微信公众号号:IT虾米 (左侧二维码扫一扫)欢迎添加!

SpringMvc多文件上传简单实现详解
你是第一个吃螃蟹的人
发表评论

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。