文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

SpringCloud 微服务最佳开发实践

2024-04-02 19:55

关注

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

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

Maven规范

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

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

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

2.core 核心包的作用:

注意: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. /版本/访问控制/域对象/动作

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

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

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 微服务内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯