一 、文件上传
- method 需要使用 post 提交,get 限制了数据大小。
- enctype 需使用 multipart/form-data,不然直接报错(需要二进制数据)。
- 需要提供 fifile 控件。
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<span style="color: red">${errorMsg}</span><br/>
<form action="/fileType" method="post" enctype="multipart/form-data">
<p>账号:<input type="text" name="username"/></p>
<%--input 便签 type选择file 即选择了一个上传文件控件--%>
<p>头像:<input type="file" name="Default"/></p>
<input type="submit" value="注册">
</form>
</body>
</html>
复制代码
注意: enctype="multipart/form-data" 提交的数据,getParameter() 无法获取到。
二、Servlet3.0 文件上传
1. API
HttpServletRequest 提供了两个方法用于从请求中解析上传的文件
返回值 | 方法 | 作用 |
---|---|---|
Part | getPart(String name) | 用于获取请求中指定 name 的文件 |
Collection | getParts() | 获取请求中全部的文件 |
Part 中常用方法:
返回值 | 方法 | 作用 |
---|---|---|
void | write(String fifileName) | 直接把接收到的文件保存到磁盘中 |
void | getContentType() | 获取文件的类型 MIME |
String | getHeader(String name) | 获取请求头信息 |
long | getSize() | 获取文件的大小 |
要给 Servlet 贴一个标签 @MultipartConfig 然后使用 getPart() 获取请求中指定 name 的文件到 Part 对象中,再使用 write 方法把文件保存到指定目录就可以了
2、代码示例
@WebServlet("/fileUpload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 普通控件数据还是使用 getParameter 方法来获取
System.out.println("username:" + req.getParameter("username"));
// 文件控件数据获取
Part part = req.getPart("headImg");
// 保存到磁盘上
part.write("D:/headImg.png");
}
}
复制代码
三、文件上传细节
1. 获取上传文件名
以前是拷贝文件(自传自存),知道文件类型;现在是用户传,程序接收,接收到文件时,涉及保存到磁盘使用什么文件名以及文件类型的问题,所有需要先获取到文件名及文件类型。可使用 Part API 获取:
返回值 | 方法 | 作用 |
---|---|---|
String | getHeader("contentdisposition") | Tocmat 8.0 之前使用通过请求头获取文件名,需截取字符串 |
String | getSubmittedFileName() | Tomcat8.0 之后提供的直接获取文件名方式 |
2. 文件名相同覆盖现有文件
若上传得文件名相同会导致覆盖服务器之前已上传的的文件,咱们的解决方法就是自己给文件起一个唯一的名称,确保不被覆盖,这里我们使用的是 UUID。
// 文件控件数据获取
Part part = req.getPart("headImg");
// 获取上传文件名
String realFileName = part.getSubmittedFileName();
// 获取上传文件扩展名
String ext = realFileName.substring(realFileName.lastIndexOf("."));
// 生成唯一字符串拼接文件名
String fileName = UUID.randomUUID().toString() + ext;
// 保存到磁盘上
part.write("D:/" + fileName);
复制代码
3. 文件保存位置问题
文件在磁盘某个位置,不在项目下,无法使用 HTTP 协议访问,所以要把用户上传的文件存放到项目中才可通过 HTTP 协议来访问,且保存的位置路径不可以写绝对路径,那么怎么办?可以通过 ServletContext 对象的 getRealPath("项目中保存上传文件的文件夹的相对路径") 来获取其的绝对路径。
在项目的 web 目录下新建一个名为 upload 文件夹,修改 UploadServlet.java 的代码如下:
@WebServlet("/fileUpload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 文件控件数据获取
Part part = req.getPart("headImg");
// 获取上传文件名
String realFileName = part.getSubmittedFileName();
// 获取上传文件扩展名
String ext = realFileName.substring(realFileName.lastIndexOf("."));
// 生成唯一字符串拼接文件名
String fileName = UUID.randomUUID().toString() + ext;
// 获取项目下的 upload 目录的绝对路径,拼接成文件的保存路径
String realPath = getServletContext().getRealPath("/upload") +"/"+ fileName;
// 保存到磁盘上
part.write(realPath);
}
}
复制代码
3.1 无法获取项目下的 upload 目录
以上方式没什么效果,原因是 IDEA 工具使用 打包 web 项目(war) 的方式来部署,所以位置有偏 差,需要还原 Web 项目的原本目录结构,以及调整部署方式。调整步骤如下:
-
WEB-INF 下 创建 classes 目录,用于存放 class 文件
-
修改项目 class 文件输出位置到 /WEB-INF/class 中(File -> Project Structure)
- 调整项目部署方式为 External Source
以上操作之后可以获取到项目下的 upload 目录了,但是之前的重新部署无效了,往后可使用编译类的 方式来代替重新部署。
4. 文件类型约束问题
UploadServlet.java
@WebServlet("/fileUpload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 文件控件数据获取
Part part = req.getPart("headImg");
// 判断上传的文件类型合法不
if(!part.getContentType().startsWith("img/")) {
req.setAttribute("errorMsg", "请上传图片");
req.getRequestDispatcher("/register.jsp").forward(req, resp); return;
}
String realFileName = part.getSubmittedFileName();
// 获取文件扩展名
String ext = realFileName.substring(realFileName.lastIndexOf("."));
// 生成唯一字符串拼接文件名
String fileName = UUID.randomUUID().toString() + ext;
// 获取项目下的 upload 目录的绝对路径,拼接成文件的保存路径
String realPath = getServletContext().getRealPath("/upload") +"/"+ fileName;
// 保存到磁盘上
part.write(realPath);
}
}
复制代码
register.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>注册</title>
</head>
<body>
<span style="color: red">${errorMsg}</span><br/>
<form action="/fileUpload" method="post" enctype="multipart/form-data">
<p>账号:<input type="text" name="username"/></p>
<p>头像:<input type="file" name="headImg"/></p>
<input type="submit" value="注册">
</form>
</body>
</html>
复制代码
5. 文件大小约束问题
文件上传限制大小可提高服务器硬盘的使用率,防止用户恶意上传文件造成服务器磁盘资源紧张。可以 通过设置 @MutipartConfifig 的属性做限制,其属性如下:
- maxFileSize:单个上传文件大小限制,单位:bytes
- maxRequestSize:显示请求中数据的大小,单位:bytes
四、文件下载
将服务器中的资源下载保存到用户电脑中。
1. 文件下载的简单实现
在 web 下新建 download 目录,里面提供两个资源 dog.rar 和 猫.rar
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>下载</title>
</head>
<body>
<h3>文件下载</h3>
<a href="/download/dog.rar">dog.rar</a><br/>
<a href="/download/猫.rar">猫.rar</a><br/>
</body>
</html>
复制代码
2. 文件下载限制
下载功能已经实现,但是文件放在 WEB-INF 外面不安全,用户只需要拿到下载的超链接都能够下载, 实际开发中,我们的文件通常需要用户有一定的权限才能下载,所以文件应该放在 WEB-INF 下,这样 的话,用户就不可以直接访问到了,须请求到交由 Servlet 来处理,我们就可以在其 service 方法中编 写下载限制操作。
2.1 移动下载资源WEB-INF下
2.2 修改 download.jsp 修改下载资源的链接地址 bar
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>下载</title>
</head>
<body>
<h3>文件下载</h3>
<a href="/download?fileName=dog.rar">dog.rar</a><br/>
<a href="/download?fileName=猫.rar">猫.rar</a><br/>
</body>
</html>
复制代码
2.3 编写 DownloadServlet.java
根据请求传递文件名参数获取对应文件响应给浏览器。
protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
//获取用户想要下载的文件名称
String fileName = req.getParameter("fileName");
//获取浏览器类型
String header = req.getHeader("User-Agent");
//根据浏览器类型设置下载文件名
//三目运算法
String mozilla = header.contains("Mozilla") ? URLEncoder.encode(fileName, "UTF-8") : new String(fileName.getBytes("UTF-8"), "ISO-8859-1");
//设置下载文件名
resp.setHeader("Content-Disposition", "attachment;filename=" + mozilla);
//获取文件所在跟路径
String realPath = req.getServletContext().getRealPath("/WEB-INF/download/");
//使用工具类File的copy方法获取文件输入流,响应会浏览器
//Files.copy(源文件,输出)
// Path path = Paths.get("C:/", "Xmp");Path用于来表示文件路径和文件。可以有多种方法来构造一个Path对象来表示一个文件路径,或者一个文件:
//resp.getOutputStream()响应一个输出流,作用下载来用
Files.copy(Paths.get(realPath, fileName), resp.getOutputStream());
}
复制代码
3. 下载文件名称问题(能使用即可)
默认情况下,Tomcat 服务器未告知浏览器文件的名称,所以需要手动设置响应头来告知浏览器文件名称,方法如下:
// 无需记,知道需要设置即可 // 给浏览器一个推荐名称
resp.setHeader("Content-Disposition", "attachment;filename=文件名称");
复制代码
处理中文件名称的问题
- IE 使用 URL 编码方式:URLEncoder.encode(fifileName, "UTF-8")
- 非 IE使用 ISO-8859-1 编码:new String (fifileName.getBytes("UTF-8"), "ISO-8859-1")
具体代码见上面一份
三层架构
1.三层架构介绍
Web 开发中的最佳实践:分层开发模式(技术层面的"分而治之")。三层架构(3-tier architecture):通 常意义上的三层架构就是将整个业务应用划分为:表现层、业务逻辑层、数据访问层。区分层次的目的 即为了“高内聚低耦合”的思想。在软件体系架构设计中,分层式结构是最常见,也是最重要的一种结
构。
- 表现层(Predentation Layer):MVC,负责处理与界面交互的相关操作。
- 业务层(Business Layer):Service,负责复杂的业务逻辑计算和判断。
- 持久层(Persistent Layer):DAO,负责将业务逻辑数据进行持久化存储
2. 业务层命名规范
- 包名:
- 公司域名倒写.模块名.service:存放业务接口代码。
- 公司域名倒写.模块名.service.impl:存放业务层接口的实现类。
- 类名:
- IXxxService:业务层接口,Xxx 表示对应模型,比如操作 User 的就起名为 IUserService。
- XxxServiceImpl:业务层接口对应的实现类,比如操作 User 的就起名为 UserServiceImpl。
- XxxServiceTest:业务层实现的测试类。