Databus Clients

概述

Databus Clients主要负责以下几个工作：

• 通过Databus Relays restful 服务，检查新的数据变化事件，并处理业务逻辑(如同步数据、保存入缓存服务等)；
• 如果与relays的连接断开时间太长(SCN号差别大)，会向bootstrap server发送一个查询请求；
• 新的客户端向bootstrap server查询之后，切换到relays获取最近的数据变化事件；
• 客户端可以单独的部署处理所有的databus relays事件，也可以主从部署，每个消费端只消费一部分事件；

技术架构

• Relay Connection：从relay端实时的获取数据变化事件；
• Bootstrap Connection：从Bootstrap Server获取回溯的数据；
• Dispatcher：读取数据变化事件并分发事件；
• Consumer Code Callbacks：分发回调，一般Client端需要实现这个接口进行业务处理；
• Checkpoint persistence：持久化Checkpoint。

Configure-client配置

目前已经对于Clients做了简单的封装，一般性的数据同步只需要修改配置即可；

1. 配置conf/db.properties

   db.properties

   jdbc.driverClassName=oracle.jdbc.driver.OracleDriver
   jdbc.url=jdbc:oracle:thin:databus/databus @10 .10. 111.5 : 1521 :testafc
   jdbc.username=databus
   jdbc.password=databus
   jdbc.pool.min.size= 1
   jdbc.pool.max.size= 3

2. 配置conf/client.properties

   client.properties

   databus.client.connectionDefaults.pullerRetries.initSleep= 1
   databus.client.checkpointPersistence.fileSystem.rootDirectory=./client-checkpoints
   databus.client.checkpointPersistence.clearBeforeUse= false
   databus.client.connectionDefaults.enablePullerMessageQueueLogging= false
   databus.client.container.jmx.rmiEnabled= false
   databus.client.container.httpPort= 9001
   databus.client.runtime.relay( 1 ).host=localhost(relay IP)
   databus.client.runtime.relay( 1 ).port= 11115
   databus.client.runtime.relay( 1 ).sources=com.lefu.boss.UNION_PAY_BCN_32_CONFIG

   注意修改 Databus Relays数据抓取端的IP；sources的名字和relay的sources.name必须一致，如果包含多个用逗号隔开即可。

3. 配置conf/configure.xml

   xml  version = "1.0"  encoding = "UTF-8" ?>
   < configure >
       < source  name = "com.lefu.boss.UNION_PAY_BCN_32_CONFIG"  id = "117"
           table = "posp_trans.UNION_PAY_BCN_32_CONFIG"  db = "oracle" >
           < fields >
               < field  name = "ID"  alias = "key"  primaryKey = "true"  type = "long"  />
               < field  name = "OPTIMISTIC"  type = "long"  />
               < field  name = "BANK_CUSTOMER_NO"  />
               < field  name = "STATUS"  />
               < field  name = "LEFU_ORG_CODE"  />
               < field  name = "CUSTOMER_NAME"  />
           fields >
       source >
   configure >

   注意：

   每个表对应一个source

   id必须与relay中sources.id一致

   name必须与relay中sources.name一致

   table：表名(根据数据库选择是否添加用户名)

   db：必须指明是oracle还是mysql

   fileds.name：字段名称

   fields.alias：别名(源字段)，默认与name相同

   fields.primarykey：是否组件(默认为false)

   fields.type：字段类型

4. 启动client

   startup.sh

   ./bin/startup.sh

   
   

至此，对于Databus Clients的配置就配置完成了！