csbase.client.facilities.configurabletable.table

Class ConfigurableTableModel<T>

java.lang.Object

javax.swing.table.AbstractTableModel

csbase.client.facilities.configurabletable.table.ConfigurableTableModel<T>

Type Parameters:

T - - tipo dos objetos que correspondem as linhas da tabela.

All Implemented Interfaces:

java.io.Serializable, javax.swing.table.TableModel

public class ConfigurableTableModel<T>
extends javax.swing.table.AbstractTableModel

Modelo de tabelas que trabalha com colunas configuráveis.
As 3 principais características deste modelo são:
1 - As linhas da tabela são representados por uma lista de objetos.
2 - As colunas são configuráveis (IConfigurableColumn).
3 - Usa um filtro para as linhas da tabela (IFilter). Este modelo trabalha apenas com colunas que implementam a interface IConfigurableColumn e, dessa forma, só exibe as colunas que estão configuradas para serem visíveis. Além disso, as linhas definidas por esse modelo são sujeitas a um filtro que implementa a interface IFilter. Dessa forma, esse modelo exibe apenas as linhas filtradas por este filtro, caso o filtro seja nulo, o modelo exibe todas as linhas.

Author:

Tecgraf

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.swing.table.AbstractTableModel

listenerList

Constructor Summary

Constructors

Constructor and Description
ConfigurableTableModel(java.util.List<IConfigurableColumn<T>> columns, tecgraf.javautils.core.filter.IFilter<T> filter, java.util.List<T> rows) Cria o modelo.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(T row) Adiciona um objeto-linha à lista.
void	addAll(java.util.Collection<T> rows) Adiciona uma coleção de objetos-linha à lista.
void	clear() Remove todos os elementos.
void	fireTableDataChanged()
void	fireTableStructureChanged()
java.util.List<IConfigurableColumn<T>>	getAllColumns() Obtém todas as colunas do modelo.
java.util.List<T>	getAllRows() Obtém todos os objetos que correspondem as linhas da tabela.
IConfigurableColumn<T>	getColumn(int columnIndex) Obtém a coluna de índice columnIndex.
IConfigurableColumn<T>	getColumnById(java.lang.String id) Obtém a coluna dado o seu identificador.
java.lang.Class<?>	getColumnClass(int columnIndex)
int	getColumnCount()
java.lang.String	getColumnName(int columnIndex)
java.util.List<IConfigurableColumn<T>>	getColumns() Obtém a lista de colunas visíveis na ordem em que elas aparecem.
java.util.List<ColumnState>	getColumnsState() Lista com os estados de todas as colunas.
tecgraf.javautils.core.filter.IFilter<T>	getFilter() Filtro das linhas.
T	getRow(int rowIndex) Obtém um objeto-linha específico.
int	getRowCount()
java.util.List<T>	getRows() Obtém a lista de objetos (já filtrada) que correspondem as linhas da tabela.
java.lang.Object	getValueAt(int rowIndex, int columnIndex)
boolean	isCellEditable(int rowIndex, int columnIndex)
T	remove(int rowIndex) Remove um objeto da lista pelo seu índice do modelo.
boolean	remove(T row) Remove o objeto da tabela.
java.util.Collection<T>	removeAll(int[] rowIndexes) Remove os objetos especificados pelos seus índices.
void	setColumnsState(java.util.List<ColumnState> columnsState) Define os estados de todas as colunas.
void	setFilter(tecgraf.javautils.core.filter.IFilter<T> filter) Modifica o filtro das linhas.
void	setRows(java.util.List<T> newRows) Substitui a lista de objetos-linha.
void	setValueAt(java.lang.Object newValue, int rowIndex, int columnIndex)

Methods inherited from class javax.swing.table.AbstractTableModel

addTableModelListener, findColumn, fireTableCellUpdated, fireTableChanged, fireTableRowsDeleted, fireTableRowsInserted, fireTableRowsUpdated, getListeners, getTableModelListeners, removeTableModelListener

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfigurableTableModel

public ConfigurableTableModel(java.util.List<IConfigurableColumn<T>> columns,
                      tecgraf.javautils.core.filter.IFilter<T> filter,
                      java.util.List<T> rows)

Cria o modelo.

Parameters:

columns - - Modelo das colunas da tabela na ordem em que devem aparecer.

filter - - filtro das linhas.

rows - - lista de objetos-linha.

Throws:

java.lang.IllegalArgumentException - se a lista de linhas ou o provedor forem iguais a null, ou se a lista de nomes das colunas retornada pelo provedor for null

Method Detail

getColumns

public java.util.List<IConfigurableColumn<T>> getColumns()

Obtém a lista de colunas visíveis na ordem em que elas aparecem.

Returns:

list de colunas visíveis na ordem em que elas aparecem.

getAllColumns

public java.util.List<IConfigurableColumn<T>> getAllColumns()

Obtém todas as colunas do modelo.

Returns:

todas as colunas (visíveis ou não)

getRowCount

public int getRowCount()

getColumnCount

public int getColumnCount()

getColumnName

public java.lang.String getColumnName(int columnIndex)

Specified by:

getColumnName in interface javax.swing.table.TableModel

Overrides:

getColumnName in class javax.swing.table.AbstractTableModel

getColumnClass

public java.lang.Class<?> getColumnClass(int columnIndex)

Specified by:

getColumnClass in interface javax.swing.table.TableModel

Overrides:

getColumnClass in class javax.swing.table.AbstractTableModel

getValueAt

public java.lang.Object getValueAt(int rowIndex,
                          int columnIndex)

setValueAt

public void setValueAt(java.lang.Object newValue,
              int rowIndex,
              int columnIndex)

Specified by:

setValueAt in interface javax.swing.table.TableModel

Overrides:

setValueAt in class javax.swing.table.AbstractTableModel

isCellEditable

public boolean isCellEditable(int rowIndex,
                     int columnIndex)

Specified by:

isCellEditable in interface javax.swing.table.TableModel

Overrides:

isCellEditable in class javax.swing.table.AbstractTableModel

getColumn

public IConfigurableColumn<T> getColumn(int columnIndex)

Obtém a coluna de índice columnIndex.

Parameters:

columnIndex - - índice da coluna.

Returns:

coluna de índice columnIndex.

clear

public void clear()

Remove todos os elementos.

setRows

public void setRows(java.util.List<T> newRows)

Substitui a lista de objetos-linha.

Parameters:

newRows - nova lista de objetos-linha.

Throws:

java.lang.IllegalArgumentException - se a lista de novas linhas for null

add

public void add(T row)

Adiciona um objeto-linha à lista. Se já existir um objeto com o mesmo identificador, este é sobrescrito (não permite duplicatas).

Parameters:

row - objeto-linha a ser adicionado.

Throws:

java.lang.IllegalArgumentException - se row for nulo.

addAll

public void addAll(java.util.Collection<T> rows)

Adiciona uma coleção de objetos-linha à lista. Se já existir um objeto com o mesmo identificador, este é sobrescrito (não permite duplicatas).

Parameters:

rows - coleção de objetos-linha a serem adicionados.

Throws:

java.lang.IllegalArgumentException - se rows for nulo.

remove

public boolean remove(T row)

Remove o objeto da tabela.

Parameters:

row - objeto a ser removido.

Returns:

true se o objeto for removido com sucesso, false caso contrário.

Throws:

java.lang.IllegalArgumentException - se row for nulo.

remove

public T remove(int rowIndex)

Remove um objeto da lista pelo seu índice do modelo.

Parameters:

rowIndex - índice do objeto a ser removido.

Returns:

o objetoremovido.

Throws:

java.lang.IndexOutOfBoundsException - se o índice for negativo ou se for maior do que o tamanho da lista de objeto-linha.

removeAll

public java.util.Collection<T> removeAll(int[] rowIndexes)

Remove os objetos especificados pelos seus índices.

Parameters:

rowIndexes - índices dos objetos a serem removidos.

Returns:

coleção de objetos removidos.

Throws:

java.lang.IllegalArgumentException - se rowIndexes for nulo.

java.lang.IndexOutOfBoundsException - se algum índice for negativo ou se for maior do que o tamanho da lista de objeto-linha.

getRows

public java.util.List<T> getRows()

Obtém a lista de objetos (já filtrada) que correspondem as linhas da tabela.

Returns:

lista de objetos que correspondem as linhas da tabela.

getAllRows

public java.util.List<T> getAllRows()

Obtém todos os objetos que correspondem as linhas da tabela.

Returns:

todos os objetos que correspondem as linhas da tabela.

getRow

public T getRow(int rowIndex)

Obtém um objeto-linha específico.

Parameters:

rowIndex - índice do objeto-linha

Returns:

o objeto-linha solicitado, ou null

Throws:

java.lang.IndexOutOfBoundsException - se o índice for inválido

getFilter

public tecgraf.javautils.core.filter.IFilter<T> getFilter()

Filtro das linhas.

Returns:

filtro das linhas.

setFilter

public void setFilter(tecgraf.javautils.core.filter.IFilter<T> filter)

Modifica o filtro das linhas.

Parameters:

filter - - novo filtro.

getColumnById

public IConfigurableColumn<T> getColumnById(java.lang.String id)

Obtém a coluna dado o seu identificador.

Parameters:

id - - identificador único da coluna.

Returns:

coluna correspondênte.

fireTableDataChanged

public void fireTableDataChanged()

Overrides:

fireTableDataChanged in class javax.swing.table.AbstractTableModel

fireTableStructureChanged

public void fireTableStructureChanged()

Overrides:

fireTableStructureChanged in class javax.swing.table.AbstractTableModel

getColumnsState

public java.util.List<ColumnState> getColumnsState()

Lista com os estados de todas as colunas.

Returns:

lista com os estados de todas as colunas.

setColumnsState

public void setColumnsState(java.util.List<ColumnState> columnsState)

Define os estados de todas as colunas.

Parameters:

columnsState - - lista com os estados de todas as colunas.