layui(谐音:类UI) 是一款采用自身模块规范编写的前端 UI 框架,遵循原生 HTML/CSS/JS 的书写与组织形式,门槛极低,拿来即用。
layui文件上传示例地址:https://www.layui.com/demo/upload.html
本次教程是基于springboot2.0的。
测试中把layui官网的文件上传都实现了一遍。
然后还在自行写了一个登录注册,使用了上传图像。因为只是测试,所以写的不规范,谅解。。。
发一些项目截图,觉得对自己有用的朋友可以自行下载看看。
这个测试项目我发布在了GitHub上。可以自行下载。如果有什么问题的地方请大佬一定要留言告诉小弟我,感激不尽!
地址:https://github.com/hunmeng/jpa01
不下载继续看文章也是可以的。往下滑
废话少说,进入主题。
在pom文件导入commons-fileupload 1.3.3依赖或者jar包
commons-fileupload commons-fileupload 1.3.3
jar包下载地址 https://repo1.maven.org/maven2/commons-fileupload/commons-fileupload/1.3.3/commons-fileupload-1.3.3.jar
1.导入完毕之后配置bean
@Configuration public class SpringBean { //设置文件上传的配置 @Bean(name = "multipartResolver") public CommonsMultipartResolver multipartResolver(){ CommonsMultipartResolver resolver = new CommonsMultipartResolver(); resolver.setDefaultEncoding("UTF-8"); resolver.setMaxUploadSize(52428800);//设置上传文件的最大值 resolver.setResolveLazily(true); return resolver; } }
2.在yml配置文件
file:
staticAccessPath: /upload/**
uploadFolder: G://upload/
3.然后配置文件夹映射,不然无法在项目中获取电脑上的文件
不过这个好像和文件上传没有关系,哈哈哈。想配置的就配置一下吧,反正之后获取图片时也会配置的。
@Configuration public class WebMvcConfig extends WebMvcConfigurerAdapter { @Value("${file.staticAccessPath}") private String staticAccessPath; @Value("${file.uploadFolder}") private String uploadFolder; @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(staticAccessPath).addResourceLocations("file:" + uploadFolder); registry.addResourceHandler("/static/**").addResourceLocations("classpath:/static/"); } }
4.之后创建一个实体类,当然你也可以不创建,直接把MultipartFile写在方法参数中,但是一定要做注意参数命名一定要是file,一定要是file,一定要是file。重要的事情说三遍。
实体类中MultipartFile属性名也必须叫file。写实体类的好处是可以方便携带其他的参数,比如和图片绑定的用户id等等
//实体类
public class FileVo implements Serializable { private
file; public FileVo(MultipartFile multipartFile) { this.file = multipartFile; } public FileVo(){} public MultipartFile getFile() { return file; } public void setFile(MultipartFile file) { this.file = file; } }
5.然后在Controller层加入以下方法。因为只是测试所以就写到了controller层,当然你也可以把文件上传方法放到util类,或者service层
@RestController @RequestMapping("/upload") public class UploadController { @Value("${file.uploadFolder}") private String uploadFolder; /** * UUID随机的命名 * 普通上传,多图片上传 * @param fileVo * @return */ @RequestMapping("/randomUplad") public Map randomUplad(FileVo fileVo){ System.out.println("fileVo:"+fileVo.getFile()); String fileUrl = fileUpload(fileVo,true); return this.file(fileUrl); } /** * 上传文件的全名称命名 * 指定允许上传的文件类型,允许上传的文件后缀,视频 * @param fileVo * @return */ @RequestMapping("/nameUplad") public Map nameUplad(FileVo fileVo){ System.out.println("fileVo:"+fileVo.getFile()); String fileUrl = fileUpload(fileVo,false); return this.file(fileUrl); } /** * 文件上传,随机UUID * @param fileVo 上传的实体 * @param b 判断是用随机的uuid还是文件的名称,默认为UUID * @return 上传的URL地址 */ public String fileUpload(FileVo fileVo,boolean b) { if (fileVo.getFile()==null) { return null; } //随机一个id String name = fileVo.getFile().getOriginalFilename(); if (b) { //判断是否用什么命名,true为UUID,false为上传文件的全名称 //获取文件的后缀 String[] split = name.split("\\."); // 匹配小数点(.)必须转义,否则split方法无效 name = UUID.randomUUID().toString().replaceAll("-", "")+"."+split[split.length-1]; } String fileUrl = this.uploadFolder+"/"+name; System.out.println("fileUrl:"+fileUrl); File file = new File(fileUrl); try { fileVo.getFile().transferTo(file); } catch (IOException e) { fileUrl = null; } return fileUrl; } @RequestMapping("/fileUploads") public Map fileUploads(MultipartFile file[]){ return this.file(null); } /** * 返回是否上传成功的参数 * @param url * @return */ public Map file(String url){ Map map = new HashMap(); if (url==null||url=="") { map.put("msg","上传失败"); map.put("code",500); return map; } map.put("msg","上传成功"); map.put("code",200); map.put("url",url); return map; } }
6.最后就是前端 的的代码了,注意导入layui的js和css!
这里的代码基本上都是https://www.layui.com/demo/upload.html里的,只修改了提交的地址罢了。
DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>layui文件上传title>
<meta name="renderer" content="webkit">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
<link rel="stylesheet" href="//res.layui.com/layui/dist/css/layui.css" media="all">
head>
<body>
<blockquote class="layui-elem-quote">使用fileupload文件上传依赖包
<p>
commons-fileupload 1.3.3
p>
<p>
MultipartFile对象的命名一定要叫 <font color="red" >filefont>
p>
blockquote>
<fieldset class="layui-elem-field layui-field-title" style="margin-top: 30px;">
<legend>常规使用:普通图片上传legend>
fieldset>
<div class="layui-upload">
<button type="button" class="layui-btn" id="test1">上传图片button>
<div class="layui-upload-list">
<img class="layui-upload-img" id="demo1">
<p id="demoText">p>
div>
div>
<fieldset class="layui-elem-field layui-field-title" style="margin-top: 30px;">
<legend>上传多张图片legend>
fieldset>
<div class="layui-upload">
<button type="button" class="layui-btn" id="test2">多图片上传button>
<blockquote class="layui-elem-quote layui-quote-nm" style="margin-top: 10px;">
预览图:
<div class="layui-upload-list" id="demo2">div>
blockquote>
div>
<fieldset class="layui-elem-field layui-field-title" style="margin-top: 30px;">
<legend>指定允许上传的文件类型legend>
fieldset>
<button type="button" class="layui-btn" id="test3"><i class="layui-icon">i>上传文件button>
<button type="button" class="layui-btn layui-btn-primary" id="test4"><i class="layui-icon">i>只允许压缩文件button>
<button type="button" class="layui-btn" id="test5"><i class="layui-icon">i>上传视频button>
<button type="button" class="layui-btn" id="test6"><i class="layui-icon">i>上传音频button>
<div style="margin-top: 10px;">
<ins class="adsbygoogle" style="display:inline-block;width:970px;height:90px" data-ad-client="ca-pub-6111334333458862" data-ad-slot="3820120620">ins>
div>
<fieldset class="layui-elem-field layui-field-title" style="margin-top: 30px;">
<legend>设定文件大小限制legend>
fieldset>
<button type="button" class="layui-btn layui-btn-danger" id="test7"><i class="layui-icon">i>上传图片button>
<div class="layui-inline layui-word-aux">
这里以限制 60KB 为例
div>
<fieldset class="layui-elem-field layui-field-title" style="margin-top: 30px;">
<legend>同时绑定多个元素,并将属性设定在元素上legend>
fieldset>
<button class="layui-btn demoMore" lay-data="{url: '/upload/nameUplad'}">上传Abutton>
<button class="layui-btn demoMore" lay-data="{url: '/upload/nameUplad', size:5}">上传Bbutton>
<button class="layui-btn demoMore" lay-data="{url: '/upload/nameUplad', accept: 'file',size:10}">上传Cbutton>
<fieldset class="layui-elem-field layui-field-title" style="margin-top: 30px;">
<legend>选完文件后不自动上传legend>
fieldset>
<div class="layui-upload">
<button type="button" class="layui-btn layui-btn-normal" id="test8">选择文件button>
<button type="button" class="layui-btn" id="test9">开始上传button>
div>
<fieldset class="layui-elem-field layui-field-title" style="margin-top: 30px;">
<legend>拖拽上传legend>
fieldset>
<div class="layui-upload-drag" id="test10">
<i class="layui-icon">i>
<p>点击上传,或将文件拖拽到此处p>
div>
<fieldset class="layui-elem-field layui-field-title" style="margin-top: 30px;">
<legend>高级应用:制作一个多文件列表legend>
fieldset>
<div class="layui-upload">
<button type="button" class="layui-btn layui-btn-normal" id="testList">选择多文件button>
<div class="layui-upload-list">
<table class="layui-table">
<thead>
<tr><th>文件名th>
<th>大小th>
<th>状态th>
<th>操作th>
tr>thead>
<tbody id="demoList">tbody>
table>
div>
<button type="button" class="layui-btn" id="testListAction">开始上传button>
div>
<fieldset class="layui-elem-field layui-field-title" style="margin-top: 30px;">
<legend>绑定原始文件域legend>
fieldset>
<input type="file" name="file" id="test20">
<script src="//res.layui.com/layui/dist/layui.js" charset="utf-8">script>
<script>
layui.use('upload', function(){
var $ = layui.jquery
,upload = layui.upload;
//普通图片上传
var uploadInst = upload.render({
elem: '#test1'
,url: '/upload/randomUplad'
,before: function(obj){
//预读本地文件示例,不支持ie8
obj.preview(function(index, file, result){
$('#demo1').attr('src', result); //图片链接(base64)
$('#demo1').attr('height', "100px");
$('#demo1').attr('width', "100px");
});
}
,done: function(res){
//如果上传失败
layer.msg(res.code+"---"+res.msg+"---"+res.url);
//上传成功
}
,error: function(){
//演示失败状态,并实现重传
var demoText = $('#demoText');
demoText.html('上传失败 重试');
demoText.find('.demo-reload').on('click', function(){
uploadInst.upload();
});
}
});
//多图片上传
upload.render({
elem: '#test2'
,url: '/upload/randomUplad'
,multiple: true
,before: function(obj){
//预读本地文件示例,不支持ie8
obj.preview(function(index, file, result){
$('#demo2').append(''+ result +'" alt="'+ file.name +'" class="layui-upload-img">')
});
}
,done: function(res){
layer.msg(res.code+"---"+res.msg+"---"+res.url);
//上传完毕
}
});
//指定允许上传的文件类型
upload.render({
elem: '#test3'
,url: '/upload/nameUplad'
,accept: 'file' //普通文件
,done: function(res){
layer.msg(res.code+"---"+res.msg+"---"+res.url);
console.log(res)
}
});
upload.render({ //允许上传的文件后缀
elem: '#test4'
,url: '/upload/nameUplad'
,accept: 'file' //普通文件
,exts: 'zip|rar|7z' //只允许上传压缩文件
,done: function(res){
layer.msg(res.code+"---"+res.msg+"---"+res.url);
console.log(res)
}
});
upload.render({
elem: '#test5'
,url: '/upload/nameUplad'
,accept: 'video' //视频
,done: function(res){
layer.msg(res.code+"---"+res.msg+"---"+res.url);
console.log(res)
}
});
upload.render({
elem: '#test6'
,url: '/upload/nameUplad'
,accept: 'audio' //音频
,done: function(res){
layer.msg(res.code+"---"+res.msg+"---"+res.url);
console.log(res)
}
});
//设定文件大小限制
upload.render({
elem: '#test7'
,url: '/upload/nameUplad'
,size: 60 //限制文件大小,单位 KB
,done: function(res){
layer.msg(res.code+"---"+res.msg+"---"+res.url);
console.log(res)
}
});
//同时绑定多个元素,并将属性设定在元素上
upload.render({
elem: '.demoMore'
,before: function(){
layer.tips('接口地址:'+ this.url, this.item, {tips: 1});
}
,done: function(res, index, upload){
var item = this.item;
layer.msg(res.code+"---"+res.msg+"---"+res.url);
console.log(item); //获取当前触发上传的元素,layui 2.1.0 新增
}
})
//选完文件后不自动上传
upload.render({
elem: '#test8'
,url: '/upload/nameUplad'
,auto: false
//,multiple: true
,bindAction: '#test9'
,done: function(res){
layer.msg(res.code+"---"+res.msg+"---"+res.url);
console.log(res)
}
});
//拖拽上传
upload.render({
elem: '#test10'
,url: '/upload/nameUplad'
,done: function(res){
layer.msg(res.code+"---"+res.msg+"---"+res.url);
console.log(res)
}
});
//多文件列表示例
var demoListView = $('#demoList')
,uploadListIns = upload.render({
elem: '#testList'
,url: '/upload/randomUplad'
,accept: 'file'
,multiple: true
,auto: false
,bindAction: '#testListAction'
,choose: function(obj){
var files = this.files = obj.pushFile(); //将每次选择的文件追加到文件队列
//读取本地文件
obj.preview(function(index, file, result){
var tr = $([''+ index +'">'
,''+ file.name +' '
,''+ (file.size/1014).toFixed(1) +'kb</td>'
,'<td>等待上传</td>'
,' '
,''
,''
,' '
,' '].join(''));
//单个重传
tr.find('.demo-reload').on('click', function(){
obj.upload(index, file);
});
//删除
tr.find('.demo-delete').on('click', function(){
delete files[index]; //删除对应的文件
tr.remove();
uploadListIns.config.elem.next()[0].value = ''; //清空 input file 值,以免删除后出现同名文件不可选
});
demoListView.append(tr);
});
}
,done: function(res, index, upload){
if(res.code == 200){ //上传成功
var tr = demoListView.find('tr#upload-'+ index)
,tds = tr.children();
tds.eq(2).html('上传成功');
tds.eq(3).html(''); //清空操作
return delete this.files[index]; //删除文件队列已经上传成功的文件
}
this.error(index, upload);
}
,error: function(index, upload){
var tr = demoListView.find('tr#upload-'+ index)
,tds = tr.children();
tds.eq(2).html('上传失败');
tds.eq(3).find('.demo-reload').removeClass('layui-hide'); //显示重传
}
});
//绑定原始文件域
upload.render({
elem: '#test20'
,url: '/upload/randomUplad'
,done: function(res){
layer.msg(res.code+"---"+res.msg+"---"+res.url);
console.log(res)
}
});
});
script>
body>
html>
最最后总结一下在编码时出现的几个问题。
1.就是MultipartFile必须命名为file
2.在获取上传文件的后缀名时,用split()方法匹配小数点(.)必须进行转义。
String[] split = name.split("\\.");
String fileSuffix = split[split.length-1];