Examples of org.osgi.service.application.ApplicationDescriptor.launch()

• org.osgi.service.application.ApplicationDescriptor.launch()
  Launches a new instance of an application. The {@code args} parameterspecifies the startup parameters for the instance to be launched, it may be null.

  The following steps are made:

  • Check for the appropriate permission.
  • Check the locking state of the application. If locked then throw an {@link ApplicationException} with the reason code{@link ApplicationException#APPLICATION_LOCKED}.
  • Calls the {@code launchSpecific()} method to create and start anapplication instance.
  • Returns the {@code ApplicationHandle} returned by thelaunchSpecific()

  The caller has to have ApplicationAdminPermission(applicationPID, "launch") in order to be able to perform this operation.

  The {@code Map} argument of the launch method contains startup argumentsfor the application. The keys used in the Map must be non-null, non-empty {@code String} objects. They can be standard or application specific.OSGi defines the {@code org.osgi.triggeringevent} key to be used to passthe triggering event to a scheduled application, however in the future it is possible that other well-known keys will be defined. To avoid unwanted clashes of keys, the following rules should be applied:

  • The keys starting with the dash (-) character are application specific, no well-known meaning should be associated with them.
  • Well-known keys should follow the reverse domain name based naming. In particular, the keys standardized in OSGi should start with {@code org.osgi.}.

  The method is synchronous, it return only when the application instance was successfully started or the attempt to start it failed.

  This method never returns {@code null}. If launching an application fails, the appropriate exception is thrown. @param arguments Arguments for the newly launched application, may benull @return the registered ApplicationHandle, which represents the newlylaunched application instance. Never returns {@code null}. @throws SecurityException if the caller doesn't have "lifecycle"ApplicationAdminPermission for the application. @throws ApplicationException if starting the application failed @throws IllegalStateException if the application descriptor isunregistered @throws IllegalArgumentException if the specified {@code Map} containsinvalid keys (null objects, empty {@code String} or a key that isnot {@code String})