Biz-SIP金融级业务中台(http://bizsip.bizmda.com))是一套基于领域驱动设计(DDD),用于快速构建金融级云原生架构的服务整合中间件,包含了在金融场景里锤炼出来的最佳实践。
Biz-SIP业务中台在交易处理时,会先后涉及Source层、App层和Sink层的处理,其中,Source层的Source模块,对应于DDD架构中的适配层,主要是对接外部和系统内部其它系统的服务接入,主要功能有:
● 通讯协议的对接:服务接入模块(Source)负责外部调用方服务的通讯接入;
● 消息转换:把外部多种消息格式,转换成平台内部通用的JSON标准消息报文类型;
● 调用应用层的App服务进行服务编排。
对于外部服务接入,可以采用前面二节所提到的开放OpenAPI接口来接入,而本节介绍的,是个性化Source模块来对接外部个性化接口的接入:
具体代码和配置可以查看Biz-SIP源代码中的Sample相关测试案例(https://gitee.com/szhengye/biz-sip)
一、App服务和Sink服务的开发和配置
在上节的App服务调用Sink服务中,已经实现了Sink服务和App服务,不过是通过平台统一的开放OpenAPI接口来调用的:
$ curl -H "Content-Type:application/json" -H "Biz-Service-Id:/bean/sample2" -X POST --data '{"accountNo":"003"}' http://localhost:8888/api|jq
{
"code": 0,
"message": "success",
"extMessage": null,
"appServiceId": "/bean/sample2",
"traceId": "3cf20f08fe7f4d0d8c320ea14b61c98esh",
"parentTraceId": null,
"timestamp": 1646564189216,
"data": {
"message": "hello!",
"accountNo": "003"
}
}
二、个性化Source模块的开发
这里我们不用上面提到的OpenAPI接口来调用,而是另外写一个个性化的接口调用方式,为了简单起见,还是采用RESTful的接口。首先,我们需要编写一个RestController类来实现个性化接口:
@RestController
public class SampleSource1Controller {
private BizMessageInterface appServiceClient = SourceClientFactory
.getAppServiceClient(BizMessageInterface.class,"/bean/sample2");
@PostMapping(value = "/source1", consumes = "application/json", produces = "application/json")
public Object doService(@RequestBody String inMessage, HttpServletResponse response) throws BizException {
JSONObject jsonObject = JSONUtil.parseObj(inMessage);
return this.appServiceClient.call(jsonObject);
}
}
在SampleSource1Controller类中,通过appServiceClient句柄,调用了"/bean/sample2"这个App服务。
三、启动应用进行测试
启动SampleSourceApplication应用,以及SampleSinkApplication和SampleAppApplication应用,通过向“/source1”发起请求,就可以接收到响应,返回的报文内容增加了message域:
$ curl -H "Content-Type:application/json" -X POST --data '{"accountNo":"003"}' http://localhost:8080/source1|jq
{
"code": 0,
"message": "success",
"extMessage": null,
"appServiceId": "/bean/sample2",
"traceId": "c4d06665d3114668bddaca096ca6ebf9",
"parentTraceId": null,
"timestamp": 1646564895713,
"data": {
"message": "hello!",
"accountNo": "003"
}
}
Biz-SIP官方网站:http://bizsip.bizmda.com
Gitee:https://gitee.com/szhengye/biz-sip