Skip to content

Latest commit

 

History

History
188 lines (142 loc) · 7.36 KB

README_CN.md

File metadata and controls

188 lines (142 loc) · 7.36 KB
Raw

简体中文 | English

Ⅰ. zfoo简介🚩

  • 极致性能，天生异步，Actor设计思想，无锁化设计，全场景RPC框架，native GraalVM支持
  • 高可拓展性，单台服务器部署，微服务部署，注册中心加集群部署，网关加集群部署，随意搭配
  • 上能做游戏服务器框架，下能做应用网站服务器框架
  • zfoo protocol 协议原生支持 C++ Rust Java/Kotlin/Scala JavaScript/TypeScript/ES C# Go Php Ruby Lua GDScript Python Dart Swift

完善的工作开发流程，完整的线上解决方案

  • 普通java项目，spring项目，分布式项目，容器项目， 不停机完美热更新代码 hotswap
  • Excel json csv配置自动映射和解析，在线不停机热更新Excel配置 storage
  • MongoDB的自动映射框架 orm
  • 事件总线 event
  • 时间任务调度 scheduler
  • 内置在程序里的轻量级cpu，内存，硬盘，网络监控， 无需代码和额外工具，解放运维生产力 monitor

Ⅱ. 背景和适用项目

  • 性能需求极高的项目，如网站和游戏服务器框架，单服滚服，全球服，直播聊天，IM系统，实时推送
  • 节省研发成本的项目，如想节省，开发，部署，运维成本
  • 适合作为 Godot，Unity，Cocos，Webgl，H5 的后端基础框架，网络通信协议支持 tcp udp websocket http
  • 喜欢 KISS法则 的项目 ，简单的配置，优雅的代码

Ⅲ. Maven依赖✨

  • 环境要求JDK 17+，支持OpenJDK, Oracle JDK, native GraalVM
<dependency>
    <groupId>com.zfoo</groupId>
    <artifactId>boot</artifactId>
    <version>4.0.0</version>
</dependency>
  • 如果不想引入全部的zfoo模块，只需要选择依赖其中一个模块
<dependency>
    <groupId>com.zfoo</groupId>
    <artifactId>protocol</artifactId>
    <version>4.0.0</version>
</dependency>

Ⅳ. 详细的教程和完整的工程案例

Ⅴ. 使用⭐

1. protocol 极致性能的Java序列化和反序列化库

// zfoo协议注册，只能初始化一次
// 注意：实际项目中是通过读取protocol.xml文件自动完成协议注册的，无需调用此方法手动注册
ProtocolManager.initProtocol(Set.of(ComplexObject.class, ObjectA.class, ObjectB.class));

// 序列化
ProtocolManager.write(byteBuf, complexObject);

// 反序列化
var packet = ProtocolManager.read(byteBuf);

2. net 极致性能的RPC框架，支持 tcp udp websocket http

// 服务提供者，只需要在方法上加个注解，则自动注册接口
@PacketReceiver
public void atUserInfoAsk(Session session, UserInfoAsk ask) {
}

// 消费者，同步请求远程用户信息，会阻塞当前的线程，慎重考虑使用同步请求
var userInfoAsk = UserInfoAsk.valueOf(userId);
var answer = NetContext.getCosumer().syncAsk(userInfoAsk, UserInfoAnswer.class, userId).packet();

// 消费者，异步请求远程用户信息，不会柱塞当前的线程，异步请求成功过后依然会在当前线程执行逻辑
NetContext.getCosumer()
                    .asyncAsk(userInfoAsk, UserInfoAnswer.class, userId)
                    .whenComplete(sm -> {
                        // do something
                    );

3. hotswap 热更新代码，不需要停止服务器，不需要额外的任何配置，一行代码开启热更新

// 传入需要更新的class文件
HotSwapUtils.hotswapClass(bytes);

4. orm 基于mongodb的自动映射框架

// 无需自己写sql和任何配置，直接通过注解定义在数据库中定义一张表
@EntityCache
public class UserEntity implements IEntity<Long> {
    @Id
    private long id;
    private String name;
}

// 更新数据库的数据
entityCaches.update(userEntity);

5. event 事件总线解耦不同模块，提高代码的质量，核心思想是观察者设计模式

// 接收一个事件，只需要在需要接收事件的方法上加一个注解就会自动监听这个事件
@EventReceiver
public void onMyNoticeEvent(MyNoticeEvent event) {
    // do something
}

// 抛出一个事件
EventBus.post(MyNoticeEvent.valueOf("我的事件"));

6. scheduler 基于cron表达式的定时任务调度框架

@Scheduler(cron = "0/1 * * * * ?")
public void cronSchedulerPerSecond() {
    // do something
}

7. storage Excel类自动映射框架，只需要定义一个和Excel对应的类，直接解析Excel

@Storage
public class StudentResource {
    @Id
    private int id;
    @Index
    private String name;
    private int age;
}

Ⅵ. 提交规范👏

  • 欢迎喜欢这个项目的人来一起维护这个项目，提交代码的时候注意下面规范
  • 项目格式化代码的方式采用IntelliJ Idea默认的格式化
  • 优先使用英文提交注释和文档，拒绝内卷从走出去开始，在idea中安装Translation插件轻松翻译
  • 代码提交的说明(commit message) 按照下面给出的些常用格式
feat[module]: 新增某一项功能
perf[module]: 优化了模块代码或者优化了什么功能
fix[module]: 修改了什么bug
test[module]: 测试了什么东西
del[module]: 删除了某些功能或者无用代码
ref[module]: 重命名或者重构了模块
doc[module]: 增加了什么文档

Ⅶ. License

zfoo使用 Apache License Version 2.0

JetBrains Logo (Main) logo