Package adams.data.spreadsheet

Class DenseDataRow

java.lang.Object

adams.data.spreadsheet.DenseDataRow

All Implemented Interfaces:

Mergeable<Row>, DataRow, Row, SpreadSheetColumnInsertionListener, Serializable

Direct Known Subclasses:

DenseFloatDataRow

public class DenseDataRow
extends Object
implements DataRow

A row for dense data representation.

Author:

fracpete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected Cell[]	m_Cells	the cells of the row.
protected SpreadSheet	m_Owner	the owner.

Constructor Summary

Constructors

Constructor	Description
DenseDataRow()	Default constructor for GOE only.
DenseDataRow(SpreadSheet owner)	Constructor that ties row to spreadsheet.

Method Summary

Modifier and Type	Method	Description
Cell	addCell(int columnIndex)	Adds a cell with the key of the cell in the header at the specified location.
Cell	addCell(String cellKey)	Adds a cell with the given key to the list and returns the created object.
void	assign(Row row)	Obtains copies of the cells from the other row, but not the owner.
Collection<String>	cellKeys()	Returns a collection of all stored cell keys.
Collection<Cell>	cells()	Returns all cells.
void	clear()	Removes all cells.
Cell	getCell(int columnIndex)	Returns the cell with the given index, null if not found.
Cell	getCell(String cellKey)	Returns the cell with the given key, null if not found.
int	getCellCount()	Returns the number of cells stored in the row.
String	getCellKey(int columnIndex)	Returns the cell key with the given column index.
DataRow	getClone(SpreadSheet owner)	Creates a copy of itself.
String	getContent(int columnIndex)	Returns the cell content with the given index.
SpreadSheet	getOwner()	Returns the spreadsheet this row belongs to.
boolean	hasCell(int columnIndex)	Returns whether the row alread contains the cell at the specified location.
boolean	hasCell(String cellKey)	Returns whether the row alread contains the cell with the given key.
int	indexOf(Cell cell)	Returns the column this particular cell is in (must belong to this row!).
boolean	isEmpty(int columnIndex)	Returns whether the row has a non-empty/non-missing cell at the specified location.
boolean	isEmpty(String cellKey)	Returns whether the row has a non-empty/non-missing cell with the given key.
void	mergeWith(Row other)	Merges its own data with the one provided by the specified row.
Cell	newCell(Row owner)	Creates a new instance of a cell.
Cell	removeCell(int columnIndex)	Removes the cell at the specified index.
Cell	removeCell(String cellKey)	Removes the cell at the specified index.
boolean	removeMissing()	Does nothing as the underlying data structure is fixed.
void	setOwner(SpreadSheet owner)	Sets the spreadsheet this row belongs to.
void	spreadSheetColumnInserted(SpreadSheetColumnInsertionEvent e)	A column got inserted.
String	toString()	Returns the internal array of cells as string.

Methods inherited from class java.lang.Object

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

Field Detail

m_Owner

protected SpreadSheet m_Owner

the owner.

m_Cells

protected Cell[] m_Cells

the cells of the row.

Constructor Detail

DenseDataRow

public DenseDataRow()

Default constructor for GOE only.

DenseDataRow

public DenseDataRow(SpreadSheet owner)

Constructor that ties row to spreadsheet.

Parameters:

owner - the spreadsheet this row belongs to

Method Detail

setOwner

public void setOwner(SpreadSheet owner)

Sets the spreadsheet this row belongs to.

Clears the cells if the number of columns differ.

Specified by:

setOwner in interface Row

Parameters:

owner - the owner

getOwner

public SpreadSheet getOwner()

Returns the spreadsheet this row belongs to.

Specified by:

getOwner in interface Row

Returns:

the owner

getClone

public DataRow getClone(SpreadSheet owner)

Creates a copy of itself.

Specified by:

getClone in interface DataRow

Specified by:

getClone in interface Row

Parameters:

owner - the new owner

Returns:

the cloned object

clear

public void clear()

Removes all cells.

Specified by:

clear in interface Row

assign

public void assign(Row row)

Obtains copies of the cells from the other row, but not the owner.

Specified by:

assign in interface Row

Parameters:

row - the row to get the cells from

newCell

public Cell newCell(Row owner)

Creates a new instance of a cell.

Specified by:

newCell in interface Row

Parameters:

owner - the owner

Returns:

the cell

hasCell

public boolean hasCell(int columnIndex)

Returns whether the row alread contains the cell at the specified location.

Specified by:

hasCell in interface Row

Parameters:

columnIndex - the column index

Returns:

true if the cell already exists

hasCell

public boolean hasCell(String cellKey)

Returns whether the row alread contains the cell with the given key.

Specified by:

hasCell in interface Row

Parameters:

cellKey - the key to look for

Returns:

true if the cell already exists

addCell

public Cell addCell(int columnIndex)

Adds a cell with the key of the cell in the header at the specified location. If the cell already exists, it returns that instead of creating one.

Specified by:

addCell in interface Row

Parameters:

columnIndex - the index of the column to create

Returns:

the created cell or the already existing cell, null if outside header bounds

addCell

public Cell addCell(String cellKey)

Adds a cell with the given key to the list and returns the created object. If the cell already exists, then this cell is returned instead and no new object created.

Specified by:

addCell in interface Row

Parameters:

cellKey - the key for the cell to create

Returns:

the created cell or the already existing cell, null if outside header bounds

removeCell

public Cell removeCell(int columnIndex)

Removes the cell at the specified index.

Specified by:

removeCell in interface Row

Parameters:

columnIndex - the index of the column

Returns:

the removed cell, null if not removed

removeCell

public Cell removeCell(String cellKey)

Removes the cell at the specified index.

Specified by:

removeCell in interface Row

Parameters:

cellKey - the key of the cell to remove

Returns:

the removed cell, null if non removed

getCell

public Cell getCell(String cellKey)

Returns the cell with the given key, null if not found.

Specified by:

getCell in interface Row

Parameters:

cellKey - the cell to look for

Returns:

the cell or null if not found

getCell

public Cell getCell(int columnIndex)

Returns the cell with the given index, null if not found.

Specified by:

getCell in interface Row

Parameters:

columnIndex - the index of the column

Returns:

the cell or null if not found

isEmpty

public boolean isEmpty(int columnIndex)

Returns whether the row has a non-empty/non-missing cell at the specified location.

Specified by:

isEmpty in interface Row

Parameters:

columnIndex - the column index

Returns:

true if the cell already exists

isEmpty

public boolean isEmpty(String cellKey)

Returns whether the row has a non-empty/non-missing cell with the given key.

Specified by:

isEmpty in interface Row

Parameters:

cellKey - the key to look for

Returns:

true if the cell already exists

getContent

public String getContent(int columnIndex)

Returns the cell content with the given index.

Specified by:

getContent in interface Row

Parameters:

columnIndex - the index of the column

Returns:

the content or null if not found

getCellKey

public String getCellKey(int columnIndex)

Returns the cell key with the given column index.

Specified by:

getCellKey in interface Row

Parameters:

columnIndex - the index of the column

Returns:

the cell key, null if invalid index

cellKeys

public Collection<String> cellKeys()

Returns a collection of all stored cell keys.

Specified by:

cellKeys in interface Row

Returns:

all cell keys (sorted according to columns)

cells

public Collection<Cell> cells()

Returns all cells.

Specified by:

cells in interface Row

Returns:

the cells

getCellCount

public int getCellCount()

Returns the number of cells stored in the row.

Specified by:

getCellCount in interface Row

Returns:

the number of cells - constant0

removeMissing

public boolean removeMissing()

Does nothing as the underlying data structure is fixed.

Specified by:

removeMissing in interface Row

Returns:

always false

indexOf

public int indexOf(Cell cell)

Returns the column this particular cell is in (must belong to this row!).

Specified by:

indexOf in interface Row

Parameters:

cell - the cell to get the column index of

Returns:

the column index, -1 if not found

spreadSheetColumnInserted

public void spreadSheetColumnInserted(SpreadSheetColumnInsertionEvent e)

A column got inserted.

Specified by:

spreadSheetColumnInserted in interface DataRow

Specified by:

spreadSheetColumnInserted in interface SpreadSheetColumnInsertionListener

Parameters:

e - the insertion event

toString

public String toString()

Returns the internal array of cells as string.

Specified by:

toString in interface Row

Overrides:

toString in class Object

Returns:

the values of the row

mergeWith

public void mergeWith(Row other)

Merges its own data with the one provided by the specified row.

Assumes that this sheet's header has already been updated.

Specified by:

mergeWith in interface Mergeable<Row>

Specified by:

mergeWith in interface Row

Parameters:

other - the row to merge with