Servlet
2024年6月20日大约 17 分钟
1、Servlet 技术
1.1 什么是 Servlet
①Servlet 是 JavaEE 规范之一 (规范就是接口)
②Servlet 是 JavaWeb 三大组件之一 (三大组件分别是：Servlet 程序、Filter 过滤器、Listener 监听器)
③Servlet 是运行在服务器上的一个 java 小程序，它可以接收客户端发送过来的请求，并响应数据给客户端
1.2 手动实现 Servlet 程序
①编写一个类去实现 Servlet 接口
②实现 service() 方法，处理请求，并响应数据
③到 web.xml 中去配置 servlet 程序的访问地址
示例代码：
第一步，创建一个 HelloServlet 类实现 Servlet 接口
public class HelloServlet implements Servlet {
@Override
public void init(ServletConfig servletConfig) throws ServletException {
}
@Override
public ServletConfig getServletConfig() {
return null;
}
/**
* service()方法是专门用来处理请求和响应的
* @param servletRequest
* @param servletResponse
* @throws ServletException
* @throws IOException
*/
@Override
public void service(ServletRequest servletRequest, ServletResponse servletResponse) throws ServletException, IOException {
System.out.println("HelloServlet 被访问了!");
}
@Override
public String getServletInfo() {
return null;
}
@Override
public void destroy() {
}
}第二步，到 web.xml 中去配置 servlet 程序的访问地址
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
<!-- servlet 标签:给 Tomcat 配置 Servlet 程序 -->
<servlet>
<!-- servlet-name 标签:给 Servlet 程序起一个别名(一般是类名) -->
<servlet-name>HelloServlet</servlet-name>
<!-- servlet-class 标签: Servlet 的全类名 -->
<servlet-class>com.hkw.bookstore.test.servlet.HelloServlet</servlet-class>
</servlet>
<!-- servlet-mapping 标签:给 Servlet 程序配置访问路径 -->
<servlet-mapping>
<!-- servlet-name 标签:告诉服务器，当前配置的地址给哪个 Servlet 程序使用 -->
<servlet-name>HelloServlet</servlet-name>
<!--
url-pattern 标签:配置访问地址
/ 光一个斜杆表示服务器解析的时候，表示地址为: http://ip:port/工程路径(上下文)
/hello 表示地址为:http://ip:port/工程路径(上下文)/hello
-->
<url-pattern>/hello</url-pattern>
</servlet-mapping>
</web-app>index.jsp 中内容：
第三步，点击启动 Tomcat 运行实例按钮
运行效果：
第四步，地址栏加上 hello，点击回车：此时界面上没有东西，因为我们没有给这个地址提供访问的资源
但是我们在 web.xml 中配置了这个访问地址对应的 Servlet 程序，就是 HelloServlet
可以看到控制台输出了我们在 HelloServlet 类的 service() 方法中输出的信息
说明 HelloServlet 接收到了来自客户端的请求
常见错误：
①url-pattern 中配置的路径没有以斜杆开头
②servlet-name 配置的值不存在
③servlet-class 标签的全类名配置错误
1.3 url 地址如何定位到 Servlet 程序去访问
1.4 Servlet 的生命周期
①、② 只在第一次访问时创建 Servlet 程序会调用，后续的访问不会再执行，说明是单例
③ 在每次访问时都会调用
④在 web 工程停止调用
- ①执行 Servlet 构造器方法
- ②执行 init 初始化方法
- ③执行 service 方法
- ④执行 destroy 销毁方法
1.5 GET 和 POST 请求的分发处理
@Override
public void service(ServletRequest servletRequest, ServletResponse servletResponse) throws ServletException, IOException {
System.out.println("HelloServlet 被访问了!");
// 类型转换，因为ServletRequest的子类HttpServletRequest里有getMethod()方法用来获取请求方式
HttpServletRequest httpServletRequest = (HttpServletRequest) servletRequest;
// 获取请求方式
String method = httpServletRequest.getMethod();
// 通过判断请求方式来分发请求
if ("GET".equals(method)) {
doGet();
} else if ("POST".equals(method)) {
doPost();
}
}
// 处理GET请求
public void doGet() {
System.out.println("GET请求");
}
// 处理POST请求
public void doPost() {
System.out.println("POST请求");
}1.6 通过继承 HttpServlet 实现 Servlet 程序
一般在实际开发中，都是使用继承 HttpServlet 类的方式去实现 Servlet 程序
public class HelloServlet2 extends HttpServlet {
// HttpServlet为我们封装好了接收到get、post等请求时调用的方法，我们只需要重写就好了
/**
* doGet()方法在get请求时调用
* @param req
* @param resp
* @throws ServletException
* @throws IOException
*/
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println("HelloServlet2 的doGet()方法");
}
/**
* doPost()方法在post请求时调用
* @param req
* @param resp
* @throws ServletException
* @throws IOException
*/
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println("HelloServlet2 的doPost()方法");
}
}在 web.xml 中配置 HelloServlet2 的访问地址
<servlet>
<servlet-name>HelloServlet2</servlet-name>
<servlet-class>com.hkw.bookstore.test.servlet.HelloServlet2</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>HelloServlet2</servlet-name>
<url-pattern>/hello2</url-pattern>
</servlet-mapping>创建两个 html 页面，里面有分别提交 get 和 post 请求的表单：
getRequest.html：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>get请求</title>
</head>
<body>
<form action="http://localhost:8080/book_store/hello2" method="get">
<input type="submit"/>
</form>
</body>
</html>postRequesthtml：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>post请求</title>
</head>
<body>
<form action="http://localhost:8080/book_store/hello2" method="post">
<input type="submit"/>
</form>
</body>
</html>重启 Tomcat 运行实例，测试下 get 和 post 请求的分发
1.7 使用 IDEA 创建 Servlet 程序
第一步，右键 New > Create New Servlet
第二步，定义好 Servlet 的 Name、Package、Class、是否使用注解
(先不使用注解，使用 2.5 版本进行学习)
可以看到，点击 OK 后，默认继承了 HttpServlet 类
第三步，在 web.xml 中手动加入访问地址的配置(其他都自动生成了)
<servlet-mapping>
<servlet-name>HelloServlet3</servlet-name>
<url-pattern>/hello3</url-pattern>
</servlet-mapping>1.8 Servlet 类的继承体系
2、ServletConfig 类
- ServletConfig 类从类名上看，就知道是 Servlet 程序的配置信息类
- Servlet 程序和 ServletConfig 对象都是由 Tomcat 负责创建，我们负责使用
- Servlet 程序默认是第一次访问的时候创建，ServletConfig 是每个 Servlet 程序创建时，就创建的一个对应的 ServletConfig 对象
ServletConfig 类的三大作用：
①可以获取 Servlet 程序的别名 servlet-name 的值
②获取初始化参数 init-param
③获取 ServletContext 对象
拿创建好的 HelloServlet 举例
第一步，我们先在 web.xml 中加入如下配置：
<!-- servlet标签:给Tomcat配置Servlet程序 -->
<servlet>
<!-- servlet-name标签:给Servlet程序起一个别名(一般是类名) -->
<servlet-name>HelloServlet</servlet-name>
<!-- servlet-class标签:Servlet的全类名 -->
<servlet-class>com.hkw.bookstore.test.servlet.HelloServlet</servlet-class>
<!-- init-param标签:配置初始化参数 -->
<init-param>
<!-- 参数名 -->
<param-name>username</param-name>
<!-- 参数值 -->
<param-value>admin</param-value>
</init-param>
<init-param>
<param-name>password</param-name>
<param-value>123456</param-value>
</init-param>
</servlet>
<!-- servlet-mapping标签:给Servlet程序配置访问路径 -->
<servlet-mapping>
<!-- servlet-name标签:告诉服务器，当前配置的地址给哪个Servlet程序使用 -->
<servlet-name>HelloServlet</servlet-name>
<!--
url-pattern标签:配置访问地址
/ 光一个斜杆表示服务器解析的时候，表示地址为: http://ip:port/工程路径(上下文)
/hello 表示地址为:http://ip:port/工程路径(上下文)/hello
-->
<url-pattern>/hello</url-pattern>
</servlet-mapping>第二步，我们对 HelloServlet 类的 init 方法进行编写，内容如下：
@Override
public void init(ServletConfig servletConfig) throws ServletException {
// 1.获取Servlet程序的别名servlet-name
System.out.println("HelloServlet程序的别名是: " + servletConfig.getServletName());
// 2.获取初始化参数init-param
System.out.println("初始化参数username的值是: " + servletConfig.getInitParameter("username"));
System.out.println("初始化参数password的值是: " + servletConfig.getInitParameter("password"));
// 3.获取ServletContext对象
System.out.println("ServletContext对象: " + servletConfig.getServletContext());
}重启 Tomcat，访问如下地址：
http://localhost:8080/book_store/hello控制台打印结果如下：
3、ServletContext
3.1 什么是 ServletContext?
①ServletContext 是一个接口，它表示 Servlet 上下文对象
②一个 Web 工程，只有一个 ServletContext 对象实例
③ServletContext 对象是一个域对象
④ServletContext 是在 Web 工程部署启动的时候创建，在 Web 工程停止的时候销毁
什么是域对象?
域对象，是可以像 Map 一样存取数据的对象
这里的域指的是存取数据的范围
ServletContext 对象对应的数据的存取范围是：整个 web 工程
| 存数据 | 取数据 | 删除数据 | |
|---|---|---|---|
| Map | put() | get() | remove() |
| 域对象 | setAttribute() | getAttrribute() | removeAttribute() |
3.2 ServletContext 类的四个作用
①获取 web.xml 中配置的上下文参数 context-param
②获取当前的工程路径，格式：/工程路径
③获取工程部署后服务器硬盘上的绝对路径
④像 Map 一样存取数据
拿 HelloServlet2 做举例，首先在 web.xml 做如下配置
<!-- context-param标签:配置上下文参数(它属于整个web工程) -->
<context-param>
<param-name>username</param-name>
<param-value>hkw123</param-value>
</context-param>
<context-param>
<param-name>password</param-name>
<param-value>root</param-value>
</context-param>在 doGet 方法中我们编写如下代码：
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println("HelloServlet2 的doGet()方法");
// 1.获取web.xml中配置的上下文参数context-param
ServletContext servletContext = getServletContext();
System.out.println("context-param参数username的值是: " + servletContext.getInitParameter("username"));
System.out.println("context-param参数password的值是: " + servletContext.getInitParameter("password"));
// 2.获取当前的工程路径，格式: /工程路径
System.out.println("当前的工程路径: " + servletContext.getContextPath());
// 3.获取工程部署后在服务器硬盘上的绝对路径
/**
* / 斜杆被服务器解析地址为: http://ip:port/工程名/ 映射到IDEA代码中的web目录
*/
System.out.println("工程部署后在服务器硬盘上的绝对路径是: " + servletContext.getRealPath("/"));
// *************************************************
// ServletContext像Map一样存取数据
System.out.println("存储之前，HelloServlet2获取域数据key1的值是: " + servletContext.getAttribute("key1"));
servletContext.setAttribute("key1","value1");
System.out.println("HelloServlet2获取域数据key1的值是: " + servletContext.getAttribute("key1"));
}通过 HelloServlet3 获取域数据 key1 的值，它的 doGet 中的代码如下：
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
ServletContext servletContext = getServletContext();
System.out.println("HelloServlet3获取域数据key1的值是: " + servletContext.getAttribute("key1"));
}重启 Tomcat 运行，结果如下：
4、HTTP 协议
4.1 什么是 HTTP 协议?
什么是协议? --- 协议是双方，或多方，相互约定好，大家都需要遵守的规则
所谓 HTTP 协议，就是指，客户端和服务器之间通信时，发送的数据，需要遵守的规则
HTTP 协议中的数据又叫报文
4.2 请求的 HTTP 协议格式
- 客户端给服务器发送数据叫请求
- 服务器给客户端回传数据叫响应
请求又分为 GET 请求和 POST 请求
①GET 请求
请求行
<1>请求行 GET
<2>请求的资源路径[+?+请求参数]
<3>请求协议和版本号 HTTP/1.1请求头
key : value 组成 不同的键值对，表示不同的含义
②POST 请求
请求行
<1>请求行 POST
<2>请求的资源路径
<3>请求协议和版本号 HTTP/1.1请求头
<1>key : value 组成 不同的键值对，表示不同的含义
<2>空行请求体
就是发送给服务器的数据
③常用请求头说明
- Accept：表示客户端可以接受的数据类型
- Accept-Language：表示客户端可以接收的语言类型
- User-Agent：表示客户端浏览器的信息
- Host：表示请求的服务器ip和端口号
④哪些是 GET 请求，哪些是 POST 请求
GET 请求有如下：
- form 标签 method=get
- a 标签
- link 标签引入 css
- script 标签引入 js 文件
- img 标签引入图片
- iframe 引入 html 页面
- 在浏览器地址栏中输入地址后敲回车\
POST 请求有如下：
- form 标签 method=post
4.3 响应的 HTTP 协议格式
①响应行
<1>响应的协议和版本号
<2>响应状态码
<3>响应状态描述符②响应头
<1>key : value 组成 不同的键值对，表示不同的含义
<2>空行③响应体
就是服务器回传给客户端的数据
④常见的响应状态码说明
- 200：表示相应成功
- 302：表示请求重定向
- 404：表示服务器已经收到请求，但是请求的资源不存在(请求路径错误)
- 500：表示服务器已经收到请求，但是服务器内部错误了(代码错误)
⑤MIME 类型说明
- MIME 是 http 协议中的数据类型
- MIME 的英文全称是 "Multipurpose Internet Mail Extensions" 多功能 Internet 邮件扩充服务
- MIME 类型的格式是 "大类型/小类型"，并与某一种文件的扩展名相对应
常见的 MIME 类型：
⑥谷歌浏览器如何查看 HTTP 协议
4.4 常见的请求和响应头说明
5、HttpServletRequest 类
5.1 HttpServletRequest 类有什么作用?
每次只要有请求进入 Tomcat 服务器，Tomcat 服务器就会把请求过来的 HTTP 协议信息解析好封装到 Request 对象中，然后传递到 service 方法(doGet 和 doPost)中给我们使用。我们可以通过 HttpServletRequest 对象，获取到所有请求的信息。
5.2 HttpServletRequest 类的常用方法
- ①getRequestURI()：获取请求的资源路径
- ②getRequestURL()：获取请求的统一资源定位符(绝对地址)
- ③getRemoteHost()：获取客户端的ip地址
- ④getHeader()：获取请求头
- ⑤getParameter()：获取请求的参数
- ⑥getParameterValues()：获取请求的参数(多个值的时候使用)
- ⑦getMethod()：获取请求的方式(GET或POST)
- ⑧setAttribute(key,value)：设置域数据
- ⑨getAttribute(key)：获取域数据
- ⑩getRequestDispatcher()：获取请求转发对象
测试一下常用 API：
新建一个继承 HttpServlet 的类(RequestAPIServlet 类)
public class RequestAPIServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// ①getRequestURI()：获取请求的资源路径
System.out.println("URI => " + request.getRequestURI());
// ②getRequestURL()：获取请求的统一资源定位符(绝对地址)
System.out.println("URL => " + request.getRequestURL());
// ③getRemoteHost()：获取客户端的ip地址
System.out.println("客户端 ip 地址 => " + request.getRemoteHost());
// ④getHeader()：获取请求头
System.out.println("请求头 User-Agent => " + request.getHeader("User-Agent"));
// ⑤getParameter()：获取请求的参数
System.out.println("请求参数 name => " + request.getParameter("name"));
// ⑦getMethod()：获取请求的方式(GET或POST)
System.out.println( "请求的方式 => " + request.getMethod() );
}
}运行结果：
5.3 如何获取请求参数
刚上面简单模拟了一个 name 的请求参数，但真实的情况都是通过表单进行的请求参数的传递
下面我们简单演示，通过表单进行发出请求和请求参数
同样，我们再新建一个 ParameterServlet 类
页面表单如下：
<body>
<form action="http://localhost:8080/07_servlet/parameterServlet" method="get">
用户名：<input type="text" name="username"><br/>
密码：<input type="password" name="password"><br/>
兴趣爱好：<input type="checkbox" name="hobby" value="cpp">C++
<input type="checkbox" name="hobby" value="java">Java
<input type="checkbox" name="hobby" value="js">JavaScript<br/>
<input type="submit">
</form>
</body>ParameterServlet 类中代码如下：
public class ParameterServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 获取请求参数
String username = request.getParameter("username");
String password = request.getParameter("password");
String[] hobby = request.getParameterValues("hobby");
System.out.println("用户名：" + username);
System.out.println("密码：" + password);
System.out.println("兴趣爱好：" + Arrays.asList(hobby));
}
}运行结果：
doGet 中解决中文乱码问题解决
// 获取请求参数
String username = req.getParameter("username");
//1 先以 iso8859-1 进行编码
//2 再以 utf-8 进行解码
username = new String(username.getBytes("iso-8859-1"), "UTF-8");5.4 doPost 中解决中文乱码问题解决（★★★）
// 设置请求体字符集为UTF-8，从而解决post请求的中文乱码问题
req.setCharacterEncoding("UTF-8");
// 获取请求参数
String username = req.getParameter("username");
String password = req.getParameter("password");
String[] hobby = req.getParameterValues("hobby");注意：要先设置字符集再获取参数
5.5 请求转发
什么是请求转发?
请求转发是指，服务器收到请求后，从一次资源跳转到另一个资源的操作叫请求转发
新建 Servlet1 和 Servlet2 两个 Servlet 程序，配置好 web.xml
Servlet1 代码：
public class Servlet1 extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 获取请求的参数（办事的材料）查看
String username = req.getParameter("username");
System.out.println("在 Servlet1（柜台 1）中查看参数（材料）：" + username);
// 给材料 盖一个章，并传递到 Servlet2（柜台 2）去查看
req.setAttribute("key1","柜台 1 的章");
// 问路：Servlet2（柜台 2）怎么走
/**
* 请求转发必须要以斜杠打头，/ 斜杠表示地址为：http://ip:port/工程名/ , 映射到 IDEA 代码的 web 目录 <br/>
**/
RequestDispatcher requestDispatcher = req.getRequestDispatcher("/servlet2");
// 走向 Sevlet2（柜台 2）
requestDispatcher.forward(req,resp);
}
}Servlet2 代码：
public class Servlet2 extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 获取请求的参数（办事的材料）查看
String username = req.getParameter("username");
System.out.println("在 Servlet2（柜台 2）中查看参数（材料）：" + username);
// 查看 柜台 1 是否有盖章
Object key1 = req.getAttribute("key1");
System.out.println("柜台 1 是否有章：" + ("柜台 1 的章".equals(key1) ? "有" : "无"));
// 处理自己的业务
System.out.println("Servlet2 处理自己的业务 ");
}
}运行结果：
5.6 base 标签
base 标签可以设置当前页面中所有相对路径工作时，参照哪个路径来进行跳转
5.7 web 中的相对路径和绝对路径
在 JavaWeb 中，路径分为相对路径和绝对路径两种
相对路径：
. 表示当前目录
.. 表示上一级目录
资源名 表示当前目录/资源名绝对路径：
http://ip:port/工程路径/资源路径在实际开发中，路径都是用绝对路径，而不简单地使用相对路径。
①绝对路径
②base+相对5.8 web 中 / 斜杆的不同意义
在 web 中 / 斜杆 是一种绝对路径
①/ 斜杆 如果被浏览器解析，得到的地址是：http://ip:port/
<a href="/">斜杆</a>②/ 斜杆 如果被服务器解析，得到的地址是：http://ip:port/工程路径
1.<url-pattern>/servlet1</url-pattern>
2.serlvetContext.getRealPath("/");
3.request.getRequestDispatcher("/");③特殊情况
response.sendRedirect("/"); // 把斜杆发送给浏览器解析，得到：http://ip:port/6、HttpServletResponse 类
6.1 HttpServletResponse 类的作用
HttpServletResponse 类和 HttpServletRequest 类一样，每次请求进来，Tomcat 服务器都会创建一个 Response 对象传递给 Servlet 程序去使用。HttpServletRequest 表示请求过来的信息，HttpServletResponse 表示所有响应的信息。
如果我们需要设置返回给客户端的信息，都可以通过 HttpServletResponse 对象来进行设置。
6.2 两个输出流的说明
①字节流 getOutputStream(); 常用于下载（传递二进制数据）
②字符流 getWriter(); 常用于回传字符串（常用）注：两个流同时只能使用一个，使用了字节流，就不能再使用字符流，反之亦然，否则会报错。
6.3 如何往客户端回传数据
要求：往客户端回传字符串
public class ResponseIOServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 要求：往客户端回传字符串
PrintWriter writer = response.getWriter();
writer.write("回传了数据");
}
}运行结果：
发现出现了响应乱码问题
6.4 响应乱码问题解决
方案一（不推荐使用）
// 设置服务器字符集为 UTF-8
resp.setCharacterEncoding("UTF-8");
// 通过响应头，设置浏览器也使用 UTF-8 字符集
resp.setHeader("Content-Type", "text/html; charset=UTF-8");方案二（推荐使用）
// 它会同时设置服务器和客户端都使用 UTF-8 字符集，还设置了响应头
// 此方法一定要在获取流对象之前调用才有效
resp.setContentType("text/html; charset=UTF-8");将解决乱码方案加入上面的代码：
public class ResponseIOServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 要求：往客户端回传字符串
// 它会同时设置服务器和客户端都使用 UTF-8 字符集，还设置了响应头
// 此方法一定要在获取流对象之前调用才有效
response.setContentType("text/html; charset=UTF-8");
PrintWriter writer = response.getWriter();
writer.write("回传了数据");
}
}运行结果：
6.5 请求重定向
请求重定向，是指客户端给服务器发请求，然后服务器告诉客户端说，我给你一个新地址，你去新地址访问，这就叫请求重定向(因为之前的地址可能已经被废弃)。
①请求重定向的第一种方案
// 设置响应状态码 302 ，表示重定向，（已搬迁）
resp.setStatus(302);
// 设置响应头，说明 新的地址在哪里
resp.setHeader("Location", "http://localhost:8080");②请求重定向的第二种方案
resp.sendRedirect("http://localhost:8080");