JSP实用教程之简易文件上传组件的实现方法(附源码)
前言
本文主要给大家介绍的是关于JSP简易文件上传组件的实现方法,分享出来供大家参考学习,下面话不多说,来一起看看详细的介绍吧。
文件上传,包括但不限于图片上传,是 Web 开发中司空见惯的场景,相信各位或多或少都曾写过这方面相关的代码。Java 界若说文件上传,则言必称 Apache Commons FileUpload,论必及 SmartUpload。更甚者,Servlet 3.0 将文件上传列入 JSR 标准,使得通过几个注解就可以在 Servlet 中配置上传,无须依赖任何组件。使用第三方组件或 Servlet 自带组件固然强大,但只靠 JSP 亦能完成任务,且短小而精悍,岂不美哉?本文实现的方法纯然基于 JSP 代码,没有弄成 Servlet 和专门的 Class(.java),实现方法纯粹是基于 JSP,没有太高的技术难度。实际使用过程中直接部署即可。
操作组件的代码行数不超过 10 行,只需几个步骤:
- 生成组件实例
- 设置实例属性
- 调用上传/下载方法
- 处理调用结果
首先是上传页面,本例是一张静态的 HTML。
上传成功如下图所示。
使用 POST 的表单,设置 ContentType 为 multipart/form-data 多段数据,还要记得 input 的 name 属性。
<html> <body> <form action="action.jsp" enctype="multipart/form-data" method="POST"> selectimage: <input type="file" name="myfile" /><br> <input type="submit" value="upload" /> </form> </body> </html>
action 中接受客户端请求的服务端代码在 action.jsp 中。action.jsp 通过 <%@include file="Upload.jsp"%>
包含了核心 Java 代码,而 Upload.jsp 里面又包含了另外一个 UploadRequest.jsp 文件。总之,我们这个小小的 Java 程序,一共包含了 UploadRequest 请求信息类、UploadException 自定义异常类和最重要的 Upload 类这三个类。
<%@page pageEncoding="UTF-8"%> <%@include file="Upload.jsp"%> <% UploadRequest ur = new UploadRequest();// 创建请求信息,所有参数都在这儿设置 ur.setRequest(request); //一定要传入 request ur.setFileOverwrite(true);// 相同文件名是否覆盖?true=允许覆盖 Upload upload = new Upload();// 上传器 try { upload.upload(ur); } catch (UploadException e) { response.getWriter().println(e.toString()); } if (ur.isOk()) // 上传成功 response.getWriter().println("上传成功:" + ur.getUploaded_save_fileName()); else response.getWriter().println("上传失败!"); %>
这里创建了 UploadRequest 实例。文件上传操作通常会附加一些限制,如:文件类型、上传文件总大小、每个文件的最大大小等。除此以外,作为一个通用组件还需要考虑更多的问题, 如:支持自定义文件保存目录、支持相对路径和绝对路径、支持自定义保存的文件的文件名称等。这些配置通通在 UploadRequest 里设置。
至于 JSP 里面的类,我愿意多说说。 JSP 里面允许我们定义 Java 的类,类本是可以是 static,但不能有 static 成员。实际上 JSP 类都是内部类,定义 static 与否关系不大。如果不能定义 static 方法,就把 static 方法移出类体外,书写成,
<%! /** * 获取开头数据头占用的长度 * * @param dateBytes * 文件二进制数据 * @return */ private static int getStartPos(byte[] dateBytes) { .... } >
<%! ... %>
和 <% ... %>
不同,前者是定义类成员的。
好~我们在看看 UploadRequest.jsp,就知道具体配置些什么。
<%@page pageEncoding="UTF-8"%> <%!/** * 上传请求的 bean,包含所有有关请求的信息 * @author frank * */ public static class UploadRequest { /** * 上传最大文件大小,默认 1 MB */ private int MaxFileSize = 1024 * 1000; /** * 保存文件的目录 */ private String upload_save_folder = "E:\\temp\\"; /** * 上传是否成功 */ private boolean isOk; /** * 是否更名 */ private boolean isNewName; /** * 成功上传之后的文件名。如果 isNewName = false,则是原上传的名字 */ private String uploaded_save_fileName; /** * 相同文件名是否覆盖?true=允许覆盖 */ private boolean isFileOverwrite = true; private HttpServletRequest request; /** * @return the maxFileSize */ public int getMaxFileSize() { return MaxFileSize; } /** * @param maxFileSize the maxFileSize to set */ public void setMaxFileSize(int maxFileSize) { MaxFileSize = maxFileSize; } /** * @return the upload_save_folder */ public String getUpload_save_folder() { return upload_save_folder; } /** * @param upload_save_folder the upload_save_folder to set */ public void setUpload_save_folder(String upload_save_folder) { this.upload_save_folder = upload_save_folder; } /** * @return the isOk */ public boolean isOk() { return isOk; } /** * @param isOk the isOk to set */ public void setOk(boolean isOk) { this.isOk = isOk; } /** * @return the isNewName */ public boolean isNewName() { return isNewName; } /** * @param isNewName the isNewName to set */ public void setNewName(boolean isNewName) { this.isNewName = isNewName; } /** * @return the uploaded_save_fileName */ public String getUploaded_save_fileName() { return uploaded_save_fileName; } /** * @param uploaded_save_fileName the uploaded_save_fileName to set */ public void setUploaded_save_fileName(String uploaded_save_fileName) { this.uploaded_save_fileName = uploaded_save_fileName; } /** * @return the isFileOverwrite */ public boolean isFileOverwrite() { return isFileOverwrite; } /** * 相同文件名是否覆盖?true=允许覆盖 * @param isFileOverwrite the isFileOverwrite to set */ public void setFileOverwrite(boolean isFileOverwrite) { this.isFileOverwrite = isFileOverwrite; } /** * @return the request */ public HttpServletRequest getRequest() { return request; } /** * @param request the request to set */ public void setRequest(HttpServletRequest request) { this.request = request; } } %>
这是一个普通的 java bean。完成上传逻辑的是 Upload 类。
其原理是:
1、由客户端把要上传的文件生成 request 数据流,与服务器端建立连接;
2、在服务器端接收 request 流,将流缓存到内存中;
3、由服务器端的内存把文件输出到指定的目录。
Upload.jsp 完整代码如下所示。
<%@page pageEncoding="UTF-8" import="java.io.*"%> <%@include file="UploadRequest.jsp"%> <%! public static class UploadException extends Exception { private static final long serialVersionUID = 579958777177500819L; public UploadException(String msg) { super(msg); } } public static class Upload { /** * 接受上传 * * @param uRequest * 上传 POJO * @return * @throws UploadException */ public UploadRequest upload(UploadRequest uRequest) throws UploadException { HttpServletRequest req = uRequest.getRequest(); // 取得客户端上传的数据类型 String contentType = req.getContentType(); if(!req.getMethod().equals("POST")){ throw new UploadException("必须 POST 请求"); } if (contentType.indexOf("multipart/form-data") == -1) { throw new UploadException("未设置表单 multipart/form-data"); } int formDataLength = req.getContentLength(); if (formDataLength > uRequest.getMaxFileSize()) { // 是否超大 throw new UploadException("文件大小超过系统限制!"); } // 保存上传的文件数据 byte dateBytes[] = new byte[formDataLength]; int byteRead = 0, totalRead = 0; try(DataInputStream in = new DataInputStream(req.getInputStream());){ while (totalRead < formDataLength) { byteRead = in.read(dateBytes, totalRead, formDataLength); totalRead += byteRead; } } catch (IOException e) { e.printStackTrace(); throw new UploadException(e.toString()); } // 取得数据分割字符串 int lastIndex = contentType.lastIndexOf("="); // 数据分割线开始位置boundary=--------------------------- String boundary = contentType.substring(lastIndex + 1, contentType.length());// ---------------------------257261863525035 // 计算开头数据头占用的长度 int startPos = getStartPos(dateBytes); // 边界位置 int endPos = byteIndexOf(dateBytes, boundary.getBytes(), (dateBytes.length - startPos)) - 4; // 创建文件 String fileName = uRequest.getUpload_save_folder() + getFileName(dateBytes, uRequest.isNewName()); uRequest.setUploaded_save_fileName(fileName); File checkedFile = initFile(uRequest); // 写入文件 try(FileOutputStream fileOut = new FileOutputStream(checkedFile);){ fileOut.write(dateBytes, startPos, endPos - startPos); fileOut.flush(); uRequest.setOk(true); } catch (FileNotFoundException e) { e.printStackTrace(); throw new UploadException(e.toString()); } catch (IOException e) { e.printStackTrace(); throw new UploadException(e.toString()); } return uRequest; } } /** * 获取开头数据头占用的长度 * * @param dateBytes * 文件二进制数据 * @return */ private static int getStartPos(byte[] dateBytes) { int startPos; startPos = byteIndexOf(dateBytes, "filename=\"".getBytes(), 0); startPos = byteIndexOf(dateBytes, "\n".getBytes(), startPos) + 1; // 遍历掉3个换行符到数据块 startPos = byteIndexOf(dateBytes, "\n".getBytes(), startPos) + 1; startPos = byteIndexOf(dateBytes, "\n".getBytes(), startPos) + 1; return startPos; } /** * 在字节数组里查找某个字节数组,找到返回>=0,未找到返回-1 * @param data * @param search * @param start * @return */ private static int byteIndexOf(byte[] data, byte[] search, int start) { int index = -1; int len = search.length; for (int i = start, j = 0; i < data.length; i++) { int temp = i; j = 0; while (data[temp] == search[j]) { // System.out.println((j+1)+",值:"+data[temp]+","+search[j]); // 计数 j++; temp++; if (j == len) { index = i; return index; } } } return index; } /** * 如果没有指定目录则创建;检测是否可以覆盖文件 * * @param uRequest * 上传 POJO * @return * @throws UploadException */ private static File initFile(UploadRequest uRequest) throws UploadException { File dir = new File(uRequest.getUpload_save_folder()); if (!dir.exists()) dir.mkdirs(); File checkFile = new File(uRequest.getUploaded_save_fileName()); if (!uRequest.isFileOverwrite() && checkFile.exists()) { throw new UploadException("文件已经存在,禁止覆盖!"); } return checkFile; } /** * 获取 POST Body 中的文件名 * * @param dateBytes * 文件二进制数据 * @param isAutoName * 是否自定命名,true = 时间戳文件名 * @return */ private static String getFileName(byte[] dateBytes, boolean isAutoName) { String saveFile = null; if(isAutoName){ saveFile = "2016" + System.currentTimeMillis(); } else { String data = null; try { data = new String(dateBytes, "UTF-8"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); data = "errFileName"; } // 取得上传的文件名 saveFile = data.substring(data.indexOf("filename=\"") + 10); saveFile = saveFile.substring(0, saveFile.indexOf("\n")); saveFile = saveFile.substring(saveFile.lastIndexOf("\\") + 1, saveFile.indexOf("\"")); } return saveFile; } %>
通过 DataInputStream 读取流数据到 dataBytes 中然后写入 FileOutputStream。另外还有些围绕配置的逻辑。
值得一提的是,Tomcat 7 下 JSP 默认的 Java 语法仍旧是 1.6 的。在 JSP 里面嵌入 Java 1.7 特性的代码会抛出“Resource specification not allowed here for source level below 1.7”的异常。于是需要修改 Tomcat/conf/web.xml 里面的配置文件,找到 <servlet> 节点,加入下面粗体部分才可以。注意是 jsp 节点,不是 default 节点(很相似)。
<servlet> <servlet-name>jsp</servlet-name> <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class> <init-param> <param-name>fork</param-name> <param-value>false</param-value> </init-param> <init-param> <param-name>xpoweredBy</param-name> <param-value>false</param-value> </init-param> lt;strong> <init-param> <param-name>compilerSourceVM</param-name> <param-value>1.7</param-value> </init-param> <init-param> <param-name>compilerTargetVM</param-name> <param-value>1.7</param-value> </init-param></strong> <load-on-startup>3</load-on-startup> </servlet>
至此,一个简单的文件上传器就完成了。但是本组件的缺点还是很明显的,试列举两项:一、上传流占用内存而非磁盘,所以上传大文件时内存会吃紧;二、尚不支持多段文件上传,也就是一次只能上传一个文件。
源码下载:http://xiazai.jb51.net/201707/yuanma/SimpleUpload(jb51.net).rar
总结
以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流,谢谢大家对我们的支持。