tree: c5f35d7ad8d977b81570a4a4bb3f9b1b4a04601a
  1. src/
  2. Cargo.toml
  3. README.md
core/services/http/README.md

Apache OpenDALâ„¢ HTTP Service

opendal-service-http provides access to objects over HTTP and HTTPS for applications built with Apache OpenDALâ„¢.

Use through opendal

Applications should normally enable this service through the opendal facade with the services-http feature:

cargo add opendal --features services-http

The service is available as opendal::services::Http. Configure the service builder, then pass it to opendal::Operator::new.

Use with opendal-core

Add the split crates directly:

cargo add opendal-core opendal-service-http

Pass a configured service builder to Operator::new:

use opendal_core::{Operator, OperatorRegistry, Result};
use opendal_service_http::{register_http_service, Http};

fn build_operator(builder: Http) -> Result<Operator> {
    Operator::new(builder)
}

fn register_for_uri() {
    register_http_service(OperatorRegistry::get());
}

register_for_uri is only needed for scheme-driven construction through Operator::from_uri or Operator::via_iter.

Services that send HTTP requests also require an HTTP transport in OperationContext. See the opendal-core composition example.

Documentation

License

Licensed under the Apache License, Version 2.0.