Struct Http 

pub struct Http { /* private fields */ }

HTTP Read-only service support like Nginx and Caddy.

Capabilities

This service can be used to:

• stat
• read
• write
• create_dir
• delete
• copy
• rename
• list
• presign
• blocking

Notes

Only read and stat are supported. We can use this service to visit any HTTP Server like nginx, caddy.

Configuration

• endpoint: set the endpoint for http
• root: Set the work directory for backend

You can refer to HttpBuilder’s docs for more information

Example

Via Builder

use anyhow::Result;
use opendal::services::Http;
use opendal::Operator;

#[tokio::main]
async fn main() -> Result<()> {
    // create http backend builder
    let mut builder = Http::default().endpoint("127.0.0.1");

    let op: Operator = Operator::new(builder)?.finish();
    Ok(())
}

Implementations

impl HttpBuilder

pub fn endpoint(self, endpoint: &str) -> Self

Available on crate feature services-http only.

Set endpoint for http backend.

For example: https://example.com

pub fn username(self, username: &str) -> Self

Available on crate feature services-http only.

set username for http backend

default: no username

pub fn password(self, password: &str) -> Self

Available on crate feature services-http only.

set password for http backend

default: no password

pub fn token(self, token: &str) -> Self

Available on crate feature services-http only.

set bearer token for http backend

default: no access token

pub fn root(self, root: &str) -> Self

Available on crate feature services-http only.

Set root path of http backend.

pub fn http_client(self, client: HttpClient) -> Self

👎Deprecated since 0.53.0: Use Operator::update_http_client instead

Available on crate feature services-http only.

Specify the http client that used by this service.

Notes

This API is part of OpenDAL’s Raw API. HttpClient could be changed during minor updates.

Trait Implementations

impl Builder for HttpBuilder

Available on crate feature services-http only.

type Config = HttpConfig

Associated configuration for this builder.

fn build(self) -> Result<impl Access>

Consume the accessor builder to build a service.

impl Debug for HttpBuilder

Available on crate feature services-http only.

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

Formats the value using the given formatter.

impl Default for HttpBuilder

Available on crate feature services-http only.

fn default() -> HttpBuilder

Returns the “default value” for a type.