com.jalios.util

Class URLUtils

java.lang.Object

com.jalios.util.URLUtils

public final class URLUtils
extends java.lang.Object

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	buildUrl(java.lang.String url, java.util.Map<java.lang.String,java.lang.String[]> parametersMap) Build an URL by adding the given parameters.
static java.lang.String	getQueryString(java.util.Map<java.lang.String,java.lang.String[]> parametersMap, java.lang.String... excludedParams) Returns a query String from a map of parameters.
static java.util.Map<java.lang.String,java.lang.String[]>	parseUrlQueryString(java.lang.String url) Parses an URL, extracts the query string and returns a map with the parameter values.

Methods inherited from class java.lang.Object

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

Method Detail

parseUrlQueryString

public static java.util.Map<java.lang.String,java.lang.String[]> parseUrlQueryString(java.lang.String url)

Parses an URL, extracts the query string and returns a map with the parameter values. The map has the same structure as the one returned by javax.servlet.ServletRequest.getParameterMap(). For each parameter name, the map contains a string array with the parameter values.

Parameters:

url - an URL or an URL query string.

Returns:

a map containing parameter names as keys and parameter values as map values.

getQueryString

public static java.lang.String getQueryString(java.util.Map<java.lang.String,java.lang.String[]> parametersMap,
                              java.lang.String... excludedParams)

Returns a query String from a map of parameters.

Parameters:

parametersMap - Map of parameters

excludedParams - Parameter to exclude in the final query string

Returns:

String representing a query string

buildUrl

public static java.lang.String buildUrl(java.lang.String url,
                        java.util.Map<java.lang.String,java.lang.String[]> parametersMap)

Build an URL by adding the given parameters.

If a parameter to be added is already present in the given URL, the URL's parameter will be replaced by the new parameter.

If a parameter has a null value, this parameter will be removed from the URL.

Example

 String url = "http://www.jalios.com/home.jsp?param1=value1&param1=value2&param2=value2#hash1";
 Map<String, String[]> map = new HashMap<String, String[]>();
 map.put("param1", null);
 map.put("param2", new String[] { "value21", "value22" });
 map.put("param3", new String[] { "value31", "value32" });
 String url = URLUtils.buildUrl(url, map);
 
 The "url" value will be:
 
 http://www.jalios.com/home.jsp?param2=value21&param2=value22&param3=value31&param3=value32#hash1
 

Parameters:

url - the full URL with parameters and hash

parametersMap - Map of the params to add/remove

Returns:

the new url