io.greptime

Class RouterClient

java.lang.Object

io.greptime.RouterClient

All Implemented Interfaces:

Display, Lifecycle<RouterOptions>, Health

public class RouterClient
extends Object
implements Lifecycle<RouterOptions>, Health, Display

A route rpc client which cached the routing table information locally and will auto refresh.

Nested Class Summary

Nested classes/interfaces inherited from interface io.greptime.common.Display

Display.DefaultPrinter, Display.Printer

Constructor Summary

Constructors

Constructor and Description
RouterClient()

Method Summary

Modifier and Type	Method and Description
CompletableFuture<Map<Endpoint,Boolean>>	checkHealth()
void	display(Display.Printer out)
boolean	init(RouterOptions opts)
<Req,Resp> CompletableFuture<Resp>	invoke(Endpoint endpoint, Req request, Context ctx)
<Req,Resp> CompletableFuture<Resp>	invoke(Endpoint endpoint, Req request, Context ctx, long timeoutMs) Invoke the rpc request to the given endpoint.
<Req,Resp> Observer<Req>	invokeClientStreaming(Endpoint endpoint, Req defaultReqIns, Context ctx, Observer<Resp> respObserver) Invoke a client streaming rpc request to the given endpoint.
<Req,Resp> void	invokeServerStreaming(Endpoint endpoint, Req request, Context ctx, Observer<Resp> observer) Invoke a server streaming rpc request to the given endpoint.
CompletableFuture<Endpoint>	route() Gets the current routing table.
void	shutdownGracefully()
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.greptime.common.Lifecycle

ensureInitialized

Constructor Detail

RouterClient

public RouterClient()

Method Detail

init

public boolean init(RouterOptions opts)

Specified by:

init in interface Lifecycle<RouterOptions>

shutdownGracefully

public void shutdownGracefully()

Specified by:

shutdownGracefully in interface Lifecycle<RouterOptions>

route

public CompletableFuture<Endpoint> route()

Gets the current routing table.

Returns:

the current routing table

invoke

public <Req,Resp> CompletableFuture<Resp> invoke(Endpoint endpoint,
                                                 Req request,
                                                 Context ctx)

Type Parameters:

Req - request type

Resp - response type

Parameters:

endpoint - the endpoint to invoke

request - the request to send

ctx - the context

Returns:

the response future

See Also:

invoke(Endpoint, Object, Context, long)

invoke

public <Req,Resp> CompletableFuture<Resp> invoke(Endpoint endpoint,
                                                 Req request,
                                                 Context ctx,
                                                 long timeoutMs)

Invoke the rpc request to the given endpoint.

Type Parameters:

Req - request type

Resp - response type

Parameters:

endpoint - the endpoint to invoke

request - the request to send

ctx - the context

timeoutMs - timeout in milliseconds

Returns:

the response future

invokeServerStreaming

public <Req,Resp> void invokeServerStreaming(Endpoint endpoint,
                                             Req request,
                                             Context ctx,
                                             Observer<Resp> observer)

Invoke a server streaming rpc request to the given endpoint.

Type Parameters:

Req - the request type

Resp - the response type

Parameters:

endpoint - the endpoint to invoke

request - the request to send

ctx - the context

observer - the observer to receive the response

invokeClientStreaming

public <Req,Resp> Observer<Req> invokeClientStreaming(Endpoint endpoint,
                                                      Req defaultReqIns,
                                                      Context ctx,
                                                      Observer<Resp> respObserver)

Invoke a client streaming rpc request to the given endpoint.

Type Parameters:

Req - the request type

Resp - the response type

Parameters:

endpoint - the endpoint to invoke

defaultReqIns - the default request instance

ctx - the context

respObserver - the observer to receive the response

Returns:

the observer to send the request

display

public void display(Display.Printer out)

Specified by:

display in interface Display

toString

public String toString()

Overrides:

toString in class Object

checkHealth

public CompletableFuture<Map<Endpoint,Boolean>> checkHealth()

Specified by:

checkHealth in interface Health