你们好，我是飘渺Jam，一名来自三流城市三流公司的三流程序员，这是咱们的第161篇原创文章，若是你喜欢个人文章请点赞转发支持一下。 html
如今基于SpringCloud的微服务开发日益流行，网上各类开源项目层出不穷。咱们在实际工做中能够参考开源项目实现不少开箱即用的功能，可是必需要遵照必定的约定和规范。java
本文结合咱们实际的开发中遇到的一些问题整理出了一份微服务开发的实践规范，欢迎各位大佬拍砖指点。程序员
Maven规范
-
全部项目必需要有一个统一的parent模块api
全部微服务工程都依赖这个parent，parent用于管理依赖版本，maven仓库，jar版本的统一升级维护服务器
在parent下层能够有 core，starter，rate-limit 等自定义模块微信
-
core 核心包的做用：restful
-
以POJO形式约定各类开发规范；如BaseEntity，统一入参，返参架构
-
各类二方、三方组件开箱即用AutoConfig；并发
-
各类提升开发效率的帮助类等 XXXUtilapp
注意：core包全部依赖的scope必须是provided，避免传递依赖，同时配合Condition注解按条件加载Bean 如 @ConditionalOnClass(Ribbon.class)，@ConditionalOnBean(StringRedisTemplete.class)
-
starter模块
若是你每一个服务都须要依赖10几个starter，能够建一个统一的starter模块帮他们统一依赖进来，管理依赖集，简化依赖
-
rate-limit模块
用于放置非通用的自开发组件
-
正确区分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 同样, 确保用户体验被认真的考虑过是很重要的！
restful接口可使用如下两种格式：
-
/版本/访问控制/域对象
-
/版本/访问控制/域对象/动做
域对象须要遵循如下几条约束：
-
域对象 用名词而非动词
-
直接使用域对象名 使用/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
代码实现：
-
GET方式{version}能够是任意值，v1,v2都可，如：@GetMapping("/{version}/pb/user")
-
POST方法强制使用 V1 ,并标记为已废弃，可是仍可以使用
@Deprecated @PostMapping("/v1/pb/user")
-
POST {version}应是当前版本，只能是v2
@PostMapping("/{version}/pb/user")
网关
-
能够不承担微服务鉴权功能，由本身服务实现（简单服务能够直接在网关层鉴权）
网关鉴权与微服务鉴权的差别在我其余文章中有详细说明，可参考此文：微服务网关受权VS微服务受权 -
须要实现访问控制权限，结合上文的Restful规范，屏蔽
/pv/**等特殊请求 -
须要实现灰度发布功能
开发联调的时候须要将服务器流量导入到本地，结合nacos的元数据与请求头可实现服务实例的筛选。参考此文实现： SpringCloud 实现网关的灰度发布
这里为你们准备了一份小小的礼物，关注公众号，输入以下代码，便可得到百度网盘地址，无套路领取！
001：《程序员必读书籍》
002：《从无到有搭建中小型互联网公司后台服务架构与运维架构》
003：《互联网企业高并发解决方案》
004：《互联网架构教学视频》
006：《SpringBoot实现点餐系统》
007：《SpringSecurity实战视频》
008：《Hadoop实战教学视频》
009：《腾讯2019Techo开发者大会PPT》
010： 微信交流群
本文分享自微信公众号 - JAVA日知录（javadaily）。
若有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一块儿分享。