Examples of org.osgi.service.application.ApplicationHandle.destroy()

• org.osgi.service.application.ApplicationHandle.destroy()
  The application instance's lifecycle state can be influenced by this method. It lets the application instance perform operations to stop the application safely, e.g. saving its state to a permanent storage.

  The method must check if the lifecycle transition is valid; a STOPPING application cannot be stopped. If it is invalid then the method must exit. Otherwise the lifecycle state of the application instance must be set to STOPPING. Then the destroySpecific() method must be called to perform any application model specific steps for safe stopping of the represented application instance.

  At the end the {@code ApplicationHandle} must be unregistered. Thismethod should free all the resources related to this {@code ApplicationHandle}.

  When this method is completed the application instance has already made its operations for safe stopping, the ApplicationHandle has been unregistered and its related resources has been freed. Further calls on this application should not be made because they may have unexpected results. @throws SecurityException if the caller doesn't have "lifecycle"{@code ApplicationAdminPermission} for the correspondingapplication. @throws IllegalStateException if the application handle is unregistered