IDEA 搭建 SpringCloud 项目【超详细步骤】

淡淡的烟草味﹌ 2024-02-19 11:43 71阅读 0赞

#### 文章目录 ####

*   *  一、前言
     *  二、项目搭建
     *   *  1. 数据库准备
         *  2. 创建父工程
         *  3. 创建注册中心
         *  4. 服务注册
         *  5. 编写业务代码
         *  6. 服务拉取

### 一、前言 ###

> 所谓微服务，就是要把整个业务模块拆分成多个各司其职的小模块，做到单一职责原则，不会重复开发相同的业务代码，实现真正意义上的高内聚、低耦合。同时，微服务可以对外暴露接口，供其它微服务使用。

如果我们在 A 服务中发起一个 http 请求到 B 服务，那么就可以实现微服务的远程调用。（restTemplate 的 getForObject 方法可以向浏览器发起请求）  
这种方法看起来是可行的，但是把 url 路径和 Java 代码耦合到一起，是不符合开闭原则的。于是就出现了 Eureka 注册中心。

每一个微服务在启动的那一刻都需要做一件事情，就是把自己的服务信息注册给 Eureka，比如服务名称、服务端口等，其它微服务想要调用另一个服务的时候，直接去 Eureka 里面拉取信息就可以了。  
同时，为了避免拉取的服务已经挂掉了，我们的服务每隔 30 秒就会向 Eureka 发起一次心跳，来证明自己还活着，如果有一天不跳了，Eureka 就会把它从注册列表中剔除。

`如果存在多个服务提供者，服务消费者就会利用负载均衡算法，从服务列表中挑选一个！`

### 二、项目搭建 ###

#### 1. 数据库准备 ####

> 此处我们要准备两个数据库，user 服务和 order 服务各自拥有自己的数据库。

CREATE TABLE USER (
    id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    NAME VARCHAR(20) NOT NULL,
    phone VARCHAR(15) NOT NULL,
    address VARCHAR(50) NOT NULL
    );
    
    INSERT INTO USER VALUES (1, "栈老师不回家", 13299075426, "山西省大同市")
    INSERT INTO USER(NAME, phone, address) VALUES ("肖恩", 18834267011, "山西省太原市")
    INSERT INTO USER(NAME, phone, address) VALUES ("李华", 12481076533, "山西省运城市")

![在这里插入图片描述][4afbd06049dd4df89b94d71cbc8be126.png]

CREATE TABLE orders (
    id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    NAME VARCHAR(30) NOT NULL,
    price INT NOT NULL,
    user_id INT NOT NULL REFERENCES USER(id)
    )
    
    INSERT INTO orders VALUES (1, "可乐鸡翅", 32, 1);
    INSERT INTO orders(NAME, price, user_id) VALUES("冰镇啤酒", 12, 1);
    INSERT INTO orders(NAME, price, user_id) VALUES("草莓冰激凌", 8, 2);
    INSERT INTO orders(NAME, price, user_id) VALUES("狼牙土豆", 10, 3);

![在这里插入图片描述][c0a9d44064374eb68f7f9b411e0ad1e4.png]

#### 2. 创建父工程 ####

**① 还是 SpringBoot 项目，选择 Spring Web 依赖**

![在这里插入图片描述][d1d016d10a7c45e7b568b5676b1c22c9.png]

![在这里插入图片描述][b1232944f6994f8da33acd294483f3ac.png]

**② 删掉 src 目录及 mvnw 开头的两个文件**

![在这里插入图片描述][8483535ad4474d55a1a5e5aff7a81eb3.png]

**③ 在 pom 文件中添加 packaging 标签和 SpringCloud 版本，并修改 SpringBoot 版本**

![在这里插入图片描述][ea8bc95913384ed2a16310e675bc6be3.png]

**④ 引入 mysql 和 mybatis 依赖，供后续使用**

![在这里插入图片描述][e3db5d8560194bfc96d11a0eb24ea972.png]

**⑤ 添加 SpringCloud 依赖库，后续子模块使用的时候就不需要再指定版本了**

![在这里插入图片描述][aef5f0b9c6ce4608bc55b9b70aa0fb49.png]

#### 3. 创建注册中心 ####

**① 在父级项目上新建模块**

![在这里插入图片描述][20dd0921c5fe4838a74bf2ff0ae74038.png]

**② 选择 Eureka Server**

![在这里插入图片描述][bdb5ed722884436284aea57468b66b03.png]

**③ 修改子模块的 parent 标签内容，指向父工程**

![在这里插入图片描述][e0f961c675f94108a6e5c6bf5ff71f98.png]

`因为父模块中已经指定了 SpringCloud 的版本，所以子模块不需要再重复写！`

**④ 在父级 pom 中添加该子模块**

![在这里插入图片描述][bcb6fa13d8904c4cbf893ab77d37b71d.png]

**⑤ 因为子类会继承父类的依赖，所以子类中多余的依赖可以删掉，后续需要什么加什么**

![在这里插入图片描述][662cbc1391434578a4bc87d874755256.png]

**⑤ 编写 application.yml 文件**

#服务端口，随便起
    server:
      port: 11011
    #服务名称
    spring:
      application:
        name: eurekaserver
      datasource:
        url: jdbc:mysql:///ZXEdb?serverTimezone=UTC
        username: root
        password: 856724bb
        driver-class-name: com.mysql.cj.jdbc.Driver
    
    #eureka地址
    eureka:
      client:
        service-url:
          defaultZone: http://127.0.0.1:11011/eureka/
        register-with-eureka: false
        fetch-registry: false

![在这里插入图片描述][a41fc2f1e72642f8bb82f75b967cf393.png]

`服务名称和 eureka 地址的配置我们可以认为是服务注册的配置，而 eureka 自己也是一个微服务，所以在服务启动的时候，它也会把自己注册到 eureka 上！`

**⑥ 启动类上添加 @EnableEurekaServer 注解**

![在这里插入图片描述][f254136c89384a3780714e17eef8d1fb.png]

**⑦ 输入 http://localhost:11011/，出现以下界面即 Eureka 创建成功。**

![在这里插入图片描述][5df0487c9d3d492b97ba41118eea6227.png]

#### 4. 服务注册 ####

> 情形：  
> 创建一个 order 服务和一个 user 服务，并把它们都注册到 eureka 中。order 里面需要用到 user，所以此时的 order 是消费者，user 是提供者。

对于服务的注册，我们只需要完成两步：  
① 引入 spring-cloud-starter-netflix-eureka-client 依赖；  
② 在 yml 文件中配置服务名称和 eureka 地址。

`eureka 服务的依赖是 server，其余微服务都是 client！`

**① 创建 order 服务和 user 服务**

![在这里插入图片描述][348a88e7e69048f5b9e580114c6f571b.png]

**② 引入 eureka 客户端依赖**

![在这里插入图片描述][5b2b7aaa19de42cbb49cd5006c220b32.png]

![在这里插入图片描述][d25af2825dce484eace76d377cbced82.png]

**③ 在父级 pom 中添加该子模块**

![在这里插入图片描述][bd38307fe51d4235b973c729bd21c3b7.png]

**④ 编写 yml 配置文件**

#服务端口，随便起
    server:
      port: 8081
    #服务名称
    spring:
      application:
        name: userserver
      datasource:
        url: jdbc:mysql:///user?serverTimezone=UTC
        username: root
        password: 856724bb
        driver-class-name: com.mysql.cj.jdbc.Driver
    
    #eureka地址
    eureka:
      client:
        service-url:
          defaultZone: http://127.0.0.1:11011/eureka/

![在这里插入图片描述][b2e038d6fb0f4fdd93d8b68b04eac734.png]

**④ 启动类上添加 @EnableEurekaServer 注解**

![在这里插入图片描述][464eba7feeb74c17b61ab2713af33534.png]

`以上是 user 的注册，order 同理！`

![在这里插入图片描述][f60b700c1a31431ebf91825d86d47506.png]

#### 5. 编写业务代码 ####

> 要求查询订单表，其中订单表里面包含用户信息。

**① 实体类**

![在这里插入图片描述][ec4fb9adfe49417ba4e829de0e5a0df7.png]

![在这里插入图片描述][29ff0c71e838485a8cc9b11f70e44131.png]

![在这里插入图片描述][ea8f6b2a92f34f5d9a40d8c4d8c50a6a.png]

**② 配置文件中添加驼峰命名功能及实体映射**

#开启驼峰命名及实体映射
    mybatis:
      type-aliases-package: com.zxe.orderserver.pojo
      configuration:
        map-underscore-to-camel-case: true

**③ 编写数据层、业务层及控制层的代码**

![在这里插入图片描述][149360ed107648deb448d21b8a513fd5.png]  
![在这里插入图片描述][ad4667830bc347bc935d42d82b19e4c7.png]

![在这里插入图片描述][43f8ae7bba5e4bdaabe2c065cf7806c1.png]

![在这里插入图片描述][2644245d0255400a881e69b7750593ce.png]

![在这里插入图片描述][a475403e89014a6b8f7ba454e46ba3d2.png]

#### 6. 服务拉取 ####

服务拉取是基于服务名称获取服务列表，然后再对服务列表做负载均衡。

**① 在 order-service 的启动类中注册 RestTemplate**

![在这里插入图片描述][cfd472bcf33c4564a93d70849cf20173.png]

`@LoadBalanced 注解用来做负载均衡！`

**② 编写 OrderService 代码，order 要调用 user，自然要用到 user 接口的访问路径，此处的路径中我们用服务名来代替 localhost**

@Service
    public class OrderService {
        
    
        @Autowired
        private OrderMapper orderMapper;
        @Autowired
        private RestTemplate restTemplate;
    
        public Order findById(Integer id) {
        
            Order order = orderMapper.find(id);
            String url = "http://userserver/user/" + order.getUserId();
            User user = restTemplate.getForObject(url, User.class);
            order.setUser(user);
            return order;
        }
    }

**③ 运行结果**

![在这里插入图片描述][648ab0ba84ac4b448cde02e73ede4bdf.png]

[4afbd06049dd4df89b94d71cbc8be126.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/913bf1fd045540c5bb7cfe63c1fa0493.png
[c0a9d44064374eb68f7f9b411e0ad1e4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/3211b45370004a0595f0376d85e03a1a.png
[d1d016d10a7c45e7b568b5676b1c22c9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/62d050c85d4d4390851446cc35f7b360.png
[b1232944f6994f8da33acd294483f3ac.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/f2df41c5c20743baa2951ed8b53865b6.png
[8483535ad4474d55a1a5e5aff7a81eb3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/b85e8fd939a14ed2812090b46d2cecc5.png
[ea8bc95913384ed2a16310e675bc6be3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/c9a6472f312242d280260a3c20857aca.png
[e3db5d8560194bfc96d11a0eb24ea972.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/baed93f960b04e3093e437e92632b884.png
[aef5f0b9c6ce4608bc55b9b70aa0fb49.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/4d99e0f6d09a4c13b5d799f625c70e4e.png
[20dd0921c5fe4838a74bf2ff0ae74038.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/66d96d6685cc4dffb3604dc8a55a4481.png
[bdb5ed722884436284aea57468b66b03.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/4515c134cd7a470c9395aa7d76ecdadd.png
[e0f961c675f94108a6e5c6bf5ff71f98.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/a9165baeaf554d1a81d737869f9596b3.png
[bcb6fa13d8904c4cbf893ab77d37b71d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/ad9a7244bccf4a8d8712933818a71a47.png
[662cbc1391434578a4bc87d874755256.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/b4733a55f3cf40168c5ff26505f10601.png
[a41fc2f1e72642f8bb82f75b967cf393.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/77c31e07fb9240f090298902393303fa.png
[f254136c89384a3780714e17eef8d1fb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/2caffe070ef745f7bf002dc4353acb83.png
[5df0487c9d3d492b97ba41118eea6227.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/07fcdbbec90644f99339b16a2d0eea17.png
[348a88e7e69048f5b9e580114c6f571b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/5ce06fd8838040f38a32c7930d30c581.png
[5b2b7aaa19de42cbb49cd5006c220b32.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/7b5474c222de45d3a6af79738317dd9b.png
[d25af2825dce484eace76d377cbced82.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/f90f4bae42cb4f5889f63a6ae90b8960.png
[bd38307fe51d4235b973c729bd21c3b7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/b5ee8418674f4efb945a4f1c1dba4854.png
[b2e038d6fb0f4fdd93d8b68b04eac734.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/03dca279b46e47c09a374bdbc36bff58.png
[464eba7feeb74c17b61ab2713af33534.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/1ace8f7ff081447e931dd54042eb9637.png
[f60b700c1a31431ebf91825d86d47506.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/21121a6d34c243b2ae4a6e3db1c3a41b.png
[ec4fb9adfe49417ba4e829de0e5a0df7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/cbe03e30d87d492aa5a292186d17c832.png
[29ff0c71e838485a8cc9b11f70e44131.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/b3a181a4e6ce41bbba2615a7fca94aff.png
[ea8f6b2a92f34f5d9a40d8c4d8c50a6a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/7fc68ea2d5e849209df20fba8a748554.png
[149360ed107648deb448d21b8a513fd5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/a0f2bddf9a8a46a4bb43fc7a9328e6e1.png
[ad4667830bc347bc935d42d82b19e4c7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/62c29bfd67534e9abc04a126bec44818.png
[43f8ae7bba5e4bdaabe2c065cf7806c1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/f2872c78f3864243a15cadbed7b5cfee.png
[2644245d0255400a881e69b7750593ce.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/a5bded379c544f06a927467429f8d5e6.png
[a475403e89014a6b8f7ba454e46ba3d2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/b832615a47c0436d8d2dc6f7f42f4dab.png
[cfd472bcf33c4564a93d70849cf20173.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/7e052297709d403bb5aad3d0ea19a375.png
[648ab0ba84ac4b448cde02e73ede4bdf.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/19/ec1e9d0273104fd9bb92d1ef866647f6.png