Package org.osgi.service.cdi.runtime

Interface CDIComponentRuntime

@ProviderType public interface CDIComponentRuntime
The CDIComponentRuntime service represents the actor that manages the CDI containers and their life cycle. The CDIComponentRuntime service allows introspection of the managed CDI containers.

This service must be registered with a Constants.SERVICE_CHANGECOUNT service property that must be updated each time any of the DTOs available from this service change.

Access to this service requires the ServicePermission[CDIComponentRuntime, GET] permission. It is intended that only administrative bundles should be granted this permission to limit access to the potentially intrusive methods provided by this service.

"ThreadSafe"

  • Method Details

    • getContainerDTOs

      Collection<ContainerDTO> getContainerDTOs(Bundle... bundles)
      Returns a collection of container description snapshots for a set of bundles.
      Parameters:
      bundles - The bundles who's container description snapshots are to be returned. Specifying no bundles, or the equivalent of an empty Bundle array, will return the container descriptions of all active bundles that define a container.
      Returns:
      A set of descriptions of the container of the specified bundles. Only bundles that have an associated container are included. If a bundle is listed multiple times in bundles only one ContainerDTO is returned. Returns an empty collection if no CDI containers are found.

    • getContainerTemplateDTO

      ContainerTemplateDTO getContainerTemplateDTO(Bundle bundle)
      Returns the ContainerTemplateDTO for the specified bundle
      Parameters:
      bundle - The bundle defining a container. Must not be null and must be active.
      Returns:
      The container template for of the specified bundle or null if it does not have an associated container.