org.brains2b.struct

Class RepeatGroup

java.lang.Object

org.brains2b.struct.StructRule

org.brains2b.struct.RepeatGroup

All Implemented Interfaces:

StructGroup

public class RepeatGroup
extends StructRule
implements StructGroup

RepeatGroup checks all rules which are part of this Group as long as there are lines to be read.

As long as one rule or group is found but not finished all lines will be passed to that rule, otherwhise an attempt is made to match incoming lines to any of the rules in this group. The first rule that matches will be used

Version:

$Revision$ $Date$

Author:

dennis@brains2b.nl

Field Summary

Fields inherited from class org.brains2b.struct.StructRule

BOL, EMPTY_LINE, EOB, EOL, m_attribute, m_out, m_terminate, SPACE

Fields inherited from interface org.brains2b.struct.StructGroup

MAP, XML

Constructor Summary

Constructors

Constructor and Description
RepeatGroup(java.lang.Object objectId, int outputType) Constructor

Method Summary

Modifier and Type	Method and Description
void	add(StructRule rule) add a rule to this Group.
void	addTransformat(Transformat format) add a Transformat to this rule
void	clearBuffer() general method to clear a buffer which an implementation of a StructRule can implement to keep all data between StructRule.isFound() and StructRule.isFinished().
java.lang.Object	getObject() get the Object created as a result of the input matching this group.
int	getOutputType() the type of output StructGroup.getObject() will deliver if the rules are matched to the output
void	insertTransformat(int pos, Transformat format)
void	readline(java.lang.String line) read a line from the parser for processing, without tracking the line number
void	readline(java.lang.String line, int lineno) read a line from the parser for processing, with tracking the line number
void	setParent(StructGroup parent) set the parent for this rule

Methods inherited from class org.brains2b.struct.StructRule

getParent, getTransformats, isFinished, isFound, isTerminate, removeWhitespace, reset, set, setFinished, setFound

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.brains2b.struct.StructGroup

getTransformats, isFinished, isFound, reset

Constructor Detail

RepeatGroup

public RepeatGroup(java.lang.Object objectId,
                   int outputType)

Constructor

Parameters:

objectId - String, id for the object to create

outputType - int, either (XML|MAP)

Method Detail

readline

public void readline(java.lang.String line)

read a line from the parser for processing, without tracking the line number

The StructParser supplies the input line for line. This does not limit the rules to one line. This is only dependant on StructRule.isFound() and StructRule.isFinished()

This method calls StructRule.readline(String, int) with lineno=-1 and will ignore lineno for information purposes

Specified by:

readline in interface StructGroup

Specified by:

readline in class StructRule

Parameters:

line - String, the line to be read

See Also:

StructRule.readline(String, int), StructParser

readline

public void readline(java.lang.String line,
                     int lineno)

read a line from the parser for processing, with tracking the line number

The StructParser supplies the input line for line. This does not limit the rules to one line. This is only dependant on StructRule.isFound() and StructRule.isFinished()

Specified by:

readline in interface StructGroup

Specified by:

readline in class StructRule

Parameters:

line - String, the line to be read

lineno - int, the linenumber of this line

See Also:

StructParser

add

public void add(StructRule rule)

add a rule to this Group. This rule will only be checked against the input if the StructGroup.isFound() is true and until StructGroup.isFinished() is true.

Specified by:

add in interface StructGroup

Parameters:

rule - StructRule, the rule to add to this group

addTransformat

public void addTransformat(Transformat format)

Description copied from class: StructRule

add a Transformat to this rule

A transformater is a class which will be called to format the values from an input to a value for the output. With an implementation one can do simple transformations SimpleTransformat like trimming whitespaces or setting the value to uppercase or do complex transformations ComplexTransformat changing multiple values in a resulting Object

Overrides:

addTransformat in class StructRule

Parameters:

format - Transformat

insertTransformat

public void insertTransformat(int pos,
                              Transformat format)

Overrides:

insertTransformat in class StructRule

getObject

public java.lang.Object getObject()

get the Object created as a result of the input matching this group.

Specified by:

getObject in interface StructGroup

Returns:

Object, the Object will be a type of (BEAN|XML|PROPERTIES) as defined. This value can be null if StructGroup.isFound() is never true for this group and might not be correctly set if StructGroup.isFinished() never is true

getOutputType

public int getOutputType()

the type of output StructGroup.getObject() will deliver if the rules are matched to the output

Specified by:

getOutputType in interface StructGroup

Returns:

int either one of the constants (XML|BEAN|PROPERTIES)

clearBuffer

public void clearBuffer()

general method to clear a buffer which an implementation of a StructRule can implement to keep all data between StructRule.isFound() and StructRule.isFinished().

This method is called from reset to clear the buffer between two independant uses of this rule

Specified by:

clearBuffer in class StructRule

See Also:

StructRule.reset()

setParent

public void setParent(StructGroup parent)

set the parent for this rule

Specified by:

setParent in interface StructGroup

Overrides:

setParent in class StructRule

Parameters:

parent - StructGroup the parent to use