org.tentackle.swing.rdc

Class PdoTablePanel<T extends org.tentackle.pdo.PersistentDomainObject<T>>

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

org.tentackle.swing.FormPanel

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

All Implemented Interfaces:

ContainerListener, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, org.tentackle.locale.I18nTranslatable, FormChangeable, FormContainer

public class PdoTablePanel<T extends org.tentackle.pdo.PersistentDomainObject<T>>
extends FormPanel

See Also:

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

Modifier and Type	Field and Description
static String	ACTION_CANCEL
static String	ACTION_SAVE
static int	SHOW_CANCEL_BUTTON
static int	SHOW_DELETE_BUTTON
static int	SHOW_DOWN_BUTTON
static int	SHOW_NEW_BUTTON
static int	SHOW_SAVE_BUTTON
static int	SHOW_UP_BUTTON

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
PdoTablePanel() Creates an empty table panel.
PdoTablePanel(FormTableEntry<T> template, List<T> objList, boolean ordered, String prefName) Creates a table panel.

Method Summary

Modifier and Type	Method and Description
boolean	add(T object) Adds an object to the list. In unordered lists the object will always be appended to the end of the list.
void	addTableModelListener(TableModelListener l) Adds a TableModelListener.
FormTable<T>	createFormTable() Creates the formtable.
FormTableModel<T>	createFormTableModel(FormTableEntry<T> template) Creates the formtable model for a given object.
protected T	createPdo() Creates a pdo for the table.
boolean	delete() Deletes the current object (row).
FormPanel	getButtonPanel() Gets the button panel. Applications may add or remove buttons.
boolean	getButtonsLessObtrusive()
FormButton	getCancelButton() Get access to the cancel button.
FormButton	getDeleteButton() Get access to the delete button.
FormTable<T>	getFormTable() Gets the table.
FormTableModel<T>	getFormTableModel() Gets the table model.
FormTableSorter<T>	getFormTableSorter() Gets the table sorter.
FormButton	getMoveDownButton() Get access to the move-down button.
FormButton	getMoveUpButton() Get access to the move-up button.
FormButton	getNewButton() Get access to the new button.
boolean	getNewBySearch() Gets the setting what happens when the new-button is pressed.
FormButton	getSaveButton() Get access to the save button.
String	getTableName() Gets the table preferences name.
FormTableEntry<T>	getTemplate() Gets the template.
int	getVisibleButtons() Gets the visible buttons mask
boolean	isCancelButtonVisible() Gets the visibility of the cancel button.
boolean	isDataChanged() Gets status info whether data has been changed or not.
boolean	isDeleteButtonVisible() Gets the visibility of the delete button.
boolean	isDownButtonVisible() Gets the visibility of the down button.
boolean	isNewButtonVisible() Gets the visibility of the save button.
boolean	isOrdered() Gets the ordered feature.
boolean	isSaveButtonVisible() Gets the visibility of the save button.
boolean	isUnique() Gets the flag whether objects can be added more than once.
boolean	isUpButtonVisible() Gets the visibility of the up button.
void	listChanged(List<T> objList) Shows a list of data objects.
void	move(boolean down) Moves the current object (row) in list up or down.
void	removeTableModelListener(TableModelListener l) Removes a TableModelListener.
T	searchObject() If newBySearch is enabled this method is invoked to run the search.
void	setButtonsLessObtrusive(boolean flag) Makes the buttons less obtrusive.
void	setCancelButtonVisible(boolean visible) Sets the visibility of the cancel button.
void	setChangeable(boolean changeable)
void	setDeleteButtonVisible(boolean visible) Sets the visibility of the delete button.
void	setDownButtonVisible(boolean visible) Sets the visibility of the down button.
void	setNewButtonVisible(boolean visible) Sets the visibility of the new button.
void	setNewBySearch(boolean newBySearch) Defines what happens when the new-button is pressed.
void	setOrdered(boolean ordered) Defines whether the data is ordered or not.
void	setSaveButtonVisible(boolean visible) Sets the visibility of the save button.
void	setTableName(String prefName) Sets the table name which is used to load the preferences.
void	setTemplate(FormTableEntry<T> template) Changes the template (necessary if context changed).
void	setUnique(boolean unique) Defines whether objects may not appear more than once. Setting unique makes only sense if newBySearch is enabled as well.
void	setup(FormTableEntry<T> template, List<T> objList, boolean ordered, String prefName) Creates a table panel.
void	setUpButtonVisible(boolean visible) Sets the visibility of the up button.
void	setVisibleButtons(int mask) Sets the visible buttons mask.

Methods inherited from class org.tentackle.swing.FormPanel

addActionListener, areValuesChanged, componentAdded, componentRemoved, createBinder, fireActionPerformed, getBinder, getFormValues, getHelpURL, getI18nTranslation, getParentWindow, getPropertyGroup, getTitle, invalidateParentInfo, isAutoUpdate, isBindable, isChangeable, isHonourChangeable, isTriggerValuesChangedEnabled, removeActionListener, saveValues, setAutoUpdate, setBindable, setFormValues, setFormValuesKeepChanged, setHelpURL, setHonourChangeable, setI18nTranslation, setPropertyGroup, setTitle, setTitle, setTriggerValuesChangedEnabled, showHelp, 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, 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, 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

ACTION_SAVE

public static final String ACTION_SAVE

See Also:

Constant Field Values

ACTION_CANCEL

public static final String ACTION_CANCEL

See Also:

Constant Field Values

SHOW_CANCEL_BUTTON

public static final int SHOW_CANCEL_BUTTON

See Also:

Constant Field Values

SHOW_DELETE_BUTTON

public static final int SHOW_DELETE_BUTTON

See Also:

Constant Field Values

SHOW_DOWN_BUTTON

public static final int SHOW_DOWN_BUTTON

See Also:

Constant Field Values

SHOW_UP_BUTTON

public static final int SHOW_UP_BUTTON

See Also:

Constant Field Values

SHOW_SAVE_BUTTON

public static final int SHOW_SAVE_BUTTON

See Also:

Constant Field Values

SHOW_NEW_BUTTON

public static final int SHOW_NEW_BUTTON

See Also:

Constant Field Values

Constructor Detail

PdoTablePanel

public PdoTablePanel(FormTableEntry<T> template,
                     List<T> objList,
                     boolean ordered,
                     String prefName)

Creates a table panel.

Parameters:

template - template for the table-row

objList - list of PDOs

ordered - true if objList is an ordered list, i.e. the position in the objList is relevant

prefName - is the FormTable-Name for preferences (installs FormTableUtility-Menu too), null = none (no Menu either)

PdoTablePanel

public PdoTablePanel()

Creates an empty table panel. (Constructor for UI-Designer)

Method Detail

setup

public void setup(FormTableEntry<T> template,
                  List<T> objList,
                  boolean ordered,
                  String prefName)

Creates a table panel.

Parameters:

template - the template for the table-row

objList - the list of PDOs

ordered - true if objList is an ordered list, i.e. the position in the objList is relevant

prefName - the FormTable-Name for preferences (installs FormTableUtility-Menu too), null = none (no Menu either)

createFormTable

public FormTable<T> createFormTable()

Creates the formtable.

Returns:

the created formtable

createFormTableModel

public FormTableModel<T> createFormTableModel(FormTableEntry<T> template)

Creates the formtable model for a given object.

The default implementation just creates the model and binds it.

Parameters:

template - the formtable entry

Returns:

the table model

getButtonPanel

public FormPanel getButtonPanel()

Gets the button panel.
Applications may add or remove buttons.

Returns:

the button panel

setOrdered

public void setOrdered(boolean ordered)

Defines whether the data is ordered or not.

Parameters:

ordered - true if sort necessary, false no sort

isOrdered

public boolean isOrdered()

Gets the ordered feature.

Returns:

true if ordered

setNewBySearch

public void setNewBySearch(boolean newBySearch)

Defines what happens when the new-button is pressed. By default an empty object will be inserted.

Parameters:

newBySearch - true if open a search dialog to select object, else createPdo empty object

getNewBySearch

public boolean getNewBySearch()

Gets the setting what happens when the new-button is pressed.

Returns:

true if open a search dialog to select object, else createPdo empty object

searchObject

public T searchObject()

If newBySearch is enabled this method is invoked to run the search. The default implementation just runs a modal PdoSearchDialog.

Returns:

the object, null if search cancelled

setUnique

public void setUnique(boolean unique)

Defines whether objects may not appear more than once.
Setting unique makes only sense if newBySearch is enabled as well.

Notice that the initial object list is not checked, i.e. the flag applies only to newly added objects.

Parameters:

unique - true if objects may not appear more than once

isUnique

public boolean isUnique()

Gets the flag whether objects can be added more than once.

Returns:

true if objects are unique, false if not (default)

setTableName

public void setTableName(String prefName)

Sets the table name which is used to load the preferences. Setting the name will also install a FormTableUtilityPopup.

Parameters:

prefName - the table name, null = none (uninstalls the popup, if any)

getTableName

public String getTableName()

Gets the table preferences name.

Returns:

the preferences name

setVisibleButtons

public void setVisibleButtons(int mask)

Sets the visible buttons mask.

Parameters:

mask - is a bitmask of SHOW_..._BUTTON

getVisibleButtons

public int getVisibleButtons()

Gets the visible buttons mask

Returns:

the bitmask of SHOW_...._BUTTON

setCancelButtonVisible

public void setCancelButtonVisible(boolean visible)

Sets the visibility of the cancel button.

Parameters:

visible - is true if visible, false if not

isCancelButtonVisible

public boolean isCancelButtonVisible()

Gets the visibility of the cancel button.

Returns:

true if visible, false if not

setDeleteButtonVisible

public void setDeleteButtonVisible(boolean visible)

Sets the visibility of the delete button.

Parameters:

visible - is true if visible, false if not

isDeleteButtonVisible

public boolean isDeleteButtonVisible()

Gets the visibility of the delete button.

Returns:

true if visible, false if not

setDownButtonVisible

public void setDownButtonVisible(boolean visible)

Sets the visibility of the down button.

Parameters:

visible - is true if visible, false if not

isDownButtonVisible

public boolean isDownButtonVisible()

Gets the visibility of the down button.

Returns:

true if visible, false if not

setUpButtonVisible

public void setUpButtonVisible(boolean visible)

Sets the visibility of the up button.

Parameters:

visible - is true if visible, false if not

isUpButtonVisible

public boolean isUpButtonVisible()

Gets the visibility of the up button.

Returns:

true if visible, false if not

setSaveButtonVisible

public void setSaveButtonVisible(boolean visible)

Sets the visibility of the save button.

Parameters:

visible - is true if visible, false if not

isSaveButtonVisible

public boolean isSaveButtonVisible()

Gets the visibility of the save button.

Returns:

true if visible, false if not

setNewButtonVisible

public void setNewButtonVisible(boolean visible)

Sets the visibility of the new button.

Parameters:

visible - is true if visible, false if not

isNewButtonVisible

public boolean isNewButtonVisible()

Gets the visibility of the save button.

Returns:

true if visible, false if not

setButtonsLessObtrusive

public void setButtonsLessObtrusive(boolean flag)

Makes the buttons less obtrusive. Useful if PdoTablePanel is embedded in another dialog with buttons.

Parameters:

flag - true for less obstrusive buttons, false is default.

getCancelButton

public FormButton getCancelButton()

Get access to the cancel button.

Returns:

the cancel button

getDeleteButton

public FormButton getDeleteButton()

Get access to the delete button.

Returns:

the delete button

getMoveDownButton

public FormButton getMoveDownButton()

Get access to the move-down button.

Returns:

the move-down button

getMoveUpButton

public FormButton getMoveUpButton()

Get access to the move-up button.

Returns:

the move-up button

getSaveButton

public FormButton getSaveButton()

Get access to the save button.

Returns:

the save button

getNewButton

public FormButton getNewButton()

Get access to the new button.

Returns:

the new button

getButtonsLessObtrusive

public boolean getButtonsLessObtrusive()

Returns:

true if buttons are less obstrusive.

setTemplate

public void setTemplate(FormTableEntry<T> template)

Changes the template (necessary if context changed).

Parameters:

template - the template

getTemplate

public FormTableEntry<T> getTemplate()

Gets the template.

Returns:

the current template

setChangeable

public void setChangeable(boolean changeable)

Specified by:

setChangeable in interface FormChangeable

Overrides:

setChangeable in class FormPanel

listChanged

public void listChanged(List<T> objList)

Shows a list of data objects.

Parameters:

objList - the list of objects

isDataChanged

public boolean isDataChanged()

Gets status info whether data has been changed or not.

Returns:

true if model data has been changed

getFormTable

public FormTable<T> getFormTable()

Gets the table.

Returns:

the FormTable

getFormTableModel

public FormTableModel<T> getFormTableModel()

Gets the table model.

Returns:

the table model

getFormTableSorter

public FormTableSorter<T> getFormTableSorter()

Gets the table sorter.

Returns:

the sorter

addTableModelListener

public void addTableModelListener(TableModelListener l)

Adds a TableModelListener.

Parameters:

l - the listener to add

removeTableModelListener

public void removeTableModelListener(TableModelListener l)

Removes a TableModelListener.

Parameters:

l - the listener to remove

move

public void move(boolean down)

Moves the current object (row) in list up or down.

Parameters:

down - true if move down, else up

add

public boolean add(T object)

Adds an object to the list.
In unordered lists the object will always be appended to the end of the list. If the is ordered and there is only one row in the table, the object will be appended after the current row. Otherwise the object will be inserted before the current row and the list gets sorted.

Notice: if the unique attribute is set, objects will not be inserted more than once.

Parameters:

object - the object to add

Returns:

true if added, false object is null or unique==true and object already in list

delete

public boolean delete()

Deletes the current object (row).

Returns:

true if deleted, false if rowIndex invalid

createPdo

protected T createPdo()

Creates a pdo for the table.

Returns:

the pdo