org.jfree.xml

Class ParserUtil


public class ParserUtil
extends java.lang.Object

Basic helper functions to ease up the process of parsing.
Author:
Thomas Morgner

Method Summary

static Rectangle2D
getElementPosition(Attributes atts)
Parses an element position.
static boolean
parseBoolean(String text, boolean defaultVal)
Parses a boolean.
static Color
parseColor(String color)
Parses a color entry.
static Color
parseColor(String color, Color defaultValue)
Parses a color entry.
static float
parseFloat(String text, String message)
Parses the string text into an float.
static float
parseFloat(String text, float defaultVal)
Parses the string text into an float.
static int
parseInt(String text, String message)
Parses the string text into an int.
static int
parseInt(String text, int defaultVal)
Parses an integer.
static float
parseRelativeFloat(String value, String exceptionMessage)
Parses a position of an element.
static String
parseString(String text, String defaultVal)
Parses a string.
static Stroke
parseStroke(String weight)
Creates a basic stroke given the width contained as float in the given string.

Method Details

getElementPosition

public static Rectangle2D getElementPosition(Attributes atts)
            throws SAXException
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.

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)
            throws SAXException
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.

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)
            throws SAXException
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.

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)
            throws SAXException
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.

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.