org.wandora.application.gui.topicpanels

Class TreeTopicPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

org.wandora.application.gui.topicpanels.TreeTopicPanel

All Implemented Interfaces:

java.awt.event.ActionListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, TopicPanel, TopicMapListener

public class TreeTopicPanel
extends javax.swing.JPanel
implements java.awt.event.ActionListener, TopicPanel

Author:

akivela

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JPanel.AccessibleJPanel

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

javax.swing.JComponent.AccessibleJComponent

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

java.awt.Container.AccessibleAWTContainer

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

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
private TopicTreeRelation[]	allRelations
private Topic	openedTopic
private Options	options
private java.lang.String	rootSubject
private java.util.Set<java.lang.String>	selectedRelations
private java.lang.String	title
private TopicTreePanel	topicTreePanel
private javax.swing.JPanel	treeContainerPanel

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
TreeTopicPanel() Creates new form TreeTopicPanel

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(java.awt.event.ActionEvent e)
boolean	applyChanges() Topic panel should store all pending changes immediately.
void	associationChanged(Association a) A notification used to report general or large changes in association.
void	associationPlayerChanged(Association a, Topic role, Topic newPlayer, Topic oldPlayer) A notification that a player in an association with a certain role has been changed.
void	associationRemoved(Association a) A notification that an association has been completely removed.
void	associationTypeChanged(Association a, Topic newType, Topic oldType) A notification that association type has changed.
void	configure()
javax.swing.JPanel	getGui() Return the UI element for the topic panel.
javax.swing.Icon	getIcon() Return icon image of the topic panel.
java.lang.String	getName() Return name of the topic panel.
int	getOrder() Return integer number that specifies topic panel's order.
java.lang.String	getTitle() Return title of the topic panel.
Topic	getTopic() Return the active topic in topic panel.
LocatorHistory	getTopicHistory() A topic panel can store it's own topic history.
javax.swing.JMenu	getViewMenu()
java.lang.Object[]	getViewMenuStruct() Topic panel can provide a menu structure that Wandora views in UI.
javax.swing.JPopupMenu	getViewPopupMenu()
void	init() Initialize the TopicPanel.
private void	initComponents() This method is called from within the constructor to initialize the form.
boolean	noScroll() If this returns true, then the topic panel will not be wrapped inside a scroll pane.
void	open(Topic topic) Open a topic in the topic panel.
void	refresh() Request topic panel UI refresh.
void	setRootTopic(Topic newRoot)
void	stop() A topic panel should stop all threads and close all (shared) resources.
boolean	supportsOpenTopic() Does the topic panel support topic open? In other words can one call the open method with a topic.
void	topicBaseNameChanged(Topic t, java.lang.String newName, java.lang.String oldName) Notification that the base name has been changed.
void	topicChanged(Topic t) A notification used to report general or large changes in topic, for example when topics are merged.
void	topicDataChanged(Topic t, Topic type, Topic version, java.lang.String newValue, java.lang.String oldValue) Notification that topic occurrence has been changed.
void	topicRemoved(Topic t) Notification that a topic has been completely removed.
void	topicSubjectIdentifierChanged(Topic t, Locator added, Locator removed) Notification that a subject identifier has changed.
void	topicSubjectLocatorChanged(Topic t, Locator newLocator, Locator oldLocator) Notification that the subject locator has been changed.
void	topicTypeChanged(Topic t, Topic added, Topic removed) Notification that a topic type has changed.
void	topicVariantChanged(Topic t, java.util.Collection<Topic> scope, java.lang.String newName, java.lang.String oldName) Notification that a variant name has been changed.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, 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, 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, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, 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, doLayout, 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, 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

title

private java.lang.String title

options

private Options options

topicTreePanel

private TopicTreePanel topicTreePanel

rootSubject

private java.lang.String rootSubject

selectedRelations

private java.util.Set<java.lang.String> selectedRelations

allRelations

private TopicTreeRelation[] allRelations

openedTopic

private Topic openedTopic

treeContainerPanel

private javax.swing.JPanel treeContainerPanel

Constructor Detail

TreeTopicPanel

public TreeTopicPanel()

Creates new form TreeTopicPanel

Method Detail

init

public void init()

Description copied from interface: TopicPanel

Initialize the TopicPanel. Called always before the topic panel is used

Specified by:

init in interface TopicPanel

initComponents

private void initComponents()

This method is called from within the constructor to initialize the form. WARNING: Do NOT modify this code. The content of this method is always regenerated by the Form Editor.

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Specified by:

actionPerformed in interface java.awt.event.ActionListener

configure

public void configure()

supportsOpenTopic

public boolean supportsOpenTopic()

Description copied from interface: TopicPanel

Does the topic panel support topic open? In other words can one call the open method with a topic.

Specified by:

supportsOpenTopic in interface TopicPanel

open

public void open(Topic topic)
          throws TopicMapException,
                 OpenTopicNotSupportedException

Description copied from interface: TopicPanel

Open a topic in the topic panel. Usually opening means that the topic is being visualized in some way.

Specified by:

open in interface TopicPanel

Throws:

TopicMapException

OpenTopicNotSupportedException

stop

public void stop()

Description copied from interface: TopicPanel

A topic panel should stop all threads and close all (shared) resources. Stopping closes the topic panel too.

Specified by:

stop in interface TopicPanel

refresh

public void refresh()
             throws TopicMapException

Description copied from interface: TopicPanel

Request topic panel UI refresh. The topic panel should refresh it's content and trigger repaint.

Specified by:

refresh in interface TopicPanel

Throws:

TopicMapException

applyChanges

public boolean applyChanges()
                     throws CancelledException,
                            TopicMapException

Description copied from interface: TopicPanel

Topic panel should store all pending changes immediately. Especially topic and association changes are important and should be stored during applyChanges.

Specified by:

applyChanges in interface TopicPanel

Throws:

CancelledException

TopicMapException

getGui

public javax.swing.JPanel getGui()

Description copied from interface: TopicPanel

Return the UI element for the topic panel. Wandora gets topic panel's UI element here.

Specified by:

getGui in interface TopicPanel

getTopic

public Topic getTopic()
               throws TopicMapException

Description copied from interface: TopicPanel

Return the active topic in topic panel. Usually the returned topic is the same topic that was opened with open methed.

Specified by:

getTopic in interface TopicPanel

Throws:

TopicMapException

getName

public java.lang.String getName()

Description copied from interface: TopicPanel

Return name of the topic panel. Name is viewed in Wandora's UI.

Specified by:

getName in interface TopicPanel

Overrides:

getName in class java.awt.Component

getTitle

public java.lang.String getTitle()

Description copied from interface: TopicPanel

Return title of the topic panel. Name is viewed in the title bar of dockable.

Specified by:

getTitle in interface TopicPanel

getIcon

public javax.swing.Icon getIcon()

Description copied from interface: TopicPanel

Return icon image of the topic panel. Icon is viewed in Wandora's UI.

Specified by:

getIcon in interface TopicPanel

noScroll

public boolean noScroll()

Description copied from interface: TopicPanel

If this returns true, then the topic panel will not be wrapped inside a scroll pane. Useful if the panel provides its own scrolling.

Specified by:

noScroll in interface TopicPanel

getOrder

public int getOrder()

Description copied from interface: TopicPanel

Return integer number that specifies topic panel's order. Order is used to sort topic panel sets. Order number is not used anymore as available panels are read from options.xml and the order in options is the order Wandora views the panels.

Specified by:

getOrder in interface TopicPanel

getViewMenuStruct

public java.lang.Object[] getViewMenuStruct()

Description copied from interface: TopicPanel

Topic panel can provide a menu structure that Wandora views in UI. This method returns a plain object array of menu objects. Plain object array is transformed into a menu using UIBox.

Specified by:

getViewMenuStruct in interface TopicPanel

getViewMenu

public javax.swing.JMenu getViewMenu()

Specified by:

getViewMenu in interface TopicPanel

getViewPopupMenu

public javax.swing.JPopupMenu getViewPopupMenu()

Specified by:

getViewPopupMenu in interface TopicPanel

getTopicHistory

public LocatorHistory getTopicHistory()

Description copied from interface: TopicPanel

A topic panel can store it's own topic history. Topic history is used to navigate backward and forward in Wandora. However, this is a hidden feature and has NOT been taken into production yet! Thus, Wandora doesn't support the topic panel specific topic histories yet!

Specified by:

getTopicHistory in interface TopicPanel

setRootTopic

public void setRootTopic(Topic newRoot)

topicSubjectIdentifierChanged

public void topicSubjectIdentifierChanged(Topic t,
                                          Locator added,
                                          Locator removed)
                                   throws TopicMapException

Description copied from interface: TopicMapListener

Notification that a subject identifier has changed. Either added or removed is non-null and indicates that a subject identifier has been added or removed, respectively. The non-null parameter contains the new subject identifier or the removed subject identifier.

Specified by:

topicSubjectIdentifierChanged in interface TopicMapListener

Throws:

TopicMapException

topicBaseNameChanged

public void topicBaseNameChanged(Topic t,
                                 java.lang.String newName,
                                 java.lang.String oldName)
                          throws TopicMapException

Description copied from interface: TopicMapListener

Notification that the base name has been changed. Either newName or oldName may be null indicating that base name was removed or old name was empty.

Specified by:

topicBaseNameChanged in interface TopicMapListener

Throws:

TopicMapException

topicTypeChanged

public void topicTypeChanged(Topic t,
                             Topic added,
                             Topic removed)
                      throws TopicMapException

Description copied from interface: TopicMapListener

Notification that a topic type has changed. Either added or removed is non-null and indicates that a type has been added or removed, respectively. The non-null parameter contains the new type or the removed type.

Specified by:

topicTypeChanged in interface TopicMapListener

Throws:

TopicMapException

topicVariantChanged

public void topicVariantChanged(Topic t,
                                java.util.Collection<Topic> scope,
                                java.lang.String newName,
                                java.lang.String oldName)
                         throws TopicMapException

Description copied from interface: TopicMapListener

Notification that a variant name has been changed. Either newName or oldName may be null indicating that the variant name was removed or old name was empty.

Specified by:

topicVariantChanged in interface TopicMapListener

Throws:

TopicMapException

topicDataChanged

public void topicDataChanged(Topic t,
                             Topic type,
                             Topic version,
                             java.lang.String newValue,
                             java.lang.String oldValue)
                      throws TopicMapException

Description copied from interface: TopicMapListener

Notification that topic occurrence has been changed. Either newValue or oldValue may be null indicating that the occurrence was removed or old value was empty.

Specified by:

topicDataChanged in interface TopicMapListener

Throws:

TopicMapException

topicSubjectLocatorChanged

public void topicSubjectLocatorChanged(Topic t,
                                       Locator newLocator,
                                       Locator oldLocator)
                                throws TopicMapException

Description copied from interface: TopicMapListener

Notification that the subject locator has been changed. Either newLocator or oldLocator may be null indicating that locator was removed or there was no old locator.

Specified by:

topicSubjectLocatorChanged in interface TopicMapListener

Throws:

TopicMapException

topicRemoved

public void topicRemoved(Topic t)
                  throws TopicMapException

Description copied from interface: TopicMapListener

Notification that a topic has been completely removed.

Specified by:

topicRemoved in interface TopicMapListener

Throws:

TopicMapException

topicChanged

public void topicChanged(Topic t)
                  throws TopicMapException

Description copied from interface: TopicMapListener

A notification used to report general or large changes in topic, for example when topics are merged. Such a large change may consist of any number of smaller changes that are NOT reported individually with the other listener methods. This method is used when tracking individual changes is hard to implement.

Specified by:

topicChanged in interface TopicMapListener

Throws:

TopicMapException

associationTypeChanged

public void associationTypeChanged(Association a,
                                   Topic newType,
                                   Topic oldType)
                            throws TopicMapException

Description copied from interface: TopicMapListener

A notification that association type has changed. Either newType or oldType can be null to indicate that old or new type was null. When type is changed from one topic to another, both will be non-null.

Specified by:

associationTypeChanged in interface TopicMapListener

Throws:

TopicMapException

associationPlayerChanged

public void associationPlayerChanged(Association a,
                                     Topic role,
                                     Topic newPlayer,
                                     Topic oldPlayer)
                              throws TopicMapException

Description copied from interface: TopicMapListener

A notification that a player in an association with a certain role has been changed. Either newPlayer or oldPlayer can be null to indicate that the no new player for the role was set or that there was no player with the role previously. Both can also be non-null to indicate that the player of the role changed.

Specified by:

associationPlayerChanged in interface TopicMapListener

Throws:

TopicMapException

associationRemoved

public void associationRemoved(Association a)
                        throws TopicMapException

Description copied from interface: TopicMapListener

A notification that an association has been completely removed.

Specified by:

associationRemoved in interface TopicMapListener

Throws:

TopicMapException

associationChanged

public void associationChanged(Association a)
                        throws TopicMapException

Description copied from interface: TopicMapListener

A notification used to report general or large changes in association. Such a large change may consist of any number of smaller changes that are NOT reported individually with the other listener methods. This method is used when tracking individual changes is hard to implement.

Specified by:

associationChanged in interface TopicMapListener

Throws:

TopicMapException