package com.walker.tcp;
|
|
public interface Connection {
|
|
/**
|
* 通道ID，这个是java系统连接通道提供的全局唯一<code>ChannelId</code>
|
* @return
|
*/
|
String getId();
|
|
/**
|
* 连接名称，这个也是系统唯一的，通常由业务定义或者绑定。如：卡号、设备终端IMEI等
|
* @return
|
*/
|
String getName();
|
|
void setName(String name);
|
|
long getCreateTimeMills();
|
|
boolean supportLongConnection();
|
|
/**
|
* 如果是长连接模式，返回该连接是否被业务认证。如果未认证就无法使用
|
* @return
|
*/
|
boolean isAuthenticated();
|
|
/**
|
* 当前是否空闲
|
* @return
|
*/
|
boolean isIdle();
|
|
Request<?> read();
|
|
void write(Response<?> response);
|
|
/**
|
* 服务端强制断开连接
|
*/
|
void disconnect();
|
|
/**
|
* 获得该连接对应的引擎ID，通常一个项目中可能存在多种服务，每个服务对应一个服务引擎。</p>
|
* 如：一个TCP监听1010端口，另外一个服务监听2020端口等。</p>
|
* 如果系统只有一个监听服务，默认engineId = 0
|
* @return
|
*/
|
int getEngineId();
|
|
/**
|
* 返回连接最后一次活动时间
|
* @return
|
*/
|
long getLastTime();
|
|
/**
|
* 连接绑定业务标识，如：设备ID等</p>
|
* 绑定后，连接就被认证，后续可以使用了
|
*/
|
void bindName(String name);
|
|
/**
|
* 长连接，判断是否连接状态
|
* @return
|
*/
|
boolean isConnected() ;
|
|
ProtocolResolver getProtocolResolver();
|
|
/**
|
* 设置报文解析器对象。对于一个连接会关联一个解析器以方便在request和response中使用
|
* @param resolver
|
*/
|
void setProtocolResolver(ProtocolResolver resolver);
|
|
/**
|
* 获取该连接对象绑定的主机信息，在集群环境中，需要标记连接对应主机。
|
* <p>目前在聊天模块中，多主机部署通过消息方式推送，主机信息是队列的一部分，通过对方连接的主机知道消息如何被路由接收。</p>
|
* @return
|
* @date 2023-09-19
|
*/
|
String getConnectionHost();
|
|
void setConnectionHost(String connectionHost);
|
|
int getAlreadyLogin();
|
}
|
