install4j API documentation



com.install4j.api.launcher
Class ApplicationLauncher

java.lang.Object
  extended by com.install4j.api.launcher.ApplicationLauncher

public class ApplicationLauncher
extends java.lang.Object

This class allows you to launch an installer application, such as an updater, from your own application. It includes a mechanism for the installer application to shut down the invoking application with a "Shutdown calling launcher" action.

In order to use this class, please include resource/i4jruntime.jar from your install4j installation into your class path. You do not need to distribute this file along with your application, install4j will do this automatically for you.

Author:
ej-technologies GmbH

Nested Class Summary
static interface ApplicationLauncher.Callback
          You can implement this interface to receive notifications when the installer application exits or needs to shut down your application.
 
Constructor Summary
ApplicationLauncher()
           
 
Method Summary
static void launchApplication(java.lang.String applicationId, java.lang.String[] arguments, boolean blocking, ApplicationLauncher.Callback callback)
          Launch an installer application that you have defined in the install4j IDE.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ApplicationLauncher

public ApplicationLauncher()
Method Detail

launchApplication

public static void launchApplication(java.lang.String applicationId,
                                     java.lang.String[] arguments,
                                     boolean blocking,
                                     ApplicationLauncher.Callback callback)
                              throws java.io.IOException
Launch an installer application that you have defined in the install4j IDE.

Parameters:
applicationId - the ID of the installer application to be launched. You can show the IDs of all installer applications on the "Installer->Screens & actions" tab with the "Show IDs" tool bar button.
arguments - the arguments you want to pass to the installer application. Can be null if no arguments should be passed. Arguments like -Dkey=value will be passed as JVM parameters, just like when calling the installer application from the command line.
blocking - if this call should block until the installer application exits.
callback - an optional call back for receiving notifications when the installer application exits or when the installer application shuts down this JVM. Can be null
Throws:
java.io.IOException - if there was an error starting the installer application