SpringCloud 微服务最佳开发实践

 更新时间:2021年07月08日 16:40:32   作者:飘渺Jam的博客  
本文结合我们实际的开发中遇到的一些问题整理出了一份微服务开发的实践规范,对SpringCloud 微服务开发实践相关知识感兴趣的朋友一起看看吧

现在基于SpringCloud的微服务开发日益流行,网上各种开源项目层出不穷。我们在实际工作中可以参考开源项目实现很多开箱即用的功能,但是必须要遵守一定的约定和规范。

本文结合我们实际的开发中遇到的一些问题整理出了一份微服务开发的实践规范,欢迎各位大佬拍砖指点。

Maven规范

1.所有项目必须要有一个统一的parent模块

所有微服务工程都依赖这个parent,parent用于管理依赖版本,maven仓库,jar版本的统一升级维护

在parent下层可以有 core,starter,rate-limit 等自定义模块

2.core 核心包的作用:

  • 以POJO形式约定各种开发规范;如BaseEntity,统一入参,返参
  • 各种二方、三方组件开箱即用AutoConfig;
  • 各种提高开发效率的帮助类等 XXXUtil

注意:core包所有依赖的scope必须是provided,避免传递依赖,同时配合Condition注解按条件加载Bean 如 @ConditionalOnClass(Ribbon.class),@ConditionalOnBean(StringRedisTemplete.class)

3.starter模块

如果你每个服务都需要依赖10几个starter,可以建一个统一的starter模块帮他们统一依赖进来,管理依赖集,简化依赖

4.rate-limit模块

用于放置非通用的自开发组件

5.正确区分Release版本 和 Snapshot版本

说明:如果是Snapshot版本,那么在mvn deploy时会自动发布到快照版本库中,而使用快照版本的模块,在不更改版本号的情况下,直接编译打包时,Maven会自动从镜像服务器上下载最新的快照版本。

如果是Release版本,那么在mvn deploy时会自动发布到正式版本库中,而使用正式版本的模块,在不更改版本号的情况下,编译打包时如果本地已经存在该版本的模块则不会主动去镜像服务器上下载。

简而言之:

Release : 正式版,有bug不能再继续使用这个版本号

Snapshot:快照版,有bug可以继续使用同一版本号,可以自动升级,推荐使用

服务调用

规范服务间通过引入sdk调用,服务消费者需要依赖生产者提供的api,配合snapshot方便升级

account
	account-api
	account-service

account-api 模块中放消费方需要用到的东西,api接口,vo,入参等...

public interface AccountApi {
    ...
}

account-service实现account-api提供的接口

@RestController
@Log4j2
@Api(tags = "用户接口")
@RequiredArgsConstructor(onConstructor = @__(@Autowired))
public class AccountController implements AccountApi {
    ...
}

消费者通过feign调用生产者,直接集成生产者提供的接口并处理熔断

@Component
@FeignClient(name = "account-service",fallbackFactory = AccountClientFallbackFactory.class)
public interface AccountClient extends AccountApi {
    ...
}

@Component
public class AccountClientFallbackFactory implements FallbackFactory<AccountClient> {

    @Override
    public AccountClient create(Throwable throwable) {
        AccountClientFallback accountClientFallback = new AccountClientFallback();
        accountClientFallback.setCause(throwable);
        return accountClientFallback;
    }

}

@Slf4j
public class AccountClientFallback implements AccountClient {
    @Setter
    private Throwable cause;

    @Override
    public ResultData<AccountDTO> getByCode(String accountCode) {
        log.error("查询失败,接口异常" ,cause);
        AccountDTO account = new AccountDTO();
        account.setAccountCode("000");
        account.setAccountName("测试Feign");
        return ResultData.success(account);
    }

}

Restful设计规范

一个 API 是一个开发者的 UI - 就像其他任何 UI 一样, 确保用户体验被认真的考虑过是很重要的!

可以使用以下两种格式:

  1. /版本/访问控制/域对象
  2. /版本/访问控制/域对象/动作

域对象需要遵循以下几条约束:

  • 域对象 用名词而非动词
  • 直接使用域对象名 使用/ticket而不是复数/tickets
  • 域对象关系表达 最大不超过2层,如/ticket/12/message
  • 需要正确区分 GET PUT POST DELETE 请求方法
  • 无法用名词 + 请求方法表述的可以扩展为 /域对象/动词 如 POST /user/login

在网关层对接口进行访问控制,访问控制的规则分为:

pb - public 所有请求均可访问

pt - protected 需要进行token认证通过后方可访问

pv - private 无法通过网关访问,只能微服务内部调用

df - default 网关请求token认证,并且请求参数和返回结果进行加解密

版本:

以微服务为力度,整个服务进行升级

例如,一个微服务有如下API

GET /v1/pb/user

POST /v1/pb/user

PUT /v1/pb/user

如果 POST /v1/pb/user 需要升级,则需要将整个微服务 /v1 升级到 /v2,同时保证版本兼容的api老版本可以继续访问

GET /v2/pb/user 等价于 GET /v1/pb/user

POST /v1/pb/user 标记为已废弃

POST /v2/pb/user

PUT /v2/pb/user 等价于 PUT /v1/pb/user

代码实现:

1.GET方式{version}可以是任意值,v1,v2均可,如:@GetMapping("/{version}/pb/user")

2.POST方法强制使用 V1 ,并标记为已废弃,但是仍可使用

@Deprecated
@PostMapping("/v1/pb/user")

3.POST {version}应是当前版本,只能是v2

@PostMapping("/{version}/pb/user")

网关

  1. 可以不承担微服务鉴权功能,由自己服务实现(简单服务可以直接在网关层鉴权)
  2. 网关鉴权与微服务鉴权的差异在我其他文章中有详细说明,可参考此文:http://t.hk.uy/2c3
  3. 需要实现访问控制权限,结合上文的Restful规范,屏蔽/pv/** 等特殊请求
  4. 需要实现灰度发布功能

开发联调的时候需要将服务器流量导入到本地,结合nacos的元数据与请求头可实现服务实例的筛选。参考此文实现:http://t.hk.uy/2c6

到此这篇关于SpringCloud 微服务最佳开发实践的文章就介绍到这了,更多相关SpringCloud 微服务内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java新特性中Preview功能如何运行调试详解

    Java新特性中Preview功能如何运行调试详解

    这篇文章主要为大家介绍了Java新特性中Preview功能如何运行调试详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-10-10
  • Spring的Aware接口你知道多少

    Spring的Aware接口你知道多少

    这篇文章主要为大家详细介绍了Spring的Aware接口,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-02-02
  • 深入讲解我们说的CAS自旋锁到底是什么

    深入讲解我们说的CAS自旋锁到底是什么

    这篇文章主要给大家介绍了关于我们说的CAS自旋锁到底是什么的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2018-05-05
  • Redis分布式锁实现方式及超时问题解决

    Redis分布式锁实现方式及超时问题解决

    这篇文章主要介绍了Redis分布式锁实现方式及超时问题解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-04-04
  • Mybatis-Plus开发提速器generator的使用

    Mybatis-Plus开发提速器generator的使用

    本文就介绍这款基于Mybatis-Plus的代码自助生成器,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-07-07
  • Maven分模块开发与依赖管理和聚合和继承及属性深入详细介绍

    Maven分模块开发与依赖管理和聚合和继承及属性深入详细介绍

    依赖管理是项目管理中非常重要的一环。几乎任何项目开发的时候需要都需要使用到库。而这些库很可能又依赖别的库,这样整个项目的依赖形成了一个树状结构,而随着这个依赖的树的延伸和扩大,一系列问题就会随之产生
    2022-10-10
  • 使用mybatis的interceptor修改执行sql以及传入参数方式

    使用mybatis的interceptor修改执行sql以及传入参数方式

    这篇文章主要介绍了使用mybatis的interceptor修改执行sql以及传入参数方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-12-12
  • 老生常谈java中的fail-fast机制

    老生常谈java中的fail-fast机制

    下面小编就为大家带来一篇老生常谈java中的fail-fast机制。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-08-08
  • 为什么 Java 8 中不需要 StringBuilder 拼接字符串

    为什么 Java 8 中不需要 StringBuilder 拼接字符串

    java8中,编辑器对“+”进行了优化,默认使用StringBuilder进行拼接,所以不用显示的使用StringBuilder了,直接用“+”就可以了。下面我们来详细了解一下
    2019-05-05
  • 解析Mybatis判断表达式源码分析

    解析Mybatis判断表达式源码分析

    这篇文章主要介绍了Mybatis判断表达式源码分析,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-10-10

最新评论