作者：京东零售 姜波

前言

本文是早些年，Paas 化刚刚提出不久时，基于部门内第一次 Paas 化热部署落地经验所写，主要内容是如何构建一些热部署代码以及一些避雷经验。

一、设计-领域模型设计

1.首先，确定领域服务所属的领域

2.其次，确定垂直业务身份

## 3.再次，提炼领域能力及扩展点

【实际工作中，我们已经把下面这个图作为领域服务设计文档进行了留存，用 Paas 化的方式实现需求，代码分布在中台、各个前台，所以整体管理代码就需要以文档形式进行统一记录，不然随着时间流逝，开发人员就无法全盘管理代码了】

二、代码结构设计

1.中台-扩展点 jar

2.中台 - 领域服务、领域能力、水平实现

3.前台-由中台人员管理的前台包工程示例

4.前台-包内结构示例

5.前台-打包和部署的一些注意点

1.热部署 jar 包要打 fat jar；

2.前台包 jar 上线版本只能打 release 版本，而且要注意版本管理

3.matrix-ext.json 文件最好在前台中进行保留，实际热部署只需要在 cjg 部署时写明即可

4.biz-module.json 文件是前台包调用外部 jsf 接口的配置文件，最好在前台包中也保留一份，便于代码管理

5.前台包调用外部 jsf 接口时，中台需要在 cjg 我的应用增加对应接口的允许权限，不然调用会报错

6.前台包中完全使用水平实现，无前台个性化实现是，也需要写一个占位的假实现类，不然热部署会报找不到实现类而失败

7.matrix2-core 不要放到扩展点 jar 中，建议只放在中台应用中，不然会出现中台实际依赖到低版本 matrix.jar 的问题

三、部署流程

藏经阁 URL：http://cjg.jd.com/web

一、建应用：能力发布->我的应用->新增

二、中台应用发布：正常发布中台工程

三、创建水平业务身份：能力发布->我的水平业务身份->创建水平业务身份->审批

四、申请/创建垂直业务身份： https://cf.jd.com/pages/viewpage.action?pageId=274946163

五、垂直身份申请使用水平身份：能力集成->垂直业务身份->水平业务身份->申请使用-审批

六、需求能力拆解：能力集成->需求能力拆解->需求拆解

七、发布垂直业务包：能力集成->垂直业务身份->业务包->新增业务包/业务包详情->按流程走即可

四、踩坑和一些经验总结

1、水平业务身份抽取，先明确的抽取垂直，再从垂直的实现里抽取水平

2、前中台部署执行逻辑，未命中垂直身份，直接执行默认逻辑，命中垂直身份，根据 matrix-ext.json 执行

3、垂直业务包中未实现任何扩展点时，热部署无法发布，需要写一个默认占位实现

4、垂直业务包只能发布，没有下线功能

5、中台 – deployGroupName 可以搭配预发分组、线上分组进行使用，可以用来区分环境，也可以用来区分机房

6、前台 – 前台调用 JSF 接口时，仅支持“serialization”:“hessian”模式，使用时最好都显式加上

7、热部署中台分组中的一台机器，此时其他中台机器冷启动，则冷启动机器执行最新版本的垂直业务包

8、由于 matrix 框架的实现方式是将前台包加载到中台应用的 BizClassLoader 中，不同的垂直业务身份之间对于类的相同的全限定名是隔离的，但是与中台本身的 AppClassLoader 是共同工作的，所以如果垂直业务包中存在与中台包中类全限定名一致的代码，就会出现各种异常，例如：

【ClassCastException: com.jd.ofw.opi.ws.jsf.Result cannot be cast to com.jd.ofw.opi.ws.jsf.Result】

【IllegalArgumentException: object is not an instance of declaring class】

等等，解决方法也比较简单，只需要在中台的藏经阁配置文件的 exportClassConfig 中增加对应的包路径的排除配置，这样就屏蔽了所有前台包的重名类，就能正常执行了。