如何配置java Servlet

下面从 概念 → 开发环境 → 基本配置方式 → 示例 → 常见问题 逐步说明如何配置 Java Servlet。

一、什么是 Servlet

Servlet 是运行在 Servlet 容器（如 Tomcat） 中的 Java 程序，用于处理 HTTP 请求和响应。

二、开发环境准备

1. JDK：JDK 8 或以上
2. Servlet 容器：Apache Tomcat（推荐）
3. 构建工具（可选）：
   • Maven（推荐）
   • Gradle
4. IDE（可选）：
   • IntelliJ IDEA
   • Eclipse

三、Servlet 的三种配置方式

✅ 方式一：注解配置（最推荐，Servlet 3.0+）

无需 web.xml，简单清晰。

import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.*;
import java.io.IOException;

@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws IOException {
        resp.getWriter().write("Hello Servlet");
    }
}

访问：

http://localhost:8080/项目名/hello

✅ 方式二：web.xml 配置（传统方式）

适用于老项目或需要集中管理。

web.xml 示例：

<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         version="5.0">

    <servlet>
        <servlet-name>helloServlet</servlet-name>
        <servlet-class>com.example.HelloServlet</servlet-class>
    </servlet>

    <servlet-mapping>
        <servlet-name>helloServlet</servlet-name>
        <url-pattern>/hello</url-pattern>
    </servlet-mapping>
</web-app>

✅ 方式三：Spring Boot（现代主流）

Spring Boot 已内置 Servlet 容器。

@WebServlet("/springHello")
public class MyServlet extends HttpServlet {
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws IOException {
        resp.getWriter().write("Spring Boot Servlet");
    }
}

启动类加：

@ServletComponentScan
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class);
    }
}

四、Maven 项目结构（示例）

src
 └── main
     ├── java
     │   └── com/example/HelloServlet.java
     ├── resources
     └── webapp
         └── WEB-INF
             └── web.xml
pom.xml

Maven 依赖：

<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
    <version>5.0.0</version>
    <scope>provided</scope>
</dependency>

五、Tomcat 部署步骤

1. 打包为 war
2. 放入 Tomcat/webapps
3. 启动 startup.bat / startup.sh
4. 浏览器访问

六、常见配置项

七、常见问题

❌ 404
→ 路径写错 / 未部署 / 项目名不对

❌ 500
→ Servlet 类未编译 / 包名错误

❌ @WebServlet 不生效
→ Tomcat 版本过低（需 7+）

如果你愿意，我可以：

• 给你一个 完整可运行示例
• 对比 Servlet vs Spring MVC
• 教你 用 IDEA 一键创建 Servlet 项目

你现在是 学习阶段 还是 实际项目配置？