org.tentackle.swing.rdc

Class PdoLinkPanel<T extends PersistentDomainObject<T>>

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

org.tentackle.swing.FormPanel

org.tentackle.swing.FormComponentPanel

org.tentackle.swing.FormFieldComponentPanel

org.tentackle.swing.rdc.PdoLinkPanel<T>

Type Parameters:

T - the pdo type

All Implemented Interfaces:

DropTargetListener, ContainerListener, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, FormChangeable, FormChangeableComponent, FormComponent, FormContainer, FormFieldComponent

public class PdoLinkPanel<T extends PersistentDomainObject<T>>
extends FormFieldComponentPanel
implements DropTargetListener

A panel containing a non-editable FormField representing showing the short text (unique key) of the data object, an optional info field (long text) and buttons for editing, search (link) and clear (unlink).

See Also:

PdoFieldPanel, Serialized Form

Nested Class Summary

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

JPanel.AccessibleJPanel

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.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 org.tentackle.swing.FormFieldComponent

ADJUST_LEFT, ADJUST_NONE, ADJUST_RIGHT, ADJUST_TRIM, CONVERT_LC, CONVERT_NONE, CONVERT_UC

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
PdoLinkPanel() Creates an application database object link panel.

Method Summary

Modifier and Type	Method and Description
PdoSearchDialog<T>	createSearchDialog() Creates the search dialog.
void	dragEnter(DropTargetDragEvent event)
void	dragExit(DropTargetEvent event)
void	dragOver(DropTargetDragEvent event)
void	drop(DropTargetDropEvent event)
void	dropActionChanged(DropTargetDragEvent event)
Object	getFormValue()
T	getLink() Gets the linked object.
long	getLinkId() Gets the object ID of the link.
boolean	isChangeable()
boolean	isDropEnabled() Returns whether the component of this linkpanel is a dropzone.
boolean	isEditButtonVisible() Gets the visibility of the edit button.
boolean	requestFocusInWindow()
void	runEdit() Edits the object
void	runSearch() Runs the search
void	setCellEditorUsage(boolean flag)
void	setChangeable(boolean flag)
void	setDropEnabled(boolean dropEnabled) Sets the component of this linkpanel to be a drop zone.
void	setEditButtonVisible(boolean visible) Sets the visibility of the edit button. Some apps don't want the user to edit the object.
void	setFormComponent(FormComponent comp)
void	setFormValue(Object obj)
void	setLink(Class<T> clazz, DomainContext context, long linkedId) Set the link with default plugin.
void	setLink(Class<T> clazz, DomainContext context, long linkedId, boolean keepPlugin) Set the link with default plugin.
void	setLink(PdoSearch<T> pdoSearch, long linkedId) Sets the link.
void	setLink(T object) Sets the link object (if plugin matches).
void	setName(String name)

Methods inherited from class org.tentackle.swing.FormFieldComponentPanel

clearText, doFormat, downRight, getAdjust, getCaretPosition, getColumns, getConvert, getConverter, getDefaultColumns, getErrorMessage, getErrorOffset, getFiller, getFormat, getFormComponent, getHorizontalAlignment, getInvalidChars, getMaxColumns, getText, getToolTipText, getValidChars, getVerticalAlignment, isAutoNext, isAutoSelect, isCaretLeft, isCaretRight, isEmpty, isEraseFirst, isInhibitAutoSelect, isOverwrite, isStartEditLeftmost, postActionEvent, setAdjust, setAutoNext, setAutoSelect, setCaretLeft, setCaretPosition, setCaretRight, setColumns, setConvert, setConverter, setDefaultColumns, setEraseFirst, setErrorMessage, setErrorOffset, setFiller, setFormat, setHorizontalAlignment, setInhibitAutoSelect, setInvalidChars, setMaxColumns, setOverwrite, setStartEditLeftmost, setText, setToolTipText, setValidChars, setVerticalAlignment, upLeft

Methods inherited from class org.tentackle.swing.FormComponentPanel

addValueListener, clearValueShownModified, fireValueChanged, fireValueEntered, getBaseline, getBinding, getBindingPath, getComponentPath, getFocusTraversalGroup, getHelpURL, getParentWindow, getPropertyGroup, getValueShown, hasFocus, invalidateParentInfo, isAutoUpdate, isBindable, isCellEditorUsage, isFireRunning, isFormTraversable, isHonourChangeable, isMandatory, isSmartValueEntered, isTriggerValueChangedEnabled, isValueChanged, isValueShownModified, prepareFocusLost, removeValueListener, requestFocus, requestFocus, requestFocusLater, saveValue, setAutoUpdate, setBindable, setBinding, setBindingPath, setComponentPath, setFireRunning, setFocusTraversalGroup, setFormTraversable, setFormWrapWindow, setHelpURL, setHonourChangeable, setMandatory, setPropertyGroup, setSmartValueEntered, setTriggerValueChangedEnabled, showErrorPopup, showHelp, triggerValueChanged, updateAllChangeable, wasFocusGainedFromTransfer, wasFocusGainedFromTransferBackward, wasTransferFocus, wasTransferFocusBackward, wasTransferFocusByEnter

Methods inherited from class org.tentackle.swing.FormPanel

addActionListener, areValuesChanged, componentAdded, componentRemoved, createBinder, fireActionPerformed, getBinder, getFormValues, getTitle, isTriggerValuesChangedEnabled, removeActionListener, saveValues, setFormValues, setFormValuesKeepChanged, setTitle, setTriggerValuesChangedEnabled, triggerValuesChanged

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, 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, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, 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, 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, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, 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, 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

Methods inherited from interface org.tentackle.swing.FormComponent

addValueListener, clearValueShownModified, fireValueChanged, fireValueEntered, getBaseline, getBinding, getBindingPath, getComponentPath, getFocusTraversalGroup, getHelpURL, getParentWindow, getPropertyGroup, getValueShown, hasFocus, invalidateParentInfo, isAutoUpdate, isBindable, isCellEditorUsage, isFireRunning, isFormTraversable, isMandatory, isSmartValueEntered, isTriggerValueChangedEnabled, isValueChanged, isValueShownModified, prepareFocusLost, removeValueListener, requestFocusLater, saveValue, setAutoUpdate, setBindable, setBinding, setBindingPath, setComponentPath, setFireRunning, setFocusTraversalGroup, setFormTraversable, setFormWrapWindow, setHelpURL, setMandatory, setPropertyGroup, setSmartValueEntered, setTriggerValueChangedEnabled, showErrorPopup, showHelp, transferFocus, transferFocusBackward, triggerValueChanged, wasFocusGainedFromTransfer, wasFocusGainedFromTransferBackward, wasTransferFocus, wasTransferFocusBackward, wasTransferFocusByEnter

Methods inherited from interface org.tentackle.swing.FormChangeableComponent

updateAllChangeable

Methods inherited from interface org.tentackle.swing.FormChangeable

isHonourChangeable, setHonourChangeable

Constructor Detail

PdoLinkPanel

public PdoLinkPanel()

Creates an application database object link panel.

Method Detail

setName

public void setName(String name)

Overridden to set the names in subcomponents.

Overrides:

setName in class Component

setFormComponent

public void setFormComponent(FormComponent comp)

Overrides:

setFormComponent in class FormComponentPanel

setDropEnabled

public void setDropEnabled(boolean dropEnabled)

Sets the component of this linkpanel to be a drop zone.

The default is true.

Parameters:

dropEnabled - true if this is a drop zone, false if not

isDropEnabled

public boolean isDropEnabled()

Returns whether the component of this linkpanel is a dropzone.

Returns:

true if this is a drop zone, false if not

setEditButtonVisible

public void setEditButtonVisible(boolean visible)

Sets the visibility of the edit button.
Some apps don't want the user to edit the object. The default is visible.

Parameters:

visible - true if editbutton is visible

isEditButtonVisible

public boolean isEditButtonVisible()

Gets the visibility of the edit button.

Returns:

true if editbutton is visible

setFormValue

public void setFormValue(Object obj)

Overridden due to binding.
Notice that obj may be null. In such a case the domain context will be retrieved from the bindingProperty DomainContext.class from the formcontainer.

Specified by:

setFormValue in interface FormComponent

Overrides:

setFormValue in class FormComponentPanel

getFormValue

public Object getFormValue()

Overridden due to binding.

Specified by:

getFormValue in interface FormComponent

Overrides:

getFormValue in class FormComponentPanel

setLink

public void setLink(PdoSearch<T> pdoSearch,
                    long linkedId)

Sets the link.

Parameters:

pdoSearch - the PdoSearch to be used

linkedId - the original, i.e. current ID of the linked object

setLink

public void setLink(T object)

Sets the link object (if plugin matches).

Parameters:

object - the database object

setLink

public void setLink(Class<T> clazz,
                    DomainContext context,
                    long linkedId,
                    boolean keepPlugin)

Set the link with default plugin.

Parameters:

clazz - the class of the linked object, e.g. Konto.class

context - is the db-connection with context

linkedId - the original, i.e. current Id of the linked object

keepPlugin - is true if keep plugin if already initialized

setLink

public void setLink(Class<T> clazz,
                    DomainContext context,
                    long linkedId)

Set the link with default plugin.

Parameters:

clazz - the class of the linked object, e.g. Konto.class

context - is the db-connection with context

linkedId - the original, i.e. current Id of the linked object

getLinkId

public long getLinkId()

Gets the object ID of the link.

Returns:

the object ID, 0 if none

getLink

public T getLink()

Gets the linked object.

Returns:

the object, null if none

setChangeable

public void setChangeable(boolean flag)

Specified by:

setChangeable in interface FormChangeable

Overrides:

setChangeable in class FormComponentPanel

isChangeable

public boolean isChangeable()

Specified by:

isChangeable in interface FormChangeable

Overrides:

isChangeable in class FormComponentPanel

requestFocusInWindow

public boolean requestFocusInWindow()

Overrides:

requestFocusInWindow in class FormComponentPanel

setCellEditorUsage

public void setCellEditorUsage(boolean flag)

Specified by:

setCellEditorUsage in interface FormComponent

Overrides:

setCellEditorUsage in class FormComponentPanel

dragEnter

public void dragEnter(DropTargetDragEvent event)

Specified by:

dragEnter in interface DropTargetListener

dragExit

public void dragExit(DropTargetEvent event)

Specified by:

dragExit in interface DropTargetListener

dragOver

public void dragOver(DropTargetDragEvent event)

Specified by:

dragOver in interface DropTargetListener

dropActionChanged

public void dropActionChanged(DropTargetDragEvent event)

Specified by:

dropActionChanged in interface DropTargetListener

drop

public void drop(DropTargetDropEvent event)

Specified by:

drop in interface DropTargetListener

createSearchDialog

public PdoSearchDialog<T> createSearchDialog()

Creates the search dialog.

Invoked from runSearch().

Returns:

the dialog

runSearch

public void runSearch()

Runs the search

runEdit

public void runEdit()

Edits the object