Struct Realm 

pub struct Realm {
    pub id: u32,
    pub name: String,
    pub status: RealmStatus,
    pub enabled: bool,
    pub expires_at: Option<u64>,
    pub created_at: u64,
    pub updated_at: Option<u64>,
    pub secret_current: String,
    pub secret_previous: Option<(String, u64)>,
}

Realm 是用于分离不同应用程序资源的虚拟概念。

Fields

id: u32

DB 自增主键，起点 2^25 = 33554432

name: String

status: RealmStatus

enabled: bool

expires_at: Option<u64>

created_at: u64

updated_at: Option<u64>

secret_current: String

SHA256 hash of current secret (必填)

secret_previous: Option<(String, u64)>

(hash, valid_until) for previous secret during rotation grace window

Implementations

impl Realm

pub async fn create( name: String, secret_hash: String, ) -> Result<Self, RealmError>

Create a new realm in the database.

secret_hash is the SHA256 hash of the realm secret (must be non-empty). Returns the Realm with its auto-generated id.

pub async fn upsert_managed( id: u32, name: String, status: RealmStatus, enabled: bool, expires_at: Option<u64>, secret_current: String, secret_previous: Option<(String, u64)>, ) -> Result<Self, RealmError>

Upsert a superv-managed realm with an externally assigned id.

pub async fn save(&mut self) -> Result<(), RealmError>

Save (UPDATE) an existing realm to the database.

pub async fn get(id: u32) -> Result<Option<Self>, RealmError>

Get a realm by its auto-increment id.

pub async fn get_by_name(name: &str) -> Result<Option<Self>, RealmError>

Get a realm by name.

pub async fn get_all() -> Result<Vec<Self>, RealmError>

Get all realms.

pub async fn delete(id: u32) -> Result<u64, RealmError>

Delete a realm by id.

pub async fn soft_delete(id: u32) -> Result<bool, RealmError>

Disable a realm without physically removing it.

pub fn is_expired(&self) -> bool

pub fn is_active(&self) -> bool

impl Realm

Realm 验证相关实现

pub async fn validate_realm( realm_id: u32, ) -> Result<Realm, RealmValidationError>

验证 Realm 是否可用（存在、未过期、状态正常）

返回 Ok(Realm) 表示 Realm 可用 返回 Err(RealmValidationError) 表示 Realm 不可用或数据库错误

pub fn map_validation_error(err: RealmValidationError) -> (u32, String)

Map a RealmValidationError to the appropriate HTTP status code and a human-readable error string (for backward-compatible callers).

• RealmUnavailable → (403, reason)
• StoreError → (500, message)

Trait Implementations

impl Clone for Realm

fn clone(&self) -> Realm

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Realm

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

Formats the value using the given formatter.

impl Default for Realm

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Realm

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'r> FromRow<'r, SqliteRow> for Realm

fn from_row(row: &'r SqliteRow) -> Result<Self, Error>

impl Serialize for Realm

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

where __S: Serializer,

Serialize this value into the given Serde serializer.