net.grinder.util.http

Interface URIParser.ParseListener

All Known Implementing Classes:

URIParser.AbstractParseListener

Enclosing interface:

URIParser

public static interface URIParser.ParseListener

Callback interface for use with URIParser.parse(java.lang.String, net.grinder.util.http.URIParser.ParseListener).

Methods are called with the maximum amount of text possible. This means that fragment(java.lang.String) will only be called once for a parse.

All of the strings that are passed to the methods are unescaped.

Each of the methods returns a boolean, which should be interpreted as "continue parse". That is, if a method returns false the parse is terminated.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	authority(String authority) Called with the authority.
boolean	fragment(String fragment) Called with fragment.
boolean	path(String path) Called with path text.
boolean	pathParameterNameValue(String name, String value) Called with a name-value pair that was found in the path.
boolean	queryString(String queryString) Called with query string text.
boolean	queryStringNameValue(String name, String value) Called with a name-value pair that was found in the query string.
boolean	scheme(String scheme) Called with the scheme for absolute URIs.

Method Detail

scheme

boolean scheme(String scheme)

Called with the scheme for absolute URIs.

Parameters:

scheme - The scheme, without ':'.

Returns:

See {ParseListener}.

authority

boolean authority(String authority)

Called with the authority.

Parameters:

authority - The authority, without leading '//'.

Returns:

See {ParseListener}.

path

boolean path(String path)

Called with path text. Called multiple times with everything in a path (net_path, abs_path, rel_path from RFC 2396), except name-value tokens found in path parameters.

Parameters:

path - The text. Includes any delimiting punctuation.

Returns:

See {ParseListener}.

pathParameterNameValue

boolean pathParameterNameValue(String name,
                             String value)

Called with a name-value pair that was found in the path.

Parameters:

name - The name. URL decoded.

value - The value. URL decoded.

Returns:

See {ParseListener}.

queryString

boolean queryString(String queryString)

Called with query string text.

Parameters:

queryString - The text. The leading '?' is stripped.

Returns:

See {ParseListener}.

queryStringNameValue

boolean queryStringNameValue(String name,
                           String value)

Called with a name-value pair that was found in the query string.

Parameters:

name - The name. URL decoded.

value - The value. URL decoded.

Returns:

See {ParseListener}.

fragment

boolean fragment(String fragment)

Called with fragment.

Parameters:

fragment - The fragment. The leading '#' is stripped.

Returns:

See {ParseListener}.