第一部分:代码规范
1. 注释
如果是定制,一定要描述 “为谁定制”
2. 规范从开发框架(framework)开始:
>维护应用名称常量(或其他替代方案)
>不管是 feign 还是普通的 http 调用,在请求头中加上应用服务 name、目标服务 name(以及其他你想要制定的协议字段)
>提供本地调用的路由插件
>提供获取 HttpServletRequest 的工具类
3. 基础字段统一:
一定不能出现歧义,例如 tenantId 和 contextTenantId,两者保留其一就好,按团队(或架构师)的规范来
4. A little copying is better than a little dependency
5. 接口上、方法参数禁止传入 HttpServletRequest 、 HttpServletResponse ,如果需要可以通过工具类获取
第二部分:培训
以上代码规范制定后要培训到位,可以以分享的形式开展,确保每一个到场的人都get到重点,重点是:最好不要占用大家周末的时间。
培训也要做好分批次的准备:第一次可以集体,第二次补第一次的缺,第三次是长久支持,做 framework 的要有服务意识。
第三部分:验收
此处验收是指所有业务线都按规范执行,并且已确认投入生产正常运行,验收分两个阶段:弱势阶段和强势阶段。
假定一个阈值为 N,在 N% 的业务线都已经反馈接入成功前是弱势阶段,超过N 后,开始由弱转强,但是得有一个前提是 frameowrk 必需要有实质性解决某问题的成分。强势不代表态度表情的强势,强势在于价值体现的强势。
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)