com.vlsolutions.swing.toolbars
Class ToolBarPersistence

java.lang.Object
  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