先说上传,在Servlet3中提供了Part来简化上传功能,而在spring boot内部默认整合了Part来完成上传。
html
只需注意form要设置一个参数enctype="multipart/form-data",才能上传文件,其他不多说了。
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
</head>
<body>
<form method="post" action="/upload" enctype="multipart/form-data">
文件:<input type="file" name="file" /><br/>
<input type="submit" value="上传" /><br/>
</form>
</body>
</html>
控制层实现上传
以下代码即可完成上传,并且将文件保存到e盘。注意,默认每个文件不得超过1M,否则会报错。
@PostMapping("/upload")
//上传的文件会转换成MultipartFile对象,file名字对应html中上传控件的name
public String test(MultipartFile file) throws IllegalStateException, IOException{
//transferTo是保存文件,参数就是要保存到的目录和名字
file.transferTo(new File("e:\\"+file.getOriginalFilename()));
return "上传完毕";
}
上面的file.getOriginalFilename(),是得到原始文件名。它还有其他一些方法,可以自己看eclipse提示。
MultipartFile对象常用方法
System.out.println("文件类型:"+file.getContentType());
System.out.println("原始文件名:"+file.getOriginalFilename());
System.out.println("文件大小:"+file.getSize());
System.out.println("是否为空:"+file.isEmpty());
application.properties配置
以下是默认配置,可以自行修改其中文件大小限制,上传的文件超出大小会报异常。
#单文件限制大小
spring.http.multipart.maxFileSize=1MB
#一次请求限制大小
spring.http.multipart.maxRequestSize=10MB
注意第二个参数,在html的form中可以有多个file,控制层的MultipartFile参数也可以有多个。也就是一次form提交,可以上传多个文件,第二个参数就是限制一次上传的所有文件加起来不超过10M。
文件命名
我上面代码中使用的是原始文件名,即用户上传时的命名。在实际情况下,可能多个用户上传的文件名字是一样的,这就有问题了,所以必须保证文件名的唯一性。在java中可以使用UUID.randomUUID()方法生成一个不会重复的名字,以此来命名文件。或者你的文件是和业务相关的,可以用业务id结合一些业务规则等来实现唯一命名就更好了。
用外部目录存储文件
tomcat项目可以把文件上传到tomcat项目的目录中,直接通过链接访问或下载这个文件。而spring boot项目在线上是以一个jar的形式存在的,不可能把文件上传到jar里面去。如上面我是上传在e盘中的,此时,如果想要访问或下载这个上传的文件,可以在application.properties中配置外部资源目录。
我在第4篇讲过,默认会有四个静态资源目录,以下配置的两个目录会覆盖掉四个默认目录。
#配置静态资源目录,以逗号分隔多个目录
spring.resources.static-locations=classpath:/static/,file:E:/image/
classpath:前缀不解释,static就是我在博客中一直用的静态目录,这是必须保留的。
file:前缀指硬盘上的目录,是可以在项目之外的目录。注意,必须先创建这个目录。
此时,如果将上传的文件xxx保存到E:/image/目录下,在浏览器直接通过http://localhost:8080/xxx 可以访问或下载这个文件。