您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 綜合教學

JavaWeb 入門：JSP 基礎、Eclipse for Java EE 與 Tomcat 整合完整圖文教程

編輯：Java 綜合教學

前言：為什麼 Android 開發者也要學 JSP？

移動端與服務端交互（HTTP/JSON）是核心技能。理解 JSP/Servlet 如何接收請求、處理業務、響應數據，有助於設計更合理的 API 協議、排查網絡異常。

一、JSP 核心概念

JSP (JavaServer Pages)：HTML 中嵌入 Java 片段（Scriptlet）與標簽庫，經容器編譯為 Servlet 執行。
運行原理：
  1. 瀏覽器請求 .jsp
  2. 容器首次訪問 → 翻譯為 _jspServlet.java → 編譯為 .class
  3. 後續請求直接調用 Servlet 實例的 service()
  4. 輸出 HTML 給瀏覽器

二、Tomcat 安裝與驗證

2.1 下載解壓

官網 tomcat.apache.org 下載二進制壓縮包（apache-tomcat-9.0.x 或 10.1.x），解壓至無中文、無空格路徑（如 D:\dev\apache-tomcat-9.0.85）。

2.2 目錄速覽

目錄	用途
`bin/`	啟動/關閉腳本（`startup.bat/shutdown.bat`）
`conf/`	核心配置 `server.xml`（端口、虛擬主機）、`web.xml`（全局部署描述符）
`lib/`	容器級共享 JAR（Servlet API、JSP API、JDBC 驅動建議放這裡）
`webapps/`	Web 應用部署目錄（WAR 或解壓目錄）
`work/`	JSP 編譯產生的 Java/Class 文件（可安全刪除）
`logs/`	運行日誌（`catalina.out`、`localhost.yyyy-mm-dd.log`）

2.3 環境變量


JAVA_HOME=D:\dev\jdk1.8.0_202
# CATALINA_HOME 可選，建議不設，由啟動腳本自動推導
Path 追加 %JAVA_HOME%\bin

2.4 啟動驗證

雙擊 bin/startup.bat，彈出控制台顯示 Server startup in xxx ms
瀏覽器訪問 https://localhost:8080 → 顯示 Tomcat 首頁 = 成功
關閉：直接關閉控制台窗口，或執行 bin/shutdown.bat

2.5 端口衝突解決


# 修改 conf/server.xml 第 69 行左右
<Connector port="8080" protocol="HTTP/1.1" ... />
# 改為 8081、9090 等未被佔用端口

或 netstat -ano | findstr :8080 找 PID → 任務管理器結束進程。

三、Eclipse for Java EE 整合 Tomcat

Window → Preferences → Server → Runtime Environments → Add
選擇對應 Tomcat 版本（如 Apache Tomcat v9.0）
Browse 選擇 Tomcat 安裝根目錄，JRE 選擇 JDK 1.8
Finish

四、建立動態 Web 專案

File → New → Dynamic Web Project
Project name: JspDemo
Target runtime: 選擇剛添加的 Tomcat
Configuration: 默認
Finish → 彈出 Open Associated Perspective? → Yes

五、JSP 編碼配置（極重要）

Window → Preferences → Web → JSP Files → Encoding: UTF-8
General → Workspace → Text file encoding: Other → UTF-8
新建 hello.jsp 自動包含：


<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html><head><meta charset="UTF-8"><title>Hello JSP</title></head>
<body><% out.println("Hello, JSP!"); %></body></html>

六、部署與運行

專案右鍵 → Run As → Run on Server
選擇 Tomcat → Finish
Eclipse 內置瀏覽器或外部瀏覽器打開 https://localhost:8080/JspDemo/hello.jsp

七、常見 404 原因排查

現象	原因	解決
訪問專案根路徑 404	無 `welcome-file-list` 配置	`web.xml` 添加 `<welcome-file>hello.jsp</welcome-file>`
訪問具體 jsp 404	文件不在 `WebContent/` 或 `src/main/webapp/`	確認文件位置，刷新專案
EL 表達式 ${} 原樣輸出	`web.xml` version < 2.4	升級 `<web-app version="3.1">`

八、JSP 執行原理深度觀察

啟動後查看 work/Catalina/localhost/JspDemo/org/apache/jsp/hello_jsp.java
發現：
  • 繼承 org.apache.jasper.runtime.HttpJspBase（間接實現 Servlet）
  • _jspService() 中包含 HTML 字符串輸出與 Java 邏輯
  • 隱含對象 request/response/session/application/out/page/config/exception 均為局部變量

九、Tomcat 進階配置

9.1 關聯 Javadoc（查看 Servlet API 文檔）

下載 servlet-api-3.1-javadoc.jar（或 tomcat-servlet-api-javadoc.zip）
Eclipse：Project → Properties → Java Build Path → Libraries → servlet-api.jar → Javadoc location → 編輯 → 選中 Javadoc 包

9.2 生產環境優化

server.xml：maxThreads="200"、acceptCount="100"、connectionTimeout="20000"
conf/web.xml：development=false（關閉 JSP 開發模式重編譯）、trimSpaces=true
啟用 Compression、Cache-Control、Gzip 靜態資源壓縮

總結

掌握 Tomcat 安裝 → Eclipse 整合 → 動態 Web 專案 → UTF-8 全鏈路 → 部署驗證 → 404 排查 → work 目錄觀察編譯產物 完整鏈路，即可建立扎實的 JavaWeb 基礎。後續學習方向：
1. Servlet 生命週期、Filter/Listener、Session 管理
2. JSTL/EL 表達式、標簽庫、MVC 分層
3. JDBC/連接池、事務、DAO/Service 設計
4. Spring/Spring MVC 整合、RESTful API 設計