1. 程式人生 > >SpringCloud零基礎上手(二)——SpringBoot多模組maven專案

SpringCloud零基礎上手(二)——SpringBoot多模組maven專案

本篇接著上一篇的內容,我們要寫一個服務生產者,向Eureka註冊中心註冊服務。為了後面的內容順利進行,我們建立一個多模組的專案。

編寫一個登陸微服務pf-login,並註冊到Eureka,先看我建立完的目錄結構:

SpringBoot多模組專案結構

簡單分析一下,最外層是pf-login,下面有client、server、dao三個模組:
①、client模組用於註冊服務,提供服務的呼叫介面,是呼叫login服務的入口。
②、server模組用於處理業務邏輯。
③、dao模組用於資料持久,和資料庫打交道。
我們還可以加一些其他的模組,比如common,base之類的用來存放公共工具等等。
模組間的依賴關係:client 依賴 server ,server 依賴 dao。

1、pf-login的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>cn.pw</groupId> <artifactId>pf-login</artifactId> <version>1.0-SNAPSHOT</version> <packaging>pom</packaging> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding
>
UTF-8</project.reporting.outputEncoding> <java.version>1.8</java.version> <spring-cloud.version>Dalston.SR4</spring-cloud.version> <fastjson-version>1.2.15</fastjson-version> </properties> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.8.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-eureka</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>${fastjson-version}</version> </dependency> </dependencies> <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> <modules> <module>pf-login-client</module> <module>pf-login-dao</module> <module>pf-login-server</module> </modules> </project>

所有關於pf-login模組的依賴都統一寫在了這裡 ,為了方便管理和避免重複依賴。與之前略有不同的是,我們加入了資料庫的依賴元件,jpa和mysql。
我們也注意到了pom中引入了阿里巴巴的fastjson,這個與其他依賴寫法不同,也就 證明SpringBoot是支援第三方依賴,也支援自定義依賴的。
<modules>是多模組專案的關鍵,模組簡的關係正是通過父pom新增<modules>,子pom新增<parent>來建立的。

2、pf-login-client的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>
    <parent>
        <groupId>cn.pw</groupId>
        <artifactId>pf-login</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>pf-login-client</artifactId>
    <name>pf-login-client</name>
    <dependencies>
        <dependency>
            <groupId>cn.pw</groupId>
            <artifactId>pf-login-server</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>      

上面我們設計了client 依賴 server,所以pom中添加了對 server的dependency。

3、pf-login-server的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>
    <parent>
        <groupId>cn.pw</groupId>
        <artifactId>pf-login</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>pf-login-server</artifactId>
    <dependencies>
        <dependency>
            <groupId>cn.pw</groupId>
            <artifactId>pf-login-dao</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
    </dependencies>
</project>  

4、pf-login-dao的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>
    <parent>
        <groupId>cn.pw</groupId>
        <artifactId>pf-login</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>pf-login-dao</artifactId>
</project>  

5、每個模組下都建立一個相同的root包,我這裡是cn.pw.platform包,保證每個模組的啟動類都在這個root包下。

原因:我們前面說過,springBoot啟動類預設掃描當前包及子包,專案打包時,所有依賴的模組以jar的形式打進來,這樣做能保證springBoot順利掃描到所有依賴jar的元件。如果包名完全不一致,或父包、子包混亂,打包編譯不會有問題,但專案啟動時,會找不到所依賴的jar中的元件。(當然,也可以通過@ComponentScans註解來指定。)

6、分步打包
打包一定從被完全依賴的模組開始,也就是從dao開始,使用 mvn install 命令,maven會在本地倉庫生成相關的jar,其他依賴該元件的模組便能從本地倉庫找到依賴的jar。
依次install dao 和 server,最後再client 模組package,這樣client中就用了dao和 server 的jar。
如果直接打包client 或 server,maven會報錯,提示找不到依賴的jar。

7、統一打包
統一打包很簡單,在所有模組的父目錄下打包,也就是通過pf-login的pom.xml打包,在pf-login下直接使用 mvn package 命令即可。

8、藉助idea打包
這裡寫圖片描述
下一步:
這裡寫圖片描述

有了這個構建多模組的基礎 ,下一篇我們就在這個基礎上編寫程式碼,寫一個登陸的服務,註冊到Eureka註冊中心。