Java Spring Cloud如何創(chuàng)建項目

0. 前言

該項目使用Maven進(jìn)行管理和構(gòu)建，所以需要預(yù)先配置好Maven。

1. 創(chuàng)建項目

先創(chuàng)建一個pom.xml 文件，添加以下內(nèi)容：

<?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>club.attachie</groupId>
    <artifactId>nature</artifactId>
    <packaging>pom</packaging>
    <version>${revision}</version>
    <properties>
        <revision>1.0-SNAPSHOT</revision>
    </properties>
</project>

POM 全稱 project object model，也就是項目對象模型，它是maven項目的標(biāo)注文件，采用XML格式，名稱就是pom.xml。這個文件用于管理源代碼、配置文件、開發(fā)者的信息和角色、問題追蹤系統(tǒng)、組織信息、項目授權(quán)、項目地址和依賴關(guān)系。

pom文件對于maven項目重要到，一個maven項目可以沒有其他的任何文件和內(nèi)容，但絕對不能沒有pom.xml文件。

1.1 項目信息

pom文件中包含了項目的基本信息：

• groupId 組織名稱

• artifactId 項目名稱

• version 版本號

1.2 使用占位符

在pom中我們會使用很多項目的版本號，有時候還會使用一些其他的常量。如果常量分布的比較零散，這樣就不利于我們的維護(hù)和管理。這時候就要引入占位符或者叫屬性。我們將需要的常量聲明在properties節(jié)點內(nèi)：

<properties>
    <revision>1.0-SNAPSHOT</revision>
</properties>

這種形式類似于 聲明了一個變量

revision=1.0-SNAPSHOT

在需要這個變量的時候，通過${revision}使用即可。

2. 項目結(jié)構(gòu)分層

在一個工業(yè)級的項目里，我們需要對項目進(jìn)行一個合理的分層。這樣有利于開發(fā)和后期維護(hù)。

那么，先在根目錄下添加這三個目錄：

• common 用來存放一些公共包

• activities 業(yè)務(wù)模塊所在的父包

• manager 用來存放一些Spring Cloud的一些管理工具，例如Spring boot admin、Spring Cloud Gateway等

分別在三個目錄下添加 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>club.attachie</groupId>
    <artifactId>各自的項目名稱，建議是目錄名</artifactId>
    <packaging>pom</packaging>
    <version>${revision}</version>
    <parent>
        <groupId>club.attachie</groupId>
        <artifactId>nature</artifactId>
        <version>${revision}</version>
    </parent>

</project>

并修改各自的artifactId。

然后注冊到根目錄的pom.xml，標(biāo)記這三個項目為子項目。

<modules>
    <module>common</module>
    <module>activities</module>
    <module>manager</module>
</modules>

然后運行：

mvn clean install

檢查一下配置是否有誤。

3. 引入公共依賴

Spring boot和Spring Cloud建立了對應(yīng)的依賴包，可以讓我們在開發(fā)過程中不用過多的擔(dān)心一些常見項目與Spring boot和Spring Cloud的版本沖突問題。

先在根目錄下的pom.xml文件中聲明引入的 Spring boot版本號和Spring Cloud版本號：

<spring-boot.version>2.2.5.RELEASE</spring-boot.version>
<spring-cloud.version>Hoxton.SR3</spring-cloud.version>

創(chuàng)建依賴管理節(jié)點，并添加 Spring boot 和Spring Cloud依賴包：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>${spring-boot.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <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>

在子包中需要用到的三方包，理應(yīng)都由根目錄下的pom.xml進(jìn)行管理，而管理的包都會放在dependencyManagement >> dependencies 節(jié)點下。

在項目中使用依賴，在pom.xml文件的project節(jié)點下添加如下節(jié)點，如果已有可以忽略，注意不是dependencyManagement下的。

<dependencies>

</dependencies>

試著添加lombok包（這個包是一個Java中很著名的包，可以省略Java中的get/set等方法的創(chuàng)建）。

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
</dependency>

之所以沒有聲明版本號，是因為這個包已經(jīng)由 spring-boot-dependencies 進(jìn)行管理了。所以我們直接在這里引入即可。