Struct RUser 

pub struct RUser {
    pub id: String,
    pub token: String,
}

Represents an authenticated user.

RUser is the key to r-token’s “parameter-as-authentication” pattern. By implementing actix-web’s FromRequest trait, it enables automatic authentication validation before your handler is called.

How It Works

When you declare RUser as a handler parameter:

1. actix-web extracts the token from the Authorization header
2. Validates the token using RTokenManager
3. If valid: creates an RUser instance and calls your handler
4. If invalid: returns 401 Unauthorized without calling your handler

Type Safety Guarantee

If your handler receives an RUser parameter, the user is guaranteed to be authenticated. No manual validation needed!

Example

use actix_web::{get, HttpResponse};
use r_token::RUser;

#[get("/profile")]
async fn profile(user: RUser) -> impl actix_web::Responder {
    // If we reach here, authentication succeeded
    HttpResponse::Ok().body(format!("User ID: {}", user.id))
}

Error Responses

• 401 Unauthorized: Token missing, invalid, or expired
• 500 Internal Server Error: RTokenManager not registered in app_data

Fields

id: String

The user’s unique identifier.

This corresponds to the ID passed to RTokenManager::login().

token: String

The authentication token.

Extracted from the Authorization request header.

Trait Implementations

impl Debug for RUser

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

Formats the value using the given formatter.

impl FromRequest for RUser

Implementation of actix-web’s FromRequest trait for automatic authentication.

This implementation enables the “parameter-as-authentication” pattern.

Validation Flow

When actix-web processes a request with an RUser parameter:

1. Retrieve Manager: Extracts RTokenManager from app_data
2. Extract Token: Reads the Authorization header (supports Bearer prefix)
3. Validate Token: Checks if the token exists in the manager’s storage
4. Return Result:
   • Success: Creates RUser and calls the handler
   • Failure: Returns error response without calling the handler

Error Responses

• 500 Internal Server Error: RTokenManager not found in app_data or mutex poisoned
• 401 Unauthorized: Token missing or invalid

type Error = Error

The associated error which can be returned.

type Future = Ready<Result<RUser, <RUser as FromRequest>::Error>>

Future that resolves to a Self.

fn from_request(req: &HttpRequest, _payload: &mut Payload) -> Self::Future

Create a Self from request parts asynchronously.

fn extract(req: &HttpRequest) -> Self::Future

Create a Self from request head asynchronously.