Deprecated API
Contents
-
Terminally Deprecated ElementsElementDescriptionuse
HttpClient.getHttpClientTransport()insteaduseEncoderConfig.getBufferSize()orDecoderConfig.getBufferSize()instead.useEncoderConfig.setBufferSize(int)orDecoderConfig.setBufferSize(int)instead.useDeploymentScanner.getWebappsDirectories()insteaduseServletApiRequest.getAuthenticationState()instead.UseServletContextHandler.ENVIRONMENTinstead.UseCrossOriginHandlerinsteaduse coreCachingWebAppClassLoaderinsteadUse org.eclipse.jetty.util.ClassMatcheruseConfiguration.getHiddenClasses()insteaduseConfiguration.getProtectedClasses()insteaduse the coreWebAppClassLoaderdirectly instead.useWebAppClassLoading.HIDDEN_CLASSES_ATTRIBUTEinstead.useWebAppClassLoading.PROTECTED_CLASSES_ATTRIBUTEinstead.no direct replacement, use ofMetaData.getXmlParser()is encouraged.useMetaData.getXmlParser()to control parser behavior.useMetaData.getXmlParser()to control parser behavior.this method is no longer usedthis method is no longer neededUseServletContextHandler.ENVIRONMENTinstead.UseCrossOriginHandlerinsteaduse coreCachingWebAppClassLoaderinsteaduseWebAppClassLoading.HIDDEN_CLASSES_ATTRIBUTEinstead.useWebAppClassLoading.PROTECTED_CLASSES_ATTRIBUTEinstead.no direct replacement, use ofMetaData.getXmlParser()is encouraged.useMetaData.getXmlParser()to control parser behavior.useMetaData.getXmlParser()to control parser behavior.this method is no longer usedthis method is no longer neededuseCompactPathRulewithRewriteHandlerinstead. Will be removed from ee10 onwards.useCompactPathRulewithRewriteHandlerinstead. Will be removed from ee10 onwards.Interceptor has been removed with no replacement in the EE10 or later implementationsReplaced byMultiPartFormInputStream. This code is slower and subject to more bugs than its replacementMultiPartFormInputStream. However, this class accepts non-compliant RFC formats that the newMultiPartFormInputStreamdoes not accept. This class is unavailable on ee10 and newer environments.UseCrossOriginHandlerinsteaduse coreCachingWebAppClassLoaderinsteaduse the coreWebAppClassLoaderdirectly instead.useWebAppClassLoading.HIDDEN_CLASSES_ATTRIBUTEinstead.useWebAppClassLoading.PROTECTED_CLASSES_ATTRIBUTEinstead.no direct replacement, use ofMetaData.getXmlParser()is encouraged.useMetaData.getXmlParser()to control parser behavior.useMetaData.getXmlParser()to control parser behavior.useCompactPathRulewithRewriteHandlerinstead. Will be removed from ee10 onwards.useCompactPathRulewithRewriteHandlerinstead. Will be removed from ee10 onwards.Interceptor has been removed with no replacement in the EE10 or later implementationsReplaced byMultiPartFormInputStream. This code is slower and subject to more bugs than its replacementMultiPartFormInputStream. However, this class accepts non-compliant RFC formats that the newMultiPartFormInputStreamdoes not accept. This class is unavailable on ee10 and newer environments.UseCrossOriginHandlerinsteaduse coreCachingWebAppClassLoaderinsteaduse the coreWebAppClassLoaderdirectly instead.useWebAppClassLoading.HIDDEN_CLASSES_ATTRIBUTEinstead.useWebAppClassLoading.PROTECTED_CLASSES_ATTRIBUTEinstead.no direct replacement, use ofMetaData.getXmlParser()is encouraged.useMetaData.getXmlParser()to control parser behavior.useMetaData.getXmlParser()to control parser behavior.useHttpExceptionno replacementUseorg.eclipse.jetty.server.CookieCacheUseCookieCompliance.Violation.SPECIAL_CHARS_IN_QUOTESinstead.no replacement because was mistakenly considered a violationuseHttpDateTimeinsteaduseHttpDateTime.parseToEpoch(String)insteaduseComplianceViolation.CapturingListener.VIOLATIONS_ATTR_KEYinstead.
(Note: new ATTR captures all Compliance violations, not just HTTP.
Make sure you haveHttpConnectionFactory.setRecordHttpComplianceViolations(true).
Also make sure that aComplianceViolation.CapturingListenerhas been added as a bean to either theConnectororServerfor the Attribute to be created.)use non-staticHttpField.containsLast(String)instead.useHttpFields.build(HttpCompliance, Supplier)instead.overrideMultiPart.Part.newContentSource(ByteBufferPool.Sized, long, long)instead.useMultiPartFormData.getParts(Attributes)insteaduseQuotedCSVinsteaduseQuotedQualityCSVinsteadNo replacement, never used.No replacement, never used.useContent.Source.asByteBuffer(Source, Promise)insteadno replacementno replacementinstances of this class can only be created by the implementationUseOpenIdConfiguration.Builderinstead.UseOpenIdConfiguration.Builderinstead.UseOpenIdConfiguration.Builderinstead.UseOpenIdConfiguration.Builderinstead.useOpenIdConfiguration.Builderto configure the OpenID Configuration.useOpenIdConfiguration.getAuthorizationEndpoint()instead.useOpenIdConfiguration.Builderto configure the OpenID Configuration.useOpenIdConfiguration.Builderto configure the OpenID Configuration.useComponents.getExecutor()insteaduseNetworkConnectionLimitinsteadno replacement.no longer used. see DeploymentScanner EnvironmentConfig for new location.no longer used byDeployable.initializeDefaults(Attributes), functionality still exists in properties files, but is now managed by DeploymentScanner.no longer used byDeployable.initializeDefaults(Attributes), functionality exists as a${jetty.base}/environments/*.xmlfeature instead.useFormFields.onFields(Request, Promise.Invocable)instead.useFormFields.getFields(Request)instead.do not use it, no replacement.Do not override. No longer invoked by Jetty.use the newCompressionHandleravailable inorg.eclipse.jetty.compression:jetty-compression-serverwith your choice of compression implementation (gzip isorg.eclipse.jetty.compression:jetty-compression-gzip, brotli isorg.eclipse.jetty.compression:jetty-compression-brotli, and zstandard isorg.eclipse.jetty.compression:jetty-compression-zstandard)UseEagerContentHandlerinstead.useRequest.onParameters(Request, Promise.Invocable)instead.Replaced withShutdownServicecomponent, which is not a singleton.No replacement.No replacement.No direct replacement, seeShutdownService, which is not a singleton.No replacement.No replacement.No replacement, use SLF4J Logger at nameShutdownServiceNo replacement.No replacement.No replacement.useSizeLimitHandlerinstead.the growth factor isn't used anymorethe growth factor isn't used anymorethe growth strategy has changed and doesn't use this constant anymore.this class is redundant now thatLifeCycle.Listenerhas default methods.useIO.asPath(Object)instead to have proper conversion of various path syntaxes across JVMs, Architectures, and OSs.useIO.copyDir(Path, Path)instead to avoid foreign target behavior across FileSystems.Using ResourceFactoryInternals.isSupported() instead.useResource.newInputStream()orIOResourcesinstead.useResourceFactory.newClassLoaderResource(String, boolean)instead, will be removed in Jetty 12.1.0useResourceFactory.newClassLoaderResource(String)orResourceFactory.newClassLoaderResource(String, boolean)instead, will be removed in Jetty 12.1.0useScanner.BulkListener.pathsChanged(Map)insteaduseScanner.BulkListener.pathsChanged(Map)instead.use {#link getCredential} instead.use {#link newCredential} instead.useConstantThrowableinsteaduseString(byte[], int, int, Charset)insteaduseQueuedThreadPool.getCurrentReservedThreads()insteadThe term available can be applied to either idle or reserved threads, but not both. UseQueuedThreadPool.getCurrentReservedThreads()orQueuedThreadPool.getIdleThreads()instead.The combination of idle and reserved threads is essentially meaningless.useScheduledExecutorSchedulerinstead.useVirtualThreadPool.getMaxConcurrentTasks()insteaduseVirtualThreadPool.setMaxConcurrentTasks(int)insteadno replacement, will be removed, functionality moved to theServerclass.useURIUtil.correctURI(URI)instead, will be removed in Jetty 12.1.0useUrlEncoded.decodeTo(String, MultiMap, Charset)insteaduseClientUpgradeRequest(URI)instead.there is no alternative intended to publicly construct aJettyWebSocketFrame.
-
Deprecated InterfacesInterfaceDescriptionInterceptor has been removed with no replacement in the EE10 or later implementationsInterceptor has been removed with no replacement in the EE10 or later implementations
-
Deprecated ClassesClassDescriptionUse
CrossOriginHandlerinsteaduseQoSHandlerinstead.use coreCachingWebAppClassLoaderinsteadUse org.eclipse.jetty.util.ClassMatcheruse the coreWebAppClassLoaderdirectly instead.UseCrossOriginHandlerinsteaduseQoSHandlerinstead.use coreCachingWebAppClassLoaderinsteadThis class is no longer required as ERROR dispatch is only done if there is an error page target.Replaced byMultiPartFormInputStream. This code is slower and subject to more bugs than its replacementMultiPartFormInputStream. However, this class accepts non-compliant RFC formats that the newMultiPartFormInputStreamdoes not accept. This class is unavailable on ee10 and newer environments.UseCrossOriginHandlerinsteaduseQoSHandlerinstead.use coreCachingWebAppClassLoaderinsteaduse the coreWebAppClassLoaderdirectly instead.This class is no longer required as ERROR dispatch is only done if there is an error page target.Replaced byMultiPartFormInputStream. This code is slower and subject to more bugs than its replacementMultiPartFormInputStream. However, this class accepts non-compliant RFC formats that the newMultiPartFormInputStreamdoes not accept. This class is unavailable on ee10 and newer environments.UseCrossOriginHandlerinsteaduseQoSHandlerinstead.use coreCachingWebAppClassLoaderinsteaduse the coreWebAppClassLoaderdirectly instead.Useorg.eclipse.jetty.server.CookieCacheuseHttpDateTimeinsteaduseQuotedCSVinsteaduseQuotedQualityCSVinsteadNo replacement, never used.No replacement, never used.useNetworkConnectionLimitinsteadUseHandler.Abstractuse the newCompressionHandleravailable inorg.eclipse.jetty.compression:jetty-compression-serverwith your choice of compression implementation (gzip isorg.eclipse.jetty.compression:jetty-compression-gzip, brotli isorg.eclipse.jetty.compression:jetty-compression-brotli, and zstandard isorg.eclipse.jetty.compression:jetty-compression-zstandard)UseDetectorConnectionFactorywith aSslConnectionFactoryinstead.Replaced withShutdownServicecomponent, which is not a singleton.useSizeLimitHandlerinstead.this class is redundant now thatLifeCycle.Listenerhas default methods.useorg.eclipse.jetty.server.StateLifeCycleListenerinsteaduseScheduledExecutorSchedulerinstead.no replacement, will be removed, functionality moved to theServerclass.
-
Deprecated Enum Classes
-
Deprecated Exceptions
-
Deprecated FieldsFieldDescriptionUse
ServletContextHandler.ENVIRONMENTinstead.useWebAppClassLoading.HIDDEN_CLASSES_ATTRIBUTEinstead.useWebAppClassLoading.PROTECTED_CLASSES_ATTRIBUTEinstead.no direct replacement, use ofMetaData.getXmlParser()is encouraged.UseServletContextHandler.ENVIRONMENTinstead.useWebAppClassLoading.HIDDEN_CLASSES_ATTRIBUTEinstead.useWebAppClassLoading.PROTECTED_CLASSES_ATTRIBUTEinstead.no direct replacement, use ofMetaData.getXmlParser()is encouraged.useWebAppClassLoading.HIDDEN_CLASSES_ATTRIBUTEinstead.useWebAppClassLoading.PROTECTED_CLASSES_ATTRIBUTEinstead.no direct replacement, use ofMetaData.getXmlParser()is encouraged.useWebAppClassLoading.HIDDEN_CLASSES_ATTRIBUTEinstead.useWebAppClassLoading.PROTECTED_CLASSES_ATTRIBUTEinstead.no direct replacement, use ofMetaData.getXmlParser()is encouraged.useComplianceViolation.CapturingListener.VIOLATIONS_ATTR_KEYinstead.
(Note: new ATTR captures all Compliance violations, not just HTTP.
Make sure you haveHttpConnectionFactory.setRecordHttpComplianceViolations(true).
Also make sure that aComplianceViolation.CapturingListenerhas been added as a bean to either theConnectororServerfor the Attribute to be created.)no replacement.no longer used. see DeploymentScanner EnvironmentConfig for new location.no longer used byDeployable.initializeDefaults(Attributes), functionality still exists in properties files, but is now managed by DeploymentScanner.no longer used byDeployable.initializeDefaults(Attributes), functionality exists as a${jetty.base}/environments/*.xmlfeature instead.the growth strategy has changed and doesn't use this constant anymore.Using ResourceFactoryInternals.isSupported() instead.
-
Deprecated MethodsMethodDescriptionuse
AnnotationParser.parseClass(Set, Resource, Resource)instead (which usesResourceinstead ofPath)useHttpClient.getHttpClientTransport()insteaduseEncoderConfig.getBufferSize()orDecoderConfig.getBufferSize()instead.useEncoderConfig.setBufferSize(int)orDecoderConfig.setBufferSize(int)instead.useDeploymentScanner.getWebappsDirectories()insteaduseServletApiRequest.getAuthenticationState()instead.User ID no longer supportedPriority no longer supportedSession tracking is no longer supportedSession tracking is no longer supporteduseConfiguration.getHiddenClasses()insteaduseConfiguration.getProtectedClasses()insteaduseMetaData.getXmlParser()to control parser behavior.useMetaData.getXmlParser()to control parser behavior.this method is no longer usedthis method is no longer neededUser ID no longer supportedPriority no longer supportedSession tracking is no longer supportedSession tracking is no longer supporteduseMetaData.getXmlParser()to control parser behavior.useMetaData.getXmlParser()to control parser behavior.this method is no longer usedthis method is no longer neededuse #getBaseResource()useCompactPathRulewithRewriteHandlerinstead. Will be removed from ee10 onwards.useCompactPathRulewithRewriteHandlerinstead. Will be removed from ee10 onwards.use #setBaseResourceuseErrorHandler.isShowMessageInTitle()insteaduseInetAccessHandler.include(String)instead.useInetAccessHandler.include(String)instead.useInetAccessHandler.include(String)instead.useInetAccessHandler.include(String)instead.no replacement provideduse getParts().isEmpty()no replacement provided.no replacement offered.no replacement offered.UseServletHandler.getMatchedServlet(String)insteaduseServletHandler.getMatchedServlet(String)insteadUser ID no longer supportedPriority no longer supportedSession tracking is no longer supportedSession tracking is no longer supporteduseMetaData.getXmlParser()to control parser behavior.useMetaData.getXmlParser()to control parser behavior.use #getBaseResource()useCompactPathRulewithRewriteHandlerinstead. Will be removed from ee10 onwards.useCompactPathRulewithRewriteHandlerinstead. Will be removed from ee10 onwards.use #setBaseResourceuseErrorHandler.isShowMessageInTitle()insteaduseInetAccessHandler.include(String)instead.useInetAccessHandler.include(String)instead.useInetAccessHandler.include(String)instead.useInetAccessHandler.include(String)instead.no replacement provideduse getParts().isEmpty()no replacement provided.no replacement offered.no replacement offered.UseServletHandler.getMatchedServlet(String)insteaduseServletHandler.getMatchedServlet(String)insteadUser ID no longer supportedPriority no longer supportedSession tracking is no longer supportedSession tracking is no longer supporteduseMetaData.getXmlParser()to control parser behavior.useMetaData.getXmlParser()to control parser behavior.no replacementuseHttpDateTime.parseToEpoch(String)insteaduse non-staticHttpField.containsLast(String)instead.useHttpField.getValueParameters(String, Map)insteaduseHttpFields.build(HttpCompliance, Supplier)instead.overrideMultiPart.Part.newContentSource(ByteBufferPool.Sized, long, long)instead.useMultiPartFormData.getParts(Attributes)insteadusePathSpec.matched(String)insteadusePathSpec.matched(String)insteaduseServletPathSpec.matched(String)#MatchedPath.getPathInfo()instead.useSession.getLocalSocketAddress()insteaduseSession.getRemoteSocketAddress()insteaduseContent.Source.asByteBuffer(Source, Promise)insteadno replacementno replacementuseOpenIdConfiguration.Builderto configure the OpenID Configuration.useOpenIdConfiguration.getAuthorizationEndpoint()instead.useOpenIdConfiguration.Builderto configure the OpenID Configuration.useOpenIdConfiguration.Builderto configure the OpenID Configuration.useComponents.getExecutor()insteaduseFormFields.onFields(Request, Promise.Invocable)instead.useFormFields.getFields(Request)instead.do not use it, no replacement.Do not override. No longer invoked by Jetty.OverrideEventsHandler.onComplete(Request, int, HttpFields, Throwable)instead.useStatisticsHandler.getRequestTotal()instead.UseEagerContentHandlerinstead.useRequest.onParameters(Request, Promise.Invocable)instead.No replacement.No replacement.No direct replacement, seeShutdownService, which is not a singleton.No replacement.No replacement.No replacement, use SLF4J Logger at nameShutdownServiceNo replacement.No replacement.No replacement.useClassMatcherdirectly.useIO.asPath(Object)instead to have proper conversion of various path syntaxes across JVMs, Architectures, and OSs.useIO.copyDir(Path, Path)instead to avoid foreign target behavior across FileSystems.useResource.newInputStream()orIOResourcesinstead.useResourceFactory.newClassLoaderResource(String, boolean)instead, will be removed in Jetty 12.1.0useResourceFactory.newClassLoaderResource(String)orResourceFactory.newClassLoaderResource(String, boolean)instead, will be removed in Jetty 12.1.0useScanner.BulkListener.pathsChanged(Map)insteaduseScanner.BulkListener.pathsChanged(Map)instead.use {#link getCredential} instead.use {#link newCredential} instead.no replacementno replacementuseString(byte[], int, int, Charset)insteaduseQueuedThreadPool.getCurrentReservedThreads()insteadThe term available can be applied to either idle or reserved threads, but not both. UseQueuedThreadPool.getCurrentReservedThreads()orQueuedThreadPool.getIdleThreads()instead.The combination of idle and reserved threads is essentially meaningless.useVirtualThreadPool.getMaxConcurrentTasks()insteaduseVirtualThreadPool.setMaxConcurrentTasks(int)insteaduseURIUtil.correctURI(URI)instead, will be removed in Jetty 12.1.0useUrlEncoded.decodeTo(String, MultiMap, Charset)insteaduseUrlEncoded.decodeUtf8To(String, int, int, Fields)instead.useUrlEncoded.decodeUtf8To(String, Fields)instead.useWebSocketConnection.getLocalSocketAddress()insteaduseWebSocketConnection.getRemoteSocketAddress()instead
-
Deprecated ConstructorsConstructorDescriptionuse
ClientUpgradeRequest()instead.useClientUpgradeRequest()instead.instances of this class can only be created by the implementationUseOpenIdConfiguration.Builderinstead.UseOpenIdConfiguration.Builderinstead.UseOpenIdConfiguration.Builderinstead.UseOpenIdConfiguration.Builderinstead.the growth factor isn't used anymorethe growth factor isn't used anymoreuseClientUpgradeRequest(URI)instead.there is no alternative intended to publicly construct aJettyWebSocketFrame.
-
Deprecated Enum ConstantsEnum ConstantDescriptionUse
CookieCompliance.Violation.SPECIAL_CHARS_IN_QUOTESinstead.no replacement because was mistakenly considered a violation
AnnotationParser.parseClass(Set, Resource, Resource)instead (which usesResourceinstead ofPath)