pub struct ServerReflectionClient<T> { /* private fields */ }client only.Expand description
Generated client for querying a grpc.reflection.v1.ServerReflection
server.
Client for this service.
Generic over T: ClientTransport. For gRPC (HTTP/2), use
Http2Connection — it has honest poll_ready and composes with
tower::balance for multi-connection load balancing. For Connect
over HTTP/1.1 (or unknown protocol), use HttpClient.
§Example (gRPC / HTTP/2)
use connectrpc::client::{Http2Connection, ClientConfig};
use connectrpc::Protocol;
let uri: http::Uri = "http://localhost:8080".parse()?;
let conn = Http2Connection::connect_plaintext(uri.clone()).await?.shared(1024);
let config = ClientConfig::new(uri).with_protocol(Protocol::Grpc);
let client = ServerReflectionClient::new(conn, config);
let response = client.server_reflection_info(request).await?;§Example (Connect / HTTP/1.1 or ALPN)
use connectrpc::client::{HttpClient, ClientConfig};
let http = HttpClient::plaintext(); // cleartext http:// only
let config = ClientConfig::new("http://localhost:8080".parse()?);
let client = ServerReflectionClient::new(http, config);
let response = client.server_reflection_info(request).await?;§Working with the response
Unary calls return UnaryResponse<OwnedView<FooView>>.
view() borrows the response
message, so field access is zero-copy:
let resp = client.server_reflection_info(request).await?;
let name: &str = resp.view().name; // borrow into the response bufferIf you need the owned struct (e.g. to store or pass by value), use
into_owned():
let owned = client.server_reflection_info(request).await?.into_owned();into_view() keeps the
zero-copy decoded body (an OwnedView) without copying; field access on it
goes through .reborrow(). Streaming responses yield one OwnedView per
received message from .message().await — bind msg.reborrow() for field
access, or convert with .to_owned_message().
Implementations§
Source§impl<T> ServerReflectionClient<T>
impl<T> ServerReflectionClient<T>
Sourcepub fn new(transport: T, config: ClientConfig) -> Self
pub fn new(transport: T, config: ClientConfig) -> Self
Create a new client with the given transport and configuration.
Sourcepub fn config(&self) -> &ClientConfig
pub fn config(&self) -> &ClientConfig
Get the client configuration.
Sourcepub fn config_mut(&mut self) -> &mut ClientConfig
pub fn config_mut(&mut self) -> &mut ClientConfig
Get a mutable reference to the client configuration.
Sourcepub async fn server_reflection_info(
&self,
) -> Result<BidiStream<T::ResponseBody, ServerReflectionRequest, ServerReflectionResponseView<'static>>, ConnectError>
pub async fn server_reflection_info( &self, ) -> Result<BidiStream<T::ResponseBody, ServerReflectionRequest, ServerReflectionResponseView<'static>>, ConnectError>
Call the ServerReflectionInfo RPC. Sends a request to /grpc.reflection.v1.ServerReflection/ServerReflectionInfo.
Sourcepub async fn server_reflection_info_with_options(
&self,
options: CallOptions,
) -> Result<BidiStream<T::ResponseBody, ServerReflectionRequest, ServerReflectionResponseView<'static>>, ConnectError>
pub async fn server_reflection_info_with_options( &self, options: CallOptions, ) -> Result<BidiStream<T::ResponseBody, ServerReflectionRequest, ServerReflectionResponseView<'static>>, ConnectError>
Call the ServerReflectionInfo RPC with explicit per-call options. Options override ClientConfig defaults.
Trait Implementations§
Source§impl<T: Clone> Clone for ServerReflectionClient<T>
impl<T: Clone> Clone for ServerReflectionClient<T>
Source§fn clone(&self) -> ServerReflectionClient<T>
fn clone(&self) -> ServerReflectionClient<T>
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more