Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
io.netty.util.ResourceLeak please use ResourceLeakTracker as it may lead to false-positives.
io.netty.util.concurrent.SingleThreadEventExecutor.NonWakeupRunnable use AbstractEventExecutor.LazyRunnable

Deprecated Classes

Class and Description
io.netty.util.internal.logging.CommonsLoggerFactory Please use Log4J2LoggerFactory or Log4JLoggerFactory or Slf4JLoggerFactory.
io.netty.util.internal.ConcurrentSet For removal in Netty 4.2. Please use ConcurrentHashMap#newKeySet() instead
io.netty.util.DomainMappingBuilder Use DomainWildcardMappingBuilder instead.
io.netty.util.DomainNameMapping Use DomainWildcardMappingBuilder}
io.netty.util.DomainNameMappingBuilder Use DomainWildcardMappingBuilder
io.netty.util.internal.IntegerHolder For removal in netty 4.2
io.netty.util.concurrent.PromiseAggregator Use PromiseCombiner.PromiseCombiner(EventExecutor). GenericFutureListener implementation which consolidates multiple Futures into one, by listening to individual Futures and producing an aggregated result (success/failure) when all Futures have completed.
io.netty.util.ThreadDeathWatcher will be removed in the next major release
io.netty.util.concurrent.UnaryPromiseNotifier use PromiseNotifier.cascade(boolean, Future, Promise).

Deprecated Exceptions

Exceptions and Description
io.netty.util.ResourceLeakException This class will be removed in the future version.

Deprecated Fields

Field and Description
io.netty.util.internal.InternalThreadLocalMap.rp1 These padding fields will be removed in the future.
io.netty.util.internal.InternalThreadLocalMap.rp2 These padding fields will be removed in the future.
io.netty.util.internal.InternalThreadLocalMap.rp3 These padding fields will be removed in the future.
io.netty.util.internal.InternalThreadLocalMap.rp4 These padding fields will be removed in the future.
io.netty.util.internal.InternalThreadLocalMap.rp5 These padding fields will be removed in the future.
io.netty.util.internal.InternalThreadLocalMap.rp6 These padding fields will be removed in the future.
io.netty.util.internal.InternalThreadLocalMap.rp7 These padding fields will be removed in the future.
io.netty.util.internal.InternalThreadLocalMap.rp8 These padding fields will be removed in the future.

Deprecated Methods

Method and Description
io.netty.util.concurrent.PromiseCombiner.add(Promise) Replaced by PromiseCombiner.add(Future).
io.netty.util.DomainNameMapping.add(String, V) use DomainNameMappingBuilder to create and fill the mapping instead
io.netty.util.concurrent.PromiseCombiner.addAll(Promise...) Replaced by PromiseCombiner.addAll(Future[])
io.netty.util.internal.InternalThreadLocalMap.counterHashCode()
io.netty.util.Attribute.getAndRemove() please consider using Attribute.getAndSet(Object) (with value of null).
io.netty.util.CharsetUtil.getDecoder(Charset) Use CharsetUtil.decoder(Charset).
io.netty.util.CharsetUtil.getEncoder(Charset) Use CharsetUtil.encoder(Charset).
io.netty.util.ResourceLeakDetectorFactory.newResourceLeakDetector(Class<T>, int, long) Use ResourceLeakDetectorFactory.newResourceLeakDetector(Class, int) instead. Returns a new instance of a ResourceLeakDetector with the given resource class.
io.netty.util.concurrent.SingleThreadEventExecutor.newTaskQueue() Please use and override SingleThreadEventExecutor.newTaskQueue(int).
io.netty.util.ConstantPool.nextId()
io.netty.util.ResourceLeakDetector.open(T) use ResourceLeakDetector.track(Object)
io.netty.util.Recycler.recycle(T, Recycler.Handle<T>) use ObjectPool.Handle.recycle(Object).
io.netty.util.ReferenceCountUtil.releaseLater(T) this may introduce a lot of memory usage so it is generally preferable to manually release objects.
io.netty.util.ReferenceCountUtil.releaseLater(T, int) this may introduce a lot of memory usage so it is generally preferable to manually release objects.
io.netty.util.Attribute.remove() please consider using Attribute.set(Object) (with value of null).
io.netty.util.ResourceLeakDetector.reportInstancesLeak(String) This method will no longer be invoked by ResourceLeakDetector.
io.netty.util.internal.InternalThreadLocalMap.setCounterHashCode(IntegerHolder)
io.netty.util.ResourceLeakDetector.setEnabled(boolean) Use ResourceLeakDetector.setLevel(Level) instead.
io.netty.util.concurrent.ImmediateEventExecutor.shutdown()
io.netty.util.concurrent.AbstractEventExecutorGroup.shutdown() EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or AbstractEventExecutorGroup.shutdownGracefully() instead.
io.netty.util.concurrent.GlobalEventExecutor.shutdown()
io.netty.util.concurrent.MultithreadEventExecutorGroup.shutdown()
io.netty.util.concurrent.SingleThreadEventExecutor.shutdown()
io.netty.util.concurrent.AbstractEventExecutor.shutdown() EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or AbstractEventExecutor.shutdownGracefully() instead.
io.netty.util.concurrent.EventExecutorGroup.shutdown() EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or EventExecutorGroup.shutdownGracefully() instead.
io.netty.util.concurrent.AbstractEventExecutorGroup.shutdownNow() EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or AbstractEventExecutorGroup.shutdownGracefully() instead.
io.netty.util.concurrent.AbstractEventExecutor.shutdownNow() EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or AbstractEventExecutor.shutdownGracefully() instead.
io.netty.util.concurrent.EventExecutorGroup.shutdownNow() EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or EventExecutorGroup.shutdownGracefully() instead.
io.netty.util.concurrent.AbstractScheduledEventExecutor.validateScheduled(long, TimeUnit) will be removed in the future.

Deprecated Constructors

Constructor and Description
io.netty.util.internal.logging.CommonsLoggerFactory() Use CommonsLoggerFactory.INSTANCE instead.
io.netty.util.DomainNameMapping(int, V) use DomainNameMappingBuilder to create and fill the mapping instead
io.netty.util.DomainNameMapping(V) use DomainNameMappingBuilder to create and fill the mapping instead
io.netty.util.internal.logging.JdkLoggerFactory() Use JdkLoggerFactory.INSTANCE instead.
io.netty.util.internal.logging.Log4J2LoggerFactory() Use Log4J2LoggerFactory.INSTANCE instead.
io.netty.util.internal.logging.Log4JLoggerFactory() Use Log4JLoggerFactory.INSTANCE instead.
io.netty.util.concurrent.PromiseCombiner()
io.netty.util.Recycler(int, int) Use one of the following instead: Recycler.Recycler(), Recycler.Recycler(int), Recycler.Recycler(int, int, int).
io.netty.util.Recycler(int, int, int, int) Use one of the following instead: Recycler.Recycler(), Recycler.Recycler(int), Recycler.Recycler(int, int, int).
io.netty.util.Recycler(int, int, int, int, int) Use one of the following instead: Recycler.Recycler(), Recycler.Recycler(int), Recycler.Recycler(int, int, int).
io.netty.util.ResourceLeakDetector(Class<?>) use ResourceLeakDetectorFactory.newResourceLeakDetector(Class, int, long).
io.netty.util.ResourceLeakDetector(Class<?>, int, long) Use ResourceLeakDetector.ResourceLeakDetector(Class, int). This should not be used directly by users of ResourceLeakDetector. Please use ResourceLeakDetectorFactory.newResourceLeakDetector(Class) or ResourceLeakDetectorFactory.newResourceLeakDetector(Class, int, long)
io.netty.util.ResourceLeakDetector(String) use ResourceLeakDetectorFactory.newResourceLeakDetector(Class, int, long).
io.netty.util.ResourceLeakDetector(String, int, long) use ResourceLeakDetectorFactory.newResourceLeakDetector(Class, int, long).
io.netty.util.internal.logging.Slf4JLoggerFactory() Use Slf4JLoggerFactory.INSTANCE instead.