Struct HttpClientLayer 

pub struct HttpClientLayer { /* private fields */ }

Layer for replacing the default HTTP client with a custom one.

This layer allows users to provide their own HTTP client implementation by implementing the HttpFetch trait. This is useful when you need to customize HTTP behavior, add authentication, use a different HTTP client library, or apply custom middleware.

Examples

use opendal_core::layers::HttpClientLayer;
use opendal_core::services;
use opendal_core::Operator;
use opendal_core::Result;
use opendal_core::raw::HttpClient;

// Create a custom HTTP client
let custom_client = HttpClient::new()?;

let op = Operator::new(services::Memory::default())?
    .layer(HttpClientLayer::new(custom_client))
    .finish();

Custom HTTP Client Implementation

use opendal_core::raw::{HttpFetch, HttpBody};
use opendal_core::Buffer;
use http::{Request, Response};
use opendal_core::Result;

struct CustomHttpClient {
    // Your custom HTTP client fields
}

impl HttpFetch for CustomHttpClient {
    async fn fetch(&self, req: Request<Buffer>) -> Result<Response<HttpBody>> {
        // Your custom HTTP client implementation
        todo!()
    }
}

Implementations

impl HttpClientLayer

pub fn new(client: HttpClient) -> Self

Create a new HttpClientLayer with the given HTTP client.

Arguments

• client - The HTTP client to use for all HTTP requests

Examples

use opendal_core::layers::HttpClientLayer;
use opendal_core::raw::HttpClient;
use opendal_core::Result;

let client = HttpClient::new()?;
let layer = HttpClientLayer::new(client);

Trait Implementations

impl Clone for HttpClientLayer

fn clone(&self) -> HttpClientLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A: Access> Layer<A> for HttpClientLayer

type LayeredAccess = HttpClientAccessor<A>

The layered accessor that returned by this layer.

fn layer(&self, inner: A) -> Self::LayeredAccess

Intercept the operations on the underlying storage.