|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.velocity.tools.generic.ValueParser
public class ValueParser
Utility class for easy parsing of String values held in a Map.
Template example(s): $parser.foo -> bar $parser.getNumber('baz') -> 12.6 $parser.getInt('baz') -> 12 $parser.getNumbers('foo') -> [12.6] Toolbox configuration: <tool> <key>parser</key> <class>org.apache.velocity.generic.Parser</class> </tool>
This comes in very handy when parsing parameters.
Field Summary | |
---|---|
private java.util.Map |
source
|
Constructor Summary | |
---|---|
ValueParser()
|
|
ValueParser(java.util.Map source)
|
Method Summary | |
---|---|
boolean |
exists(java.lang.String key)
Convenience method for checking whether a certain parameter exists. |
java.lang.String |
get(java.lang.String key)
Convenience method for use in Velocity templates. |
java.lang.Boolean |
getBoolean(java.lang.String key)
|
boolean |
getBoolean(java.lang.String key,
boolean alternate)
|
java.lang.Boolean |
getBoolean(java.lang.String key,
java.lang.Boolean alternate)
|
java.lang.Boolean[] |
getBooleans(java.lang.String key)
|
double |
getDouble(java.lang.String key,
double alternate)
|
double[] |
getDoubles(java.lang.String key)
|
int |
getInt(java.lang.String key,
int alternate)
|
int[] |
getInts(java.lang.String key)
|
java.lang.Number |
getNumber(java.lang.String key)
|
java.lang.Number |
getNumber(java.lang.String key,
java.lang.Number alternate)
|
java.lang.Number[] |
getNumbers(java.lang.String key)
|
protected java.util.Map |
getSource()
|
java.lang.String |
getString(java.lang.String key)
|
java.lang.String |
getString(java.lang.String key,
java.lang.String alternate)
|
java.lang.String[] |
getStrings(java.lang.String key)
|
protected java.lang.Boolean |
parseBoolean(java.lang.String value)
Converts a parameter value into a Boolean
Sub-classes can override to allow for customized boolean parsing. |
protected java.lang.Number |
parseNumber(java.lang.String value)
Converts a parameter value into a Number
This is used as the base for all numeric parsing methods. |
protected void |
setSource(java.util.Map source)
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
private java.util.Map source
Constructor Detail |
---|
public ValueParser()
public ValueParser(java.util.Map source)
Method Detail |
---|
protected void setSource(java.util.Map source)
protected java.util.Map getSource()
public boolean exists(java.lang.String key)
key
- the parameter's key
true
if a parameter exists for the specified
key; otherwise, returns false
.public java.lang.String get(java.lang.String key)
key
- the parameter's key
null
if there is no matching
parameterpublic java.lang.String getString(java.lang.String key)
key
- the parameter's key
null
if there is no matching
parameterpublic java.lang.String getString(java.lang.String key, java.lang.String alternate)
key
- the desired parameter's keyalternate
- The alternate value
public java.lang.Boolean getBoolean(java.lang.String key)
key
- the desired parameter's key
Boolean
object for the specified key or
null
if no matching parameter is foundpublic boolean getBoolean(java.lang.String key, boolean alternate)
key
- the desired parameter's keyalternate
- The alternate boolean value
public java.lang.Boolean getBoolean(java.lang.String key, java.lang.Boolean alternate)
key
- the desired parameter's keyalternate
- the alternate Boolean
Boolean
for the specified key or the specified
alternate if no matching parameter is foundpublic java.lang.Number getNumber(java.lang.String key)
key
- the desired parameter's key
Number
for the specified key or
null
if no matching parameter is foundpublic java.lang.Number getNumber(java.lang.String key, java.lang.Number alternate)
key
- the desired parameter's keyalternate
- The alternate Number
public int getInt(java.lang.String key, int alternate)
key
- the desired parameter's keyalternate
- The alternate int value
public double getDouble(java.lang.String key, double alternate)
key
- the desired parameter's keyalternate
- The alternate double value
public java.lang.String[] getStrings(java.lang.String key)
key
- the key for the desired parameter
null
if the no values are associated with the given keypublic java.lang.Boolean[] getBooleans(java.lang.String key)
key
- the key for the desired parameter
public java.lang.Number[] getNumbers(java.lang.String key)
key
- the key for the desired parameter
null
if Numbers are not associated with it.public int[] getInts(java.lang.String key)
key
- the key for the desired parameter
null
if numbers are not associated with it.public double[] getDoubles(java.lang.String key)
key
- the key for the desired parameter
null
if numbers are not associated with it.protected java.lang.Number parseNumber(java.lang.String value) throws java.lang.NumberFormatException
Number
This is used as the base for all numeric parsing methods. So,
sub-classes can override to allow for customized number parsing.
(e.g. to handle fractions, compound numbers, etc.)
value
- the string to be parsed
Number
java.lang.NumberFormatException
protected java.lang.Boolean parseBoolean(java.lang.String value)
Boolean
Sub-classes can override to allow for customized boolean parsing.
(e.g. to handle "Yes/No" or "T/F")
value
- the string to be parsed
Boolean
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |