Swing utility classes

There are three Swing utility classes helping to use the API in a Swing environment:

• The DefaultSwingScriptLogger is a JFrame which implements the Script logger interface
• The DefaultSwingScriptLoggerArea is a JComponent which implements the Script logger interface
• The SwingExceptionListener implements the Exception listener interface
• The SwingDebugScriptWindow is a Swing component which is a Debug listener and allows to manage a debug session. See also SwingDebugScriptWindow for more information about this Swing component

Dependencies

You just need to have the scriptHelperSwing.jar file in your Classpath.

Showing logs

Logs are handled by the DefaultSwingScriptLogger and the DefaultSwingScriptLoggerArea classes.

To show the logs in a Swing window, just use the following:

      ScriptWrapper<Script> wrapper = new GroovyScriptWrapper() {
      }
      ...
      DefaultSwingScriptLogger(); logger = new DefaultSwingScriptLogger();
      wrapper.setScriptLogger(logger);

Showing exceptions

Exceptions StackTrace are handled by the SwingExceptionListener class.

To show the exceptions in a Swing window, just use the following:

      ScriptWrapper<Script> wrapper = new GroovyScriptWrapper() {
      }
      ...
      SwingExceptionListener listener = new SwingExceptionListener();
      wrapper.addExceptionListener(listener);

Then the first exception encountered during the compilation or execution of the script will popup the following window, for example:

StackTraces are also shown and clicking on a StackTrace element allows to go to the associated line in the script. For example:

Behavior of the error window

By default the error window will not reappear in the script session but the next error message will only be shown in the logger. However it is possible to configure the SwingExceptionListener so that all exceptions will trigger the apparition of the error window by:

      listener.resetWrapperOnDispose(true);

In this case, the window will show a "dismiss" option for quitting the widnwo to allow to reset to the default behavior: