刚入行那会儿,我最头疼的就是搞明白“Servlet交互”这几个字到底在说啥。很多教程上来就甩一堆类和接口,讲完doGet讲doPost,看得人云里雾里。等真正接手项目,要用web.xml方式自己从零搭一个Servlet出来,才发现那些基础概念全串起来了。今天这篇就专门聊这个事:基于web.xml配置方式,把Servlet交互的来龙去脉、完整示例和实操中的坑一次讲清楚。适合刚学完Java基础想入门Web开发的朋友,也适合工作几年一直在用Spring MVC、突然要维护老项目或者面试前想补基础的同学。
1. Servlet交互的前置认知与方案选型
1.1 Servlet在整个Web体系里到底扮演什么角色
我们先别急着写代码,先把位置摆清楚。你的浏览器发一个HTTP请求出去,到服务器返回一个HTML页面,中间这一圈,Servlet就是那个干活的“中间商”。
Tomcat这类Web容器负责监听端口、接收请求、解析HTTP报文,然后把请求信息封装成一个HttpServletRequest对象,把响应通道封装成HttpServletResponse对象,最后找到一个合适的Servlet,把这两个对象塞给它。你的业务逻辑写在Servlet的service、doGet或者doPost方法里,读取请求参数,处理业务,再往response里写内容,Tomcat会把response里写的字节流按HTTP协议格式打包发回浏览器。
所以Servlet交互,本质上就是“容器怎么找到一个Servlet并调用它”和“Servlet怎么从请求里拿数据、怎么把结果写回去”这一整套机制。默认情况下,Servlet是单实例多线程的:一个Servlet类在容器里只会被加载一次、实例化一次,所有请求共用同一个实例,每次请求由容器分配一个线程来执行。
1.2 为什么现在还要学web.xml配置方式
我知道很多新手会问:现在不都是注解@WebServlet或者直接Spring MVC一把梭吗?为什么还要死磕web.xml?
我的回答是:理解web.xml,是理解Servlet机制的最短路径。注解方式本质上是Servlet 3.0以后提供的一个“语法糖”,容器启动时还是得扫描注解、生成和web.xml等价的注册信息。你直接看web.xml,相当于把注册过程摊开了、讲明白了,哪个url-pattern对应哪个servlet-class,一目了然。而且在实际工作中,老项目、政府项目、企业内部系统,用web.xml做配置的依然是大量存在的。你总不想遇到老项目就发怵吧。
还有一个原因:web.xml能配置很多东西,比如load-on-startup设置启动加载顺序、init-param传初始化参数、filter过滤器、listener监听器。这些如果只用注解,有些场景反而不如web.xml直观,尤其是多环境切换和运维调整参数的时候。
1.3 版本选择与环境准备
Servlet版本和Tomcat版本、Java版本是挂钩的,就像齿轮咬合一样。这里给出一张常见对应表,避免你去网上乱搜索踩坑:
| Servlet版本 | Tomcat版本 | Java版本 | 说明 |
|---|---|---|---|
| 2.5 | Tomcat 6.x | Java 5+ | web.xml配置方式,老项目多 |
| 3.0 | Tomcat 7.x | Java 6+ | 开始支持注解,但web.xml仍是主流 |
| 3.1 | Tomcat 8.x | Java 7+ | 支持异步处理增强 |
| 4.0 | Tomcat 9.x | Java 8+ | HTTP/2支持 |
| 5.0 | Tomcat 10.x | Java 11+ | Jakarta EE 9,包名改为jakarta.* |
这里有个大坑:Tomcat 10及以上版本,Servlet的包名从javax.servlet改成了jakarta.servlet。你如果拿Tomcat 9的代码部署到Tomcat 10,直接报ClassNotFoundException。我这篇示例用的是Servlet 4.0 + Tomcat 9 + Java 8这套经典组合,包名还是javax.servlet,你网上搜到的多数资料也是这个体系,学习成本最低。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 工程骨架与web.xml核心配置
2.1 项目目录结构
Servlet项目最标准的目录结构,就是Maven的标准Web结构。如果你是手动建目录,也请严格按这个规矩来,别自创一套。Tomcat检查一个Web应用是否合法,就是看这些目录,缺了WEB-INF/web.xml,它直接拒绝部署。
text复制servlet-demo
├── pom.xml
└── src
└── main
├── java
│ └── com
│ └── demo
│ └── servlet
│ └── LoginServlet.java
└── webapp
├── index.html
├── login.jsp
├── WEB-INF
│ └── web.xml
注意几个细节:编译后的class文件必须放在WEB-INF/classes目录下,第三方jar包必须放在WEB-INF/lib目录下。Tomcat的ClassLoader是从这两个目录加载类的,你放错地方,它看都看不到你的Servlet。如果你是直接手动编译部署,这一步能拦下不少报404的人。
Maven的pom.xml里,最核心就是引入Servlet API。记住,这个依赖的scope必须是provided,因为Tomcat本身已经带了一套Servlet API实现。你如果把scope写成compile,打包出来WEB-INF/lib下面会多出一个servlet-api.jar,和Tomcat自带的那套冲突,经常会出现一些莫名其妙的类加载问题,比如NoSuchMethodError。我见过不止一个同事栽在这上面。
xml复制<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
2.2 web.xml关键配置逐项拆解
写Servlet的web.xml配置,本质上就是在向容器“注册”Servlet并声明“谁来响应哪个URL”。满配的web.xml长这样:
xml复制<?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">
<display-name>Servlet Demo</display-name>
<servlet>
<servlet-name>LoginServlet</servlet-name>
<servlet-class>com.demo.servlet.LoginServlet</servlet-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>LoginServlet</servlet-name>
<url-pattern>/login</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>
我来把这几个标签讲透:
<servlet>和<servlet-mapping>必须成对出现。<servlet>是“声明有这么个类”,<servlet-mapping>是“规定这个类的哪个URL归它管”。两者通过<servlet-name>关联。你光写<servlet>不写`<servle
