1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
// Copyright (C) 2001-2003 Jon A. Maxwell (JAM)
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
package net.sourceforge.jnlp;
import net.sourceforge.jnlp.runtime.*;
/**
* This optional interface is used to handle conditions that occur
* while launching JNLP applications, applets, and installers.
*
* @author <a href="mailto:jmaxwell@users.sourceforge.net">Jon A. Maxwell (JAM)</a> - initial author
* @version $Revision: 1.9 $
*/
public interface LaunchHandler {
/**
* 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.
*/
public void launchError(LaunchException exception);
/**
* 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.
*
* @return true if the launch should continue, false to abort
*/
public boolean launchWarning(LaunchException warning);
/**
* Called when a security validation error occurs while
* launching the application.
*
* @return true to allow the application to continue, false to stop it.
*/
public boolean validationError(LaunchException error);
// this method will probably be replaced when real security
// controller is in place.
/**
* 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.
*
* @param application the application instance that is starting
*/
public void launchInitialized(JNLPFile file);
/**
* Called when an application, applet or installer is ready to start.
* Good point to hide the splash screen.
*
* @param application the application instance that is ready
*/
public void launchStarting(ApplicationInstance application);
/**
* Called when an application, applet, or installer has been
* launched successfully (the main method or applet start method
* returned normally).
*
* @param application the launched application instance
*/
public void launchCompleted(ApplicationInstance application);
}
|
