io.grpc.services

Class HealthStatusManager

java.lang.Object

io.grpc.services.HealthStatusManager

@ExperimentalApi
public final class HealthStatusManager
extends Object

A HealthStatusManager object manages a health check service. A health check service is created in the constructor of HealthStatusManager, and it can be retrieved by the getHealthService() method. The health status manager can update the health statuses of the server.

Constructor Summary

Constructors

Constructor and Description
HealthStatusManager() Creates a new health service instance.

Method Summary

Modifier and Type	Method and Description
void	clearStatus(String service) Clears the health status record of a service.
io.grpc.health.v1.HealthGrpc.HealthImplBase	getHealthService() Gets the health check service created in the constructor.
void	setStatus(String service, io.grpc.health.v1.HealthCheckResponse.ServingStatus status) Updates the status of the server.

Methods inherited from class java.lang.Object

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

Constructor Detail

HealthStatusManager

public HealthStatusManager()

Creates a new health service instance.

Method Detail

getHealthService

public io.grpc.health.v1.HealthGrpc.HealthImplBase getHealthService()

Gets the health check service created in the constructor.

setStatus

public void setStatus(String service,
                      io.grpc.health.v1.HealthCheckResponse.ServingStatus status)

Updates the status of the server.

Parameters:

service - the name of some aspect of the server that is associated with a health status. This name can have no relation with the gRPC services that the server is running with. It can also be an empty String "" per the gRPC specification.

status - is one of the values HealthCheckResponse.ServingStatus.SERVING, HealthCheckResponse.ServingStatus.NOT_SERVING and HealthCheckResponse.ServingStatus.UNKNOWN.

clearStatus

public void clearStatus(String service)

Clears the health status record of a service. The health service will respond with NOT_FOUND error on checking the status of a cleared service.

Parameters:

service - the name of some aspect of the server that is associated with a health status. This name can have no relation with the gRPC services that the server is running with. It can also be an empty String "" per the gRPC specification.