Package net.sourceforge.jnlp
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 TypeMethodDescriptionvoid
launchCompleted
(ApplicationInstance application) Called when an application, applet, or installer has been launched successfully (the main method or applet start method returned normally).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.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.boolean
launchWarning
(LaunchException warning) Called when launching the application can not be launched due to an error that is not fatal.boolean
validationError
(LaunchException error) Called when a security validation error occurs while launching the application.
-
Method Details
-
launchError
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
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
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
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
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
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
-