Maven（四）：Maven的使用——java工程与Web工程

男娘i 2023-09-26 20:04 77阅读 0赞

### 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` 可以参照官网看到它的用法：

![在这里插入图片描述][722f71388d624ffb8bba0e83280a57de.png]

参数 `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`包形式

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

![在这里插入图片描述][30e74a9599de4c368cda3ca6da9067ab.png]

> `webapp` 目录下有 `index.jsp`
> 
> `WEB-INF` 目录下有 `web.xml`

## 5、创建 Servlet ##

### 5.1 在 main 目录下创建 java 目录 ###

![在这里插入图片描述][cbae2608cc994ecf8115e2024ae5d6e4.png]

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

![在这里插入图片描述][c89b5bf93fc246d79c3716ae5a7b50de.png]

### 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` 包。

![在这里插入图片描述][4c80e234440c4708b33020f1d4d514f3.png]

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

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

![在这里插入图片描述][02202848dcb242fb9df3e5af7972b99d.png]

> 比如，我们找到的 `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` 包的位置如下图所示：

![在这里插入图片描述][77a2b7265ef2490ea4addb7c4f1a4408.png]

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

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

![在这里插入图片描述][4daae4ae6f124bffa62cf2fa11e7bcec.png]

> 启动 `Tomcat`：

![在这里插入图片描述][6cd7109ae44e47f7a45089c0f9d0ae47.png]  
![在这里插入图片描述][b1750fc7ba4e448b8be6583c58805c43.png]

> 通过浏览器尝试访问：`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`

![在这里插入图片描述][63fbc80277e24eb698d0501e06b46c5e.png]

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

![在这里插入图片描述][5b9234769f2342ffa247225b0f4cd1d7.png]

### 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` 被传递到我们的工程了。

[722f71388d624ffb8bba0e83280a57de.png]: https://img-blog.csdnimg.cn/722f71388d624ffb8bba0e83280a57de.png
[30e74a9599de4c368cda3ca6da9067ab.png]: https://img-blog.csdnimg.cn/30e74a9599de4c368cda3ca6da9067ab.png
[cbae2608cc994ecf8115e2024ae5d6e4.png]: https://img-blog.csdnimg.cn/cbae2608cc994ecf8115e2024ae5d6e4.png
[c89b5bf93fc246d79c3716ae5a7b50de.png]: https://img-blog.csdnimg.cn/c89b5bf93fc246d79c3716ae5a7b50de.png
[4c80e234440c4708b33020f1d4d514f3.png]: https://img-blog.csdnimg.cn/4c80e234440c4708b33020f1d4d514f3.png
[https_mvnrepository.com]: https://mvnrepository.com/
[02202848dcb242fb9df3e5af7972b99d.png]: https://img-blog.csdnimg.cn/02202848dcb242fb9df3e5af7972b99d.png
[77a2b7265ef2490ea4addb7c4f1a4408.png]: https://img-blog.csdnimg.cn/77a2b7265ef2490ea4addb7c4f1a4408.png
[4daae4ae6f124bffa62cf2fa11e7bcec.png]: https://img-blog.csdnimg.cn/4daae4ae6f124bffa62cf2fa11e7bcec.png
[6cd7109ae44e47f7a45089c0f9d0ae47.png]: https://img-blog.csdnimg.cn/6cd7109ae44e47f7a45089c0f9d0ae47.png
[b1750fc7ba4e448b8be6583c58805c43.png]: https://img-blog.csdnimg.cn/b1750fc7ba4e448b8be6583c58805c43.png
[63fbc80277e24eb698d0501e06b46c5e.png]: https://img-blog.csdnimg.cn/63fbc80277e24eb698d0501e06b46c5e.png
[5b9234769f2342ffa247225b0f4cd1d7.png]: https://img-blog.csdnimg.cn/5b9234769f2342ffa247225b0f4cd1d7.png