参考索引
这里有 Zeze 全部主题的 API 级参考文档。写代码时查具体接口、配置、属性表——按主题找入口。如果想系统学习,请先读 Manual 指南。
定义数据、写事务、读写存储的基石。
| 文档 | 说明 |
|---|---|
| solution.xml 参考 | 完整 XML 语法:solution/module/bean/variable/table/rpc/protocol/project/service 全部标签与属性 |
| Bean 数据模型 | 类型系统、variable id 规则、托管状态、DynamicBean、版本兼容 |
| 事务系统 | Procedure、TransactionLevel、嵌套存储过程、whileCommit、返回值、@DispatchMode |
| Table 存储接口 | CRUD、selectDirty、walk 遍历、TableCache、本地 RocksDB 缓存 |
| 序列化协议 | 二进制 TLV 编码、4-bit 类型、Tag、varint、跨语言一致 |
| ChangeListener | Table 级数据变更监听,同步数据给客户端 |
| 事务中操作外部系统 | whileCommit/幂等/事务队列,安全调度外部副作用 |
| 配置参考 | 完整 XML 配置:zeze/DatabaseConf/TableConf/ServiceConf |
分布式服务的组成与协作。
| 文档 | 说明 |
|---|---|
| Provider-Linkd 架构 | Linkd/Provider/ServiceManager/ProviderDirect 角色与交互全貌 |
| Online 在线管理 | 登录登出、可靠消息、Transmit 跨服转发、Broadcast |
| Redirect 跨服调用 | @RedirectHash / @RedirectAll / @RedirectToServer 三种模式 |
| 网络层 | Service/Protocol/Rpc、连接管理、握手加密、WebSocket |
| Session 与 UserState | 会话信息在连接/协议/事务间的传递 |
| GlobalCacheManager | 缓存同步协议:Modify/Share/Invalid 权限模型 |
| ServiceManager | 服务注册与发现 |
| 全球同服 | 单点模块的并发分组、ConcurrentLevel、大量共享模块优化 |
存储后端的选择与配置。
| 文档 | 说明 |
|---|---|
| 数据库抽象层总览 | Database/Storage、DatabaseType 枚举、选择决策表 |
| 关系型(MySQL/PostgreSQL) | JDBC、KV 模式 vs 关系映射、Druid 连接池 |
| NoSQL(MongoDB/Redis/TiKV) | 各 NoSQL 配置与选型 |
| RocksDB | 嵌入式引擎、单机限制、本地缓存层 |
| Dbh2 | Zeze 自研分布式数据库,分桶与 Raft |
开箱即用的框架组件。
| 文档 | 说明 |
|---|---|
| Timer 定时器 | Auto/Named/Online/Offline 四类调度、Cron 表达式 |
| AutoKey | 分布式唯一自增 ID |
| DelayRemove | 延迟删除,配合并发遍历 |
| Raft | 共识实现,GCM/ServiceManager 的高可用基础 |
基于 Table 的高层数据结构。
| 文档 | 说明 |
|---|---|
| 集合总览 | 统一初始化、BeanFactory、与 Table 的关系 |
| Queue | FIFO 队列 / LIFO 栈、CsQueue 跨服务器 |
| LinkedMap | 有序双向链表映射,背包/排行榜 |
| CHashMap | 一致性哈希并发 Map |
| DepartmentTree | 部门树,组织架构/权限 |
| BoolList | 位图列表,标记位 |
| DAG | 有向无环图,依赖管理 |
游戏服务端开箱即用系统。
| 文档 | 说明 |
|---|---|
| 游戏模块总览 | ProviderWithOnline 启动入口 |
| Bag 背包 | 物品增删移、自动堆叠拆分 |
| Rank 排行榜 | 并发分区、RedirectHash、多路归并 |
| LoginQueue 登录队列 | 登录排队与过载保护 |
| Task 任务系统 | 基于持久化队列的任务模型 |
跨语言客户端库。
| 文档 | 说明 |
|---|---|
| C# / Unity | solution.xml 生成 C# 代码、Unity 接入 |
| C++ | zezecxx 静态库、ByteBuffer、Net、Protocol |
| TypeScript | Zeze/zeze.ts 序列化、浏览器/Node.js 接入 |
运行期与运维话题。
| 文档 | 说明 |
|---|---|
| 热更新 | ClassReloader/HotModule/HotService,不停服更新 |
| 线程模型 | 线程池分类、Checkpoint 线程、调度 |
| 性能调优 | 缓存命中率、Checkpoint 策略、benchmark |
| Prometheus 监控 | 指标暴露、Dashboard |
| 消息队列 | 内置 MQ、RocketMQ、RedoQueue 跨系统重试 |