com.ibm.manplato.Conduit
Class CDKJBridge

java.lang.Object
  |
  +--com.ibm.manplato.Conduit.Conduit
        |
        +--com.ibm.manplato.Conduit.CDKJBridge
All Implemented Interfaces:
java.awt.event.ActionListener, java.util.EventListener, java.io.Serializable
Direct Known Subclasses:
MemoConduit

public abstract class CDKJBridge
extends Conduit
implements java.awt.event.ActionListener

A bridge class to support CDK-J Conduits. This class acts as a bridge between the ManplatoSync Conduit API specification, and those conduits written to Palm's CDK-Java specification.

Version:
$Rev$-$Date: 2001/07/20 15:49:50 $$State: Exp $
Author:
File Created By: Brad BARCLAY <bbarclay@ca.ibm.com>, Last Modified By: $Author: Yaztromo $
See Also:
Serialized Form

Constructor Summary
CDKJBridge()
          CDKJBridge constructor.
 
Method Summary
 void actionPerformed(java.awt.event.ActionEvent e)
          Invoked when an action occurs.
 void activateConduitConfiguration()
          Activates this Conduits menu, if one exists.
protected abstract  boolean doFastSync()
           
protected abstract  java.lang.String getCDKJConduitClassName()
           
abstract  java.lang.String getConduitName()
          Returns the name of this Conduit for display.
protected abstract  int getConduitVersion()
           
 javax.swing.JPanel getConfigPanel()
          Gets a handle to this Conduits configuration panel.
protected abstract  int getCreatorID()
           
protected  java.lang.String getDBName(int num)
           
protected abstract  java.lang.String[] getDBNames()
           
 java.lang.String getDescriptiveText()
          Gets the description for this Conduit.
protected  java.lang.String getFileName(int num)
           
protected abstract  java.lang.String[] getFileNames()
           
protected  java.lang.String getResourceBundleClassName()
          Gets the fully-qualified classname for this conduits ResourceBundle class.
 void startSync(ConduitHandler conduitHandler, DLPUserInfo userInfo)
          This method is called when this Conduit is given the opportunity to synchronize.
 
Methods inherited from class com.ibm.manplato.Conduit.Conduit
getResourceBundle, getSyncPriorityLevel, toString
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

CDKJBridge

public CDKJBridge()
CDKJBridge constructor. If your CDK-J conduit needs any special configuration done, do it here.
Method Detail

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)
Invoked when an action occurs.
Specified by:
actionPerformed in interface java.awt.event.ActionListener

activateConduitConfiguration

public final void activateConduitConfiguration()
Activates this Conduits menu, if one exists.

doFastSync

protected abstract boolean doFastSync()
Returns:
boolean

getCDKJConduitClassName

protected abstract java.lang.String getCDKJConduitClassName()
Returns:
java.lang.String

getConduitName

public abstract java.lang.String getConduitName()
Returns the name of this Conduit for display. CDK-J Conduits must implement this method themselves, as all GDK-J Conduits share a single common resource file.
Overrides:
getConduitName in class Conduit
Returns:
the name of this Conduit.

getConduitVersion

protected abstract int getConduitVersion()
Returns:
int

getConfigPanel

public javax.swing.JPanel getConfigPanel()
Gets a handle to this Conduits configuration panel. In the GUI ManplatoSync applications, this method will be called at Conduit initialization to get a handle to a Conduit-supplied configuration JPanel, which will be added to the ManplatoSync Tabbed viewpane. This method is not used in non-GUI ManplatoSync applications. By default, this method returns null. When thi GUI client receives a null handle, it will put together a basic page with information on this Conduit. Override and implement this method to create a JPanel with any configuration widgets you wish to use. It is up to you to provide your own event handlers to manage the widgets inside the JPanel.
Overrides:
getConfigPanel in class Conduit
Returns:
a handle to a fully initialized JPanel.

getCreatorID

protected abstract int getCreatorID()
Returns:
int

getDBName

protected java.lang.String getDBName(int num)
Returns:
java.lang.String

getDBNames

protected abstract java.lang.String[] getDBNames()
Returns:
java.lang.String

getDescriptiveText

public java.lang.String getDescriptiveText()
Gets the description for this Conduit. In the CDK-J implementation, this method defaults to returning null. Subclasses should override the implementation of this method if they wish to provide descriptive text.
Overrides:
getDescriptiveText in class Conduit
Returns:
the text describing this conduit.

getFileName

protected java.lang.String getFileName(int num)
Returns:
java.lang.String

getFileNames

protected abstract java.lang.String[] getFileNames()
Returns:
java.lang.String

getResourceBundleClassName

protected java.lang.String getResourceBundleClassName()
Gets the fully-qualified classname for this conduits ResourceBundle class.
Overrides:
getResourceBundleClassName in class Conduit
Returns:
a String containing the package and classname for this Conduits resources.

startSync

public final void startSync(ConduitHandler conduitHandler,
                            DLPUserInfo userInfo)
                     throws NotConnectedException
This method is called when this Conduit is given the opportunity to synchronize.
Overrides:
startSync in class Conduit
Parameters:
conduitHndlr - he handle to the active ConduitHandler to use for synchronization.
Throws:
NotConnectedException - thrown if the connection to the Palm is lost.