org.jboss.netty.handler.codec.http

Class QueryStringEncoder

java.lang.Object

org.jboss.netty.handler.codec.http.QueryStringEncoder

public class QueryStringEncoder
extends java.lang.Object

Creates an URL-encoded URI from a path string and key-value parameter pairs. This encoder is for one time use only. Create a new instance for each URI.

 QueryStringEncoder encoder = new QueryStringEncoder("/hello");
 encoder.addParam("recipient", "world");
 assert encoder.toString().equals("/hello?recipient=world");
 

See Also:

QueryStringDecoder

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	QueryStringEncoder.Param

Field Summary

Fields

Modifier and Type	Field and Description
private java.nio.charset.Charset	charset
private java.util.List<QueryStringEncoder.Param>	params
private java.lang.String	uri

Constructor Summary

Constructors

Constructor and Description
QueryStringEncoder(java.lang.String uri) Creates a new encoder that encodes a URI that starts with the specified path string.
QueryStringEncoder(java.lang.String uri, java.nio.charset.Charset charset) Creates a new encoder that encodes a URI that starts with the specified path string in the specified charset.

Method Summary

Modifier and Type	Method and Description
void	addParam(java.lang.String name, java.lang.String value) Adds a parameter with the specified name and value to this encoder.
private static java.lang.String	encodeComponent(java.lang.String s, java.nio.charset.Charset charset)
java.lang.String	toString() Returns the URL-encoded URI which was created from the path string specified in the constructor and the parameters added by addParam(String, String) method.
java.net.URI	toUri() Returns the URL-encoded URI object which was created from the path string specified in the constructor and the parameters added by addParam(String, String) method.

Methods inherited from class java.lang.Object

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

Field Detail

charset

private final java.nio.charset.Charset charset

uri

private final java.lang.String uri

params

private final java.util.List<QueryStringEncoder.Param> params

Constructor Detail

QueryStringEncoder

public QueryStringEncoder(java.lang.String uri)

Creates a new encoder that encodes a URI that starts with the specified path string. The encoder will encode the URI in UTF-8.

QueryStringEncoder

public QueryStringEncoder(java.lang.String uri,
                          java.nio.charset.Charset charset)

Creates a new encoder that encodes a URI that starts with the specified path string in the specified charset.

Method Detail

addParam

public void addParam(java.lang.String name,
                     java.lang.String value)

Adds a parameter with the specified name and value to this encoder.

toUri

public java.net.URI toUri()
                   throws java.net.URISyntaxException

Returns the URL-encoded URI object which was created from the path string specified in the constructor and the parameters added by addParam(String, String) method.

Throws:

java.net.URISyntaxException

toString

public java.lang.String toString()

Returns the URL-encoded URI which was created from the path string specified in the constructor and the parameters added by addParam(String, String) method.

Overrides:

toString in class java.lang.Object

encodeComponent

private static java.lang.String encodeComponent(java.lang.String s,
                                                java.nio.charset.Charset charset)