热门标签 | HotTags
当前位置:  开发笔记 > 前端 > 正文

JSP实用教程之简易文件上传组件的实现方法(附源码)

文件上传是我们在日常开发中经常遇到的一个功能,下面这篇文章主要给大家介绍了关于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 属性。

 
 
  
  selectimage: 

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 =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  

通过 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 里面的配置文件,找到 节点,加入下面粗体部分才可以。注意是 jsp 节点,不是 default 节点(很相似)。

 
  jsp 
  org.apache.jasper.servlet.JspServlet 
   
   fork 
   false 
   
   
   xpoweredBy 
   false 
   
lt;strong>   
   compilerSourceVM 
   1.7 
   
   
   compilerTargetVM 
   1.7 
   
  3 
  

至此,一个简单的文件上传器就完成了。但是本组件的缺点还是很明显的,试列举两项:一、上传流占用内存而非磁盘,所以上传大文件时内存会吃紧;二、尚不支持多段文件上传,也就是一次只能上传一个文件。

源码下载:http://xiazai.jb51.net/201707/yuanma/SimpleUpload(jb51.net).rar

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流,谢谢大家对的支持。


推荐阅读
author-avatar
完颜777_870
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有