Struct SaSession 

pub struct SaSession {
    pub id: String,
    pub create_time: DateTime<Utc>,
    pub terminal_list: Vec<SaTerminalInfo>,
    pub history_terminal_count: i32,
    pub data: HashMap<String, Value>,
}

Session 对象 | Session Object

用于存储用户会话数据的对象 Object for storing user session data

字段说明 | Field Description

• id: Session 唯一标识 | Session unique identifier
• create_time: 创建时间 | Creation time
• data: 存储的键值对数据 | Stored key-value data

使用示例 | Usage Example

let mut session = SaSession::new("session_123");
session.set("username", "张三")?;
session.set("age", 25)?;
 
let username: Option<String> = session.get("username");
println!("Username: {:?}", username);

Fields

id: String

Session ID

create_time: DateTime<Utc>

创建时间 | Creation time

terminal_list: Vec<SaTerminalInfo>

已登录设备终端列表（对齐 Java SaSession.terminalList）

history_terminal_count: i32

历史累计登录设备数，仅增不减，用于生成终端 index（对齐 Java historyTerminalCount）

data: HashMap<String, Value>

数据存储 | Data storage

Implementations

impl SaSession

pub fn new(id: impl Into<String>) -> Self

pub fn set<T: Serialize>( &mut self, key: impl Into<String>, value: T, ) -> Result<(), Error>

设置值 | Set Value

参数 | Parameters

• key: 键名 | Key name
• value: 要存储的值 | Value to store

返回 | Returns

• Ok(()): 设置成功 | Set successfully
• Err: 序列化失败 | Serialization failed

pub fn get<T: for<'de> Deserialize<'de>>(&self, key: &str) -> Option<T>

获取值 | Get Value

参数 | Parameters

• key: 键名 | Key name

返回 | Returns

• Some(value): 找到值并成功反序列化 | Found value and deserialized successfully
• None: 键不存在或反序列化失败 | Key not found or deserialization failed

pub fn remove(&mut self, key: &str) -> Option<Value>

删除值 | Remove Value

参数 | Parameters

• key: 键名 | Key name

返回 | Returns

被删除的值，如果键不存在则返回 None Removed value, or None if key doesn’t exist

pub fn clear(&mut self)

清空 session | Clear Session

删除所有存储的数据 | Remove all stored data

pub fn has(&self, key: &str) -> bool

检查 key 是否存在 | Check if Key Exists

参数 | Parameters

• key: 键名 | Key name

返回 | Returns

• true: 键存在 | Key exists
• false: 键不存在 | Key doesn’t exist

pub fn add_terminal(&mut self, terminal: SaTerminalInfo)

新增一个终端：自动分配 index = history_terminal_count + 1，并累加历史计数

pub fn remove_terminal(&mut self, token_value: &str) -> Option<SaTerminalInfo>

按 token 移除终端；返回被移除的终端（不存在则 None）

pub fn get_terminal(&self, token_value: &str) -> Option<&SaTerminalInfo>

按 token 获取终端引用

pub fn terminal_list_copy(&self) -> Vec<SaTerminalInfo>

终端列表副本

pub fn get_terminal_list_by_device_type( &self, device_type: Option<&str>, ) -> Vec<SaTerminalInfo>

按设备类型筛选终端；device_type 传 None 表示不限设备类型

pub fn get_token_value_list_by_device_type( &self, device_type: Option<&str>, ) -> Vec<String>

按设备类型提取 token 列表

pub fn terminal_count(&self) -> usize

终端数量

Trait Implementations

impl Clone for SaSession

fn clone(&self) -> SaSession

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SaSession

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SaSession

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SaSession

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.