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.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.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_SPDY
io.undertow.UndertowOptions.HTTP_HEADERS_CACHE_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

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.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.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.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.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>)