对于发布的工具,遵循基本的版本规则,采用常用的三段式。即 主版本号(Major version).次版本号(Minor version).修订号(Revision number),如:1.2.3
*主版本号: 版本的主要变更,通常添加重大特性,或者代码重构(无法向下兼容),会增加主版本号,如从1.x升级到2.x.
*次版本号: 版本的次要变更,修复bug或增加小特性会增加次版本号,尽量向下兼容,如从2.1升级到2.2.
*修订号: 版本的微小变更,通常修复bug或优化功能会增加修订号,如从2.2.1升级到2.2.2.
基本工具类
网络框架,netty+mina
消息编解码,protobuf+struct
新增代码热更模块
新增线程模型接口ThreadModel及其实现DispatchThreadModel
新增消息处理器注册中心CommonMessageHandlerRegister
增加websocket简易实现
消息javabean支持继承关系,允许编解码父类字段
所有子模块取消对log4j的全局依赖,log层只绑定sl4j接口
TcpSocketServerBuilder的protocolEncoder改为单例模式,所有客户端共享
增加對jdk17及以上版本的支持
新增加策划配置数据读取工具,支持csv/excel格式,允许数据按id查询,按索引查询,支持数据热更新(此版本不推荐使用,直接升级到2.x)
修改私有协议栈格式,消息头增加一个index字段,保存客户端的消息序号。
删除Traceable接口,客户端回调id直接使用上面的消息序号。
注:消息序号不是每个项目都需要,在每个消息增加这样的字段,会导致每个消息多出4个字段的长度。一开始设计是拒绝的,但底层设计不应过于严格,应尽量宽容。
就像消息类型cmd字段,其实在很多项目里直接申明为short(3w+)也足够用。当然,int的长度允许业务为各种类型进行分段分类。还是那个词,宽容!
如果实在介意消息序号,或者消息长度,或者需要支持压缩,加密啥的,底层无法做到面面俱到,用户可以参考DefaultProtocolDecoder/DefaultProtocolEncoder,设计自己的私有协议。
至于RequestDataFrame的MessageHeader类,接口参数及返回值都是int类型,但编辑码层面仍可选择short等类型,节省网络流量。至于应用程序方面的内存消耗,这些消息属于“短命小对象”,对GC影响甚微。
websocket支持BinaryWebSocketFrame
升级mina-core版本: from 2.0.7 to 2.0.22, 去掉mina-http依赖
jforgame-data更名为jforgame-data-spring-boot-starter
修复DataManager注入失败bug
PTable重命名为DataTable,增加name()方法用于重命名文件
Container支持使用子类,用于存储二级缓存
消息处理器如果方法签名有返回值,则无须申明index字段
修复bug:WebSocketServer二进制流只支持json编解码
StructMessageCodec新增构造函数,用于设置编码最大字节长度
新增模块,用于对应用程序的线程、CPU、内存、gc等数据进行监控
修复读取excel文件,如果首列数据为空导致数据错乱问题
IdSession类增加sendAndClose方法,用于在主动关闭session前做一些清尾通知
WebSocketServerBuilder增加idleMilliSeconds参数,若XX时间没收到请求,则服务器主动断开session
引入eventbus;DateUtil新增若干方法
excel配置读取改用FileSystemResource;完善表格读取异常日志;增加导出export选项
websocket增加客户端工具
增加trie树结构,用于实现脏词检测
增加persist工具,用于实现对象异步持久化
增加MethodCaller工具,基于句柄高性能反射工具
新增随机工具RandomUtil, RandomWeightPool
增加websocket帧聚合器,处理大数据请求
消息处理器使用方法句柄代替传统反射,大幅提升性能
ResourceAutoConfiguration类dataConversionService组件增加ConditionalOnMissingBean注解,允许用户自定义
引入DataValidator数据完整性验证,目前包括主键及自定义验证规则
修复无法热更新类的bug
发布jforgame-orm工具,轻量级,专门为游戏服务器打造的orm工具,支持mysql, sqllite等关系型数据库
修复JavaDoctor#hotSwap()返回值有误
增加通用配置项,参考CommonData类,CommonConfig注解相关,通过注解直接引用策划配置项
org.apache.poi版本从4.1.1升到5.4.0, https://github.com/kingston-csj/jforgame/security/dependabot/34
新增DigestUtil,ZipUtil, TypeUtil几个工具类
LruHashMap优化; 修复QueueContainerGroup运行异常。
完善API文档
修复WebSocketClient.openSession()方法,确保返回的IdSession是可用的
mina版本从2.0.22升级到2.0.27, https://github.com/kingston-csj/jforgame/security/dependabot/33
修复QueueContainerGroup#name字段显示为空。
修复MessageTask构造函数初始化问题
RpcMessageClient增加future请求模式
TcpSocketClient增加构造函数
优化SqlFactory的sql语句
WebSocketServerBuilder增加maxProtocolBytes参数,用于设置最大协议字节数
修复ExcelDataReader,CsvDataReader配置读取规则不统一。
配置bean支持继承关系,子类可以继承父类的配置字段
新增util包,容纳所有工具类, Pair, Triple放到ds包下, FileUtils更名为FileUtil
Container#init()更名为afterLoad(), getRecordsBy()更名为getRecordsByIndex(), getRecord()更名为getRecordById()
移除SchemaUpdate冗余类
新增线程模型模块,包含两种实现:1.基于关键字分发模型;2.基于Actor模型
ServerNode迁移到server目录
WebSocketJsonFrame移到socket-api模块
ThreadModel相关接口迁移到threadmodel新模块
netty/mina 包路径去掉support层
MessageTask更名为ClientRequestTask,去掉dispatchKey字段
SocketIoDispatcher#dispatch()参数由RequestDataFrame变更为RequestContext,整合请求的所有上下文信息
调整ServerNode的类路径(API类路径变动!!)
WebSocketServer增加参数fameType参数,用于设置websocket帧类型
ThreadModel新增方法isShutdown(),用于判断线程池是否已关闭
DataRepository新增方法queryByUniqueIndex(), 用于根据唯一索引查询单个记录
Container#inject()方法增加主键检查
Container增加#validate(DataRepository dataRepository)方法,允许容器进行关联数据校验
FileUtil新增checkAndCreateDirectory()方法,用于检查并创建目录
修复linux+jdk17热更新失败
增加MapCodec,以支持字典字段
增加FieldIgnore注解,用于忽略字段序列化
修复NumberUtil#doubleValue()方法内部错误
增加schedule.parser包,用于解析游戏常用的自定义格式时间表达式
EventBus事件监听支持类继承关系,事件分发支持事件继承关系
修改MethodHandleUtils#createMethodCaller抛出的异常类型
新增Response类,作为客户端响应消息的基类
DataManager修复非小写表名读取失败问题
修改ForeignKeyValidator触发的提示内容
修复TableDefinition采用继承关系的类数据源索引重复验证异常
增加JsonDataReader,用于读取json数据源
修复Container读取的数据记录无序
增加拥有线程监控能力的增强版线程模型MonitoredDispatchThreadModel
jackson版本从2.16.1 升级到 2.18.6
StructMessageCodec增加集合元素类型异构模式
修复DelayContainer和QueueContainer并发修改bug
增加CronContainer基于cron表达式的持久化容器
修复LruHashMap#get()读写锁问题
DateUtil增加getDayDiffFromToday()来计算指定时间戳与今天相差的天数
ActorSystemConfig增加queueCapacity字段,用于配置线程池队列
ActorSystem优化accept()方法性能
内部增加一些运行期异常检测
SchemaStrategy#doExecute()改为由业务代码自行关闭连接库连接
修复 ThreadSampler对“JVM 内部线程”CPU统计不准的问题
修复DiskFileSystemVo#usage()磁盘空间为0时异常
新增日志系统,自动适配各种日志框架,为生产运营/监控提供日志服务
优化RpcMessageClient#request()内部逻辑
websocket服务器对wspath带参数进行容错
版本从2.0.27升至2.0.28
BeanProcessor#toBean和toBeanList方法内部自动执行BaseEntity#afterLoad()钩子
修复BeanProcessor#toBean()没有处理对象继承的属性
Container去掉#validate()无参方法
Container#validate(DataRepository dataRepository)签名增加DataValidator异常
jforgame-socket-api更名为jforgame-socket-core
新增加RequestScheduler抽象层
新增加RequestExecutionInterceptor, 为请求执行前后增加拦截器
删除ClientRequestMail和ClientRequestTask
代码目录结构调整
MessageExecuteUnit更名为MessageHandlerMethod
CallBackService#closeTimer()更名为shutdown()
StructMessageCodec更名为StructCodec
ProtobufMessageCodec更名为ProtobufCodec
修复CollectionCodec2编码空集合时异常
拆分为jforgame-data业务模块和jforgame-data-spring-boot-starter装配模块
jforgame-data-spring-boot-starter更名为jforgame-data-spring-boot-starter
ActorSystem移除actor时同步停用实例并清空邮箱
ActorSystem增加运行状态校验,系统关闭后拒绝新建actor和提交任务
ActorSystemConfig调整部署规则匹配策略,改为“精确匹配优先,其次最长前缀匹配”
ClassFileMeta读取类名移除对org.ow2.as依赖,改为直接解析字节码
去掉entity主键字段必须是基本类型包装类的限制
新增基于json的消息编解码工具
entity字段允许使用基本类型,不强迫使用包装类
补充JPA注解关于Table#indexes联合索引的语义
TrieDictionary改为线程安全
优化DelayContainer和QueueContainer持久化容器, 增加通用容器组PersistContainerGroup
PersistContainer增加死信机制
CommonData#key add @Index annotation
ResourceOptions add ignoreConfig attribute
ExcelDataReader对类型为公式的单元格,直接使用单元格缓存结果
netty版本从4.1.107.Final升级到4.1.125.Final,精简netty的依赖包
websocket服务器支持自适应帧类型,frameType为0代表自动根据客户端上行编码类型选择编码方式
修复 websocket 数据分片聚合 bug,废弃jforgame.socket.netty.server.WebSocketFrameAggregator
增加TableDataLoader抽象层,支持数据库作为配置数据源
MapCodec/MapCodec2 key支持除String以外的其他基本类型
DbService更名为EntityPersister
persist作为独立模块
MessageHandler更名为IoMessageFilter,messageReceived更名为filter,强调io层处理
ChainedMessageDispatcher#addMessageHandler更名为addIoMessageFilter
与threadmodel解耦,(DispatchThreadRequestScheduler,ActorRequestScheduler,RequestSchedulers,RequestActorSelector,SessionBindingActorSelector)等文件属于装配层
DefaultClientSocketIoHandler更名为CallbackHandler
DataReader更名为FileDataReader