net.shibboleth.utilities.java.support.net

Class SimpleURLCanonicalizer

java.lang.Object

net.shibboleth.utilities.java.support.net.SimpleURLCanonicalizer

public final class SimpleURLCanonicalizer
extends java.lang.Object

This class performs simple canonicalization of a URL as follows:

• The scheme is lower-cased.
• The hostname is lower-cased
• The port is removed if it is the default port registered for the scheme

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.Map<java.lang.String,java.lang.Integer>	schemePortMap The scheme-to-port mapping data.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	SimpleURLCanonicalizer() Constructor to prevent instantiation.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	canonicalize(java.lang.String url) Canonicalize the supplied URL.
private static void	canonicalize(URLBuilder url) Canonicalize the supplied URLBuilder data.
static void	deregisterSchemePortMapping(java.lang.String scheme) Deregister a scheme-to-port mapping.
static java.lang.Integer	getRegisteredPort(java.lang.String scheme) Obtain the default port registered for a scheme.
static void	registerSchemePortMapping(java.lang.String scheme, java.lang.Integer port) Register a new scheme-to-port mapping.

Methods inherited from class java.lang.Object

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

Field Detail

schemePortMap

private static java.util.Map<java.lang.String,java.lang.Integer> schemePortMap

The scheme-to-port mapping data.

Constructor Detail

SimpleURLCanonicalizer

private SimpleURLCanonicalizer()

Constructor to prevent instantiation.

Method Detail

registerSchemePortMapping

public static void registerSchemePortMapping(@Nonnull @NotEmpty
                                             java.lang.String scheme,
                                             @Nonnull
                                             java.lang.Integer port)

Register a new scheme-to-port mapping.

Parameters:

scheme - the scheme to register

port - the default port for that scheme

deregisterSchemePortMapping

public static void deregisterSchemePortMapping(@Nonnull
                                               java.lang.String scheme)

Deregister a scheme-to-port mapping.

Parameters:

scheme - the scheme to deregister

getRegisteredPort

@Nullable
public static java.lang.Integer getRegisteredPort(@Nonnull @NotEmpty
                                                            java.lang.String scheme)

Obtain the default port registered for a scheme.

Parameters:

scheme - the scheme to look up

Returns:

the default port registered for the scheme, or null if none registered

canonicalize

@Nonnull
 @NotEmpty
public static java.lang.String canonicalize(@Nonnull @NotEmpty
                                                                java.lang.String url)
                                                         throws java.net.MalformedURLException

Canonicalize the supplied URL.

Parameters:

url - the URL to canonicalize

Returns:

the canonicalized URL

Throws:

java.net.MalformedURLException - if the URL is not a valid URL

canonicalize

private static void canonicalize(@Nonnull
                                 URLBuilder url)

Canonicalize the supplied URLBuilder data.

Parameters:

url - the URLBuilder to canonicalize