Package org.freeplane.api
Interface Convertible
- All Known Implementing Classes:
Convertible
public interface Convertible
Utility wrapper class around a String that is used to convert node texts to different types.
It's especially important for Formulas.
-
Method Summary
Modifier and TypeMethodDescriptionboolean
For implicit conversion to boolean: true if the text is not empty.int
int
compareTo
(Convertible convertible) boolean
getBool()
parses the text (case insensitive) as boolean viaBoolean.parseBoolean(String)
.Converts to Calendar if possible.getDate()
Converts to Date if possible.getNum()
Convert to Number.getNum0()
Safe variant ofgetNum()
, throws nothing - on any error (long) 0 is returned.Uses the following priority ranking to determine the type of the text: null Long Double Date StringgetPlain()
Removes HTML markup if necessary.getRaw()
Returns original objectNo conversion.getText()
No conversion.getUri()
Converts to URI if possible.boolean
isDate()
Type check.boolean
isNum()
Type check.
-
Method Details
-
getNum
Convert to Number. All Java number literals are allowed as described byLong.decode(String)
- Returns:
- a Long or a Double, whatever fits best.
- Throws:
ConversionException
- if text is not a number.
-
getNum0
Number getNum0()Safe variant ofgetNum()
, throws nothing - on any error (long) 0 is returned.- Returns:
- a Long or a Double if text is convertible to it or 0 otherwise (even if text is null).
-
getString
String getString()No conversion.- Returns:
- The original string.
-
getText
String getText()No conversion.- Returns:
- The original string.
-
getPlain
String getPlain()Removes HTML markup if necessary.- Returns:
- The result of
HtmlUtils.htmlToPlain(String)
-
getDate
Converts to Date if possible. The valid date patterns are "yyyy-MM-dd HH:dd:ss.SSSZ" with optional '-', ':'. ' ' may be replaced by 'T'.- Returns:
- a Date for the parsed text
- Throws:
ConversionException
- if the text is not convertible to a Date.
-
getCalendar
Converts to Calendar if possible. SeegetDate()
for recognized patterns.- Returns:
- a Calendar for the parsed text.
- Throws:
ConversionException
- if the text is not convertible to a Date.
-
getUri
Converts to URI if possible.- Returns:
- a URI
- Throws:
ConversionException
- if the text is not convertible to a URI.
-
getObject
Object getObject()Uses the following priority ranking to determine the type of the text:- null
- Long
- Double
- Date
- String
- Returns:
- Object - the type that fits best.
-
getRaw
Object getRaw()Returns original object- Returns:
- the original object
- Since:
- 1.7.4
-
isNum
boolean isNum()Type check.- Returns:
- true if the text is convertible to number.
-
isDate
boolean isDate()Type check.- Returns:
- true if the text is convertible to date.
-
compareTo
-
compareTo
-
getBool
boolean getBool()parses the text (case insensitive) as boolean viaBoolean.parseBoolean(String)
.- Returns:
- boolean
-
asBoolean
boolean asBoolean()For implicit conversion to boolean: true if the text is not empty.- Returns:
- boolean
-