netx.jnlp
public class Launcher extends java.lang.Object
An optional LaunchHandler can be specified that is notified of warning and error condition while launching and that indicates whether a launch may proceed after a warning has occurred. If specified, the LaunchHandler is notified regardless of whether the file is launched in the foreground or background.
Constructor and Description |
---|
Launcher()
Create a launcher with the runtime's default update policy
and launch handler.
|
Launcher(LaunchHandler handler)
Create a launcher with the specified handler and the
runtime's default update policy.
|
Launcher(LaunchHandler handler,
UpdatePolicy policy)
Create a launcher with an optional handler using the
specified update policy and launch handler.
|
Modifier and Type | Method and Description |
---|---|
protected AppletInstance |
createApplet(JNLPFile file,
boolean enableCodeBase)
Create an AppletInstance.
|
protected ApplicationInstance |
createApplication(JNLPFile file)
Creates an Application.
|
protected AppThreadGroup |
createThreadGroup(JNLPFile file)
Create a thread group for the JNLP file.
|
UpdatePolicy |
getUpdatePolicy()
Returns the update policy used when launching applications.
|
boolean |
isCreateAppContext()
Returns whether applications are launched in their own
AppContext.
|
ApplicationInstance |
launch(JNLPFile file)
Launches a JNLP file by calling the launch method for the
appropriate file type.
|
ApplicationInstance |
launch(java.net.URL location)
Launches a JNLP file by calling the launch method for the
appropriate file type.
|
protected ApplicationInstance |
launchApplet(JNLPFile file,
boolean enableCodeBase)
Launches a JNLP applet.
|
protected ApplicationInstance |
launchApplication(JNLPFile file)
Launches a JNLP application.
|
void |
launchBackground(JNLPFile file)
Launches a JNLP file by calling the launch method for the
appropriate file type in a different thread.
|
void |
launchBackground(java.net.URL location)
Launches the JNLP file at the specified location in the
background by calling the launch method for its file type.
|
void |
launchExternal(JNLPFile file)
Launches the JNLP file in a new JVM instance.
|
void |
launchExternal(java.net.URL location)
Launches the JNLP file at the specified location in a new JVM
instance.
|
protected ApplicationInstance |
launchInstaller(JNLPFile file)
Launches a JNLP installer.
|
void |
setCreateAppContext(boolean context)
Sets whether to launch the application in a new AppContext
(a separate event queue, look and feel, etc).
|
void |
setUpdatePolicy(UpdatePolicy policy)
Sets the update policy used by launched applications.
|
public Launcher()
public Launcher(LaunchHandler handler)
handler
- the handler to use or null for no handler.public Launcher(LaunchHandler handler, UpdatePolicy policy)
handler
- the handler to use or null for no handler.policy
- the update policy to use or null for default policy.public void setUpdatePolicy(UpdatePolicy policy)
public UpdatePolicy getUpdatePolicy()
public void setCreateAppContext(boolean context)
public boolean isCreateAppContext()
public ApplicationInstance launch(JNLPFile file) throws LaunchException
file
- the JNLP file to launchLaunchException
- if an error occurred while launching (also sent to handler)public ApplicationInstance launch(java.net.URL location) throws LaunchException
location
- the URL of the JNLP file to launchLaunchException
- if there was an exceptionpublic void launchBackground(JNLPFile file)
file
- the JNLP file to launchpublic void launchBackground(java.net.URL location)
location
- the location of the JNLP filepublic void launchExternal(JNLPFile file) throws LaunchException
file
- the JNLP file to launchLaunchException
- if there was an exceptionpublic void launchExternal(java.net.URL location) throws LaunchException
location
- the URL of the JNLP file to launchLaunchException
- if there was an exceptionprotected ApplicationInstance launchApplication(JNLPFile file) throws LaunchException
LaunchException
protected ApplicationInstance launchApplet(JNLPFile file, boolean enableCodeBase) throws LaunchException
The enableCodeBase parameter adds the applet's codebase to the locations searched for resources and classes. This can slow down the applet loading but allows browser-style applets that don't use JAR files exclusively to be run from a applet JNLP file. If the applet JNLP file does not specify any resources then the code base will be enabled regardless of the specified value.
file
- the JNLP fileenableCodeBase
- whether to add the codebase URL to the classloaderLaunchException
protected ApplicationInstance launchInstaller(JNLPFile file) throws LaunchException
LaunchException
protected AppletInstance createApplet(JNLPFile file, boolean enableCodeBase) throws LaunchException
enableCodeBase
- whether to add the code base URL to the classloaderLaunchException
protected ApplicationInstance createApplication(JNLPFile file) throws LaunchException
LaunchException
protected AppThreadGroup createThreadGroup(JNLPFile file)