org.jfree.xml

Class ParserUtil

public class ParserUtil extends Object

Basic helper functions to ease up the process of parsing.

Author: Thomas Morgner

Method Summary
static Rectangle2DgetElementPosition(Attributes atts)
Parses an element position.
static booleanparseBoolean(String text, boolean defaultVal)
Parses a boolean.
static ColorparseColor(String color)
Parses a color entry.
static ColorparseColor(String color, Color defaultValue)
Parses a color entry.
static floatparseFloat(String text, String message)
Parses the string text into an float.
static floatparseFloat(String text, float defaultVal)
Parses the string text into an float.
static intparseInt(String text, String message)
Parses the string text into an int.
static intparseInt(String text, int defaultVal)
Parses an integer.
static floatparseRelativeFloat(String value, String exceptionMessage)
Parses a position of an element.
static StringparseString(String text, String defaultVal)
Parses a string.
static StrokeparseStroke(String weight)
Creates a basic stroke given the width contained as float in the given string.

Method Detail

getElementPosition

public static Rectangle2D getElementPosition(Attributes atts)
Parses an element position. The position is stored in the attributes "x", "y", "width" and "height". The attributes are allowed to have relative notion.

Parameters: atts the attributes.

Returns: the element position.

Throws: SAXException if there is a problem getting the element position.

parseBoolean

public static boolean parseBoolean(String text, boolean defaultVal)
Parses a boolean. If the string text contains the value of "true", the true value is returned, else false is returned.

Parameters: text the text to parse. defaultVal the default value.

Returns: a boolean.

parseColor

public static Color parseColor(String color)
Parses a color entry. If the entry is in hexadecimal or ocal notation, the color is created using Color.decode(). If the string denotes a constant name of on of the color constants defined in java.awt.Color, this constant is used.

As fallback the color black is returned if no color can be parsed.

Parameters: color the color (as a string).

Returns: the paint.

parseColor

public static Color parseColor(String color, Color defaultValue)
Parses a color entry. If the entry is in hexadecimal or octal notation, the color is created using Color.decode(). If the string denotes a constant name of one of the color constants defined in java.awt.Color, this constant is used.

As fallback the supplied default value is returned if no color can be parsed.

Parameters: color the color (as a string). defaultValue the default value (returned if no color can be parsed).

Returns: the paint.

parseFloat

public static float parseFloat(String text, String message)
Parses the string text into an float. If text is null or does not contain a parsable value, the message given in message is used to throw a SAXException.

Parameters: text the text to parse. message the error message if parsing fails.

Returns: the float value.

Throws: SAXException if there is a problem with the parsing.

parseFloat

public static float parseFloat(String text, float defaultVal)
Parses the string text into an float. If text is null or does not contain a parsable value, the message given in message is used to throw a SAXException.

Parameters: text the text to parse. defaultVal the defaultValue returned if parsing fails.

Returns: the float value.

parseInt

public static int parseInt(String text, String message)
Parses the string text into an int. If text is null or does not contain a parsable value, the message given in message is used to throw a SAXException.

Parameters: text the text to parse. message the error message if parsing fails.

Returns: the int value.

Throws: SAXException if there is a problem with the parsing.

parseInt

public static int parseInt(String text, int defaultVal)
Parses an integer.

Parameters: text the text to parse. defaultVal the default value.

Returns: the integer.

parseRelativeFloat

public static float parseRelativeFloat(String value, String exceptionMessage)
Parses a position of an element. If a relative postion is given, the returnvalue is a negative number between 0 and -100.

Parameters: value the value. exceptionMessage the exception message.

Returns: the float value.

Throws: SAXException if there is a problem parsing the string.

parseString

public static String parseString(String text, String defaultVal)
Parses a string. If the text is null, defaultval is returned.

Parameters: text the text to parse. defaultVal the default value.

Returns: a string.

parseStroke

public static Stroke parseStroke(String weight)
Creates a basic stroke given the width contained as float in the given string. If the string could not be parsed into a float, a basic stroke with the width of 1 is returned.

Parameters: weight a string containing a number (the stroke weight).

Returns: the stroke.