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.
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    Called when an application, applet, or installer has been launched successfully (the main method or applet start method returned normally).
    void
    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
    Called when an application, applet or installer has been determined.
    void
    Called when an application, applet or installer is ready to start.
    boolean
    Called when launching the application can not be launched due to an error that is not fatal.
    boolean
    Called when a security validation error occurs while launching the application.
  • Method Details

    • launchError

      void launchError(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
    • launchWarning

      boolean launchWarning(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 consummed as warning
      Returns:
      true if the launch should continue, false to abort
    • validationError

      boolean validationError(LaunchException error)
      Called when a security validation error occurs while launching the application.
      Parameters:
      error - to be rethrown as launch error
      Returns:
      true to allow the application to continue, false to stop it.
    • 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