SpringCloud零基礎上手(二)——SpringBoot多模組maven專案
本篇接著上一篇的內容,我們要寫一個服務生產者,向Eureka註冊中心註冊服務。為了後面的內容順利進行,我們建立一個多模組的專案。
編寫一個登陸微服務pf-login,並註冊到Eureka,先看我建立完的目錄結構:
簡單分析一下,最外層是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註冊中心。