1、说明

使用 mvn archetype:generate 命令生成 Web 工程时,需要使用一个专门的 archetype。这个专门生成 Web 工程骨架的 archetype 可以参照官网看到它的用法:
实验四:创建 Maven 版的 Web 工程 - 图1
参数 archetypeGroupId、archetypeArtifactId、archetypeVersion 用来指定现在使用的 maven-archetype-webapp 的坐标。

2、操作

注意:如果在上一个工程的目录下执行 mvn archetype:generate 命令,那么 Maven 会报错:不能在一个非 pom 的工程下再创建其他工程。所以不要再刚才创建的工程里再创建新的工程,请回到工作空间根目录来操作。
然后运行生成工程的命令:

  1. mvn archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-webapp -DarchetypeVersion=1.4

下面的操作按照提示执行:
TIP
Define value for property ‘groupId’: com.atguigu.maven
Define value for property ‘artifactId’: pro02-maven-web
Define value for property ‘version’ 1.0-SNAPSHOT: :【直接回车,使用默认值】
Define value for property ‘package’ com.atguigu.maven: :【直接回车,使用默认值】
Confirm properties configuration:
groupId: com.atguigu.maven
artifactId: pro02-maven-web
version: 1.0-SNAPSHOT
package: com.atguigu.maven
Y: :【直接回车,表示确认】

3、生成的pom.xml

确认打包的方式是war包形式

  1. <packaging>war</packaging>

4、生成的Web工程的目录结构

image.png
webapp 目录下有 index.jsp
WEB-INF 目录下有 web.xml

5、创建 Servlet

①在 main 目录下创建 java 目录

image.png

②在 java 目录下创建 Servlet 类所在的包的目录

image.png

③在包下创建 Servlet 类

  1. package com.atguigu.maven;
  2. import javax.servlet.http.HttpServlet;
  3. import javax.servlet.http.HttpServletRequest;
  4. import javax.servlet.http.HttpServletResponse;
  5. import javax.servlet.ServletException;
  6. import java.io.IOException;
  7. public class HelloServlet extends HttpServlet{
  8. protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  9. response.getWriter().write("hello maven web");
  10. }
  11. }

④在 web.xml 中注册 Servlet

  1. <servlet>
  2. <servlet-name>helloServlet</servlet-name>
  3. <servlet-class>com.atguigu.maven.HelloServlet</servlet-class>
  4. </servlet>
  5. <servlet-mapping>
  6. <servlet-name>helloServlet</servlet-name>
  7. <url-pattern>/helloServlet</url-pattern>
  8. </servlet-mapping>

6、在 index.jsp 页面编写超链接

  1. <html>
  2. <body>
  3. <h2>Hello World!</h2>
  4. <a href="helloServlet">Access Servlet</a>
  5. </body>
  6. </html>

TIP
JSP全称是 Java Server Page,和 Thymeleaf 一样,是服务器端页面渲染技术。这里我们不必关心 JSP 语法细节,编写一个超链接标签即可。

7、编译

此时直接执行 mvn compile 命令出错:
DANGER
程序包 javax.servlet.http 不存在
程序包 javax.servlet 不存在
找不到符号
符号: 类 HttpServlet
……
上面的错误信息说明:我们的 Web 工程用到了 HttpServlet 这个类,而 HttpServlet 这个类属于 servlet-api.jar 这个 jar 包。此时我们说,Web 工程需要依赖 servlet-api.jar 包。
实验四:创建 Maven 版的 Web 工程 - 图5

8、配置对 servlet-api.jar 包的依赖

对于不知道详细信息的依赖可以到https://mvnrepository.com/网站查询。使用关键词搜索,然后在搜索结果列表中选择适合的使用。
实验四:创建 Maven 版的 Web 工程 - 图6
比如,我们找到的 servlet-api 的依赖信息:

  1. <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
  2. <dependency>
  3. <groupId>javax.servlet</groupId>
  4. <artifactId>javax.servlet-api</artifactId>
  5. <version>3.1.0</version>
  6. <scope>provided</scope>
  7. </dependency>

这样就可以把上面的信息加入 pom.xml。重新执行 mvn compile 命令。

9、将 Web 工程打包为 war 包

运行 mvn package 命令,生成 war 包的位置如下图所示:
image.png

10、将 war 包部署到 Tomcat 上运行

将 war 包复制到 Tomcat/webapps 目录下
image.png
启动 Tomcat:
image.png
image.png
通过浏览器尝试访问:http://localhost:8080/pro02-maven-web/index.jsp