Spring-Cloud笔记02:IDEA中构建多模块的Maven项目

[超级链接:Spring-Cloud学习序章]

---

本章主要描述在IDEA中，如何构建多模块的Maven项目。

多模块Maven项目

为了便于统一的版本维护和管理，经常会用到Maven的多模块模式。

本文以以下模块结构为例，对如何创建多模块Maven项目进行描述。

构建主工程

首先创建一个Maven项目作为主工程，类型无所谓，这里建议使用maven-archetype-quickstart骨架，创建过程如下：

• File-->New-->Project
• -->Maven-->Create from archetype-->maven-archetype-quickstart-Next
• -->GroupId={你的GroupId}-->AritifactId={你的ArtifactId}
• -->Next-->Next-->Finish-->New Whindow

本示例中，我的主项目叫main-project，GroupId和AritifactId的配置如下：

构建子模块

子模块项目创建于主工程之内，创建过程如下：

• 右键点击项目名称-->New-->Module
• 选中Spring Initializr-->Next
• -->Group={主工程的GroupId}-->Aritifact={当前模块的ArtifactId}、
• -->Next-->Next-->Finish

本示例中，子模块的名称为module-a和module-b，Group和Aritifact的配置如下：

通过同样的方式创建子模块module-b。

优化结构

完成上述的主工程以及两个子模块创建之后，项目结构视图如下：

下面对这个多模块项目进行优化。

删除主工程多于目录

并不需要在主工程进行任何代码开发，所以删除其src目录。

编辑主工程pom.xml

作为主工程，其pom.xml可以作为其他子模块工程的基准依赖，方便进行统一的版本管理。

将主工程pom.xml修改如下：

<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>pers.hanchaogroupId>
    <artifactId>main-projectartifactId>
    <version>1.0-SNAPSHOTversion>
    <name>main-projectname>

    
    <modules>
        <module>module-amodule>
        <module>module-bmodule>
    modules>

    
    <parent>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-parentartifactId>
        <version>1.5.2.RELEASEversion>
        <relativePath/> 
    parent>

    
    <properties>
        <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8project.reporting.outputEncoding>
        <java.version>1.8java.version>
        <spring-cloud.version>Dalston.SR1spring-cloud.version>
    properties>

    <dependencies>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-actuatorartifactId>
        dependency>
        
        <dependency>
            <groupId>org.springframework.cloudgroupId>
            <artifactId>spring-cloud-starter-eureka-serverartifactId>
        dependency>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-webartifactId>
        dependency>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-testartifactId>
            <scope>testscope>
        dependency>
    dependencies>

    
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloudgroupId>
                <artifactId>spring-cloud-dependenciesartifactId>
                <version>${spring-cloud.version}version>
                <type>pomtype>
                <scope>importscope>
            dependency>
        dependencies>
    dependencyManagement>

    
    <repositories>
        <repository>
            <id>spring-snapshotsid>
            <name>Spring Snapshotsname>
            <url>https://repo.spring.io/snapshoturl>
            <snapshots>
                <enabled>trueenabled>
            snapshots>
        repository>
        <repository>
            <id>spring-milestonesid>
            <name>Spring Milestonesname>
            <url>https://repo.spring.io/milestoneurl>
            <snapshots>
                <enabled>falseenabled>
            snapshots>
        repository>
    repositories>
project>

在上述的pom.xml文件中，主要做了以下几件事：

• 配置Spring Boot的版本
• 配置Spring Cloud的版本
• 配置微服务的一些基本组件，如actuator、eureka、web和test。
• 配置编码方式
• 配置java版本
• 配置子模块

注意：Spring Boot和Spring Cloud有特定的对照关系，具体可参看：http://projects.spring.io/spring-cloud/

编辑子模块pom.xml

子模块pom.xml可以引用主工程pom.xml的依赖关系，所以也对其进行配置，其中module-a的pom.xml配置如下：

<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>pers.hanchao.mainprojectgroupId>
	<artifactId>module-aartifactId>
	<version>0.0.1-SNAPSHOTversion>
	<packaging>jarpackaging>

	<name>module-aname>
	<description>Demo project for Spring Cloud Module Adescription>

	
	<parent>
		<groupId>pers.hanchaogroupId>
		<artifactId>main-projectartifactId>
		<version>1.0-SNAPSHOTversion>
		<relativePath/> 
	parent>

	
	<dependencies>
		
	dependencies>

project>

从上面的配置可以得知，module-a从主工程中继承了一系列依赖关系，如actuator、eureka、web和test。

并且，module-a还可以对自己模块特有的一些依赖进行配置。

运行测试

改写module-a的启动类ModuleAApplication.java，如下：

@RestController
@SpringBootApplication
public class ModuleAApplication {

	public static void main(String[] args) {
		SpringApplication.run(ModuleAApplication.class, args);
	}

	@GetMapping("/hi")
	public String hi(){
		return "Hello World!";
	}
}

启动项目，在浏览器访问http://localhost:8080/hi，结果如图所示：

说明配置成功。