SpringCloud | 第一节：多模块maven工程搭建

我个人比较倾向于使用Spring Initializr来创建maven工程，下面通过搭建一个拥有两个子模块的maven项目，来介绍一下后台多模块的maven工程的搭建方式。

1、maven工程下载

进入Spring Initializr：https://start.spring.io/。

在页面上面输入好工程信息之后，点击“Generate Project”，如图1.1所示：

2、父模块创建

解压下载好的压缩包，把src文件夹、HELP.md、mvnw、mvnw删除，并原来的pom文件修改为如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<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>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.4.RELEASE</version>
        <relativePath /> <!-- lookup parent from repository -->
    </parent>

    <groupId>vip.jackie</groupId>
    <artifactId>cloud</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>pom</packaging>

    <name>cloud</name>
    <description>Spring Cloud</description>

    <properties>
        <java.version>1.8</java.version>
        <spring-cloud.version>Finchley.SR2</spring-cloud.version>
    </properties>

    <modules>
        <module>eureka-server</module>
        <module>eureka-client</module>
    </modules>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

</project>

特备注意一下spring boot的版本和spring cloud的版本，这里使用的是2.0.4的spring boot版本和Finchley.SR2的spring cloud版本。根据官网的说明Finchley版本的spring cloud必须使用2.0.x的spring boot。

这里对几个比较重要的标签做出一下说明：

<packaging>pom</packaging>

表面这是一个父模块，其下面会有0个或者一个以上的子模块，子模块由<modules>标签指明。

<modules>
	<module>eureka-server</module>
	<module>eureka-client</module>
</modules>

表面这个父模块拥有两个子模块，分别叫eureka-server和eureka-client。

	<dependencyManagement>
		<dependencies>
			<dependency>
				<groupId>org.springframework.cloud</groupId>
				<artifactId>spring-cloud-dependencies</artifactId>
				<version>${spring-cloud.version}</version>
				<type>pom</type>
				<scope>import</scope>
			</dependency>
		</dependencies>
	</dependencyManagement>

<dependencyManagement>用来做依赖管理，并不会下载实际的jar包。所有子模块如果有用到<dependencies>指定的依赖，会直接继承该依赖的版本号。这里指定了spring cloud的版本。

注意子模块的工程必须位于父模块工程pom的同一级目录，并且项目的文件夹名称和<module>指定的名称一样。

整个工程结构如图2.1所示：

3、子模块创建

把之前下载好的压缩包解压两份到与父工程的pom文件同一级目录下，并分别命名为eureka-server和eureka-client。修改子工程的pom如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<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>

	<parent>
		<groupId>vip.jackie</groupId>
		<artifactId>cloud</artifactId>
		<version>0.0.1-SNAPSHOT</version>
	</parent>

	<artifactId>eureka-server</artifactId>
	<packaging>jar</packaging>

	<name>eureka-server</name>
	<description>eureka-server</description>

	<properties>
	</properties>

	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

两个子工程的pom只要保证<artifactId>不同就行，最好命名为和工程的目录名一样。为了节省篇幅，就不贴上另一个子工程的pom代码。

这里对几个比较重要的标签做出一下说明：

<parent>
    <groupId>vip.jackie</groupId>
    <artifactId>cloud</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</parent>

指明子模块的父模块。通过这种方式，子模块就可以继承父模块的很多属性，包括父模块<dependencyManagement>指定的依赖本版号。在这里子模块基础父模块的<groupId>和<version>，所以子模块的pom就不需要再指定这两个属性。

如果使用的是eclipse，直接导入父工程为maven工程即可。

4、总结

这里大致介绍了如何搭建多模块maven工程搭建。下一节将会介绍spring cloud的服务治理Eureka。