Eclipse 创建基于 Maven 的 Web 项目(动态)

前言

本文主要介绍如何使用 Eclipse 创建基于 Maven 的 Web 项目(动态),适用于任何版本的 Eclipse。

快速开始

创建 Maven Web 项目

  • 创建 Maven 项目,并自定义工作空间的位置

  • 选择 Web 项目的骨架

  • 设置 Group IdArtifact Id

提示

  • Group Id:项目组织唯一的标识符,实际对应 Java 的包的结构,是 main 目录里 java 的目录结构
  • Artifact Id:项目的唯一的标识符,实际对应项目的名称,就是项目根目录的名称

完善项目的目录结构

创建 java 目录

选中项目 -> 右击 -> Properties - Java Builder Path -> Libraries -> JRE System Library -> Edit -> 选中 Alternate JRE -> 选择本地的 JDK 版本 -> Finish –> Apply -> Apply and Close

完成上述步骤后,在项目内会自动显示出 src/main/javasrc/test/java 目录。这些目录并不是没有创建而是默认被隐藏了,由于创建 Maven 项目时使用了 Eclipse 里的默认模板,而默认模板的 JRE 版本比较低,默认被设置为隐藏造成的,详细说明请看这里

创建 resources 目录

选中项目 -> 右击 -> New -> Source Folde,然后手动创建以下的资源文件目录:

  • src/main/resources
  • src/test/resources

完善后的项目目录结构

配置 Maven Web 项目

更改 JDK 的版本

在 Maven 的 pom.xml 配置文件里添加以下内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<properties>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
</properties>

<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.0</version>
<configuration>
<source>11</source>
<target>11</target>
</configuration>
</plugin>
</plugins>

更改 Servlet 的版本

在 Maven 的 pom.xml 配置文件里添加以下内容:

1
2
3
4
5
6
 <dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.0.1</version>
<scope>provided</scope>
</dependency>

更改 web.xml 配置文件

选中项目 -> 右击 -> Properties -> Project Facets -> 将 Dynamic Web Module 前边的勾去掉,然后修改为 3.0 版本 -> 再修改 Java 的版本 -> Apply

再次勾选 Dynamic Web Module 前边的勾,下边会立刻出现一个 Further configuration available 超链接,然后点击它

更改 Content directory 的路径,并勾选要求生成 web.xml 配置文件,然后点击 OK 按钮

最后编辑 web.xml 配置文件,将下边的代码替换掉原有的配置内容

1
2
3
4
5
6
7
8
<?xml version="1.0" encoding="UTF-8"?>  
<web-app
version="3.0"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://JAVA.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">

</web-app>

运行 Maven Web 项目

添加 Tomcat 运行环境

选中项目 -> 右击 -> Properties -> Server -> Runtime Environments -> Add

选择 Tomcat 服务器的目标版本,然后点击 Next 按钮

选择本地 Tomcat 服务器所在的位置,最后点击 Finish -> Apply and Close 按钮

部署项目到 Tomcat 服务器

创建本地的 Tomcat 服务器

选择 Tomcat 服务器的目标版本,并选中上面已创建的 Tomcat 运行环境

将项目移动到本地的 Tomcat 服务器

点击 Finish 按钮完成配置

Tomcat 服务器运行 Web 项目

选中项目 -> 右击 -> Run As -> Run on Server -> 选择本地的 Tomcat 服务器 -> Finish

项目成功启动后,Eclipse 的控制台会输出如下的日志信息

打开浏览器访问 http://localhost:8080/ssm-study,其中的 ssm-study 是项目名称

最终的项目目录结构

参考博客