io.servicetalk.grpc.netty

Class GrpcClients

java.lang.Object

io.servicetalk.grpc.netty.GrpcClients

public final class GrpcClients
extends java.lang.Object

A factory to create gRPC clients.

Method Summary

Modifier and Type	Method and Description
static GrpcClientBuilder<HostAndPort,java.net.InetSocketAddress>	forAddress(HostAndPort address) Creates a GrpcClientBuilder for an address with default LoadBalancer and DNS ServiceDiscoverer.
static <U,R> GrpcClientBuilder<U,R>	forAddress(ServiceDiscoverer<U,R,? extends ServiceDiscovererEvent<R>> serviceDiscoverer, U address) Creates a GrpcClientBuilder for a custom address type with default LoadBalancer and user provided ServiceDiscoverer.
static GrpcClientBuilder<HostAndPort,java.net.InetSocketAddress>	forAddress(java.lang.String host, int port) Creates a GrpcClientBuilder for an address with default LoadBalancer and DNS ServiceDiscoverer.
static GrpcClientBuilder<HostAndPort,java.net.InetSocketAddress>	forResolvedAddress(HostAndPort address) Creates a GrpcClientBuilder for an address with default LoadBalancer and DNS ServiceDiscoverer.
static GrpcClientBuilder<java.net.InetSocketAddress,java.net.InetSocketAddress>	forResolvedAddress(java.net.InetSocketAddress address) Creates a GrpcClientBuilder for an address with default LoadBalancer and DNS ServiceDiscoverer.
static GrpcClientBuilder<HostAndPort,java.net.InetSocketAddress>	forResolvedAddress(java.lang.String host, int port) Creates a GrpcClientBuilder for a resolved address with default LoadBalancer.

Methods inherited from class java.lang.Object

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

Method Detail

forAddress

public static GrpcClientBuilder<HostAndPort,java.net.InetSocketAddress> forAddress(java.lang.String host,
                                                                                   int port)

Creates a GrpcClientBuilder for an address with default LoadBalancer and DNS ServiceDiscoverer.

Parameters:

host - host to connect to, resolved by default using a DNS ServiceDiscoverer.

port - port to connect to

Returns:

new builder for the address

forAddress

public static GrpcClientBuilder<HostAndPort,java.net.InetSocketAddress> forAddress(HostAndPort address)

Creates a GrpcClientBuilder for an address with default LoadBalancer and DNS ServiceDiscoverer.

Parameters:

address - the UnresolvedAddress to connect to, resolved by default using a DNS ServiceDiscoverer.

Returns:

new builder for the address

forResolvedAddress

public static GrpcClientBuilder<HostAndPort,java.net.InetSocketAddress> forResolvedAddress(java.lang.String host,
                                                                                           int port)

Creates a GrpcClientBuilder for a resolved address with default LoadBalancer.

Parameters:

host - resolved host address to connect to.

port - port to connect to

Returns:

new builder for the address

forResolvedAddress

public static GrpcClientBuilder<HostAndPort,java.net.InetSocketAddress> forResolvedAddress(HostAndPort address)

Creates a GrpcClientBuilder for an address with default LoadBalancer and DNS ServiceDiscoverer.

Parameters:

address - the ResolvedAddress to connect to.

Returns:

new builder for the address

forResolvedAddress

public static GrpcClientBuilder<java.net.InetSocketAddress,java.net.InetSocketAddress> forResolvedAddress(java.net.InetSocketAddress address)

Creates a GrpcClientBuilder for an address with default LoadBalancer and DNS ServiceDiscoverer.

Parameters:

address - the InetSocketAddress to connect to.

Returns:

new builder for the address

forAddress

public static <U,R> GrpcClientBuilder<U,R> forAddress(ServiceDiscoverer<U,R,? extends ServiceDiscovererEvent<R>> serviceDiscoverer,
                                                      U address)

Creates a GrpcClientBuilder for a custom address type with default LoadBalancer and user provided ServiceDiscoverer.

Type Parameters:

U - the type of address before resolution (unresolved address)

R - the type of address after resolution (resolved address)

Parameters:

serviceDiscoverer - The ServiceDiscoverer to resolve addresses of remote servers to connect to. The lifecycle of the provided ServiceDiscoverer should be managed by the caller.

address - the UnresolvedAddress to connect to resolved using the provided serviceDiscoverer.

Returns:

new builder with provided configuration