csbase.client.facilities.configurabletable.table

Class ConfigurableTable<T>

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JTable

tecgraf.javautils.gui.table.SortableTable

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

Type Parameters:

T - - tipo do objeto que corresponde as linhas da tabela.

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, EventListener, Accessible, CellEditorListener, ListSelectionListener, RowSorterListener, TableColumnModelListener, TableModelListener, Scrollable, tecgraf.javautils.gui.table.SortableTableListener

public class ConfigurableTable<T>
extends tecgraf.javautils.gui.table.SortableTable

Esta tabela utiliza o conceito de que cada instância possui um identificador único. Este identificador é muito útil nos componentes que utilizam essa tabela, por exemplo, TabbedPane4Tables, Panel4Tables e ConfigurableTableFactory. Essa tabela usa o modelo de tabelas definido pela classe ConfigurableTableModel. Para adiconarmos/modificarmos linhas desta tabela basta passarmos uma lista de objetos do tipo T. Essa tabela também permite definir um filtro para suas linhas. Para isso, o filtro deve implementar a interface IFilter. Para criar uma tabela configurável é necessário uma lista de colunas que implementam a interface IConfigurableColumn, uma lista de objetos do tipo T e, opcionalmente, um filtro IFilter. Veja abaixo: List<IConfigurableColumn<Person>> columns = new ArrayList<IConfigurableColumn<Person>>(); ... List<Person> rows = new ArrayList<Person>(); rows.add(new Person(...)); rows.add(new Person(...)); IFilter<Person> filter = new PersonSingleFilter<Person>(); ConfigurableTable<Person> table = new ConfigurableTable<Person>(columns, filter, rows); Para atualizar as linhas dessa tabela basta fazermos: table.setRows(newRows); table.updateRows(); Para atualizar as linhas após setar um filtro basta fazermos: table.setFilter(newFilter); table.updateRows(); Esta tabela também permite que o usuário defina, através de um dialogo da tabela, qual as colunas que ele deseja ver. Para isso, basta clicar com o botão direito sobre a tabela.

Author:

Tecgraf

See Also:

IFilter ConfigurableTableFactory, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JTable

JTable.AccessibleJTable, JTable.DropLocation, JTable.PrintMode

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.JTable

AUTO_RESIZE_ALL_COLUMNS, AUTO_RESIZE_LAST_COLUMN, AUTO_RESIZE_NEXT_COLUMN, AUTO_RESIZE_OFF, AUTO_RESIZE_SUBSEQUENT_COLUMNS, autoCreateColumnsFromModel, autoResizeMode, cellEditor, cellSelectionEnabled, columnModel, dataModel, defaultEditorsByColumnClass, defaultRenderersByColumnClass, editingColumn, editingRow, editorComp, gridColor, preferredViewportSize, rowHeight, rowMargin, rowSelectionAllowed, selectionBackground, selectionForeground, selectionModel, showHorizontalLines, showVerticalLines, tableHeader

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
ConfigurableTable(String id, List<IConfigurableColumn<T>> columns, tecgraf.javautils.core.filter.IFilter<T> filter) Construtor padrão.
ConfigurableTable(String id, List<IConfigurableColumn<T>> columns, tecgraf.javautils.core.filter.IFilter<T> filter, List<T> rows) Construtor.

Method Summary

Modifier and Type	Method and Description
void	addColumnVisibilityListener(ColumnVisibilityListener listener) Adiciona um ouvinte que é acionado sempre que a visibilidade de alguma coluna for alterada.
protected void	addHeaderAction() Adiciona uma ação no header da tabela.
List<JCheckBoxMenuItem>	createColumnsCheckBoxes() Cria uma lista de checkboxes que permite o usuário trocar a visibilidade de cada coluna.
boolean	equals(Object obj)
TableCellEditor	getCellEditor(int row, int column)
TableCellRenderer	getCellRenderer(int row, int column)
List<ColumnState>	getColumnsState() Lista com os estados de todas as colunas.
List<ColumnVisibilityListener>	getColumnVisibilityListeners() Obtém a lista com todos os ouvintes de visibilidade de colunas.
tecgraf.javautils.core.filter.IFilter<T>	getFilter() Obtém o filtro da tabela.
String	getId() Identificador único da tabela.
List<T>	getRows() Obtém a lista de objetos que corresponde as linhas da tabela.
List<T>	getSelectedObjects() Obtem a lista de objetos selecionados.
int	getTotalColumnCount() Número total de colunas (visíveis e ocultas).
int	hashCode()
void	setColumnsState(List<ColumnState> columnsState) Define os estados de todas as colunas.
void	setFilter(tecgraf.javautils.core.filter.IFilter<T> filter) Altera o filtro usado na tabela.
void	setModel(TableModel tableModel) Este método foi sobrescrito para não permitir que o usuário modifique o modelo de tabelas.
void	setRowToKey(RowToKey<T> rowToKey) Define o objeto encarregado de obter uma chave (String) de uma linha genérica.
String	toString()
void	updateColumns() Atualiza a visualização das colunas da tabela.
void	updateRows() Atualiza a visualização das linhas da tabela.
void	updateRows(List<T> newRows) Atualiza a visualização das linhas da tabela.

Methods inherited from class tecgraf.javautils.gui.table.SortableTable

addSortableTableListener, adjustColumnWidth, adjustColumnWidth, adjustRowHeight, adjustSize, convertRowIndexToModel, convertRowIndexToView, createSearchPanel, createSearchPanel, doLayout, getComparator, getCurrentSortOrder, getNoSortStateEnabled, getPreferredCellHeight, getPreferredCellWidth, getPreferredHeaderWidth, getSortedColIndexView, getToolTipEnabled, removeSortableTableListener, setComparator, setComparators, setNoSortStateEnabled, setPreferredColumnWidthToFit, setRemainingSpaceToColumns, setRowFilter, setRowSorter, setSortable, setToolTipEnabled, setUseDisabledLook, sort, sort, sort, sorterChanged, tableSorted

Methods inherited from class javax.swing.JTable

addColumn, addColumnSelectionInterval, addNotify, addRowSelectionInterval, changeSelection, clearSelection, columnAdded, columnAtPoint, columnMarginChanged, columnMoved, columnRemoved, columnSelectionChanged, configureEnclosingScrollPane, convertColumnIndexToModel, convertColumnIndexToView, createDefaultColumnModel, createDefaultColumnsFromModel, createDefaultDataModel, createDefaultEditors, createDefaultRenderers, createDefaultSelectionModel, createDefaultTableHeader, createScrollPaneForTable, editCellAt, editCellAt, editingCanceled, editingStopped, getAccessibleContext, getAutoCreateColumnsFromModel, getAutoCreateRowSorter, getAutoResizeMode, getCellEditor, getCellRect, getCellSelectionEnabled, getColumn, getColumnClass, getColumnCount, getColumnModel, getColumnName, getColumnSelectionAllowed, getDefaultEditor, getDefaultRenderer, getDragEnabled, getDropLocation, getDropMode, getEditingColumn, getEditingRow, getEditorComponent, getFillsViewportHeight, getGridColor, getIntercellSpacing, getModel, getPreferredScrollableViewportSize, getPrintable, getRowCount, getRowHeight, getRowHeight, getRowMargin, getRowSelectionAllowed, getRowSorter, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedColumn, getSelectedColumnCount, getSelectedColumns, getSelectedRow, getSelectedRowCount, getSelectedRows, getSelectionBackground, getSelectionForeground, getSelectionModel, getShowHorizontalLines, getShowVerticalLines, getSurrendersFocusOnKeystroke, getTableHeader, getToolTipText, getUI, getUIClassID, getUpdateSelectionOnSort, getValueAt, initializeLocalVars, isCellEditable, isCellSelected, isColumnSelected, isEditing, isRowSelected, moveColumn, paramString, prepareEditor, prepareRenderer, print, print, print, print, print, processKeyBinding, removeColumn, removeColumnSelectionInterval, removeEditor, removeNotify, removeRowSelectionInterval, resizeAndRepaint, rowAtPoint, selectAll, setAutoCreateColumnsFromModel, setAutoCreateRowSorter, setAutoResizeMode, setCellEditor, setCellSelectionEnabled, setColumnModel, setColumnSelectionAllowed, setColumnSelectionInterval, setDefaultEditor, setDefaultRenderer, setDragEnabled, setDropMode, setEditingColumn, setEditingRow, setFillsViewportHeight, setGridColor, setIntercellSpacing, setPreferredScrollableViewportSize, setRowHeight, setRowHeight, setRowMargin, setRowSelectionAllowed, setRowSelectionInterval, setSelectionBackground, setSelectionForeground, setSelectionMode, setSelectionModel, setShowGrid, setShowHorizontalLines, setShowVerticalLines, setSurrendersFocusOnKeystroke, setTableHeader, setUI, setUpdateSelectionOnSort, setValueAt, sizeColumnsToFit, sizeColumnsToFit, tableChanged, unconfigureEnclosingScrollPane, updateUI, valueChanged

Methods inherited from class javax.swing.JComponent

addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ConfigurableTable

public ConfigurableTable(String id,
                         List<IConfigurableColumn<T>> columns,
                         tecgraf.javautils.core.filter.IFilter<T> filter,
                         List<T> rows)

Construtor.

Parameters:

id - - identificador da tabela.

columns - - colunas da tabela.

filter - - filtro que é utilizado para filtrar as linhas da tabela.

rows - - lista de objetos que definem as linhas da tabela.

ConfigurableTable

public ConfigurableTable(String id,
                         List<IConfigurableColumn<T>> columns,
                         tecgraf.javautils.core.filter.IFilter<T> filter)

Construtor padrão.

Parameters:

id - - identificador da tabela.

columns - - implementação das colunas da tabela.

filter - - filtro das linhas da tabela.

Method Detail

getId

public String getId()

Identificador único da tabela.

Returns:

identificador da tabela.

getRows

public List<T> getRows()

Obtém a lista de objetos que corresponde as linhas da tabela.

Returns:

lista de objetos que corresponde as linhas da tabela.

getFilter

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

Obtém o filtro da tabela.

Returns:

filtro.

getSelectedObjects

public List<T> getSelectedObjects()

Obtem a lista de objetos selecionados.

Returns:

lista de objetos selecionados.

setFilter

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

Altera o filtro usado na tabela.

Parameters:

filter - o filtro.

updateRows

public void updateRows(List<T> newRows)

Atualiza a visualização das linhas da tabela.

Parameters:

newRows - - lista com as novas linhas da tabela.

updateRows

public void updateRows()

Atualiza a visualização das linhas da tabela.

updateColumns

public void updateColumns()

Atualiza a visualização das colunas da tabela.

getColumnsState

public List<ColumnState> getColumnsState()

Lista com os estados de todas as colunas.

Returns:

lista com os estados de todas as colunas.

setColumnsState

public void setColumnsState(List<ColumnState> columnsState)

Define os estados de todas as colunas.

Parameters:

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

createColumnsCheckBoxes

public List<JCheckBoxMenuItem> createColumnsCheckBoxes()

Cria uma lista de checkboxes que permite o usuário trocar a visibilidade de cada coluna.

Returns:

- lista de checkboxes.

getTotalColumnCount

public int getTotalColumnCount()

Número total de colunas (visíveis e ocultas).

Returns:

número de colunas (visíveis e ocultas).

addColumnVisibilityListener

public void addColumnVisibilityListener(ColumnVisibilityListener listener)

Adiciona um ouvinte que é acionado sempre que a visibilidade de alguma coluna for alterada.

Parameters:

listener - - ouvinte

getColumnVisibilityListeners

public List<ColumnVisibilityListener> getColumnVisibilityListeners()

Obtém a lista com todos os ouvintes de visibilidade de colunas.

Returns:

lista de ouvintes.

setRowToKey

public void setRowToKey(RowToKey<T> rowToKey)

Define o objeto encarregado de obter uma chave (String) de uma linha genérica.

Parameters:

rowToKey - - objeto encarregado de obter uma chave (String) de uma linha genérica.

setModel

public void setModel(TableModel tableModel)

Este método foi sobrescrito para não permitir que o usuário modifique o modelo de tabelas.

Overrides:

setModel in class tecgraf.javautils.gui.table.SortableTable

getCellRenderer

public TableCellRenderer getCellRenderer(int row,
                                         int column)

Overrides:

getCellRenderer in class tecgraf.javautils.gui.table.SortableTable

getCellEditor

public TableCellEditor getCellEditor(int row,
                                     int column)

Overrides:

getCellEditor in class JTable

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Component

addHeaderAction

protected void addHeaderAction()

Adiciona uma ação no header da tabela.