ChannelConfig (Netty API Reference (5.0.0.Alpha2))

All Known Subinterfaces:: DatagramChannelConfig, DomainSocketChannelConfig, OioServerSocketChannelConfig, OioSocketChannelConfig, RxtxChannelConfig, SctpChannelConfig, SctpServerChannelConfig, ServerSocketChannelConfig, SocketChannelConfig, UdtChannelConfig, UdtServerChannelConfig

All Known Implementing Classes:: DefaultChannelConfig, DefaultDatagramChannelConfig, DefaultOioServerSocketChannelConfig, DefaultOioSocketChannelConfig, DefaultSctpChannelConfig, DefaultSctpServerChannelConfig, DefaultServerSocketChannelConfig, DefaultSocketChannelConfig, DefaultUdtChannelConfig, DefaultUdtServerChannelConfig, EpollChannelConfig, EpollDatagramChannelConfig, EpollDomainSocketChannelConfig, EpollServerChannelConfig, EpollServerSocketChannelConfig, EpollSocketChannelConfig

public interface ChannelConfig

A set of configuration properties of a Channel.

Please down-cast to more specific configuration type such as SocketChannelConfig or use setOptions(Map) to set the transport-specific properties:

 Channel ch = ...;
 SocketChannelConfig cfg = (SocketChannelConfig) ch.getConfig();
 cfg.setTcpNoDelay(false);

Option map

An option map property is a dynamic write-only property which allows the configuration of a Channel without down-casting its associated ChannelConfig. To update an option map, please call setOptions(Map).

All ChannelConfig has the following options:

Name	Associated setter method
`ChannelOption.CONNECT_TIMEOUT_MILLIS`	`setConnectTimeoutMillis(int)`
`ChannelOption.WRITE_SPIN_COUNT`	`setWriteSpinCount(int)`
`ChannelOption.ALLOCATOR`	`setAllocator(ByteBufAllocator)`
`ChannelOption.AUTO_READ`	`setAutoRead(boolean)`

More options are available in the sub-types of ChannelConfig. For example, you can configure the parameters which are specific to a TCP/IP socket as explained in SocketChannelConfig.

Method Summary

Methods
Modifier and Type	Method and Description
`ByteBufAllocator`	`getAllocator()` Returns `ByteBufAllocator` which is used for the channel to allocate buffers.
`int`	`getConnectTimeoutMillis()` Returns the connect timeout of the channel in milliseconds.
`int`	`getMaxMessagesPerRead()` Returns the maximum number of messages to read per read loop.
`MessageSizeEstimator`	`getMessageSizeEstimator()` Returns `MessageSizeEstimator` which is used for the channel to detect the size of a message.
`<T> T`	`getOption(ChannelOption<T> option)` Return the value of the given `ChannelOption`
`Map<ChannelOption<?>,Object>`	`getOptions()` Return all set `ChannelOption`'s.
`RecvByteBufAllocator`	`getRecvByteBufAllocator()` Returns `RecvByteBufAllocator` which is used for the channel to allocate receive buffers.
`int`	`getWriteBufferHighWaterMark()` Returns the high water mark of the write buffer.
`int`	`getWriteBufferLowWaterMark()` Returns the low water mark of the write buffer.
`int`	`getWriteSpinCount()` Returns the maximum loop count for a write operation until `WritableByteChannel.write(ByteBuffer)` returns a non-zero value.
`boolean`	`isAutoRead()` Returns `true` if and only if `ChannelHandlerContext.read()` will be invoked automatically so that a user application doesn't need to call it at all.
`ChannelConfig`	`setAllocator(ByteBufAllocator allocator)` Set the `ByteBufAllocator` which is used for the channel to allocate buffers.
`ChannelConfig`	`setAutoRead(boolean autoRead)` Sets if `ChannelHandlerContext.read()` will be invoked automatically so that a user application doesn't need to call it at all.
`ChannelConfig`	`setConnectTimeoutMillis(int connectTimeoutMillis)` Sets the connect timeout of the channel in milliseconds.
`ChannelConfig`	`setMaxMessagesPerRead(int maxMessagesPerRead)` Sets the maximum number of messages to read per read loop.
`ChannelConfig`	`setMessageSizeEstimator(MessageSizeEstimator estimator)` Set the `ByteBufAllocator` which is used for the channel to detect the size of a message.
`<T> boolean`	`setOption(ChannelOption<T> option, T value)` Sets a configuration property with the specified name and value.
`boolean`	`setOptions(Map<ChannelOption<?>,?> options)` Sets the configuration properties from the specified `Map`.
`ChannelConfig`	`setRecvByteBufAllocator(RecvByteBufAllocator allocator)` Set the `ByteBufAllocator` which is used for the channel to allocate receive buffers.
`ChannelConfig`	`setWriteBufferHighWaterMark(int writeBufferHighWaterMark)` Sets the high water mark of the write buffer.
`ChannelConfig`	`setWriteBufferLowWaterMark(int writeBufferLowWaterMark)` Sets the low water mark of the write buffer.
`ChannelConfig`	`setWriteSpinCount(int writeSpinCount)` Sets the maximum loop count for a write operation until `WritableByteChannel.write(ByteBuffer)` returns a non-zero value.

- Method Detail
  - getOptions
```
Map<ChannelOption<?>,Object> getOptions()
```
    Return all set ChannelOption's.
  - setOptions
```
boolean setOptions(Map<ChannelOption<?>,?> options)
```
    Sets the configuration properties from the specified Map.
  - getOption
```
<T> T getOption(ChannelOption<T> option)
```
    Return the value of the given ChannelOption
  - setOption
```
<T> boolean setOption(ChannelOption<T> option,
                    T value)
```
    Sets a configuration property with the specified name and value. To override this method properly, you must call the super class:
```
 public boolean setOption(ChannelOption<T> option, T value) {
     if (super.setOption(option, value)) {
         return true;
     }

     if (option.equals(additionalOption)) {
         ....
         return true;
     }

     return false;
 }
 
```
    Returns:
    true if and only if the property has been set
  - getConnectTimeoutMillis
```
int getConnectTimeoutMillis()
```
    Returns the connect timeout of the channel in milliseconds. If the Channel does not support connect operation, this property is not used at all, and therefore will be ignored.
    
    Returns:
    the connect timeout in milliseconds. 0 if disabled.
  - setConnectTimeoutMillis
```
ChannelConfig setConnectTimeoutMillis(int connectTimeoutMillis)
```
    Sets the connect timeout of the channel in milliseconds. If the Channel does not support connect operation, this property is not used at all, and therefore will be ignored.
    
    Parameters:
    connectTimeoutMillis - the connect timeout in milliseconds. 0 to disable.
  - getMaxMessagesPerRead
```
int getMaxMessagesPerRead()
```
    Returns the maximum number of messages to read per read loop. a channelRead() event. If this value is greater than 1, an event loop might attempt to read multiple times to procure multiple messages.
  - setMaxMessagesPerRead
```
ChannelConfig setMaxMessagesPerRead(int maxMessagesPerRead)
```
    Sets the maximum number of messages to read per read loop. If this value is greater than 1, an event loop might attempt to read multiple times to procure multiple messages.
  - getWriteSpinCount
```
int getWriteSpinCount()
```
    Returns the maximum loop count for a write operation until WritableByteChannel.write(ByteBuffer) returns a non-zero value. It is similar to what a spin lock is used for in concurrency programming. It improves memory utilization and write throughput depending on the platform that JVM runs on. The default value is 16.
  - setWriteSpinCount
```
ChannelConfig setWriteSpinCount(int writeSpinCount)
```
    Sets the maximum loop count for a write operation until WritableByteChannel.write(ByteBuffer) returns a non-zero value. It is similar to what a spin lock is used for in concurrency programming. It improves memory utilization and write throughput depending on the platform that JVM runs on. The default value is 16.
    
    Throws:
    
    IllegalArgumentException - if the specified value is 0 or less than 0
  - getAllocator
```
ByteBufAllocator getAllocator()
```
    Returns ByteBufAllocator which is used for the channel to allocate buffers.
  - setAllocator
```
ChannelConfig setAllocator(ByteBufAllocator allocator)
```
    Set the ByteBufAllocator which is used for the channel to allocate buffers.
  - getRecvByteBufAllocator
```
RecvByteBufAllocator getRecvByteBufAllocator()
```
    Returns RecvByteBufAllocator which is used for the channel to allocate receive buffers.
  - setRecvByteBufAllocator
```
ChannelConfig setRecvByteBufAllocator(RecvByteBufAllocator allocator)
```
    Set the ByteBufAllocator which is used for the channel to allocate receive buffers.
  - isAutoRead
```
boolean isAutoRead()
```
    Returns true if and only if ChannelHandlerContext.read() will be invoked automatically so that a user application doesn't need to call it at all. The default value is true.
  - setAutoRead
```
ChannelConfig setAutoRead(boolean autoRead)
```
    Sets if ChannelHandlerContext.read() will be invoked automatically so that a user application doesn't need to call it at all. The default value is true.
  - getWriteBufferHighWaterMark
```
int getWriteBufferHighWaterMark()
```
    Returns the high water mark of the write buffer. If the number of bytes queued in the write buffer exceeds this value, Channel.isWritable() will start to return false.
  - setWriteBufferHighWaterMark
```
ChannelConfig setWriteBufferHighWaterMark(int writeBufferHighWaterMark)
```
    Sets the high water mark of the write buffer. If the number of bytes queued in the write buffer exceeds this value, Channel.isWritable() will start to return false.
  - getWriteBufferLowWaterMark
```
int getWriteBufferLowWaterMark()
```
    Returns the low water mark of the write buffer. Once the number of bytes queued in the write buffer exceeded the high water mark and then dropped down below this value, Channel.isWritable() will start to return true again.
  - setWriteBufferLowWaterMark
```
ChannelConfig setWriteBufferLowWaterMark(int writeBufferLowWaterMark)
```
    Sets the low water mark of the write buffer. Once the number of bytes queued in the write buffer exceeded the high water mark and then dropped down below this value, Channel.isWritable() will start to return true again.
  - getMessageSizeEstimator
```
MessageSizeEstimator getMessageSizeEstimator()
```
    Returns MessageSizeEstimator which is used for the channel to detect the size of a message.
  - setMessageSizeEstimator
```
ChannelConfig setMessageSizeEstimator(MessageSizeEstimator estimator)
```
    Set the ByteBufAllocator which is used for the channel to detect the size of a message.

Interface ChannelConfig

Option map

Method Summary

Method Detail

getOptions

setOptions

getOption

setOption

getConnectTimeoutMillis

setConnectTimeoutMillis

getMaxMessagesPerRead

setMaxMessagesPerRead

getWriteSpinCount

setWriteSpinCount

getAllocator

setAllocator

getRecvByteBufAllocator

setRecvByteBufAllocator

isAutoRead

setAutoRead

getWriteBufferHighWaterMark

setWriteBufferHighWaterMark

getWriteBufferLowWaterMark

setWriteBufferLowWaterMark

getMessageSizeEstimator

setMessageSizeEstimator