二. SpringCloud基本Rest微服务工程搭建

1. 父工程构建

1.1 Maven项目搭建

环境	版本
JDK	1.8
Maven	3.6+
Maven模板	maven-archetype-size
删除父工程src文件

1.2 父工程pom文件

回顾：

① Maven中dependencyManagement和dependencies的区别

Maven使用dependencyManagement元素来提供一种管理依赖版本号的方式。通常会在一个组织或者项目的最顶层的父POM中看到。使用pom.xml中的dependencyManagement元素能让所有中引用一个依赖而不用显示的列出版本号。Maven会沿着父子层次向上找，直到找到一个拥有dependencyManagement元素的项目，然后它就会使用这个元素中指定的版本号。另外如果某个子项目需要使用另外的版本只需要声明version即可。注意：dependencyManagement里只是声明依赖，并不实现引入，因此子项目要显示的声明需要的依赖。

② Maven中如何跳过单元测试

在Idea的Maven侧栏点击闪电图标，使Maven跳过test生命周期即可。

<?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.polaris</groupId>

    <artifactId>com.polaris.springcloud</artifactId>

    <version>1.0-SNAPSHOT</version>

    <packaging>pom</packaging>

    <modules>

    </modules>

    <!-- 统一管理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>5.1.47</mysql.version>

        <druid.version>1.1.16</druid.version>

        <mybatis.spring.boot.version>1.3.0</mybatis.spring.boot.version>

    </properties>

    <!-- 子模块继承之后，提供作用：锁定版本+子modlue不用写groupId和version  -->

    <dependencyManagement>

        <dependencies>

            <!--spring boot 2.2.2-->

            <dependency>

                <groupId>org.springframework.boot</groupId>

                <artifactId>spring-boot-dependencies</artifactId>

                <version>2.2.2.RELEASE</version>

                <type>pom</type>

                <scope>import</scope>

            </dependency>

            <!--spring cloud Hoxton.SR1-->

            <dependency>

                <groupId>org.springframework.cloud</groupId>

                <artifactId>spring-cloud-dependencies</artifactId>

                <version>Hoxton.SR1</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>2.1.0.RELEASE</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.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>

            <dependency>

                <groupId>log4j</groupId>

                <artifactId>log4j</artifactId>

                <version>${log4j.version}</version>

            </dependency>

            <dependency>

                <groupId>org.projectlombok</groupId>

                <artifactId>lombok</artifactId>

                <version>${lombok.version}</version>

                <optional>true</optional>

            </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>

</project>

2. 微服务提供者支付Module模块

cloud-provider-payment8001

2.1 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">

    <parent>

        <artifactId>com.polaris.springcloud</artifactId>

        <groupId>com.polaris</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>

        <!--mysql-connector-java-->

        <dependency>

            <groupId>mysql</groupId>

            <artifactId>mysql-connector-java</artifactId>

        </dependency>

        <!--jdbc-->

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-jdbc</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>

2.2 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              # mysql驱动包

    url: jdbc:mysql://mpolaris.top:3306/cloud-test?useUnicode=true&characterEncoding=utf-8&useSSL=false

    username: root

    password: 123456

mybatis:

  mapperLocations: classpath:mapper/*.xml

  type-aliases-package: com.polaris.springcloud.entities    # 所有Entity别名类所在包

2.3 主启动类

/**

 * @Author polaris

 * @Date 2021/1/21 1:00

 */

@SpringBootApplication

public class PaymentMain {

    public static void main(String[] args) {

        SpringApplication.run(PaymentMain.class,args);

    }

}

2.4 业务类（简单演示）

建表

entities

主实体与 Json封装体

@Data

@AllArgsConstructor

@NoArgsConstructor

public class Payment implements Serializable {

    private Long id;

    private String serial;

}

@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);

    }

}

dao

接口PaymentDao与mybatis映射文件PaymentMapper

@Mapper

public interface PaymentDao {

    int save(Payment payment);

    Payment getPaymentById(@Param("id") Long id);

}

<?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.polaris.springcloud.dao.PaymentDao">

    <insert id="save" parameterType="Payment" useGeneratedKeys="true" keyProperty="id">

        insert into payment(serial)  values(#{serial});

    </insert>

    <resultMap id="BaseResultMap" type="com.polaris.springcloud.entities.Payment">

        <id column="id" property="id" jdbcType="BIGINT"/>

        <id column="serial" property="serial" jdbcType="VARCHAR"/>

    </resultMap>

    <select id="getPaymentById" parameterType="Long" resultMap="BaseResultMap">

        select * from payment where id=#{id};

    </select>

</mapper>

service

接口与实现类

@Service

public class PaymentServiceImpl implements PaymentService {

    @Resource

    private PaymentDao paymentDao;

    @Override

    public int save(Payment payment) {

        return paymentDao.save(payment);

    }

    @Override

    public Payment getPaymentById(Long id) {

        return paymentDao.getPaymentById(id);

    }

}

controller

@RestController

@Slf4j

@RequestMapping("/payment")

public class PaymentController {

    @Resource

    private PaymentService paymentService;

    @PostMapping("/save")

    public CommonResult save(Payment payment) {

        int result = paymentService.save(payment);

        log.info("===> result: " + result);

        if(result > 0) {

            return new CommonResult(200,"保存到数据库成功",result);

        }

        return new CommonResult(400,"保存到数据库失败",null);

    }

    @GetMapping("/get/{id}")

    public CommonResult<Payment> save(@PathVariable("id") Long id) {

        Payment paymentById = paymentService.getPaymentById(id);

        log.info("===> payment: " + paymentById);

        if(paymentById != null) {

            return new CommonResult(200,"查询成功",paymentById);

        }

        return new CommonResult(400,"查询失败",null);

    }

}

3. 开启Devtools热部署

3.1 聚合父类总工程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.2 当前工程添加devtools依赖

<dependency>

    <groupId>org.springframework.boot</groupId>

    <artifactId>spring-boot-devtools</artifactId>

    <scope>runtime</scope>

    <optional>true</optional>

</dependency>

3.3 Idea开启自动编译选项

3.4 开启热注册

快捷键 ctrl + shift + alt + /，打开Registry

勾选

重启Idea，即可测试代码时不用手动重启

注意：该功能只能在开发阶段使用，上线前一定要关闭

4. 微服务消费者订单Module模块

cloud-consumer-order80

4.1 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.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>

4.2 yml配置文件

server:

  port: 80

4.3 主启动类

4.4 RestTemplate引入

是什么

RestTemplate提供了多种便捷访问远程Http服务的方法，是一种简单便捷的访问restful服务模板类，是Spring提供的用于访问Rest服务的客户端模板工具类

如何使用

官网使用：https://docs.spring.io/spring-framework/docs/5.2.2.RELEASE/javadoc-api/org/springframework/web/client/RestTemplate.html

使用restTemplate访问restful接口非常的简单粗暴。

url REST请求地址
requestMap 请求参数
ResponseBean.classs HTTP响应转换被转换成的对象类型

config配置类

@Configuration

public class ApplicationContextConfig {

    @Bean

    public RestTemplate getRestTemplate() {

        return new RestTemplate();

    }

}

4.5 业务类

entities

与提供者支付模块一致

controller

@RestController

@Slf4j

@RequestMapping("/consumer")

public class OrderController {

    @Resource

    private RestTemplate restTemplate;

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

    @GetMapping("/payment/save")

    public CommonResult<Payment> save(Payment payment) {

        return restTemplate.postForObject(PAYMENT_URL + "/payment/save",

                payment,CommonResult.class);

    }

    @GetMapping("/payment/get/{id}")

    public CommonResult<Payment> get(@PathVariable("id") Long id) {

        return restTemplate.getForObject(PAYMENT_URL + "/payment/get/" + id,

                CommonResult.class);

    }

}

4.6 启动两个模块测试

启动两个模块没有出现Run Dashbord的问题

在工程目录下找.idea文件夹下的workspace.xml添加如下代码即可

<component name="RunDashboard">

    <option name="configurationTypes">

      <set>

        <option value="SpringBootApplicationConfigurationType" />

      </set>

    </option>

    <option name="ruleStates">

      <list>

        <RuleState>

          <option name="name" value="ConfigurationTypeDashboardGroupingRule" />

        </RuleState>

        <RuleState>

          <option name="name" value="StatusDashboardGroupingRule" />

        </RuleState>

      </list>

    </option>

</component>

插入成功但是没有内容的问题

解决：支付模块这里一定要加@RequestBody注解

@PostMapping("/save")

public CommonResult save(@RequestBody Payment payment) {

	int result = paymentService.save(payment);

	log.info("===> result: " + result);

	if(result > 0) {

	return new CommonResult(200,"保存到数据库成功",result);

	}

	return new CommonResult(400,"保存到数据库失败",null);

}

5. 工程重构 - 公共工程模块

5.1 发现问题 - 系统中有重复代码 entities

5.2 新建公共工程 cloud-api-common

重复代码，公共接口，第三方接口，工具类等都可以放在这里

pom.xml

Hutool是一个小而全的Java工具类库，是项目中“util”包友好的替代

<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>

    <!-- hutool工具类 -->

    <dependency>

        <groupId>cn.hutool</groupId>

        <artifactId>hutool-all</artifactId>

        <version>5.1.0</version>

    </dependency>

</dependencies>

5.3 抽取多个模块的共同代码

将cloud-api-common安装到maven仓库

修改订单80和支付8001代码

删除各自原先的enntities
各自添加pom内容

<!-- 公共模块 -->

<dependency>

    <groupId>com.polaris</groupId>

    <artifactId>cloud-api-common</artifactId>

    <version>${project.version}</version>

</dependency>

二. SpringCloud基本Rest微服务工程搭建的更多相关文章

SpringCloud+Eureka+Feign+Ribbon的简化搭建流程,加入熔断,网关和Redis缓存[2]
目录前提:本篇是基于 SpringCloud+Eureka+Feign+Ribbon的简化搭建流程和CRUD练习[1] 的修改与拓展 1.修改consumer的CenterFeign.java,把返 ...
【springcloud】Eureka服务注册中心搭建
转自:https://blog.csdn.net/pengjunlee/article/details/86538997 Spring Cloud是一系列框架的集合,它利用Spring Boot的开发 ...
SpringCloud微服务实战——搭建企业级开发框架（二）：环境准备
这里简单说明一下在Windows系统下开发SpringCloud项目所需要的的基本环境,这里只说明开发过程中基础必须的软件,其他扩展功能(Docker,k8s,MinIO,XXL-JOB,EKL,Ke ...
SpringCloud微服务实战——搭建企业级开发框架（四十二）：集成分布式任务调度平台XXL-JOB，实现定时任务功能
定时任务几乎是每个业务系统必不可少的功能,计算到期时间.过期时间等,定时触发某项任务操作.在使用单体应用时,基本使用Spring提供的注解即可实现定时任务,而在使用微服务集群时,这种方式就要考虑添 ...
SpringCloud微服务实战——搭建企业级开发框架（二十三）：Gateway+OAuth2+JWT实现微服务统一认证授权
OAuth2是一个关于授权的开放标准,核心思路是通过各类认证手段(具体什么手段OAuth2不关心)认证用户身份,并颁发token(令牌),使得第三方应用可以使用该token(令牌)在限定时间.限定 ...
SpringCloud微服务实战——搭建企业级开发框架（四十五）：【微服务监控告警实现方式二】使用Actuator（Micrometer）+Prometheus+Grafana实现完整的微服务监控
无论是使用SpringBootAdmin还是使用Prometheus+Grafana都离不开SpringBoot提供的核心组件Actuator.提到Actuator,又不得不提Micrometer ...
SpringCloud微服务实战——搭建企业级开发框架（二十一）：基于RBAC模型的系统权限设计
RBAC(基于角色的权限控制)模型的核心是在用户和权限之间引入了角色的概念.取消了用户和权限的直接关联,改为通过用户关联角色.角色关联权限的方法来间接地赋予用户权限,从而达到用户和权限解耦的目的. R ...
SpringCloud微服务实战——搭建企业级开发框架（二十二）：基于MybatisPlus插件TenantLineInnerInterceptor实现多租户功能
多租户技术的基本概念: 多租户技术(英语:multi-tenancy technology)或称多重租赁技术,是一种软件架构技术,它是在探讨与实现如何于多用户的环境下共用相同的系统或程序组件,并且 ...
SpringCloud微服务实战——搭建企业级开发框架（二十四）：集成行为验证码和图片验证码实现登录功能
随着近几年技术的发展,人们对于系统安全性和用户体验的要求越来越高,大多数网站系统都逐渐采用行为验证码来代替图片验证码.GitEgg-Cloud集成了开源行为验证码组件和图片验证码,并在系统中添加可配置 ...

随机推荐

Helm 带你飞
文章目录目录文章目录在没使用 Helm之前,向 K8S部署应用,我们要依次部署 deployment. svc 等,步骤较繁琐.况且随着很多项目微服务化,复杂的应用在容器中部署以及管理显得较为复 ...
python初学者-从键盘获取信息
name = input(">>> 姓名:") QQ = input(">>>QQ: ") phone_num = inpu ...
后端Long类型传到前端精度丢失的正确解决方式
原因:前端js对Long类型支持的精度不够,导致后端使用的Long传到前端丢失精度,比如现在分布式id生成算法"雪花算法"在使用中就会出现问题. 解决方式: 1.后端的Long类型 ...
grpc系列- protobuf详解
Protocol Buffers 是一种与语言.平台无关,可扩展的序列化结构化数据的方法,常用于通信协议,数据存储等等.相较于 JSON.XML,它更小.更快.更简单,因此也更受开发人员的青眯. 基本 ...
如何快速学会git
相信大多数入门者都对git的原理比较恍惚,今天我们来告诉大家如何快速学会git命令. 1.git init 这个命令会在当前目录里创建一个.git目录,也就是初始化本地仓库.git. 如图先创建文件夹 ...
vue中的插值操作
mustache语法 1.将data的文本数据插入至html语句中,使用mustache语法. v-once指令 2.在某些情况下,我们不希望界面随意的跟随改变,这个时候我们可以使用v-once的指令 ...
2.1JAVA文件基本结构
命名包名全为英文小写项目包命名域名反转.团队名.项目名相关项目包命名域名反转.团队名.父项目名.子项目名类和接口名所有单词首字母大写抽象类用"Abstract" ...
简单4步，利用Prometheus Operator实现自定义指标监控
本文来自Rancher Labs 在过去的文章中,我们花了相当大的篇幅来聊关于监控的话题.这是因为当你正在管理Kubernetes集群时,一切都会以极快的速度发生变化.因此有一个工具来监控集群的健康状 ...
Vue2+Koa2+Typescript前后端框架教程--05Sequelize的使用（ORM）
本篇开始分享Node.js后端服务开发中对于数据结构ORM的实现,主要使用的技术栈是:Sequelize. 上一篇文章中讲到班级管理的数据结构:ID,班级名称,班级编码,班主任ID,使用的数据库是My ...
分享一个的c++写的，模仿awk的框架类CAwkDoc
这是我好多年前,模仿awk写的. awk大家都比较熟悉,使用awk处理文件,读取文件,分割字段这些工作awk自己帮你实现了. 程序员只要编写业务逻辑代码,并且awk还提供了很多常用的字符串操作函数,可 ...