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 726651d97e Deploy documentation staging from
f77c8c512c309f11bb9dd53fa82f088f22a97726
f77c8c512c309f11bb9dd53fa82f088f22a97726
726651d97e is described below
commit 726651d97efef1c4ad965f44a81045ae3cce5513
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Sat Dec 13 15:13:17 2025 +0000
Deploy documentation staging from f77c8c512c309f11bb9dd53fa82f088f22a97726
f77c8c512c309f11bb9dd53fa82f088f22a97726
---
.../juneau/commons/collections/Flag_Test.html | 70 +++++++++++++++++++++-
.../apache/juneau/commons/collections/Flag.html | 49 ++++++++++++++-
2 files changed, 117 insertions(+), 2 deletions(-)
diff --git
a/site/xref-test/org/apache/juneau/commons/collections/Flag_Test.html
b/site/xref-test/org/apache/juneau/commons/collections/Flag_Test.html
index 85e2a10b44..0895c22354 100644
--- a/site/xref-test/org/apache/juneau/commons/collections/Flag_Test.html
+++ b/site/xref-test/org/apache/juneau/commons/collections/Flag_Test.html
@@ -247,7 +247,75 @@
<a class="jxr_linenumber" name="L239" href="#L239">239</a>
<a class="jxr_linenumber" name="L240" href="#L240">240</a>
assertEquals(2, d);
<a class="jxr_linenumber" name="L241" href="#L241">241</a> }
-<a class="jxr_linenumber" name="L242" href="#L242">242</a> }
+<a class="jxr_linenumber" name="L242" href="#L242">242</a>
+<a class="jxr_linenumber" name="L243" href="#L243">243</a> <em
class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L244" href="#L244">244</a> <em
class="jxr_comment">// toString(), equals(), hashCode()</em>
+<a class="jxr_linenumber" name="L245" href="#L245">245</a> <em
class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L246" href="#L246">246</a>
+<a class="jxr_linenumber" name="L247" href="#L247">247</a> @Test
+<a class="jxr_linenumber" name="L248" href="#L248">248</a> <strong
class="jxr_keyword">void</strong> d01_toString_<strong
class="jxr_keyword">true</strong>() {
+<a class="jxr_linenumber" name="L249" href="#L249">249</a> <strong
class="jxr_keyword">var</strong> flag = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L250" href="#L250">250</a>
assertEquals(<span class="jxr_string">"true"</span>, flag.toString());
+<a class="jxr_linenumber" name="L251" href="#L251">251</a> }
+<a class="jxr_linenumber" name="L252" href="#L252">252</a>
+<a class="jxr_linenumber" name="L253" href="#L253">253</a> @Test
+<a class="jxr_linenumber" name="L254" href="#L254">254</a> <strong
class="jxr_keyword">void</strong> d02_toString_false() {
+<a class="jxr_linenumber" name="L255" href="#L255">255</a> <strong
class="jxr_keyword">var</strong> flag = Flag.of(false);
+<a class="jxr_linenumber" name="L256" href="#L256">256</a>
assertEquals(<span class="jxr_string">"false"</span>, flag.toString());
+<a class="jxr_linenumber" name="L257" href="#L257">257</a> }
+<a class="jxr_linenumber" name="L258" href="#L258">258</a>
+<a class="jxr_linenumber" name="L259" href="#L259">259</a> @Test
+<a class="jxr_linenumber" name="L260" href="#L260">260</a> <strong
class="jxr_keyword">void</strong> d03_equals_sameValue() {
+<a class="jxr_linenumber" name="L261" href="#L261">261</a> <strong
class="jxr_keyword">var</strong> flag1 = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L262" href="#L262">262</a> <strong
class="jxr_keyword">var</strong> flag2 = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L263" href="#L263">263</a>
assertTrue(flag1.equals(flag2));
+<a class="jxr_linenumber" name="L264" href="#L264">264</a>
assertTrue(flag2.equals(flag1));
+<a class="jxr_linenumber" name="L265" href="#L265">265</a> }
+<a class="jxr_linenumber" name="L266" href="#L266">266</a>
+<a class="jxr_linenumber" name="L267" href="#L267">267</a> @Test
+<a class="jxr_linenumber" name="L268" href="#L268">268</a> <strong
class="jxr_keyword">void</strong> d04_equals_differentValue() {
+<a class="jxr_linenumber" name="L269" href="#L269">269</a> <strong
class="jxr_keyword">var</strong> flag1 = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L270" href="#L270">270</a> <strong
class="jxr_keyword">var</strong> flag2 = Flag.of(false);
+<a class="jxr_linenumber" name="L271" href="#L271">271</a>
assertFalse(flag1.equals(flag2));
+<a class="jxr_linenumber" name="L272" href="#L272">272</a>
assertFalse(flag2.equals(flag1));
+<a class="jxr_linenumber" name="L273" href="#L273">273</a> }
+<a class="jxr_linenumber" name="L274" href="#L274">274</a>
+<a class="jxr_linenumber" name="L275" href="#L275">275</a> @Test
+<a class="jxr_linenumber" name="L276" href="#L276">276</a> <strong
class="jxr_keyword">void</strong> d05_equals_sameInstance() {
+<a class="jxr_linenumber" name="L277" href="#L277">277</a> <strong
class="jxr_keyword">var</strong> flag = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L278" href="#L278">278</a>
assertTrue(flag.equals(flag));
+<a class="jxr_linenumber" name="L279" href="#L279">279</a> }
+<a class="jxr_linenumber" name="L280" href="#L280">280</a>
+<a class="jxr_linenumber" name="L281" href="#L281">281</a> @Test
+<a class="jxr_linenumber" name="L282" href="#L282">282</a> <strong
class="jxr_keyword">void</strong> d06_equals_notAFlag() {
+<a class="jxr_linenumber" name="L283" href="#L283">283</a> <strong
class="jxr_keyword">var</strong> flag = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L284" href="#L284">284</a>
assertFalse(flag.equals(<span class="jxr_string">"not a flag"</span>));
+<a class="jxr_linenumber" name="L285" href="#L285">285</a>
assertFalse(flag.equals(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L286" href="#L286">286</a> }
+<a class="jxr_linenumber" name="L287" href="#L287">287</a>
+<a class="jxr_linenumber" name="L288" href="#L288">288</a> @Test
+<a class="jxr_linenumber" name="L289" href="#L289">289</a> <strong
class="jxr_keyword">void</strong> d07_hashCode_sameValue() {
+<a class="jxr_linenumber" name="L290" href="#L290">290</a> <strong
class="jxr_keyword">var</strong> flag1 = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L291" href="#L291">291</a> <strong
class="jxr_keyword">var</strong> flag2 = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L292" href="#L292">292</a>
assertEquals(flag1.hashCode(), flag2.hashCode());
+<a class="jxr_linenumber" name="L293" href="#L293">293</a> }
+<a class="jxr_linenumber" name="L294" href="#L294">294</a>
+<a class="jxr_linenumber" name="L295" href="#L295">295</a> @Test
+<a class="jxr_linenumber" name="L296" href="#L296">296</a> <strong
class="jxr_keyword">void</strong> d08_hashCode_differentValue() {
+<a class="jxr_linenumber" name="L297" href="#L297">297</a> <strong
class="jxr_keyword">var</strong> flag1 = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L298" href="#L298">298</a> <strong
class="jxr_keyword">var</strong> flag2 = Flag.of(false);
+<a class="jxr_linenumber" name="L299" href="#L299">299</a> <em
class="jxr_comment">// Different values should have different hash codes
(though not guaranteed)</em>
+<a class="jxr_linenumber" name="L300" href="#L300">300</a>
assertNotEquals(flag1.hashCode(), flag2.hashCode());
+<a class="jxr_linenumber" name="L301" href="#L301">301</a> }
+<a class="jxr_linenumber" name="L302" href="#L302">302</a>
+<a class="jxr_linenumber" name="L303" href="#L303">303</a> @Test
+<a class="jxr_linenumber" name="L304" href="#L304">304</a> <strong
class="jxr_keyword">void</strong> d09_hashCode_booleanHashCode() {
+<a class="jxr_linenumber" name="L305" href="#L305">305</a> <strong
class="jxr_keyword">var</strong> flagTrue = Flag.of(<strong
class="jxr_keyword">true</strong>);
+<a class="jxr_linenumber" name="L306" href="#L306">306</a> <strong
class="jxr_keyword">var</strong> flagFalse = Flag.of(false);
+<a class="jxr_linenumber" name="L307" href="#L307">307</a>
assertEquals(Boolean.hashCode(<strong class="jxr_keyword">true</strong>),
flagTrue.hashCode());
+<a class="jxr_linenumber" name="L308" href="#L308">308</a>
assertEquals(Boolean.hashCode(false), flagFalse.hashCode());
+<a class="jxr_linenumber" name="L309" href="#L309">309</a> }
+<a class="jxr_linenumber" name="L310" href="#L310">310</a> }
</pre>
<hr/>
<div id="footer">© 2016–2025 <a href="https://www.apache.org/";>The Apache
Software Foundation</a></div>
diff --git a/site/xref/org/apache/juneau/commons/collections/Flag.html
b/site/xref/org/apache/juneau/commons/collections/Flag.html
index a76edf3480..e8cdf5f233 100644
--- a/site/xref/org/apache/juneau/commons/collections/Flag.html
+++ b/site/xref/org/apache/juneau/commons/collections/Flag.html
@@ -275,7 +275,54 @@
<a class="jxr_linenumber" name="L267" href="#L267">267</a> value =
false;
<a class="jxr_linenumber" name="L268" href="#L268">268</a> <strong
class="jxr_keyword">return</strong> <strong class="jxr_keyword">this</strong>;
<a class="jxr_linenumber" name="L269" href="#L269">269</a> }
-<a class="jxr_linenumber" name="L270" href="#L270">270</a> }
+<a class="jxr_linenumber" name="L270" href="#L270">270</a>
+<a class="jxr_linenumber" name="L271" href="#L271">271</a> <em
class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L272" href="#L272">272</a> <em
class="jxr_javadoccomment"> * Returns a string representation of this
flag.</em>
+<a class="jxr_linenumber" name="L273" href="#L273">273</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L274" href="#L274">274</a> <em
class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L275" href="#L275">275</a> <em
class="jxr_javadoccomment"> * The format is simply the string
representation of the boolean value.</em>
+<a class="jxr_linenumber" name="L276" href="#L276">276</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L277" href="#L277">277</a> <em
class="jxr_javadoccomment"> * @return A string representation of this
flag.</em>
+<a class="jxr_linenumber" name="L278" href="#L278">278</a> <em
class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L279" href="#L279">279</a> @Override
+<a class="jxr_linenumber" name="L280" href="#L280">280</a> <strong
class="jxr_keyword">public</strong> String toString() {
+<a class="jxr_linenumber" name="L281" href="#L281">281</a> <strong
class="jxr_keyword">return</strong> String.valueOf(value);
+<a class="jxr_linenumber" name="L282" href="#L282">282</a> }
+<a class="jxr_linenumber" name="L283" href="#L283">283</a>
+<a class="jxr_linenumber" name="L284" href="#L284">284</a> <em
class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L285" href="#L285">285</a> <em
class="jxr_javadoccomment"> * Compares the specified object with this flag
for equality.</em>
+<a class="jxr_linenumber" name="L286" href="#L286">286</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L287" href="#L287">287</a> <em
class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L288" href="#L288">288</a> <em
class="jxr_javadoccomment"> * Returns <jk>true</jk> if and
only if the specified object is also a <c>Flag</c> and both
flags</em>
+<a class="jxr_linenumber" name="L289" href="#L289">289</a> <em
class="jxr_javadoccomment"> * have the same boolean value.</em>
+<a class="jxr_linenumber" name="L290" href="#L290">290</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L291" href="#L291">291</a> <em
class="jxr_javadoccomment"> * @param o The object to be compared for
equality with this flag.</em>
+<a class="jxr_linenumber" name="L292" href="#L292">292</a> <em
class="jxr_javadoccomment"> * @return <jk>true</jk> if the
specified object is equal to this flag.</em>
+<a class="jxr_linenumber" name="L293" href="#L293">293</a> <em
class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L294" href="#L294">294</a> @Override
+<a class="jxr_linenumber" name="L295" href="#L295">295</a> <strong
class="jxr_keyword">public</strong> <strong
class="jxr_keyword">boolean</strong> equals(Object o) {
+<a class="jxr_linenumber" name="L296" href="#L296">296</a> <strong
class="jxr_keyword">return</strong> (o instanceof <a name="Flag"
href="../../../../../org/apache/juneau/commons/collections/Flag.html#Flag">Flag</a>
o2) && eq(<strong class="jxr_keyword">this</strong>, o2, (x, y) ->
x.value == y.value);
+<a class="jxr_linenumber" name="L297" href="#L297">297</a> }
+<a class="jxr_linenumber" name="L298" href="#L298">298</a>
+<a class="jxr_linenumber" name="L299" href="#L299">299</a> <em
class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L300" href="#L300">300</a> <em
class="jxr_javadoccomment"> * Returns the hash code value for this
flag.</em>
+<a class="jxr_linenumber" name="L301" href="#L301">301</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L302" href="#L302">302</a> <em
class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L303" href="#L303">303</a> <em
class="jxr_javadoccomment"> * The hash code is computed from the boolean
value using the standard <c>Boolean.hashCode(boolean)</c></em>
+<a class="jxr_linenumber" name="L304" href="#L304">304</a> <em
class="jxr_javadoccomment"> * method, which returns
<c>1231</c> for <c>true</c> and <c>1237</c>
for <c>false</c>.</em>
+<a class="jxr_linenumber" name="L305" href="#L305">305</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L306" href="#L306">306</a> <em
class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L307" href="#L307">307</a> <em
class="jxr_javadoccomment"> * This ensures that
<c>flag1.equals(flag2)</c> implies that
<c>flag1.hashCode()==flag2.hashCode()</c></em>
+<a class="jxr_linenumber" name="L308" href="#L308">308</a> <em
class="jxr_javadoccomment"> * for any two flags <c>flag1</c>
and <c>flag2</c>, as required by the general contract of</em>
+<a class="jxr_linenumber" name="L309" href="#L309">309</a> <em
class="jxr_javadoccomment"> * {@link Object#hashCode()}.</em>
+<a class="jxr_linenumber" name="L310" href="#L310">310</a> <em
class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L311" href="#L311">311</a> <em
class="jxr_javadoccomment"> * @return The hash code value for this
flag.</em>
+<a class="jxr_linenumber" name="L312" href="#L312">312</a> <em
class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L313" href="#L313">313</a> @Override
+<a class="jxr_linenumber" name="L314" href="#L314">314</a> <strong
class="jxr_keyword">public</strong> <strong class="jxr_keyword">int</strong>
hashCode() {
+<a class="jxr_linenumber" name="L315" href="#L315">315</a> <strong
class="jxr_keyword">return</strong> Boolean.hashCode(value);
+<a class="jxr_linenumber" name="L316" href="#L316">316</a> }
+<a class="jxr_linenumber" name="L317" href="#L317">317</a> }
</pre>
<hr/>
<div id="footer">© 2016–2025 <a href="https://www.apache.org/";>The Apache
Software Foundation</a></div>
