SpringCloud（一）聚合工程搭建

寫在前面：

• 你好，歡迎你的閱讀！
• 我熱愛技術，熱愛分享，熱愛生活， 我始終相信：技術是開源的，知識是共享的！
• 博客裏面的內容大部分均爲原創，是自己日常的學習記錄和總結，便於自己在後面的時間裏回顧，當然也是希望可以分享自己的知識。目前的內容幾乎是基礎知識和技術入門，如果你覺得還可以的話不妨關注一下，我們共同進步！
• 除了分享博客之外，也喜歡看書，寫一點日常雜文和心情分享，如果你感興趣，也可以關注關注！
• 微信公衆號：傲驕鹿先生

說明：

1、專欄涉及到的源碼已經同步至https://github.com/SetAlone/springcloud2020（持續更新）

2、springcloud系列博文內容爲學習《尚硅谷2020最新版SpringCloud(H版&alibaba)框架開發教程》的記錄，此係列課程是目前看來個人覺得非常不錯的資源，在此可以與大家進行分享。

3、個人收集到了課程源碼和所需的腦圖、筆記等資源，如需要私信我即可。查找資源不易，希望可以給個點贊和關注。

一、IDEA新建project工作空間

1、New Project

2、聚合總父工程名字

3.、Maven選版本

4、工程名字

5、 字符編碼

6、註解生效激活

7、java編譯版本選8

8、File Type過濾（可做可不做）

父工程POM文件

<?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.atguigu.springcloud</groupId>
    <artifactId>cloud2020</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <!--統一管理jar包版本-->
    <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>
        <junit.version>4.12</junit.version>
        <log4j.version>1.2.17</log4j.version>
        <lombok.version>1.16.18</lombok.version>
        <mysql.version>8.0.19</mysql.version>
        <druid.version>1.1.16</druid.version>
        <spring.boot.version>2.2.2.RELEASE</spring.boot.version>
        <spring.cloud.version>Hoxton.SR1</spring.cloud.version>
        <spring.cloud.alibaba.version>2.1.0.RELEASE</spring.cloud.alibaba.version>
        <mybatis.spring.boot.version>1.3.0</mybatis.spring.boot.version>
    </properties>

    <!--子模塊繼承後,提供作用:鎖定版本+子module不用groupId和version-->
    <dependencyManagement>
        <dependencies>
            <!--springboot 2.2.2-->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring.boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!--Spring cloud Hoxton.SR1-->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring.cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!--Spring cloud alibaba 2.1.0.RELEASE-->
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring.cloud.alibaba.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>${mysql.version}</version>
            </dependency>
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>druid</artifactId>
                <version>${druid.version}</version>
            </dependency>
            <dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
            </dependency>
        </dependencies>
    </dependencyManagement>

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

    <!--第三方maven私服-->
    <repositories>
        <repository>
            <id>nexus-aliyun</id>
            <name>Nexus aliyun</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>


</project>
 

Maven中的DependencyManagement和Dependencies

這樣做的好處就是: 如果有多個子項目都引用同一樣的依賴,則可以避免在每個使用的子項目裏都聲明一個版本號,這樣想升級或切換到另一個版本時,只需在頂層父容器裏更新,而不需要一個一個子項目的修改;另外如果某個子項目需要另外的一個版本,只需聲明version版本 

父工程創建完成執行mvn:insall將父工程發佈到倉庫方便子工程繼承。

二、Rest微服務工程搭建

每次建立一個新的Moudle模塊的時候我們都將進行如下的操作步驟：建moudle，改pom，寫yml，主啓動類、業務類、測試

1.Cloud-provider-payment8001 微服務提供者Module模塊

建moudle

在父工程上右鍵，new——>moudle，新建一個新的maven項目，不需要選擇嚮導。命令爲cloud-provider-payment8001。

創建完成後在父工程的pom文件中查看，會有如下的一個變化，因爲新的子工程是繼承自父工程的。

<modules>
    <module>cloud-provider-payment8001</module>
</modules>

改pom

<?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">
    <parent>
        <artifactId>SpringCloud2020</artifactId>
        <groupId>com.atguigu.springcloud</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>cloud-provider-payment8001</artifactId>

    <dependencies>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.1.10</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>${lombok.version}</version>
            <optional>true</optional>
        </dependency>

    </dependencies>

</project>

寫yml

在resources文件夾下 創建一個application.yml文件，進行yml文件的編寫

server:
  port: 8001

spring:
  application:
    name: cloud-payment-service
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: org.gjt.mm.mysql.Driver
    url: jdbc:mysql://000.000.000.000:3306/db2020_cloud?useUnicode=true&characterEncoding=utf-8&useSSL=false
    username: root
    password: 123456

mybatis:
  mapper-locations: classpath:mapper/*.xml
  type-aliases-package: com.atguigu.springcloud.entities

主啓動類

在java文件夾下創建一個新的java文件作爲主啓動類。

package com.atguigu.springcloud;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class PaymentMain8001 {
    public static void main(String[] args) {
        SpringApplication.run(PaymentMain8001.class);
    }
}

業務類

1、數據庫建表：

 DROP TABLE IF EXISTS `payment`;
 CREATE TABLE `payment`
 (
     `id`     bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主鍵',
     `serial` varchar(200) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL COMMENT '支付流水號',
     PRIMARY KEY (`id`) USING BTREE
 ) ENGINE = InnoDB
   CHARACTER SET = utf8
   COLLATE = utf8_general_ci COMMENT = '支付表'
   ROW_FORMAT = Dynamic;

2、實體類entities

主實體Payment

package com.atguigu.springcloud.entities;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.io.Serializable;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Payment implements Serializable {
    private Long id;
    private String serial;
}

Json封裝體CommonResult

package com.atguigu.springcloud.entities;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class CommonResult<T> {
    private Integer code;
    private String message;
    private T data;

    public CommonResult(Integer code, String message) {
        this(code, message, null);
    }
}

3、dao

接口PaymentDao

 package com.atguigu.springcloud.dao;
 ​
 import com.atguigu.springcloud.entities.Payment;
 import org.apache.ibatis.annotations.Mapper;
 import org.apache.ibatis.annotations.Param;
 ​
 ​
 @Mapper
 public interface PaymentDao {
 ​
     public int create(Payment payment);
 ​
     public Payment getPaymentById(@Param("id") Long id);
 }

4、mybatis的映射文件PaymentMapper.xml

在src\main\resources下創建文件夾mapper，再創建PaymentMapper.xml文件

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
 ​
 <mapper namespace="com.atguigu.springcloud.dao.PaymentDao">
 ​
     <insert id="insert" parameterType="Payment" useGeneratedKeys="true" keyProperty="id">
         insert into payment(serial)
         values (#{serial});
     </insert>
 ​
 <!--    使用resultMap進行映射-->
     <resultMap id="BaseResultMap" type="com.atguigu.springcloud.entities.Payment">
         <id column="id" property="id" jdbcType="BIGINT"></id>
         <id column="serial" property="serial" jdbcType="VARCHAR"></id>
     </resultMap>
     <select id="getPaymentById" parameterType="Long" resultType="BaseResultMap">
         select * from payment where id=#{id};
     </select>
 ​
 </mapper>

5、service

接口PaymentService

 package com.atguigu.springcloud.service;
 ​
 ​
 import com.atguigu.springcloud.entities.Payment;
 import org.apache.ibatis.annotations.Param;
 ​
 public interface PaymentService {
     public int create(Payment payment);
 ​
     public Payment getPaymentById(@Param("id") Long id);
 ​
 }

接口實現類PaymentServiceImpl

package com.atguigu.springcloud.service.impl;
 ​
 import com.atguigu.springcloud.dao.PaymentDao;
 import com.atguigu.springcloud.entities.Payment;
 import com.atguigu.springcloud.service.PaymentService;
 import org.springframework.stereotype.Service;
 ​
 import javax.annotation.Resource;
 ​
 @Service
 public class PaymentServiceImpl implements PaymentService {
 ​
     @Resource
     private PaymentDao paymentDao;
 ​
     public int create(Payment payment){
         return paymentDao.create(payment);
     }
 ​
     public Payment getPaymentById(Long id){
         return paymentDao.getPaymentById(id);
     }
 ​
 }

6、controller

package com.atguigu.springcloud.controller;
 ​
 import com.atguigu.springcloud.entities.CommonResult;
 import com.atguigu.springcloud.entities.Payment;
 import com.atguigu.springcloud.service.PaymentService;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RestController;
 ​
 import javax.annotation.Resource;
 ​
 @RestController
 @Slf4j
 public class PaymentController {
 ​
     @Resource
     private PaymentService paymentService;
 ​
     @PostMapping(value = "/payment/create")
     public CommonResult create(@RequestBody Payment payment) {
         int result = paymentService.create(payment);
         log.info("*****插入結果：" + result);
 ​
         if (result > 0) {
             return new CommonResult(200, "插入數據庫成功", result);
         } else {
             return new CommonResult(444, "插入數據庫失敗", null);
         }
     }
 ​
     @GetMapping(value = "/payment/get/{id}")
     public CommonResult GetPaymentById(@PathVariable("id") Long id) {
         Payment payment = paymentService.getPaymentById(id);
         log.info("*****插入結果：" + payment);
 ​
         if (payment !=null) {
             return new CommonResult(200, "查詢成功", payment);
         } else {
             return new CommonResult(444, "沒有對應記錄，查詢ID:"+id, null);
         }
     }
 }

測試

• 在瀏覽器輸入http://localhost:8001/payment/get/31進行測試

• postman模擬post

2、熱部署Devtools

1.Adding devtools to your project

在cloud-provider-payment8001項目的pom文件中添加依賴

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <scope>runtime</scope>
    <optional>true</optional>
</dependency>

2.Adding plugin to your pom.xml

在聚合父類總工程的pom.xml裏添加配置

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

3.Enabling automatic build（開啓自動編譯的選項）

在設置settings中開啓自動編譯選項

4、Update the value of

組合鍵ctrl+shift+alt+/ 打開如下的選項卡進行設置

進行上面的4個步驟後即可開啓熱部署的設置，當你在啓動項目的情況下修改其他內容，項目會自行的重新啓動，不用再手動的重新啓動，提高了開發的效率。但是在實際的生產環境中一班不會開啓熱部署的。

3、cloud-consumer-order80 微服務消費者訂單Module模塊

還是按照建立新moudle的幾個步驟快速構建

1、建立新的moudle，繼承自父工程，命名爲cloud-consumer-order80

2、改pom文件

<?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">
    <parent>
        <groupId>com.atguigu.springcloud</groupId>
        <artifactId>cloud2020</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>cloud-consumer-order80</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

</project>

3、寫yml

server:
	port:80

4、主啓動類

package com.atguigu.spring;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

import java.io.Serializable;

@SpringBootApplication
public class OrderMain80 implements Serializable {
    public static void main(String[] args) {
        SpringApplication.run(OrderMain80.class,args);
    }
}

5、業務類

作爲一個消費者模塊，我們不需要再進行數據的操作，因此不需要service和dao。

實體類entities（複製上面模塊的中的實體即可）

controller

1）使用Resttemplate完成客戶端消費者80模塊到微服務提供者8001模塊的調用。

使用Resttemplate對象的話需要將它注入到springboot的容器中。

package com.atguigu.springcloud.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestTemplate;

@Configuration
public class ApplicationContextConfig
{
    @Bean
    public RestTemplate getRestTemplate()
    {
        return new RestTemplate();
    }
}

2）編寫controller類

package com.atguigu.springcloud.controller;

import com.atguigu.springcloud.entities.CommonResult;
import com.atguigu.springcloud.entities.Payment;
import lombok.extern.slf4j.Slf4j;
import org.springframework.cloud.client.ServiceInstance;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;

import javax.annotation.Resource;
import java.net.URI;
import java.util.List;

@RestController
@Slf4j
public class OrderController
{
    public static final String PAYMENT_URL = "http://localhost:8001";

    @Resource
    private RestTemplate restTemplate;

    @GetMapping("/consumer/payment/create")
    public CommonResult<Payment> create(Payment payment)
    {
        return restTemplate.postForObject(PAYMENT_URL +"/payment/create",payment,CommonResult.class);
    }

    @GetMapping("/consumer/payment/get/{id}")
    public CommonResult<Payment> getPayment(@PathVariable("id") Long id)
    {
        return restTemplate.getForObject(PAYMENT_URL+"/payment/get/"+id,CommonResult.class);
    }
}

6、測試

3、工程重構

因爲整個項目採用的工程聚合的方式進行構建，我們在完成 了上面的兩個子模塊的建立後，發現兩個項目中有共同的部分，即業務類中的實體entities文件夾是共有的部分，因此我們可以將其提取出來，作爲一個模塊進行構建：

1）建立新的moudle，命名爲cloud-api-commons

2)修改pom文件

<?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">
    <parent>
        <artifactId>springcloud2020</artifactId>
        <groupId>com.atguigu.springcloud</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>cloud-api-commons</artifactId>


    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.1.0</version>
        </dependency>
    </dependencies>

</project>

3）將同有的部分：實體類進行復制

4）使用mvn命令進行clean、install

5）在訂單80和支付8001分別改造

• 刪除原有的實體類entities文件夾
• 修改各自的pom文件，在pom文件中添加依賴

<dependency>
    <groupId>com.atguigu.springcloud</groupId>
    <artifactId>cloud-api-common</artifactId>
    <version>${project.version}</version>
</dependency>
 

4、工程樣圖

在完成了父工程和兩個子工程的搭建後就會如下圖的樣圖