Package 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	Description
static <U,R> GrpcClientBuilder<U,R>	forAddress(ServiceDiscoverer<U,R,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(HostAndPort address)	Creates a GrpcClientBuilder for an address with default LoadBalancer and DNS 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.
static GrpcClientBuilder<HostAndPort,java.net.InetSocketAddress>	forResolvedAddress(java.lang.String host, int port)	Creates a GrpcClientBuilder for a resolved address with default LoadBalancer.
static GrpcClientBuilder<java.net.InetSocketAddress,java.net.InetSocketAddress>	forResolvedAddress(java.net.InetSocketAddress address)	Creates a GrpcClientBuilder for an address with default LoadBalancer.
static <T extends java.net.SocketAddress> GrpcClientBuilder<T,T>	forResolvedAddress(T address)	Creates a GrpcClientBuilder for an address with default LoadBalancer.
static GrpcClientBuilder<java.lang.String,java.net.InetSocketAddress>	forServiceAddress(java.lang.String serviceName)	Creates a GrpcClientBuilder for the passed serviceName with default LoadBalancer and a DNS ServiceDiscoverer using SRV record lookups.

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

forServiceAddress

public static GrpcClientBuilder<java.lang.String,java.net.InetSocketAddress> forServiceAddress(java.lang.String serviceName)

Creates a GrpcClientBuilder for the passed serviceName with default LoadBalancer and a DNS ServiceDiscoverer using SRV record lookups.

Parameters:

serviceName - the service name to query via SRV DNS.

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.

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.

Parameters:

address - the InetSocketAddress to connect to.

Returns:

new builder for the address

forResolvedAddress

public static <T extends java.net.SocketAddress> GrpcClientBuilder<T,T> forResolvedAddress(T address)

Creates a GrpcClientBuilder for an address with default LoadBalancer.

Type Parameters:

T - The type of SocketAddress.

Parameters:

address - the ResolvedAddress to connect. This address will also be used for the HttpHeaderNames.HOST. Use GrpcClientBuilder.unresolvedAddressToHost(Function) if you want to override that value or GrpcClientBuilder.disableHostHeaderFallback() if you want to disable this behavior.

Returns:

new builder for the address

forAddress

public static <U,R> GrpcClientBuilder<U,R> forAddress(ServiceDiscoverer<U,R,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