Adjust Handle.get() behavior - throw exception if attempting to get()…

… reference which was destroyed.
jakartaee · Nov 1, 2021 · 7ec75c2 · 7ec75c2
1 parent e53493f
commit 7ec75c2
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 1 deletion.
diff --git a/api/src/main/java/jakarta/enterprise/inject/Instance.java b/api/src/main/java/jakarta/enterprise/inject/Instance.java
@@ -281,6 +281,8 @@ interface Handle<T> extends AutoCloseable {
          * @return the contextual reference
          * @see Instance#get()
          * @throws IllegalStateException If the producing {@link Instance} does not exist
+         * @throws IllegalStateException If invoked on {@link Handle} that previously successfully destroyed its
+         * underlying contextual reference
          */
         T get();
 

diff --git a/spec/src/main/asciidoc/core/injectionandresolution.asciidoc b/spec/src/main/asciidoc/core/injectionandresolution.asciidoc
@@ -701,7 +701,8 @@ public interface Handle<T> extends AutoCloseable {
 }
 ----
 
-The `get()` method returns a contextual reference object. The contextual reference is resolved lazily.
+The `get()` method returns a contextual reference object. The contextual reference is resolved lazily. Throws
+`IllegalStateException` if invoked on `Handle` that previously successfully destroyed its underlying contextual reference.
 
 The `getBean()` method returns the `Bean` object representing metadata of the given contextual instance.