4 行代码接入 Spring —— ionet 的生态融合之道

"纯 JavaSE"不是限制，而是自由

ionet 是纯 JavaSE 实现的。这意味着它不强制绑定任何框架------不依赖 Spring，也不排斥 Spring。

这让 ionet 拥有了一种独特的定位：它可以与你已有的任何框架融合。

与 Spring 集成

Spring 是 Java 生态中最重要的框架，大多数团队的基础设施都建立在 Spring 之上。ionet 与 Spring 的集成非常简单------只需要在启动时将 Spring 的 ApplicationContext 注入即可。

集成后你可以：

在 Action 中使用 @Autowired 注入的 Spring Bean
使用 Spring 的事务管理
使用 Spring Data 访问数据库
使用 Spring 的 AOP、定时任务等所有能力

EventBus 与 Spring 的结合

如果你的订阅者类是由 Spring 管理的，可以从 ApplicationContext 中获取实例后注册到 EventBus：

java 复制代码

builder.addRunner((EventBusRunner) (eventBus, _) -> {
    // 从 Spring 容器中获取订阅者
    var subscriber = applicationContext.getBean(EmailEventBusSubscriber.class);
    eventBus.register(subscriber);
});

这样，你的事件订阅者就可以注入 Spring 的 Service、Repository 等 Bean 了。

不止 Spring

ionet 的生态融合能力不限于 Spring。因为它是纯 JavaSE 的，所以可以与任何框架共存：

框架	融合方式	获得的能力
Spring	ApplicationContext 注入	DI、AOP、事务、Spring Data
Vert.x	共存	响应式编程、事件循环
Quarkus	共存	原生编译、快速启动
Solon	共存	轻量级 DI

你可以把 ionet 看作一个"网络通信引擎"，它负责消息传输和业务路由，而 Spring/Vert.x/Quarkus 负责业务支撑（数据库、缓存、任务调度等）。

TCP / WebSocket / UDP ------ 一套代码

再次强调 ionet 的一个核心能力：一套业务代码，同时支持多种连接方式。

java 复制代码

@ActionController(1)
public class HallAction {
    @ActionMethod(0)
    private UserMessage login(LoginMessage message) {
        // 这段代码同时支持 TCP / WebSocket / UDP
        return new UserMessage("Hello");
    }
}

Godot/Unity 端游客户端 → TCP
React/Vue Web 客户端 → WebSocket
IoT 传感器设备 → UDP

同一个 Action，同时服务所有连接方式。未来支持 KCP、QUIC 时，代码也不需要改。

JDK25 + 分代 ZGC

ionet 最低要求 JDK25。这不仅是一个版本号，更是一个性能保障：

分代 ZGC 的红利

亚毫秒级暂停时间 → 游戏不卡顿
自动内存管理 → 不需要 JVM 调优专家
稳定的延迟表现 → P99 延迟可控

现代 Java 语法

JDK25 带来的语法改进（模式匹配、Record、密封类、虚拟线程等）让你的业务代码更简洁。配合 ionet 的 Action 模型，代码可读性极高。

小结

ionet 的生态策略是：做好网络通信这一件事，其他的交给专业的框架。

需要 ORM？接入 Spring Data
需要缓存？接入 Spring Cache / Redis
需要定时任务？接入 Spring Scheduler
需要响应式？接入 Vert.x

ionet 不与这些框架竞争，而是与它们互补。你获得了 ionet 的纳秒级网络通信能力，同时保留了原有框架的全部生态。

更多资源

📖 与 Spring 集成
📖 你的生态

下一篇预告：[从单体到分布式 ------ ionet 的部署方案与动态扩缩容]