Class NettyChannelBuilder
- java.lang.Object
-
- io.grpc.ManagedChannelBuilder<T>
-
- io.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
-
- io.grpc.netty.NettyChannelBuilder
-
@ExperimentalApi("https://github.com/grpc/grpc-java/issues/1784") @CheckReturnValue public final class NettyChannelBuilder extends io.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
A builder to help simplify construction of channels using the Netty transport.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
NettyChannelBuilder.LocalSocketPicker
This class is meant to be overriden with a custom implementation ofNettyChannelBuilder.LocalSocketPicker.createSocketAddress(java.net.SocketAddress, io.grpc.Attributes)
.
-
Field Summary
Fields Modifier and Type Field Description static int
DEFAULT_FLOW_CONTROL_WINDOW
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description NettyChannelBuilder
channelFactory(io.netty.channel.ChannelFactory<? extends io.netty.channel.Channel> channelFactory)
Specifies theChannelFactory
to createChannel
instances.NettyChannelBuilder
channelType(java.lang.Class<? extends io.netty.channel.Channel> channelType)
Specifies the channel type to use, by default we useEpollSocketChannel
if available, otherwise usingNioSocketChannel
.protected io.grpc.ManagedChannelBuilder<?>
delegate()
NettyChannelBuilder
eventLoopGroup(io.netty.channel.EventLoopGroup eventLoopGroup)
Provides an EventGroupLoop to be used by the netty transport.NettyChannelBuilder
flowControlWindow(int flowControlWindow)
Sets the flow control window in bytes.static NettyChannelBuilder
forAddress(java.lang.String host, int port)
Creates a new builder with the given host and port.static NettyChannelBuilder
forAddress(java.lang.String host, int port, io.grpc.ChannelCredentials creds)
Creates a new builder with the given host and port.static NettyChannelBuilder
forAddress(java.net.SocketAddress serverAddress)
Creates a new builder with the given server address.static NettyChannelBuilder
forAddress(java.net.SocketAddress serverAddress, io.grpc.ChannelCredentials creds)
Creates a new builder with the given server address.static NettyChannelBuilder
forTarget(java.lang.String target)
Creates a new builder with the given target string that will be resolved byNameResolver
.static NettyChannelBuilder
forTarget(java.lang.String target, io.grpc.ChannelCredentials creds)
Creates a new builder with the given target string that will be resolved byNameResolver
.NettyChannelBuilder
initialFlowControlWindow(int initialFlowControlWindow)
Sets the initial flow control window in bytes.NettyChannelBuilder
keepAliveTime(long keepAliveTime, java.util.concurrent.TimeUnit timeUnit)
NettyChannelBuilder
keepAliveTimeout(long keepAliveTimeout, java.util.concurrent.TimeUnit timeUnit)
NettyChannelBuilder
keepAliveWithoutCalls(boolean enable)
NettyChannelBuilder
localSocketPicker(NettyChannelBuilder.LocalSocketPicker localSocketPicker)
If non-null
, attempts to create connections bound to a local port.NettyChannelBuilder
maxHeaderListSize(int maxHeaderListSize)
Deprecated.UsemaxInboundMetadataSize(int)
insteadNettyChannelBuilder
maxInboundMessageSize(int max)
Sets the maximum message size allowed for a single gRPC frame.NettyChannelBuilder
maxInboundMetadataSize(int bytes)
Sets the maximum size of metadata allowed to be received.NettyChannelBuilder
negotiationType(NegotiationType type)
Sets the negotiation type for the HTTP/2 connection.NettyChannelBuilder
sslContext(io.netty.handler.ssl.SslContext sslContext)
SSL/TLS context to use instead of the system default.NettyChannelBuilder
usePlaintext()
Equivalent to usingnegotiationType(NegotiationType)
withPLAINTEXT
.NettyChannelBuilder
useTransportSecurity()
Equivalent to usingnegotiationType(NegotiationType)
withTLS
.<T> NettyChannelBuilder
withOption(io.netty.channel.ChannelOption<T> option, T value)
Specifies a channel option.-
Methods inherited from class io.grpc.internal.AbstractManagedChannelImplBuilder
build, compressorRegistry, decompressorRegistry, defaultLoadBalancingPolicy, defaultServiceConfig, directExecutor, disableRetry, disableServiceConfigLookUp, enableFullStreamDecompression, enableRetry, executor, idleTimeout, intercept, intercept, maxHedgedAttempts, maxRetryAttempts, maxTraceEvents, nameResolverFactory, offloadExecutor, overrideAuthority, perRpcBufferLimit, proxyDetector, retryBufferSize, setBinaryLog, thisT, toString, userAgent
-
-
-
-
Field Detail
-
DEFAULT_FLOW_CONTROL_WINDOW
public static final int DEFAULT_FLOW_CONTROL_WINDOW
- See Also:
- Constant Field Values
-
-
Method Detail
-
forAddress
public static NettyChannelBuilder forAddress(java.net.SocketAddress serverAddress)
Creates a new builder with the given server address. This factory method is primarily intended for using Netty Channel types other than SocketChannel.forAddress(String, int)
should generally be preferred over this method, since that API permits delaying DNS lookups and noticing changes to DNS. If an unresolved InetSocketAddress is passed in, then it will remain unresolved.
-
forAddress
public static NettyChannelBuilder forAddress(java.net.SocketAddress serverAddress, io.grpc.ChannelCredentials creds)
Creates a new builder with the given server address. This factory method is primarily intended for using Netty Channel types other than SocketChannel.forAddress(String, int, ChannelCredentials)
should generally be preferred over this method, since that API permits delaying DNS lookups and noticing changes to DNS. If an unresolved InetSocketAddress is passed in, then it will remain unresolved.
-
forAddress
public static NettyChannelBuilder forAddress(java.lang.String host, int port)
Creates a new builder with the given host and port.
-
forAddress
public static NettyChannelBuilder forAddress(java.lang.String host, int port, io.grpc.ChannelCredentials creds)
Creates a new builder with the given host and port.
-
forTarget
public static NettyChannelBuilder forTarget(java.lang.String target)
Creates a new builder with the given target string that will be resolved byNameResolver
.
-
forTarget
public static NettyChannelBuilder forTarget(java.lang.String target, io.grpc.ChannelCredentials creds)
Creates a new builder with the given target string that will be resolved byNameResolver
.
-
delegate
@Internal protected io.grpc.ManagedChannelBuilder<?> delegate()
- Specified by:
delegate
in classio.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
-
channelType
@CanIgnoreReturnValue public NettyChannelBuilder channelType(java.lang.Class<? extends io.netty.channel.Channel> channelType)
Specifies the channel type to use, by default we useEpollSocketChannel
if available, otherwise usingNioSocketChannel
.You either use this or
channelFactory(io.netty.channel.ChannelFactory)
if yourChannel
implementation has no no-args constructor.It's an optional parameter. If the user has not provided an Channel type or ChannelFactory when the channel is built, the builder will use the default one which is static.
You must also provide corresponding
eventLoopGroup(EventLoopGroup)
. For example,NioSocketChannel
must useNioEventLoopGroup
, otherwise your application won't start.
-
channelFactory
@CanIgnoreReturnValue public NettyChannelBuilder channelFactory(io.netty.channel.ChannelFactory<? extends io.netty.channel.Channel> channelFactory)
Specifies theChannelFactory
to createChannel
instances. This method is usually only used if the specificChannel
requires complex logic which requires additional information to create theChannel
. Otherwise, recommend to usechannelType(Class)
.It's an optional parameter. If the user has not provided an Channel type or ChannelFactory when the channel is built, the builder will use the default one which is static.
You must also provide corresponding
eventLoopGroup(EventLoopGroup)
. For example,NioSocketChannel
basedChannelFactory
must useNioEventLoopGroup
, otherwise your application won't start.
-
withOption
@CanIgnoreReturnValue public <T> NettyChannelBuilder withOption(io.netty.channel.ChannelOption<T> option, T value)
Specifies a channel option. As the underlying channel as well as network implementation may ignore this value applications should consider it a hint.
-
negotiationType
@CanIgnoreReturnValue public NettyChannelBuilder negotiationType(NegotiationType type)
Sets the negotiation type for the HTTP/2 connection.Default:
TLS
-
eventLoopGroup
@CanIgnoreReturnValue public NettyChannelBuilder eventLoopGroup(@Nullable io.netty.channel.EventLoopGroup eventLoopGroup)
Provides an EventGroupLoop to be used by the netty transport.It's an optional parameter. If the user has not provided an EventGroupLoop when the channel is built, the builder will use the default one which is static.
You must also provide corresponding
channelType(Class)
orchannelFactory(ChannelFactory)
corresponding to the givenEventLoopGroup
. For example,NioEventLoopGroup
requiresNioSocketChannel
The channel won't take ownership of the given EventLoopGroup. It's caller's responsibility to shut it down when it's desired.
-
sslContext
@CanIgnoreReturnValue public NettyChannelBuilder sslContext(io.netty.handler.ssl.SslContext sslContext)
SSL/TLS context to use instead of the system default. It must have been configured withGrpcSslContexts
, but options could have been overridden.
-
initialFlowControlWindow
@CanIgnoreReturnValue public NettyChannelBuilder initialFlowControlWindow(int initialFlowControlWindow)
Sets the initial flow control window in bytes. Setting initial flow control window enables auto flow control tuning using bandwidth-delay product algorithm. To disable auto flow control tuning, useflowControlWindow(int)
. By default, auto flow control is enabled with initial flow control window size ofDEFAULT_FLOW_CONTROL_WINDOW
.
-
flowControlWindow
@CanIgnoreReturnValue public NettyChannelBuilder flowControlWindow(int flowControlWindow)
Sets the flow control window in bytes. Setting flowControlWindow disables auto flow control tuning; useinitialFlowControlWindow(int)
to enable auto flow control tuning. If not called, the default value isDEFAULT_FLOW_CONTROL_WINDOW
) with auto flow control tuning.
-
maxHeaderListSize
@CanIgnoreReturnValue @Deprecated @InlineMe(replacement="this.maxInboundMetadataSize(maxHeaderListSize)") public NettyChannelBuilder maxHeaderListSize(int maxHeaderListSize)
Deprecated.UsemaxInboundMetadataSize(int)
insteadSets the maximum size of header list allowed to be received. This is cumulative size of the headers with some overhead, as defined for HTTP/2's SETTINGS_MAX_HEADER_LIST_SIZE. The default is 8 KiB.
-
maxInboundMetadataSize
@CanIgnoreReturnValue public NettyChannelBuilder maxInboundMetadataSize(int bytes)
Sets the maximum size of metadata allowed to be received. This is cumulative size of the entries with some overhead, as defined for HTTP/2's SETTINGS_MAX_HEADER_LIST_SIZE. The default is 8 KiB.- Overrides:
maxInboundMetadataSize
in classio.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
- Parameters:
bytes
- the maximum size of received metadata- Returns:
- this
- Throws:
java.lang.IllegalArgumentException
- if bytes is non-positive- Since:
- 1.17.0
-
usePlaintext
@CanIgnoreReturnValue public NettyChannelBuilder usePlaintext()
Equivalent to usingnegotiationType(NegotiationType)
withPLAINTEXT
.- Overrides:
usePlaintext
in classio.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
-
useTransportSecurity
@CanIgnoreReturnValue public NettyChannelBuilder useTransportSecurity()
Equivalent to usingnegotiationType(NegotiationType)
withTLS
.- Overrides:
useTransportSecurity
in classio.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
-
keepAliveTime
@CanIgnoreReturnValue public NettyChannelBuilder keepAliveTime(long keepAliveTime, java.util.concurrent.TimeUnit timeUnit)
- Overrides:
keepAliveTime
in classio.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
- Since:
- 1.3.0
-
keepAliveTimeout
@CanIgnoreReturnValue public NettyChannelBuilder keepAliveTimeout(long keepAliveTimeout, java.util.concurrent.TimeUnit timeUnit)
- Overrides:
keepAliveTimeout
in classio.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
- Since:
- 1.3.0
-
keepAliveWithoutCalls
@CanIgnoreReturnValue public NettyChannelBuilder keepAliveWithoutCalls(boolean enable)
- Overrides:
keepAliveWithoutCalls
in classio.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
- Since:
- 1.3.0
-
localSocketPicker
@CanIgnoreReturnValue public NettyChannelBuilder localSocketPicker(@Nullable NettyChannelBuilder.LocalSocketPicker localSocketPicker)
If non-null
, attempts to create connections bound to a local port.
-
maxInboundMessageSize
@CanIgnoreReturnValue public NettyChannelBuilder maxInboundMessageSize(int max)
Sets the maximum message size allowed for a single gRPC frame. If an inbound messages larger than this limit is received it will not be processed and the RPC will fail with RESOURCE_EXHAUSTED.- Overrides:
maxInboundMessageSize
in classio.grpc.internal.AbstractManagedChannelImplBuilder<NettyChannelBuilder>
-
-