Biz-SIP业务中台案例实战（10）——有分隔符格式转换器（velocity-split）

Biz-SIP金融级业务中台(http://bizsip.bizmda.com))是一套基于领域驱动设计（DDD）架构，能快速构建金融级云原生架构的服务整合中间件，整合了在金融场景里锤炼出来的最佳实践。

Biz-SIP业务中台支持多种报文类型的格式转换器，包括XML、JSON、定长、有分隔符、ISO-8583等报文类型的解包和打包，格式转换器可以在Source模块和Sink服务中进行配置和使用，实现打包（平台标准报文格式转换成外部报文格式）和解包（外部报文格式转换成平台标准报文格式）。
velocity-split类型的格式转换器，能把Biz-SIP内部标准消息报文，根据配置打包成外部的有分隔符格式报文；同时也直接把外部的有分隔符格式报文，解包成Biz-SIP内部标准消息报文。
本节案例中是在Sink服务模块中，配置velocity-split格式转换器，以实现有分隔符格式报文（velocity-split）的打包和解包：

其中，App层是通过Sink透传App服务，直接让调用方通过OpenAPI接口调用Sink服务（velocity-split-sink），Sink服务会把平台内部标准格式（JSONObject对象，内部即JSON报文）进行打包成有分隔符格式报文，传给通讯连接器Connector，原包返回后再解包成平台内部标准格式，响应给调用方。

具体代码和配置可以查看Biz-SIP源代码中的Sample相关测试案例（https://gitee.com/szhengye/biz-sip）

一、Sink层Sink服务的开发和配置

同样，在Biz-SIP配置目录的sink.yml中，配置对应的Sink服务：

- id: velocity-split-sink
  type: rest
  url: http://bizsip-sample-sink/sink7
  converter:
    type: velocity-split
    separators:
      - "*"
      - ","
    pack-rules:
      - predicate: '#{#data[sex]=="0"}'
        rule: velocity-split-sink/woman.vm
      - predicate: '#{#data[sex]=="1"}'
        rule: velocity-split-sink/man.vm
      - predicate:
        rule: velocity-split-sink/error.vm
  connector:
    type: service
    class-name: com.bizmda.bizsip.sample.sink.service.EchoConnectorService

可以看到velocity-split-sink这个Sink服务，connector关联了能把请求报文直接原包响应返回的EchoConnectorService类。而格式转换器converter，则直接设置“type: velocity-split”，表示采用有分隔符格式转换器，作为当前Sink服务的格式转换器。
Sink服务的converter项下配置了separators参数，说明在对有分隔符报文进行解包时，会首先用separators参数下的字符作为分隔符，对报文进行解包操作。pack-rules参数，表示会根据pack-rules断言规则，选择指定的打包规则配置文件，进行打包操作，上面配置中，是根据报文中的sex域值来决定的。
打包规则配置文件，配置内容如下：

velocity-split-sink/woman.vm：
${data.sex},${data.accountNo}*${data.accountName},${data.balance}

velocity-split-sink/man.vm：
${data.sex},${data.accountNo}*${data.accountName},${data.balance}

velocity-split-sink/error.vm：
${data.sex},${data.accountNo}*${data.accountName},${data.balance}

这个Sink服务没有设置processor属性，即为缺省default类型，采用默认的缺省Sink服务流程来处理的，处理步骤依次为：

1. 调用格式转换器converter对传入报文进行打包；
2. 对上步打包后的报文作为调用请求报文，调用通讯适配器connector进行处理，并收到并返回响应报文；
3. 调用格式转换器converter对响应报文进行解包，并返回解包后的报文。

最后，还需要在SampleSinkApplication的应用配置文件application-local.yml中，在bizsip.sink-id配置项中，增加fixed-length-sink以便启动Sink服务：

bizsip:
  config-path: /var/bizsip/config
  sink-id: hello-sink,echo-sink,simple-xml-sink,velocity-json-sink,velocity-xml-sink,fixed-length-sink,velocity-split-sink

二、App层App服务的开发和配置

对于Sink透传App服务，只需要在app.yml中配置即可：

- app-service-id: /sink/velocity-split-sink
  type: sink-service
  sink-id: velocity-split-sink

可以看到在app.yml中，配置了App服务“/sink/velocity-split-sink”，类型为Sink透传App服务（sink-service），透传调用的Sink服务为“velocity-split-sink”。

三、启动应用进行测试

启动SampleSinkApplication、SampleAppApplication应用，通过OpenAPI接口进行测试：

$ curl -H "Content-Type:application/json" -H "Biz-Service-Id:/sink/velocity-split-sink" -X POST --data '{"accountName": "王五","balance": 500,"accountNo":"005","sex":"0"}' http://localhost:8888/api|jq

{
  "code": 0,
  "message": "success",
  "extMessage": null,
  "appServiceId": "/sink/velocity-split-sink",
  "traceId": "81f3b80f4ff04668bc17d18f633199b7",
  "parentTraceId": null,
  "timestamp": 1647176027220,
  "data": {
    "array": [
      [
        "0",
        "005"
      ],
      [
        "王五",
        "500"
      ]
    ]
  }
}

EchoConnectorService打印日志：

收到报文:
====+ 01-02-03-04-05-06-07-08-09-10-11-12-13-14-15-16-17-18-19-20 + ====== ASCII  ====== +
0000: 30 2C 30 30 35 2A E7 8E 8B E4 BA 94 2C 35 30 30             | 0,005*王.五.,500.... |

Biz-SIP网站：http://bizsip.bizmda.com
Gitee代码库：https://gitee.com/szhengye/biz-sip