目录

  1. 环境概述
  2. 安装 JDK
  3. 安装 Eclipse
  4. 安装 Apache Tomcat
  5. 配置 Eclipse 服务器
  6. 创建 JSP/Servlet 项目
  7. 运行 JSP/Servlet
  8. 常见问题及解决方案
  9. 参考资料

1. 环境概述

在 Eclipse 中开发 JSP 和 Servlet 需要配置以下环境:

  • JDK(Java Development Kit):提供 Java 运行环境。
  • Eclipse IDE for Enterprise Java Developers:支持 JSP/Servlet 开发的 IDE。
  • Apache Tomcat:JSP 和 Servlet 需要运行在 Web 服务器上,推荐使用 Tomcat。

2. 安装 JDK

2.1 下载 JDK

JSP/Servlet 需要 Java 运行环境,推荐安装 JDK 11 或更高版本

下载地址

2.2 安装 JDK

Windows

  1. 下载 JDK 安装包(.exe)。
  2. 运行安装程序,按照提示安装。
  3. 配置环境变量(可选):
    • JAVA_HOME = C:\Program Files\Java\jdk-XX
    • Path 添加 %JAVA_HOME%\bin
    • 在命令行执行 java -version 确认安装成功。

macOS/Linux

  1. 使用 Homebrew(macOS): brew install openjdk@11
  2. 使用 apt(Ubuntu): sudo apt update && sudo apt install openjdk-11-jdk
  3. 确认安装: java -version

3. 安装 Eclipse

3.1 下载 Eclipse

访问 Eclipse 官网 下载 Eclipse IDE for Enterprise Java Developers(Java EE 版)。

3.2 安装 Eclipse

  1. 运行 Eclipse Installer,选择 Eclipse IDE for Enterprise Java Developers
  2. 安装完成后,启动 Eclipse。

4. 安装 Apache Tomcat

4.1 下载 Tomcat

Tomcat 是最常用的 JSP/Servlet 运行环境,建议使用 Tomcat 9 或 10

下载地址Tomcat 官网

选择 Core > zip/tar.gz 下载(不推荐 .exe 安装包)。

4.2 配置 Tomcat

  1. 解压文件(例如 C:\tomcat/opt/tomcat)。
  2. 启动 Tomcat 测试: cd C:\tomcat\bin startup.bat # Windows ./startup.sh # macOS/Linux
  3. 访问 http://localhost:8080/ 确保 Tomcat 运行正常。

5. 配置 Eclipse 服务器

5.1 在 Eclipse 添加 Tomcat

  1. 打开 Eclipse,点击 Window → Preferences
  2. 在左侧导航栏找到 Server → Runtime Environments
  3. 点击 Add,选择 Apache → Tomcat 9.0(或 10.0)
  4. 指定 Tomcat 安装路径(例如 C:\tomcat),点击 Finish

5.2 创建 Tomcat 服务器

  1. Eclipse 左下角 Servers 视图,右键 New → Server
  2. 选择 Apache → Tomcat 9.0(或 10.0),点击 Next
  3. 选择项目(如果还没有,可以跳过),点击 Finish

6. 创建 JSP/Servlet 项目

6.1 创建动态 Web 项目

  1. 文件 → 新建 → 动态 Web 项目
  2. 填写项目名称(例如 JSPDemo)。
  3. 选择 目标运行时(选择 Apache Tomcat 9.0)。
  4. 继续点击 下一步 → 下一步 → 完成

6.2 目录结构

JSPDemo/
 ├── WebContent/
 │   ├── META-INF/
 │   ├── WEB-INF/
 │   │   ├── web.xml
 │   ├── index.jsp
 ├── src/
 │   ├── com.example/
 │   │   ├── HelloServlet.java


7. 运行 JSP/Servlet

7.1 创建 JSP 页面(index.jsp)

  1. WebContent 目录下新建 index.jsp,输入以下代码:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>JSP 测试</title>
</head>
<body>
    <h1>欢迎使用 JSP</h1>
    <p>当前时间: <%= new java.util.Date() %></p>
</body>
</html>

  1. 右键项目,选择 Run As → Run on Server,访问 http://localhost:8080/JSPDemo/index.jsp

7.2 创建 Servlet(HelloServlet.java)

  1. src 目录下创建包 com.example,新建 HelloServlet.java
package com.example;

import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) 
            throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        response.getWriter().println("<h1>Hello, Servlet!</h1>");
    }
}

  1. 右键项目,选择 Run As → Run on Server,访问 http://localhost:8080/JSPDemo/hello

8. 常见问题及解决方案

8.1 Tomcat 启动失败

  • 确保 JAVA_HOMECATALINA_HOME 配置正确。
  • 检查端口 8080 是否被占用,可修改 server.xml<Connector port="8081" protocol="HTTP/1.1" connectionTimeout="20000" />

8.2 JSP 页面 404

  • 确保 index.jsp 放在 WebContent/ 目录下。
  • 确保 web.xml 正确配置。

8.3 Servlet 访问 404

  • 确保 HelloServlet.java 编译后存在 build/classes/com/example/ 目录下。
  • 确保 @WebServlet("/hello") 注解正确。

9. 参考资料

出站链接

其他资源


至此,你已成功搭建 Eclipse JSP/Servlet 开发环境!🚀