客户端（Client）示例
客户端初始化参数：
#------------------------------------- # 服务模块--客户端初始化参数 #------------------------------------- # 客户端配置列表，多个客户端名称间用'|'分隔，默认为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);
}
}