net.devh.boot.grpc.client.channelfactory

Interface GrpcChannelFactory

All Superinterfaces:

AutoCloseable

All Known Implementing Classes:

AbstractChannelFactory, InProcessChannelFactory, NettyChannelFactory, ShadedNettyChannelFactory

public interface GrpcChannelFactory
extends AutoCloseable

This factory creates grpc Channels for a given service name. Implementations are encouraged to utilize connection pooling and thus close should be called before disposing it.

Since:

5/17/16

Method Summary

Modifier and Type	Method and Description
void	close()
default Channel	createChannel(String name) Creates a new channel for the given service name.
Channel	createChannel(String name, List<ClientInterceptor> interceptors) Creates a new channel for the given service name.

Method Detail

createChannel

default Channel createChannel(String name)

Creates a new channel for the given service name. The returned channel will use all globally registered ClientInterceptors.

Note: The underlying implementation might reuse existing ManagedChannels allow connection reuse.

Parameters:

name - The name of the service.

Returns:

The newly created channel for the given service.

createChannel

Channel createChannel(String name,
                      List<ClientInterceptor> interceptors)

Creates a new channel for the given service name. The returned channel will use all globally registered ClientInterceptors.

Note: The underlying implementation might reuse existing ManagedChannels allow connection reuse.

Note: The given interceptors will be applied after the global interceptors. But the interceptors that were applied last, will be called first.

Parameters:

name - The name of the service.

interceptors - A list of additional client interceptors that should be added to the channel.

Returns:

The newly created channel for the given service.

close

void close()

Specified by:

close in interface AutoCloseable