使用java的MultipartFile实现layui官网文件上传实现全部示例，java文件上传

2022-11-20 21:44:09

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

码农公寓

相关文章