arlut.csd.JDataComponent

Class JdateField

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

arlut.csd.JDataComponent.JdateField

All Implemented Interfaces:

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

public class JdateField
extends javax.swing.JPanel
implements java.awt.event.ActionListener, java.awt.event.FocusListener

This class defines a Date/Time GUI component that ties into the JsetValueCallback interface that the Ganymede clients use internally to receive higher level GUI events.

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 JsetValueCallback	callback The callback that we use to communicate date changes in this field to the Ganymede client, etc.
private java.util.Date	curr_date The date that we most recently have from our GUI components.
private javax.swing.JFormattedTextField	datef datePicker's internal text editing field, that we apply a FocusListener to.
private org.jdesktop.swingx.JXDatePicker	datePicker The SwingX date picker GUI component we're building JdateField around.
(package private) static boolean	debug
private java.util.Date	original_date The last date that we had from the Ganymede server.
private javax.swing.JTextField	timef A text editing component for the time of day for this JdateField, if we are set up to provide time display/editing.
(package private) static TranslationService	ts TranslationService object for handling string localization in the Ganymede client.

Fields inherited from class javax.swing.JComponent

accessibleContext, 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

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
JdateField() Minimal Constructor for JdateField.
JdateField(java.util.Date date, boolean iseditable, boolean islimited, boolean usetime, java.util.Date minDate, java.util.Date maxDate) Contructor that creates a JdateField based on the date it is given.
JdateField(java.util.Date date, boolean iseditable, boolean islimited, boolean usetime, java.util.Date minDate, java.util.Date maxDate, JsetValueCallback parent) Contructor that creates a JdateField based on the Date object it is given.

Method Summary

Methods

Modifier and Type	Method and Description
void	actionPerformed(java.awt.event.ActionEvent e) ActionListener method we use to trigger on mouse clicks on the drop-down calendar widget.
void	focusGained(java.awt.event.FocusEvent e) Required by the FocusListener interface.
void	focusLost(java.awt.event.FocusEvent e) FocusListener method to react to focus loss on the datePicker and/or timef text editing widgets.
java.util.Date	getDate() Returns the date associated with this JdateField
private java.lang.String	prefixZero(java.lang.String str)
void	setCallback(JsetValueCallback callback) Attaches this JdateField component to the callback we use to notify on date/time change input.
void	setDate(java.util.Date date) Sets the date and time value of this JdateField.
private void	setDateOnly(java.util.Date date) Sets the calendar date of this JdateField, keeping the time of day previously set.
void	setLimits(java.util.Date minDate, java.util.Date maxDate) Sets the minimum and maximum dates allowed in this JdateField.
private void	setTimeOnly(java.lang.String timeStr) Sets the time of day for this JdateField, keeping the calendar date previously set.
void	updateServer() Propagate the date value up to the server object.

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, 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, hide, 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

debug

static final boolean debug

See Also:

Constant Field Values

ts

static final TranslationService ts

TranslationService object for handling string localization in the Ganymede client.

datePicker

private org.jdesktop.swingx.JXDatePicker datePicker

The SwingX date picker GUI component we're building JdateField around.

datef

private javax.swing.JFormattedTextField datef

datePicker's internal text editing field, that we apply a FocusListener to.

timef

private javax.swing.JTextField timef

A text editing component for the time of day for this JdateField, if we are set up to provide time display/editing.

callback

private JsetValueCallback callback

The callback that we use to communicate date changes in this field to the Ganymede client, etc.

original_date

private java.util.Date original_date

The last date that we had from the Ganymede server. We will revert to this date if our callback refuses our change.

curr_date

private java.util.Date curr_date

The date that we most recently have from our GUI components. This will be promoted into original_date once a callback carrying this date succeeds.

Constructor Detail

JdateField

public JdateField()

Minimal Constructor for JdateField. This will construct a JdateField with no value.

JdateField

public JdateField(java.util.Date date,
          boolean iseditable,
          boolean islimited,
          boolean usetime,
          java.util.Date minDate,
          java.util.Date maxDate,
          JsetValueCallback parent)

Contructor that creates a JdateField based on the Date object it is given. This constructor can be used if the JdateField will be making callbacks to pass its data to the appropriate container.

Parameters:

parent - the container which implements the callback function for this JdateField

date - the Date object to use

iseditable - true if the datefield can be edited by the user

islimited - true if there is to be a restriction on the range of dates

usetime - If true, this JdateField will display a time edit box next to the date edit field.

minDate - the oldest possible date that can be entered into this JdateField

maxDate - the newest possible date that can be entered into this JdateField

JdateField

public JdateField(java.util.Date date,
          boolean iseditable,
          boolean islimited,
          boolean usetime,
          java.util.Date minDate,
          java.util.Date maxDate)

Contructor that creates a JdateField based on the date it is given. It is also possible to set restrictions on the range of dates for this JdateField when using this constructor

Parameters:

date - the Date object to use

islimited - true if there is to be a restriction on the range of dates

usetime - If true, this JdateField will display a time edit box next to the date edit field.

minDate - the oldest possible date that can be entered into this JdateField

maxDate - the newest possible date that can be entered into this JdateField

Method Detail

focusLost

public void focusLost(java.awt.event.FocusEvent e)

FocusListener method to react to focus loss on the datePicker and/or timef text editing widgets.

Specified by:

focusLost in interface java.awt.event.FocusListener

focusGained

public void focusGained(java.awt.event.FocusEvent e)

Required by the FocusListener interface.

Specified by:

focusGained in interface java.awt.event.FocusListener

actionPerformed

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

ActionListener method we use to trigger on mouse clicks on the drop-down calendar widget.

Specified by:

actionPerformed in interface java.awt.event.ActionListener

getDate

public java.util.Date getDate()

Returns the date associated with this JdateField

setLimits

public void setLimits(java.util.Date minDate,
             java.util.Date maxDate)

Sets the minimum and maximum dates allowed in this JdateField.

setDateOnly

private void setDateOnly(java.util.Date date)

Sets the calendar date of this JdateField, keeping the time of day previously set.

Calling this method does not trigger the callback.

Parameters:

date - The Date to load into this JdateField.

setTimeOnly

private void setTimeOnly(java.lang.String timeStr)

Sets the time of day for this JdateField, keeping the calendar date previously set.

Calling this method does not trigger the callback.

Parameters:

timeStr - The string to extract time of day from.

setDate

public void setDate(java.util.Date date)

Sets the date and time value of this JdateField.

Calling this method does not trigger the callback.

Parameters:

date - The Date to extract the calendar date and time of day from.

setCallback

public void setCallback(JsetValueCallback callback)

Attaches this JdateField component to the callback we use to notify on date/time change input.

updateServer

public void updateServer()

Propagate the date value up to the server object.

prefixZero

private java.lang.String prefixZero(java.lang.String str)