jSyncManager

org.jSyncManager.Client
Class ApplicationJFrame

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame
                          |
                          +--javax.swing.JFrame
                                |
                                +--org.jSyncManager.Client.ApplicationJFrame
All Implemented Interfaces:
javax.accessibility.Accessible, java.awt.event.ActionListener, java.util.EventListener, java.awt.image.ImageObserver, java.awt.MenuContainer, javax.swing.RootPaneContainer, java.io.Serializable, SynchronizerListener, TransportChangedListener, javax.swing.WindowConstants, java.awt.event.WindowListener

public class ApplicationJFrame
extends javax.swing.JFrame
implements java.awt.event.WindowListener, SynchronizerListener, TransportChangedListener, java.awt.event.ActionListener

The main jSyncManager Frame. This class contains the main jSyncManager Swing GUI frame.

Version:
$Revision: 1.17 $
Author:
Ian DALLAS <occupant@iandallas.com>
Last modified by: $Author: yaztromo $ on $Date: 2003/07/09 09:09:39 $.
See Also:
Serialized Form

Inner classes inherited from class javax.swing.JFrame
javax.swing.JFrame.AccessibleJFrame
 
Inner classes inherited from class java.awt.Frame
java.awt.Frame.AccessibleAWTFrame
 
Inner classes inherited from class java.awt.Window
java.awt.Window.AccessibleAWTWindow
 
Inner classes inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Inner classes inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.AWTTreeLock
 
Fields inherited from class javax.swing.JFrame
accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled
 
Fields inherited from class java.awt.Frame
CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, icon, ICONIFIED, mbManagement, menuBar, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, ownedWindows, resizable, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, title, W_RESIZE_CURSOR, WAIT_CURSOR
 
Fields inherited from class java.awt.Window
inputContext, nativeActive, OPENED, ownedWindowList, state, warningString, windowListener
 
Fields inherited from class java.awt.Container
component, containerListener, layoutMgr, listeningBoundsChildren, listeningChildren, ncomponents, needsPaint
 
Fields inherited from class java.awt.Component
actionListenerK, adjustmentListenerK, appContext, background, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, componentListener, componentListenerK, componentOrientation, containerListenerK, cursor, dropTarget, enabled, eventMask, focusListener, focusListenerK, font, foreground, graphicsConfig, hasFocus, height, hierarchyBoundsListener, hierarchyBoundsListenerK, hierarchyListener, hierarchyListenerK, incRate, inputMethodListener, inputMethodListenerK, isInc, isPacked, itemListenerK, keyListener, keyListenerK, LEFT_ALIGNMENT, locale, LOCK, metrics, minSize, mouseListener, mouseListenerK, mouseMotionListener, mouseMotionListenerK, newEventsOnly, ownedWindowK, parent, peer, peerFont, popups, prefSize, RIGHT_ALIGNMENT, textListenerK, TOP_ALIGNMENT, valid, visible, width, windowClosingException, windowListenerK, x, y
 
Fields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
ApplicationJFrame(RegistrationData preferences)
           
 
Method Summary
 void actionPerformed(java.awt.event.ActionEvent ae)
           
 void changeTransport(SLPTransportInterface t)
          This method will be called when the used has changed their transport class.
 void endOfSync(Synchronizer s)
          This message is called by the Synchronizer instance specified when it has completed a synchronization.
 java.util.Vector getConduits(Synchronizer s)
          Retrieves a Vector object containing the active instances of the conduits to be synchronized.
 AbstractConduit getDefaultConduit(Synchronizer s)
          Retrieves the DefaultConduit object to be used at the end of a standard sync.
 DLPUserInfo getNewUserInfo(Synchronizer s)
          Requests new user information from the sync application.
 java.io.File getRestoreDatabasePath()
          Gets the database set to be used for the restore operation.
 int getSyncType(Synchronizer s)
          Retrieves the type of synchronization to perform.
 void midSync(Synchronizer s)
          This message is called by the Synchronizer instance specified when it has reached the mid-point of a synchronization job.
 void processUser(DLPUserInfo userInfo, Synchronizer s)
          Gives the application a chance to process the user info for the handhelds owner.
 void startOfSync(Synchronizer s)
          This message is called by the Synchronizer instance specified when it has began a synchronization job.
 boolean useTimeSync(Synchronizer s)
          Requests wether or not date and time synchronization should be used at sync time.
 boolean validateUser(int userID, Synchronizer s)
          Requests user validation from the implementing application.
 void windowActivated(java.awt.event.WindowEvent windowevent)
          Method to handle events for the WindowListener interface.
 void windowClosed(java.awt.event.WindowEvent windowevent)
          Method to handle events for the WindowListener interface.
 void windowClosing(java.awt.event.WindowEvent windowevent)
          Method to handle events for the WindowListener interface.
 void windowDeactivated(java.awt.event.WindowEvent windowevent)
          Method to handle events for the WindowListener interface.
 void windowDeiconified(java.awt.event.WindowEvent windowevent)
          Method to handle events for the WindowListener interface.
 void windowIconified(java.awt.event.WindowEvent windowevent)
          Method to handle events for the WindowListener interface.
 void windowOpened(java.awt.event.WindowEvent windowevent)
          Method to handle events for the WindowListener interface.
 
Methods inherited from class javax.swing.JFrame
addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isRootPaneCheckingEnabled, paramString, processKeyEvent, processWindowEvent, remove, setContentPane, setDefaultCloseOperation, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, update
 
Methods inherited from class java.awt.Frame
, addNotify, addToFrameList, constructComponentName, finalize, getCursorType, getFrames, getIconImage, getMenuBar, getState, getTitle, isResizable, postProcessKeyEvent, remove, removeFromFrameList, removeNotify, setCursor, setIconImage, setMenuBar, setResizable, setState, setTitle
 
Methods inherited from class java.awt.Window
addOwnedWindow, addWindowListener, adjustListeningChildren, applyResourceBundle, applyResourceBundle, connectOwnedWindow, dispatchEventImpl, dispose, eventEnabled, getFocusOwner, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, hide, isActive, isShowing, nextFocus, pack, postEvent, postWindowEvent, preProcessKeyEvent, processEvent, removeOwnedWindow, removeWindowListener, resetGC, setCursor, setFocusOwner, show, toBack, toFront, transferFocus
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyOrientation, checkGD, countComponents, createChildHierarchyEvents, createHierarchyEvents, deliverEvent, dispatchEventToSelf, doLayout, findComponentAt, findComponentAt, findComponentAt, getAccessibleAt, getAccessibleChild, getAccessibleChildrenCount, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents_NoClientCode, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getMouseEventTarget, getPreferredSize, getWindow, insets, invalidate, invalidateTree, isAncestorOf, layout, lightweightPaint, lightweightPrint, list, list, locate, minimumSize, numListening, paint, paintComponents, paintHeavyweightComponents, postsOldMouseEvents, preferredSize, print, printComponents, printHeavyweightComponents, processContainerEvent, proxyEnableEvents, proxyRequestFocus, remove, removeAll, removeContainerListener, setFont, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, areInputMethodsEnabled, bounds, checkImage, checkImage, checkWindowClosingException, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getAccessibleIndexInParent, getAccessibleStateSet, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont_NoClientCode, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen_NoTreeLock, getLocationOnScreen, getName, getNativeContainer, getParent_NoClientCode, getParent, getPeer, getSize, getSize, getToolkitImpl, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isEnabledImpl, isFocusTraversable, isLightweight, isOpaque, isRecursivelyVisible, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseMotionEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.awt.MenuContainer
getFont, postEvent
 

Constructor Detail

ApplicationJFrame

public ApplicationJFrame(RegistrationData preferences)
                  throws java.lang.Exception
Method Detail

windowActivated

public void windowActivated(java.awt.event.WindowEvent windowevent)
Method to handle events for the WindowListener interface.
Specified by:
windowActivated in interface java.awt.event.WindowListener
Parameters:
windowevent - java.awt.event.WindowEvent.

windowClosed

public void windowClosed(java.awt.event.WindowEvent windowevent)
Method to handle events for the WindowListener interface.
Specified by:
windowClosed in interface java.awt.event.WindowListener
Parameters:
windowevent - java.awt.event.WindowEvent.

windowClosing

public void windowClosing(java.awt.event.WindowEvent windowevent)
Method to handle events for the WindowListener interface.
Specified by:
windowClosing in interface java.awt.event.WindowListener
Parameters:
windowevent - java.awt.event.WindowEvent.

windowDeactivated

public void windowDeactivated(java.awt.event.WindowEvent windowevent)
Method to handle events for the WindowListener interface.
Specified by:
windowDeactivated in interface java.awt.event.WindowListener
Parameters:
windowevent - java.awt.event.WindowEvent.

windowDeiconified

public void windowDeiconified(java.awt.event.WindowEvent windowevent)
Method to handle events for the WindowListener interface.
Specified by:
windowDeiconified in interface java.awt.event.WindowListener
Parameters:
windowevent - java.awt.event.WindowEvent.

windowIconified

public void windowIconified(java.awt.event.WindowEvent windowevent)
Method to handle events for the WindowListener interface.
Specified by:
windowIconified in interface java.awt.event.WindowListener
Parameters:
windowevent - java.awt.event.WindowEvent.

windowOpened

public void windowOpened(java.awt.event.WindowEvent windowevent)
Method to handle events for the WindowListener interface.
Specified by:
windowOpened in interface java.awt.event.WindowListener
Parameters:
windowevent - java.awt.event.WindowEvent.

endOfSync

public void endOfSync(Synchronizer s)
This message is called by the Synchronizer instance specified when it has completed a synchronization.
Specified by:
endOfSync in interface SynchronizerListener
Parameters:
s - a reference to the Synchronizer that has completed a sync job.

getConduits

public java.util.Vector getConduits(Synchronizer s)
Retrieves a Vector object containing the active instances of the conduits to be synchronized. Conduits are only used during a standard sync. This method is not called for a backup or restore sync.
Specified by:
getConduits in interface SynchronizerListener
Parameters:
s - a reference to the Synchronizer that has completed a sync job.
Returns:
a Vector object containing the active instances of the conduits to be synchronized.

getDefaultConduit

public AbstractConduit getDefaultConduit(Synchronizer s)
Retrieves the DefaultConduit object to be used at the end of a standard sync.
Specified by:
getDefaultConduit in interface SynchronizerListener
Parameters:
s - a reference to the Synchronizer that has completed a sync job.
Returns:
the DefaultConduit object to be used at the end of a standard sync.

getNewUserInfo

public DLPUserInfo getNewUserInfo(Synchronizer s)
Requests new user information from the sync application. If the Synchronizer engine determines that the handheld contains no user information, it will request that the application provide the necessary information so it may be written to the handheld. For applications that can't handle this (such as remote servers), return null to inform the Synchronizer that it should reject this user.
Specified by:
getNewUserInfo in interface SynchronizerListener
Parameters:
s - a reference to the Synchronizer that has completed a sync job.
Returns:
a DLPUserInfo object describing the new user, or null.

getSyncType

public int getSyncType(Synchronizer s)
Retrieves the type of synchronization to perform. Valid return values include Synchronizer.NORMAL_SYNC, Synchronizer.BACKUP_SYNC, and Synchronizer.RESTORE_SYNC.
Specified by:
getSyncType in interface SynchronizerListener
Parameters:
s - a reference to the Synchronizer that has completed a sync job.
Returns:
the type of synchronization to perform.

midSync

public void midSync(Synchronizer s)
This message is called by the Synchronizer instance specified when it has reached the mid-point of a synchronization job. The mid-point is defined to be after all user, system, and database info has been read, date and time synchronized (as requested), but before the main synchronization task has begun.
Specified by:
midSync in interface SynchronizerListener
Parameters:
s - a reference to the Synchronizer that has reached the mid-point of a sync job.

processUser

public void processUser(DLPUserInfo userInfo,
                        Synchronizer s)
Gives the application a chance to process the user info for the handhelds owner. Processing of this information is application-specific. An application may simply return from this method with no penalty.
Specified by:
processUser in interface SynchronizerListener
Parameters:
userInfo - the DLPUserInfo object for the currently synchronizing handheld.
s - a reference to the Synchronizer that has completed a sync job.

startOfSync

public void startOfSync(Synchronizer s)
This message is called by the Synchronizer instance specified when it has began a synchronization job.
Specified by:
startOfSync in interface SynchronizerListener
Parameters:
s - a reference to the Synchronizer that has started a sync job.

useTimeSync

public boolean useTimeSync(Synchronizer s)
Requests wether or not date and time synchronization should be used at sync time. Date and Time sync will write the sync hosts current date and time to the handheld. Note however that some users may not desire this functionality, particularily if their handheld is in a different timezone than the system they're syncing against. This method allows the application to provide the user with such a choice. Note that the user shouldn't be interrupted at sync time with this question -- it should be something they are required to set/unset prior to synchronization.
Specified by:
useTimeSync in interface SynchronizerListener
Parameters:
s - a reference to the Synchronizer that has completed a sync job.
Returns:
true if the date/time should be synchronized, false otherwise.

validateUser

public boolean validateUser(int userID,
                            Synchronizer s)
Requests user validation from the implementing application. An application implementing synchronization functionality through the Synchronizer class has the option of accepting or rejecting users based on their user ID. Note that it is perfectly acceptable to hard-code this call to return true to allow anyone to sync. However, hard-coding to always return false will prevent anyone from ever synchronizing.
Specified by:
validateUser in interface SynchronizerListener
Parameters:
userID - int
s - a reference to the Synchronizer that has completed a sync job.
Returns:
true if the application is willing to allow this user to sync, false otherwise.

getRestoreDatabasePath

public java.io.File getRestoreDatabasePath()
Gets the database set to be used for the restore operation. If the sync type equals Synchronizer.RESTORE_SYNC, this method will be called at sync time to retreive the DLPDatabaseSet containing the databases to be restored.
Specified by:
getRestoreDatabasePath in interface SynchronizerListener
Returns:
the DLPDatabaseSet object containing the databases to be restored.

changeTransport

public void changeTransport(SLPTransportInterface t)
This method will be called when the used has changed their transport class.
Specified by:
changeTransport in interface TransportChangedListener
Parameters:
the - new Transport instance to be used.

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent ae)
Specified by:
actionPerformed in interface java.awt.event.ActionListener

jSyncManager

Copyright (c) 1999 - 2003 Brad BARCLAY and others. All Rights Reserved.