Clarify requirements of the Contexts SPI interface

jakartaee · May 24, 2023 · 1fc78ac · 1fc78ac
1 parent 98ffc2f
commit 1fc78ac
Showing 1 changed file with 8 additions and 2 deletions.
diff --git a/api/src/main/java/org/jboss/cdi/tck/spi/Contexts.java b/api/src/main/java/org/jboss/cdi/tck/spi/Contexts.java
@@ -34,14 +34,20 @@ public interface Contexts<T extends Context> {
     public static final String PROPERTY_NAME = Contexts.class.getName();
 
     /**
-     * Sets the specified context as active
+     * Sets the specified context as active.
+     * <p>
+     * The set of existing contextual instances of the context is preserved
+     * across invocations of {@link #setActive(Context)} and {@link #setInactive(Context)}.
      *
      * @param context The context to set active
      */
     public void setActive(T context);
 
     /**
-     * Sets the specified context as inactive
+     * Sets the specified context as inactive.
+     * <p>
+     * The set of existing contextual instances of the context is preserved
+     * across invocations of {@link #setActive(Context)} and {@link #setInactive(Context)}.
      *
      * @param context The context to set inactive
      */