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 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 final class	RequestRouter.Entry<T>
(package private) static final class	RequestRouter.SingleAuthorityResolver<T>

Field Summary

Fields

Modifier and Type	Field	Description
private final BiFunction<String, URIAuthority, URIAuthority>	authorityResolver
private final Function<URIAuthority, Function<String,T>>	authorityRouter
private final HttpRequestMapper<T>	downstream
static final BiFunction<String, URIAuthority, URIAuthority>	IGNORE_PORT_AUTHORITY_RESOLVER
static final URIAuthority	LOCAL_AUTHORITY
static final BiFunction<String, URIAuthority, URIAuthority>	LOCAL_AUTHORITY_RESOLVER

Constructor Summary

Constructors

Constructor	Description
RequestRouter(Function<URIAuthority, Function<String,T>> authorityRouter, BiFunction<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, List<RequestRouter.Entry<T>> handlerEntries, BiFunction<String, URIAuthority, URIAuthority> authorityResolver, HttpRequestMapper<T> downstream)
(package private) static final <T> Function<URIAuthority, T>	noAuthorityResolver()
T	resolve(HttpRequest request, HttpContext context)	Resolves a handler matching the given request.

Methods inherited from class Object

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

Field Details

LOCAL_AUTHORITY

public static final URIAuthority LOCAL_AUTHORITY

LOCAL_AUTHORITY_RESOLVER

public static final BiFunction<String, URIAuthority, URIAuthority> LOCAL_AUTHORITY_RESOLVER

IGNORE_PORT_AUTHORITY_RESOLVER

public static final BiFunction<String, URIAuthority, URIAuthority> IGNORE_PORT_AUTHORITY_RESOLVER

authorityRouter

private final Function<URIAuthority, Function<String,T>> authorityRouter

authorityResolver

private final BiFunction<String, URIAuthority, URIAuthority> authorityResolver

downstream

private final HttpRequestMapper<T> downstream

Constructor Details

RequestRouter

RequestRouter(Function<URIAuthority, Function<String,T>> authorityRouter,
 BiFunction<String, URIAuthority, URIAuthority> authorityResolver,
 HttpRequestMapper<T> downstream)

Method Details

noAuthorityResolver

static final <T> Function<URIAuthority, T> noAuthorityResolver()

create

@Internal
public static <T> RequestRouter<T> create(URIAuthority primaryAuthority,
 UriPatternType patternType,
 List<RequestRouter.Entry<T>> handlerEntries,
 BiFunction<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.