cn.xnatural.remoter

Class Remoter

java.lang.Object

cn.xnatural.aio.AioBase

cn.xnatural.remoter.Remoter

public class Remoter
extends cn.xnatural.aio.AioBase

基于 https:/gitee/xnat/enet 做的远程事件 集群分布式 核心类 多应用之间的连接器,简化跨系统调用 依赖 AioServer, AioClient

Field Summary

Fields

Modifier and Type	Field and Description
protected cn.xnatural.remoter.Lazier<Charset>	_charset 数据编码
protected cn.xnatural.remoter.Lazier<Boolean>	_master 是否为master true: 则向同为master的应用同步集群应用信息, false: 只向 masterHps 指向的服务同步集群应用信息
protected cn.xnatural.remoter.Lazier<String>	_masterHps 集群的服务中心地址 [host1]:port1,[host2]:port2.
protected cn.xnatural.aio.AioClient	aioClient tcp数据发送端
protected cn.xnatural.aio.AioServer	aioServer tcp数据接收端
protected String	appId 应用实例id
protected String	appName 应用名
protected Map<String,DataVersion>	dataVersionMap 集群数据版本管理
protected Map<String,cn.xnatural.enet.event.EC>	ecMap 远程事件临时持有 ecId -> EC
protected cn.xnatural.enet.event.EP	ep 事件中心 https://gitee.com/xnat/enet
protected static org.slf4j.Logger	log
protected Map<String,cn.xnatural.remoter.SafeList<cn.xnatural.remoter.Node>>	nodeMap 保存集群中的应用节点信息 name -> Node
protected cn.xnatural.sched.Sched	sched 定时任务 https://gitee.com/xnat/sched

Fields inherited from class cn.xnatural.aio.AioBase

attrs, exec

Constructor Summary

Constructors

Constructor and Description
Remoter(String appName, String appId, Map<String,Object> attrs) 创建 Remoter(String, String, Map, ExecutorService, EP, Sched)
Remoter(String appName, String appId, Map<String,Object> attrs, ExecutorService exec, cn.xnatural.enet.event.EP ep, cn.xnatural.sched.Sched sched) 创建 Remoter
Remoter(String appName, String appId, String hp, boolean isMaster)
Remoter(String appName, String appId, String hp, boolean isMaster, ExecutorService exec, cn.xnatural.enet.event.EP ep, cn.xnatural.sched.Sched sched)
Remoter(String appName, String appId, String hp, String masterHps)
Remoter(String appName, String appId, String hp, String masterHps, boolean isMaster)
Remoter(String appName, String appId, String hp, String masterHps, boolean isMaster, ExecutorService exec, cn.xnatural.enet.event.EP ep, cn.xnatural.sched.Sched sched)
Remoter(String appName, String appId, String hp, String masterHps, boolean isMaster, String delimiter)
Remoter(String appName, String appId, String hp, String masterHps, boolean isMaster, String delimiter, ExecutorService exec, cn.xnatural.enet.event.EP ep, cn.xnatural.sched.Sched sched) 创建一个 Remoter
Remoter(String appName, String appId, String hp, String masterHps, ExecutorService exec, cn.xnatural.enet.event.EP ep, cn.xnatural.sched.Sched sched)

Method Summary

Modifier and Type	Method and Description
protected void	appUp(Map data, cn.xnatural.aio.AioStream se) client -> master 接收集群应用的数据上传, 应用上线通知 NOTE: 此方法线程已安全 id 和 tcp 必须唯一
Remoter	autoHeartbeat() 开始自动心跳
DataVersion	dataVersion(String key) 获取数据集的数据版本集群同步器
protected void	doFire(cn.xnatural.enet.event.EC ec, String appName, String eName, List remoteMethodArgs) 调用远程事件 执行流程: 1.
Object	fire(String appName, String eName, List remoteMethodArgs) 同步远程事件调用
void	fireAsync(String appName, String eName, Consumer callback, List remoteMethodArgs) 异步远程事件调用
cn.xnatural.aio.AioClient	getAioClient() getter
cn.xnatural.aio.AioServer	getAioServer() getter
Map<String,Object>	getAppInfo() 应用自己的信息 例: {"id":"gy_GRLD5JhT4g", "name":"rc", "tcp":"192.168.2.104:8001", "http":"192.168.2.104:8000", "master": true}
cn.xnatural.enet.event.EP	getEp() 事件中心
boolean	isMaster() 是否为master
protected void	receiveDataVersion(String key, String dataKey, Long version, Object data) 接收远程远程应用的数据同步
protected void	receiveEventReq(com.alibaba.fastjson.JSONObject data, com.alibaba.fastjson.JSONObject source, cn.xnatural.aio.AioStream se) 接收远程事件的执行请求
protected void	receiveEventResp(com.alibaba.fastjson.JSONObject data) 接收远程事件返回的数据.
protected void	receiveMsg(String msg, cn.xnatural.aio.AioStream stream) 接收远程发送的消息
protected void	receiveReply(String reply, cn.xnatural.aio.AioStream se) 接收远程回响的消息
String	resolveHttp(String appName)
protected void	sendMsg(String appName, String msg, String target) 发送消息
Remoter	sendMsgToAll(String appName, String msg) 向不应用的所有实例发送消息
Remoter	sendMsgToAny(String appName, String msg) 向应用其中一个实例发送数据
void	stop() stop
void	sync() 集群应用同步函数
protected void	updateAppInfo(com.alibaba.fastjson.JSONObject data) master -> client 更新 app 信息

Methods inherited from class cn.xnatural.aio.AioBase

exec, getAttr, getBoolean, getInteger, getLong, getStr, indexOf, ipv4, setAttr

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

protected static final org.slf4j.Logger log

ep

protected cn.xnatural.enet.event.EP ep

事件中心 https://gitee.com/xnat/enet

sched

protected cn.xnatural.sched.Sched sched

定时任务 https://gitee.com/xnat/sched

appName

protected String appName

应用名

appId

protected String appId

应用实例id

nodeMap

protected final Map<String,cn.xnatural.remoter.SafeList<cn.xnatural.remoter.Node>> nodeMap

保存集群中的应用节点信息 name -> Node

ecMap

protected final Map<String,cn.xnatural.enet.event.EC> ecMap

远程事件临时持有 ecId -> EC

dataVersionMap

protected final Map<String,DataVersion> dataVersionMap

集群数据版本管理

aioClient

protected cn.xnatural.aio.AioClient aioClient

tcp数据发送端

aioServer

protected cn.xnatural.aio.AioServer aioServer

tcp数据接收端

_masterHps

protected final cn.xnatural.remoter.Lazier<String> _masterHps

集群的服务中心地址 [host1]:port1,[host2]:port2. 例 :8001 or localhost:8001

_master

protected final cn.xnatural.remoter.Lazier<Boolean> _master

是否为master true: 则向同为master的应用同步集群应用信息, false: 只向 masterHps 指向的服务同步集群应用信息

_charset

protected final cn.xnatural.remoter.Lazier<Charset> _charset

数据编码

Constructor Detail

Remoter

public Remoter(String appName,
               String appId,
               Map<String,Object> attrs,
               ExecutorService exec,
               cn.xnatural.enet.event.EP ep,
               cn.xnatural.sched.Sched sched)

创建 Remoter

Parameters:

appName - 当前应用名

appId - 当前应用实例id

attrs - 属性集

exec - 线程池

ep - 事件中心

sched - 定时任务调度

Remoter

public Remoter(String appName,
               String appId,
               Map<String,Object> attrs)

创建 Remoter(String, String, Map, ExecutorService, EP, Sched)

Parameters:

appName - 当前应用名

appId - 当前应用实例id

attrs - 属性集

Remoter

public Remoter(String appName,
               String appId,
               String hp,
               String masterHps,
               boolean isMaster,
               String delimiter,
               ExecutorService exec,
               cn.xnatural.enet.event.EP ep,
               cn.xnatural.sched.Sched sched)

创建一个 Remoter

Parameters:

appName - 应用名

appId - 应用实行id

hp - 本实例绑定的地址和端口, 用于定它实例调用 格式: host:port

masterHps - 中心应用的地址和端口 格式: host1:port1,host2:port2

isMaster - 当前实例是否为master

delimiter - TCP 粘包/拆包 分割符 默认: \n

exec - 执行线程池

ep - 事件中心, 包含所有暴露的事件方法

sched - 用于事件超时管理

Remoter

public Remoter(String appName,
               String appId,
               String hp,
               String masterHps,
               boolean isMaster,
               String delimiter)

Remoter

public Remoter(String appName,
               String appId,
               String hp,
               String masterHps,
               boolean isMaster,
               ExecutorService exec,
               cn.xnatural.enet.event.EP ep,
               cn.xnatural.sched.Sched sched)

Remoter

public Remoter(String appName,
               String appId,
               String hp,
               String masterHps,
               boolean isMaster)

Remoter

public Remoter(String appName,
               String appId,
               String hp,
               String masterHps,
               ExecutorService exec,
               cn.xnatural.enet.event.EP ep,
               cn.xnatural.sched.Sched sched)

Remoter

public Remoter(String appName,
               String appId,
               String hp,
               String masterHps)

Remoter

public Remoter(String appName,
               String appId,
               String hp,
               boolean isMaster,
               ExecutorService exec,
               cn.xnatural.enet.event.EP ep,
               cn.xnatural.sched.Sched sched)

Remoter

public Remoter(String appName,
               String appId,
               String hp,
               boolean isMaster)

Method Detail

stop

public void stop()

stop

fire

public Object fire(String appName,
                   String eName,
                   List remoteMethodArgs)

同步远程事件调用

Parameters:

appName - 应用名

eName - 远程应用中的事件名

remoteMethodArgs - 远程事件监听方法的参数

Returns:

事件执行结果值

fireAsync

public void fireAsync(String appName,
                      String eName,
                      Consumer callback,
                      List remoteMethodArgs)

异步远程事件调用

Parameters:

appName - 应用名

eName - 远程应用中的事件名

callback - 回调函数. 1. 正常结果, 2. Exception

remoteMethodArgs - 远程事件监听方法的参数

sendMsgToAny

public Remoter sendMsgToAny(String appName,
                            String msg)

向应用其中一个实例发送数据

Parameters:

appName - 应用名

msg - 消息

Returns:

Remoter

sendMsgToAll

public Remoter sendMsgToAll(String appName,
                            String msg)

向不应用的所有实例发送消息

Parameters:

appName - 应用名

msg - 消息

Returns:

Remoter

sendMsg

protected void sendMsg(String appName,
                       String msg,
                       String target)

发送消息

Parameters:

appName - 应用名

msg - 消息内容

target - 可用值: 'any', 'all'

dataVersion

public DataVersion dataVersion(String key)

获取数据集的数据版本集群同步器

Parameters:

key - 同步器的key

Returns:

DataVersion

receiveDataVersion

@EL(name="dataVersion")
protected void receiveDataVersion(String key,
                                                          String dataKey,
                                                          Long version,
                                                          Object data)

接收远程远程应用的数据同步

Parameters:

key - 同步Key

dataKey - 数据key

version - 数据版本

data - 数据

autoHeartbeat

public Remoter autoHeartbeat()

开始自动心跳

sync

public void sync()

集群应用同步函数

doFire

@EL(name="remote")
protected void doFire(cn.xnatural.enet.event.EC ec,
                                         String appName,
                                         String eName,
                                         List remoteMethodArgs)

调用远程事件 执行流程: 1. 客户端发送事件: doFire(EC, String, String, List) 2. 服务端接收到事件: receiveEventReq(JSONObject, JSONObject, AioStream) 3. 客户端接收到返回: receiveEventResp(com.alibaba.fastjson.JSONObject)

Parameters:

ec -

appName - 应用名

eName - 远程应用中的事件名

remoteMethodArgs - 远程事件监听方法的参数

receiveMsg

protected void receiveMsg(String msg,
                          cn.xnatural.aio.AioStream stream)

接收远程发送的消息

Parameters:

msg - 消息内容

stream - AioStream

receiveReply

protected void receiveReply(String reply,
                            cn.xnatural.aio.AioStream se)

接收远程回响的消息

Parameters:

reply - 回应消息

se - AioSession

receiveEventResp

protected void receiveEventResp(com.alibaba.fastjson.JSONObject data)

接收远程事件返回的数据. 和 doFire(EC, String, String, List) 对应

Parameters:

data -

receiveEventReq

protected void receiveEventReq(com.alibaba.fastjson.JSONObject data,
                               com.alibaba.fastjson.JSONObject source,
                               cn.xnatural.aio.AioStream se)

接收远程事件的执行请求

Parameters:

data - 数据

source - 来源

se - AioStream

appUp

protected void appUp(Map data,
                     cn.xnatural.aio.AioStream se)

client -> master 接收集群应用的数据上传, 应用上线通知 NOTE: 此方法线程已安全 id 和 tcp 必须唯一

Parameters:

data - 节点应用上传的数据 {"name": "应用名", "id": "应用实例id", "tcp":"host:port", "http":"host:port", "udp": "host:port"}

se - AioStream

updateAppInfo

@EL(name="updateAppInfo")
protected void updateAppInfo(com.alibaba.fastjson.JSONObject data)

master -> client 更新 app 信息

Parameters:

data - app node信息 例: {"name":"rc", "id":"rc_b70d18d52269451291ea6380325e2a84", "tcp":"192.168.56.1:8001","http":"localhost:8000"} 属性不为空: name, id, tcp

getAppInfo

public Map<String,Object> getAppInfo()

应用自己的信息 例: {"id":"gy_GRLD5JhT4g", "name":"rc", "tcp":"192.168.2.104:8001", "http":"192.168.2.104:8000", "master": true}

resolveHttp

@EL(name="resolveHttp")
public String resolveHttp(String appName)

getAioClient

public cn.xnatural.aio.AioClient getAioClient()

getter

Returns:

AioClient

getAioServer

public cn.xnatural.aio.AioServer getAioServer()

getter

Returns:

AioServer

getEp

public cn.xnatural.enet.event.EP getEp()

事件中心

Returns:

EP

isMaster

public boolean isMaster()

是否为master