Java文件上传细讲(java如何上传文件到服务器)
ztj100 2025-07-09 18:38 4 浏览 0 评论
什么是文件上传?
文件上传就是把用户的信息保存起来。
为什么需要文件上传?
在用户注册的时候,可能需要用户提交照片。那么这张照片就应该要进行保存。
上传组件(工具)
为什么我们要使用上传工具?
为啥我们需要上传组件呢?当我们要获取客户端的数据,我们一般是通过getParameter()方法来获取的。
上传文件数据是经过MIME协议进行分割的,表单进行了二进制封装。也就是说:getParameter()无法获取得到上传文件的数据。
我们首先来看看文件上传http是怎么把数据带过去的
- jsp页面,表单一定要指定enctype:multipart/form-data
<form action="${pageContext.request.contextPath }/servlet/UploadServlet1" enctype="multipart/form-data" method="post">
上传用户:<input type="text" name="username"><br/>
上传文件1:<input type="file" name="file1"><br/>
上传文件2:<input type="file" name="file2"><br/>
<input type="submit" value="提交">
</form>
- http抓包
- 尝试在Servlet上使用getParameter()获取数据
String ss = request.getParameter("username");
System.out.println(ss);
- 直接使用getParameter是获取不到数据的。
那么我们要怎么办呢????request对象提供了ServletInputStream流给我们读取数据
- 我们试着读取下文件
ServletInputStream inputStream = request.getInputStream();
byte[] bytes = new byte[1024];
int len = 0;
while ((len = inputStream.read(bytes)) > 0) {
System.out.println(new String(bytes, 0, len));
}
- 在jsp页面多增添一个input控件
<input type="text" name="password">
- 我上传的文本文件内容就是111111,读取效果如下:
现在我们能够读取上传文件的数据了,但是现在问题又来了怎么把文件上传个数据和普通传送给服务器的数据分割开来呢?.上面在图上我们已经看到了,他们是混合在一起的。
按我们平常的做法是很难分割开来的,所以我们需要上传组件
上传组件有两种
- FileUpload【操作比较复杂】
- SamrtUpload【操作比较简单】
FileUpload
要使用FileUpload组件,就需要导入两个jar包
- commons-io
- Commons-fileupload
开发步骤
- 创建解析器工厂对象【DiskFileItemFactory】
- 通过解析器工厂创建解析器【ServletFileUpload】
- 调用解析器方法解析request对象,得到所有上传的内容【list】
- 遍历list,判断每个对象是否是上传文件
- 如果是普通表单字段,得到字段名和字段值
- 如果是上传文件,调用InputSteam方法得到输入流,读取上传的数据
快速入门
try{
//1.得到解析器工厂
DiskFileItemFactory factory = new DiskFileItemFactory();
//2.得到解析器
ServletFileUpload upload = new ServletFileUpload(factory);
//3.判断上传表单的类型
if(!upload.isMultipartContent(request)){
//上传表单为普通表单,则按照传统方式获取数据即可
return;
}
//为上传表单,则调用解析器解析上传数据
List<FileItem> list = upload.parseRequest(request); //FileItem
//遍历list,得到用于封装第一个上传输入项数据fileItem对象
for(FileItem item : list){
if(item.isFormField()){
//得到的是普通输入项
String name = item.getFieldName(); //得到输入项的名称
String value = item.getString();
System.out.println(name + "=" + value);
}else{
//得到上传输入项
String filename = item.getName(); //得到上传文件名 C:\Documents and Settings\ThinkPad\桌面\1.txt
filename = filename.substring(filename.lastIndexOf("\\")+1);
InputStream in = item.getInputStream(); //得到上传数据
int len = 0;
byte buffer[]= new byte[1024];
String savepath = this.getServletContext().getRealPath("/upload");
FileOutputStream out = new FileOutputStream(savepath + "\\" + filename); //向upload目录中写入文件
while((len=in.read(buffer))>0){
out.write(buffer, 0, len);
}
in.close();
out.close();
}
}
}catch (Exception e) {
e.printStackTrace();
}
测试
- 普通的字段和上传的文件都能读取得到了!
SmartUpload
要使用SmartUpload组件,就需要导入smartupload.jar开发包
快速入门免费学习资料获取方式
//实例化组件
SmartUpload smartUpload = new SmartUpload();
//初始化上传操作
smartUpload.initialize(this.getServletConfig(), request, response);
try {
//上传准备
smartUpload.upload();
//对于普通数据,单纯到request对象是无法获取得到提交参数的。也是需要依赖smartUpload
String password = smartUpload.getRequest().getParameter("password");
System.out.println(password);
//上传到uploadFile文件夹中
smartUpload.save("uploadFile");
} catch (SmartUploadException e) {
e.printStackTrace();
}
测试
同样地,我们可以上传文件到uploadFile文件夹中。代码量也的确减少很多!
也能够获取普通字段的参数
上传文件名的中文乱码和上传数据的中文乱码
- 我把文件名改成中文,就乱码了:
- 表单提交过来的中文数据也乱码了。
上面已经说了,上传文件的数据的表单进行了二进制封装,所以使用request对数据编码编码,对于表单提交过来的数据是不奏效的!
FileUpload解决乱码
使用FileUpload解决乱码问题是十分简单的
- 解决中文文件名乱码,得到解析器以后,就直接设置解析器的编码为UTF-8就行了!
//设置upload的编码
fileUpload.setHeaderEncoding("UTF-8");
- 解决表单数据乱码,在获取表单值的时候,按照UTF-8编码来获取
String value = fileItem.getString("UTF-8");
效果:
SmartUpload解决乱码
这个组件解决乱码问题有点麻烦,在网上找了各种办法也没找到简单的......
所以,如果数据不涉及到中文就使用SmartUpload组件,涉及到中文数据就使用FileUpload组件吧!
多个文件上传,动态添加上传控件
假设我现在有多个文件要上传,而且要上传的个数是不确定的。那么我们要怎么办呢???
我们不可能列出很多很多个上传文件的控件在页面上,这样不美观。如果用户用不到那么多个控件,也浪费呀。
所以,我们想要动态地增添上传文件的控件,如果用户还想要上传文件,只需要动态地生成控件出来即可!
分析
要想在页面上动态地生成控件,无非就是使用JavaScript代码。
那么我们要怎么做呢??
这样子吧:当用户想要上传文件的时候,就点击按钮,按钮绑定事件,生成文件上传的控件。
为了做得更加完善,每当生成了文件上传的控件,也提供一个删除按钮,删除该控件!
我们应该使用div装载着我们要生成的控件和删除按钮,而用户点击删除的时候,应该是要把删除按钮和文件上传控件都一起隐藏起来的。所以,最好就是使用嵌套div!
代码
- 页面代码:
<table border="1px">
<tr>
<td>上传用户:</td>
<td><input type="text" name="username"></td>
</tr>
<tr>
<td>添加上传文件</td>
<td><input type="button" value="添加上传文件" onclick="addUploadFile()"> </td>
</tr>
<tr>
<td>
<div id="file">
</div>
</td>
</tr>
</table>
- javaScript代码
<script type="text/javascript">
function addUploadFile() {
//生成文件上传控件
var input = document.createElement("input");
input.type = 'file';
input.name = 'fileName';
//生成删除按钮
var del = document.createElement("input");
del.type = 'button';
del.value = '删除';
//生成内部的div
var innerDiv = document.createElement("div");
//将两个控件绑定到内部div上
innerDiv.appendChild(input);
innerDiv.appendChild(del);
//得到外部div控件,并将内部div绑定到外部div上
var outterDiv = document.getElementById("file");
outterDiv.appendChild(innerDiv);
//为删除按钮绑定事件
del.onclick = function dele() {
//调用外界div的remove方法把内部的div干掉
this.parentNode.parentNode.removeChild(this.parentNode);
}
}
</script>
文件上传细节
- 如果上传文件的大小大于我们设定文件的大小,那么文件在上传的时候会使用临时文件保存上传数据。在上传完毕后,我们应该删除临时文件
- 上传文件的位置是不能在WEB服务器管理之下的,否则可能造成安全问题【其他人有可能通过手段来修改上传文件】
- 如果上传文件名相同,那么就会把原本的上传文件覆盖掉。我们要生成一个独一无二的文件名。
- 如果用户量很大,上传文件非常多。那么我们不应该在一个目录保存所有的上传文件,这样很可能造成磁盘奔溃了。所以我们要把上传的文件打散到不同的目录下。
分析
删除临时文件问题是非常简单的,只需要在所有的操作完毕之后,调用FileItem的delete()方法即可
让上传文件的位置不能在WEB服务器管理之下,我们把上传文件的位置放到WEB-INF/目录下即可!
文件名相同的问题,我们可以使用UUID+用户上传的文件名来作为我们保存上传文件名。这样的文件名就是独一无二的了。
要将上传的文件进行打散,那么我们需要使用HashCode算法来进行打散。
- 低四位生成一级目录
- 5-8位生成二级目录
代码
下面我们写一个比较完善的上传文件代码
- 使用hashCode算法来打散保存的目录
private String makeDirPath(String fileName, String path) {
//通过文件名来算出一级目录和二级目录
int hashCode = fileName.hashCode();
int dir1 = hashCode & 0xf;
int dir2 = (hashCode & 0xf0) >> 4;
String dir = path + "\\" + dir1 + "\\" + dir2;
//如果该目录不存在,就创建目录
File file = new File(dir);
if (!file.exists()) {
file.mkdirs();
}
//返回全路径
return dir;
}
- 生成独一无二的文件名
private String makeFileName(String fileName) {
//使用下划线把UUID和文件名分割开来,后面可能会解析文件名的。
return UUID.randomUUID().toString() + "_"+ fileName;
}
- 上传的代码
//创建工厂
DiskFileItemFactory factory = new DiskFileItemFactory();
//通过工厂创建解析器
ServletFileUpload fileUpload = new ServletFileUpload(factory);
//设置upload的编码
fileUpload.setHeaderEncoding("UTF-8");
//判断上传表单的类型
if(!fileUpload.isMultipartContent(request)){
//上传表单为普通表单,则按照传统方式获取数据即可
return;
}
try {
//解析request对象,得到List【装载着上传的全部内容】
List<FileItem> list = fileUpload.parseRequest(request);
//遍历List,判断装载的内容是普通字段还是上传文件
for (FileItem fileItem : list) {
//如果是普通输入项
if (fileItem.isFormField()) {
//得到输入项的名称和值
String name = fileItem.getFieldName();
String value = fileItem.getString("UTF-8");
System.out.println(name + " = " + value);
} else {
//如果是上传文件
//得到上传名称【包括路径名】
String fileName = fileItem.getName();
//截取文件名
fileName = fileName.substring(fileName.lastIndexOf("\\") + 1);
//生成独一无二的文件名
fileName = makeFileName(fileName);
InputStream inputStream = fileItem.getInputStream();
//得到项目的路径,把上传文件写到项目中
String path = this.getServletContext().getRealPath("/WEB-INF/uploadFile");
//得到分散后的目录路径
String realPath = makeDirPath(fileName, path);
FileOutputStream outputStream = new FileOutputStream(realPath + "\\" + fileName);
byte[] bytes = new byte[1024];
int len = 0;
while ((len = inputStream.read(bytes)) > 0) {
outputStream.write(bytes, 0, len);
}
inputStream.close();
outputStream.close();
//删除临时文件的数据
fileItem.delete();
}
}
} catch (FileUploadException e) {
e.printStackTrace();
}
效果:
- 成功把目录打散,文件名也是独一无二的了。
列出上传目录下的文件,提供下载
在讲解respose对象的时候已经讲解过文件下载了。这次我们就直接写一个小案例来巩固文件下载把。
- 上传目录下的文件有3个
分析
首先,要把目录下的文件都列出来。由于后面要根据文件名对文件进行下载,所以我们用一个Map集合来保存所有的文件
下载文件部分也很简单,根据文件名和上传文件位置找到对应的文件,对其进行读写,然后修改消息头实现下载就好了。
- 得到装载上传文件的路径,通过递归把所有的文件都查找出来(判断是否是文件就是递归出口),装载到Map集合中
- 将Map集合传到前台做展示
- 用户点击下载的时候,再根据原名来获取绝对路径
- 如果该资源是存在的,就允许用户下载
代码
- 将存放在WEB-INF/目录下的文件全部放在Map集合中
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
//得到上传文件的目录
String filePath = this.getServletContext().getRealPath("/WEB-INF/uploadFile");
Map map = new HashMap();
//使用递归来得到所有的文件,并添加到Map集合中
getAllFiles(new File(filePath), map);
request.setAttribute("map", map);
request.getRequestDispatcher("/listFile.jsp").forward(request, response);
}
private void getAllFiles(File filePath, Map map) {
//如果不是文件,那么它就是文件夹
if (!filePath.isFile()) {
//列出文件夹下所有的文件(可能是文件,可能是文件夹)
File[] files = filePath.listFiles();
for (File file : files) {
//得到的文件(或者是文件夹)再对其进行判断
getAllFiles(file, map);
}
} else {
//进入到else语句了,肯定是文件了
//得到文件名
String fileName = filePath.getName().substring(filePath.getName().lastIndexOf("_") + 1);
//我们将文件全名作为key,文件名作为value保存在map集合中
map.put(filePath.getName(), fileName);
}
}
- 在JSP页面中显示可以下载的文件
<c:forEach items="${map}" var="me">
<c:url var="url" value="/DownFileServlet">
<c:param name="fileName" value="${me.key}"></c:param>
</c:url>
${me.value}<a href="${url}">下载!</a><br>
</c:forEach>
- 实现下载的Servlet
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
//得到文件的全名
String fileName = request.getParameter("fileName");
//如果是中文数据,需要转码。
fileName = new String(fileName.getBytes("ISO8859-1"), "utf-8");
//得到保存文件的位置
String path = this.getServletContext().getRealPath("/WEB-INF/uploadFile");
//文件是通过文件名进行hashCode打散保存的,通过文件名拿到文件绝对路径
String fileRealPath = makeFilePath(fileName, path);
System.out.println(fileRealPath);
//判断文件是否存在
File file = new File(fileRealPath);
if (!file.exists()) {
request.setAttribute("message", "您要下载的资源不存在了!");
request.getRequestDispatcher("/message.jsp").forward(request, response);
return ;
}
//存在
//读取该文件并把数据写给浏览器
FileInputStream inputStream = new FileInputStream(fileRealPath);
byte[] bytes = new byte[1024];
int len = 0;
while ((len = inputStream.read(bytes)) > 0) {
response.getOutputStream().write(bytes, 0, len);
}
inputStream.close();
//设置消息头,告诉浏览器,这是下载的文件
String name = fileName.substring(fileName.lastIndexOf("_") + 1);
response.setHeader("content-disposition","attachment;filename=" + URLEncoder.encode(name, "UTF-8"));
}
private String makeFilePath(String fileName, String path) {
int hashCode = fileName.hashCode();
int dir1 = hashCode & 0xf;
int dir2 = (hashCode & 0xf0) >> 4;
String dir = path + "\\" + dir1 + "\\" + dir2 +"\\"+ fileName;
return dir;
}
效果
如果文章有错的地方欢迎指正,大家互相交流。免费学习资料获取方式
相关推荐
- 前端案例·程序员的浪漫:流星雨背景
-
如果文章对你有收获,还请不要吝啬【点赞收藏评论】三连哦,你的鼓励将是我成长助力之一!谢谢!(1)方式1:简单版本【1】先看实现效果...
- UI样式iPod classic的HTML本地音乐播放器框架
-
PS:音量可以鼠标点击按住在音量图标边的轮盘上下拖拽滑动音量大小中心按钮可以更改播放器为白色...
- JavaScript 强制回流问题及优化方案
-
JavaScript代码在运行过程中可能会强制触发浏览器的回流(Reflow)...
- Ai 编辑器 Cursor 零基础教程:推箱子小游戏实战演练
-
最近Ai火的同时,Ai编辑器Cursor同样火了一把。今天我们就白漂一下Cursor,使用免费版本搞一个零基础教程...
- 19年前司机被沉尸水库!凶手落网,竟已是身家千万的大老板
-
]|\[sS])*"|'(?:[^\']|\[sS])*'|[^)}]+)s*)/g,l=window.testenv_reshost||window.__moon_host||"res.wx.qq...
- 全民健身网络热度调查“居家健身”成为第一网络热词
-
]|\[sS])*"|'(?:[^\']|\[sS])*'|[^)}]+)s*)/g,l=window.testenv_reshost||window.__moon_host||"res.wx.qq...
- 取代JavaScript库的10个现代Web API及详细实施代码
-
为什么浏览器内置的API你还在用某个臃肿的Javascript库呢?用内置的API有什么好处呢?Web平台经历了巨大演进,引入了强大的原生API,不再需要臃肿的JavaScript库。现代浏览器现已支...
- 前端文件下载的N种姿势:从简单到高级
-
文件下载是web开发里一个非常常见的功能,无论是下载用户生成的数据、图片、文档还是应用程序包。前端开发者有多种方式来实现这一需求,每种方式都有其适用场景和优缺点。介绍下几种比较常用的文件下载方法。...
- JavaScript 性能优化方法(js前端性能优化)
-
JavaScript性能优化方法减少DOM操作频繁的DOM操作会导致浏览器重绘和回流,影响性能。使用文档片段(DocumentFragment)或虚拟DOM技术减少直接操作。...
- DOM节点的创建、插入、删除、查找、替换
-
在前端开发中,js与html联系最紧密的莫过于对DOM的操作了,本文为大家分享一些DOM节点的基本操作。一、创建DOM节点使用的命令是varoDiv=document.createElement...
- 前端里的拖拖拽拽(拖拽式前端框架)
-
最近在项目中使用了react-dnd,一个基于HTML5的拖拽库,“拖拽能力”丰富了前端的交互方式,基于拖拽能力,会扩展各种各样的拖拽反馈效果,因此有必要学习了解,最好的学习方式就是实操!...
- 大模型实战:Flask+H5三件套实现大模型基础聊天界面
-
本文使用Flask和H5三件套(HTML+JS+CSS)实现大模型聊天应用的基本方式话不多说,先贴上实现效果:流式输出:思考输出:聊天界面模型设置:模型设置会话切换:前言大模型的聊天应用从功能...
- SSE前端(sse前端数据)
-
<!DOCTYPEhtml><htmllang="zh-CN"><head>...
- 课堂点名总尴尬?试试 DeepSeek,或能实现点名自由!(附教程)
-
2025年2月26日"你有没有经历过这样的场景?老师拿着花名册扫视全班:'今天我们来点名...'那一刻心跳加速,默念:'别点我!'但现在,我要...
- 我会在每个项目中复制这10个JS代码片段
-
你是否也有这种感觉:在搭建新项目时,你会想:"这个函数我是不是已经写过了...在某个地方?"是的——我也是。所以在开发了数十个React、Node和全栈应用后,我不再重复造轮子。我创建...
你 发表评论:
欢迎- 一周热门
- 最近发表
- 标签列表
-
- idea eval reset (50)
- vue dispatch (70)
- update canceled (42)
- order by asc (53)
- spring gateway (67)
- 简单代码编程 贪吃蛇 (40)
- transforms.resize (33)
- redisson trylock (35)
- 卸载node (35)
- np.reshape (33)
- torch.arange (34)
- npm 源 (35)
- vue3 deep (35)
- win10 ssh (35)
- vue foreach (34)
- idea设置编码为utf8 (35)
- vue 数组添加元素 (34)
- std find (34)
- tablefield注解用途 (35)
- python str转json (34)
- java websocket客户端 (34)
- tensor.view (34)
- java jackson (34)
- vmware17pro最新密钥 (34)
- mysql单表最大数据量 (35)