Deprecated API

Contents

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

Terminally Deprecated Elements

Element	Description
io.undertow.security.api.SecurityContext.addAuthenticationMechanism(AuthenticationMechanism)	This method is now only applicable to SecurityContext implementations that also implement the AuthenticationMechanismContext interface.
io.undertow.security.api.SecurityContext.getAuthenticationMechanisms()	Obtaining lists of mechanisms is discouraged, however there should not be a need to call this anyway.
io.undertow.security.api.SecurityContext.getIdentityManager()	Authentication mechanisms that rely on the IdentityManager should instead hold their own reference to it.
io.undertow.security.api.SecurityContextFactory	Instead extend AbstractSecurityContextAssociationHandler to provide alternative contexts.
io.undertow.server.CookieStore.asLegacyMap()	This method exists for backward compatibility with the deprecated HttpServerExchange.getRequestCookies() and HttpServerExchange.getResponseCookies() methods. Use CookieStore.iterator() or CookieStore.get(String) instead.
io.undertow.server.handlers.Cookie.setSameSite(boolean)
io.undertow.server.handlers.PathHandler.addPath(String, HttpHandler)	Superseded by PathHandler.addPrefixPath(String, io.undertow.server.HttpHandler).
io.undertow.server.handlers.proxy.LoadBalancingProxyClient.HostSelector.selectHost(LoadBalancingProxyClient.Host[])
io.undertow.server.handlers.proxy.mod_cluster.Balancer.BalancerBuilder.getMaxattempts()	Use Balancer.BalancerBuilder.getMaxRetries().
io.undertow.server.handlers.proxy.mod_cluster.Balancer.BalancerBuilder.setMaxattempts(int)	Use Balancer.BalancerBuilder.setMaxRetries(int).
io.undertow.server.handlers.proxy.mod_cluster.ModClusterStatus.LoadBalancer.getMaxAttempts()	Use ModClusterStatus.LoadBalancer.getMaxRetries().
io.undertow.server.handlers.resource.DirectoryUtils.renderDirectoryListing(String, Resource)
io.undertow.server.HttpServerExchange.getNonDecodedQueryString()	use HttpServerExchange.getQueryString() instead
io.undertow.server.HttpServerExchange.getRequestCookies()	use either HttpServerExchange.requestCookies() or HttpServerExchange.getRequestCookie(String) or HttpServerExchange.setRequestCookie(Cookie) methods instead
io.undertow.server.HttpServerExchange.getResponseCookies()	use either HttpServerExchange.responseCookies() or HttpServerExchange.setResponseCookie(Cookie) methods instead
io.undertow.server.HttpServerExchange.setNonDecodedQueryString(String)	Use #setQueryString instead
io.undertow.UndertowOptions.DEFAULT_HTTP_HEADERS_CACHE_SIZE
io.undertow.UndertowOptions.DEFAULT_MAX_CACHED_HEADER_SIZE
io.undertow.UndertowOptions.ENABLE_CONNECTOR_STATISTICS
io.undertow.UndertowOptions.ENABLE_SPDY
io.undertow.UndertowOptions.HTTP_HEADERS_CACHE_SIZE
io.undertow.UndertowOptions.HTTP2_SETTINGS_MAX_HEADER_LIST_SIZE
io.undertow.UndertowOptions.MAX_CACHED_HEADER_SIZE
io.undertow.util.Certificates.toPem(X509Certificate)
io.undertow.util.Cookies.parseRequestCookies(int, boolean, List<String>)	use Cookies.parseRequestCookies(int, boolean, List, Set) instead
io.undertow.util.Cookies.parseRequestCookies(int, boolean, List<String>, Set<Cookie>)
io.undertow.util.QueryParameterUtils.mergeQueryParametersWithNewQueryString(Map<String, Deque<String>>, String)
io.undertow.util.QueryParameterUtils.mergeQueryParametersWithNewQueryString(Map<String, Deque<String>>, String, String)

Deprecated Interfaces

Interface	Description
io.undertow.security.api.SecurityContextFactory	Instead extend AbstractSecurityContextAssociationHandler to provide alternative contexts.

Deprecated Classes

Class	Description
io.undertow.attribute.TransportProtocolAttribute	Please use RequestProtocolAttribute
io.undertow.predicate.MaxContentSizePredicate
io.undertow.predicate.MinContentSizePredicate
io.undertow.server.handlers.DateHandler
io.undertow.server.handlers.PathTemplateHandler.PathTemplateMatch
io.undertow.server.handlers.proxy.SimpleProxyClientProvider
io.undertow.util.PipeliningExecutor

Deprecated Fields

Field	Description
io.undertow.conduits.ChunkedStreamSinkConduit.TRAILERS
io.undertow.conduits.ChunkedStreamSourceConduit.TRAILERS
io.undertow.server.handlers.PathTemplateHandler.PATH_TEMPLATE_MATCH
io.undertow.server.protocol.http2.Http2OpenListener.HTTP2_14
io.undertow.UndertowOptions.ALLOW_ENCODED_SLASH	- this option was interpreted improperly.
io.undertow.UndertowOptions.ALLOW_ID_LESS_MATRIX_PARAMETERS
io.undertow.UndertowOptions.DEFAULT_ALLOW_ID_LESS_MATRIX_PARAMETERS
io.undertow.UndertowOptions.DEFAULT_HTTP_HEADERS_CACHE_SIZE
io.undertow.UndertowOptions.DEFAULT_MAX_CACHED_HEADER_SIZE
io.undertow.UndertowOptions.ENABLE_CONNECTOR_STATISTICS
io.undertow.UndertowOptions.ENABLE_SPDY
io.undertow.UndertowOptions.HTTP_HEADERS_CACHE_SIZE
io.undertow.UndertowOptions.HTTP2_SETTINGS_MAX_HEADER_LIST_SIZE
io.undertow.UndertowOptions.MAX_CACHED_HEADER_SIZE
io.undertow.util.StatusCodes.MOVED_PERMENANTLY

Deprecated Methods

Method	Description
io.undertow.Handlers.date(HttpHandler)
io.undertow.io.BufferWritableOutputStream.transferFrom(FileChannel)
io.undertow.predicate.Predicates.maxContentSize(long)
io.undertow.predicate.Predicates.minContentSize(long)
io.undertow.security.api.AuthenticationMechanismFactory.create(String, FormParserFactory, Map<String, String>)
io.undertow.security.api.SecurityContext.addAuthenticationMechanism(AuthenticationMechanism)	This method is now only applicable to SecurityContext implementations that also implement the AuthenticationMechanismContext interface.
io.undertow.security.api.SecurityContext.getAuthenticationMechanisms()	Obtaining lists of mechanisms is discouraged, however there should not be a need to call this anyway.
io.undertow.security.api.SecurityContext.getIdentityManager()	Authentication mechanisms that rely on the IdentityManager should instead hold their own reference to it.
io.undertow.security.impl.SecurityContextImpl.getAuthenticationMechanisms()
io.undertow.security.impl.SecurityContextImpl.getIdentityManager()
io.undertow.server.BasicSSLSessionInfo.getPeerCertificateChain()
io.undertow.server.ConnectionSSLSessionInfo.getPeerCertificateChain()
io.undertow.server.Connectors.setExchangeRequestPath(HttpServerExchange, String, String, boolean, boolean, StringBuilder)
io.undertow.server.CookieStore.asLegacyMap()	This method exists for backward compatibility with the deprecated HttpServerExchange.getRequestCookies() and HttpServerExchange.getResponseCookies() methods. Use CookieStore.iterator() or CookieStore.get(String) instead.
io.undertow.server.handlers.Cookie.setSameSite(boolean)
io.undertow.server.handlers.form.FormData.FormValue.getFile()
io.undertow.server.handlers.form.FormData.FormValue.getPath()
io.undertow.server.handlers.form.FormData.FormValue.isFile()
io.undertow.server.handlers.PathHandler.addPath(String, HttpHandler)	Superseded by PathHandler.addPrefixPath(String, io.undertow.server.HttpHandler).
io.undertow.server.handlers.PathHandler.removePath(String)
io.undertow.server.handlers.proxy.LoadBalancingProxyClient.HostSelector.selectHost(LoadBalancingProxyClient.Host[])
io.undertow.server.handlers.proxy.mod_cluster.Balancer.BalancerBuilder.getMaxattempts()	Use Balancer.BalancerBuilder.getMaxRetries().
io.undertow.server.handlers.proxy.mod_cluster.Balancer.BalancerBuilder.setMaxattempts(int)	Use Balancer.BalancerBuilder.setMaxRetries(int).
io.undertow.server.handlers.proxy.mod_cluster.Balancer.getMaxattempts()
io.undertow.server.handlers.proxy.mod_cluster.MCMPConfig.getManagementHost()
io.undertow.server.handlers.proxy.mod_cluster.MCMPConfig.getManagementPort()
io.undertow.server.handlers.proxy.mod_cluster.ModCluster.getProxyHandler()
io.undertow.server.handlers.proxy.mod_cluster.ModClusterStatus.LoadBalancer.getMaxAttempts()	Use ModClusterStatus.LoadBalancer.getMaxRetries().
io.undertow.server.handlers.proxy.ProxyHandler.addRequestHeader(HttpString, ExchangeAttribute)
io.undertow.server.handlers.proxy.ProxyHandler.addRequestHeader(HttpString, String)
io.undertow.server.handlers.proxy.ProxyHandler.addRequestHeader(HttpString, String, ClassLoader)
io.undertow.server.handlers.proxy.ProxyHandler.removeRequestHeader(HttpString)
io.undertow.server.handlers.proxy.ProxyHandler.setMaxConnectionRetries(int)
io.undertow.server.handlers.proxy.ProxyHandler.setReuseXForwarded(boolean)
io.undertow.server.handlers.proxy.ProxyHandler.setRewriteHostHeader(boolean)
io.undertow.server.handlers.resource.DirectoryUtils.renderDirectoryListing(String, Resource)
io.undertow.server.HttpServerExchange.dispatch()
io.undertow.server.HttpServerExchange.getNonDecodedQueryString()	use HttpServerExchange.getQueryString() instead
io.undertow.server.HttpServerExchange.getRequestCookies()	use either HttpServerExchange.requestCookies() or HttpServerExchange.getRequestCookie(String) or HttpServerExchange.setRequestCookie(Cookie) methods instead
io.undertow.server.HttpServerExchange.getResponseCode()
io.undertow.server.HttpServerExchange.getResponseCookies()	use either HttpServerExchange.responseCookies() or HttpServerExchange.setResponseCookie(Cookie) methods instead
io.undertow.server.HttpServerExchange.setNonDecodedQueryString(String)	Use #setQueryString instead
io.undertow.server.HttpServerExchange.setResponseCode(int)
io.undertow.server.ServerConnection.getBufferPool()
io.undertow.server.SSLSessionInfo.getPeerCertificateChain()	in favor of SSLSessionInfo.getPeerCertificates() because SSLSession.getPeerCertificateChain() throws java 15.
io.undertow.Undertow.Builder.addListener(int, String)
io.undertow.Undertow.Builder.addListener(int, String, Undertow.ListenerType)
io.undertow.Undertow.Builder.setBuffersPerRegion(int)
io.undertow.util.Certificates.toPem(X509Certificate)
io.undertow.util.Cookies.parseRequestCookies(int, boolean, List<String>)	use Cookies.parseRequestCookies(int, boolean, List, Set) instead
io.undertow.util.Cookies.parseRequestCookies(int, boolean, List<String>, Set<Cookie>)
io.undertow.util.Headers.extractTokenFromHeader(String, String)
io.undertow.util.PathMatcher.removePath(String)
io.undertow.util.QueryParameterUtils.mergeQueryParametersWithNewQueryString(Map<String, Deque<String>>, String)
io.undertow.util.QueryParameterUtils.mergeQueryParametersWithNewQueryString(Map<String, Deque<String>>, String, String)
io.undertow.util.QueryParameterUtils.parseQueryString(String)
io.undertow.util.URLUtils.parsePathParms(String, HttpServerExchange, String, boolean, int)
io.undertow.websockets.client.WebSocketClient.connect(XnioWorker, ByteBufferPool, OptionMap, URI, WebSocketVersion)
io.undertow.websockets.client.WebSocketClient.connect(XnioWorker, ByteBufferPool, OptionMap, URI, WebSocketVersion, WebSocketClientNegotiation)
io.undertow.websockets.client.WebSocketClient.connect(XnioWorker, XnioSsl, ByteBufferPool, OptionMap, InetSocketAddress, URI, WebSocketVersion, WebSocketClientNegotiation, Set<ExtensionHandshake>)
io.undertow.websockets.client.WebSocketClient.connect(XnioWorker, XnioSsl, ByteBufferPool, OptionMap, URI, WebSocketVersion)
io.undertow.websockets.client.WebSocketClient.connect(XnioWorker, XnioSsl, ByteBufferPool, OptionMap, URI, WebSocketVersion, WebSocketClientNegotiation)
io.undertow.websockets.client.WebSocketClient.connect(XnioWorker, XnioSsl, ByteBufferPool, OptionMap, URI, WebSocketVersion, WebSocketClientNegotiation, Set<ExtensionHandshake>)
io.undertow.websockets.core.WebSocketChannel.getSubProtocols()
io.undertow.websockets.core.WebSocketUtils.initiateTransfer(I, O, ChannelListener<? super I>, ChannelListener<? super O>, ChannelExceptionHandler<? super I>, ChannelExceptionHandler<? super O>, ByteBufferPool)

Deprecated Constructors

Constructor	Description
io.undertow.security.impl.BasicAuthenticationMechanism.Factory(IdentityManager)
io.undertow.security.impl.ClientCertAuthenticationMechanism.Factory(IdentityManager)
io.undertow.security.impl.DigestAuthenticationMechanism.Factory(IdentityManager)
io.undertow.security.impl.ExternalAuthenticationMechanism.Factory(IdentityManager)
io.undertow.security.impl.GenericHeaderAuthenticationMechanism.Factory(IdentityManager)
io.undertow.server.handlers.error.FileErrorPageHandler(HttpHandler, File, Integer...)
io.undertow.server.handlers.error.FileErrorPageHandler(File, Integer...)
io.undertow.server.handlers.JDBCLogHandler(HttpHandler, Executor, String, DataSource)
io.undertow.server.handlers.proxy.ProxyHandler(ProxyClient, int, HttpHandler)
io.undertow.server.handlers.proxy.ProxyHandler(ProxyClient, int, HttpHandler, boolean, boolean)
io.undertow.server.handlers.proxy.ProxyHandler(ProxyClient, int, HttpHandler, boolean, boolean, int)
io.undertow.server.handlers.proxy.ProxyHandler(ProxyClient, HttpHandler)
io.undertow.server.handlers.resource.ResourceHandler()
io.undertow.server.handlers.resource.URLResource(URL, URLConnection, String)
io.undertow.server.protocol.http.HttpOpenListener(Pool<ByteBuffer>)
io.undertow.server.protocol.http.HttpOpenListener(Pool<ByteBuffer>, OptionMap)
io.undertow.server.protocol.http2.Http2OpenListener(Pool<ByteBuffer>)
io.undertow.server.protocol.http2.Http2OpenListener(Pool<ByteBuffer>, OptionMap)
io.undertow.server.protocol.http2.Http2OpenListener(Pool<ByteBuffer>, OptionMap, String)
io.undertow.util.StringReadChannelListener(Pool<ByteBuffer>)