Deprecated API

Contents

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

Deprecated Interfaces

Interface and Description
io.netty.util.ResourceLeak please use ResourceLeakTracker as it may lead to false-positives.

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 DomainNameMappingBuilder instead.
io.netty.util.internal.IntegerHolder For removal in netty 4.2
io.netty.util.concurrent.PromiseAggregator Use PromiseCombiner 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

Deprecated Exceptions

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

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 Recycler.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.AbstractEventExecutorGroup.shutdown() EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or AbstractEventExecutorGroup.shutdownGracefully() instead.
io.netty.util.concurrent.MultithreadEventExecutorGroup.shutdown()
io.netty.util.concurrent.AbstractEventExecutor.shutdown() EventExecutorGroup.shutdownGracefully(long, long, TimeUnit) or AbstractEventExecutor.shutdownGracefully() instead.
io.netty.util.concurrent.GlobalEventExecutor.shutdown()
io.netty.util.concurrent.SingleThreadEventExecutor.shutdown()
io.netty.util.concurrent.ImmediateEventExecutor.shutdown()
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.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.