Maven学习及分模块创建

一、引言

---

1.1 项目管理问题

写项目时，我们需要引用各种 jar 包，尤其是比较大的工程，引用的 jar 包往往有几十个乃至上百个， 每用
到一种 jar 包，都需要手动引入工程目录，而且经常遇到各种让人抓狂的 jar 包冲突，版本冲突。

写完项目我们后面还需要把代码与各种配置文件、资源整合到一起，定型打包，如果是 web项目，还需要发布到服务器

思路：

​ 小笔记本：

​ 某某jar 在哪里 mybatis 0.x1.

​ mysql 02.x.y

1.1.1 繁琐

要为每个项目手动导入所需的jar，需要搜集全部jar

1.1.2 复杂

项目中的jar如果需要版本升级，就需要再重新搜集jar

1.1.3 冗余

相同的jar在不同的项目中保存了多份

1.2 项目管理方案

Java项目需要一个统一的便捷的管理工具：Maven

Maven的好处
​ Maven 的一个核心特性就是依赖管理。当我们涉及到多模块的项目（包含成百个模块或者子项目），管理依赖就变成一项困难的任务。Maven 展示出了它对处理这种情形的高度控制。
​ 传统的 WEB 项目中，我们必须将工程所依赖的 jar 包复制到工程中，导致了工程变得很大。maven 工程中不直接将 jar 包导入到工程中，而是通过在 pom.xml 文件中添加所需 jar 包的坐标，这样就很好的避免了 jar 直接引入进来，在需要用到 jar 包的时候，只要查找 pom.xml 文件，再通过 pom.xml 文件中的坐标，到一个专门用于”存放 jar 包的仓库”(maven 仓库)中根据坐标从而找到这些 jar 包，再把这些 jar 包拿去运行。
​
Maven常应用于大型项目，可以提高开发效率，也就是Maven的分模块开发，例如：
传统项目 按层分： dao service web
互联网项目 按业务分： 用户管理 订单管理 支付管理 …

二、介绍

---

Maven这个单词来自于意第绪语（犹太语），意为知识的积累.

​ Maven是一个基于项目对象模型（POM）的概念的纯java开发的开源的项目管理工具。

​ 主要用来管理java项目，进行依赖管理(jar包依赖管理)和项目构建(项目编译、打包、测试、部署)。此外还能分模块开发，提高开发效率。

项目的一键构建
​ 我们的项目，往往都要经历编译、测试、运行、打包、安装 ，部署等一系列过程。
​
什么是构建？
​ 指的是项目从编译、测试、运行、打包、安装 ，部署整个过程都交给 maven 进行管理，这个过程称为构建。

一键构建
​ 指的是整个构建过程，使用 maven 一个命令可以轻松完成整个工作。

三、Maven安装

---

3.1 下载Maven

下载Maven

http://us.mirrors.quenda.co/apache/maven/maven-3/3.5.4/binaries/
)]

3.2 Maven安装

3.2.1 解压

注意： Maven 下载后，将 Maven 解压到一个没有中文没有空格的路径下，比如 D:\maven 下面

解压后，有如下目录：

`bin:含有mvn运行的脚本`
`boot:含有plexus-classworlds类加载器框架,Maven 使用该框架加载自己的类库。`
`conf:含有settings.xml配置文件`
`lib:含有Maven运行时所需要的java类库`

3.2.2 环境变量

maven依赖java环境，所以要确保java环境已配置好

使用maven必须配置JDK。

在环境变量 path 配置 MAVEN 安装目录的bin目录（和之前jdk的配置类似）

%MAVEN_HOME%\bin

3.2.3 测试

查看maven版本信息

mvn -v

四、Maven配置

---

4.1 本地仓库

maven的conf目录中有 settings.xml ，是maven的配置文件，做如下配置：

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 			  	http://maven.apache.org/xsd/settings-1.0.0.xsd">
  
  
  <localRepository>D:\Program Files\maven\myrepositorylocalRepository>

4.2 JDK配置

在 标签中 增加 一个 标签，限定maven项目默认的jdk版本。

内容如下：

<profiles>
    
	<profile>    
        <id>myjdkid>    
        <activation>    
            <activeByDefault>trueactiveByDefault>    
            <jdk>1.8jdk>    
        activation>    
        <properties>    
            <maven.compiler.source>1.8maven.compiler.source>    
            <maven.compiler.target>1.8maven.compiler.target>
            <maven.compiler.compilerVersion>1.8maven.compiler.compilerVersion> 
        properties>    
    profile>
profiles>

<activeProfiles>
    <activeProfile>myjdkactiveProfile>
activeProfiles>

五、仓库

---

5.1 概念

• 存储依赖的地方，体现形式就是本地的一个目录。

• 仓库中不仅存放依赖，而且管理着每个依赖的唯一标识(坐标)，Java项目凭坐标获取依赖。

5.2 仓库分类

maven 中仓库的类型：

本地仓库 ：用来存储从远程仓库或中央仓库下载的插件和 jar 包，项目使用一些插件或 jar 包，
优先从本地仓库查找
默认本地仓库位置在 $user.dir/.m2/repository，${user.dir}表示windows 用户目录。
注意：可在 MAVE_HOME/conf/settings.xml 文件中配置本地仓库位置。

远程仓库：如果本地需要插件或者 jar 包,本地仓库没有，默认去远程仓库下载。
远程仓库可以在互联网内也可以在局域网内。

中央仓库 ：在 maven 软件中内置一个远程仓库地址 http://repo1.maven.org/maven2 ，它是中央仓库，服务于整个互联网，它是由 Maven 团队自己维护，里面存储了非常全的 jar 包，它包含了世界上大部分流行的开源项目构件。

仓库分类

当需要依赖时，会从仓库中取查找，优先顺序为：

本地仓库 > 私服(如果配置了的话) > 公共仓库(如果配置了的话) > 中央仓库

5.3 本地仓库

即在settings.xml 中配置的目录。

使用过了的依赖都会自动存储在本地仓库中，后续可以复用。

5.4 远程仓库

5.4.1 中央仓库

• Maven 中央仓库是由 Maven 社区提供的仓库，不用任何配置，maven中内置了中央仓库的地址。

  其中包含了绝大多数流行的开源Java构件。

• https://mvnrepository.com/ 可以搜索需要的依赖的相关信息（仓库搜索服务）

  http://repo.maven.apache.org/maven2/ 中央仓库地址

5.4.2 公共仓库【重点】

• 除中央仓库之外，还有其他远程仓库。
  比如aliyun仓库（http://maven.aliyun.com/nexus/content/groups/public/）

• 中央仓库在国外，下载依赖速度过慢，所以都会配置一个国内的公共仓库替代中央仓库。

<mirrors>
	<mirror>
        <id>aliyunid>  
        
        <mirrorOf>centralmirrorOf>    
        <name>Nexus aliyunname>
        
        <url>http://maven.aliyun.com/nexus/content/groups/publicurl>  
    mirror>
mirrors>

5.4.3 私服【了解】

公司范围内共享的仓库，不对外开放。

可以通过 Nexus来创建、管理一个私服。

六、Idea-Maven

---

6.1 在Idea中关联Maven

在idea中关联本地安装的maven，后续就可以通过idea使用maven来管理项目

Maven 工程的目录结构

作为一个 maven 工程，它的 src目录和 pom.xml 是必备的。
进入 src目录后，我们发现它里面的目录结构如下：

src/main/java —— 存放项目的.java 文件
src/main/resources —— 存放项目资源文件，如 spring, hibernate 配置文件
src/test/java —— 存放所有单元测试.java 文件，如 JUnit 测试类
src/test/resources —— 测试资源文件
target —— 项目输出位置，编译后的class 文件会输出到此目录
pom.xml——maven 项目核心配置文件

注意：如果是普通的 java 项目，那么就没有webapp 目录。

在全局设置中，关联Maven

6.2 创建Maven项目

6.2.1 新建项目

新建项目，要选择 Maven 选项

如下选项
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-UQRKdTwr-1689164470827)(Pictures/创建maven项目1.jpg)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ORXVELAj-1689164470448)(image-20230313142735029.png)]

6.2.2 指定项目名

设置项目名

6.2.3 项目位置

项目位置如下

6.2.4 项目结构

• src/main/java 存放源代码，建包，放项目中代码(service,dao,User,…)

• src/main/resources 书写配置文件，项目中的配置文件(jdbc.properties)

• src/test/java 书写测试代码，项目中测试案例代码

• src/test/resources 书写测试案例相关配置文件

• 目根/pom.xml (project object model) maven项目核心文件，其中定义项目构建方式，声明依赖等

• 注意：项目中的建包，建类，执行，都和普通项目无差异

项目结构如下：

6.2.5 pom.xml文件

pom 基本配置
pom.xml 是 Maven 项目的核心配置文件，位于每个工程的根目录，基本配置如下

  <project > ：文件的根节点 .
	<modelversion > ： pom.xml 使用的对象模型版本
	<groupId > ：项目名称，一般写项目的域名
	<artifactId > ：模块名称，子项目名或模块名称
	<version > ：产品的版本号 
	<packaging > ：打包类型，一般有 jar、war、pom 等
<name > ：项目的显示名，常用于 Maven 生成的文档。
<description > ：项目描述，常用于 Maven 生成的文档
<dependencies> ：项目依赖构件配置，配置项目依赖构件的坐标
<build> ：项目构建配置，配置编译、运行插件等。

例如：配置tomcat7插件和jdk1.8(不用配置 )
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.tomcat.mavengroupId>
        <artifactId>tomcat7-maven-pluginartifactId>
        <version>2.2version>
        <configuration>
          <port>8888port>
        configuration>
      plugin>
      <plugin>
          <groupId>org.apache.maven.pluginsgroupId>
          <artifactId>maven-compiler-pluginartifactId>
          <configuration>
            <target>1.8target>
            <source>1.8source>
            <encoding>UTF-8encoding>
          configuration>
        plugin>
    plugins>
  build>

在 pom.xml 文件中锁定 jar 包版本配置


<properties>
    <mybatis.version>3.4.5mybatis.version>
properties>


<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mybatisgroupId>
            <artifactId>mybatisartifactId>
            <version>${mybatis.version}version>
        dependency>
    dependencies>
dependencyManagement>


<dependencies>
	<dependency>
        <groupId>org.mybatisgroupId>
        <artifactId>mybatisartifactId>
        <version>${mybatis.version}version>
	dependency>
dependencies>

6.2.6 项目类型

根据项目类型，在pom.xml中做出对应配置，添加配置：war/jar

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0modelVersion>
    <groupId>com.itfenggroupId>
    <artifactId>test01artifactId>
    <version>1.0-SNAPSHOTversion>
    
    
    <packaging>jarpackaging>
project>

6.3 导入依赖jar

建好项目后，需要导入需要的jar，要通过坐标

• 每个构件都有自己的坐标 = groupId + artifactId + version = 项目标识 + 项目名 + 版本号

• 在maven项目中只需要配置坐标，maven便会自动加载对应依赖。删除坐标则会移除依赖

6.3.1 查找依赖

依赖查找服务：https://mvnrepository.com/ ，获得依赖的坐标，在maven项目中导入。

查找依赖坐标
)]

6.3.2 导入依赖

在项目的pom文件中，增加依赖

在项目的pom.xml文件添加依赖

6.3.3 同步依赖

引入坐标后，同步依赖，确认导入。

窗口右下角弹窗，刷新依赖，使新加的配置被maven加载

####6.4 创建web项目

6.4.1 打包方式

pom.xml中设置 war

web项目打包方式为：war

6.4.2 web依赖

导入 JSP 和 Servlet 和 JSTL依赖，使项目具有web编译环境

<project ...>
    ...
    <packaging>warpackaging>

	
    <dependencies>
        <dependency>
            
            <groupId>javax.servletgroupId>
            <artifactId>jstlartifactId>
            <version>1.2version>
        dependency>
        <dependency>
            
            <groupId>javax.servletgroupId>
            <artifactId>javax.servlet-apiartifactId>
            <version>3.1.0version>
            <scope>providedscope>
        dependency>
        <dependency>
            
            <groupId>javax.servletgroupId>
            <artifactId>jsp-apiartifactId>
            <version>2.0version>
            <scope>providedscope>
        dependency>
    dependencies>
project>

6.4.3 webapp目录

按照maven规范，新建web项目特有目录

新建如下目录和文件

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
	
web-app>

6.4.4 定义Servlet和Jsp

照常定义即可

6.5 部署web项目

6.5.1 新增Tomcat

新增Tomcat

6.5.2 部署web项目

部署web项目

6.5.3 启动Tomcat

启动Tomcat

6.6 依赖生命周期

6.6.1 概念

Jar包生效的时间段，即Jar的生命周期

依赖范围
在 pom.xml 文件中添加坐标时需要指定依赖范围（scope标签），依赖范围包括：

compile：编译范围，指 A在编译时依赖 B，此范围为默认依赖范围。编译范围的依赖会用在
编译、测试、运行，由于运行时需要所以编译范围的依赖会被打包。

provided：provided 依赖只有在当 JDK 或者一个容器已提供该依赖之后才使用， provided 依
赖在编译和测试时需要，在运行时不需要，比如：servlet api 被 tomcat 容器提供。

runtime：runtime 依赖在运行和测试系统的时候需要，但在编译的时候不需要。比如：jdbc
的驱动包。由于运行时需要所以 runtime 范围的依赖会被打包。

test：test 范围依赖 在编译和运行时都不需要，它们只有在测试编译和测试运行阶段可用，
比如：junit。 由于运行时不需要所以test范围依赖不会被打包。

system：system 范围依赖与 provided 类似，但是你必须显式的提供一个对于本地系统中 JAR
文件的路径，需要指定 systemPath 磁盘路径，system依赖不推荐使用。

6.6.2 使用方式

项目中导入的依赖可以做生命周期的管理

<dependency>
    <groupId>commons-iogroupId>
    <artifactId>commons-ioartifactId>
    <version>2.6version>
    
    <scope>compilescope>
dependency>
<dependency>
    
    <groupId>javax.servletgroupId>
    <artifactId>javax.servlet-apiartifactId>
    <version>3.1.0version>
    
    <scope>providedscope>
dependency>
<dependency>
    <groupId>junitgroupId>
    <artifactId>junitartifactId>
    <version>4.12version>
    
    <scope>testscope>
dependency>

6.6.3 生命周期详解

标识	周期
compile	缺省值，适用于所有阶段（测试运行，编译，运行，打包）
provided	类似compile，期望JDK、容器或使用者会提供这个依赖。如 servlet-api.jar；适用于（测试运行，编译）阶段
runtime	只在运行时使用，如 mysql的驱动jar，适用于（运行，测试运行）阶段
test	只在测试时使用，适用于（编译，测试运行）阶段，如 junit.jar
system	Maven不会在仓库中查找对应依赖，在本地磁盘目录中查找；适用于（编译，测试运行，运行）阶段

七、Maven指令

---

7.1 命令行

通过Idea打开 cmd，然后执行Maven指令

Maven的常用命令

clean 清理编译的文件（清理target文件夹）

compile 编译了主目录的文件（只编译项目中src\main目录下的代码）

test 编译并运行了测试目录的文件（编译运行src\test目录下的代码）

package 打包（将jar war包，该war的命名规范取决于pom.xml文件中的命名）jar包java默认格式打包；war:web 的包。

install 就是把项目发布到本地仓库

deploy 上传到私服

tomcat：run 一键启动

打开 cmd，并定位到项目目录

执行maven指令

org.apache.maven.plugins maven-war-plugin 2.2 false mvn package问题

7.2 Maven面板

Idea中有Maven面板，其中可以快速执行Maven指令

maven面板

八、Maven分模块开发

---

Maven 分模块开发

整个项目比较庞大的时候： 订单模块 、支付模块、权限模块、分开;

1.先创建父工程，pom.xml文件中，打包方式为pom
2.右键父工程创建子工程，dao工程和service工程打包方式为jar，web工程打包方式为war
3.每完成一个模块后需要install，如果在IDEA中install时报错（JDK版本过低），需要在父工程的pom.xml文件中配置如下代码：

<build>
    <plugins>
        <plugin>
            <artifactId>maven-compiler-pluginartifactId>
            <groupId>org.apache.maven.pluginsgroupId>
            <configuration>
                
                <source>1.8source>
                <target>1.8target>
                <encoding>UTF-8encoding>
            configuration>
        plugin>
    plugins>
build>

第一步：创建maven父级项目

第二步：删除maven下的src

需要设置父级的pom.xml ， 修改文件; pom

父级pom.xml下，可以加各个自己需要的通用依赖，和之前的配置是一样的。

​

第三步：

​ 创建各个子模块;product user order

第三个的

​

第四步：不同模块之间的类库调用

第五步：

​ 在各个子模块之间，创建和之前一样的分层包及其类文件；

order下创建了com.yh.service.OrderService类；

调用的是product模块下的

​ com.yh.entity.ChindProduct类

测试。

​
/plugins>

[外链图片转存中...(img-hjLAxg5t-1689164470449)]







**第一步：创建maven父级项目**

**第二步：删除maven下的src**

需要设置父级的pom.xml ，	修改文件;		pom

父级pom.xml下，可以加各个自己需要的通用依赖，和之前的配置是一样的。

​	[外链图片转存中...(img-Mp61zVk6-1689164470449)]

**第三步：**

​	创建各个子模块;product  user  order

[外链图片转存中...(img-KiMpy5dP-1689164470449)]

[外链图片转存中...(img-dVv2pLix-1689164470449)]

[外链图片转存中...(img-5RrJh4ku-1689164470450)]



第三个的

​	[外链图片转存中...(img-X1T9qoGd-1689164470450)]

第四步：**不同模块之间的类库调用**

[外链图片转存中...(img-S0ajhOII-1689164470450)]

**第五步：**

​	在各个子模块之间，创建和之前一样的分层包及其类文件；

  order下创建了com.yh.service.OrderService类；

 调用的是product模块下的

​	com.yh.entity.ChindProduct类

测试。



​