org.xwiki.url

Interface URLNormalizer<T>

Type Parameters:

T - the type of object to return (eg ExtendedURL, URL)

@Role
public interface URLNormalizer<T>

Normalize a relative URL. Various implementations can exist, for example one implementation may normalize the passed relative URL into a full absolute URL object. Another implementation may simply prefix the passed relative URL with a Servlet Container's webapp name (aka application context name). Note that in general the implementations will depends on the Container in which XWiki is executing (eg Servlet Container).

It's also important that Normalizers should be independent of URL Scheme formats since they should be usable for all URL Schemes. Note that Normalizers should not replace ResourceReferenceSerializer implementations.

Since:

6.1M2

Version:

$Id: d22f4ab03c210ca825cd5d17bf63a88f346e46ce $

Method Summary

Methods

Modifier and Type	Method and Description
T	normalize(ExtendedURL partialURL)

Method Detail

normalize

T normalize(ExtendedURL partialURL)

Parameters:

partialURL - the partial URL to normalize

Returns:

the normalized URL, what is done depends on the implementation