org.apache.http.protocol

Class UriHttpRequestHandlerMapper

java.lang.Object

org.apache.http.protocol.UriHttpRequestHandlerMapper

All Implemented Interfaces:

HttpRequestHandlerMapper

@Contract(threading=SAFE)
public class UriHttpRequestHandlerMapper
extends Object
implements HttpRequestHandlerMapper

Maintains a map of HTTP request handlers keyed by a request URI pattern.
Patterns may have three formats:

• *
• *<uri>
• <uri>*

This class can be used to map an instance of HttpRequestHandler matching a particular request URI. Usually the mapped request handler will be used to process the request with the specified request URI.

Since:

4.3

Constructor Summary

Constructors

Constructor and Description
UriHttpRequestHandlerMapper()

Method Summary

Modifier and Type	Method and Description
HttpRequestHandler	lookup(HttpRequest request) Looks up a handler matching the given request URI.
void	register(String pattern, HttpRequestHandler handler) Registers the given HttpRequestHandler as a handler for URIs matching the given pattern.
void	unregister(String pattern) Removes registered handler, if exists, for the given pattern.

Methods inherited from class java.lang.Object

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

Constructor Detail

UriHttpRequestHandlerMapper

public UriHttpRequestHandlerMapper()

Method Detail

register

public void register(String pattern,
                     HttpRequestHandler handler)

Registers the given HttpRequestHandler as a handler for URIs matching the given pattern.

Parameters:

pattern - the pattern to register the handler for.

handler - the handler.

unregister

public void unregister(String pattern)

Removes registered handler, if exists, for the given pattern.

Parameters:

pattern - the pattern to unregister the handler for.

lookup

public HttpRequestHandler lookup(HttpRequest request)

Looks up a handler matching the given request URI.

Specified by:

lookup in interface HttpRequestHandlerMapper

Parameters:

request - the request

Returns:

handler or null if no match is found.