ioGame 适用于网络游戏服务器、物联网、内部系统及各种需要长连接的场景；

优化 FlowContext createRequestMessage

#194

可能在 springboot 集成 light-domain-event 时，启动报 java.lang.ClassNotFoundException

#198

HeadMetadata 增加 customData 属性；用于自定义数据，专为开发者预留的一个字段，开发者可以利用该字段来传递自定义数据。该字段由开发者自己定义，框架不会对数据做任何处理，也不会做任何检查，开发者可以利用该字段来传递任何数据，包括自定义对象。

模拟客户端

因发展需要，模拟客户端使用新 api ，与 SDK 风格做统一。从 17.1.58 版本开始，推荐开发者使用新版本的 api。已经将老的 api 做了过期标记，将在 ioGame21 版本中完全移除这些过期的 api。整体变化不大，内容如下

请求 api

变更说明

 ########## 请求 - 旧版本 ########## // 创建一个模拟命令 - 【125-3】读取某个玩家的私有消息 ofCommandUserId(ChatCmd.readPrivateMessage).callback(ByteValueList.class, result -> { List<ChatMessage> list = result.toList(ChatMessage.class); if (CollKit.isEmpty(list)) { return; } log.info("玩家【{}】读取私聊消息数量 : {}", userId, list.size()); System.out.println("------------------------------"); list.stream().map(ClientChatKit::toString).forEach(System.out::println); System.out.println("------------------------------"); }).setDescription("读取某个玩家的私有消息"); ########## 请求 - 新版本 ########## // 创建一个模拟命令 - 【125-3】读取某个玩家的私有消息 ofCommandUserId(ChatCmd.readPrivateMessage).setTitle("读取某个玩家的私有消息").callback(result -> { List<ChatMessage> list = result.listValue(ChatMessage.class); if (CollKit.isEmpty(list)) { return; } log.info("玩家【{}】读取私聊消息数量 : {}", userId, list.size()); System.out.println("------------------------------"); list.stream().map(ClientChatKit::toString).forEach(System.out::println); System.out.println("------------------------------"); });

 ########## 请求 - 旧版本 ########## HelloReq helloReq = new HelloReq(); helloReq.name = "abc12"; ofCommand(DemoCmd.here).callback(HelloReq.class, result -> { HelloReq value = result.getValue(); log.info("value : {}", value); }).setDescription("here").setRequestData(helloReq); ########## 请求 - 新版本 ########## ofCommand(DemoCmd.here).setTitle("here").setRequestData(() -> { HelloReq helloReq = new HelloReq(); helloReq.name = "abc12"; return helloReq; }).callback(result -> { HelloReq value = result.getValue(HelloReq.class); log.info("value : {}", value); });

广播 api

变更说明

 ########## 广播 - 旧版本 ########## // 广播监听回调 - 监听【125-11】玩家私聊消息通知 listenBroadcast(ChatNotifyMessage.class, result -> { ChatNotifyMessage chatNotifyMessage = result.getValue(); // 聊天消息发送方的 userId long senderId = chatNotifyMessage.senderId; log.info("玩家[{}]给我的私聊通知", senderId); }, ChatCmd.notifyPrivate, "玩家私聊消息通知"); ########## 广播 - 新版本 ########## // 广播监听回调 - 监听【125-11】玩家私聊消息通知 ofListen(result -> { ChatNotifyMessage chatNotifyMessage = result.getValue(ChatNotifyMessage.class); // 聊天消息发送方的 userId long senderId = chatNotifyMessage.senderId; log.info("玩家[{}]给我的私聊通知", senderId); }, ChatCmd.notifyPrivate, "玩家私聊消息通知");

其他更新

<netty.version>4.1.100.Final</netty.version>
<lombok.version>1.18.30</lombok.version>

ioGame 使用趋势数据统计

关注 ioGame 的游戏服务器开发者持续增多，2022-09 ~ 2023-08 月统计数据；

这里的统计信息是关于开发者关注 ioGame 框架相关的，从统计数据中可以看出，由于 ioGame 上手简单，功能强大等优点，得到了众多开发者的关注。如果你想知道 ioGame 有没有人在使用，可以先到这里看下统计数据、开发者的评价与讨论。

https://www.yuque.com/iohao/game/gpxk93#TwVa8

这里展示了每月的统计数据，统计数据来源于语雀后台，这些数据都是真实的、客观存在的、活的。

因为成本的原因，某宝某多还没有出现能提供这种服务的商家，所以这样的统计数据也更具真实性。

通过统计数据，我们可以看到每天会有很多开发者在访问 ioGame 的在线文档，并且这些统计数据不是来源于口嗨的，也不是主观创造的。

所以，还在犹豫要不要使用 ioGame 的开发者们，更应该讨论的是 “为什么这些开发者会选择使用 ioGame”，而不是 ioGame 有没有人在使用的问题。

点击我，到语雀后台查看 ioGame 的数据

maven pom

 <dependency> <groupId>com.iohao.game</groupId> <artifactId>run-one-netty</artifactId> <version>${ioGame.version}</version> </dependency>

ioGame 是一个 java 网络游戏服务器框架，有以下特点：

• 无锁异步化、事件驱动的架构设计
• 支持 websocket 和 socket 两种通信协议
• 支持 protobuf、json 等不同的通信协议
• 集群无中心节点、集群自动化、分布式的设计
• 真轻量级，不依赖任何第三方中间件或数据库就能支持集群、分布式
• 提供多种通讯方式，且逻辑服之间可以相互跨机器通信
• 与 spring 和其他框架融合方便
• 学习成本低，开发体验好
• 支持多服单进程、多服多进程的启动和部署方式
• 提供游戏文档生成的辅助功能
• 包体小、启动快、内存占用少
• 提供优雅的路由访问权限控
• 提供了灵活的线程扩展与设置
• 智能的同进程亲和性

• 网络通信框架：职责是各服务器之间的网络通信
• 业务框架：职责是业务逻辑的处理方式和编写方式

网络通信框架 

SOFABolt 是蚂蚁金融服务集团开发的一套基于 Netty 实现的网络通信框架。

• 为了让 Java 程序员能将更多的精力放在基于网络通信的业务逻辑实现上，而不是过多的纠结于网络底层 NIO 的实现以及处理难以调试的网络问题，Netty 应运而生。
• 为了让中间件开发者能将更多的精力放在产品功能特性实现上，而不是重复地一遍遍制造通信框架的轮子，SOFABolt 应运而生。

Bolt 名字取自迪士尼动画 - 闪电狗，是一个基于 Netty 最佳实践的轻量、易用、高性能、易扩展的通信框架。

业务框架

如果说 sofa-bolt 是为了让 Java 程序员能将更多的精力放在基于网络通信的业务逻辑实现上。而业务框架正是解决业务逻辑如何方便实现这一问题上。业务框架是游戏框架的一部分，职责是简化程序员的业务逻辑实现，业务框架使程序员能够快速的开始编写游戏业务。

业务框架对于每个 action （即业务的处理方法） 都是通过 asm 与 Singleton、Flyweight 、Command 等设计模式结合，对 action 的获取上通过 array 来得到，是一种近原生的方式。

架构简图

 /** 请求 */ @ProtobufClass @FieldDefaults(level = AccessLevel.PUBLIC) public class HelloReq { String name; }

 @ActionController(1) public class DemoAction { @ActionMethod(0) public HelloReq here(HelloReq helloReq) { HelloReq newHelloReq = new HelloReq(); newHelloReq.name = helloReq.name + ", I'm here "; return newHelloReq; } }

 ┏━━━━━ Debug. [(DemoAction.java:4).here] ━━━ [cmd:1 - subCmd:0 - cmdMerge:65536] ┣ userId : 888 ┣ 参数: helloReq : HelloReq(name=塔姆) ┣ 响应: HelloReq(name=塔姆, I'm here ) ┣ 时间: 0 ms (业务方法总耗时) ┗━━━━━ Debug [DemoAction.java] ━━━ [当前线程:RequestMessage-8-1] 

 Debug. [(DemoAction.java:4).here]： 表示执行业务的是 DemoAction 类下的 here 方法，4 表示业务方法所在的代码行数。 在工具中点击控制台的 DemoAction.java:4 这条信息，就可以跳转到对应的代码中（快速导航到对应的代码），这是一个开发良好体验的开始！ userId : 当前发起请求的 用户 id。 参数 : 通常是游戏前端传入的值。 响应： 通常是业务方法返回的值 ，业务框架会把这个返回值推送到游戏前端。 时间： 执行业务方法总耗时，我们可根据业务方法总耗时的时长来优化业务。 路由信息：[cmd - subCmd] 路由是唯一的访问地址。