Package net.sourceforge.jnlp.runtime
Class ApplicationInstance
java.lang.Object
net.sourceforge.jnlp.runtime.ApplicationInstance
- Direct Known Subclasses:
AppletInstance
Represents a running instance of an application described in a
JNLPFile. This class provides a way to track the application's
resources and destroy the application.
-
Constructor Summary
ConstructorsConstructorDescriptionApplicationInstance
(JNLPFile file, ThreadGroup group, ClassLoader loader) Create an application instance for the file. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addApplicationListener
(ApplicationListener listener) Add an Application listenerprotected void
Adds a window that this application opened.void
destroy()
Stop the application and destroy its resources.void
finalize()
Releases the application's resources before it is collected.protected void
Notify listeners that the application has been terminated.sun.awt.AppContext
Returns the classloader.Returns the jnlpfile on which is this application basedReturns the thread group.getTitle()
Returns the application title.void
Initialize the application's environment (installs environment variables, etc).boolean
Returns whether the application is running.boolean
isSigned()
void
removeApplicationListener
(ApplicationListener listener) Remove an Application Listener
-
Constructor Details
-
ApplicationInstance
Create an application instance for the file. This should be done in the appropriateThreadGroup
only.- Parameters:
file
- jnlpfile for which the instance do existsgroup
- thread group to which it belongsloader
- loader for this application
-
-
Method Details
-
addApplicationListener
Add an Application listener- Parameters:
listener
- listener to be added
-
removeApplicationListener
Remove an Application Listener- Parameters:
listener
- to be removed
-
fireDestroyed
protected void fireDestroyed()Notify listeners that the application has been terminated. -
initialize
public void initialize()Initialize the application's environment (installs environment variables, etc). -
finalize
public void finalize()Releases the application's resources before it is collected. Only collectable if classloader and thread group are also collectable so basically is almost never called (an application would have to close its windows and exit its threads but not call JNLPRuntime.exit). -
getJNLPFile
Returns the jnlpfile on which is this application based- Returns:
- JNLP file for this task.
-
getTitle
Returns the application title.- Returns:
- the title of this application
-
isRunning
public boolean isRunning()Returns whether the application is running.- Returns:
- state of application
-
destroy
public void destroy()Stop the application and destroy its resources. -
getThreadGroup
Returns the thread group.- Returns:
- thread group of this application, unless it is stopped
- Throws:
IllegalStateException
- if the app is not running
-
getClassLoader
Returns the classloader.- Returns:
- the classloader of this application, unless it is stopped
- Throws:
IllegalStateException
- if the app is not running
-
addWindow
Adds a window that this application opened. When the application is disposed, these windows will also be disposed.- Parameters:
window
- to be added
-
isSigned
public boolean isSigned()- Returns:
- whether or not this application is signed.
-
getAppContext
public sun.awt.AppContext getAppContext()- Returns:
- application context of this instance
-