文章目录
Servlet
Servlet 简介
servlet 是 sun 公司开发动态 web 的一门技术。sun 公司在 servlet API 接口中提供了一个 接口叫做 servlet 。如果想开发一个 servlet 程序,只需要两个步骤 :
- 编写一个类,实现 servlet 接口
- 把开发好的java 程序部署到 web 服务器中
把实现了 servlet 接口的 java程序叫做 servlet
Hello Servlet 案例
1、创建一个 普通 的Maven 项目,删除 src 目录,把这个项目做为父项目(主工程),之后的小项目(Moudel)都放在这个项目里面。
2、导入依赖 :根据 Tomcat版本不同,导入不同的依赖
注意
:很多依赖都是javax 下的,Tomcat 10里面的servlet使用的是jakarta,所以后期使用起来会有一些问题
<!-- tomcat低版本 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
</dependency>
<!-- tomcat 10 -->
<dependency>
<groupId>jakarta.servlet</groupId>
<artifactId>jakarta.servlet-api</artifactId>
<version>5.0.0</version>
</dependency>
3、创建子项目 – 使用maven 创建一个 web 项目
关于 maven 父子工程解释 :
父项目中 会有 :
<modules>
<module>servlet</module>
</modules>
子项目中会有 :
<parent>
<artifactId>javaweb-maven-all</artifactId>
<groupId>com.hkp</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
子项目可以直接使用 父项目中的 pom 依赖
4、web 项目 优化
- 完善项目结构 (main 文件夹中创建java 和 resources 文件夹)
- 修改 web.xml 文件,将配置改为最新(选做)文件在Tomcat文件夹下的tomcat\webapps\ROOT\WEB-INF
<?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"
metadata-complete="true">
</web-app>
5、编写一个 Servlet 程序
- 创建一个普通类
- 实现 Servlet 接口,这里只需要继承 HttpServlet 即可
package com.hkp.servlet;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
public class HelloServlet extends HttpServlet {
@Override
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws IOException, ServletException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();//创建响应流
out.println("<html>");
out.println("<head>");
out.println("<title>Hello World!</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>Hello World!</h1>");
out.println("</body>");
out.println("</html>");
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
6、在 web.xml 中编写Servlet的映射
为什么需要映射 ?
我们写的是java程序,但是需要通过浏览器访问,而浏览器需要连接 web 服务器,所以我们要在web服务中注册我们的Servlet
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
version="5.0"
metadata-complete="true">
<!-- servlet 和 servlet-mapping 中的 servlet-name 必须一样-->
<!--注册 Servlet-->
<servlet>
<servlet-name>hello</servlet-name>
<servlet-class>com.hkp.servlet.HelloServlet</servlet-class>
</servlet>
<!-- servlet 的请求路径-->
<servlet-mapping>
<servlet-name>hello</servlet-name>
<url-pattern>/hello</url-pattern>
</servlet-mapping>
</web-app>
7、配置 Tomcat
8、在页面中访问测试
Servlet 原理
Servlet 是由服务器调用的,web 服务器在收到浏览器的请求之后 :
Mapping 问题
-
一个Servlet 可以指定一个映射路径
<servlet-mapping> <servlet-name>hello</servlet-name> <url-pattern>/hello</url-pattern> </servlet-mapping>
-
一个Servlet 可以指定多个映射路径
<servlet-mapping> <servlet-name>hello</servlet-name> <url-pattern>/hello</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>hello</servlet-name> <url-pattern>/hello1</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>hello</servlet-name> <url-pattern>/hello2</url-pattern> </servlet-mapping>
-
一个Servlet 可以指定通用映射路径
<servlet-mapping> <servlet-name>hello</servlet-name> <url-pattern>/hello/*</url-pattern> </servlet-mapping>
-
默认请求路径 :启动后,项目会默认访问 hello 对应的 Servlet ,而不会去访问 index.jsp
<servlet-mapping> <servlet-name>hello</servlet-name> <url-pattern>/*</url-pattern> </servlet-mapping>
-
指定一些后缀或前缀
<!-- 自定义后缀实现请求路径 --> <!-- 注意 :*前面不能加项目的映射路径 --> <servlet-mapping> <servlet-name>hello</servlet-name> <url-pattern>*.han</url-pattern> </servlet-mapping>
优先级
指定了固有的映射路径优先级最高,如果找不到就会去走默认的处理请求
例如 :自定义一个 404 页面
1、编写 ErrorServlet
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
public class ErrorServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
resp.setContentType("text/html");
resp.setCharacterEncoding("utf-8");
PrintWriter writer = resp.getWriter();
writer.println("您找的资源不存在~");
}
}
2、编写 web.xml 中的 servlet 映射路径
<servlet>
<servlet-name>hello</servlet-name>
<servlet-class>com.hkp.servlet.HelloServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>hello</servlet-name>
<url-pattern>/hello</url-pattern>
</servlet-mapping>
<!-- 404-->
<servlet>
<servlet-name>error</servlet-name>
<servlet-class>com.hkp.servlet.ErrorServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>error</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
3、测试 :
ServletContext 对象 :Servlet 上下文
web 容器在启动的时候,会为每个 web 程序都创建一个对应的 ServletContext 对象,它代表了当前的 web 应用 ;
1、共享数据
在一个Servlet 中的存放一个值,在其他的 Servlet 中可以拿到
1、创建 SetServlet 用来往 ServletContext 存数据
import jakarta.servlet.ServletContext;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
public class SetServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
ServletContext context = this.getServletContext();
String username = "root";
//将数据保存在 ServletContext 中,键 : username ; 值 : username
context.setAttribute("username",username);
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
2、创建 GetServlet 用来取 ServletContext 中的数据
import jakarta.servlet.ServletContext;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
public class GetServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
ServletContext context = this.getServletContext();
String username = (String) context.getAttribute("username");
resp.setContentType("text/html");
resp.setCharacterEncoding("utf-8");
PrintWriter writer = resp.getWriter();
writer.println("用户为 :"+username);
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
3、设置 web.xml 文件,配置 Servlet 映射路径
<servlet>
<servlet-name>getc</servlet-name>
<servlet-class>com.hkp.servlet.GetServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>getc</servlet-name>
<url-pattern>/getc</url-pattern>
</servlet-mapping>
<servlet>
<servlet-name>setc</servlet-name>
<servlet-class>com.hkp.servlet.SetServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>setc</servlet-name>
<url-pattern>/setc</url-pattern>
</servlet-mapping>
4、启动测试
注意 :需要先去访问 SetServlet ,让数据存到 ServletContext 中去,才能调用 GetServlet 去取数据;如果直接去访问 GetServlet ,得到的是null ;
正常访问
直接访问 GetServlet
2、获取初始化参数
1、在 web.xml 中 配置初始化参数
<!-- 配置一些 web 应用的初始化参数 -->
<context-param>
<param-name>url</param-name>
<param-value>jdbc:mysql://localhost:3306/schooldb</param-value>
</context-param>
<!-- 配置 Servlet 映射 -->
<servlet>
<servlet-name>gp</servlet-name>
<servlet-class>com.hkp.servlet.ServletDemo</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>gp</servlet-name>
<url-pattern>/gp</url-pattern>
</servlet-mapping>
2、编写 Servlet 去获取初始化参数
import jakarta.servlet.ServletContext;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
public class ServletDemo extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
ServletContext context = this.getServletContext();
String s = context.getInitParameter("url");
PrintWriter writer = resp.getWriter();
writer.println(s);
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
3、启动访问
3、请求转发
1、编写 Servlet
import jakarta.servlet.RequestDispatcher;
import jakarta.servlet.ServletContext;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
public class ServletDemo1 extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
ServletContext context = this.getServletContext();
//转发请求的路径 :转发到 /gp(在 web.xml 中配置的映射路径) 这个 Servlet 中
RequestDispatcher requestDispatcher = context.getRequestDispatcher("/gp");
requestDispatcher.forward(req,resp);//调用 forward 方法实现请求转发
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
2、配置 web.xml 中的映射路径
<servlet>
<servlet-name>sd1</servlet-name>
<servlet-class>com.hkp.servlet.ServletDemo1</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>sd1</servlet-name>
<url-pattern>/sd1</url-pattern>
</servlet-mapping>
3、启动测试
4、读取资源文件 properties
properties 文件 :
- 在 java 目录下创建 properties 文件(有问题)
- 在 resources 目录下创建 properties 文件 (常规操作)
发现 :都被打包到了同一个路径下 : classes,我们俗称为 :classpath
1、在resources 中创建properties 文件
username = "root"
password = "admin"
2、创建 Servlet 读取 properties 文件
import jakarta.servlet.ServletContext;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.InputStream;
import java.io.PrintWriter;
import java.util.Properties;
public class ServletDemo2 extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
ServletContext context = this.getServletContext();
//获取文件 /WEB-INF/classes/db.properties 为编译后 target 里的地址
InputStream resource = context.getResourceAsStream("/WEB-INF/classes/db.properties");
Properties prop = new Properties();
//加载文件
prop.load(resource);
//获取文件属性
String username = prop.getProperty("username");
String password = prop.getProperty("password");
//设置页面的编码格式
resp.setCharacterEncoding("utf-8");
resp.setContentType("text/html");
//向页面响应
PrintWriter writer = resp.getWriter();
writer.println("用户名 :"+username);
writer.println("密码 :"+password);
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
3、配置 web.xml 中的 Servlet 映射路径
<servlet>
<servlet-name>sd2</servlet-name>
<servlet-class>com.hkp.servlet.ServletDemo2</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>sd2</servlet-name>
<url-pattern>/sd2</url-pattern>
</servlet-mapping>
4、测试
HttpServletResponse :响应
web 服务器接收到客户端的 HTTP 请求,针对这个请求,分别创建一个代表请求的 HttpServletRequest对象,代表响应的 HttpServletResponse
- 获取客户端请求过来的参数,找 :HttpServletRequest
- 给客户端响应一些信息,找 :HttpServletResponse
简单分类
负责向浏览器发送数据的方法
ServletOutputStream getOutputStream() throws IOException;
PrintWriter getWriter() throws IOException;
负责向浏览器发送响应头的方法
void setCharacterEncoding(String var1);
void setContentLength(int var1);
void setContentLengthLong(long var1);
void setContentType(String var1);
void setStatus(int var1);
响应的状态码
int SC_CONTINUE = 100;
int SC_SWITCHING_PROTOCOLS = 101;
int SC_OK = 200;
int SC_CREATED = 201;
int SC_ACCEPTED = 202;
int SC_NON_AUTHORITATIVE_INFORMATION = 203;
int SC_NO_CONTENT = 204;
int SC_RESET_CONTENT = 205;
int SC_PARTIAL_CONTENT = 206;
int SC_MULTIPLE_CHOICES = 300;
int SC_MOVED_PERMANENTLY = 301;
int SC_MOVED_TEMPORARILY = 302;
int SC_FOUND = 302;
int SC_SEE_OTHER = 303;
int SC_NOT_MODIFIED = 304;
int SC_USE_PROXY = 305;
int SC_TEMPORARY_REDIRECT = 307;
int SC_BAD_REQUEST = 400;
int SC_UNAUTHORIZED = 401;
int SC_PAYMENT_REQUIRED = 402;
int SC_FORBIDDEN = 403;
int SC_NOT_FOUND = 404;
int SC_METHOD_NOT_ALLOWED = 405;
int SC_NOT_ACCEPTABLE = 406;
int SC_PROXY_AUTHENTICATION_REQUIRED = 407;
int SC_REQUEST_TIMEOUT = 408;
int SC_CONFLICT = 409;
int SC_GONE = 410;
int SC_LENGTH_REQUIRED = 411;
int SC_PRECONDITION_FAILED = 412;
int SC_REQUEST_ENTITY_TOO_LARGE = 413;
int SC_REQUEST_URI_TOO_LONG = 414;
int SC_UNSUPPORTED_MEDIA_TYPE = 415;
int SC_REQUESTED_RANGE_NOT_SATISFIABLE = 416;
int SC_EXPECTATION_FAILED = 417;
int SC_INTERNAL_SERVER_ERROR = 500;
int SC_NOT_IMPLEMENTED = 501;
int SC_BAD_GATEWAY = 502;
int SC_SERVICE_UNAVAILABLE = 503;
int SC_GATEWAY_TIMEOUT = 504;
int SC_HTTP_VERSION_NOT_SUPPORTED = 505;
常见应用
1、向浏览器输出信息
1、编写 Servlet
public class HelloServlet extends HttpServlet {
@Override
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws IOException, ServletException {
response.setContentType("text/html");
//response.getWriter()使用该方法向页面响应数据
PrintWriter out = response.getWriter();//创建响应流
out.println("<html>");
out.println("<head>");
out.println("<title>Hello World!</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>Hello World!</h1>");
out.println("</body>");
out.println("</html>");
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
2、编写配置文件 web.xml 配置 Servlet 映射路径
<!-- servlet 和 servlet-mapping 中的 servlet-name 必须一样-->
<!--注册 Servlet-->
<servlet>
<servlet-name>hello</servlet-name>
<servlet-class>com.hkp.servlet.HelloServlet</servlet-class>
</servlet>
<!-- servlet 的请求路径-->
<servlet-mapping>
<servlet-name>hello</servlet-name>
<url-pattern>/hello</url-pattern>
</servlet-mapping>
2、实现重定向
一个 web 资源收到客户端的请求后,他会通知客户端去访问另外一个 web 资源,这个过程叫做 重定向;
void sendRedirect(String var1) throws IOException;
案例
1、编写 Servlet
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
public class RedirectServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
//重定向的地址 :req.getContextPath() 是Tomcat中的项目名 /gp(在 web.xml 中配置的映射路径) 这个 Servlet 中
resp.sendRedirect(req.getContextPath()+"/gp");
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
2、配置 web.xml 文件
<servlet>
<servlet-name>red</servlet-name>
<servlet-class>com.hkp.servlet.RedirectServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>red</servlet-name>
<url-pattern>/red</url-pattern>
</servlet-mapping>
3、启动测试
HttpServletRequest : 请求
代表客户端的请求,用户通过 http 协议访问服务器,http请求中的所有信息会被封装到 HttpServletRequest 中,通过 HttpServletRequest 的方法,获取客户端的参数信息。
接收参数和转发
1、在 index.jsp 中编写一个表单,模拟发送请求
<%@ page contentType="text/html;charset=UTF-8"
language="java" pageEncoding="utf-8" %>
<html>
<head>
<title>第一个Servlet</title>
</head>
<body>
<%--这里提交的路径,需要寻找到项目的路径--%>
<%--${pageContext.request.contextPath}代表当前的项目--%>
<%--/login代表web.xml 中配置的servlet映射--%>
<form action="${pageContext.request.contextPath}/login" method="get">
用户名 :<input type="text" name="username"><br/>
密码 :<input type="password" name="password"><br/>
爱好 :
<input type="checkbox" name="hobby" value="唱歌">唱歌
<input type="checkbox" name="hobby" value="跳舞">跳舞
<input type="checkbox" name="hobby" value="代码">代码
<br/>
<input type="submit">
</form>
</body>
</html>
使用 ${pageContext.request.contextPath} 这个语法,需要引入依赖 :jsp-api
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jsp-api</artifactId>
<version>2.0</version>
</dependency>
2、写一个成功页面
<h1>success~~~</h1>
3、编写 Servlet
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
public class RequestServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
//处理后台接收乱码问题
req.setCharacterEncoding("utf-8");
resp.setCharacterEncoding("utf-8");
//获取参数
String username = req.getParameter("username");
String password = req.getParameter("password");
String[] hobbies = req.getParameterValues("hobby");
for (String hobby : hobbies) {
System.out.println(hobby);
}
System.out.println(username+":"+password);
//转发到success.jsp 页面去 ;
//注意 :转发的时候不需要写项目地址,只需要写jsp的地址就行
//重定向的时候需要写项目地址
req.getRequestDispatcher("/success.jsp").forward(req,resp);
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
doGet(req, resp);
}
}
4、配置 web.xml
<servlet>
<servlet-name>login</servlet-name>
<servlet-class>com.hkp.servlet.RequestServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>login</servlet-name>
<url-pattern>/login</url-pattern>
</servlet-mapping>
5、启动测试
控制台输出
面试题 :
聊聊重定向和转发的区别?
相同点 :都能实现页面的跳转
不同点 :
- 转发时,地址栏不会发生变化 ; 307
- 重定向,地址栏会发生变化 302
注意
:
- 转发的时候不需要写项目地址,只需要写jsp的地址就行
- 重定向的时候需要写项目地址
//转发
req.getRequestDispatcher("/success.jsp").forward(req,resp);
//重定向的地址 :req.getContextPath() 是Tomcat中的项目名 /gp(在 web.xml 中配置的映射路径) 这个 Servlet 中
resp.sendRedirect(req.getContextPath()+"/gp");