使用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];

 

相關文章