io.undertow

Class Handlers

java.lang.Object

io.undertow.Handlers

public class Handlers
extends Object

Utility class with convenience methods for dealing with handlers

Author:

Stuart Douglas

Method Summary

Methods

Modifier and Type	Method and Description
static DateHandler	date(HttpHandler next) Returns a new HTTP handler that sets the Date: header.
static void	handlerNotNull(HttpHandler handler)
static SetHeaderHandler	header(HttpHandler next, String headerName, String headerValue) Returns a handler that sets a response header
static HttpContinueReadHandler	httpContinueRead(HttpHandler next) A handler that automatically handles HTTP 100-continue responses, by sending a continue response when the first attempt is made to read from the request channel.
static IPAddressAccessControlHandler	ipAccessControl(HttpHandler next, boolean defaultAllow) Returns a new handler that can allow or deny access to a resource based on IP address
static PathHandler	path() Creates a new path handler
static PathHandler	path(HttpHandler defaultHandler) Creates a new path handler, with the default handler specified
static PredicateHandler	predicate(Predicate predicate, HttpHandler trueHandler, HttpHandler falseHandler) Returns a new predicate handler, that will delegate to one of the two provided handlers based on the value of the provided predicate.
static HttpHandler	predicateContext(HttpHandler next)
static PredicatesHandler	predicates(List<PredicatedHandler> handlers, HttpHandler next)
static RedirectHandler	redirect(String location) Returns a new redirect handler
static ResourceHandler	resource(ResourceManager resourceManager) Return a new resource handler
static HttpHandler	rewrite(String condition, String target, ClassLoader classLoader, HttpHandler next) Creates the set of handlers that are required to perform a simple rewrite.
static SetAttributeHandler	setAttribute(HttpHandler next, String attribute, String value, ClassLoader classLoader) Returns an attribute setting handler that can be used to set an arbitrary attribute on the exchange.
static HttpTraceHandler	trace(HttpHandler next) Returns a new HTTP trace handler.
static URLDecodingHandler	urlDecoding(HttpHandler next, String charset) A handler that will decode the URL, query parameters and to the specified charset.
static HttpHandler	urlDecodingHandler(String charset, HttpHandler next) Returns a new handler that decodes the URL and query parameters into the specified charset, assuming it has not already been done by the connector.
static NameVirtualHostHandler	virtualHost() Creates a new virtual host handler
static NameVirtualHostHandler	virtualHost(HttpHandler defaultHandler) Creates a new virtual host handler using the provided default handler
static NameVirtualHostHandler	virtualHost(HttpHandler defaultHandler, HttpHandler hostHandler, String... hostnames) Creates a new virtual host handler that uses the provided handler as the root handler for the given hostnames.
static NameVirtualHostHandler	virtualHost(HttpHandler hostHandler, String... hostnames) Creates a new virtual host handler that uses the provided handler as the root handler for the given hostnames.
static WebSocketProtocolHandshakeHandler	websocket(WebSocketConnectionCallback sessionHandler)
static WebSocketProtocolHandshakeHandler	websocket(WebSocketConnectionCallback sessionHandler, HttpHandler next)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

path

public static PathHandler path(HttpHandler defaultHandler)

Creates a new path handler, with the default handler specified

Parameters:

defaultHandler - The default handler

Returns:

A new path handler

path

public static PathHandler path()

Creates a new path handler

Returns:

A new path handler

virtualHost

public static NameVirtualHostHandler virtualHost()

Creates a new virtual host handler

Returns:

A new virtual host handler

virtualHost

public static NameVirtualHostHandler virtualHost(HttpHandler defaultHandler)

Creates a new virtual host handler using the provided default handler

Returns:

A new virtual host handler

virtualHost

public static NameVirtualHostHandler virtualHost(HttpHandler hostHandler,
                                 String... hostnames)

Creates a new virtual host handler that uses the provided handler as the root handler for the given hostnames.

Parameters:

hostHandler - The host handler

hostnames - The host names

Returns:

A new virtual host handler

virtualHost

public static NameVirtualHostHandler virtualHost(HttpHandler defaultHandler,
                                 HttpHandler hostHandler,
                                 String... hostnames)

Creates a new virtual host handler that uses the provided handler as the root handler for the given hostnames.

Parameters:

defaultHandler - The default handler

hostHandler - The host handler

hostnames - The host names

Returns:

A new virtual host handler

websocket

public static WebSocketProtocolHandshakeHandler websocket(WebSocketConnectionCallback sessionHandler)

Parameters:

sessionHandler - The web socket session handler

Returns:

The web socket handler

websocket

public static WebSocketProtocolHandshakeHandler websocket(WebSocketConnectionCallback sessionHandler,
                                          HttpHandler next)

Parameters:

sessionHandler - The web socket session handler

next - The handler to invoke if the web socket connection fails

Returns:

The web socket handler

resource

public static ResourceHandler resource(ResourceManager resourceManager)

Return a new resource handler

Parameters:

resourceManager - The resource manager to use

Returns:

A new resource handler

redirect

public static RedirectHandler redirect(String location)

Returns a new redirect handler

Parameters:

location - The redirect location

Returns:

A new redirect handler

trace

public static HttpTraceHandler trace(HttpHandler next)

Returns a new HTTP trace handler. This handler will handle HTTP TRACE requests as per the RFC.

WARNING: enabling trace requests may leak information, in general it is recomended that these be disabled for security reasons.

Parameters:

next - The next handler in the chain

Returns:

A HTTP trace handler

date

public static DateHandler date(HttpHandler next)

Returns a new HTTP handler that sets the Date: header.

Parameters:

next - The next handler in the chain

Returns:

A new date handler

predicate

public static PredicateHandler predicate(Predicate predicate,
                         HttpHandler trueHandler,
                         HttpHandler falseHandler)

Returns a new predicate handler, that will delegate to one of the two provided handlers based on the value of the provided predicate.

Parameters:

predicate - The predicate

trueHandler - The handler that will be executed if the predicate is true

falseHandler - The handler that will be exected if the predicate is false

Returns:

A new predicate handler

See Also:

Predicate, Predicates

predicateContext

public static HttpHandler predicateContext(HttpHandler next)

Parameters:

next - The next handler

Returns:

a handler that sets up a new predicate context

predicates

public static PredicatesHandler predicates(List<PredicatedHandler> handlers,
                           HttpHandler next)

header

public static SetHeaderHandler header(HttpHandler next,
                      String headerName,
                      String headerValue)

Returns a handler that sets a response header

Parameters:

next - The next handler in the chain

headerName - The name of the header

headerValue - The header value

Returns:

A new set header handler

ipAccessControl

public static final IPAddressAccessControlHandler ipAccessControl(HttpHandler next,
                                            boolean defaultAllow)

Returns a new handler that can allow or deny access to a resource based on IP address

Parameters:

next - The next handler in the chain

defaultAllow - Determine if a non-matching address will be allowed by default

Returns:

A new IP access control handler

httpContinueRead

public static final HttpContinueReadHandler httpContinueRead(HttpHandler next)

A handler that automatically handles HTTP 100-continue responses, by sending a continue response when the first attempt is made to read from the request channel.

Parameters:

next - The next handler in the chain

Returns:

A new continue handler

urlDecoding

public static final URLDecodingHandler urlDecoding(HttpHandler next,
                             String charset)

A handler that will decode the URL, query parameters and to the specified charset.

If you are using this handler you must set the UndertowOptions.DECODE_URL parameter to false.

This is not as efficient as using the parsers built in UTF-8 decoder. Unless you need to decode to something other than UTF-8 you should rely on the parsers decoding instead.

Parameters:

next - The next handler in the chain

charset - The charset to decode to

Returns:

a new url decoding handler

setAttribute

public static SetAttributeHandler setAttribute(HttpHandler next,
                               String attribute,
                               String value,
                               ClassLoader classLoader)

Returns an attribute setting handler that can be used to set an arbitrary attribute on the exchange. This includes functions such as adding and removing headers etc.

Parameters:

next - The next handler

attribute - The attribute to set, specified as a string presentation of an ExchangeAttribute

value - The value to set, specified an a string representation of an ExchangeAttribute

classLoader - The class loader to use to parser the exchange attributes

Returns:

The handler

rewrite

public static HttpHandler rewrite(String condition,
                  String target,
                  ClassLoader classLoader,
                  HttpHandler next)

Creates the set of handlers that are required to perform a simple rewrite.

Parameters:

condition - The rewrite condition

target - The rewrite target if the condition matches

next - The next handler

Returns:

urlDecodingHandler

public static HttpHandler urlDecodingHandler(String charset,
                             HttpHandler next)

Returns a new handler that decodes the URL and query parameters into the specified charset, assuming it has not already been done by the connector. For this handler to take effect the parameter UndertowOptions.DECODE_URL must have been set to false.

Parameters:

charset - The charset to decode

next - The next handler

Returns:

A handler that decodes the URL

handlerNotNull

public static void handlerNotNull(HttpHandler handler)