Class FormSpecParser

java.lang.Object

com.jgoodies.forms.layout.FormSpecParser

public final class FormSpecParser
extends Object

Parses encoded column and row specifications. Returns ColumnSpec or RowSpec arrays if successful, and aims to provide useful information in case of a syntax error.

Version:

$Revision: 1.12 $

See Also:

• ColumnSpec
• RowSpec

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	FormSpecParser.FormLayoutParseException	Used by the parser for encoded column and row specifications.
(package private) static final class	FormSpecParser.Multiplier	Internal helper class that is returned by multiplier(String, int).

Field Summary

Fields

Modifier and Type	Field	Description
private static final Pattern	DIGIT_PATTERN
private final LayoutMap	layoutMap
private static final Pattern	MULTIPLIER_PREFIX_PATTERN
private final String	source

Constructor Summary

Constructors

Modifier	Constructor	Description
private	FormSpecParser(String source, String description, LayoutMap layoutMap, boolean horizontal)	Constructs a parser for the given encoded column/row specification, the given LayoutMap, and orientation.

Method Summary

Modifier and Type	Method	Description
private void	addSpec(List<String> encodedSpecs, String expression, int offset)
private void	fail(int index, NumberFormatException cause)
private void	fail(int index, String description)
static void	fail(String source, int index, String description)
private static String	message(String source, int index, String description)
private FormSpecParser.Multiplier	multiplier(String expression, int offset)
private ColumnSpec[]	parseColumnSpecs()
(package private) static ColumnSpec[]	parseColumnSpecs(String encodedColumnSpecs, LayoutMap layoutMap)
private RowSpec[]	parseRowSpecs()
(package private) static RowSpec[]	parseRowSpecs(String encodedRowSpecs, LayoutMap layoutMap)
private List<String>	split(String expression, int offset)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

MULTIPLIER_PREFIX_PATTERN

private static final Pattern MULTIPLIER_PREFIX_PATTERN

DIGIT_PATTERN

private static final Pattern DIGIT_PATTERN

source

private final String source

layoutMap

private final LayoutMap layoutMap

Constructor Details

FormSpecParser

private FormSpecParser(String source,
 String description,
 LayoutMap layoutMap,
 boolean horizontal)

Constructs a parser for the given encoded column/row specification, the given LayoutMap, and orientation.

Parameters:

source - the raw encoded column or row specification as provided by the user

description - describes the source, e.g. "column specification"

layoutMap - maps layout variable names to ColumnSpec and RowSpec objects

horizontal - true for columns, false for rows

Throws:

NullPointerException - if source or layoutMap is null

Method Details

parseColumnSpecs

static ColumnSpec[] parseColumnSpecs(String encodedColumnSpecs,
 LayoutMap layoutMap)

parseRowSpecs

static RowSpec[] parseRowSpecs(String encodedRowSpecs,
 LayoutMap layoutMap)

parseColumnSpecs

private ColumnSpec[] parseColumnSpecs()

parseRowSpecs

private RowSpec[] parseRowSpecs()

split

private List<String> split(String expression,
 int offset)

addSpec

private void addSpec(List<String> encodedSpecs,
 String expression,
 int offset)

multiplier

private FormSpecParser.Multiplier multiplier(String expression,
 int offset)

fail

public static void fail(String source,
 int index,
 String description)

fail

private void fail(int index,
 String description)

fail

private void fail(int index,
 NumberFormatException cause)

message

private static String message(String source,
 int index,
 String description)