Deprecated API

Contents

• Terminally Deprecated
• Interfaces
• Classes
• Exception Classes
• Fields
• Methods
• Constructors

Terminally Deprecated Elements

Element	Description
org.eclipse.jetty.util.BlockingArrayQueue(int, int)	the growth factor isn't used anymore
org.eclipse.jetty.util.BlockingArrayQueue(int, int, int)	the growth factor isn't used anymore
org.eclipse.jetty.util.BlockingArrayQueue.DEFAULT_GROWTH	the growth strategy has changed and doesn't use this constant anymore.
org.eclipse.jetty.util.ClassVisibilityChecker.isServerClass(Class<?>)	use ClassVisibilityChecker.isHiddenClass(Class)
org.eclipse.jetty.util.ClassVisibilityChecker.isSystemClass(Class<?>)	use ClassVisibilityChecker.isProtectedClass(Class)
org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener	this class is redundant now that LifeCycle.Listener has default methods.
org.eclipse.jetty.util.IO.copyDir(Path, Path, CopyOption...)	use IO.copyDir(Path, Path) instead to avoid foreign target behavior across FileSystems.
org.eclipse.jetty.util.resource.PathResource.SUPPORTED_SCHEMES	Using ResourceFactoryInternals.isSupported() instead.
org.eclipse.jetty.util.resource.Resource.newReadableByteChannel()	use Resource.newInputStream() or IOResources instead.
org.eclipse.jetty.util.resource.ResourceFactory.newClassPathResource(String)	use ResourceFactory.newClassLoaderResource(String, boolean) instead, will be removed in Jetty 12.1.0
org.eclipse.jetty.util.resource.ResourceFactory.newSystemResource(String)	use ResourceFactory.newClassLoaderResource(String) or ResourceFactory.newClassLoaderResource(String, boolean) instead, will be removed in Jetty 12.1.0
org.eclipse.jetty.util.resource.ResourceFactory.of(Resource)	Use Resource.resolve(String)
org.eclipse.jetty.util.Scanner.BulkListener.filesChanged(Set<String>)	use Scanner.BulkListener.pathsChanged(Map) instead
org.eclipse.jetty.util.Scanner.BulkListener.pathsChanged(Set<Path>)	use Scanner.BulkListener.pathsChanged(Map) instead.
org.eclipse.jetty.util.security.SecurityUtils.doAs(Subject, Callable<T>)	use SecurityUtils.callAs(Subject, Callable)
org.eclipse.jetty.util.ssl.SslContextFactory.getPassword(String)	use {#link getCredential} instead.
org.eclipse.jetty.util.ssl.SslContextFactory.newPassword(String)	use {#link newCredential} instead.
org.eclipse.jetty.util.StaticException	use ConstantThrowable instead
org.eclipse.jetty.util.StringUtil.toString(byte[], int, int, String)	use String(byte[], int, int, Charset) instead
org.eclipse.jetty.util.thread.QueuedThreadPool.getAvailableReservedThreads()	use QueuedThreadPool.getCurrentReservedThreads() instead
org.eclipse.jetty.util.thread.QueuedThreadPool.getMaxAvailableThreads()	The term available can be applied to either idle or reserved threads, but not both. Use QueuedThreadPool.getCurrentReservedThreads() or QueuedThreadPool.getIdleThreads() instead.
org.eclipse.jetty.util.thread.QueuedThreadPool.getMaxLeasedThreads()	use QueuedThreadPool.getLeasedThreads()
org.eclipse.jetty.util.thread.QueuedThreadPool.getReadyThreads()	The combination of idle and reserved threads is essentially meaningless.
org.eclipse.jetty.util.thread.TimerScheduler	use ScheduledExecutorScheduler instead.
org.eclipse.jetty.util.URIUtil.correctFileURI(URI)	use URIUtil.correctURI(URI) instead, will be removed in Jetty 12.1.0
org.eclipse.jetty.util.URIUtil.split(String)	use ResourceFactory.split(String)
org.eclipse.jetty.util.UrlEncoded.decodeTo(String, MultiMap<String>, String)	use UrlEncoded.decodeTo(String, MultiMap, Charset) instead
org.eclipse.jetty.util.UrlEncoded.decodeUtf8To(InputStream, MultiMap<String>, int, int)	use UrlEncoded.decodeUtf8To(InputStream, Fields, int, int) instead.
org.eclipse.jetty.util.VirtualThreads.Configurable.isUseVirtualThreads()	use VirtualThreads.Configurable.getVirtualThreadsExecutor() instead
org.eclipse.jetty.util.VirtualThreads.Configurable.setUseVirtualThreads(boolean)	use VirtualThreads.Configurable.setVirtualThreadsExecutor(Executor) instead
org.eclipse.jetty.util.VirtualThreads.executeOnVirtualThread(Runnable)	use VirtualThreads.getVirtualThreadsExecutor(Executor) instead

Deprecated Interfaces

Interface	Description
org.eclipse.jetty.util.ClassMatcher.Constructor

Deprecated Classes

Class	Description
org.eclipse.jetty.util.AttributesMap	use Attributes.Mapped
org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener	this class is redundant now that LifeCycle.Listener has default methods.
org.eclipse.jetty.util.component.FileNoticeLifeCycleListener	use org.eclipse.jetty.server.StateLifeCycleListener instead
org.eclipse.jetty.util.SharedBlockingCallback	Use Blocker.Shared.callback()
org.eclipse.jetty.util.thread.TimerScheduler	use ScheduledExecutorScheduler instead.

Deprecated Exception Classes

Exception Class	Description
org.eclipse.jetty.util.StaticException	use ConstantThrowable instead

Deprecated Fields

Field	Description
org.eclipse.jetty.util.BlockingArrayQueue.DEFAULT_GROWTH	the growth strategy has changed and doesn't use this constant anymore.
org.eclipse.jetty.util.resource.PathResource.SUPPORTED_SCHEMES	Using ResourceFactoryInternals.isSupported() instead.

Deprecated Methods

Method	Description
org.eclipse.jetty.util.ClassMatcher.wrap(ClassMatcher, ClassMatcher.Constructor<T>)	use ClassMatcher directly.
org.eclipse.jetty.util.ClassVisibilityChecker.isServerClass(Class<?>)	use ClassVisibilityChecker.isHiddenClass(Class)
org.eclipse.jetty.util.ClassVisibilityChecker.isSystemClass(Class<?>)	use ClassVisibilityChecker.isProtectedClass(Class)
org.eclipse.jetty.util.IO.copyDir(Path, Path, CopyOption...)	use IO.copyDir(Path, Path) instead to avoid foreign target behavior across FileSystems.
org.eclipse.jetty.util.resource.Resource.newReadableByteChannel()	use Resource.newInputStream() or IOResources instead.
org.eclipse.jetty.util.resource.ResourceFactory.newClassPathResource(String)	use ResourceFactory.newClassLoaderResource(String, boolean) instead, will be removed in Jetty 12.1.0
org.eclipse.jetty.util.resource.ResourceFactory.newSystemResource(String)	use ResourceFactory.newClassLoaderResource(String) or ResourceFactory.newClassLoaderResource(String, boolean) instead, will be removed in Jetty 12.1.0
org.eclipse.jetty.util.resource.ResourceFactory.of(Resource)	Use Resource.resolve(String)
org.eclipse.jetty.util.Scanner.BulkListener.filesChanged(Set<String>)	use Scanner.BulkListener.pathsChanged(Map) instead
org.eclipse.jetty.util.Scanner.BulkListener.pathsChanged(Set<Path>)	use Scanner.BulkListener.pathsChanged(Map) instead.
org.eclipse.jetty.util.security.SecurityUtils.doAs(Subject, Callable<T>)	use SecurityUtils.callAs(Subject, Callable)
org.eclipse.jetty.util.ssl.SslContextFactory.getPassword(String)	use {#link getCredential} instead.
org.eclipse.jetty.util.ssl.SslContextFactory.newPassword(String)	use {#link newCredential} instead.
org.eclipse.jetty.util.ssl.SslContextFactory.processIncludeCipherSuites(String[], List<String>)	no replacement
org.eclipse.jetty.util.ssl.SslContextFactory.removeExcludedCipherSuites(List<String>)	no replacement
org.eclipse.jetty.util.StringUtil.endsWithIgnoreCase(String, String)	Use StringUtil.asciiEndsWithIgnoreCase(String, String)
org.eclipse.jetty.util.StringUtil.startsWithIgnoreCase(String, String)	Use StringUtil.asciiEndsWithIgnoreCase(String, String)
org.eclipse.jetty.util.StringUtil.toString(byte[], int, int, String)	use String(byte[], int, int, Charset) instead
org.eclipse.jetty.util.thread.QueuedThreadPool.getAvailableReservedThreads()	use QueuedThreadPool.getCurrentReservedThreads() instead
org.eclipse.jetty.util.thread.QueuedThreadPool.getMaxAvailableThreads()	The term available can be applied to either idle or reserved threads, but not both. Use QueuedThreadPool.getCurrentReservedThreads() or QueuedThreadPool.getIdleThreads() instead.
org.eclipse.jetty.util.thread.QueuedThreadPool.getMaxLeasedThreads()	use QueuedThreadPool.getLeasedThreads()
org.eclipse.jetty.util.thread.QueuedThreadPool.getReadyThreads()	The combination of idle and reserved threads is essentially meaningless.
org.eclipse.jetty.util.thread.ReservedThreadExecutor.getPending()
org.eclipse.jetty.util.URIUtil.appendSchemeHostPort(StringBuffer, String, String, int)	Use URIUtil.appendSchemeHostPort(StringBuilder, String, String, int)
org.eclipse.jetty.util.URIUtil.correctFileURI(URI)	use URIUtil.correctURI(URI) instead, will be removed in Jetty 12.1.0
org.eclipse.jetty.util.URIUtil.split(String)	use ResourceFactory.split(String)
org.eclipse.jetty.util.URIUtil.toURI(String)	This method is currently resolving relative paths against the current directory, which is a mechanism that should be implemented by a ResourceFactory. All calls to this method need to be reviewed.
org.eclipse.jetty.util.UrlEncoded.decodeTo(String, MultiMap<String>, String)	use UrlEncoded.decodeTo(String, MultiMap, Charset) instead
org.eclipse.jetty.util.UrlEncoded.decodeUtf8To(InputStream, MultiMap<String>, int, int)	use UrlEncoded.decodeUtf8To(InputStream, Fields, int, int) instead.
org.eclipse.jetty.util.UrlEncoded.decodeUtf8To(String, int, int, MultiMap<String>)	use UrlEncoded.decodeUtf8To(String, int, int, Fields) instead.
org.eclipse.jetty.util.UrlEncoded.decodeUtf8To(String, MultiMap<String>)	use UrlEncoded.decodeUtf8To(String, Fields) instead.
org.eclipse.jetty.util.VirtualThreads.Configurable.isUseVirtualThreads()	use VirtualThreads.Configurable.getVirtualThreadsExecutor() instead
org.eclipse.jetty.util.VirtualThreads.Configurable.setUseVirtualThreads(boolean)	use VirtualThreads.Configurable.setVirtualThreadsExecutor(Executor) instead
org.eclipse.jetty.util.VirtualThreads.executeOnVirtualThread(Runnable)	use VirtualThreads.getVirtualThreadsExecutor(Executor) instead

Deprecated Constructors

Constructor	Description
org.eclipse.jetty.util.BlockingArrayQueue(int, int)	the growth factor isn't used anymore
org.eclipse.jetty.util.BlockingArrayQueue(int, int, int)	the growth factor isn't used anymore