Struct ConnectionHandle 

pub struct ConnectionHandle {
    pub id: String,
    pub created_at: SystemTime,
    pub last_used: SystemTime,
    pub health_score: f64,
    pub error_count: usize,
}

Handle representing an active connection

This structure tracks the state and health of an individual connection in the connection pool.

Health Scoring

The health score ranges from 0.0 to 100.0:

• 100.0: Perfect health
• 75.0-99.9: Good health
• 50.0-74.9: Degraded health
• 0.0-49.9: Poor health

Health is updated based on operation success/failure:

• Success: +10 points (max 100)
• Failure: -25 points (min 0)

Example Usage

let mut handle = ConnectionHandle::new();

// Update health based on operation success
handle.update_health(true); // Success
handle.update_health(false); // Failure

// Check if connection is healthy
if handle.is_healthy() {
    // Use the connection
}

Fields

id: String

Unique connection identifier (UUID)

created_at: SystemTime

When the connection was created (as SystemTime for serialization)

last_used: SystemTime

When the connection was last used (as SystemTime for serialization)

health_score: f64

Health score (0.0 to 100.0)

error_count: usize

Number of consecutive errors

Implementations

impl ConnectionHandle

pub fn new() -> Self

Create a new connection handle with health monitoring

pub fn update_health(&mut self, success: bool)

Update health score based on operation success

Parameters

• success: Whether the operation succeeded

Behavior

• Success: +10 points (capped at 100), reset error count
• Failure: -25 points (floored at 0), increment error count

pub fn is_healthy(&self) -> bool

Check if connection is healthy

A connection is considered healthy if:

• Health score > 50.0
• Error count < 5

Returns

• true: Connection is healthy
• false: Connection is unhealthy

pub fn age_seconds(&self) -> u64

Get connection age in seconds

pub fn idle_seconds(&self) -> u64

Get time since last use in seconds

pub fn status(&self) -> ConnectionStatus

Get connection status

pub fn touch(&mut self)

Manually update the last used time

pub fn reset_health(&mut self)

Reset health score to perfect

Trait Implementations

impl Clone for ConnectionHandle

fn clone(&self) -> ConnectionHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectionHandle

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConnectionHandle

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ConnectionHandle

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

where __S: Serializer,

Serialize this value into the given Serde serializer.