org.ocpsoft.rewrite.servlet.util
Class QueryStringBuilder

java.lang.Object
  org.ocpsoft.rewrite.servlet.util.QueryStringBuilder

public class QueryStringBuilder
extends java.lang.Object

Utility for building URL query strings.

Author:

Lincoln Baxter, III

Constructor Summary

QueryStringBuilder()

Method Summary

void	addParameter(java.lang.String name, java.lang.String... values) Add a single parameter with the given values.
QueryStringBuilder	addParameterArrays(java.util.Map<java.lang.String,java.lang.String[]> params) Add parameters from the given map of name=value pairs.
QueryStringBuilder	addParameterLists(java.util.Map<java.lang.String,java.util.List<java.lang.String>> params) Add parameters from the given map of name=value pairs.
QueryStringBuilder	addParameters(java.lang.String url) Add parameters from the given URL.
static QueryStringBuilder	createFrom(java.lang.String parameters) Build a query string from the given URL.
static QueryStringBuilder	createFromArrays(java.util.Map<java.lang.String,java.lang.String[]> params) Build a query string from the given map of name=value pairs.
static QueryStringBuilder	createFromLists(java.util.Map<java.lang.String,java.util.List<java.lang.String>> params) Build a query string from the given map of name=value pairs.
static QueryStringBuilder	createNew() Return a new empty instance of QueryStringBuilder
QueryStringBuilder	decode() Return a new QueryStringBuilder instance having called URLDecoder.decode(String, String) on each name=value pair.
QueryStringBuilder	encode() Return a new QueryStringBuilder instance having called URLEncoder.encode(String, String) on each name=value pair.
java.lang.String	getParameter(java.lang.String name) Get the first value of given parameter name.
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getParameterMap() Get the name, values[] map representing this query string.
java.util.Set<java.lang.String>	getParameterNames() Get set of parameter names currently stored in this query string.
java.lang.String[]	getParameterValues(java.lang.String name) Get the array of values for a given parameter name.
boolean	isEmpty() Return true if this query string currently contains no parameters.
java.util.List<java.lang.String>	removeParameter(java.lang.String string)
java.lang.String	toQueryString() Convert the current parameters to a valid query string, including the leading '?' character.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryStringBuilder

public QueryStringBuilder()

Method Detail

createNew

public static QueryStringBuilder createNew()

Return a new empty instance of QueryStringBuilder

createFrom

public static QueryStringBuilder createFrom(java.lang.String parameters)

Build a query string from the given URL. If a '?' character is encountered in the URL, the any characters up to and including the first '?' will be ignored.

createFromArrays

public static QueryStringBuilder createFromArrays(java.util.Map<java.lang.String,java.lang.String[]> params)

Build a query string from the given map of name=value pairs. For parameters with more than one value, each value will be appended using the same name.

createFromLists

public static QueryStringBuilder createFromLists(java.util.Map<java.lang.String,java.util.List<java.lang.String>> params)

Build a query string from the given map of name=value pairs. For parameters with more than one value, each value will be appended using the same name.

addParameters

public QueryStringBuilder addParameters(java.lang.String url)

Add parameters from the given URL. If a '?' character is encountered in the URL, the any characters up to and including the first '?' will be ignored. If a parameter already exists, append new values to the existing list of values for that parameter.

addParameter

public void addParameter(java.lang.String name,
                         java.lang.String... values)

Add a single parameter with the given values.

addParameterArrays

public QueryStringBuilder addParameterArrays(java.util.Map<java.lang.String,java.lang.String[]> params)

Add parameters from the given map of name=value pairs. For parameters with more than one value, each value will be appended using the same name. If a parameter already exists, append new values to the existing list of values for that parameter.

addParameterLists

public QueryStringBuilder addParameterLists(java.util.Map<java.lang.String,java.util.List<java.lang.String>> params)

Add parameters from the given map of name=value pairs. For parameters with more than one value, each value will be appended using the same name. If a parameter already exists, append new values to the existing list of values for that parameter.

decode

public QueryStringBuilder decode()

Return a new QueryStringBuilder instance having called URLDecoder.decode(String, String) on each name=value pair.

encode

public QueryStringBuilder encode()

Return a new QueryStringBuilder instance having called URLEncoder.encode(String, String) on each name=value pair.

getParameter

public java.lang.String getParameter(java.lang.String name)

Get the first value of given parameter name.

Returns:

The value of the parameter, null if the parameter does not exist, or "" if the parameter exists but has no values.

getParameterMap

public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getParameterMap()

Get the name, values[] map representing this query string.

getParameterNames

public java.util.Set<java.lang.String> getParameterNames()

Get set of parameter names currently stored in this query string.

getParameterValues

public java.lang.String[] getParameterValues(java.lang.String name)

Get the array of values for a given parameter name.

Returns:

The values of the parameter, null if the parameter does not exist.

isEmpty

public boolean isEmpty()

Return true if this query string currently contains no parameters.

removeParameter

public java.util.List<java.lang.String> removeParameter(java.lang.String string)

toQueryString

public java.lang.String toQueryString()

Convert the current parameters to a valid query string, including the leading '?' character.

For example, a QueryStringBuilder with the values [key=>value, name=>value1,value2,value3] will become:

 
 ?key=value&name=value1&name=value2&name=value3
 

Returns:

If parameters exist, return a valid query string with leading '?' character. If no parameters exist, return an empty string.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object