Skip to main content

Crate opendal_layer_route

Crate opendal_layer_route 

Source
Expand description

§Apache OpenDAL™ Route Layer

opendal-layer-route routes operations to different operators by matching paths against glob patterns.

§Use through opendal

Applications should normally enable this layer through the opendal facade with the layers-route feature:

cargo add opendal --features layers-route

The layer is available as opendal::layers::RouteLayer and can be composed with an operator through opendal::Operator::layer.

§Use with opendal-core

Add the split crates directly:

cargo add opendal-core opendal-layer-route

Pass a configured layer to Operator::layer:

use opendal_core::Operator;
use opendal_layer_route::RouteLayer;

fn add_layer(operator: Operator, layer: RouteLayer) -> Operator {
    operator.layer(layer)
}

Construct and configure layer as described in the API documentation before composing it with an operator.

§Routing semantics

  • Routes are evaluated in the order they are added. The first matching glob wins.
  • Paths that match no route continue through the operator wrapped by the layer.
  • Copy and rename select a service from the source path. The layer does not transfer data between two routed services.
  • Batched deletes route each path independently.

§Documentation

§License

Licensed under the Apache License, Version 2.0.

Structs§

RouteLayer
RouteLayer routes operations to different operators by matching paths against glob patterns.
RouteLayerBuilder
Builder for RouteLayer.