Struct GrpcProxy 

pub struct GrpcProxy { /* private fields */ }

gRPC reverse proxy middleware.

Recognises requests with Content-Type: application/grpc* and forwards them to a backend over HTTP/2, leaving all other requests to the next layer.

Requires the http2 Cargo feature.

Example

use rust_web_server::app::App;
use rust_web_server::core::New;
use rust_web_server::proxy::GrpcProxy;

let app = App::new()
    .wrap(GrpcProxy::new(["grpc-service:50051"]));

Implementations

impl GrpcProxy

pub fn new<I, S>(backends: I) -> Self

where I: IntoIterator<Item = S>, S: AsRef<str>,

Create a proxy distributing gRPC connections across backends in round-robin order.

Each backend entry can be:

• "host:port" — plain TCP (gRPC cleartext)
• "grpc://host:port" — plain TCP (explicit scheme)
• "grpcs://host:port" — TLS (gRPC over TLS; port defaults to 443)
• "https://host:port" — TLS (same as grpcs://)

TLS backends require the http2 Cargo feature.

pub fn path_prefix(self, prefix: impl Into<String>) -> Self

Only proxy requests whose URI starts with prefix; pass others through.

Trait Implementations

impl Middleware for GrpcProxy

Available on crate feature http2 only.

fn handle( &self, request: &Request, connection: &ConnectionInfo, next: &dyn Application, ) -> Result<Response, String>