Interface LaunchHandler

All Known Implementing Classes:
AbstractLaunchHandler, DefaultLaunchHandler, GuiLaunchHandler
public interface LaunchHandler
This optional interface is used to handle conditions that occur while launching JNLP applications, applets, and installers.
Version:
$Revision: 1.9 $

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    handleLaunchError(LaunchException exception)
    Called when the application could not be launched due to a fatal error, such as the inability to find the main class or non-parseable XML.
    void
    handleLaunchWarning(LaunchException warning)
    Called when launching the application can not be launched due to an error that is not fatal.
    void
    launchCompleted(ApplicationInstance application)
    Called when an application, applet, or installer has been launched successfully (the main method or applet start method returned normally).
    void
    launchInitialized(JNLPFile file)
    Called when an application, applet or installer has been determined.
    void
    launchStarting(ApplicationInstance application)
    Called when an application, applet or installer is ready to start.
    void
    validationError(LaunchException error)
    Called when a security validation error occurs while launching the application.

  • Method Details

    • handleLaunchError

      void handleLaunchError(LaunchException exception)
      Called when the application could not be launched due to a fatal error, such as the inability to find the main class or non-parseable XML.
      Parameters:
      exception - to be re-thrown as launch error

    • handleLaunchWarning

      void handleLaunchWarning(LaunchException warning)
      Called when launching the application can not be launched due to an error that is not fatal. For example a JNLP file that is not strictly correct yet does not necessarily prohibit the system from attempting to launch the application.
      Parameters:
      warning - exception to be consumed as warning

    • validationError

      void validationError(LaunchException error)
      Called when a security validation error occurs while launching the application.
      Parameters:
      error - to be rethrown as launch error

    • launchInitialized

      void launchInitialized(JNLPFile file)
      Called when an application, applet or installer has been determined. We have some very basic information about the application at this point, but do not have everything required. This is a nice point to show the splash screen.
      Parameters:
      file - the JNLP file of the instance that is starting

    • launchStarting

      void launchStarting(ApplicationInstance application)
      Called when an application, applet or installer is ready to start. Good point to hide the splash screen.
      Parameters:
      application - the application instance that is ready

    • launchCompleted

      void launchCompleted(ApplicationInstance application)
      Called when an application, applet, or installer has been launched successfully (the main method or applet start method returned normally).
      Parameters:
      application - the launched application instance