layUI框架中文件上传前后端交互及遇到的相关问题

2018-12-06 07:34:33来源：博客园阅读 ()

下面我将讲述一下我在使用layUI框架中文件上传所遇到的问题：

前端jsp页面：

<div class="layui-form-item"> 
　　<label class="layui-form-label">照片</label> 
　　<div class="layui-input-block"> 
　　　　<!-- 上传按钮 -->
　　　　<button type="button" class="layui-btn" id="uploadPic"><i class="layui-icon">&#xe67c;</i>选择图片</button> 
　　　　<br><br>                    
　　　　<button type="button" class="layui-btn layui-btn-warm" id="uploadPicBtn">开始上传</button>
　　　　<!-- 隐藏的input,一个隐藏的input（用于保存文件url） -->
　　　　<input type="hidden" id="img_url" name="img" value=""/> 
　　　　<!-- 预览区域 -->
　　　　<div class="layui-upload-list"> 
　　　　　　<img class="layui-upload-img" width="100px" height="80px" id="preShow"/> 
　　　　　　<p id="demoText"></p> 
　　　　</div>                
　　</div> 
</div>
<div class="layui-form-item"> 
　　<label class="layui-form-label">视频</label> 
　　　　<div class="layui-input-block"> 
　　　　<!-- 上传按钮 -->
       <!-- <input type="file" name="file2" lay-type="video" class="layui-upload-file">  -->
       <button type="button" class="layui-btn" id="uploadVideo"><i class="layui-icon"></i>上传视频</button>
       <button type="button" class="layui-btn layui-btn-warm" id="uploadVideoBtn">开始上传</button>                     
       <!-- 隐藏的input,一个隐藏的input（用于保存文件url） -->
       <input type="hidden" id="video_url" name="video" value=""/> 
　　</div> 
</div>

<script src="${basePath}/x-admin/lib/layui/layui.js" charset="utf-8"></script>
<script type="text/javascript" src="${basePath}/public/js/jquery-3.3.1.min.js"></script>
/* 前端文件上传到java后端控制器 */　
　<script>
　　layui.use('upload', function(){ 
        var upload = layui.upload , $ = layui.jquery;
        //上传图片
        var uploadInst = upload.render({ 
            elem: '#uploadPic' //绑定元素 
            ,url: '${basePath}/ar/uploadFile' //上传接口 [[@{/upload/img}]]
            ,auto: false
            ,bindAction: '#uploadPicBtn'
            ,before: function(obj){ 
                //预读本地文件示例，不支持ie8 
                obj.preview(function(index, file, result){ 
                    $('#preShow').attr('src', result); //图片链接（base64） 
                    }); 
            } 
        ,done: function(res){ 
            //如果上传失败 
            if(res.code > 0){ 
                alert("上传失败"+res.data.src); 
                return layer.msg('上传失败'); 
                } 
            //上传成功 
                alert("上传成功"+res.data.src); 
                document.getElementById("img_url").value = res.data.src; 
                return layer.msg('上传成功'); 
                } 
         ,error: function(){ 
             /*date_default_timezone_set("Asia/Shanghai");
            //演示失败状态，并实现重传
              var dd=res.responseText.replace(/<\/?.+?>/g,"");
            var text=dd.replace(/ /g,"");//去掉所有空格
            o.msg("请求上传接口出现异常"+text),
           console.log(text);
            m(e) */
            
            var demoText = $('#demoText');
            demoText.html('<span style="color: #FF5722;">上传失败</span> <a class="layui-btn layui-btn-mini demo-reload">重试</a>'); 
            demoText.find('.demo-reload').on('click', function(){ 
                uploadInst.upload(); 
            });  
           } 
      });  
        
        //上传视频
        var uploadInst =upload.render({
            elem: '#uploadVideo'
                ,url: '${basePath }/ar/uploadFile'
                ,accept: 'video' //视频
                ,done: function(res){
                  console.log(res)
                //如果上传失败 
                if(res.code > 0){ 
                    alert("上传失败"+res.data.src); 
                    return layer.msg('上传失败'); 
                    } 
                    //上传成功 
                    alert("上传成功"+res.data.src); 
                    /* document.getElementById("img_url").value = res.data.src;  */
                    return layer.msg('上传成功'); 
                }
　　　　　　});
} );

java后台控制端：

@Controller
@RequestMapping(value="/ar")
@MultipartConfig
public class AnalyseRepariController {
@Autowired
private AnalyseRepariService arService;
  //图片上传控制器
        @RequestMapping(value = "/uploadFile" , method = RequestMethod.POST) 
        @ResponseBody
        public JSONObject uploadPicture(@RequestParam("file")MultipartFile file,HttpServletRequest servletRequest) 
                        throws IOException { 
                //如果文件内容不为空，则写入上传路径 
                //String str = "";
                JSONObject res = new JSONObject();
                JSONObject resUrl = new JSONObject();
                //上传文件路径 
                String path = servletRequest.getServletContext().getRealPath("/uploadFile");
                
                System.out.println("文件名称"+file.getOriginalFilename()); 
                //上传文件名         
                String name = file.getOriginalFilename();//上传文件的真实名称
                String suffixName = name.substring(name.lastIndexOf("."));//获取后缀名
                String hash = Integer.toHexString(new Random().nextInt());//自定义随机数（字母+数字）作为文件名
                String fileName = hash + suffixName;        
                File filepath = new File(path, fileName); 
                System.out.println("随机数文件名称"+filepath.getName()); 
                //判断路径是否存在，没有就创建一个 
                if (!filepath.getParentFile().exists()) { 
                    filepath.getParentFile().mkdirs(); 
                    } 
                //将上传文件保存到一个目标文档中 
                File tempFile = new File(path + File.separator + fileName);
                file.transferTo(tempFile);
                
                resUrl.put("src", tempFile.getPath());
                res.put("code", 0);
                res.put("msg", "");
                res.put("data", resUrl);
                //str = "{\"code\": 0,\"msg\": \"上传成功\",\"data\": {\"src\":\""+path+fileName + "\"}}";
                System.out.println("res里面的值：");
                System.out.println(res.toString());    
                return res;
            } 
}

报“请求上传接口异常”问题，一般的解决方法：

1、后台返回到前台的json数据一直报数据接口异常

第一，检查自己返回的json数据格式是否正常，该接口返回的相应信息（response）必须是一个标准的 JSON 格式，如：返回的数据格式是否是

{
  "code": 0
  ,"msg": ""
  ,"data": {
    "src": "http://cdn.layui.com/123.jpg"
  }
}

返回的数据格式是这样的，但是还是报数据接口异常的话
第二，msg的值一定要写"",不然会一直报错，自己设定的code值一定要写0，其他的值都是错误的。
2、json数据包是否配置好，我就是这样才导致一直报错

在 SpringController.java中需要如下代码：并在构建路径中引入这两个jar包，才能支持json格式的生成。

jackson-core-asl-1.9.11.jar

jackson-mapper-asl-1.9.11.jar
先下载这两个jar包，并加到项目的WebContent\WEB-INF\lib目录下，然后在编辑器目录中右击选择Web App Libraries中的Configure Build Path...引入项目中放入的两个jar包。

在springmvc.xml中需要配置如下信息：

    <!-- 注解映射器 -->
    <!-- 一定要配置这个，否则layui框架中文件上传会报请求上传接口异常，JACKSON包，让Spring MVC支持JSON视图的解析以及返回JSON数据进行呈现 -->
    <!--引入json支持,josn转换器配置  -->
    <bean
        class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <!-- json转换器 -->
        <property name="messageConverters">
            <list>
                <bean
                    class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter">
                </bean>
            </list>
        </property>
    </bean>

然后再浏览器中访问就可以得到json格式的数据了。

其实，经过测试发现，有的 spring版本不在springmvc.xml中进行josn转换器配置也可以转换成json格式，springmvc有自动转换功能，可惜我的没有。

controller代码: 我用的是@ResponseBody注解实现的

//文件上传控制器
@RequestMapping(value = "/uploadFile" , method = RequestMethod.POST) 
@ResponseBody
public JSONObject uploadPicture(@RequestParam("file")MultipartFile file,HttpServletRequest servletRequest) 
                throws IOException { 
        //如果文件内容不为空，则写入上传路径 
        //String str = "";
        JSONObject res = new JSONObject();
        JSONObject resUrl = new JSONObject();
        //上传文件路径 
        String path = servletRequest.getServletContext().getRealPath("/uploadFile");
        
        System.out.println("文件名称"+file.getOriginalFilename()); 
        //上传文件名         
        String name = file.getOriginalFilename();//上传文件的真实名称
        String suffixName = name.substring(name.lastIndexOf("."));//获取后缀名
        String hash = Integer.toHexString(new Random().nextInt());//自定义随机数（字母+数字）作为文件名
        String fileName = hash + suffixName;        
        File filepath = new File(path, fileName); 
        System.out.println("随机数文件名称"+filepath.getName()); 
        //判断路径是否存在，没有就创建一个 
        if (!filepath.getParentFile().exists()) { 
            filepath.getParentFile().mkdirs(); 
            } 
        //将上传文件保存到一个目标文档中 
        File tempFile = new File(path + File.separator + fileName);
        file.transferTo(tempFile);
        
        resUrl.put("src", tempFile.getPath());
        res.put("code", 0);
        res.put("msg", "");
        res.put("data", resUrl);
        //str = "{\"code\": 0,\"msg\": \"上传成功\",\"data\": {\"src\":\""+path+fileName + "\"}}";
        System.out.println("res里面的值：");
        System.out.println(res.toString());    
        return res;
    }