From 8f67fa84a7a8a1d464cdbda3757100f6d88902be Mon Sep 17 00:00:00 2001
From: Tagir Valeev <tagir.valeev@jetbrains.com>
Date: Thu, 3 Apr 2025 17:07:11 +0200
Subject: [PATCH] [java-annotations] IDEA-370354 Unmark
 `Class.getAnnotation(annoClass)` as Nullable

(cherry picked from commit 381d07d7dfdbc732dc651e27ac2d3b1f6e2e185e)

IJ-CR-159406

GitOrigin-RevId: e3897a8c401659c9c447136e66b28217960cf5cb
---
 java/jdkAnnotations/java/lang/annotations.xml |  8 +++----
 .../java/lang/reflect/annotations.xml         | 22 ++++++++++---------
 2 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/java/jdkAnnotations/java/lang/annotations.xml b/java/jdkAnnotations/java/lang/annotations.xml
index 8d8bfec3067a..dc553a1937db 100644
--- a/java/jdkAnnotations/java/lang/annotations.xml
+++ b/java/jdkAnnotations/java/lang/annotations.xml
@@ -146,7 +146,7 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.Class A getAnnotation(java.lang.Class&lt;A&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
@@ -155,7 +155,7 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.Class A getDeclaredAnnotation(java.lang.Class&lt;A&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
@@ -916,7 +916,7 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.Package A getAnnotation(java.lang.Class&lt;A&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
@@ -925,7 +925,7 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.Package A getDeclaredAnnotation(java.lang.Class&lt;A&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
diff --git a/java/jdkAnnotations/java/lang/reflect/annotations.xml b/java/jdkAnnotations/java/lang/reflect/annotations.xml
index 39d06d7f8e3a..538e902b0fb0 100644
--- a/java/jdkAnnotations/java/lang/reflect/annotations.xml
+++ b/java/jdkAnnotations/java/lang/reflect/annotations.xml
@@ -1,6 +1,6 @@
 <root>
   <item name='java.lang.reflect.AccessibleObject T getAnnotation(java.lang.Class&lt;T&gt;)'>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
@@ -9,7 +9,7 @@
     <annotation name='org.jetbrains.annotations.NotNull'/>
   </item>
   <item name='java.lang.reflect.AccessibleObject T getDeclaredAnnotation(java.lang.Class&lt;T&gt;)'>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.reflect.AccessibleObject T getDeclaredAnnotation(java.lang.Class&lt;T&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
@@ -61,13 +61,13 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
-      <annotation name='org.jetbrains.annotations.Nullable'/>
+      <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.reflect.AnnotatedElement T getAnnotation(java.lang.Class&lt;T&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
   </item>
   <item name='java.lang.reflect.AnnotatedElement T getDeclaredAnnotation(java.lang.Class&lt;T&gt;)'>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.reflect.AnnotatedElement T getDeclaredAnnotation(java.lang.Class&lt;T&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
@@ -130,6 +130,7 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.reflect.AnnotatedType T getAnnotation(java.lang.Class&lt;T&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
@@ -187,7 +188,7 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.reflect.Constructor T getAnnotation(java.lang.Class&lt;T&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
@@ -296,7 +297,7 @@
     <annotation name='org.jetbrains.annotations.NotNull' typePath="/[]"/>
   </item>
   <item name='java.lang.reflect.Executable T getAnnotation(java.lang.Class&lt;T&gt;)'>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
@@ -343,7 +344,7 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.reflect.Field T getAnnotation(java.lang.Class&lt;T&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
@@ -486,7 +487,7 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.reflect.Method T getAnnotation(java.lang.Class&lt;T&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
@@ -613,13 +614,13 @@
     <annotation name='org.jetbrains.annotations.NotNull' typePath="/[]"/>
   </item>
   <item name='java.lang.reflect.Parameter T getAnnotation(java.lang.Class&lt;T&gt;)'>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.reflect.Parameter T getAnnotation(java.lang.Class&lt;T&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>
   </item>
   <item name='java.lang.reflect.Parameter T getDeclaredAnnotation(java.lang.Class&lt;T&gt;)'>
-    <annotation name='org.jetbrains.annotations.Nullable'/>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
@@ -701,6 +702,7 @@
     <annotation name='org.jetbrains.annotations.Contract'>
       <val name="pure" val="true"/>
     </annotation>
+    <annotation name='org.jetbrains.annotations.UnknownNullability'/>
   </item>
   <item name='java.lang.reflect.RecordComponent T getAnnotation(java.lang.Class&lt;T&gt;) 0'>
     <annotation name='org.jetbrains.annotations.NotNull'/>