IDEA + Maven 搭建多模块微服务项目

Maven 介绍与使用

0，Maven 的概念

Maven，发音为 [ˈmeɪvn]，“专家，内行”的意思。它是一个项目生命周期管理和依赖管理工具，也是 Apache 维护的顶级开源项目。官网地址：https://maven.apache.org/

为什么要使用 Maven？我们传统的 Web 工程，对于依赖使用的工具包，都是通过在工程路径手动添加的形式完成的，这样一来，工具包的升级，冲突管理都十分不便。这与我们追求自动化的生产理念是不符的，而 Maven 就是为了解决这个问题诞生的。

1，Maven 使用

首先从官网下载后，你会看到如下形式的目录：

|-- bin #存放二进制可执行文件
|-- boot # Maven 自身的引导程序
|-- conf # Maven的配置文件，如setting.xml可修改仓库代理
|-- lib # Maven所依赖的jar包

你需要设置 MAVEN_HOME，它的正常运行也离不开 JDK 支持。

你可以在终端使用 mvn -v，来检查安装是否正确。（安装不是我们介绍的重点）

Mavev 同样有仓库这一概念，你可以在setting.xml中设置全局仓库位置：

 <!-- <localRepository>/path/to/local/repo</localRepository> -->
<localRepository>D:\repository</localRepository>

为了访问加速，可以设置阿里的代理镜像：当本地仓库没有需要的jar包时，会到远程仓库下载。

<mirrors>
      <mirror>
        <id>nexus-aliyun</id>
        <mirrorOf>central</mirrorOf>
        <name>Nexus aliyun</name>
        <url>http://maven.aliyun.com/nexus/content/groups/public</url>
      </mirror>
  </mirrors>
<!-- 修改默认使用的jdk1.5配置-->
<profile>
      <id>jdk-1.8</id> 
      <activation>
		<activeByDefault>true</activeByDefault>
        <jdk>1.8</jdk>
      </activation>
      <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
		<maven.compiler.target>1.8</maven.compiler.target>
		<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
      </properties>
</profile>

2，Maven 命令

在终端里，你可以使用 mvn option 形式执行 Maven 操作。命令的执行路径应该是项目的根路径，即pom文件的同级目录。

• clean，清理掉 target 下的目录即内容
• compile，编译
• test，会执行单元测试下的所有测试样例
• package，打包jar或war，
• deploy，部署到 pom 文件配置的远程仓库
• install，安装到本地仓库中

另外，你可以使用如下命令查看依赖和分析依赖

• mvn dependency：tree

• mvn dependency：analyze

3，IDEA 使用 Maven

settings 配置好后，IDEA 中 Maven 工程可以单独创建，也可以使用模版创建比如 Web 模块，不在细说。

新建 maven 工程后，可以看到 pom.xml 的配置信息，我们贴出一个 demo 分析一下：

<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.0</modelVersion>
  <!-- 组织信息 --> 
  <groupId>com.mycompany.app</groupId>
  <artifactId>my-app</artifactId>
  <version>1.0-SNAPSHOT</version>
     <!-- 打包方式 --> 
   <packaging>jar</packaging>
   <!-- 模块名称 --> 
  <name>my-app</name>
    
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>
    
  <!--配置式集中管理依赖的版本 --> 
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.7</maven.compiler.source>
    <maven.compiler.target>1.7</maven.compiler.target>
      
      <spring.version>5.0.2.RELEASE</spring.version>
    <slf4j.version>1.6.6</slf4j.version>
    <log4j.version>1.2.12</log4j.version>
    <mysql.version>5.1.6</mysql.version>
    <mybatis.version>3.4.5</mybatis.version>
  </properties>
    
  <!-- 添加依赖 --> 
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
       <!-- 使用el表达式配置版本 --> 
      <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>${spring.version}</version>
    </dependency>

  </dependencies>
 
  <build>
    <pluginManagement>
         <!-- 插件，为springboot应用提供maven支持，打包时会生成jar --> 
         <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </pluginManagement>
  </build>
</project>

对于想加入的 dependency，你可以在 https://mvnrepository.com/中找到。

这里说一下标签 <scope></scope>，它的设置约定了依赖的作用范围，即有些依赖我们只是需要的时候用到它，最终发布的版本可能不会保留。这通常包括：（注意依赖具有传递性）

compile，默认，所有类路径下可用，可传递

provided ，编译和测试时可用，不可传递

runtime，运行和测试可用可依赖，

test，测试支持，不可传递

4，IDEA 创建多模块 Maven 项目

现在的微服务项目都是多模块开发的，便于我们的升级和维护。如何创建多模块项目：

1. 新建 QuickStart模块，然后删除 src目录，并修改pom.xml中的 packaging 为pom；

2. 在父工程下右键 new 一个子 moule，jar或web

   

子模块和父模块的引用关系：

强制引入：父模块的 dependencys，子模块都可以引入；

可选引入：父模块的 dependencyManagement，子模块可选，引入时不需要加版本号。

子模块 A 如何引入子模块 B 的类或者方法：

1，将 B 的坐标引入到 A 的 dependencys 中；

2，将 B 模块和父模块安装到本地仓库，这样 A 打包后才会有父模块和 B 的类。

同时，pom 支持继承另外模块的依赖，你可以在 dependencyManagement 中，引入这个 pom，并修改

<type>pom</type> 及 <scope>import</scope>