| A kvp parser which parses a value consisting of tokens in a nested list.
A value in nested form is a number of lists of tokens, seperated by an outer
delimeter. The tokens in each list are serarated by an inner delimiter
The default outer delimiter is are parentheses ( '()' ) , the default inner
delimter is a comma ( ',' ). Example:
key=(token11,token12,...,token1N)(token21,token22,...,token2N)(...)(tokenM1,tokenM2,...,tokenMN)
where N = number of tokens in each set, and M = number of sets.
Upon processing of each token, the token is parsed into an instance of
NestedKvpParser.getBinding() . Subclasses should override the method
NestedKvpParser.parseToken(String) .
By default, the
NestedKvpParser.parse(String) method returns a list of lists. Each
of which contains instances of
NestedKvpParser.getBinding() . The
NestedKvpParser.parseTokenSet(List) method may be overidden to return a differnt type of object.
author: Justin Deoliveira, The Open Planning Project, jdeolive@openplans.org author: TODO: add a method to convert return value as to not force returning a list |