Package org.apache.hc.core5.http.impl.routing

Class RequestRouter<T>

java.lang.Object

org.apache.hc.core5.http.impl.routing.RequestRouter<T>

Type Parameters:

T - request handler type.

All Implemented Interfaces:

HttpRequestMapper<T>

@Contract(threading=IMMUTABLE)
public class RequestRouter<T>
extends java.lang.Object
implements HttpRequestMapper<T>

Request mapper that can route requests based on their properties to a specific request handler.

Since:

5.3

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RequestRouter.Builder<T>
static class	RequestRouter.Entry<T>
(package private) static class	RequestRouter.SingleAuthorityResolver<T>

Field Summary

Fields

Modifier and Type	Field	Description
private java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority>	authorityResolver
private java.util.function.Function<URIAuthority,java.util.function.Function<java.lang.String,T>>	authorityRouter
private HttpRequestMapper<T>	downstream
static java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority>	IGNORE_PORT_AUTHORITY_RESOLVER
static URIAuthority	LOCAL_AUTHORITY
static java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority>	LOCAL_AUTHORITY_RESOLVER

Constructor Summary

Constructors

Constructor	Description
RequestRouter(java.util.function.Function<URIAuthority,java.util.function.Function<java.lang.String,T>> authorityRouter, java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority> authorityResolver, HttpRequestMapper<T> downstream)

Method Summary

Modifier and Type	Method	Description
static <T> RequestRouter.Builder<T>	builder()
static <T> RequestRouter.Builder<T>	builder(UriPatternType patternType)
static <T> RequestRouter<T>	create(URIAuthority primaryAuthority, UriPatternType patternType, java.util.List<RequestRouter.Entry<T>> handlerEntries, java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority> authorityResolver, HttpRequestMapper<T> downstream)
(package private) static <T> java.util.function.Function<URIAuthority,T>	noAuthorityResolver()
T	resolve(HttpRequest request, HttpContext context)	Resolves a handler matching the given request.

Methods inherited from class java.lang.Object

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

Field Detail

LOCAL_AUTHORITY

public static final URIAuthority LOCAL_AUTHORITY

LOCAL_AUTHORITY_RESOLVER

public static final java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority> LOCAL_AUTHORITY_RESOLVER

IGNORE_PORT_AUTHORITY_RESOLVER

public static final java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority> IGNORE_PORT_AUTHORITY_RESOLVER

authorityRouter

private final java.util.function.Function<URIAuthority,java.util.function.Function<java.lang.String,T>> authorityRouter

authorityResolver

private final java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority> authorityResolver

downstream

private final HttpRequestMapper<T> downstream

Constructor Detail

RequestRouter

RequestRouter(java.util.function.Function<URIAuthority,java.util.function.Function<java.lang.String,T>> authorityRouter,
              java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority> authorityResolver,
              HttpRequestMapper<T> downstream)

Method Detail

noAuthorityResolver

static final <T> java.util.function.Function<URIAuthority,T> noAuthorityResolver()

create

@Internal
public static <T> RequestRouter<T> create(URIAuthority primaryAuthority,
                                          UriPatternType patternType,
                                          java.util.List<RequestRouter.Entry<T>> handlerEntries,
                                          java.util.function.BiFunction<java.lang.String,URIAuthority,URIAuthority> authorityResolver,
                                          HttpRequestMapper<T> downstream)

builder

public static <T> RequestRouter.Builder<T> builder(UriPatternType patternType)

builder

public static <T> RequestRouter.Builder<T> builder()

resolve

public T resolve(HttpRequest request,
                 HttpContext context)
          throws HttpException

Description copied from interface: HttpRequestMapper

Resolves a handler matching the given request.

Specified by:

resolve in interface HttpRequestMapper<T>

Parameters:

request - the request to map to a handler

Returns:

HTTP request handler or null if no match is found.

Throws:

HttpException - in case of an HTTP protocol violation.