入职java已经快2个月了。做了一个多月的改bug,6天的开发,刚做完一个文件上传,得好好整理下。

文件上传的大体思路其实是一样的,前端通过表单的方式上传,后端解析这个表单请求中的内容,得到文件部分的字段,再以流的形式读到内存中,后面怎么处理看业务了,比如保存到服务器等等。

一、前端
对于我这种前端ui等比较差的,果断选择了bootstrap为我撑撑场面。不会的可以搜一搜学一学,挺好用的。就是为你提供一些漂亮的样式,排版,自适应以及一些比较方便的插件。比如这个文件上传,基于bootstrap刚好有一个方便的fileinput。

先来秀一下效果

开源 java ITSM 开源 java 上传_上传


是不是挺漂亮的,实际上没有多少是靠我自己写的。

1)首先准备环境,你得有bootstrap环境,它依赖于jquery,这个你也是要的,有网络的童鞋可以直接使用cdn,没有的可以自行下载

<!-- 新 Bootstrap 核心 CSS 文件 -->
<link
    href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css"
    rel="stylesheet">
<script
    src="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap-theme.min.css"></script>
<script src="https://cdn.bootcss.com/jquery/2.1.1/jquery.min.js"></script>
<script
    src="https://cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>

接着是file input插件的环境,我是下载下来用的,下载地址为https://github.com/kartik-v/bootstrap-fileinput/archive/v4.4.3.zip
只需要两个文件,大家对号入座

<script src="XXXXXXXXX/fileinput.min.js"></script>
    <link
    href="XXXXXXXXXX/fileinput.min.css"
    rel="stylesheet">

2)使用,外面那个遮罩和框使用的是bootstrap的模态框,这里不介绍了。只说中间文件上传部分。

<input id="uploadfile" type="file" class="file file-loading">

没了,简介明了,你只要声明好它的class就好,多简单。

然后你在javascript中可以对它进行定制,比如我的需求是这样的:

//上传组件初始化
    $("#uploadfile").fileinput({
        language: 'zh', //设置语言
        uploadUrl: "${ctx}/dataModel/uploadModel", //上传的地址
        allowedFileExtensions: ['doc','docx'],//接收的文件后缀
        uploadAsync: true, //默认异步上传
        showUpload: true, //是否显示上传按钮

        showRemove : true, //显示移除按钮
        showPreview : true, //是否显示预览
        showCaption: true,//是否显示标题
        browseClass: "btn btn-primary", //按钮样式     
        dropZoneEnabled: false,//是否显示拖拽区域
        maxFileCount: 1, //表示允许同时上传的最大文件个数
        enctype: 'multipart/form-data',
        validateInitialCount:true,
        uploadExtraData: function(previewId, index) {   //额外参数
            var obj = {};
            obj.modelId = select.id;
            return obj;
        }
    });

同时上传完毕的回调

//异步上传返回结果处理
    $("#uploadfile").on("fileuploaded", function (event, data, previewId, index) {
            var response = data.response;
        //....
        });

前端到此结束

二、后端
后端你可以使用多种方式,我这使用的是SpringMVC,所以我的处理过程是写在Controller中的。

/**
     * 上传模型
     */
    @RequestMapping(value = "/uploadModel",method = RequestMethod.POST)
    @ResponseBody
    public Object uploadModel(HttpServletRequest request,HttpServletResponse response){
//      String dataPortalDir = request.getRealPath("");    //dataPortal路径
        String dataPortalDir = "/Users/cd/Downloads/dataPortalSt";    //dataPortal路径
        String cacheDir = "/files/cache";
        String htmlDir = "/files/html";
        Map<String, Object> json = new HashMap<String, Object>();
        ShiroHttpServletRequest shiroRequest = (ShiroHttpServletRequest) request;

        //转换为multipartrequest
        CommonsMultipartResolver commonsMultipartResolver = new CommonsMultipartResolver();  
        MultipartHttpServletRequest multipartRequest = commonsMultipartResolver.resolveMultipart((HttpServletRequest) shiroRequest.getRequest());  


        /** 页面控件的文件流* */
        MultipartFile multipartFile = null;
        Map map =multipartRequest.getFileMap();
         for (Iterator i = map.keySet().iterator(); i.hasNext();) {
                Object obj = i.next();
                multipartFile=(MultipartFile) map.get(obj);

               }

          //获取额外参数
               String modelId =  multipartRequest.getParameter("modelId");

        /** 获取文件的后缀* */
        String filename = multipartFile.getOriginalFilename();

        //拷贝文件
        InputStream inputStream;
        String htmlUrl = "";
        try {

            inputStream = multipartFile.getInputStream();
            String tmpFilePath = dataPortalDir+cacheDir+File.separator+UUIDUtil.getUUID()+
                    filename.substring(filename.lastIndexOf("."));
                    //保存到服务器
            tmpFilePath = FileUtil.copyInputStreamToFile(inputStream, tmpFilePath,false);

            System.out.println("copy file to:"+tmpFilePath);



        } catch (Exception e) {
            e.printStackTrace();
        }
        json.put("code", 0);
        json.put("message", "上传成功");
        json.put("result", htmlUrl);
        return json;
    }

这里有点小问题,就是一开始拿到的request并不是MultipartHttpServletRequest,而是ShiroHttpServletRequest。做了一次转换之后才可以。

第二个问题是额外参数,通过转换后是存放在MultipartHttpServletRequest的multiParam…中的,在后端获取的时候通过MultipartHttpServletRequest的getParameter(“modelId”);直接拿到。- -这个折腾了我一下午

2017.09.18
今天发现这个后台上传貌似还有点问题在里面,我们的request被搭框架的整了下,不再是ShiroHttpServletRequest,此时强转会发生错误。这里经过改写后的方法为:

@ResponseBody
    @RequestMapping(value = "upload")
    public DataResult<?> uploadFile(@RequestParam("file_data") MultipartFile uploadfile, 
            @RequestParam("modelId") String modelId) {
      //....可以发现参数直接拿到MultipartFile和modelId
    }

2017.09.20
今天发现file input在i.e.上兼容性不大好。ie9上都会出问题。没辙了,只能改写。改写过程中发现request不再是MultipartHttpServletRequest,有点泪奔,这是肿么了。
发现了一篇介绍的,看着挺完善的

SpringMVC默认是关闭fileupload功能的,开启该能够并验证文件上传,需要做如下几件事情:
第一:打开SpringMVC的文件上传功能:
***-servlet.xml中配置:
<bean id="multipartResolver"
    class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="100000"/>
    <property name="maxInMemorySize" value="10240" />
</bean>
配置后,当SpringMVC接受到multipartRequest的时候,就会把HttpServletRequest转为MultipartHttpServletRequest类型,
第二步:创建上传文件的file.jsp:
<form action="dynamicFields.action?method=uploadFile" method="post" enctype="multipart/form-data"><input type="file" name="myfile" id="myfile" value="" /><br/><input type="submit" value="确认提交"></form>
一定不要漏掉enctype="multipart/form-data",否则web容器认为这不是一个MultipartRequest请求,会报错org.springframework.web.multipart.MultipartException: The current request is not a multipart request。
第三步:Controller层创建代码:
@RequestMapping(params = {"method=uploadFile"})
public ModelAndView uploadFile(@RequestParam("myfile") MultipartFile myfile,
                                  HttpServletRequest request, HttpServletResponse response) throws Exception {
    if(!myfile.isEmpty()){
        logger.info(myfile.getName());
        byte[] bs= myfile.getBytes() ;
        logger.info(new String(bs));
    }
    return null;
}
部署web应用运行后,能够看到控制台中打印出上传文件的内容,BINGO搞定(SpringMVC依赖common-fileupload.jar,需要加载该jar包)

按理说应该是这样没跑了,可是我的还是有问题,明天继续改改看。request的类型变化真的好神奇- -。

2017.09.21上午
今天发现按照上面是对的。只不过这样是表单提交,表单提交会导致上传之后会发生页面跳转。禁止页面跳转的方式试了很多,网上说的那些都不大行,原因是他们是禁止了submit,相当于。这时候是不能上传的,要重新写上传。
经过多次查找资料,最后发现了一个好用的jquery-form,确实好用,官网http://malsup.com/jquery/form/.可以兼容到ie8,它的example中还提供了fileupload的例子http://malsup.com/jquery/form/progress.html
用法很简单,几个回调清晰明了,如下:

$('form').ajaxForm({
         beforeSend: function() {
             var percentVal = '0%';
             bar.width(percentVal)
             percent.html(percentVal);
         },
         uploadProgress: function(event, position, total, percentComplete) {
             var percentVal = percentComplete + '%';
             bar.width(percentVal)
             percent.html(percentVal);
         },
         success: function() {
             var percentVal = '100%';
             bar.width(percentVal)
             percent.html(percentVal);
         },
        complete: function(xhr) {

        }
     });

这样就完成了对ie9的兼容,当然上传界面只能自己写写了。

2017.09.21下午
发现这个上传里面的坑还不少。今天上传一个文档的时候出来这么一个异常:

org.springframework.web.multipart.MultipartException: Could not parse multipart servlet request; 
nested exception is java.io.IOException: 
org.apache.tomcat.util.http.fileupload.FileUploadBase$IOFileUploadException: Processing of multipart/form-data request failed. 
/upload_760aac73_045e_4c42_8f13_c36ad1041276_00000015.tmp (Permission denied)] with root cause
java.io.FileNotFoundException: /upload_760aac73_045e_4c42_8f13_c36ad1041276_00000015.tmp (Permission denied)

可以看出分成了两个tmp,目测是由于文件超过定义好的2M大小时,会被分成多块上传,上面两个则是分成的两个缓存文件。这个时候怎么处理?

经过多番查证这个问题是这样的,

参考1:
从Spring3.1开始,Spring提供了CommonsMultipartResolver
和StandardServletMultipartResolver处理multipart请求。

参考2:
该文中使用CommonsMultipartResolver处理multipart请求,出现了跟我一样的问题。配置中的maxInMemorySIze 是文件上传的时候写到内存中的最大值,默认是10240字节,如果这里写大了,那么小于这个参数的文件则不会创建临时文件。

而我们使用了StandardServletMultipartResolver,以此类推在配置文件web.xml中

<multipart-config>
            <location>/</location>
            <max-file-size>20848820</max-file-size>
            <max-request-size>418018841</max-request-size>
            <file-size-threshold>1048576</file-size-threshold>
        </multipart-config>

由于这里的file-size-threshold是1M左右,当我的文件大于这个阀值,就会保存到临时文件upload_xxx.tmp中,而这个文件是存放在location中的。所以解决办法出来了,增大阀值必然是可以的,不过不是根本办法。根本解决办法是location配置到有权限的文件夹中。dalao支了一招,直接去掉location配置,使用默认的location就没有权限问题了。

2017.09.22凌晨
今天上班的时候碰到一个奇葩问题,关于表单提交的,以前好好的一个可以用的项目,突然在表单提交的时候后台取不到参数值了。entype采用的是默认的,如果采用multipart编码就可以拿到。由于很多地方都是这样的,没法一个个加,特别有的还是用ajax,jquery的load等方式。
终于在2点多的时候解决了。环境问题- -,全部换成现在用的javase-1.8就好了。无语,睡觉了。