ObjectTableModel (JavaUtils / GUI 5.0.1 API)

java.lang.Object
- javax.swing.table.AbstractTableModel
- - tecgraf.javautils.gui.table.ObjectTableModel<T>

Type Parameters:

T - tipo do objeto que representa cada linha da tabela

All Implemented Interfaces:

Serializable, TableModel
```
public class ObjectTableModel<T>
extends AbstractTableModel
```
Modelo para tabelas em que cada objeto representando uma linha da tabela. Este modelo utiliza instâncias da interface ObjectTableProvider para obter os valores das células.

INSTRUÇÕES PARA USO:
Cada objeto da lista a ser passada para o modelo deve ter propriedades que representem as colunas da tabela. O construtor recebe como parâmetro os nomes das colunas e um "provedor de valores" (instância da ObjectTableProvider) para obter a propriedade adequada para cada coluna.

Antes de utilizar essa classe, de uma olhada na classe ColumnsObjectTableModel. Elas são bem parecidas, mas a ColumnsObjectTableModel substitui o ObjectTableProvider por um array de IColumn. Essa mudança na arquitetura,
- facilita o reúso do código da coluna,
- exime o desenvolvedor de trabalhar com o índice das colunas como no ObjectTableProvider,
- facilita verificar se uma célula é editável, pois o método IColumn.isEditable(Object) recebe apenas o objeto-linha, diferente do metodo ModifiableObjectTableProvider.isCellEditable(int, int) que recebe os índices da linha e coluna da célula.
Author:

Leonardo Barros

See Also:

ObjectTableModelSample, Serialized Form

Field Summary
- Fields inherited from class javax.swing.table.AbstractTableModel
  listenerList

Constructor Summary

Constructors
Constructor and Description

ObjectTableModel(List<T> rows, ObjectTableProvider<T> provider)
Cria o modelo.

Constructors
Constructor and Description
`ObjectTableModel(List<T> rows, ObjectTableProvider<T> provider)` Cria o modelo.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(T row)` Adiciona um objeto-linha à lista.
`void`	`addAll(Collection<T> rows)` Adiciona uma coleção de objetos-linha à lista.
`void`	`clear()` Remove todos os elementos de objetos.
`Class<?>`	`getColumnClass(int colIndex)`
`int`	`getColumnCount()`
`String`	`getColumnName(int colIndex)`
`ObjectTableProvider<T>`	`getProvider()` Obtém o `ObjectTableProvider`
`T`	`getRow(int rowIndex)` Obtém um objeto-linha específico.
`int`	`getRowCount()`
`List<T>`	`getRows()` Obtém a lista de objetos-linha atualizada.
`Object`	`getValueAt(int rowIndex, int colIndex)`
`boolean`	`isCellEditable(int rowIndex, int columnIndex)`
`boolean`	`modify(T row)` Modifica os dados de um objeto-linha da lista.
`T`	`remove(int rowIndex)` Remove um objeto-linha da lista pelo seu índice do modelo.
`boolean`	`remove(T row)` Remove um objeto-linha da lista.
`Collection<T>`	`removeAll()` Remove todos os objetos-linha.
`Collection<T>`	`removeAll(int[] rowIndexes)` Remove os objetos-linha especificados pelos seus índices.
`void`	`setRows(List<T> newRows)` Substitui a lista de objetos-linha.
`void`	`setValueAt(Object newValue, int rowIndex, int colIndex)`
`void`	`swapRows(int index1, int index2)` Troca duas linhas no modelo.

Methods inherited from class javax.swing.table.AbstractTableModel
addTableModelListener, findColumn, fireTableCellUpdated, fireTableChanged, fireTableDataChanged, fireTableRowsDeleted, fireTableRowsInserted, fireTableRowsUpdated, fireTableStructureChanged, getListeners, getTableModelListeners, removeTableModelListener

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ObjectTableModel
```
public ObjectTableModel(List<T> rows,
                        ObjectTableProvider<T> provider)
```
    Cria o modelo.
    
    Parameters:
    
    rows - lista de objetos-linha.
    
    provider - provedor para extrair os valores das células dos objetos-linha.
    
    Throws:
    
    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
  - getProvider
```
public ObjectTableProvider<T> getProvider()
```
    Obtém o ObjectTableProvider
    
    Returns:
    
    ObjectTableProvider
  - getRowCount
```
public int getRowCount()
```
  - getColumnCount
```
public int getColumnCount()
```
  - getValueAt
```
public Object getValueAt(int rowIndex,
                         int colIndex)
```
  - setValueAt
```
public void setValueAt(Object newValue,
                       int rowIndex,
                       int colIndex)
```
    Specified by:
    
    setValueAt in interface TableModel
    
    Overrides:
    
    setValueAt in class AbstractTableModel
  - isCellEditable
```
public boolean isCellEditable(int rowIndex,
                              int columnIndex)
```
    Specified by:
    
    isCellEditable in interface TableModel
    
    Overrides:
    
    isCellEditable in class AbstractTableModel
  - getColumnName
```
public String getColumnName(int colIndex)
```
    Specified by:
    
    getColumnName in interface TableModel
    
    Overrides:
    
    getColumnName in class AbstractTableModel
  - getColumnClass
```
public Class<?> getColumnClass(int colIndex)
```
    Specified by:
    
    getColumnClass in interface TableModel
    
    Overrides:
    
    getColumnClass in class AbstractTableModel
  - clear
```
public void clear()
```
    Remove todos os elementos de objetos.
  - setRows
```
public void setRows(List<T> newRows)
```
    Substitui a lista de objetos-linha.
    
    Parameters:
    
    newRows - nova lista de objetos-linha.
    
    Throws:
    
    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:
    
    IllegalArgumentException - se row for nulo.
  - addAll
```
public void addAll(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:
    
    IllegalArgumentException - se rows for nulo.
  - remove
```
public boolean remove(T row)
```
    Remove um objeto-linha da lista.
    
    Parameters:
    
    row - objeto-linha a ser removido.
    
    Returns:
    
    true se o objeto-linha for encontrado e removido com sucesso, false caso contrário.
    
    Throws:
    
    IllegalArgumentException - se row for nulo.
  - remove
```
public T remove(int rowIndex)
```
    Remove um objeto-linha da lista pelo seu índice do modelo.
    
    Parameters:
    
    rowIndex - índice do objeto-linha a ser removido.
    
    Returns:
    
    o objeto-linha removido.
    
    Throws:
    
    IndexOutOfBoundsException - se o índice for negativo ou se for maior do que o tamanho da lista de objeto-linha.
  - removeAll
```
public Collection<T> removeAll(int[] rowIndexes)
```
    Remove os objetos-linha especificados pelos seus índices.
    
    Parameters:
    
    rowIndexes - índices dos objetos-linha a serem removidos.
    
    Returns:
    
    coleção de objetos removidos.
    
    Throws:
    
    IllegalArgumentException - se rowIndexes for nulo.
    
    IndexOutOfBoundsException - se algum índice for negativo ou se for maior do que o tamanho da lista de objeto-linha.
    
    See Also:
    
    AbstractTableModel.fireTableRowsDeleted(int, int)
  - removeAll
```
public Collection<T> removeAll()
```
    Remove todos os objetos-linha.
    
    Returns:
    
    coleção de objetos removidos.
  - modify
```
public boolean modify(T row)
```
    Modifica os dados de um objeto-linha da lista.
    
    Parameters:
    
    row - objeto-linha a ser modificado.
    
    Returns:
    
    true caso o objeto tenha sido modificado com sucesso, false caso este não tenha sido encontrado.
    
    Throws:
    
    IllegalArgumentException - se a linha for null
  - getRows
```
public List<T> getRows()
```
    Obtém a lista de objetos-linha atualizada.
    
    Returns:
    
    lista de objetos-linha.
  - 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:
    
    IndexOutOfBoundsException - se o índice for inválido
  - swapRows
```
public void swapRows(int index1,
                     int index2)
```
    Troca duas linhas no modelo.
    
    Parameters:
    
    index1 - - índice da primeira linha
    
    index2 - - índice da segunda linha

Class ObjectTableModel<T>

Field Summary

Fields inherited from class javax.swing.table.AbstractTableModel

Constructor Summary

Method Summary

Methods inherited from class javax.swing.table.AbstractTableModel

Methods inherited from class java.lang.Object

Constructor Detail

ObjectTableModel

Method Detail

getProvider

getRowCount

getColumnCount

getValueAt

setValueAt

isCellEditable

getColumnName

getColumnClass

clear

setRows

add

addAll

remove

remove

removeAll

removeAll

modify

getRows

getRow

swapRows