Package io.micronaut.http.server.netty.configuration

Class NettyHttpServerConfiguration.EventLoopConfig

java.lang.Object
io.micronaut.http.server.netty.configuration.NettyHttpServerConfiguration.EventLoopConfig
All Implemented Interfaces:
Named, EventLoopGroupConfiguration
Direct Known Subclasses:
NettyHttpServerConfiguration.Parent, NettyHttpServerConfiguration.Worker
Enclosing class:
NettyHttpServerConfiguration
public abstract static class NettyHttpServerConfiguration.EventLoopConfig extends Object implements EventLoopGroupConfiguration
Abstract class for configuring the Netty event loop.

  • Method Details

    • getName

      @NonNull public @NonNull String getName()
      Specified by:
      getName in interface Named
      Returns:
      The name of the component

    • setEventLoopGroup

      public void setEventLoopGroup(String name)
      Sets the name to use.
      Parameters:
      name - The name

    • setThreads

      public void setThreads(int threads)
      Sets the number of threads for the event loop group.
      Parameters:
      threads - The number of threads

    • setIoRatio

      public void setIoRatio(Integer ioRatio)
      Sets the I/O ratio.
      Parameters:
      ioRatio - The I/O ratio

    • setExecutor

      public void setExecutor(String executor)
      A named executor service to use for event loop threads (optional). This property is very specialized. In particular, it will not solve read timeouts or fix blocking operations on the event loop, in fact it may do the opposite. Don't use unless you really know what this does.
      Parameters:
      executor - The executor

    • setPreferNativeTransport

      public void setPreferNativeTransport(boolean preferNativeTransport)
      Parameters:
      preferNativeTransport - Set whether to prefer the native transport if available

    • setShutdownQuietPeriod

      public void setShutdownQuietPeriod(Duration shutdownQuietPeriod)
      Parameters:
      shutdownQuietPeriod - Set the shutdown quiet period

    • setShutdownTimeout

      public void setShutdownTimeout(Duration shutdownTimeout)
      Parameters:
      shutdownTimeout - Set the shutdown timeout (must be >= shutdownQuietPeriod)

    • getNumOfThreads

      public int getNumOfThreads()
      Returns:
      The number of threads to use

    • getIoRatio

      public Optional<Integer> getIoRatio()
      Specified by:
      getIoRatio in interface EventLoopGroupConfiguration
      Returns:
      The I/O ratio to use

    • getExecutorName

      public Optional<String> getExecutorName()
      Specified by:
      getExecutorName in interface EventLoopGroupConfiguration
      Returns:
      The name of the configured executor to use

    • getNumThreads

      public int getNumThreads()
      Specified by:
      getNumThreads in interface EventLoopGroupConfiguration
      Returns:
      The number of threads for the event loop, or 0 to use EventLoopGroupConfiguration.getThreadCoreRatio()

    • getThreadCoreRatio

      public double getThreadCoreRatio()
      Description copied from interface: EventLoopGroupConfiguration
      The number of threads per core to use if EventLoopGroupConfiguration.getNumThreads() is set to 0.
      Specified by:
      getThreadCoreRatio in interface EventLoopGroupConfiguration
      Returns:
      The thread-to-core ratio

    • setThreadCoreRatio

      public void setThreadCoreRatio(double threadCoreRatio)
      The number of threads per core to use if getNumThreads() is set to 0.
      Parameters:
      threadCoreRatio - The thread-to-core ratio
      Since:
      4.8.0

    • isPreferNativeTransport

      public boolean isPreferNativeTransport()
      Specified by:
      isPreferNativeTransport in interface EventLoopGroupConfiguration
      Returns:
      Whether to prefer the native transport

    • getShutdownQuietPeriod

      public Duration getShutdownQuietPeriod()
      Specified by:
      getShutdownQuietPeriod in interface EventLoopGroupConfiguration
      Returns:
      The shutdown quiet period

    • getShutdownTimeout

      public Duration getShutdownTimeout()
      Specified by:
      getShutdownTimeout in interface EventLoopGroupConfiguration
      Returns:
      The shutdown timeout (must be >= shutdownQuietPeriod)

    • isLoomCarrier

      public boolean isLoomCarrier()
      Specified by:
      isLoomCarrier in interface EventLoopGroupConfiguration
      Returns:
      When set to true, use a special experimental event loop that can also execute virtual threads, in order to improve virtual thread performance.

    • setLoomCarrier

      public void setLoomCarrier(boolean loomCarrier)
      Parameters:
      loomCarrier - When set to true, use a special experimental event loop that can also execute virtual threads, in order to improve virtual thread performance.