Interface ApplicationManager
public interface ApplicationManager
Application Manager API.
Used to manipulate Glue Desktop applications.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionReturns configurations for all available applications.Returns all currently running application instances.Returns the current application instance.ready()A future that completes when app manager is initialized.default CompletionStage<AsynchronousCloseable> registerInstanceHandler(String applicationName, ApplicationInstanceHandler handler) Registers a handler function to be executed when child application instance is started.registerInstanceHandler(String applicationName, Consumer<ApplicationConfiguration.Builder> config, ApplicationInstanceHandler handler) Registers a handler function to be executed when Glue Desktop will shut down or restart.default CompletionStage<ApplicationInstance> Start an application by specified name.default CompletionStage<ApplicationInstance> Start an application instance by specified name and context.Start an application instance by specified name, context and options.
-
Method Details
-
applications
Map<String,ApplicationConfiguration> applications()Returns configurations for all available applications. They are keyed by application name.- Returns:
- a map with available application configurations keyed by application name, never
null
-
instances
Collection<ApplicationInstance> instances()Returns all currently running application instances.- Returns:
- collection with all running application instances, never
null
-
myInstance
Optional<ApplicationInstance> myInstance()Returns the current application instance.- Returns:
- current application instance
- Since:
- 1.4.12
-
ready
CompletionStage<ApplicationManager> ready()A future that completes when app manager is initialized.- Returns:
- a stage that completes when application manager is initialized, never
null - Since:
- 1.4.12
-
start
CompletionStage<ApplicationInstance> start(String applicationName, Map<String, Object> context, Map<String, Object> options) Start an application instance by specified name, context and options.- Parameters:
applicationName- identifying name for the applicationcontext- starting context specificationoptions- starting options specification- Returns:
- a stage that completes when application instance starts, never
null - Since:
- 1.4.9
-
start
default CompletionStage<ApplicationInstance> start(String applicationName, Map<String, Object> context) Start an application instance by specified name and context.- Parameters:
applicationName- identifying name for the applicationcontext- starting context specification- Returns:
- a stage that completes when application instance starts, never
null
-
start
Start an application by specified name.- Parameters:
applicationName- identifying name for the application- Returns:
- a stage that completes when the application instance is started, never
null
-
registerInstanceHandler
default CompletionStage<AsynchronousCloseable> registerInstanceHandler(String applicationName, ApplicationInstanceHandler handler) Registers a handler function to be executed when child application instance is started.- Parameters:
applicationName- The application name, must not benullhandler- The application instance handler, must not benull- Returns:
- A stage that completes when the handler is registered, never
null - Since:
- 1.4.2
-
registerInstanceHandler
CompletionStage<AsynchronousCloseable> registerInstanceHandler(String applicationName, Consumer<ApplicationConfiguration.Builder> config, ApplicationInstanceHandler handler) - Parameters:
applicationName- The application name, must not benullconfig- The application configuration builder, may benullhandler- The application instance handler, must not benull- Returns:
- A stage that completes when the handler is registered, never
null - Since:
- 1.7.0
-
registerShuttingDownHandler
Registers a handler function to be executed when Glue Desktop will shut down or restart.- Returns:
- A stage that completes when the handler is registered, never
null - Since:
- 1.4.12
-