This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/juneau.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new bbebcea8e6 Deploy documentation staging from
72471edbf78ac57feb4bb6558768ef423c4e4fc0
72471edbf78ac57feb4bb6558768ef423c4e4fc0
bbebcea8e6 is described below
commit bbebcea8e6da02f44f36e2f375a7c9599ed6aa45
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Mon Nov 17 16:15:14 2025 +0000
Deploy documentation staging from 72471edbf78ac57feb4bb6558768ef423c4e4fc0
72471edbf78ac57feb4bb6558768ef423c4e4fc0
---
.../juneau/common/reflect/AnnotationInfo.html | 120 +++++++++++++++------
1 file changed, 88 insertions(+), 32 deletions(-)
diff --git a/site/xref/org/apache/juneau/common/reflect/AnnotationInfo.html
b/site/xref/org/apache/juneau/common/reflect/AnnotationInfo.html
index 2e002de223..eff38868ea 100644
--- a/site/xref/org/apache/juneau/common/reflect/AnnotationInfo.html
+++ b/site/xref/org/apache/juneau/common/reflect/AnnotationInfo.html
@@ -538,41 +538,97 @@
<a class="jxr_linenumber" name="L530" href="#L530">530</a> }
<a class="jxr_linenumber" name="L531" href="#L531">531</a>
<a class="jxr_linenumber" name="L532" href="#L532">532</a> <em
class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L533" href="#L533">533</a> <em
class="jxr_javadoccomment"> * Returns the value of the specified method on
this annotation as a string array.</em>
+<a class="jxr_linenumber" name="L533" href="#L533">533</a> <em
class="jxr_javadoccomment"> * Returns the value of the specified method on
this annotation as a class of a specific type.</em>
<a class="jxr_linenumber" name="L534" href="#L534">534</a> <em
class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L535" href="#L535">535</a> <em
class="jxr_javadoccomment"> * @param methodName The method name.</em>
-<a class="jxr_linenumber" name="L536" href="#L536">536</a> <em
class="jxr_javadoccomment"> * @return An optional containing the value of
the specified method, or empty if not found or not a string array.</em>
-<a class="jxr_linenumber" name="L537" href="#L537">537</a> <em
class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L538" href="#L538">538</a> <strong
class="jxr_keyword">public</strong> Optional<String[]>
getStringArray(String methodName) {
-<a class="jxr_linenumber" name="L539" href="#L539">539</a> <strong
class="jxr_keyword">return</strong> getMethod(methodName).filter(x ->
x.hasReturnType(String[].<strong class="jxr_keyword">class</strong>)).map(x
-> (String[])x.invoke(a));
-<a class="jxr_linenumber" name="L540" href="#L540">540</a> }
-<a class="jxr_linenumber" name="L541" href="#L541">541</a>
-<a class="jxr_linenumber" name="L542" href="#L542">542</a> <em
class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L543" href="#L543">543</a> <em
class="jxr_javadoccomment"> * Returns the value of the specified method on
this annotation as a class array.</em>
-<a class="jxr_linenumber" name="L544" href="#L544">544</a> <em
class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L545" href="#L545">545</a> <em
class="jxr_javadoccomment"> * @param methodName The method name.</em>
-<a class="jxr_linenumber" name="L546" href="#L546">546</a> <em
class="jxr_javadoccomment"> * @return An optional containing the value of
the specified method, or empty if not found or not a class array.</em>
+<a class="jxr_linenumber" name="L535" href="#L535">535</a> <em
class="jxr_javadoccomment"> * <h5
class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L536" href="#L536">536</a> <em
class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L537" href="#L537">537</a> <em
class="jxr_javadoccomment"> * <jc>// Get a serializer class
from an annotation</jc></em>
+<a class="jxr_linenumber" name="L538" href="#L538">538</a> <em
class="jxr_javadoccomment"> * Optional&lt;Class&lt;?
<jk>extends</jk> Serializer&gt;&gt;
<jv>serializerClass</jv> = </em>
+<a class="jxr_linenumber" name="L539" href="#L539">539</a> <em
class="jxr_javadoccomment"> *
<jv>annotationInfo</jv>.getClassValue(<js>"serializer"</js>,
Serializer.<jk>class</jk>);</em>
+<a class="jxr_linenumber" name="L540" href="#L540">540</a> <em
class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L541" href="#L541">541</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L542" href="#L542">542</a> <em
class="jxr_javadoccomment"> * @param <T> The expected supertype of
the class.</em>
+<a class="jxr_linenumber" name="L543" href="#L543">543</a> <em
class="jxr_javadoccomment"> * @param methodName The method name.</em>
+<a class="jxr_linenumber" name="L544" href="#L544">544</a> <em
class="jxr_javadoccomment"> * @param type The expected supertype of the
class value.</em>
+<a class="jxr_linenumber" name="L545" href="#L545">545</a> <em
class="jxr_javadoccomment"> * @return An optional containing the value of
the specified method cast to the expected type, </em>
+<a class="jxr_linenumber" name="L546" href="#L546">546</a> <em
class="jxr_javadoccomment"> * or empty if not found, not a class,
or not assignable to the expected type.</em>
<a class="jxr_linenumber" name="L547" href="#L547">547</a> <em
class="jxr_javadoccomment"> */</em>
<a class="jxr_linenumber" name="L548" href="#L548">548</a>
@SuppressWarnings(<span class="jxr_string">"unchecked"</span>)
-<a class="jxr_linenumber" name="L549" href="#L549">549</a> <strong
class="jxr_keyword">public</strong> Optional<Class<?>[]>
getClassArray(String methodName) {
-<a class="jxr_linenumber" name="L550" href="#L550">550</a> <strong
class="jxr_keyword">return</strong>
(Optional<Class<?>[]>)(Optional<?>)getMethod(methodName).filter(x
-> x.hasReturnType(Class[].<strong
class="jxr_keyword">class</strong>)).map(x -> x.invoke(a));
-<a class="jxr_linenumber" name="L551" href="#L551">551</a> }
-<a class="jxr_linenumber" name="L552" href="#L552">552</a>
-<a class="jxr_linenumber" name="L553" href="#L553">553</a> <em
class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L554" href="#L554">554</a> <em
class="jxr_javadoccomment"> * Returns the return type of the specified
method on this annotation.</em>
-<a class="jxr_linenumber" name="L555" href="#L555">555</a> <em
class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L556" href="#L556">556</a> <em
class="jxr_javadoccomment"> * <h5
class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L557" href="#L557">557</a> <em
class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L558" href="#L558">558</a> <em
class="jxr_javadoccomment"> * Optional&lt;ClassInfo&gt;
<jv>returnType</jv> =
<jv>annotationInfo</jv>.getReturnType(<js>"value"</js>);</em>
-<a class="jxr_linenumber" name="L559" href="#L559">559</a> <em
class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L560" href="#L560">560</a> <em
class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L561" href="#L561">561</a> <em
class="jxr_javadoccomment"> * @param methodName The method name.</em>
-<a class="jxr_linenumber" name="L562" href="#L562">562</a> <em
class="jxr_javadoccomment"> * @return An optional containing the return
type of the specified method, or empty if method not found.</em>
-<a class="jxr_linenumber" name="L563" href="#L563">563</a> <em
class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L564" href="#L564">564</a> <strong
class="jxr_keyword">public</strong> Optional<ClassInfo>
getReturnType(String methodName) {
-<a class="jxr_linenumber" name="L565" href="#L565">565</a> <strong
class="jxr_keyword">return</strong> getMethod(methodName).map(x ->
x.getReturnType());
-<a class="jxr_linenumber" name="L566" href="#L566">566</a> }
-<a class="jxr_linenumber" name="L567" href="#L567">567</a> }
+<a class="jxr_linenumber" name="L549" href="#L549">549</a> <strong
class="jxr_keyword">public</strong> <T> Optional<Class<? <strong
class="jxr_keyword">extends</strong> T>> getClassValue(String methodName,
Class<T> type) {
+<a class="jxr_linenumber" name="L550" href="#L550">550</a> <strong
class="jxr_keyword">return</strong> getMethod(methodName)
+<a class="jxr_linenumber" name="L551" href="#L551">551</a>
.filter(x -> x.hasReturnType(Class.<strong
class="jxr_keyword">class</strong>))
+<a class="jxr_linenumber" name="L552" href="#L552">552</a>
.map(x -> (Class<?>)x.invoke(a))
+<a class="jxr_linenumber" name="L553" href="#L553">553</a>
.filter(type::isAssignableFrom)
+<a class="jxr_linenumber" name="L554" href="#L554">554</a>
.map(x -> (Class<? <strong class="jxr_keyword">extends</strong> T>)x);
+<a class="jxr_linenumber" name="L555" href="#L555">555</a> }
+<a class="jxr_linenumber" name="L556" href="#L556">556</a>
+<a class="jxr_linenumber" name="L557" href="#L557">557</a> <em
class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L558" href="#L558">558</a> <em
class="jxr_javadoccomment"> * Returns the value of the specified method on
this annotation as a string array.</em>
+<a class="jxr_linenumber" name="L559" href="#L559">559</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L560" href="#L560">560</a> <em
class="jxr_javadoccomment"> * @param methodName The method name.</em>
+<a class="jxr_linenumber" name="L561" href="#L561">561</a> <em
class="jxr_javadoccomment"> * @return An optional containing the value of
the specified method, or empty if not found or not a string array.</em>
+<a class="jxr_linenumber" name="L562" href="#L562">562</a> <em
class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L563" href="#L563">563</a> <strong
class="jxr_keyword">public</strong> Optional<String[]>
getStringArray(String methodName) {
+<a class="jxr_linenumber" name="L564" href="#L564">564</a> <strong
class="jxr_keyword">return</strong> getMethod(methodName).filter(x ->
x.hasReturnType(String[].<strong class="jxr_keyword">class</strong>)).map(x
-> (String[])x.invoke(a));
+<a class="jxr_linenumber" name="L565" href="#L565">565</a> }
+<a class="jxr_linenumber" name="L566" href="#L566">566</a>
+<a class="jxr_linenumber" name="L567" href="#L567">567</a> <em
class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L568" href="#L568">568</a> <em
class="jxr_javadoccomment"> * Returns the value of the specified method on
this annotation as a class array.</em>
+<a class="jxr_linenumber" name="L569" href="#L569">569</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L570" href="#L570">570</a> <em
class="jxr_javadoccomment"> * @param methodName The method name.</em>
+<a class="jxr_linenumber" name="L571" href="#L571">571</a> <em
class="jxr_javadoccomment"> * @return An optional containing the value of
the specified method, or empty if not found or not a class array.</em>
+<a class="jxr_linenumber" name="L572" href="#L572">572</a> <em
class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L573" href="#L573">573</a>
@SuppressWarnings(<span class="jxr_string">"unchecked"</span>)
+<a class="jxr_linenumber" name="L574" href="#L574">574</a> <strong
class="jxr_keyword">public</strong> Optional<Class<?>[]>
getClassArray(String methodName) {
+<a class="jxr_linenumber" name="L575" href="#L575">575</a> <strong
class="jxr_keyword">return</strong>
(Optional<Class<?>[]>)(Optional<?>)getMethod(methodName).filter(x
-> x.hasReturnType(Class[].<strong
class="jxr_keyword">class</strong>)).map(x -> x.invoke(a));
+<a class="jxr_linenumber" name="L576" href="#L576">576</a> }
+<a class="jxr_linenumber" name="L577" href="#L577">577</a>
+<a class="jxr_linenumber" name="L578" href="#L578">578</a> <em
class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L579" href="#L579">579</a> <em
class="jxr_javadoccomment"> * Returns the value of the specified method on
this annotation as a class array of a specific type.</em>
+<a class="jxr_linenumber" name="L580" href="#L580">580</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L581" href="#L581">581</a> <em
class="jxr_javadoccomment"> * <h5
class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L582" href="#L582">582</a> <em
class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L583" href="#L583">583</a> <em
class="jxr_javadoccomment"> * <jc>// Get an array of serializer
classes from an annotation</jc></em>
+<a class="jxr_linenumber" name="L584" href="#L584">584</a> <em
class="jxr_javadoccomment"> * Optional&lt;Class&lt;?
<jk>extends</jk> Serializer&gt;[]&gt;
<jv>serializerClasses</jv> = </em>
+<a class="jxr_linenumber" name="L585" href="#L585">585</a> <em
class="jxr_javadoccomment"> *
<jv>annotationInfo</jv>.getClassArray(<js>"serializers"</js>,
Serializer.<jk>class</jk>);</em>
+<a class="jxr_linenumber" name="L586" href="#L586">586</a> <em
class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L587" href="#L587">587</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L588" href="#L588">588</a> <em
class="jxr_javadoccomment"> * @param <T> The expected supertype of
the classes.</em>
+<a class="jxr_linenumber" name="L589" href="#L589">589</a> <em
class="jxr_javadoccomment"> * @param methodName The method name.</em>
+<a class="jxr_linenumber" name="L590" href="#L590">590</a> <em
class="jxr_javadoccomment"> * @param type The expected supertype of the
class values.</em>
+<a class="jxr_linenumber" name="L591" href="#L591">591</a> <em
class="jxr_javadoccomment"> * @return An optional containing the value of
the specified method cast to the expected type, </em>
+<a class="jxr_linenumber" name="L592" href="#L592">592</a> <em
class="jxr_javadoccomment"> * or empty if not found, not a class
array, or any element is not assignable to the expected type.</em>
+<a class="jxr_linenumber" name="L593" href="#L593">593</a> <em
class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L594" href="#L594">594</a>
@SuppressWarnings(<span class="jxr_string">"unchecked"</span>)
+<a class="jxr_linenumber" name="L595" href="#L595">595</a> <strong
class="jxr_keyword">public</strong> <T> Optional<Class<? <strong
class="jxr_keyword">extends</strong> T>[]> getClassArray(String
methodName, Class<T> type) {
+<a class="jxr_linenumber" name="L596" href="#L596">596</a> <strong
class="jxr_keyword">return</strong> getMethod(methodName)
+<a class="jxr_linenumber" name="L597" href="#L597">597</a>
.filter(x -> x.hasReturnType(Class[].<strong
class="jxr_keyword">class</strong>))
+<a class="jxr_linenumber" name="L598" href="#L598">598</a>
.map(x -> (Class<?>[])x.invoke(a))
+<a class="jxr_linenumber" name="L599" href="#L599">599</a>
.filter(arr -> {
+<a class="jxr_linenumber" name="L600" href="#L600">600</a>
<strong class="jxr_keyword">for</strong> (<strong
class="jxr_keyword">var</strong> c : arr) {
+<a class="jxr_linenumber" name="L601" href="#L601">601</a>
<strong class="jxr_keyword">if</strong>
(!type.isAssignableFrom(c))
+<a class="jxr_linenumber" name="L602" href="#L602">602</a>
<strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L603" href="#L603">603</a>
}
+<a class="jxr_linenumber" name="L604" href="#L604">604</a>
<strong class="jxr_keyword">return</strong> <strong
class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L605" href="#L605">605</a>
})
+<a class="jxr_linenumber" name="L606" href="#L606">606</a>
.map(x -> (Class<? <strong class="jxr_keyword">extends</strong>
T>[])x);
+<a class="jxr_linenumber" name="L607" href="#L607">607</a> }
+<a class="jxr_linenumber" name="L608" href="#L608">608</a>
+<a class="jxr_linenumber" name="L609" href="#L609">609</a> <em
class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L610" href="#L610">610</a> <em
class="jxr_javadoccomment"> * Returns the return type of the specified
method on this annotation.</em>
+<a class="jxr_linenumber" name="L611" href="#L611">611</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L612" href="#L612">612</a> <em
class="jxr_javadoccomment"> * <h5
class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L613" href="#L613">613</a> <em
class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L614" href="#L614">614</a> <em
class="jxr_javadoccomment"> * Optional&lt;ClassInfo&gt;
<jv>returnType</jv> =
<jv>annotationInfo</jv>.getReturnType(<js>"value"</js>);</em>
+<a class="jxr_linenumber" name="L615" href="#L615">615</a> <em
class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L616" href="#L616">616</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L617" href="#L617">617</a> <em
class="jxr_javadoccomment"> * @param methodName The method name.</em>
+<a class="jxr_linenumber" name="L618" href="#L618">618</a> <em
class="jxr_javadoccomment"> * @return An optional containing the return
type of the specified method, or empty if method not found.</em>
+<a class="jxr_linenumber" name="L619" href="#L619">619</a> <em
class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L620" href="#L620">620</a> <strong
class="jxr_keyword">public</strong> Optional<ClassInfo>
getReturnType(String methodName) {
+<a class="jxr_linenumber" name="L621" href="#L621">621</a> <strong
class="jxr_keyword">return</strong> getMethod(methodName).map(x ->
x.getReturnType());
+<a class="jxr_linenumber" name="L622" href="#L622">622</a> }
+<a class="jxr_linenumber" name="L623" href="#L623">623</a> }
</pre>
<hr/>
<div id="footer">© 2016–2025 <a href="https://www.apache.org/";>The Apache
Software Foundation</a></div>
