com.ca.directory.jxplorer
Class JXplorer

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame
                          |
                          +--javax.swing.JFrame
                                |
                                +--com.ca.directory.jxplorer.JXplorer
All Implemented Interfaces:
javax.accessibility.Accessible, java.awt.image.ImageObserver, JXplorerEventGenerator, java.awt.MenuContainer, javax.swing.RootPaneContainer, java.io.Serializable, javax.swing.WindowConstants

public class JXplorer
extends javax.swing.JFrame
implements JXplorerEventGenerator

Does the main setup for JXplorer.

See Also:
Serialized Form

Nested Class Summary
 
Nested classes inherited from class javax.swing.JFrame
javax.swing.JFrame.AccessibleJFrame
 
Nested classes inherited from class java.awt.Frame
java.awt.Frame.AccessibleAWTFrame
 
Nested classes inherited from class java.awt.Window
java.awt.Window.AccessibleAWTWindow
 
Nested classes inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Nested classes inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
 
Field Summary
static java.lang.String CA_PATH_PROPERTY
           
static java.lang.String CA_TYPE_PROPERTY
           
static java.lang.String CLIENT_PATH_PROPERTY
           
static java.lang.String CLIENT_TYPE_PROPERTY
           
static boolean debug
           
static int debugLevel
           
static java.lang.String fileURLPrefix
           
protected  CBHelpSystem helpSystem
           
 java.lang.Thread jndiThread
           
static javax.swing.JFrame jx
           
static java.lang.String localDir
           
protected  MainMenu mainMenu
           
static java.util.Properties myProperties
           
 java.lang.Thread offlineThread
           
static java.lang.String propertyFile
           
 java.lang.Thread schemaThread
           
 java.lang.Thread searchThread
           
protected  java.util.Stack statusStack
           
protected  StopMonitor stopMonitor
           
 
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, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
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
JXplorer()
          Constructor for the JXplorer object, which is in fact the whole browser.
 
Method Summary
 void addJXplorerListener(JXplorerListener l)
          Adds the specified JXplorer listener to receive JXplorer events from JXplorer.
protected  void addSecurityProvider(java.lang.String providerName)
          Allows extra security providers to be manually added.
static boolean checkFileEnvironment()
          Checks that the file directories are valid, and contain any vital files.
static boolean checkJavaEnvironment()
          Checks that the java and system environment is adequate to run in.
 void checkPropertyDependantActions(java.lang.String key, java.lang.String value)
          This is triggered when a global property changes for some reason, and takes any appropriate action.
 void disconnect()
          Disables/enables the menu and button bar items to reflect a disconnected state.
 void fireJXplorerEvent(JXplorerEvent e)
          Creates JXplorer events by dispatching them to any registered JXplorerListener objects.
 SmartTree getActiveTree()
          Returns the tree that is currently being directly displayed to the user.
 AttributeDisplay getAttributeDisplay()
          Returns the Attribute Display.
 javax.swing.JScrollPane getExplorePanel()
          Returns the Explore panel.
static java.lang.String getFileURL(java.lang.String fileDir)
          In order to use file paths as urls, we must attach an appropriate prefix (e.g. file://) and change any backslashes to forward slashes.
 CBHelpSystem getHelpSystem()
          This returns the help system used by JX.
static javax.swing.ImageIcon getImageIcon(java.lang.String name)
          JXplorer utility ftn: load an image from the standard JX images directory.
 MainMenu getMainMenu()
          Returns Main Menu.
static java.util.Properties getMyProperties()
          Sometimes it is more convenient to simply pass the whole properties hash to a subordinate class, rather than using the get...() methods
static java.lang.String getProperty(java.lang.String key)
          Convenience function to access both the System property list, or failing that the internal JXplorer properties list.
static java.lang.String getProperty(java.lang.String key, java.lang.String defaultValue)
          Convenience function to access the internal JXplorer properties list.
 javax.swing.JScrollPane getResultsPanel()
          Returns the panel for displaying the search results.
static javax.swing.JFrame getRootFrame()
          Returns the JXplorer frame.
 JNDIBroker getSearchBroker()
          Returns the JNDIBroker used for searching, and the search tree.
 SmartTree getSearchTree()
          Returns the search display tree.
 java.lang.String getStatus()
           
 StopMonitor getStopMonitor()
          returns the current stop monitor object.
 SmartTree getTree()
          Returns the display tree.
 javax.swing.JTabbedPane getTreeTabPane()
          Returns the tree's tabbed pane.
 void initialiseTree(SmartTree tree, DataSink viewer, JXplorerEventGenerator gen)
           
 void initJNDIBroker()
           
 void initOfflineBroker()
          initialise the offline broker, used for viewing ldif files independantly of a working directory.
 void initSchemaBroker()
           
 void initSearchBroker()
           
 void initStopMonitor()
           
 void initUtilityFtns(javax.swing.JFrame rootFrame)
          Set up some common utility ftns for logging and error reporting.
static boolean isLinux()
          Test for Linux (usually to disable features that appear to be more than usually broken on that platform - e.g.
static boolean isSolaris()
          Test for solaris (usually to disable features that appear to be more than usually broken on that platform - e.g. drag and drop).
static void main(java.lang.String[] args)
          The main class, from whence all else proceeds.
protected  void makeDNAutoRefreshing(DN dn)
           
 java.lang.String popStatus()
          recalls a status message saved via @pushStatus, as well as setting it using @setStatus.
protected  void positionBrowser()
          Set the position and size of the browser to be (where possible) the same As it was the last time it was used.
 boolean postConnectionSetup(com.ca.directory.jxplorer.broker.JNDIBroker.DataConnectionQuery request)
          When a connection has been established (i.e. by JXOpenConWin), this method is called to link up the trees with their respective data brokers.
 void preConnectionSetup()
          Before a new connection is made, the old display trees should be cleared.
protected static void printSecurityProviders()
           
static void printTime(java.lang.String msg)
           
 void pushStatus(java.lang.String newMessage)
          saves the old Status message on the status stack for later use, and sets status to a new message.
 void removeJXplorerListener(JXplorerListener l)
          Removes the specified JXplorer listener so that it no longer receives JXplorer events from this button.
static void runTests()
           
protected static void setDefaultLocationProperty(java.lang.String propName, java.lang.String defaultLocation)
          loads a property representing a file directory (XXX or url), and checks that that it exists.
static java.lang.String setDefaultProperty(java.lang.String key, java.lang.String value)
          Sets the default values for properties.
 void setDisconnectView()
          Disables/enables the menu and button bar items to reflect a disconnected state.
static void setProperties(java.util.Properties suppliedProperties)
          Initialises the myProperties property list, and sets default values for properties not in the config file.
static void setProperty(java.lang.String key, java.lang.String value)
          sets a property in the dxserver property list.
 void setStatus(java.lang.String s)
          Sets a status message that is displayed on the bottom of the screen.
protected  void setupActiveComponents()
          this is where smart objects such as the tree viewer, the results viewer (from the search class) and the attribute viewers get added to the panes.
protected  void setupFrills()
          Make minor additions; the top-right window icon and the title bar text.
protected  void setupGUI()
          Starts the GUI off, calling subroutines to initialise the overall window, the menu and the main panel.
protected  void setupHelp()
          Initialise the JavaHelp system, pointing it at the right help files.
protected  void setupLookAndFeel()
          This sets the initial look and feel to the local system look and feel, if possible; otherwise uses the java default.
protected  void setupMainPanel()
          Sets up the main panel, and places the directory viewing panels in it.
protected  void setupMainWorkArea()
          Sets up the main work area, below the tool bar, which displays the tree/browser panel, and the results panel...
protected  void setupMenu()
          Sets up the menu items, along with appropriate listeners
 void setupResourceFiles()
          A variety of plugin possibilities exist in JXplorer.
protected  void setupSecurityProviders()
           
protected  void setupStatusDisplay()
          The Status panel is the small (one line) panel at the bottom of the browser that reports to users what is happening with the browser (e.g.
protected  void setupToolBars()
           
protected  void setupWindowButtons()
          Sets up the window behaviour to close the application on a window close.
 void showSplashScreen(javax.swing.JWindow splash)
          Displays a splash screen with a thin black border in the center of the screen.
 void shutdown()
          Closes the application down
 void shutdown(java.lang.String msg)
          Closes the application down, optionally printing out a message
static void start(java.util.Properties myProperties)
          A common start point.
 java.lang.String toString()
           
 
Methods inherited from class javax.swing.JFrame
addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, update
 
Methods inherited from class java.awt.Frame
addNotify, finalize, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setIconImage, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated
 
Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, hide, isActive, isFocusableWindow, isFocusCycleRoot, isFocused, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationRelativeTo, show, toBack, toFront
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, transferFocusBackward, 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, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, 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, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, transferFocus, transferFocusUpCycle
 
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
 

Field Detail

myProperties

public static java.util.Properties myProperties

propertyFile

public static java.lang.String propertyFile

localDir

public static java.lang.String localDir

fileURLPrefix

public static java.lang.String fileURLPrefix

jx

public static javax.swing.JFrame jx

debug

public static boolean debug

debugLevel

public static int debugLevel

statusStack

protected java.util.Stack statusStack

mainMenu

protected MainMenu mainMenu

helpSystem

protected CBHelpSystem helpSystem

stopMonitor

protected StopMonitor stopMonitor

jndiThread

public java.lang.Thread jndiThread

schemaThread

public java.lang.Thread schemaThread

searchThread

public java.lang.Thread searchThread

offlineThread

public java.lang.Thread offlineThread

CLIENT_TYPE_PROPERTY

public static final java.lang.String CLIENT_TYPE_PROPERTY
See Also:
Constant Field Values

CA_TYPE_PROPERTY

public static final java.lang.String CA_TYPE_PROPERTY
See Also:
Constant Field Values

CLIENT_PATH_PROPERTY

public static final java.lang.String CLIENT_PATH_PROPERTY
See Also:
Constant Field Values

CA_PATH_PROPERTY

public static final java.lang.String CA_PATH_PROPERTY
See Also:
Constant Field Values
Constructor Detail

JXplorer

public JXplorer()
Constructor for the JXplorer object, which is in fact the whole browser.

Method Detail

printTime

public static void printTime(java.lang.String msg)

main

public static void main(java.lang.String[] args)
The main class, from whence all else proceeds. (Obviously, this is not used if the browser is run as an applet instead...)

Parameters:
args - Not currently used.

initUtilityFtns

public void initUtilityFtns(javax.swing.JFrame rootFrame)
Set up some common utility ftns for logging and error reporting.


start

public static void start(java.util.Properties myProperties)
A common start point. This method is where the JXplorer object is created and initialised, and should be called by the main method, the applet initialiser, or by external programs wishing to incorporate JXplorer.


runTests

public static void runTests()

checkJavaEnvironment

public static boolean checkJavaEnvironment()
Checks that the java and system environment is adequate to run in.


checkFileEnvironment

public static boolean checkFileEnvironment()
Checks that the file directories are valid, and contain any vital files.


getProperty

public static java.lang.String getProperty(java.lang.String key)
Convenience function to access both the System property list, or failing that the internal JXplorer properties list.


getProperty

public static java.lang.String getProperty(java.lang.String key,
                                           java.lang.String defaultValue)
Convenience function to access the internal JXplorer properties list.


getMyProperties

public static java.util.Properties getMyProperties()
Sometimes it is more convenient to simply pass the whole properties hash to a subordinate class, rather than using the get...() methods


setProperty

public static void setProperty(java.lang.String key,
                               java.lang.String value)
sets a property in the dxserver property list.


checkPropertyDependantActions

public void checkPropertyDependantActions(java.lang.String key,
                                          java.lang.String value)
This is triggered when a global property changes for some reason, and takes any appropriate action.


setDefaultProperty

public static java.lang.String setDefaultProperty(java.lang.String key,
                                                  java.lang.String value)
Sets the default values for properties. This is overridden if the property appears in the system properties list or config text file. (The system properties list always takes priority.)

Parameters:
key - the unique key of the property.
value - the actual value to set.
Returns:
the final value of the property.

getFileURL

public static java.lang.String getFileURL(java.lang.String fileDir)
In order to use file paths as urls, we must attach an appropriate prefix (e.g. file://) and change any backslashes to forward slashes.

If fileURLPrefix has been set to a legitimate web address, the files should be automatically pulled from that site.

Parameters:
fileDir - the file directory to reproduce as a url
Returns:
the converted file-as-url

setProperties

public static void setProperties(java.util.Properties suppliedProperties)
Initialises the myProperties property list, and sets default values for properties not in the config file. Note that file names use the File.separator character, (which is system dependant) while URLs use '/' always.


setDefaultLocationProperty

protected static void setDefaultLocationProperty(java.lang.String propName,
                                                 java.lang.String defaultLocation)
loads a property representing a file directory (XXX or url), and checks that that it exists. If either the property doesn't exist, or the actual directory doesn't exist, then the default is used instead...


initJNDIBroker

public void initJNDIBroker()

initSearchBroker

public void initSearchBroker()

initSchemaBroker

public void initSchemaBroker()

initOfflineBroker

public void initOfflineBroker()
initialise the offline broker, used for viewing ldif files independantly of a working directory.


initStopMonitor

public void initStopMonitor()

getStopMonitor

public StopMonitor getStopMonitor()
returns the current stop monitor object.


setupGUI

protected void setupGUI()
Starts the GUI off, calling subroutines to initialise the overall window, the menu and the main panel.


positionBrowser

protected void positionBrowser()
Set the position and size of the browser to be (where possible) the same As it was the last time it was used.


setupLookAndFeel

protected void setupLookAndFeel()
This sets the initial look and feel to the local system look and feel, if possible; otherwise uses the java default. (Note that user can change this using the 'view' menu item, set up below.)


setupWindowButtons

protected void setupWindowButtons()
Sets up the window behaviour to close the application on a window close.


setupMenu

protected void setupMenu()
Sets up the menu items, along with appropriate listeners


getMainMenu

public MainMenu getMainMenu()
Returns Main Menu.

Returns:
the main menue.

getSearchBroker

public JNDIBroker getSearchBroker()
Returns the JNDIBroker used for searching, and the search tree.

Returns:
the search broker.

getTreeTabPane

public javax.swing.JTabbedPane getTreeTabPane()
Returns the tree's tabbed pane.

Returns:
the tabbed pane.

getExplorePanel

public javax.swing.JScrollPane getExplorePanel()
Returns the Explore panel.

Returns:
the explore panel.

getResultsPanel

public javax.swing.JScrollPane getResultsPanel()
Returns the panel for displaying the search results.

Returns:
the results panel.

getSearchTree

public SmartTree getSearchTree()
Returns the search display tree.

Returns:
the search (or results) tree.

getTree

public SmartTree getTree()
Returns the display tree.

Returns:
the explore tree.

getRootFrame

public static javax.swing.JFrame getRootFrame()
Returns the JXplorer frame.

Returns:
the root frame.

getAttributeDisplay

public AttributeDisplay getAttributeDisplay()
Returns the Attribute Display.

Returns:
the main viewer.

setupMainPanel

protected void setupMainPanel()
Sets up the main panel, and places the directory viewing panels in it.


setupToolBars

protected void setupToolBars()

setupActiveComponents

protected void setupActiveComponents()
this is where smart objects such as the tree viewer, the results viewer (from the search class) and the attribute viewers get added to the panes.


initialiseTree

public void initialiseTree(SmartTree tree,
                           DataSink viewer,
                           JXplorerEventGenerator gen)

setupStatusDisplay

protected void setupStatusDisplay()
The Status panel is the small (one line) panel at the bottom of the browser that reports to users what is happening with the browser (e.g. 'connecting', 'disconnected' etc.)


getStatus

public java.lang.String getStatus()

setStatus

public void setStatus(java.lang.String s)
Sets a status message that is displayed on the bottom of the screen.


pushStatus

public void pushStatus(java.lang.String newMessage)
saves the old Status message on the status stack for later use, and sets status to a new message.

Parameters:
newMessage - the new status message to set (note - this new Message is *not* saved on the stack!)

popStatus

public java.lang.String popStatus()
recalls a status message saved via @pushStatus, as well as setting it using @setStatus.

Returns:
the saved status message, in case anyone cares

setupMainWorkArea

protected void setupMainWorkArea()
Sets up the main work area, below the tool bar, which displays the tree/browser panel, and the results panel...


getActiveTree

public SmartTree getActiveTree()
Returns the tree that is currently being directly displayed to the user.


setupFrills

protected void setupFrills()
Make minor additions; the top-right window icon and the title bar text.


getImageIcon

public static javax.swing.ImageIcon getImageIcon(java.lang.String name)
JXplorer utility ftn: load an image from the standard JX images directory.

Parameters:
name - the file name of the image file within the images directory
Returns:
the loaded image.

setupHelp

protected void setupHelp()
Initialise the JavaHelp system, pointing it at the right help files.


getHelpSystem

public CBHelpSystem getHelpSystem()
This returns the help system used by JX. Useful to get if you need to append some more help stuff.

Returns:
the current JX HelpSystem.

shutdown

public void shutdown()
Closes the application down


shutdown

public void shutdown(java.lang.String msg)
Closes the application down, optionally printing out a message

Parameters:
msg - optional message to be printed out on closing.

toString

public java.lang.String toString()
Overrides:
toString in class java.awt.Component

preConnectionSetup

public void preConnectionSetup()
Before a new connection is made, the old display trees should be cleared.


postConnectionSetup

public boolean postConnectionSetup(com.ca.directory.jxplorer.broker.JNDIBroker.DataConnectionQuery request)
When a connection has been established (i.e. by JXOpenConWin), this method is called to link up the trees with their respective data brokers.

This does quite a bit of work, including trying to find the default base naming context(s), and registering schema.


makeDNAutoRefreshing

protected void makeDNAutoRefreshing(DN dn)

disconnect

public void disconnect()
Disables/enables the menu and button bar items to reflect a disconnected state. Clears the Explore, Results and Schema trees and also sets the status message to disconnected.


setDisconnectView

public void setDisconnectView()
Disables/enables the menu and button bar items to reflect a disconnected state. Also sets the status message to disconnected.


addJXplorerListener

public void addJXplorerListener(JXplorerListener l)
Adds the specified JXplorer listener to receive JXplorer events from JXplorer. Currently,the only JXplorer event occurs when a user selects a DN. If l is null, no exception is thrown and no JXplorer is performed.

Parameters:
l - the JXplorer listener
Since:
JDK1.1
See Also:
java.awt.event.JXplorerListener, java.awt.Button#removeJXplorerListener

removeJXplorerListener

public void removeJXplorerListener(JXplorerListener l)
Removes the specified JXplorer listener so that it no longer receives JXplorer events from this button. JXplorer events occur when a user presses or releases the mouse over this button. If l is null, no exception is thrown and no JXplorer is performed.

Parameters:
l - the JXplorer listener
Since:
JDK1.1
See Also:
java.awt.event.JXplorerListener, java.awt.Button#addJXplorerListener

fireJXplorerEvent

public void fireJXplorerEvent(JXplorerEvent e)
Creates JXplorer events by dispatching them to any registered JXplorerListener objects. (Implements the JXplorerEventGenerator interface)

Specified by:
fireJXplorerEvent in interface JXplorerEventGenerator
Parameters:
e - the JXplorer event.
See Also:
JXplorerEventGenerator, JXplorerListener, addJXplorerListener(com.ca.directory.jxplorer.event.JXplorerListener)

showSplashScreen

public void showSplashScreen(javax.swing.JWindow splash)
Displays a splash screen with a thin black border in the center of the screen.


setupResourceFiles

public void setupResourceFiles()
A variety of plugin possibilities exist in JXplorer. To make distribution easier, it is possible to package up class files, as well as image/text/etc. files, and use a custom resource loader to access these zipped/jarred resources. This sets it all up, as well as adding any custom security providers...


setupSecurityProviders

protected void setupSecurityProviders()

addSecurityProvider

protected void addSecurityProvider(java.lang.String providerName)
Allows extra security providers to be manually added.

Parameters:
providerName - the class name of the security provider to add (e.g. something like 'sun.security.provider.Sun')

printSecurityProviders

protected static void printSecurityProviders()

isSolaris

public static boolean isSolaris()
Test for solaris (usually to disable features that appear to be more than usually broken on that platform - e.g. drag and drop).


isLinux

public static boolean isLinux()
Test for Linux (usually to disable features that appear to be more than usually broken on that platform - e.g. JAVA L&F).

Returns:
true if Linux OS, false otherwise.