Struct ServiceDescriptor

pub struct ServiceDescriptor { /* private fields */ }

A protobuf service definition.

Implementations

impl ServiceDescriptor

pub fn new(pool: DescriptorPool, index: usize) -> ServiceDescriptor

Create a new ServiceDescriptor referencing the service at index within the given DescriptorPool.

Panics

Panics if index is out-of-bounds.

pub fn index(&self) -> usize

Returns the index of this ServiceDescriptor within the parent DescriptorPool.

pub fn parent_pool(&self) -> &DescriptorPool

Gets a reference to the DescriptorPool this service is defined in.

pub fn parent_file(&self) -> FileDescriptor

Gets the FileDescriptor this service is defined in.

pub fn name(&self) -> &str

Gets the short name of the service, e.g. MyService.

pub fn full_name(&self) -> &str

Gets the full name of the service, e.g. my.package.Service.

Examples found in repository

examples/reflection.rs (line 17)

async fn main() -> Result<()> {
    let request = ReflectionRequest::new("http://localhost:50051");
    let desc = ProtoDescriptor::from_reflection(request).await?;
    let service = &desc.get_services()[0];
    let method = &desc.get_methods(service)[1];
    println!("Service: {:}", service.full_name());
    println!("Method:  {:}", method.full_name());
    //
    let mut req = desc.get_request(&method);
    req.set_address("http://localhost:50051");

    let mut req = desc.get_request(&method);
    req.set_address("http://localhost:50051");

    Ok(())
}

examples/metadata.rs (line 18)

async fn main() -> Result<()> {
    let desc = ProtoDescriptor::new(
        vec!["/Users/philippreiter/Rust/wireman/example"],
        vec!["grpc_simple/debugger.proto"],
    )?;
    let service = &desc.get_services()[0];
    let method = &desc.get_methods(service)[1];
    println!("Service: {:}", service.full_name());
    println!("Method:  {:}", method.full_name());

    let mut req = desc.get_request(&method);
    req.set_address("http://localhost:50051");

    let resp = do_request(&req).await?;
    println!("\nResponse:\n{:}", resp.message.to_json()?);

    Ok(())
}

pub fn package_name(&self) -> &str

Gets the name of the package this service is defined in, e.g. my.package.

If no package name is set, an empty string is returned.

pub fn path(&self) -> &[i32]

Gets the path where this service is defined within the FileDescriptorProto, e.g. [6, 0].

See path for more details on the structure of the path.

pub fn parent_file_descriptor_proto(&self) -> &FileDescriptorProto

Gets a reference to the FileDescriptorProto in which this service is defined.

pub fn service_descriptor_proto(&self) -> &ServiceDescriptorProto

Gets a reference to the raw ServiceDescriptorProto wrapped by this ServiceDescriptor.

pub fn options(&self) -> DynamicMessage

Decodes the options defined for this ServiceDescriptorProto, including any extension options.

pub fn methods(&self) -> impl ExactSizeIterator

Gets an iterator yielding a MethodDescriptor for each method defined in this service.

Trait Implementations

impl Clone for ServiceDescriptor

fn clone(&self) -> ServiceDescriptor

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServiceDescriptor

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

Formats the value using the given formatter.

impl PartialEq for ServiceDescriptor

fn eq(&self, other: &ServiceDescriptor) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ServiceDescriptor

impl StructuralPartialEq for ServiceDescriptor