Struct actix_web_lab::extract::ThinData

pub struct ThinData<T>(pub T);

Application data wrapper and extractor for cheaply-cloned types.

Similar to Actix Web’s Data wrapper but for Clone types that are already an Arc internally or shares state using some other means when cloned.

Unlike Data, this wrapper clones T during extraction. Therefore, it is the user’s responsibility to ensure that clones of T do actually share the same state, otherwise state may be unexpectedly different across multiple requests.

Note that if your type is an Arc<T> then it’s recommended to use Actix Web’s Data::from(arc) conversion instead.

Examples

use actix_web_lab::extract::ThinData;
use actix_web::{App, Responder, HttpResponse, web};

// Use the `ThinData<T>` extractor to access a database connection pool.
async fn index(ThinData(db_pool): ThinData<DbPool>) -> impl Responder {
    // database action ...

    HttpResponse::Ok()
}

let db_pool = DbPool::default();

App::new()
    .app_data(ThinData(db_pool.clone()))
    .service(web::resource("/").get(index))

Tuple Fields

0: T

Trait Implementations

impl<T> AsMut<T> for ThinData<T>

fn as_mut(&mut self) -> &mut T

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T> AsRef<T> for ThinData<T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: Clone> Clone for ThinData<T>

fn clone(&self) -> ThinData<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for ThinData<T>

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

Formats the value using the given formatter.

impl<T> Deref for ThinData<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> DerefMut for ThinData<T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T: Clone + 'static> FromRequest for ThinData<T>

type Error = Error

The associated error which can be returned.

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

Future that resolves to a Self.

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

Create a Self from request parts asynchronously.

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

Create a Self from request head asynchronously.