【Spring Cloud 基础设施搭建系列】Spring Cloud Demo项目环境初始化

素颜马尾好姑娘i 2024-04-18 17:04 12阅读 0赞

### 文章目录 ###

*   *  前提介绍
     *  项目环境初始化
     *   *  parent pom管理
         *  common module
     *  源代码

## 前提介绍 ##

这个只是一个Spring Cloud 的个人学习项目，主要会涉及到一些Spring Cloud的基础设施，主要是个人的学习和记录。  
这系列的Spring Cloud Demo中所使用的Spring Cloud为**Greenwich.RC1**，使用的Spring Boot的版本为**2.1.1.RELEASE**。大家可能要注意一下版本，不同的版本配置和名称上可能会不同。

## 项目环境初始化 ##

### parent pom管理 ###

首先我们在项目的最外层创建一个parent的pom.xml文件，用来管理之后所有的module模块。

<?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>
    
        <groupId>com.cc.cloud</groupId>
        <artifactId>spring-cloud-demo</artifactId>
        <packaging>pom</packaging>
        <version>1.0</version>
    
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
            <java.version>1.8</java.version>
            <spring-cloud.version>Greenwich.RC1</spring-cloud.version>
        </properties>
    
    
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.1.1.RELEASE</version>
            <relativePath/>
        </parent>
    
    
        <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>
    
        <dependencies>
            
            <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>
    
        <repositories>
            <repository>
                <id>spring-milestones</id>
                <name>Spring Milestones</name>
                <url>https://repo.spring.io/milestone</url>
                <snapshots>
                    <enabled>false</enabled>
                </snapshots>
            </repository>
        </repositories>
    
    
    </project>

### common module ###

然后我们创建一个common module，用来放一些common的工具类或者其他公用的类。

然后我们可以common module中的依赖版本交给parent pom去管理。

parent pom.xml

<?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>
    
        <groupId>com.cc.cloud</groupId>
        <artifactId>spring-cloud-demo</artifactId>
        <packaging>pom</packaging>
        <version>1.0</version>
        <modules>
            <module>cloud-common</module>
        </modules>
    
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
            <java.version>1.8</java.version>
            <spring-cloud.version>Greenwich.RC1</spring-cloud.version>
        </properties>
    
    
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.1.1.RELEASE</version>
            <relativePath/>
        </parent>
    
    
        <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>
                
                <dependency>
                    <groupId>com.google.code.gson</groupId>
                    <artifactId>gson</artifactId>
                    <version>2.7</version>
                </dependency>
                <dependency>
                    <groupId>com.fasterxml.jackson.core</groupId>
                    <artifactId>jackson-annotations</artifactId>
                    <version>2.9.0</version>
                </dependency>
                <dependency>
                    <groupId>com.alibaba</groupId>
                    <artifactId>fastjson</artifactId>
                    <version>1.1.26</version>
                </dependency>
            </dependencies>
        </dependencyManagement>
    
        <dependencies>
            
            <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>
    
        <repositories>
            <repository>
                <id>spring-milestones</id>
                <name>Spring Milestones</name>
                <url>https://repo.spring.io/milestone</url>
                <snapshots>
                    <enabled>false</enabled>
                </snapshots>
            </repository>
        </repositories>
    
    
    </project>

common pom.xml

但这个时候我们在parent pom路径下使用`mvn clean install`会报如下的错误：

C:\Users\c\Desktop\spring-cloud-demo>mvn clean install
    [INFO] Scanning for projects...
    [INFO] ------------------------------------------------------------------------
    [INFO] Reactor Build Order:
    [INFO]
    [INFO] spring-cloud-demo
    [INFO] cloud-common
    [INFO]
    [INFO] ------------------------------------------------------------------------
    [INFO] Building spring-cloud-demo 1.0
    [INFO] ------------------------------------------------------------------------
    [INFO]
    [INFO] --- maven-clean-plugin:3.1.0:clean (default-clean) @ spring-cloud-demo ---
    [INFO]
    [INFO] --- spring-boot-maven-plugin:2.1.1.RELEASE:repackage (repackage) @ spring-cloud-demo ---
    [INFO]
    [INFO] --- maven-install-plugin:2.5.2:install (default-install) @ spring-cloud-demo ---
    [INFO] Installing C:\Users\c\Desktop\spring-cloud-demo\pom.xml to D:\Maven\repository\com\cc\cloud\spring-cloud-demo\1.0\spring-cloud-demo-1.0.pom
    [INFO]
    [INFO] ------------------------------------------------------------------------
    [INFO] Building cloud-common 1.0
    [INFO] ------------------------------------------------------------------------
    [INFO]
    [INFO] --- maven-clean-plugin:3.1.0:clean (default-clean) @ cloud-common ---
    [INFO] Deleting C:\Users\c\Desktop\spring-cloud-demo\cloud-common\target
    [INFO]
    [INFO] --- maven-resources-plugin:3.1.0:resources (default-resources) @ cloud-common ---
    [INFO] Using 'UTF-8' encoding to copy filtered resources.
    [INFO] Copying 0 resource
    [INFO] Copying 0 resource
    [INFO]
    [INFO] --- maven-compiler-plugin:3.8.0:compile (default-compile) @ cloud-common ---
    [INFO] Nothing to compile - all classes are up to date
    [INFO]
    [INFO] --- maven-resources-plugin:3.1.0:testResources (default-testResources) @ cloud-common ---
    [INFO] Using 'UTF-8' encoding to copy filtered resources.
    [INFO] skip non existing resourceDirectory C:\Users\c\Desktop\spring-cloud-demo\cloud-common\src\test\resources
    [INFO]
    [INFO] --- maven-compiler-plugin:3.8.0:testCompile (default-testCompile) @ cloud-common ---
    [INFO] Nothing to compile - all classes are up to date
    [INFO]
    [INFO] --- maven-surefire-plugin:2.22.1:test (default-test) @ cloud-common ---
    [INFO] No tests to run.
    [INFO]
    [INFO] --- maven-jar-plugin:3.1.0:jar (default-jar) @ cloud-common ---
    [INFO] Building jar: C:\Users\c\Desktop\spring-cloud-demo\cloud-common\target\cloud-common-1.0.jar
    [INFO]
    [INFO] --- spring-boot-maven-plugin:2.1.1.RELEASE:repackage (repackage) @ cloud-common ---
    [INFO] ------------------------------------------------------------------------
    [INFO] Reactor Summary:
    [INFO]
    [INFO] spring-cloud-demo .................................. SUCCESS [  0.985 s]
    [INFO] cloud-common ....................................... FAILURE [  1.338 s]
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD FAILURE
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time: 2.868 s
    [INFO] Finished at: 2019-09-13T17:31:48+08:00
    [INFO] Final Memory: 35M/424M
    [INFO] ------------------------------------------------------------------------
    [ERROR] Failed to execute goal org.springframework.boot:spring-boot-maven-plugin:2.1.1.RELEASE:repackage (repackage) on project cloud-common: Execution repackage of goa
    l org.springframework.boot:spring-boot-maven-plugin:2.1.1.RELEASE:repackage failed: Unable to find main class -> [Help 1]
    [ERROR]
    [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
    [ERROR] Re-run Maven using the -X switch to enable full debug logging.
    [ERROR]
    [ERROR] For more information about the errors and possible solutions, please read the following articles:
    [ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/PluginExecutionException
    [ERROR]
    [ERROR] After correcting the problems, you can resume the build with the command
    [ERROR]   mvn <goals> -rf :cloud-common

所以我们需要禁止spring-boot-maven-plugin插件在子模块cloud-common中使用  
我们需要在cloud-common模块中加入一下配置：

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

cloud-common的pom.xml完整配置：

再次执行命令就发现没有报错了。

C:\Users\c\Desktop\spring-cloud-demo>mvn clean install
    [INFO] Scanning for projects...
    [INFO] ------------------------------------------------------------------------
    [INFO] Reactor Build Order:
    [INFO]
    [INFO] spring-cloud-demo
    [INFO] cloud-common
    [INFO]
    [INFO] ------------------------------------------------------------------------
    [INFO] Building spring-cloud-demo 1.0
    [INFO] ------------------------------------------------------------------------
    [INFO]
    [INFO] --- maven-clean-plugin:3.1.0:clean (default-clean) @ spring-cloud-demo ---
    [INFO]
    [INFO] --- spring-boot-maven-plugin:2.1.1.RELEASE:repackage (repackage) @ spring-cloud-demo ---
    [INFO]
    [INFO] --- maven-install-plugin:2.5.2:install (default-install) @ spring-cloud-demo ---
    [INFO] Installing C:\Users\c\Desktop\spring-cloud-demo\pom.xml to D:\Maven\repository\com\cc\cloud\spring-cloud-demo\1.0\spring-cloud-demo-1.0.pom
    [INFO]
    [INFO] ------------------------------------------------------------------------
    [INFO] Building cloud-common 1.0
    [INFO] ------------------------------------------------------------------------
    [INFO]
    [INFO] --- maven-clean-plugin:3.1.0:clean (default-clean) @ cloud-common ---
    [INFO] Deleting C:\Users\c\Desktop\spring-cloud-demo\cloud-common\target
    [INFO]
    [INFO] --- maven-resources-plugin:3.1.0:resources (default-resources) @ cloud-common ---
    [INFO] Using 'UTF-8' encoding to copy filtered resources.
    [INFO] Copying 0 resource
    [INFO] Copying 0 resource
    [INFO]
    [INFO] --- maven-compiler-plugin:3.8.0:compile (default-compile) @ cloud-common ---
    [INFO] Nothing to compile - all classes are up to date
    [INFO]
    [INFO] --- maven-resources-plugin:3.1.0:testResources (default-testResources) @ cloud-common ---
    [INFO] Using 'UTF-8' encoding to copy filtered resources.
    [INFO] skip non existing resourceDirectory C:\Users\c\Desktop\spring-cloud-demo\cloud-common\src\test\resources
    [INFO]
    [INFO] --- maven-compiler-plugin:3.8.0:testCompile (default-testCompile) @ cloud-common ---
    [INFO] Nothing to compile - all classes are up to date
    [INFO]
    [INFO] --- maven-surefire-plugin:2.22.1:test (default-test) @ cloud-common ---
    [INFO] No tests to run.
    [INFO]
    [INFO] --- maven-jar-plugin:3.1.0:jar (default-jar) @ cloud-common ---
    [INFO] Building jar: C:\Users\c\Desktop\spring-cloud-demo\cloud-common\target\cloud-common-1.0.jar
    [INFO]
    [INFO] --- spring-boot-maven-plugin:2.1.1.RELEASE:repackage (repackage) @ cloud-common ---
    [INFO]
    [INFO] --- maven-install-plugin:2.5.2:install (default-install) @ cloud-common ---
    [INFO] Installing C:\Users\c\Desktop\spring-cloud-demo\cloud-common\target\cloud-common-1.0.jar to D:\Maven\repository\com\cc\cloud\cloud-common\1.0\cloud-common-1.0.ja
    r
    [INFO] Installing C:\Users\c\Desktop\spring-cloud-demo\cloud-common\pom.xml to D:\Maven\repository\com\cc\cloud\cloud-common\1.0\cloud-common-1.0.pom
    [INFO] ------------------------------------------------------------------------
    [INFO] Reactor Summary:
    [INFO]
    [INFO] spring-cloud-demo .................................. SUCCESS [  1.568 s]
    [INFO] cloud-common ....................................... SUCCESS [  0.914 s]
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time: 3.056 s
    [INFO] Finished at: 2019-09-13T17:45:50+08:00
    [INFO] Final Memory: 36M/449M
    [INFO] ------------------------------------------------------------------------

## 源代码 ##

[https://gitee.com/cckevincyh/spring-cloud-demo/tree/init-project][https_gitee.com_cckevincyh_spring-cloud-demo_tree_init-project]  
[Maven中如何禁止插件(plugin)在子模块(module)上执行][Maven_plugin_module]

[https_gitee.com_cckevincyh_spring-cloud-demo_tree_init-project]: https://gitee.com/cckevincyh/spring-cloud-demo/tree/init-project
[Maven_plugin_module]: https://blog.csdn.net/bluishglc/article/details/17191779