io.grpc.transport.netty

Class NettyServerBuilder

java.lang.Object

io.grpc.AbstractServerBuilder<NettyServerBuilder>

io.grpc.transport.netty.NettyServerBuilder

public final class NettyServerBuilder
extends AbstractServerBuilder<NettyServerBuilder>

A builder to help simplify the construction of a Netty-based GRPC server.

Nested Class Summary

Nested classes/interfaces inherited from class io.grpc.AbstractServerBuilder

AbstractServerBuilder.ServerEssentials

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_CONNECTION_WINDOW_SIZE
static int	DEFAULT_STREAM_WINDOW_SIZE

Method Summary

Modifier and Type	Method and Description
NettyServerBuilder	bossEventLoopGroup(EventLoopGroup group) Provides the boss EventGroupLoop to the server.
protected AbstractServerBuilder.ServerEssentials	buildEssentials()
NettyServerBuilder	channelType(Class<? extends ServerChannel> channelType) Specify the channel type to use, by default we use NioServerSocketChannel.
NettyServerBuilder	connectionWindowSize(int connectionWindowSize) Sets the HTTP/2 connection flow control window.
static NettyServerBuilder	forAddress(SocketAddress address) Creates a server builder configured with the given SocketAddress.
static NettyServerBuilder	forPort(int port) Creates a server builder that will bind to the given port.
static NettyServerBuilder	forRegistryAndPort(HandlerRegistry registry, int port) Creates a server builder that will bind to the given port and use the HandlerRegistry for call dispatching.
NettyServerBuilder	maxConcurrentCallsPerConnection(int maxCalls) The maximum number of concurrent calls permitted for each incoming connection.
NettyServerBuilder	sslContext(SslContext sslContext) Sets the TLS context to use for encryption.
NettyServerBuilder	streamWindowSize(int streamWindowSize) Sets the HTTP/2 per-stream flow control window.
NettyServerBuilder	workerEventLoopGroup(EventLoopGroup group) Provides the worker EventGroupLoop to the server.

Methods inherited from class io.grpc.AbstractServerBuilder

addService, build, executor

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CONNECTION_WINDOW_SIZE

public static final int DEFAULT_CONNECTION_WINDOW_SIZE

See Also:

Constant Field Values

DEFAULT_STREAM_WINDOW_SIZE

public static final int DEFAULT_STREAM_WINDOW_SIZE

See Also:

Constant Field Values

Method Detail

forPort

public static NettyServerBuilder forPort(int port)

Creates a server builder that will bind to the given port.

Parameters:

port - the port on which the server is to be bound.

Returns:

the server builder.

forRegistryAndPort

public static NettyServerBuilder forRegistryAndPort(HandlerRegistry registry,
                                                    int port)

Creates a server builder that will bind to the given port and use the HandlerRegistry for call dispatching.

Parameters:

registry - the registry of handlers used for dispatching incoming calls.

port - the port on which to the server is to be bound.

Returns:

the server builder.

forAddress

public static NettyServerBuilder forAddress(SocketAddress address)

Creates a server builder configured with the given SocketAddress.

Parameters:

address - the socket address on which the server is to be bound.

Returns:

the server builder

channelType

public NettyServerBuilder channelType(Class<? extends ServerChannel> channelType)

Specify the channel type to use, by default we use NioServerSocketChannel.

bossEventLoopGroup

public NettyServerBuilder bossEventLoopGroup(EventLoopGroup group)

Provides the boss EventGroupLoop to the server.

It's an optional parameter. If the user has not provided one when the server is built, the builder will use the default one which is static.

The server won't take ownership of the given EventLoopGroup. It's caller's responsibility to shut it down when it's desired.

Grpc uses non-daemon Threads by default and thus a ServerImpl will continue to run even after the main thread has terminated. However, users have to be cautious when providing their own EventLoopGroups. For example, Netty's EventLoopGroups use daemon threads by default and thus an application with only daemon threads running besides the main thread will exit as soon as the main thread completes. A simple solution to this problem is to call ServerImpl.awaitTerminated() to keep the main thread alive until the server has terminated.

workerEventLoopGroup

public NettyServerBuilder workerEventLoopGroup(EventLoopGroup group)

Provides the worker EventGroupLoop to the server.

It's an optional parameter. If the user has not provided one when the server is built, the builder will create one.

The server won't take ownership of the given EventLoopGroup. It's caller's responsibility to shut it down when it's desired.

Grpc uses non-daemon Threads by default and thus a ServerImpl will continue to run even after the main thread has terminated. However, users have to be cautious when providing their own EventLoopGroups. For example, Netty's EventLoopGroups use daemon threads by default and thus an application with only daemon threads running besides the main thread will exit as soon as the main thread completes. A simple solution to this problem is to call ServerImpl.awaitTerminated() to keep the main thread alive until the server has terminated.

sslContext

public NettyServerBuilder sslContext(SslContext sslContext)

Sets the TLS context to use for encryption. Providing a context enables encryption. It must have been configured with GrpcSslContexts, but options could have been overridden.

maxConcurrentCallsPerConnection

public NettyServerBuilder maxConcurrentCallsPerConnection(int maxCalls)

The maximum number of concurrent calls permitted for each incoming connection. Defaults to no limit.

connectionWindowSize

public NettyServerBuilder connectionWindowSize(int connectionWindowSize)

Sets the HTTP/2 connection flow control window. If not called, the default value is DEFAULT_CONNECTION_WINDOW_SIZE).

streamWindowSize

public NettyServerBuilder streamWindowSize(int streamWindowSize)

Sets the HTTP/2 per-stream flow control window. If not called, the default value is DEFAULT_STREAM_WINDOW_SIZE).

buildEssentials

protected AbstractServerBuilder.ServerEssentials buildEssentials()

Specified by:

buildEssentials in class AbstractServerBuilder<NettyServerBuilder>