客户端(Client)示例

2018-12-24 22:34 更新

客户端初始化参数:

#-------------------------------------
# 服务模块--客户端初始化参数
#-------------------------------------

# 客户端配置列表,多个客户端名称间用'|'分隔,默认为default
ymp.configs.serv.client.name_list=default

# 服务名称, 默认为default
ymp.configs.serv.client.default.name=default

# 远程主机IP地址, 默认为0.0.0.0
ymp.configs.serv.client.default.host=0.0.0.0

# 远程主机端口号, 默认为8281
ymp.configs.serv.client.default.port=8281

# 编解码字符集, 默认为UTF-8
ymp.configs.serv.client.default.charset=UTF-8

# 缓冲区大小, 默认为4096
ymp.configs.serv.client.default.buffer_size=4096

# 执行线程池大小, 默认为10
ymp.configs.serv.client.default.executor_count=10

# 连接超时时间(秒), 默认为30
ymp.configs.serv.client.default.connection_timeout=30

# 心跳发送时间间隔(秒), 默认为60
ymp.configs.serv.client.default.heartbeat_interval=60

# 自定义参数, 可选
ymp.configs.serv.client.default.params.xxx=xxx

通过在监听器实现类声明@Client注解来表示一个客户端,该注解有如下参数:

事件说明
name设置客户端名称,Serv框架将会根据该参数指定的名称加载对应的客户端参数配置,默认为default;
codec设置编解码器,默认为NioStringCodec;
implClass客户端实现类,默认为NioClient;
reconnectClass短线重连服务实现类,默认为NONE;
hearbeatClass链路维护(心跳)服务实现类,默认为NONE;

基于TCP协议的客户端,需要继承NioClientListener监听器类,支持监听如下事件:

事件说明
onSessionConnected客户端成功接入服务端后触发该事件;
onBeforeSessionClosed客户端会话被关闭之前触发该事件;
onAfterSessionClosed客户端会话被关闭之后触发该事件;
onMessageReceived收到服务端发送的消息时触发该事件;
onExceptionCaught出现异常时触发该事件;

基于UDP协议的客户端,需要继承NioUdpListener监听器类,支持监听如下事件:

事件说明
onSessionReady客户端与服务端连接已建立并准备就绪时触发该事件;
onMessageReceived收到服务端发送的消息时触发该事件;
onExceptionCaught出现异常时触发该事件;
示例代码
TCP客户端
@Client(reconnectClass = DefaultReconnectService.class,
        hearbeatClass = DefaultHeartbeatService.class, codec = TextLineCodec.class)
public class TcpClient extends NioClientListener {

    @Override
    public void onSessionConnected(INioSession session) throws IOException {
        super.onSessionConnected(session);
        //
        session.send("Hello from client.");
    }

    @Override
    public void onMessageReceived(Object message, INioSession session) throws IOException {
        super.onMessageReceived(message, session);
        //
        System.out.println(session + "--->" + message);
    }

    @Override
    public void onExceptionCaught(Throwable e, INioSession session) throws IOException {
        System.out.println(session + "--->" + e.getMessage(), e);
    }
}
UDP客户端
@Client(implClass = NioUdpClient.class, codec = TextLineCodec.class)
public class UdpClient extends NioUdpListener {

    public Object onSessionReady() throws IOException {
        return "Hello from client.";
    }

    public Object onMessageReceived(InetSocketAddress sourceAddr, Object message) throws IOException {
        System.out.println(sourceAddr + "--->" + message);
        return null;
    }

    public void onExceptionCaught(InetSocketAddress sourceAddr, Throwable e) throws IOException {
        System.out.println(sourceAddr + "--->" + e);
    }
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号