javax.jbi.management
Interface InstallationServiceMBean

public interface InstallationServiceMBean

The deployment service MBean allows administrative tools to manage service assembly deployments. The tasks supported are:

• Installing (and uninstalling) a shared library
• Creating (loading) and destroying (unloading) a component installer MBean.
• Finding an existing component installer MBean.

Installing and uninstalling components is accomplished using InstallerMBeans, loaded by this MBean. An individual installer MBean is needed for each component installation / uninstallation. This is to support the more complex installation process that some components require.

Author:

JSR208 Expert Group

Method Summary

java.lang.String	installSharedLibrary(java.lang.String slZipURL) TODO result must be non-null and non-empty, refactoring all failure cases Install a shared library installation package.
javax.management.ObjectName	loadInstaller(java.lang.String componentName) Load the InstallerMBean for a previously installed component.
javax.management.ObjectName	loadNewInstaller(java.lang.String installZipURL) TODO result must be non-null.
boolean	uninstallSharedLibrary(java.lang.String slName) Uninstall a previously installed shared library.
boolean	unloadInstaller(java.lang.String aComponentName, boolean isToBeDeleted) TODO unloadInstaller isToBeDeleted parameter isn't used at the moment : this method completly deletes the component from the container TODO unloadInstaller Problem with jar deletion, they can't be deleted before classloader been garbaged collected TODO Refactoring failure cases Unload an InstallerMBean previously loaded for a component.

Method Detail

installSharedLibrary

java.lang.String installSharedLibrary(java.lang.String slZipURL)

TODO result must be non-null and non-empty, refactoring all failure cases Install a shared library installation package.

The return value is the unique name for the shared-library, as found in the the value of the installation descriptor's <identification><name> element.

Parameters:

slZipURL - URL locating a zip file containing a shared library installation package; must be non-null, non-empty, and a legal URL

Returns:

the unique name of the shared library loaded from slZipURL; must be non-null and non-empty

loadInstaller

javax.management.ObjectName loadInstaller(java.lang.String componentName)

Load the InstallerMBean for a previously installed component.

The "component name" refers to the <identification> <name> element value from the component's installation package (see loadNewInstaller(String)).

Parameters:

componentName - the component name identifying the installer to load; must be non-null and non-empty

Returns:

the JMX ObjectName of the InstallerMBean loaded from an existing installation context; null if the installer MBean doesn't exist

loadNewInstaller

javax.management.ObjectName loadNewInstaller(java.lang.String installZipURL)

TODO result must be non-null. Refactoring all failure cases and algorithm Load the installer for a new component for the given component installation package.

Parameters:

installZipURL - URL locating a ZIP file containing the JBI Installation package to be installed; must be non-null, non-empty, and a legal URL

Returns:

the JMX ObjectName of the InstallerMBean loaded from installZipURL; must be non-null

uninstallSharedLibrary

boolean uninstallSharedLibrary(java.lang.String slName)

Uninstall a previously installed shared library.

Parameters:

slName - the name of the shared name space to uninstall; must be non-null and non-empty

Returns:

true if the uninstall was successful

unloadInstaller

boolean unloadInstaller(java.lang.String aComponentName,
                        boolean isToBeDeleted)

TODO unloadInstaller isToBeDeleted parameter isn't used at the moment : this method completly deletes the component from the container TODO unloadInstaller Problem with jar deletion, they can't be deleted before classloader been garbaged collected TODO Refactoring failure cases Unload an InstallerMBean previously loaded for a component.

Parameters:

componentName - the component name identifying the installer to unload; must be non-null and non-empty

isToBeDeleted - trueReturns:

true if the operation was successful, otherwise false