The main jSyncManager Frame.
This class contains the main jSyncManager Swing GUI frame.
actionPerformed
public void actionPerformed(ActionEvent ae)
The action event handler method.
ae - the ActionEvent to be handled.
endOfSync
public void endOfSync(Synchronizer s)
This message is called by the Synchronizer instance specified when it has completed
a synchronization.
- endOfSync in interface SynchronizerListener
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.
- getConduits in interface SynchronizerListener
s - a reference to the Synchronizer that has completed a sync job.
- 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.
- getDefaultConduit in interface SynchronizerListener
s - a reference to the Synchronizer that has completed a sync job.
- 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.
- getNewUserInfo in interface SynchronizerListener
s - a reference to the Synchronizer that has completed a sync job.
- a DLPUserInfo object describing the new user, or null.
getRestoreDatabasePath
public 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.
- getRestoreDatabasePath in interface SynchronizerListener
- the DLPDatabaseSet object containing the databases to be restored.
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.
- getSyncType in interface SynchronizerListener
s - a reference to the Synchronizer that has completed a sync job.
- 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.
- midSync in interface SynchronizerListener
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.
- processUser in interface SynchronizerListener
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.
- startOfSync in interface SynchronizerListener
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.
- useTimeSync in interface SynchronizerListener
s - a reference to the Synchronizer that has completed a sync job.
- true if the date/time should be synchronized, false otherwise.
validateUser
public boolean validateUser(DLPUserInfo user,
String serialNumber,
Synchronizer s)Requests user validation from the implementing application.
- validateUser in interface SynchronizerListener
user - the DLPUserInfo object to validate.serialNumber - the serial number of the connecting device.s - a reference to the active Synchronizer.
- true, as this implementation always permits synchronization.
windowActivated
public void windowActivated(WindowEvent windowevent)
Method to handle events for the WindowListener interface.
windowevent - java.awt.event.WindowEvent.
windowClosed
public void windowClosed(WindowEvent windowevent)
Method to handle events for the WindowListener interface.
windowevent - java.awt.event.WindowEvent.
windowClosing
public void windowClosing(WindowEvent windowevent)
Method to handle events for the WindowListener interface.
windowevent - java.awt.event.WindowEvent.
windowDeactivated
public void windowDeactivated(WindowEvent windowevent)
Method to handle events for the WindowListener interface.
windowevent - java.awt.event.WindowEvent.
windowDeiconified
public void windowDeiconified(WindowEvent windowevent)
Method to handle events for the WindowListener interface.
windowevent - java.awt.event.WindowEvent.
windowIconified
public void windowIconified(WindowEvent windowevent)
Method to handle events for the WindowListener interface.
windowevent - java.awt.event.WindowEvent.
windowOpened
public void windowOpened(WindowEvent windowevent)
Method to handle events for the WindowListener interface.
windowevent - java.awt.event.WindowEvent.