surmux 0.2.0

极简 SurrealDB WebSocket 客户端 — 单连接 JSON-RPC 多路复用, 极简依赖
Documentation
//! 连接池: 多个独立 WS 连接, round-robin 分发.
//!
//! 适用于高并发场景 (>1000 并发请求), 提供比单连接更高的吞吐量.
//!
//! # 使用示例
//!
//! ```rust,ignore
//! let pool = SurrealPool::connect(config, 4).await?;
//! let client = pool.client();  // round-robin
//! client.query("SELECT ...").all().await?;
//! ```

use std::sync::Arc;
use std::sync::atomic::AtomicUsize;
use std::sync::atomic::Ordering;

use crate::client::SurrealClient;
use crate::config::SurrealConfig;
use crate::error::SurrealResult;

/// 连接池: N 个独立 WS 连接, round-robin 分发.
///
/// 每个连接有独立的 WS 连接和 Router 后台任务,
/// 因此多连接可以并行处理更多请求.
#[derive(Clone)]
pub struct SurrealPool {
    clients: Arc<Vec<SurrealClient>>,
    next: Arc<AtomicUsize>,
}

impl SurrealPool {
    /// 创建包含 `size` 个连接的池.
    ///
    /// 每个连接独立认证和复用.
    pub async fn connect(config: &SurrealConfig, size: usize) -> SurrealResult<Self> {
        assert!(size > 0, "连接池大小必须 > 0");

        let mut clients = Vec::with_capacity(size);
        for _ in 0..size {
            // 每个连接使用独立配置副本
            let client = SurrealClient::connect(config.clone()).await?;
            clients.push(client);
        }

        Ok(Self {
            clients: Arc::new(clients),
            next: Arc::new(AtomicUsize::new(0)),
        })
    }

    /// Round-robin 获取一个客户端.
    pub fn client(&self) -> &SurrealClient {
        let idx = self.next.fetch_add(1, Ordering::Relaxed) % self.clients.len();
        &self.clients[idx]
    }

    /// 返回连接数.
    pub fn size(&self) -> usize {
        self.clients.len()
    }
}