com.vlsolutions.swing.toolbars
Class ToolBarPersistence

java.lang.Object
  extended by com.vlsolutions.swing.toolbars.ToolBarPersistence
All Implemented Interfaces:
java.lang.Runnable

public class ToolBarPersistence
extends java.lang.Object
implements java.lang.Runnable

This class contains methods to keep a set of toolbars persistent.

The class uses the preferences framework of the java runtime, and installs a shutdown hook to save the toolbars state on application exit.

Warning : this class cannot be run from a sandboxed (untrusted) environment (unsigned applet/ java web start) as it uses classes requiring a SecurityManager (Preferences API and Runtime shutdown hook).

Call loadToolBarLayout() upon application startup, after registering all ToolBars.

See Also:
ToolBarIO

Constructor Summary
ToolBarPersistence(java.lang.Object mainClass, ToolBarContainer container)
          Construct a new set of persistent toolbars.
 
Method Summary
protected  void handleUnloadedToolBar(VLToolBar toolbar)
           
 void loadToolBarLayout()
          Load the toolbar configuration.
 void run()
          Save the toolbar configuration.
 void saveToolBarLayout()
          Save the toolbar configuration.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ToolBarPersistence

public ToolBarPersistence(java.lang.Object mainClass,
                          ToolBarContainer container)
Construct a new set of persistent toolbars.

Parameters:
mainClass - the main class of the application. Will be used to generate a reasonable name for the preferences to store toolbar configuration
container - the toolbarcontainer to keep persistent
Throws:
java.lang.SecurityException - if this class is invoked from an untrusted environment
Method Detail

handleUnloadedToolBar

protected void handleUnloadedToolBar(VLToolBar toolbar)

loadToolBarLayout

public void loadToolBarLayout()
                       throws java.io.IOException,
                              javax.xml.parsers.ParserConfigurationException,
                              org.xml.sax.SAXException
Load the toolbar configuration.

Throws:
java.io.IOException
javax.xml.parsers.ParserConfigurationException
org.xml.sax.SAXException

run

public void run()
Save the toolbar configuration.

Masks all errors.

don't call this method directly : it is used by the shudown hook.

Specified by:
run in interface java.lang.Runnable
See Also:
Runnable.run()

saveToolBarLayout

public void saveToolBarLayout()
                       throws java.io.IOException
Save the toolbar configuration.

Throws:
java.io.IOException


© Copyright 2004-2007 VLSolutions. All Rights Reserved.
www.vlsolutions.com : Java Components - Smart Client Applications