org.onosproject.ui.table

Class TableModel

java.lang.Object

org.onosproject.ui.table.TableModel

public class TableModel
extends Object

A simple model of table data.

Note that this is not a full MVC type model; the expected usage pattern is to create an empty table, add rows (by consulting the business model), sort rows (based on client request parameters), and finally produce the sorted list of rows.

The table also provides a mechanism for defining how cell values for a particular column should be formatted into strings, to help facilitate the encoding of the table data into a JSON structure.

Note that it is expected that all values for a particular column will be the same class.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	TableModel.Row Model of a row.
static class	TableModel.SortDir Designates sorting direction.

Constructor Summary

Constructors

Constructor and Description
TableModel(String... columnIds) Constructs a table (devoid of data) with the given column IDs.

Method Summary

Modifier and Type	Method and Description
TableModel.Row	addRow() Adds a row to the table model.
int	columnCount() Returns the number of columns in this table model.
String[]	getColumnIds() Returns the array of column IDs for this table model.
CellFormatter	getFormatter(String columnId) Returns the cell formatter to use on values in the specified column.
TableModel.Row[]	getRows() Returns the raw TableModel.Row representation of the rows in this table.
int	rowCount() Returns the number of rows in this table model.
void	setComparator(String columnId, CellComparator comparator) Sets a cell comparator for the specified column.
void	setFormatter(String columnId, CellFormatter formatter) Sets a cell formatter for the specified column.
void	sort(String columnId, TableModel.SortDir dir) Sorts the table rows based on the specified column, in the specified direction.
static TableModel.SortDir	sortDir(String s) Returns the appropriate sort direction for the given string.

Methods inherited from class java.lang.Object

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

Constructor Detail

TableModel

public TableModel(String... columnIds)

Constructs a table (devoid of data) with the given column IDs.

Parameters:

columnIds - column identifiers

Method Detail

rowCount

public int rowCount()

Returns the number of rows in this table model.

Returns:

number of rows

columnCount

public int columnCount()

Returns the number of columns in this table model.

Returns:

number of columns

getColumnIds

public String[] getColumnIds()

Returns the array of column IDs for this table model.

Implementation note: we are knowingly passing you a reference to our internal array to avoid copying. Don't mess with it. It's your table you'll break if you do!

Returns:

the column identifiers

getRows

public TableModel.Row[] getRows()

Returns the raw TableModel.Row representation of the rows in this table.

Returns:

raw table rows

setComparator

public void setComparator(String columnId,
                          CellComparator comparator)

Sets a cell comparator for the specified column.

Parameters:

columnId - column identifier

comparator - comparator to use

setFormatter

public void setFormatter(String columnId,
                         CellFormatter formatter)

Sets a cell formatter for the specified column.

Parameters:

columnId - column identifier

formatter - formatter to use

getFormatter

public CellFormatter getFormatter(String columnId)

Returns the cell formatter to use on values in the specified column.

Parameters:

columnId - column identifier

Returns:

an appropriate cell formatter

addRow

public TableModel.Row addRow()

Adds a row to the table model.

Returns:

the row, for chaining

sort

public void sort(String columnId,
                 TableModel.SortDir dir)

Sorts the table rows based on the specified column, in the specified direction.

Parameters:

columnId - column identifier

dir - sort direction

sortDir

public static TableModel.SortDir sortDir(String s)

Returns the appropriate sort direction for the given string.

The expected strings are "asc" for ascending and "desc" for descending. Any other value will default to ascending.

Parameters:

s - sort direction string encoding

Returns:

sort direction