io.servicetalk.client.api

Interface ClientGroup<Key,Client extends ListenableAsyncCloseable>

Type Parameters:

Key - the type of key used for client lookup

Client - the type of client stored in the group

All Superinterfaces:

AsyncCloseable, ListenableAsyncCloseable

All Known Implementing Classes:

DefaultPartitionedClientGroup

public interface ClientGroup<Key,Client extends ListenableAsyncCloseable>
extends ListenableAsyncCloseable

A data-structure capable of holding arbitrary number of clients and bridging lifecycle events across all clients managed by the group.

Method Summary

Modifier and Type	Method and Description
static <Key,Client extends ListenableAsyncCloseable> ClientGroup<Key,Client>	from(java.util.function.Function<Key,Client> factory) Creates a ClientGroup based on a factory of clients of type Client.
Client	get(Key key) Return the Client identified by the provided key or create a new one when none exists.

Methods inherited from interface io.servicetalk.concurrent.api.ListenableAsyncCloseable

onClose

Methods inherited from interface io.servicetalk.concurrent.api.AsyncCloseable

closeAsync, closeAsyncGracefully

Method Detail

get

Client get(Key key)

Return the Client identified by the provided key or create a new one when none exists.

Parameters:

key - the key identifying the client to return or create, this key may contain attributes about the requested client in order to create new instances

Returns:

a client assigned to the provided key, either by looking up an existing or creating a new instance if non-existent

from

static <Key,Client extends ListenableAsyncCloseable> ClientGroup<Key,Client> from(java.util.function.Function<Key,Client> factory)

Creates a ClientGroup based on a factory of clients of type Client.

Type Parameters:

Key - the type of key used for client lookup and creation

Client - the type of client stored in the group

Parameters:

factory - Function will be called every time get(Object) is called with a non-existent Key.

Returns:

a ClientGroup based on a @{code factory} of clients of type Client.