技术教程 SpringCloud Hoxton版微服务-入门篇 正文

SpringCloud Hoxton版微服务-入门篇

2022-07-26,,

SpringCloud Hoxton.SR9初级版

文章目录

    • SpringCloud Hoxton.SR9初级版
  • 前言
  • 一、架构选型
  • 二、父工程创建
    • 1、创建maven工程：
    • 2、全局设置编码：
    • 3、注释生效激活：
    • 4、java编译版本选择：
    • 5、删除src文件夹、清除pom.xml部分代码
    • 5、删除src文件夹、清除pom.xml部分代码聚合结果：
    • 6、完善pom.xml依赖：
  • 二、子工程创建-支付模块
    • 1、创建支付模块：
    • 2、模块名称 dt-provider-payment：
    • 3、父工程的pom.xml依赖便会自动导入 dt-provider-payment子工程的支付模块：
    • 4、dt-provider-payment子工程的支付模块：
    • 5、dt-provider-payment子工程基础架构如下：
    • 6、dt-provider-payment导入pom.xml依赖：
    • 6、配置application.yml:
    • 6、创建启动器PaymentAppMain.class:
    • 7、创建PaymentController.class控制器:
  • 三、子工程创建-订单模块
    • 1、订单服务名称 dt-consumer-order：
    • 2、配置application.yml：
    • 3、创建OrderAppMain启动器：
    • 4、创建OrderController.class控制器：
    • 5、订单(消费者)调用支费服务（提供者）：
      • 5.1 RestTemplate简介
      • 5.2 RestTemplate配置类
  • 四、子工程创建-公共模块
    • 1、公共服务名称 dt-service-common:
    • 2、导入pom.xml依赖:
    • 3、通用JSON返回实体:
    • 4、通用Payment 实体:
    • 5、通用基础架构:
    • 6、打包上传到maven库，共享通用：
      • 6.1 先clean再install
      • 6.2 打包成功后即可在订单和支付模块使用公共依赖库
  • 五、测试：
    • 1、支付模块自测试
    • 2、订单调用支付模块测试
  • 六、最后

前言

Spring Cloud 是一系列框架的有序集合，它利用 Spring Boot的开发便利性简化了分布式系统的开发，比如服务发现、服务网关、服务路由、链路追踪等。
Spring Cloud并不重复造轮子，而是将市面上开发得比较好的模块集成进去，进行封装，从而减少了各模块的开发成本。
换句话说：Spring Cloud提供了构建分布式系统所需的“全家桶”。

一、架构选型

spring-cloud官方地址：https://spring.io/projects/spring-cloud#learn

时至今日，技术选型官方推荐如下：

可以看到官方更新的最新H版，并且推荐我们使用的Spring-Boot版本是2.3.5的稳定版。

二、父工程创建

1、创建maven工程：

2、全局设置编码：

3、注释生效激活：

4、java编译版本选择：

5、删除src文件夹、清除pom.xml部分代码

5、删除src文件夹、清除pom.xml部分代码聚合结果：

6、完善pom.xml依赖：

<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.17</mysql.version>
    <druid.version>1.1.16</druid.version>
    <mybatis.spring.boot.version>1.3.2</mybatis.spring.boot.version>
    <!--架构选型-->
    <springboot.version>2.3.5.RELEASE</springboot.version>
    <spring-cloud.version>Hoxton.SR9</spring-cloud.version>
  </properties>

  <!--子模块继承父工程-->
  <dependencyManagement>
    <dependencies>
      <!--spring-boot-->
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-dependencies</artifactId>
        <version>${springboot.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
      <!--spring-cloud-->
      <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-dependencies</artifactId>
        <version>${spring-cloud.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
      <!--mysql-->
      <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>${mysql.version}</version>
        <scope>runtime</scope>
      </dependency>
      <!-- druid-->
      <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>${druid.version}</version>
      </dependency>
      <!--mybatis-->
      <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>${mybatis.spring.boot.version}</version>
      </dependency>
      <!--单元测试-->
      <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>${junit.version}</version>
      </dependency>
      <!--log4j-->
      <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>${log4j.version}</version>
      </dependency>
      <!--lombok-->
      <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>${lombok.version}</version>
        <scope>provided</scope>
      </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>

二、子工程创建-支付模块

1、创建支付模块：

2、模块名称 dt-provider-payment：

3、父工程的pom.xml依赖便会自动导入 dt-provider-payment子工程的支付模块：

4、dt-provider-payment子工程的支付模块：

5、dt-provider-payment子工程基础架构如下：

6、dt-provider-payment导入pom.xml依赖：

<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>
    <!--druid-->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
    </dependency>
    <!--mysql-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
    <!--devtools-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <scope>runtime</scope>
        <optional>true</optional>
    </dependency>
    <!--lombok-->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
    <!--test-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

6、配置application.yml:

server:
  port: 9001
spring:
  application:
    name: cloud-payment-service
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://xxxxxxx:3306/dtcloud?useUnicode=true&characterEncoding=utf-8&useSSL=false
    username: root
    password: 123456
mybatis:
  mapperLocations:  classpath:mapper/*.xml
  type-aliases-package: com.dtydf.springcloud.pojo
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

6、创建启动器PaymentAppMain.class:

7、创建PaymentController.class控制器:

@RestController
@RequestMapping("/api/pay")
public class PaymentController {

    @Autowired
    private PaymentService paymentService;

    @GetMapping(value = "/payment/get/{id}")
    public CommentResult<Payment> getPaymentById(@PathVariable("id") Long id){
        Payment payment = paymentService.getById(id);
        log.info("返回结果："+payment);
        if(payment != null){
            return new CommentResult<>(200,"查询成功",payment);
        }else {
            return new CommentResult<>(201,"没有查询到对应的记录",null);
        }
    }
}

三、子工程创建-订单模块

1、订单服务名称 dt-consumer-order：

2、配置application.yml：

server:
  port: 8001
spring:
  application:
    name: cloud-consumer-service

3、创建OrderAppMain启动器：

@SpringBootApplication(exclude={DataSourceAutoConfiguration.class})
public class OrderAppMain {

    public static void main(String[] args) {
        SpringApplication.run(OrderAppMain.class,args);
    }
}

4、创建OrderController.class控制器：

@RestController
@Slf4j
public class OrderController {

    private static final String PAYMENT_URL = "http://localhost:9001";

    @Autowired
    private RestTemplate restTemplate;

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

    @GetMapping(value = "/consumer/payment/get/{id}")
    public CommentResult<Payment> getPaymentById(@PathVariable("id") Long id){
        log.info("订单(消费者)调用支费服务（提供者）");
        return restTemplate.getForObject(PAYMENT_URL + "/payment/get/"+id,CommentResult.class);
    }

}

5、订单(消费者)调用支费服务（提供者）：

5.1 RestTemplate简介

RestTemplate是Spring提供的用于访问Rest服务的客户端，RestTemplate提供了多种便捷访问远程Http服务的方法,能够大大提高客户端的编写效率

5.2 RestTemplate配置类

/**
 * @description: RestTemplate
 * @author: ydf
 * @date: 2020/12/2 22:45
 * @version: v1.0
 */
@Configuration
public class ApplicationContextConfig {

    @Bean
    @LoadBalanced //开启负载均衡的功能(轮询的方式)
    public RestTemplate restTemplate(){
        return new RestTemplate();
    }
}

四、子工程创建-公共模块

1、公共服务名称 dt-service-common:

2、导入pom.xml依赖:

<dependencies>
        <!--devtools-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <!--lombok-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <!--hutool Java基础工具类,对文件、流、加密解密、转码、正则、线程、XML等JDK方法进行封装-->
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.1.0</version>
        </dependency>
    </dependencies>

3、通用JSON返回实体:

/**
 * @description: 通用JSON返回实体
 * @author: ydf
 * @date: 2020/12/2 21:50
 * @version: v1.0
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class CommentResult<T> {

    private Integer code;

    private String message;

    private T data;

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

4、通用Payment 实体:

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Payment implements Serializable {

    private static final long serialVersionUID = -6582898024290800951L;

    private Long id;

    private String serial;
}

5、通用基础架构:

6、打包上传到maven库，共享通用：

6.1 先clean再install

6.2 打包成功后即可在订单和支付模块使用公共依赖库

<!--引入自己自定义的api通用包，可以使用Payment支付Entity-->
<dependency>
    <groupId>com.dtydf.springcloud</groupId>
    <artifactId>dt-service-common</artifactId>
    <version>1.0-SNAPSHOT</version>
    <scope>compile</scope>
</dependency>

五、测试：

1、支付模块自测试

http://localhost:9001/payment/get/1

2、订单调用支付模块测试

http://localhost:8001/consumer/payment/get/1

六、最后

订单(消费者)调用支费服务（提供者），通过Spring提供的RestTemplate，访问Rest服务的客户端，实现了简单的微服务间的调用。

下一篇我们将使用RestTemplate做服务调用的负载均衡实现。

本文地址：https://blog.csdn.net/qq_41107231/article/details/110496929

《SpringCloud Hoxton版微服务-入门篇.doc》

下载本文的Word格式文档，以方便收藏与打印。

Copyright 2023. 昆居客 - IT编程,互联网信息技术文档大全!