Package com.grpc.health.v1

Interface HealthGrpc.AsyncService

All Known Implementing Classes:
HealthGrpc.HealthImplBase
Enclosing class:
HealthGrpc
public static interface HealthGrpc.AsyncService
 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.

  • Method Summary

    Modifier and Type
    Method
    Description
    default void
    check(HealthCheckRequest request, io.grpc.stub.StreamObserver<HealthCheckResponse> responseObserver)
    Check gets the health of the specified service.
    default void
    watch(HealthCheckRequest request, io.grpc.stub.StreamObserver<HealthCheckResponse> responseObserver)
    Performs a watch for the serving status of the requested service.

  • Method Details

    • check

      default 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

      default 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.