Package org.scictrl.mp.orbitcorrect.accessories

Class DefaultDBReader

java.lang.Object

org.scictrl.mp.orbitcorrect.accessories.AbstractParameterReader

org.scictrl.mp.orbitcorrect.accessories.DefaultDBReader

All Implemented Interfaces:

IDataBushReader

public class DefaultDBReader
extends AbstractParameterReader
implements IDataBushReader

This is straightforward implementation of IDataBushReader. DefaultDBReader is designed for reading input written in DataBush specific format. String, written in this format is obtained by calling DataBush.toString() method. Proper read sequence is

• open input stream with any of openInStream method
• read input with DefaultDBReader.read() method. List elements can be returned by read or obtained with DefaultDBReader.getList() method.
• close input with DefaultDBReader.closeInStream().

Example of reading is described in ParameterReader.
The only difference is, that you should call read() instead init(). Method init() does not implements any functionallity. Result of reading are instances of DataBush elements, with parameters initialized as described in input format. Elements are stored in ElementList. The list is used to initialize DataBush. Examples, how elements are written in DataBush specific format, can be obtained by calling DefaultDBReader.getSamples().

Author:

igor@scictrl.com

See Also:

• AbstractParameterReader
• IDataBushReader
• DataBush
• ElementList

Field Summary

Fields

Modifier and Type	Field	Description
Properties	readers	Holdes a set of properties.
protected Object[][]	template	Template.

Fields inherited from class org.scictrl.mp.orbitcorrect.accessories.AbstractParameterReader

log, st, tok, uRL

Fields inherited from interface org.scictrl.mp.orbitcorrect.IDataBushReader

ST_FILE, ST_URL

Constructor Summary

Constructors

Constructor	Description
DefaultDBReader()	DefaultDBReader constructor, that sets default keys and values to java.util.Properties.

Method Summary

Modifier and Type	Method	Description
void	addReader(String tag, String reader)	Adds new reader to java.util.Properties.
void	close()	Closes opened input stream.
ElementList<AbstractDataBushElement>	getList()	Returns list of instances of DataBush elements created by read() method.
IDataBushReader	getReader(String tag)	Returnes IDataBushReader with given key.To IDataBushReader are propeties also set.
Properties	getReaders()	Returnes readers.
static ElementList<AbstractDataBushElement>	getSamples()	Returns samples of all elements recognized by DataBush and DefaultDBReader.
void	open(Reader reader)	open.
ElementList<AbstractDataBushElement>	read()	Reads input and creates DataBush elements.
ElementList<AbstractDataBushElement>	read(ElementList<AbstractDataBushElement> l)	Reads input and creates DataBush elements.

Methods inherited from class org.scictrl.mp.orbitcorrect.accessories.AbstractParameterReader

debugPrint, debugPrintln, getProperties, getSourceType, getURL, open, open, setProperties

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.scictrl.mp.orbitcorrect.IDataBushReader

getProperties, getSourceType, open, open, setProperties

Field Details

readers

public Properties readers

Holdes a set of properties.

template

protected Object[][] template

Template.

Constructor Details

DefaultDBReader

public DefaultDBReader()

DefaultDBReader constructor, that sets default keys and values to java.util.Properties.

Method Details

addReader

public void addReader(String tag,
 String reader)

Adds new reader to java.util.Properties.

Parameters:

tag - java.lang.String

reader - java.lang.Class

close

public void close()
           throws DataBushException

Closes opened input stream. After stream is closed, new stream may be opened and read. Close opened input stream. After stream is closed, new stream may be opened and read.
This is implementation of ParameterReader.closeInStream().

Specified by:

close in interface IDataBushReader

Overrides:

close in class AbstractParameterReader

Throws:

DataBushException - if any.

getList

public ElementList<AbstractDataBushElement> getList()

Returns list of instances of DataBush elements created by read() method. Returns list of elements created by DefaultDBReader. Elements are stored in ElementList list. List is created and filled after call to read() method.

Specified by:

getList in interface IDataBushReader

Returns:

ElementList list of read elements

getReader

public IDataBushReader getReader(String tag)
                          throws IllegalArgumentException,
ClassNotFoundException,
InstantiationException,
IllegalAccessException,
ClassCastException,
InvocationTargetException,
NoSuchMethodException,
SecurityException

Returnes IDataBushReader with given key.To IDataBushReader are propeties also set.

Parameters:

tag - java.lang.String key to reader

Returns:

accessories.DataBushReader

Throws:

SecurityException - if read fails

NoSuchMethodException - if read fails

InvocationTargetException - if read fails

IllegalArgumentException - if read fails

ClassNotFoundException - if read fails

InstantiationException - if read fails

IllegalAccessException - if read fails

ClassCastException - if read fails

getReaders

public Properties getReaders()

Returnes readers.

Returns:

java.util.Properties

getSamples

public static ElementList<AbstractDataBushElement> getSamples()

Returns samples of all elements recognized by DataBush and DefaultDBReader. Elements are stored in ElementList list.

Returns:

ElementList of sample elements

open

public void open(Reader reader)
          throws DataBushException

open.

Parameters:

reader - a Reader object

Throws:

DataBushException - if any.

read

public ElementList<AbstractDataBushElement> read()
                                          throws DataBushException

Reads input and creates DataBush elements. Input must be opened with one of ParameterReader.openInStream methods. Created elements are stored and returned in ElementList. Reads input and creates DataBush elements. Input must be opened with one of ParameterReader.openInStream methods. Created instances of DataBush elements are stored and returned in ElementList. Call read only once per new opened stream.

Specified by:

read in interface IDataBushReader

Returns:

ElementList list of created elements

Throws:

DataBushException - if any.

read

public ElementList<AbstractDataBushElement> read(ElementList<AbstractDataBushElement> l)
                                          throws DataBushException

Reads input and creates DataBush elements. Input must be opened with one of ParameterReader.openInStream methods. Created elements are stored and returned in ElementList. Reads input and creates DataBush elements. Input must be opened with one of ParameterReader.openInStream methods. Created instances of DataBush elements are stored and returned in ElementList. Call read only once per new opened stream.

Specified by:

read in interface IDataBushReader

Parameters:

l - a ElementList object

Returns:

ElementList list of created elements

Throws:

DataBushException - if any.

See Also:

• ElementList