使用java的MultipartFile實現layui官網檔案上傳實現全部示例，java檔案上傳
阿新 • • 發佈：2019-07-13
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包
<!--上傳檔案依賴-->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.3</version>
</dependency>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">
<!-- 注意：如果你直接複製所有程式碼到本地，上述css路徑需要改成你本地的 -->
</head>
<body>
<blockquote class="layui-elem-quote">使用fileupload檔案上傳依賴包
<p>
commons-fileupload 1.3.3
</p>
<p>
MultipartFile物件的命名一定要叫 <font color="red" >file</font>
</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;">
<!-- 示例-970 -->
<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'}">上傳A</button>
<button class="layui-btn demoMore" lay-data="{url: '/upload/nameUplad', size:5}">上傳B</button>
<button class="layui-btn demoMore" lay-data="{url: '/upload/nameUplad', accept: 'file',size:10}">上傳C</button>
<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>
<!-- 注意：如果你直接複製所有程式碼到本地，上述js路徑需要改成你本地的 -->
<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('<span style="color: #FF5722;">上傳失敗</span> <a class="layui-btn layui-btn-xs demo-reload">重試</a>');
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('<img width="100px;" height="100px;" src="'+ 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 = $(['<tr id="upload-'+ index +'">'
,'<td>'+ file.name +'</td>'
,'<td>'+ (file.size/1014).toFixed(1) +'kb</td>'
,'<td>等待上傳</td>'
,'<td>'
,'<button class="layui-btn layui-btn-xs demo-reload layui-hide">重傳</button>'
,'<button class="layui-btn layui-btn-xs layui-btn-danger demo-delete">刪除</button>'
,'</td>'
,'</tr>'].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('<span style="color: #5FB878;">上傳成功</span>');
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('<span style="color: #FF5722;">上傳失敗</span>');
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];