Package com.grpc.health.v1

Class HealthGrpc.HealthStub

java.lang.Object
io.grpc.stub.AbstractStub<S>
io.grpc.stub.AbstractAsyncStub<HealthGrpc.HealthStub>
com.grpc.health.v1.HealthGrpc.HealthStub
Enclosing class:
HealthGrpc
public static final class HealthGrpc.HealthStub extends io.grpc.stub.AbstractAsyncStub<HealthGrpc.HealthStub>
A stub to allow clients to do asynchronous rpc calls to service Health. 
 Health is gRPC's mechanism for checking whether a server is able to handle
 RPCs. Its semantics are documented in
 https://github.com/grpc/grpc/blob/master/doc/health-checking.md.

  • Nested Class Summary

    Nested classes/interfaces inherited from class io.grpc.stub.AbstractStub

    io.grpc.stub.AbstractStub.StubFactory<T extends io.grpc.stub.AbstractStub<T>>

  • Method Summary

    Modifier and Type
    Method
    Description
    protected HealthGrpc.HealthStub
    build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
     
    void
    check(HealthCheckRequest request, io.grpc.stub.StreamObserver<HealthCheckResponse> responseObserver)
    Check gets the health of the specified service.
    void
    watch(HealthCheckRequest request, io.grpc.stub.StreamObserver<HealthCheckResponse> responseObserver)
    Performs a watch for the serving status of the requested service.

    Methods inherited from class io.grpc.stub.AbstractAsyncStub

    newStub, newStub

    Methods inherited from class io.grpc.stub.AbstractStub

    getCallOptions, getChannel, withCallCredentials, withChannel, withCompression, withDeadline, withDeadlineAfter, withExecutor, withInterceptors, withMaxInboundMessageSize, withMaxOutboundMessageSize, withOption, withWaitForReady

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Method Details

    • build

      protected HealthGrpc.HealthStub build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
      Specified by:
      build in class io.grpc.stub.AbstractStub<HealthGrpc.HealthStub>

    • check

      public void check(HealthCheckRequest request, io.grpc.stub.StreamObserver<HealthCheckResponse> responseObserver)
       Check gets the health of the specified service. If the requested service
 is unknown, the call will fail with status NOT_FOUND. If the caller does
 not specify a service name, the server should respond with its overall
 health status.
 Clients should set a deadline when calling Check, and can declare the
 server unhealthy if they do not receive a timely response.
 Check implementations should be idempotent and side effect free.

    • watch

      public void watch(HealthCheckRequest request, io.grpc.stub.StreamObserver<HealthCheckResponse> responseObserver)
       Performs a watch for the serving status of the requested service.
 The server will immediately send back a message indicating the current
 serving status.  It will then subsequently send a new message whenever
 the service's serving status changes.
 If the requested service is unknown when the call is received, the
 server will send a message setting the serving status to
 SERVICE_UNKNOWN but will *not* terminate the call.  If at some
 future point, the serving status of the service becomes known, the
 server will send a new message with the service's serving status.
 If the call terminates with status UNIMPLEMENTED, then clients
 should assume this method is not supported and should not retry the
 call.  If the call terminates with any other status (including OK),
 clients should retry the call with appropriate exponential backoff.