Introduce BeanContainer.getContexts() to be able to get hold of all context objects, even if inactive (#629)

Author: manovotn

api/src/main/java/jakarta/enterprise/inject/spi/BeanContainer.java

@@ -13,6 +13,7 @@
 
 import java.lang.annotation.Annotation;
 import java.lang.reflect.Type;
+import java.util.Collection;
 import java.util.List;
 import java.util.Set;
 
@@ -213,6 +214,15 @@ public interface BeanContainer {
      */
     Context getContext(Class<? extends Annotation> scopeType);
 
+    /**
+     * Obtains all {@linkplain Context context objects}, active and inactive, for the given
+     * {@linkplain jakarta.enterprise.context scope}.
+     *
+     * @param scopeType the {@linkplain jakarta.enterprise.context scope}; must not be {@code null}
+     * @return immutable collection of {@linkplain Context context objects}; never {@code null}, but may be empty
+     */
+    Collection<Context> getContexts(Class<? extends Annotation> scopeType);
+
     /**
      * Returns an instance of Event with specified type <code>java.lang.Object</code> and specified qualifier <code>@Default</code>
      * It allows typesafe synchronous or asynchronous event firing without injection of {@link Event} built-in bean requirement.