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

总结

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

(0)

相关推荐

  • jsp按格式导出doc文件实例详解

    jsp按格式导出doc文件实例详解 原理:doc文件其实可以保存为xml文件,该xml文件用字符串表示了doc文件的表现形式,我们只需要用Java将那些要填的内容替换掉然后下载给客户就行了. 1.首先是按照你的文档填写好数据. 2.将文档另存为xml文件,然后编辑该xml文件,将填好的内容用某种格式替换,如:将名字张三替换成${name} 3.读取文件,将文件中的${name}替换成真正的名字. 4.下载. 接下来看代码: 首先是那个转换类 package com.my.util; import

  • 运用JSP+ajax实现分类查询功能的实例代码

    本文主要是介绍了运用JSP+ajax实现分类查询功能的实例代码,分享给大家供大家参考,具体如下: 这次是对小学期关于大学毕业生信息管理系统课程设计中遇到的一些问题和解决方法进行记录和分享. 题目要求:提供企业招聘信息(本年度或历年)查询功能: 首先建立一个jsp文件用来显示数据库信息,并在上面加输入条件的文本框和查询按钮,在这个jsp文件中需要完成一个js函数在用于完成查询功能. <%@ page language="java" pageEncoding="UTF-8&

  • JSP中springmvc配置validator的注意事项

    SpringMVC介绍之Validation 对于任何一个应用而言在客户端做的数据有效性验证都不是安全有效的,这时候就要求我们在开发的时候在服务端也对数据的有效性进行验证.SpringMVC自身对数据在服务端的校验有一个比较好的支持,它能将我们提交到服务端的数据按照我们事先的约定进行数据有效性验证,对于不合格的数据信息SpringMVC会把它保存在错误对象中,这些错误信息我们也可以通过SpringMVC提供的标签在前端JSP页面上进行展示. 关于springmvc配置validator的注意事项

  • 详解SpringBoot集成jsp(附源码)+遇到的坑

    本文介绍了SpringBoot集成jsp(附源码)+遇到的坑 ,分享给大家 1.大体步骤 (1)创建Maven web project: (2)在pom.xml文件添加依赖: (3)配置application.properties支持jsp (4)编写测试Controller (5)编写JSP页面 (6)编写启动类App.java 2.新建SpringInitialzr 3.pom文件 <dependencies> <dependency> <groupId>org.s

  • JSP实用教程之简易图片验证码的实现方法(附源码)

    前言 很多新手对图片验证码不是很了解,所以本文尝试通过一个简单的 JSP 小程序来实现验证码功能.文中给出了详细的示例代码,文末给出了完整实例代码的下载地址,下面话不多说了,来一起看看详细的介绍吧. 效果图 示例代码 前台代码如下: <form action="action.jsp" method="POST"> <label> 用户名: <input type="text" name="name"

  • JSP 开发之Spring Boot 动态创建Bean

    JSP 开发之Spring Boot 动态创建Bean 1.通过注解@Import导入方式创建 a.新建MyImportBeanDefinitionRegistrar注册中心 Java代码 import org.springframework.beans.factory.support.BeanDefinitionRegistry; import org.springframework.beans.factory.support.GenericBeanDefinition; import org

  • jsp页面验证码完整实例

    本文实例为大家分享了sp页面验证码的具体代码,供大家参考,具体内容如下 项目结构如下,MyEclipse中新建一个Web Project,取名servlet 1.src下new一个servlet类 package com.servlet; import java.awt.Color; import java.awt.Font; import java.awt.Graphics2D; import java.awt.image.BufferedImage; import java.io.IOExc

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

    前言 本文主要给大家介绍的是关于JSP简易文件上传组件的实现方法,分享出来供大家参考学习,下面话不多说,来一起看看详细的介绍吧. 文件上传,包括但不限于图片上传,是 Web 开发中司空见惯的场景,相信各位或多或少都曾写过这方面相关的代码.Java 界若说文件上传,则言必称 Apache Commons FileUpload,论必及  SmartUpload.更甚者,Servlet 3.0 将文件上传列入 JSR 标准,使得通过几个注解就可以在 Servlet 中配置上传,无须依赖任何组件.使用第

  • 自动写入文件上传到指定服务器SoftwareMeteringCLS.vbs源码

    复制代码 代码如下: ' FileName: SoftwareMeteringCLS.vbs ' //////////////////////////////////////////////////////////////////// If (WScript.ScriptName = "SoftwareMeteringCLS.vbs") Then Call demo_SoftwareMeteringCLS() ' ====================================

  • Java Socket+mysql实现简易文件上传器的代码

    最近跟着某网站学习了一个小项目,因为白天有课,所以都是晚上写的,今天把它完成了. 项目主要是实现一个文件上传器,通过客户端的登陆,把本地文件上传到服务器的数据库(本地的). 首先建两个表如下: 一个文件信息表 CREATE TABLE `fileinfo` ( `Fname` char(50) NOT NULL, `FInfo` blob NOT NULL, `FId` int(10) NOT NULL AUTO_INCREMENT, PRIMARY KEY (`FId`) ) ENGINE=I

  • JavaBean实现多文件上传的两种方法

    摘要:本文介绍了JavaBean实现多个文件上传的两种方法,分别是使用http协议和ftp协议实现.首先讲述了http协议传送多个文件的基本格式和实现上传的详细过程,之后简单介绍了使用ftpclient 类实现了ftp方式的上传,最后对这两种方法进行了比较. 关键字:JavaBean .http .ftp .ftpclient JavaBean是一种基于Java的软件组件.JSP对于在Web 应用中集成JavaBean组件提供了完善的支持.这种支持不仅能缩短开发时间(可以直接利用经测试和可信任的

  • JavaWeb实现文件上传与下载的方法

    文件上传概述 实现web开发中的文件上传功能,需完成如下二步操作: 在web页面中添加上传输入项 在servlet中读取上传文件的数据,并保存到本地硬盘中. 如何在web页面中添加上传输入项? <input type="file">标签用于在web页面中添加文件上传输入项,设置文件上传输入项时须注意: 1.必须要设置input输入项的name属性,否则浏览器将不会发送上传文件的数据. 2.必须把form的enctype属值设为multipart/form-data.设置该值

  • JavaServlet的文件上传和下载实现方法

    先分析一下上传文件的流程 1-先通过前段页面中的选择文件选择要上传的图片 index.jsp <%@ page language="java" import="java.util.*" pageEncoding="utf-8" contentType="text/html; charset=UTF-8"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 T

  • Java文件上传与文件下载实现方法详解

    本文实例讲述了Java文件上传与文件下载实现方法.分享给大家供大家参考,具体如下: Java文件上传 数据上传是客户端向服务器端上传数据,客户端向服务器发送的所有请求都属于数据上传.文件上传是数据上传的一种特例,指客户端向服务器上传文件.即将保存在客户端的文件上传一个副本到服务器,并保存在服务器中. 1.上传表单要求 文件上传要求客户端提交特殊的请求--multipart请求,即包含多部分数据的请求.必须将<form/>标签的enctype属性值设为"multipart/form-d

  • php文件上传原理与实现方法详解

    本文实例讲述了php文件上传原理与实现方法.分享给大家供大家参考,具体如下: 文件上传实际上就是在前段使用一个form表单提交本地文件到服务器,然后在服务器端将文件从临时目录转移到指定目录的过程. 1.php配置文件 php.ini文件中的file uploads部分定义了相关文件上传配置, file_uploads = On 打开文件上传 upload_tmp_dir =临时目录 upload_max_filesize = 2M最大上传大小 max_file_uploads = 20单次最大上

  • Bootstrap fileinput文件上传组件使用详解

    一.使用方法 1.导入依赖的js和css文件: <link rel="stylesheet" href="css/bootstrap.min.css" /> <link rel="stylesheet" href="css/fileinput.min.css" /> <script type="text/javascript" src="js/jquery-3.2.1

  • Servlet实现文件上传的三种方法总结

    Servlet实现文件上传的三种方法总结 1. 通过getInputStream()取得上传文件. /** * To change this template, choose Tools | Templates * and open the template in the editor. */ package net.individuals.web.servlet; import java.io.DataInputStream; import java.io.FileOutputStream;

随机推荐