Module io.helidon.inject.api
Package io.helidon.inject.api

Interface InjectionServices

@Deprecated(forRemoval=true, since="4.0.8") public interface InjectionServices
Deprecated, for removal: This API element is subject to removal in a future version.
Helidon inject is deprecated and will be replaced in a future version
Abstract factory for all services provided by a single Helidon Injection provider implementation. An implementation of this interface must minimally supply a "services registry" - see services().

The global singleton instance is accessed via injectionServices(). Note that optionally one can provide a primordial bootstrap configuration to the Injection services provider. One must establish any bootstrap instance prior to the first call to injectionServices() as it will use a default configuration if not explicitly set. Once the bootstrap has been set it cannot be changed for the lifespan of the JVM.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final ServiceInfoCriteria
    EMPTY_CRITERIA
    Deprecated, for removal: This API element is subject to removal in a future version.
    Empty criteria will match anything and everything.
    static final ContextualServiceQuery
    SERVICE_QUERY_REQUIRED
    Deprecated, for removal: This API element is subject to removal in a future version.
    Denotes a match to any (default) service, but required to be matched to at least one.
    static final String
    TAG_DEBUG
    Deprecated, for removal: This API element is subject to removal in a future version.
    Tag for putting Injection tooling, processing, and runtime into debug mode.

  • Method Summary

    Modifier and Type
    Method
    Description
    Optional<ActivationLog>
    activationLog()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Optionally, the service provider activation log.
    Bootstrap
    bootstrap()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Returns the Bootstrap configuration instance that was used to initialize this instance.
    InjectionServicesConfig
    config()
    Deprecated, for removal: This API element is subject to removal in a future version.
    The governing configuration.
    static ActivationRequest
    createActivationRequestDefault()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Will create an activation request either to Phase.ACTIVE or limited to any BootstrapBlueprint.limitRuntimePhase() specified.
    static Optional<Bootstrap>
    globalBootstrap()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Retrieves any primordial bootstrap configuration that previously set.
    static void
    globalBootstrap(Bootstrap bootstrap)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Sets the primordial bootstrap configuration that will supply injectionServices() during global singleton initialization.
    static Optional<InjectionServices>
    injectionServices()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Get InjectionServices instance if available.
    Optional<Injector>
    injector()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Optionally, the injector.
    static boolean
    isDebugEnabled()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Whether debug is enabled.
    Optional<Set<ServiceInfoCriteria>>
    lookups()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Optionally, the set of Services lookup criteria that were recorded.
    Optional<Metrics>
    metrics()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Optionally, the metrics that are exposed by the provider implementation.
    static Bootstrap
    realizedGlobalBootStrap()
    Deprecated, for removal: This API element is subject to removal in a future version.
    First attempts to locate and return the globalBootstrap() and if not found will create a new bootstrap instance.
    static Services
    realizedServices()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Short-cut for the following code block.
    default Services
    services()
    Deprecated, for removal: This API element is subject to removal in a future version.
    The service registry.
    Optional<? extends Services>
    services(boolean initialize)
    Deprecated, for removal: This API element is subject to removal in a future version.
    The service registry.
    Optional<Map<TypeName,ActivationResult>>
    shutdown()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Attempts to perform a graceful Injector.deactivate(Object, InjectorOptions) on all managed service instances in the Services registry.
    static Phase
    terminalActivationPhase()
    Deprecated, for removal: This API element is subject to removal in a future version.
    The terminal phase for activation that we should not cross.
    static Optional<Services>
    unrealizedServices()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Similar to services(), but here if Injection is not available or the services registry has not yet been initialized then this method will return Optional.empty().

  • Field Details

    • TAG_DEBUG

      static final String TAG_DEBUG
      Deprecated, for removal: This API element is subject to removal in a future version.
      Tag for putting Injection tooling, processing, and runtime into debug mode.
      See Also:

    • EMPTY_CRITERIA

      static final ServiceInfoCriteria EMPTY_CRITERIA
      Deprecated, for removal: This API element is subject to removal in a future version.
      Empty criteria will match anything and everything.

    • SERVICE_QUERY_REQUIRED

      static final ContextualServiceQuery SERVICE_QUERY_REQUIRED
      Deprecated, for removal: This API element is subject to removal in a future version.
      Denotes a match to any (default) service, but required to be matched to at least one.

  • Method Details

    • isDebugEnabled

      static boolean isDebugEnabled()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Whether debug is enabled.
      Returns:
      whether to debug

    • bootstrap

      Bootstrap bootstrap()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Returns the Bootstrap configuration instance that was used to initialize this instance.
      Returns:
      the bootstrap configuration instance

    • globalBootstrap

      static Optional<Bootstrap> globalBootstrap()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Retrieves any primordial bootstrap configuration that previously set.
      Returns:
      the bootstrap primordial configuration already assigned
      See Also:

    • realizedGlobalBootStrap

      static Bootstrap realizedGlobalBootStrap()
      Deprecated, for removal: This API element is subject to removal in a future version.
      First attempts to locate and return the globalBootstrap() and if not found will create a new bootstrap instance.
      Returns:
      a bootstrap

    • globalBootstrap

      static void globalBootstrap(Bootstrap bootstrap)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Sets the primordial bootstrap configuration that will supply injectionServices() during global singleton initialization.
      Parameters:
      bootstrap - the primordial global bootstrap configuration
      See Also:

    • injectionServices

      static Optional<InjectionServices> injectionServices()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Get InjectionServices instance if available. The highest Weighted service will be loaded and returned. Remember to optionally configure any primordial Bootstrap configuration prior to the first call to get InjectionServices.
      Returns:
      the services instance

    • realizedServices

      static Services realizedServices()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Short-cut for the following code block. During the first invocation the Services registry will be initialized. 
       
   return injectionServices().orElseThrow().services();
      Returns:
      the services instance

    • unrealizedServices

      static Optional<Services> unrealizedServices()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Similar to services(), but here if Injection is not available or the services registry has not yet been initialized then this method will return Optional.empty(). This is convenience for users who conditionally want to use Injection's service registry if it is currently available and in active use, but if not do alternative processing or allocations directly, etc.
      Returns:
      the services instance if it has already been activated and initialized, empty otherwise

    • services

      default Services services()
      Deprecated, for removal: This API element is subject to removal in a future version.
      The service registry. The first call typically loads and initializes the service registry. To avoid automatic loading and initialization on any first request then consider using unrealizedServices() or services(boolean).
      Returns:
      the services registry

    • services

      Optional<? extends Services> services(boolean initialize)
      Deprecated, for removal: This API element is subject to removal in a future version.
      The service registry. The first call typically loads and initializes the service registry.
      Parameters:
      initialize - true to allow initialization applicable for the 1st request, false to prevent 1st call initialization
      Returns:
      the services registry if it is available and already has been initialized, empty if not yet initialized

    • config

      InjectionServicesConfig config()
      Deprecated, for removal: This API element is subject to removal in a future version.
      The governing configuration.
      Returns:
      the config

    • injector

      Optional<Injector> injector()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Optionally, the injector.
      Returns:
      the injector, or empty if not available

    • shutdown

      Optional<Map<TypeName,ActivationResult>> shutdown()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Attempts to perform a graceful Injector.deactivate(Object, InjectorOptions) on all managed service instances in the Services registry. Deactivation is handled within the current thread.

      If the service provider does not support shutdown an empty is returned.

      The default reference implementation will return a map of all service types that were deactivated to any throwable that was observed during that services shutdown sequence.

      The order in which services are deactivated is dependent upon whether the activationLog() is available. If the activation log is available, then services will be shutdown in reverse chronological order as how they were started. If the activation log is not enabled or found to be empty then the deactivation will be in reverse order of RunLevel from the highest value down to the lowest value. If two services share the same RunLevel value then the ordering will be based upon the implementation's comparator.

      When shutdown returns, it is guaranteed that all services were shutdown, or failed to achieve shutdown.

      The shutdown timeout from InjectionServicesConfigBlueprint.shutdownTimeout() will be applied as the default.

      Returns:
      a map of all managed service types deactivated to results of deactivation, or empty if shutdown is not supported

    • activationLog

      Optional<ActivationLog> activationLog()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Optionally, the service provider activation log.
      Returns:
      the injector, or empty if not available

    • metrics

      Optional<Metrics> metrics()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Optionally, the metrics that are exposed by the provider implementation.
      Returns:
      the metrics, or empty if not available

    • lookups

      Optional<Set<ServiceInfoCriteria>> lookups()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Optionally, the set of Services lookup criteria that were recorded. This is only available if InjectionServicesConfigBlueprint.serviceLookupCaching() is enabled.
      Returns:
      the lookup criteria recorded, or empty if not available

    • createActivationRequestDefault

      static ActivationRequest createActivationRequestDefault()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Will create an activation request either to Phase.ACTIVE or limited to any BootstrapBlueprint.limitRuntimePhase() specified.
      Returns:
      the activation request

    • terminalActivationPhase

      static Phase terminalActivationPhase()
      Deprecated, for removal: This API element is subject to removal in a future version.
      The terminal phase for activation that we should not cross.
      Returns:
      the terminal phase for activation