从零开始搭建第一个 JavaWeb 项目

最新推荐文章于 2025-10-08 11:13:36 发布

原创

最新推荐文章于 2025-10-08 11:13:36 发布 · 1.5k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#java #web #java-ee

一、开发环境准备

在开始搭建JavaWeb项目之前，我们需要准备好相应的开发环境，这是项目顺利进行的基础。本指南将详细介绍JDK、Web服务器和IDE的安装配置过程。

（一）JDK安装与配置

JDK（Java Development Kit）是Java开发的核心工具包，包含了Java编译器、运行时环境等必备组件。

1. 下载JDK

访问Oracle官网(https://www.oracle.com/java/technologies/downloads/)，根据自己的操作系统选择合适的JDK版本进行下载。建议选择稳定版本，如JDK 8或JDK 11。对于企业级开发，推荐使用LTS(Long-Term Support)版本以获得长期支持。

2. 安装JDK

运行下载的安装程序，按照提示进行安装。注意：

安装路径尽量选择没有空格和特殊字符的路径，例如"D:\Java\jdk1.8.0_301"
在Windows系统上，安装时建议记录安装路径，方便后续配置
对于Linux系统，可以使用包管理器安装或手动解压安装

3. 配置环境变量

Windows系统配置步骤：

右键"此电脑"→"属性"→"高级系统设置"→"环境变量"
新建系统变量"JAVA_HOME"，变量值为JDK的安装路径，如"D:\Java\jdk1.8.0_301"
编辑系统变量"Path"，在末尾添加"%JAVA_HOME%\bin"和"%JAVA_HOME%\jre\bin"
新建系统变量"CLASSPATH"，变量值为".;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar"（注意前面的点号表示当前目录）

Linux/Mac系统配置：

在~/.bashrc或~/.bash_profile文件中添加：

export JAVA_HOME=/usr/local/jdk1.8.0_301
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

4. 验证安装

打开命令提示符/终端，输入以下命令：

java -version
javac -version

如果能显示出对应的版本信息，则说明JDK安装配置成功。

（二）Web服务器安装

常用的JavaWeb服务器有Tomcat、Jetty等，这里以Tomcat为例进行讲解。

1. 下载Tomcat

访问Apache Tomcat官网(https://tomcat.apache.org/)，选择合适的版本下载：

生产环境建议使用稳定版本(如9.0.x)
开发环境可以尝试最新版本
下载压缩包形式(.zip或.tar.gz)便于安装和卸载

2. 解压安装

将下载的压缩包解压到合适的目录：

Windows示例："D:\Tomcat\apache-tomcat-9.0.54"
Linux/Mac示例："/usr/local/tomcat"

3. 配置环境变量（可选）

新建系统变量"CATALINA_HOME"，变量值为Tomcat的安装目录
在"Path"中添加"%CATALINA_HOME%\bin"(Windows)或"$CATALINA_HOME/bin"(Linux/Mac)

4. 验证安装

进入Tomcat安装目录下的"bin"文件夹
Windows双击"startup.bat"，Linux/Mac执行"./startup.sh"
打开浏览器，输入"http://localhost:8080"
如果能看到Tomcat的欢迎页面，则说明安装成功

5. 常见问题处理

端口冲突：修改conf/server.xml中的8080端口
启动闪退：检查JAVA_HOME配置和日志文件(catalina.out/logs/catalina.log)
权限问题(Linux/Mac)：chmod +x *.sh

（三）IDE选择与配置

常用的Java开发IDE有Eclipse、IntelliJ IDEA等，这里以IntelliJ IDEA为例。

1. 下载安装IntelliJ IDEA

访问JetBrains官网(https://www.jetbrains.com/idea/)，选择合适版本：

社区版(免费)：适合基础Java开发
旗舰版(付费)：提供完整的Web开发支持

2. 配置JDK

打开IntelliJ IDEA
进入"File"→"Project Structure"→"SDKs"
点击"+"号，选择"JDK"
选择之前安装的JDK目录，完成JDK配置

3. 配置Tomcat

进入"Run"→"Edit Configurations"
点击"+"号，选择"Tomcat Server"→"Local"
在"Application Server"中点击"Configure"
选择Tomcat的安装目录，完成Tomcat配置

4. 创建JavaWeb项目

选择"File"→"New"→"Project"
选择"Java Enterprise"
勾选"Web Application"选项
配置项目名称和位置
完成项目创建

5. 运行测试

创建简单的Servlet或JSP文件
配置部署描述符(web.xml)
点击运行按钮，选择配置好的Tomcat服务器
在浏览器中访问测试页面验证配置

通过以上步骤，您已经完成了JavaWeb开发环境的完整配置，可以开始进行项目开发了。

二、创建 JavaWeb 项目

（一）使用 IDE 创建项目详细步骤

启动 IntelliJ IDEA
- 双击桌面图标或通过开始菜单启动
- 如果是首次使用，会显示欢迎界面；否则会显示最近项目列表
新建项目
- 点击 "Create New Project" 按钮
- 在弹出的新建项目对话框中：
  - 左侧项目类型选择 "Java Enterprise"
  - 右侧模板选择 "Web Application"
  - 在下方配置区域：
    - 选择已安装的 JDK（建议使用 JDK 8 或以上版本）
    - 选择已配置的 Tomcat 服务器（如未配置，可点击 "New" 按钮添加）
    - 勾选 "Create web.xml" 选项（如需使用传统部署描述符）
项目配置
- 点击 "Next" 进入项目命名页面
- 输入项目名称（如 "MyWebApp"）
- 指定项目存储路径（建议使用不含空格和特殊字符的路径）
- 选择项目类型（Maven 或普通 Java 项目）
- 点击 "Finish" 完成创建
初始项目验证
- 等待 IDEA 完成项目初始化
- 检查项目视图中是否生成基础目录结构
- 确认自动生成的 index.jsp 文件是否正常显示

（二）项目结构详细解析

源代码目录 (src/main/java)
- 包结构示例：
  - com.example.controller：存放 Servlet 控制器
  - com.example.service：业务逻辑层
  - com.example.dao：数据访问层
  - com.example.model：实体类
- 典型文件：
  - UserServlet.java：处理用户相关请求的Servlet
  - ProductService.java：商品业务逻辑实现
资源目录 (src/main/resources)
- 配置文件类型：
  - database.properties：数据库连接配置
  - log4j2.xml：日志系统配置
  - spring-context.xml：Spring框架配置
  - mybatis-config.xml：MyBatis框架配置
- 特殊目录：
  - /static：存放静态资源（CSS/JS/图片）
  - /templates：存放模板文件（如Thymeleaf模板）
Web应用目录 (src/main/webapp)
- 主要子目录：
  - /WEB-INF：
    - web.xml：配置示例：
```
<web-app>
  <servlet>
    <servlet-na
```