ej.wadapps.application

Interface ApplicationInstaller

All Known Implementing Classes:

ApplicationInstallerKF, PersistentApplicationInstallerKF

public interface ApplicationInstaller

The application installer allows to install or uninstall applications.

Method Summary

Modifier and Type	Method and Description
void	addApplicationInstallationListener(ApplicationInstallationListener applicationInstallationListener) Adds an application installation listener.
boolean	canUninstall(Application application) Checks if we can uninstall the given application.
Application	install(InputStream stream) Installs an application from an input stream.
Application	install(InputStream stream, IProgressMonitor monitor) Installs an application from an input stream.
void	removeApplicationInstallationListener(ApplicationInstallationListener applicationInstallationListener) Removes an application installation listener.
boolean	uninstall(Application application) Uninstalls an application.
boolean	uninstall(Application application, IProgressMonitor monitor) Uninstalls an application.

Method Detail

addApplicationInstallationListener

void addApplicationInstallationListener(ApplicationInstallationListener applicationInstallationListener)

Adds an application installation listener.

It will be notified for each application installation or uninstallation.

Parameters:

applicationInstallationListener - the listener to add.

canUninstall

boolean canUninstall(Application application)

Checks if we can uninstall the given application.

Parameters:

application - the application to check.

Returns:

true if the application can been uninstalled, false otherwise.

install

Application install(InputStream stream)
             throws ApplicationOperationException

Installs an application from an input stream.

Parameters:

stream - the stream containing the application.

Returns:

the application instance.

Throws:

SecurityException - if a security manager exits and if the caller does not have the appropriate permissions.

ApplicationOperationException - if any unexpected errors occur while installing this application.

install

Application install(InputStream stream,
                    IProgressMonitor monitor)
             throws ApplicationOperationException

Installs an application from an input stream.

Parameters:

stream - the stream containing the application.

monitor - the progress monitor to use for reporting progress to the user. It is the caller's responsibility to call done() on the given monitor.

Returns:

the application instance.

Throws:

SecurityException - if a security manager exits and if the caller does not have the appropriate permissions.

ApplicationOperationException - if any unexpected errors occur while installing this application.

removeApplicationInstallationListener

void removeApplicationInstallationListener(ApplicationInstallationListener applicationInstallationListener)

Removes an application installation listener.

If the given listener is not registered, nothing is done.

Parameters:

applicationInstallationListener - the listener to remove.

uninstall

boolean uninstall(Application application)
           throws ApplicationOperationException

Uninstalls an application.

Parameters:

application - the application to uninstall.

Returns:

true if the application has been uninstalled, false otherwise.

Throws:

SecurityException - if a security manager exits and if the caller does not have the appropriate permissions.

ApplicationOperationException - if any unexpected errors occur while uninstalling this application.

uninstall

boolean uninstall(Application application,
                  IProgressMonitor monitor)
           throws ApplicationOperationException

Uninstalls an application.

Parameters:

application - the application to uninstall.

monitor - the progress monitor to use for reporting progress to the user. It is the caller's responsibility to call done() on the given monitor.

Returns:

true if the application has been uninstalled, false otherwise.

Throws:

SecurityException - if a security manager exits and if the caller does not have the appropriate permissions.

ApplicationOperationException - if any unexpected errors occur while uninstalling this application.