jQuery OCUpload ——> 一键上传插件

时间 2019-11-19

原文原文链接

OCUpload为jQuery的插件(One Click Upload)，意思为一键上传，封装了对于文件上传的一些方法，只需几行代码，文件上传优雅而简洁。
对于传统的文件上传，只是经过input标签，经过设置enctype为multipart/form-data，选中文件后还需点击按钮，提交表单，才能在后台进行相关字段解析，经过流来进行文件上传，上传成功后，页面多半要刷新，没法给用户良好的体验。OCUpload实现了页面“不刷新”，选择文件后直接上传，不须要选中文件后再点击按钮上传表单。javascript

ajax不能作文件上传。java

插件使用步骤jquery

1. 在页面中引入OCUpload插件的js文件ajax

<script type="text/javascript" src="${pageContext.request.contextPath}/js/jquery.ocupload-1.1.2.js"></script>

2. 在页面中提供任意一个元素来“占位子”（上传文件通常选择按钮，因此这里利用easyui定义一个按钮）apache

<body>
  <a id="import" class="easyui-linkbutton" data-options="iconCls:'icon-redo'">上传文档</a>
</body>

3. 在head中给id为import的按钮添加upload事件，这是OCUpload的上传方法，参数为json对象。json

因为是简单入门，在这里即便用三个主要的属性：服务器

action(处理上传文件的后台action路径)，name(给文件设置name，便于后台经过name获取)，onComplete(参数为function，执行上传完毕的回调函数)。函数

<script type="text/javascript">
    $(function(){
        $("#import").upload({
        action:'${pageContext.request.contextPath}/regionAction_importXls',
        name:'upload',
        onComplete: function (data, self, element) { 
         if(data=='1'){
                $.messager.alert("提示信息","数据导入成功!","info");
            }else{
                $.messager.alert("提示信息","数据导入失败!","info");
            }
                location.reload();
        }
    });
});
</script>

到此便完成一键上传的前台代码，只须要后台对上传文件进行解析处理便可完成文件上传。ui

原理：spa

OCUpload将咱们的linkbutton底部添加了一个带有文件input的form和一个display:none 不可见的iframe。
选择文件后form中的input触发onChange事件，直接提交表单，实现了选择文件后直接上传
文件上传后，原本页面是要刷新的，可是OCUpload将target指向底部隐藏的iframe，使得隐藏的iframe刷新，从而达到咱们的页面“不刷新”的效果

官方上传例子：

$(element).upload({
                name: 'file',//上传组件的name属性，即<input type='file' name='file'/>
                action: '',//向服务器请求的路径
                enctype: 'multipart/form-data',//mime类型，默认便可
                params: {},//请求时额外传递的参数，默认为空
                autoSubmit: true,//是否自动提交，即当选择了文件，自动关闭了选择窗口后，是否自动提交请求。
                onSubmit: function() {},//提交表单以前触发事件
                onComplete: function() {},//提交表单完成后触发的事件
                onSelect: function() {}//当用户选择了一个文件后触发事件
        });

注意：OCUpload只是在前台页面中把文件上传，上传以后须要在后台对文件进行解析，这里使用到了apache POI对excel文件进行解析。