org.mazarineblue.datasources

Class SourceChain

java.lang.Object

org.mazarineblue.datasources.SourceChain

All Implemented Interfaces:

DataSource, VariableSource

public class SourceChain
extends Object
implements DataSource

Author:

Alex de Kruijff <alex.de.kruijff@MazarineBlue.org>

Constructor Summary

Constructors

Constructor and Description
SourceChain()
SourceChain(DataSource... sources)
SourceChain(DataSource source)
SourceChain(DataSource source, SourceChain next)

Method Summary

Modifier and Type	Method and Description
String[]	getColumns() Returns an array of supported columns.
Object	getData(int index)
Object	getData(String column) Return the object at the specified column.
String	getLineIdentifier() Returns the line identifier.
String	getSourceIdentifier() Returns the source identifier.
boolean	hasNext() Return true if the data source has more rows.
SourceChain	lastLink()
SourceChain	link(DataSource... sources)
SourceChain	link(DataSource source)
String	next() Moves the data source to the next row.
String	reset() Resets the data source.
boolean	setData(int index, Object value) Sets the specified value to the specivied column.
boolean	setData(String column, Object value) Return the object at the specified index.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.mazarineblue.datasources.DataSource

getData, getData, reset

Constructor Detail

SourceChain

public SourceChain()

SourceChain

public SourceChain(DataSource source)

SourceChain

public SourceChain(DataSource source,
                   SourceChain next)

SourceChain

public SourceChain(DataSource... sources)

Method Detail

link

public SourceChain link(DataSource... sources)

link

public SourceChain link(DataSource source)

lastLink

public SourceChain lastLink()

hasNext

public boolean hasNext()

Description copied from interface: DataSource

Return true if the data source has more rows.

Specified by:

hasNext in interface DataSource

Returns:

true if the data source has more rows.

next

public String next()

Description copied from interface: DataSource

Moves the data source to the next row.

Specified by:

next in interface DataSource

Returns:

the line identifier of the next row.

reset

public String reset()

Description copied from interface: DataSource

Resets the data source.

Specified by:

reset in interface DataSource

Returns:

the line identifier from before reset was called or null, if next was not called.

getSourceIdentifier

public String getSourceIdentifier()

Description copied from interface: DataSource

Returns the source identifier.

Specified by:

getSourceIdentifier in interface DataSource

Returns:

the source identifier

getLineIdentifier

public String getLineIdentifier()
                         throws IllegalSourceStateException

Description copied from interface: DataSource

Returns the line identifier.

Specified by:

getLineIdentifier in interface DataSource

Returns:

the line identifier.

Throws:

IllegalSourceStateException - when the method could not be called due to the state of the source i.e. next() has not been called or this method is not supported by the data source. when next() has not been

getData

public Object getData(String column)
               throws IllegalSourceStateException

Description copied from interface: DataSource

Return the object at the specified column.

Specified by:

getData in interface DataSource

Specified by:

getData in interface VariableSource

Parameters:

column - the location where the object resides.

Returns:

the object at the specified index or null if it could not be fetched.

Throws:

IllegalSourceStateException - when the method could not be called due to the state of the source i.e. next() has not been called or this method is not supported by the data source. when next() has not been

getData

public Object getData(int index)
               throws IllegalSourceStateException

Specified by:

getData in interface DataSource

Throws:

IllegalSourceStateException

setData

public boolean setData(String column,
                       Object value)
                throws Exception

Description copied from interface: DataSource

Return the object at the specified index.

Specified by:

setData in interface DataSource

Specified by:

setData in interface VariableSource

Parameters:

column - the location where the object should be stored.

value - the object to store.

Returns:

the object at the specified index or null if it could not be fetched.

Throws:

Exception

setData

public boolean setData(int index,
                       Object value)

Description copied from interface: DataSource

Sets the specified value to the specivied column.

Specified by:

setData in interface DataSource

Parameters:

index - the location where the object should be stored.

value - the object to store.

Returns:

the object at the specified index or null if it could not be fetched.

getColumns

public String[] getColumns()

Description copied from interface: DataSource

Returns an array of supported columns.

Specified by:

getColumns in interface DataSource

Returns:

an array of supported columns or an empty array when none are supported by this data source.