Struct Http 

pub struct Http { /* private fields */ }

HTTP Read-only service support like Nginx and Caddy.

Capabilities

Depending on its configuration and the backing system, this service can expose:

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

Inspect the effective capability set with opendal_core::Operator::info and opendal_core::OperatorInfo::capability after building an operator.

Notes

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

Configuration

Use crate::HttpConfig for serializable configuration and this builder’s methods for direct construction. The field and method documentation defines accepted values, defaults, and environment interaction.

Example

Via Builder

use opendal_core::Operator;
use opendal_core::Result;
use opendal_service_http::Http;

#[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)?;
    Ok(())
}

Implementations

impl HttpBuilder

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

Set endpoint for http backend.

For example: https://example.com

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

set username for http backend

default: no username

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

set password for http backend

default: no password

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

set bearer token for http backend

default: no access token

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

Set root path of http backend.

Trait Implementations

impl Builder for HttpBuilder

type Config = HttpConfig

Associated configuration.

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

Consume the builder to build a service.

impl Debug for HttpBuilder

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

Formats the value using the given formatter.

impl Default for HttpBuilder

fn default() -> HttpBuilder

Returns the “default value” for a type.