xyz.cofe.gui.swing.tree

Class TreeTable

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JTable

xyz.cofe.gui.swing.tree.TreeTable

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, EventListener, Accessible, CellEditorListener, ListSelectionListener, RowSorterListener, TableColumnModelListener, TableModelListener, Scrollable

public class TreeTable
extends JTable

Компонент TreeTable. Компонент Java Swing, для работы с деревом в виде таблицы.

Основные фичи

• Компонент сам хранит внутри себя структуру дерева
• Дерево может динамически изменяться (добавление/удаление/перемещение узлов), компонент берет на себя заботу, по отслеживанию изменения структуры дерева.
• Вершинами дерева, могут являться любые объекты (включая null) и между ними можно задать функции:
  • follow ( node ) : nodes - функцию доступа к дочерним узлам (например file.list())
  • naming( node ) : String - функцию именования вершины
  • followable( node ) : boolean - проверка наличия дочерних узлов
  • и д.р.
• Дерево может быть не однородно по типу данных вершин, так например вполне допускается что вершина File может содержать дочерние вершины как Map/String/... и т.д.
• Дерево может содержать данные которые повторяются, null ссылки и кольца
• Любой узел может содержать свою версию функций: follow, naming, followable, ...
• Узлы дерева полученные через follow кэшируются и могут быть освобождены/перечитаны спустя некоторое время
• Генериуется различные события как раскрытие узла, или добавление узла в дерево и т.д.

Author:

nt.gocha@gmail.com

See Also:

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

Modifier and Type	Field and Description
protected TreeTableNodeValueEditor	nodeEditor
protected TreeTableNodeRender	nodeRender
protected TreeTableNodeBasic	root
protected KeyStroke	toggleNodeFolding
protected TreeTableModel	treeTableModel

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
TreeTable()

Method Summary

Modifier and Type	Method and Description
void	addRootEvent(xyz.cofe.collection.tree.TreeNodeEvent<TreeTableNodeBasic> ev)
Closeable	addRootListener(xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic> listener)
Closeable	addRootListener(xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic> listener, boolean weakLink)
protected void	fireRootEvent(xyz.cofe.collection.tree.TreeNodeEvent<TreeTableNodeBasic> event)
void	fireRootEvents()
int[]	getColumnsWidths()
Column	getDataTreeColumnAtX(int x)
Columns	getDataTreeColumns()
int	getFocusedColumn()
TreeTableNode	getFocusedNode()
int	getFocusedRow()
TreeTableNode	getNodeAt(int x, int y)
Object	getNodeColumnHeaderValue()
String	getNodeColumnName()
TreeTableNodeValueEditor	getNodeEditor()
TreeTableNode	getNodeOf(int row)
TreeTableNodeRender	getNodeRender()
TreeTableNodeBasic	getRoot()
Queue<xyz.cofe.collection.tree.TreeNodeEvent<TreeTableNodeBasic>>	getRootEventQueue()
Set<xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic>>	getRootListeners()
int	getRowOf(TreeTableNode node)
List<TreeTableNode>	getSelectedNodes() Возвращает выбранные узлы
KeyStroke	getToggleNodeFolding()
TreeTableModel	getTreeTableModel()
boolean	hasRootListener(xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic> listener)
protected void	installModel()
protected void	installNodeEditor()
protected void	installNodeRender()
boolean	isRootVisible()
protected boolean	isTreeTableNodeColumn(int x, int y)
protected boolean	isTreeTableNodeIcon(int x, int y) Проверяет что в указанной позиции расплогается иконка сварачивания/разворчанивания узла
protected void	processKeyEvent(KeyEvent e)
protected void	processMouseEvent(MouseEvent e)
protected boolean	processNodeExnderMouseEvent(MouseEvent e, TreeTableNode ttnode)
protected boolean	processNodeKeyEvent(KeyEvent e, TreeTableNode ttnode)
void	removeRootAllListeners()
void	removeRootListener(xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic> listener)
void	setColumnsWidths(boolean pref, int[] w)
void	setFocusedCell(int row, int col) Установка фокуса на определенную ячейку таблицы
void	setFocusedNode(TreeTableNode node)
void	setNodeColumnHeaderValue(Object value)
void	setNodeColumnName(String name)
void	setRoot(TreeTableNodeBasic newroot)
void	setRootVisible(boolean rootVisible)
void	setSelectedRows(int[] rows) Устанавливает выбранные строки
void	setToggleNodeFolding(KeyStroke toggleNodeFolding)

Methods inherited from class javax.swing.JTable

addColumn, addColumnSelectionInterval, addNotify, addRowSelectionInterval, changeSelection, clearSelection, columnAdded, columnAtPoint, columnMarginChanged, columnMoved, columnRemoved, columnSelectionChanged, configureEnclosingScrollPane, convertColumnIndexToModel, convertColumnIndexToView, convertRowIndexToModel, convertRowIndexToView, createDefaultColumnModel, createDefaultColumnsFromModel, createDefaultDataModel, createDefaultEditors, createDefaultRenderers, createDefaultSelectionModel, createDefaultTableHeader, createScrollPaneForTable, doLayout, editCellAt, editCellAt, editingCanceled, editingStopped, getAccessibleContext, getAutoCreateColumnsFromModel, getAutoCreateRowSorter, getAutoResizeMode, getCellEditor, getCellEditor, getCellRect, getCellRenderer, 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, setModel, setPreferredScrollableViewportSize, setRowHeight, setRowHeight, setRowMargin, setRowSelectionAllowed, setRowSelectionInterval, setRowSorter, setSelectionBackground, setSelectionForeground, setSelectionMode, setSelectionModel, setShowGrid, setShowHorizontalLines, setShowVerticalLines, setSurrendersFocusOnKeystroke, setTableHeader, setUI, setUpdateSelectionOnSort, setValueAt, sizeColumnsToFit, sizeColumnsToFit, sorterChanged, 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, 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, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

nodeRender

protected volatile TreeTableNodeRender nodeRender

nodeEditor

protected TreeTableNodeValueEditor nodeEditor

root

protected TreeTableNodeBasic root

treeTableModel

protected TreeTableModel treeTableModel

toggleNodeFolding

protected KeyStroke toggleNodeFolding

Constructor Detail

TreeTable

public TreeTable()

Method Detail

getNodeRender

public TreeTableNodeRender getNodeRender()

installNodeRender

protected void installNodeRender()

getNodeEditor

public TreeTableNodeValueEditor getNodeEditor()

installNodeEditor

protected void installNodeEditor()

getRoot

public TreeTableNodeBasic getRoot()

setRoot

public void setRoot(TreeTableNodeBasic newroot)

hasRootListener

public boolean hasRootListener(xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic> listener)

getRootListeners

public Set<xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic>> getRootListeners()

addRootListener

public Closeable addRootListener(xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic> listener)

addRootListener

public Closeable addRootListener(xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic> listener,
                                 boolean weakLink)

removeRootListener

public void removeRootListener(xyz.cofe.collection.tree.TreeNodeListener<TreeTableNodeBasic> listener)

removeRootAllListeners

public void removeRootAllListeners()

fireRootEvent

protected void fireRootEvent(xyz.cofe.collection.tree.TreeNodeEvent<TreeTableNodeBasic> event)

getRootEventQueue

public Queue<xyz.cofe.collection.tree.TreeNodeEvent<TreeTableNodeBasic>> getRootEventQueue()

addRootEvent

public void addRootEvent(xyz.cofe.collection.tree.TreeNodeEvent<TreeTableNodeBasic> ev)

fireRootEvents

public void fireRootEvents()

getTreeTableModel

public TreeTableModel getTreeTableModel()

installModel

protected void installModel()

getNodeOf

public TreeTableNode getNodeOf(int row)

getRowOf

public int getRowOf(TreeTableNode node)

isRootVisible

public boolean isRootVisible()

setRootVisible

public void setRootVisible(boolean rootVisible)

getColumnsWidths

public int[] getColumnsWidths()

setColumnsWidths

public void setColumnsWidths(boolean pref,
                             int[] w)

getDataTreeColumns

public Columns getDataTreeColumns()

getDataTreeColumnAtX

public Column getDataTreeColumnAtX(int x)

getNodeAt

public TreeTableNode getNodeAt(int x,
                               int y)

getNodeColumnName

public String getNodeColumnName()

setNodeColumnName

public void setNodeColumnName(String name)

getNodeColumnHeaderValue

public Object getNodeColumnHeaderValue()

setNodeColumnHeaderValue

public void setNodeColumnHeaderValue(Object value)

isTreeTableNodeColumn

protected boolean isTreeTableNodeColumn(int x,
                                        int y)

isTreeTableNodeIcon

protected boolean isTreeTableNodeIcon(int x,
                                      int y)

Проверяет что в указанной позиции расплогается иконка сварачивания/разворчанивания узла

Parameters:

x - координаты

y - координаты

Returns:

true - расположена икона

getToggleNodeFolding

public KeyStroke getToggleNodeFolding()

setToggleNodeFolding

public void setToggleNodeFolding(KeyStroke toggleNodeFolding)

processNodeExnderMouseEvent

protected boolean processNodeExnderMouseEvent(MouseEvent e,
                                              TreeTableNode ttnode)

processNodeKeyEvent

protected boolean processNodeKeyEvent(KeyEvent e,
                                      TreeTableNode ttnode)

processMouseEvent

protected void processMouseEvent(MouseEvent e)

Overrides:

processMouseEvent in class JComponent

processKeyEvent

protected void processKeyEvent(KeyEvent e)

Overrides:

processKeyEvent in class JComponent

getSelectedNodes

public List<TreeTableNode> getSelectedNodes()

Возвращает выбранные узлы

Returns:

выбранные узлы или пустой список

setSelectedRows

public void setSelectedRows(int[] rows)

Устанавливает выбранные строки

Parameters:

rows - строки таблицы

getFocusedRow

public int getFocusedRow()

getFocusedColumn

public int getFocusedColumn()

setFocusedCell

public void setFocusedCell(int row,
                           int col)

Установка фокуса на определенную ячейку таблицы

Parameters:

row - строка

col - ячейка

getFocusedNode

public TreeTableNode getFocusedNode()

setFocusedNode

public void setFocusedNode(TreeTableNode node)