Maven（四）：Maven的使用（中）

  • 前言
  • 一、实验四：创建 Maven 版的 Web 工程
    • 1、说明
    • 2、操作
    • 3、生成的pom.xml
    • 4、生成的Web工程的目录结构
    • 5、创建 Servlet
      • 5.1 在 main 目录下创建 java 目录
      • 5.2 在 java 目录下创建 Servlet 类所在的包的目录
      • 5.3 在包下创建 Servlet 类
      • 5.4 在 web.xml 中注册 Servlet
    • 6、在 index.jsp 页面编写超链接
    • 7、编译
    • 8、配置对 servlet-api.jar 包的依赖
    • 9、将 Web 工程打包为 war 包
    • 10、将 war 包部署到 Tomcat 上运行
  • 二、实验五：让 Web 工程依赖 Java 工程
    • 1、观念
    • 2、操作
    • 3、在 Web 工程中，编写测试代码
      • 3.1 补充创建目录
      • 3.2 确认 Web 工程依赖了 junit
      • 3.3 创建测试类
    • 4、执行Maven命令
      • 4.1 测试命令
      • 4.2 打包命令
      • 4.3 查看当前 Web 工程所依赖的 jar 包的列表
      • 4.4 以树形结构查看当前 Web 工程的依赖信息

前言

本博主将用CSDN记录软件开发求学之路上亲身所得与所学的心得与知识，有兴趣的小伙伴可以关注博主！也许一个人独行，可以走的很快，但是一群人结伴而行，才能走的更远！

一、实验四：创建 Maven 版的 Web 工程

1、说明

使用 mvn archetype:generate 命令生成 Web 工程时，需要使用一个专门的 archetype。这个专门生成 Web工程骨架的 archetype 可以参照官网看到它的用法：

参数 archetypeGroupId、archetypeArtifactId、archetypeVersion 用来指定现在使用的 maven-archetype-webapp 的坐标。

2、操作

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

然后运行生成工程的命令：

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

下面的操作按照提示执行：

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包形式

<packaging>war</packaging>

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

webapp 目录下有 index.jsp

WEB-INF 目录下有 web.xml

5、创建 Servlet

5.1 在 main 目录下创建 java 目录

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

5.3 在包下创建 Servlet 类

package com.atguigu.maven;import javax.servlet.http.HttpServlet;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import javax.servlet.ServletException;import java.io.IOException;public class HelloServlet extends HttpServlet{protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {response.getWriter().write("hello maven web");}}

5.4 在 web.xml 中注册 Servlet

<servlet><servlet-name>helloServlet</servlet-name><servlet-class>com.atguigu.maven.HelloServlet</servlet-class></servlet><servlet-mapping><servlet-name>helloServlet</servlet-name><url-pattern>/helloServlet</url-pattern></servlet-mapping>

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

<html><body><h2>Hello World!</h2><a href="helloServlet">Access Servlet</a></body></html>

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

7、编译

此时直接执行 mvn compile 命令出错：

程序包 javax.servlet.http 不存在程序包 javax.servlet 不存在找不到符号符号: 类 HttpServlet……

上面的错误信息说明：我们的 Web 工程用到了 HttpServlet 这个类，而 HttpServlet 这个类属于servlet-api.jar 这个 jar 包。此时我们说，Web 工程需要依赖 servlet-api.jar 包。

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

对于不知道详细信息的依赖可以到https://mvnrepository.com/网站查询。使用关键词搜索，然后在搜索结果列表中选择适合的使用。

比如，我们找到的 servlet-api 的依赖信息：

<dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>3.1.0</version><scope>provided</scope></dependency>

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

9、将 Web 工程打包为 war 包

运行 mvn package 命令，生成 war 包的位置如下图所示：

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

将 war 包复制到 Tomcat/webapps 目录下

启动 Tomcat：


通过浏览器尝试访问：http://localhost:8080/pro02-maven-web/index.jsp

二、实验五：让 Web 工程依赖 Java 工程

1、观念

明确一个意识：从来只有 Web 工程依赖 Java 工程，没有反过来 Java 工程依赖 Web 工程。本质上来说，Web 工程依赖的Java 工程其实就是 Web 工程里导入的 jar 包。最终 Java 工程会变成 jar 包，放在 Web 工程的WEB-INF/lib 目录下。

2、操作

在 pro02-maven-web 工程的 pom.xml 中，找到 dependencies 标签，在 dependencies标签中做如下配置：

<dependency><groupId>com.atguigu.maven</groupId><artifactId>pro01-maven-java</artifactId><version>1.0-SNAPSHOT</version></dependency>

3、在 Web 工程中，编写测试代码

3.1 补充创建目录

pro02-maven-web\src\test\java\com\atguigu\maven

3.2 确认 Web 工程依赖了 junit

 <dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version><scope>test</scope></dependency>

3.3 创建测试类

把 Java 工程的 CalculatorTest.java 类复制到 pro02-maven-wb\src\test\java\com\atguigu\maven 目录下

4、执行Maven命令

4.1 测试命令

mvn test

说明：测试操作中会提前自动执行编译操作，测试成功就说明编译也是成功的。

4.2 打包命令

mvn package

通过查看 war 包内的结构，我们看到被 Web 工程依赖的 Java 工程确实是会变成 Web 工程的 WEB-INF/lib 目录下的jar 包。

4.3 查看当前 Web 工程所依赖的 jar 包的列表

mvn dependency:list

[INFO] The following files have been resolved:[INFO] org.hamcrest:hamcrest-core:jar:1.3:test[INFO] javax.servlet:javax.servlet-api:jar:3.1.0:provided[INFO] com.atguigu.maven:pro01-maven-java:jar:1.0-SNAPSHOT:compile[INFO] junit:junit:jar:4.12:test

说明：javax.servlet:javax.servlet-api:jar:3.1.0:provided 格式显示的是一个 jar包的坐标信息。格式是：
groupId:artifactId:打包方式:version:依赖的范围

这样的格式虽然和我们 XML 配置文件中坐标的格式不同，但是本质上还是坐标信息，大家需要能够认识这样的格式，将来从 Maven命令的日志或错误信息中看到这样格式的信息，就能够识别出来这是坐标。进而根据坐标到Maven仓库找到对应的jar包，用这样的方式解决我们遇到的报错的情况。

4.4 以树形结构查看当前 Web 工程的依赖信息

mvn dependency:tree

[INFO] com.atguigu.maven:pro02-maven-web:war:1.0-SNAPSHOT [INFO] +- junit:junit:jar:4.12:test [INFO] | \- org.hamcrest:hamcrest-core:jar:1.3:test [INFO] +- javax.servlet:javax.servlet-api:jar:3.1.0:provided [INFO] \- com.atguigu.maven:pro01-maven-java:jar:1.0-SNAPSHOT:compile

我们在 pom.xml 中并没有依赖 hamcrest-core，但是它却被加入了我们依赖的列表。原因是：junit依赖了hamcrest-core，然后基于依赖的传递性，hamcrest-core 被传递到我们的工程了。