flare_core/server/builder/mod.rs
1//! 服务端构建器模块
2//!
3//! 提供统一的三种构建模式，从简单到复杂，满足不同场景需求：
4//!
5//! ## 三种模式
6//!
7//! 1. **简单模式（ServerBuilder）** - 使用闭包定义消息处理逻辑，最小实现，适合快速原型开发
8//! 2. **观察者模式（ObserverServerBuilder）** - 使用 `ServerEventHandler` trait，基本功能实现
9//! 3. **Flare 模式（FlareServerBuilder）** - 使用 `ServerEventHandler` trait，完整功能实现，推荐用于生产环境
10//!
11//! ## 架构设计原则
12//!
13//! - **公共逻辑统一处理**：所有模式共享底层实现（`HybridServer`），避免代码重复
14//! - **渐进式增强**：从简单到复杂，按需选择，无需为兼容性保留冗余代码
15//! - **类型安全**：充分利用 Rust 类型系统，编译期保证正确性
16//! - **零成本抽象**：高级抽象不带来运行时开销
17//!
18//! 所有构建器都基于 `HybridServer`，提供统一的 `ServerHandle` 访问接口
19
20pub mod base;
21pub mod common;
22pub mod flare;
23pub mod observer;
24pub mod simple;
25
26// 重新导出基类和通用组件
27pub use base::BaseServerBuilderConfig;
28pub use common::ServerWrapper;
29
30// 重新导出观察者模式
31pub use observer::{ObserverServer, ObserverServerBuilder};
32
33// 重新导出简单模式
34pub use simple::{MessageContext, ServerBuilder, SimpleServer};
35
36// 重新导出 Flare 服务端构建器
37pub use flare::{FlareServer, FlareServerBuilder};