Module com.aoapps.net.partialurl

Package com.aoapps.net.partialurl

Class PartialURLMap<V>

java.lang.Object

com.aoapps.net.partialurl.PartialURLMap<V>

public class PartialURLMap<V>
extends Object

Maps partial URLs to arbitrary values and provides fast lookups.

Constructor Summary

Constructors

Constructor	Description
PartialURLMap()

Method Summary

Modifier and Type	Method	Description
PartialURLMatch<V>	get(FieldSource fieldSource)	Gets the value associated with the given URL, returning the most specific match.
void	put(PartialURL partialUrl, V value)	Adds a new partial URL to this map while checking for conflicts.

Methods inherited from class java.lang.Object

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

Constructor Details

PartialURLMap

public PartialURLMap()

Method Details

put

public void put(PartialURL partialUrl,
 V value)
         throws IllegalStateException

Adds a new partial URL to this map while checking for conflicts.

TODO: Use MinimalMap in the index?

Implementation Note:
Currently, when an exception occurs, the index may be in a partial state. Changes are not rolled-back.

Throws:

IllegalStateException - If the partial URL conflicts with an existing entry.

get

public PartialURLMatch<V> get(FieldSource fieldSource)
                       throws MalformedURLException

Gets the value associated with the given URL, returning the most specific match.

Ordering is consistent with:

• PartialURL.matches(com.aoapps.net.partialurl.FieldSource)
• PartialURL.getCombinations()
• SinglePartialURL.compareTo(com.aoapps.net.partialurl.SinglePartialURL)

Implementation Note:
The maximum number of internal map lookups is: (host, null) * (contextPath, null) * (maxSlashCount + 1) * (scheme, null) * (port, null), or 2 * 2 * (maxSlashCount + 1) * 2 * 2, or 16 * (maxSlashCount + 1). The actual number of map lookups will typically be much less than this due to a sparsely populated index.

Returns:

The matching value or null of no match

Throws:

MalformedURLException