You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by gi...@apache.org on 2025/11/30 15:57:19 UTC
(juneau) branch asf-staging updated: Deploy documentation staging from a3c24376ac639a425d4195de29f88f544a2ff6b3 a3c24376ac639a425d4195de29f88f544a2ff6b3
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 b0f69565ad Deploy documentation staging from a3c24376ac639a425d4195de29f88f544a2ff6b3 a3c24376ac639a425d4195de29f88f544a2ff6b3
b0f69565ad is described below
commit b0f69565ad8c43a38c9784c186b92574c344cd66
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Sun Nov 30 15:57:13 2025 +0000
Deploy documentation staging from a3c24376ac639a425d4195de29f88f544a2ff6b3 a3c24376ac639a425d4195de29f88f544a2ff6b3
---
.../juneau/common/utils/StringUtils_Test.html | 566 +-
.../apache/juneau/common/utils/StringUtils.html | 6352 ++++++++++----------
.../xref/org/apache/juneau/common/utils/Utils.html | 1970 +++---
.../juneau/junit/bct/BasicBeanConverter.html | 218 +-
.../org/apache/juneau/junit/bct/BctAssertions.html | 2 +-
.../juneau/junit/bct/PropertyExtractors.html | 500 +-
site/xref/org/apache/juneau/rest/RestRequest.html | 2949 ++++-----
7 files changed, 6278 insertions(+), 6279 deletions(-)
diff --git a/site/xref-test/org/apache/juneau/common/utils/StringUtils_Test.html b/site/xref-test/org/apache/juneau/common/utils/StringUtils_Test.html
index d37f29ee73..3dcc89fd30 100644
--- a/site/xref-test/org/apache/juneau/common/utils/StringUtils_Test.html
+++ b/site/xref-test/org/apache/juneau/common/utils/StringUtils_Test.html
@@ -3108,18 +3108,18 @@
<a class="jxr_linenumber" name="L3100" href="#L3100">3100</a> <em class="jxr_comment">//====================================================================================================</em>
<a class="jxr_linenumber" name="L3101" href="#L3101">3101</a> @Test
<a class="jxr_linenumber" name="L3102" href="#L3102">3102</a> <strong class="jxr_keyword">void</strong> a77_lc() {
-<a class="jxr_linenumber" name="L3103" href="#L3103">3103</a> assertNull(lc(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L3104" href="#L3104">3104</a> assertEquals(<span class="jxr_string">""</span>, lc(<span class="jxr_string">""</span>));
-<a class="jxr_linenumber" name="L3105" href="#L3105">3105</a> assertEquals(<span class="jxr_string">"hello"</span>, lc(<span class="jxr_string">"HELLO"</span>));
-<a class="jxr_linenumber" name="L3106" href="#L3106">3106</a> assertEquals(<span class="jxr_string">"hello world"</span>, lc(<span class="jxr_string">"Hello World"</span>));
+<a class="jxr_linenumber" name="L3103" href="#L3103">3103</a> assertNull(lowerCase(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L3104" href="#L3104">3104</a> assertEquals(<span class="jxr_string">""</span>, lowerCase(<span class="jxr_string">""</span>));
+<a class="jxr_linenumber" name="L3105" href="#L3105">3105</a> assertEquals(<span class="jxr_string">"hello"</span>, lowerCase(<span class="jxr_string">"HELLO"</span>));
+<a class="jxr_linenumber" name="L3106" href="#L3106">3106</a> assertEquals(<span class="jxr_string">"hello world"</span>, lowerCase(<span class="jxr_string">"Hello World"</span>));
<a class="jxr_linenumber" name="L3107" href="#L3107">3107</a> }
<a class="jxr_linenumber" name="L3108" href="#L3108">3108</a>
<a class="jxr_linenumber" name="L3109" href="#L3109">3109</a> @Test
<a class="jxr_linenumber" name="L3110" href="#L3110">3110</a> <strong class="jxr_keyword">void</strong> a78_uc() {
-<a class="jxr_linenumber" name="L3111" href="#L3111">3111</a> assertNull(uc(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L3112" href="#L3112">3112</a> assertEquals(<span class="jxr_string">""</span>, uc(<span class="jxr_string">""</span>));
-<a class="jxr_linenumber" name="L3113" href="#L3113">3113</a> assertEquals(<span class="jxr_string">"HELLO"</span>, uc(<span class="jxr_string">"hello"</span>));
-<a class="jxr_linenumber" name="L3114" href="#L3114">3114</a> assertEquals(<span class="jxr_string">"HELLO WORLD"</span>, uc(<span class="jxr_string">"Hello World"</span>));
+<a class="jxr_linenumber" name="L3111" href="#L3111">3111</a> assertNull(upperCase(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L3112" href="#L3112">3112</a> assertEquals(<span class="jxr_string">""</span>, upperCase(<span class="jxr_string">""</span>));
+<a class="jxr_linenumber" name="L3113" href="#L3113">3113</a> assertEquals(<span class="jxr_string">"HELLO"</span>, upperCase(<span class="jxr_string">"hello"</span>));
+<a class="jxr_linenumber" name="L3114" href="#L3114">3114</a> assertEquals(<span class="jxr_string">"HELLO WORLD"</span>, upperCase(<span class="jxr_string">"Hello World"</span>));
<a class="jxr_linenumber" name="L3115" href="#L3115">3115</a> }
<a class="jxr_linenumber" name="L3116" href="#L3116">3116</a>
<a class="jxr_linenumber" name="L3117" href="#L3117">3117</a> <em class="jxr_comment">//====================================================================================================</em>
@@ -3582,275 +3582,301 @@
<a class="jxr_linenumber" name="L3574" href="#L3574">3574</a> appendIfNotEmpty(sb2, <span class="jxr_string">"suffix"</span>);
<a class="jxr_linenumber" name="L3575" href="#L3575">3575</a> assertEquals(<span class="jxr_string">"prefixsuffix"</span>, sb2.toString());
<a class="jxr_linenumber" name="L3576" href="#L3576">3576</a>
-<a class="jxr_linenumber" name="L3577" href="#L3577">3577</a> assertThrows(IllegalArgumentException.<strong class="jxr_keyword">class</strong>, () -> appendIfNotEmpty(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">"test"</span>));
-<a class="jxr_linenumber" name="L3578" href="#L3578">3578</a> }
-<a class="jxr_linenumber" name="L3579" href="#L3579">3579</a>
-<a class="jxr_linenumber" name="L3580" href="#L3580">3580</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3581" href="#L3581">3581</a> <em class="jxr_comment">// appendIfNotBlank(StringBuilder, String)</em>
-<a class="jxr_linenumber" name="L3582" href="#L3582">3582</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3583" href="#L3583">3583</a> @Test
-<a class="jxr_linenumber" name="L3584" href="#L3584">3584</a> <strong class="jxr_keyword">void</strong> a111_appendIfNotBlank() {
-<a class="jxr_linenumber" name="L3585" href="#L3585">3585</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L3586" href="#L3586">3586</a> assertSame(sb, appendIfNotBlank(sb, <span class="jxr_string">"hello"</span>));
-<a class="jxr_linenumber" name="L3587" href="#L3587">3587</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
-<a class="jxr_linenumber" name="L3588" href="#L3588">3588</a>
-<a class="jxr_linenumber" name="L3589" href="#L3589">3589</a> appendIfNotBlank(sb, <span class="jxr_string">" "</span>);
-<a class="jxr_linenumber" name="L3590" href="#L3590">3590</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
-<a class="jxr_linenumber" name="L3591" href="#L3591">3591</a>
-<a class="jxr_linenumber" name="L3592" href="#L3592">3592</a> appendIfNotBlank(sb, <span class="jxr_string">"\t\n"</span>);
-<a class="jxr_linenumber" name="L3593" href="#L3593">3593</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
-<a class="jxr_linenumber" name="L3594" href="#L3594">3594</a>
-<a class="jxr_linenumber" name="L3595" href="#L3595">3595</a> appendIfNotBlank(sb, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L3596" href="#L3596">3596</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
-<a class="jxr_linenumber" name="L3597" href="#L3597">3597</a>
-<a class="jxr_linenumber" name="L3598" href="#L3598">3598</a> appendIfNotBlank(sb, <strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L3599" href="#L3599">3599</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
-<a class="jxr_linenumber" name="L3600" href="#L3600">3600</a>
-<a class="jxr_linenumber" name="L3601" href="#L3601">3601</a> appendIfNotBlank(sb, <span class="jxr_string">"world"</span>);
-<a class="jxr_linenumber" name="L3602" href="#L3602">3602</a> assertEquals(<span class="jxr_string">"helloworld"</span>, sb.toString());
-<a class="jxr_linenumber" name="L3603" href="#L3603">3603</a>
-<a class="jxr_linenumber" name="L3604" href="#L3604">3604</a> <strong class="jxr_keyword">var</strong> sb2 = <strong class="jxr_keyword">new</strong> StringBuilder(<span class="jxr_string">"prefix"</span>);
-<a class="jxr_linenumber" name="L3605" href="#L3605">3605</a> appendIfNotBlank(sb2, <span class="jxr_string">"suffix"</span>);
-<a class="jxr_linenumber" name="L3606" href="#L3606">3606</a> assertEquals(<span class="jxr_string">"prefixsuffix"</span>, sb2.toString());
+<a class="jxr_linenumber" name="L3577" href="#L3577">3577</a> <em class="jxr_comment">// Auto-create StringBuilder if null and append occurs</em>
+<a class="jxr_linenumber" name="L3578" href="#L3578">3578</a> <strong class="jxr_keyword">var</strong> sb3 = appendIfNotEmpty(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">"test"</span>);
+<a class="jxr_linenumber" name="L3579" href="#L3579">3579</a> assertNotNull(sb3);
+<a class="jxr_linenumber" name="L3580" href="#L3580">3580</a> assertEquals(<span class="jxr_string">"test"</span>, sb3.toString());
+<a class="jxr_linenumber" name="L3581" href="#L3581">3581</a>
+<a class="jxr_linenumber" name="L3582" href="#L3582">3582</a> <em class="jxr_comment">// Return null if null and no append occurs</em>
+<a class="jxr_linenumber" name="L3583" href="#L3583">3583</a> assertNull(appendIfNotEmpty(<strong class="jxr_keyword">null</strong>, <strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L3584" href="#L3584">3584</a> assertNull(appendIfNotEmpty(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">""</span>));
+<a class="jxr_linenumber" name="L3585" href="#L3585">3585</a> }
+<a class="jxr_linenumber" name="L3586" href="#L3586">3586</a>
+<a class="jxr_linenumber" name="L3587" href="#L3587">3587</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3588" href="#L3588">3588</a> <em class="jxr_comment">// appendIfNotBlank(StringBuilder, String)</em>
+<a class="jxr_linenumber" name="L3589" href="#L3589">3589</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3590" href="#L3590">3590</a> @Test
+<a class="jxr_linenumber" name="L3591" href="#L3591">3591</a> <strong class="jxr_keyword">void</strong> a111_appendIfNotBlank() {
+<a class="jxr_linenumber" name="L3592" href="#L3592">3592</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L3593" href="#L3593">3593</a> assertSame(sb, appendIfNotBlank(sb, <span class="jxr_string">"hello"</span>));
+<a class="jxr_linenumber" name="L3594" href="#L3594">3594</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
+<a class="jxr_linenumber" name="L3595" href="#L3595">3595</a>
+<a class="jxr_linenumber" name="L3596" href="#L3596">3596</a> appendIfNotBlank(sb, <span class="jxr_string">" "</span>);
+<a class="jxr_linenumber" name="L3597" href="#L3597">3597</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
+<a class="jxr_linenumber" name="L3598" href="#L3598">3598</a>
+<a class="jxr_linenumber" name="L3599" href="#L3599">3599</a> appendIfNotBlank(sb, <span class="jxr_string">"\t\n"</span>);
+<a class="jxr_linenumber" name="L3600" href="#L3600">3600</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
+<a class="jxr_linenumber" name="L3601" href="#L3601">3601</a>
+<a class="jxr_linenumber" name="L3602" href="#L3602">3602</a> appendIfNotBlank(sb, <span class="jxr_string">""</span>);
+<a class="jxr_linenumber" name="L3603" href="#L3603">3603</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
+<a class="jxr_linenumber" name="L3604" href="#L3604">3604</a>
+<a class="jxr_linenumber" name="L3605" href="#L3605">3605</a> appendIfNotBlank(sb, <strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L3606" href="#L3606">3606</a> assertEquals(<span class="jxr_string">"hello"</span>, sb.toString());
<a class="jxr_linenumber" name="L3607" href="#L3607">3607</a>
-<a class="jxr_linenumber" name="L3608" href="#L3608">3608</a> assertThrows(IllegalArgumentException.<strong class="jxr_keyword">class</strong>, () -> appendIfNotBlank(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">"test"</span>));
-<a class="jxr_linenumber" name="L3609" href="#L3609">3609</a> }
+<a class="jxr_linenumber" name="L3608" href="#L3608">3608</a> appendIfNotBlank(sb, <span class="jxr_string">"world"</span>);
+<a class="jxr_linenumber" name="L3609" href="#L3609">3609</a> assertEquals(<span class="jxr_string">"helloworld"</span>, sb.toString());
<a class="jxr_linenumber" name="L3610" href="#L3610">3610</a>
-<a class="jxr_linenumber" name="L3611" href="#L3611">3611</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3612" href="#L3612">3612</a> <em class="jxr_comment">// appendWithSeparator(StringBuilder, String, String)</em>
-<a class="jxr_linenumber" name="L3613" href="#L3613">3613</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3614" href="#L3614">3614</a> @Test
-<a class="jxr_linenumber" name="L3615" href="#L3615">3615</a> <strong class="jxr_keyword">void</strong> a112_appendWithSeparator() {
-<a class="jxr_linenumber" name="L3616" href="#L3616">3616</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L3617" href="#L3617">3617</a> assertSame(sb, appendWithSeparator(sb, <span class="jxr_string">"first"</span>, <span class="jxr_string">", "</span>));
-<a class="jxr_linenumber" name="L3618" href="#L3618">3618</a> assertEquals(<span class="jxr_string">"first"</span>, sb.toString());
+<a class="jxr_linenumber" name="L3611" href="#L3611">3611</a> <strong class="jxr_keyword">var</strong> sb2 = <strong class="jxr_keyword">new</strong> StringBuilder(<span class="jxr_string">"prefix"</span>);
+<a class="jxr_linenumber" name="L3612" href="#L3612">3612</a> appendIfNotBlank(sb2, <span class="jxr_string">"suffix"</span>);
+<a class="jxr_linenumber" name="L3613" href="#L3613">3613</a> assertEquals(<span class="jxr_string">"prefixsuffix"</span>, sb2.toString());
+<a class="jxr_linenumber" name="L3614" href="#L3614">3614</a>
+<a class="jxr_linenumber" name="L3615" href="#L3615">3615</a> <em class="jxr_comment">// Auto-create StringBuilder if null and append occurs</em>
+<a class="jxr_linenumber" name="L3616" href="#L3616">3616</a> <strong class="jxr_keyword">var</strong> sb3 = appendIfNotBlank(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">"test"</span>);
+<a class="jxr_linenumber" name="L3617" href="#L3617">3617</a> assertNotNull(sb3);
+<a class="jxr_linenumber" name="L3618" href="#L3618">3618</a> assertEquals(<span class="jxr_string">"test"</span>, sb3.toString());
<a class="jxr_linenumber" name="L3619" href="#L3619">3619</a>
-<a class="jxr_linenumber" name="L3620" href="#L3620">3620</a> appendWithSeparator(sb, <span class="jxr_string">"second"</span>, <span class="jxr_string">", "</span>);
-<a class="jxr_linenumber" name="L3621" href="#L3621">3621</a> assertEquals(<span class="jxr_string">"first, second"</span>, sb.toString());
-<a class="jxr_linenumber" name="L3622" href="#L3622">3622</a>
-<a class="jxr_linenumber" name="L3623" href="#L3623">3623</a> appendWithSeparator(sb, <span class="jxr_string">"third"</span>, <span class="jxr_string">", "</span>);
-<a class="jxr_linenumber" name="L3624" href="#L3624">3624</a> assertEquals(<span class="jxr_string">"first, second, third"</span>, sb.toString());
-<a class="jxr_linenumber" name="L3625" href="#L3625">3625</a>
-<a class="jxr_linenumber" name="L3626" href="#L3626">3626</a> <strong class="jxr_keyword">var</strong> sb2 = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L3627" href="#L3627">3627</a> appendWithSeparator(sb2, <span class="jxr_string">"a"</span>, <span class="jxr_string">"-"</span>);
-<a class="jxr_linenumber" name="L3628" href="#L3628">3628</a> appendWithSeparator(sb2, <span class="jxr_string">"b"</span>, <span class="jxr_string">"-"</span>);
-<a class="jxr_linenumber" name="L3629" href="#L3629">3629</a> appendWithSeparator(sb2, <span class="jxr_string">"c"</span>, <span class="jxr_string">"-"</span>);
-<a class="jxr_linenumber" name="L3630" href="#L3630">3630</a> assertEquals(<span class="jxr_string">"a-b-c"</span>, sb2.toString());
-<a class="jxr_linenumber" name="L3631" href="#L3631">3631</a>
-<a class="jxr_linenumber" name="L3632" href="#L3632">3632</a> <strong class="jxr_keyword">var</strong> sb3 = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L3633" href="#L3633">3633</a> appendWithSeparator(sb3, <span class="jxr_string">"x"</span>, <strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L3634" href="#L3634">3634</a> assertEquals(<span class="jxr_string">"x"</span>, sb3.toString());
-<a class="jxr_linenumber" name="L3635" href="#L3635">3635</a> appendWithSeparator(sb3, <span class="jxr_string">"y"</span>, <strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L3636" href="#L3636">3636</a> assertEquals(<span class="jxr_string">"xy"</span>, sb3.toString());
-<a class="jxr_linenumber" name="L3637" href="#L3637">3637</a>
-<a class="jxr_linenumber" name="L3638" href="#L3638">3638</a> <strong class="jxr_keyword">var</strong> sb4 = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L3639" href="#L3639">3639</a> appendWithSeparator(sb4, <strong class="jxr_keyword">null</strong>, <span class="jxr_string">", "</span>);
-<a class="jxr_linenumber" name="L3640" href="#L3640">3640</a> assertEquals(<span class="jxr_string">""</span>, sb4.toString());
-<a class="jxr_linenumber" name="L3641" href="#L3641">3641</a> appendWithSeparator(sb4, <span class="jxr_string">"test"</span>, <span class="jxr_string">", "</span>);
-<a class="jxr_linenumber" name="L3642" href="#L3642">3642</a> assertEquals(<span class="jxr_string">"test"</span>, sb4.toString());
-<a class="jxr_linenumber" name="L3643" href="#L3643">3643</a>
-<a class="jxr_linenumber" name="L3644" href="#L3644">3644</a> assertThrows(IllegalArgumentException.<strong class="jxr_keyword">class</strong>, () -> appendWithSeparator(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">"test"</span>, <span class="jxr_string">", "</span>));
-<a class="jxr_linenumber" name="L3645" href="#L3645">3645</a> }
-<a class="jxr_linenumber" name="L3646" href="#L3646">3646</a>
-<a class="jxr_linenumber" name="L3647" href="#L3647">3647</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3648" href="#L3648">3648</a> <em class="jxr_comment">// buildString(Consumer<StringBuilder>)</em>
-<a class="jxr_linenumber" name="L3649" href="#L3649">3649</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3650" href="#L3650">3650</a> @Test
-<a class="jxr_linenumber" name="L3651" href="#L3651">3651</a> <strong class="jxr_keyword">void</strong> a113_buildString() {
-<a class="jxr_linenumber" name="L3652" href="#L3652">3652</a> <strong class="jxr_keyword">var</strong> result = buildString(sb -> {
-<a class="jxr_linenumber" name="L3653" href="#L3653">3653</a> sb.append(<span class="jxr_string">"Hello"</span>);
-<a class="jxr_linenumber" name="L3654" href="#L3654">3654</a> sb.append(<span class="jxr_string">" "</span>);
-<a class="jxr_linenumber" name="L3655" href="#L3655">3655</a> sb.append(<span class="jxr_string">"World"</span>);
-<a class="jxr_linenumber" name="L3656" href="#L3656">3656</a> });
-<a class="jxr_linenumber" name="L3657" href="#L3657">3657</a> assertEquals(<span class="jxr_string">"Hello World"</span>, result);
-<a class="jxr_linenumber" name="L3658" href="#L3658">3658</a>
-<a class="jxr_linenumber" name="L3659" href="#L3659">3659</a> <strong class="jxr_keyword">var</strong> joined = buildString(sb -> {
-<a class="jxr_linenumber" name="L3660" href="#L3660">3660</a> appendWithSeparator(sb, <span class="jxr_string">"a"</span>, <span class="jxr_string">", "</span>);
-<a class="jxr_linenumber" name="L3661" href="#L3661">3661</a> appendWithSeparator(sb, <span class="jxr_string">"b"</span>, <span class="jxr_string">", "</span>);
-<a class="jxr_linenumber" name="L3662" href="#L3662">3662</a> appendWithSeparator(sb, <span class="jxr_string">"c"</span>, <span class="jxr_string">", "</span>);
-<a class="jxr_linenumber" name="L3663" href="#L3663">3663</a> });
-<a class="jxr_linenumber" name="L3664" href="#L3664">3664</a> assertEquals(<span class="jxr_string">"a, b, c"</span>, joined);
-<a class="jxr_linenumber" name="L3665" href="#L3665">3665</a>
-<a class="jxr_linenumber" name="L3666" href="#L3666">3666</a> <strong class="jxr_keyword">var</strong> empty = buildString(sb -> {
-<a class="jxr_linenumber" name="L3667" href="#L3667">3667</a> <em class="jxr_comment">// Do nothing</em>
-<a class="jxr_linenumber" name="L3668" href="#L3668">3668</a> });
-<a class="jxr_linenumber" name="L3669" href="#L3669">3669</a> assertEquals(<span class="jxr_string">""</span>, empty);
-<a class="jxr_linenumber" name="L3670" href="#L3670">3670</a>
-<a class="jxr_linenumber" name="L3671" href="#L3671">3671</a> <strong class="jxr_keyword">var</strong> complex = buildString(sb -> {
-<a class="jxr_linenumber" name="L3672" href="#L3672">3672</a> appendIfNotEmpty(sb, <span class="jxr_string">"prefix"</span>);
-<a class="jxr_linenumber" name="L3673" href="#L3673">3673</a> appendWithSeparator(sb, <span class="jxr_string">"middle"</span>, <span class="jxr_string">"-"</span>);
-<a class="jxr_linenumber" name="L3674" href="#L3674">3674</a> appendWithSeparator(sb, <span class="jxr_string">"suffix"</span>, <span class="jxr_string">"-"</span>);
-<a class="jxr_linenumber" name="L3675" href="#L3675">3675</a> });
-<a class="jxr_linenumber" name="L3676" href="#L3676">3676</a> assertEquals(<span class="jxr_string">"prefix-middle-suffix"</span>, complex);
-<a class="jxr_linenumber" name="L3677" href="#L3677">3677</a>
-<a class="jxr_linenumber" name="L3678" href="#L3678">3678</a> assertThrows(IllegalArgumentException.<strong class="jxr_keyword">class</strong>, () -> buildString(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L3679" href="#L3679">3679</a> }
-<a class="jxr_linenumber" name="L3680" href="#L3680">3680</a>
-<a class="jxr_linenumber" name="L3681" href="#L3681">3681</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3682" href="#L3682">3682</a> <em class="jxr_comment">// String Constants and Utilities</em>
-<a class="jxr_linenumber" name="L3683" href="#L3683">3683</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3620" href="#L3620">3620</a> <em class="jxr_comment">// Return null if null and no append occurs</em>
+<a class="jxr_linenumber" name="L3621" href="#L3621">3621</a> assertNull(appendIfNotBlank(<strong class="jxr_keyword">null</strong>, <strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L3622" href="#L3622">3622</a> assertNull(appendIfNotBlank(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">""</span>));
+<a class="jxr_linenumber" name="L3623" href="#L3623">3623</a> assertNull(appendIfNotBlank(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">" "</span>));
+<a class="jxr_linenumber" name="L3624" href="#L3624">3624</a> assertNull(appendIfNotBlank(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">"\t\n"</span>));
+<a class="jxr_linenumber" name="L3625" href="#L3625">3625</a> }
+<a class="jxr_linenumber" name="L3626" href="#L3626">3626</a>
+<a class="jxr_linenumber" name="L3627" href="#L3627">3627</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3628" href="#L3628">3628</a> <em class="jxr_comment">// appendWithSeparator(StringBuilder, String, String)</em>
+<a class="jxr_linenumber" name="L3629" href="#L3629">3629</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3630" href="#L3630">3630</a> @Test
+<a class="jxr_linenumber" name="L3631" href="#L3631">3631</a> <strong class="jxr_keyword">void</strong> a112_appendWithSeparator() {
+<a class="jxr_linenumber" name="L3632" href="#L3632">3632</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L3633" href="#L3633">3633</a> assertSame(sb, appendWithSeparator(sb, <span class="jxr_string">"first"</span>, <span class="jxr_string">", "</span>));
+<a class="jxr_linenumber" name="L3634" href="#L3634">3634</a> assertEquals(<span class="jxr_string">"first"</span>, sb.toString());
+<a class="jxr_linenumber" name="L3635" href="#L3635">3635</a>
+<a class="jxr_linenumber" name="L3636" href="#L3636">3636</a> appendWithSeparator(sb, <span class="jxr_string">"second"</span>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3637" href="#L3637">3637</a> assertEquals(<span class="jxr_string">"first, second"</span>, sb.toString());
+<a class="jxr_linenumber" name="L3638" href="#L3638">3638</a>
+<a class="jxr_linenumber" name="L3639" href="#L3639">3639</a> appendWithSeparator(sb, <span class="jxr_string">"third"</span>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3640" href="#L3640">3640</a> assertEquals(<span class="jxr_string">"first, second, third"</span>, sb.toString());
+<a class="jxr_linenumber" name="L3641" href="#L3641">3641</a>
+<a class="jxr_linenumber" name="L3642" href="#L3642">3642</a> <strong class="jxr_keyword">var</strong> sb2 = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L3643" href="#L3643">3643</a> appendWithSeparator(sb2, <span class="jxr_string">"a"</span>, <span class="jxr_string">"-"</span>);
+<a class="jxr_linenumber" name="L3644" href="#L3644">3644</a> appendWithSeparator(sb2, <span class="jxr_string">"b"</span>, <span class="jxr_string">"-"</span>);
+<a class="jxr_linenumber" name="L3645" href="#L3645">3645</a> appendWithSeparator(sb2, <span class="jxr_string">"c"</span>, <span class="jxr_string">"-"</span>);
+<a class="jxr_linenumber" name="L3646" href="#L3646">3646</a> assertEquals(<span class="jxr_string">"a-b-c"</span>, sb2.toString());
+<a class="jxr_linenumber" name="L3647" href="#L3647">3647</a>
+<a class="jxr_linenumber" name="L3648" href="#L3648">3648</a> <strong class="jxr_keyword">var</strong> sb3 = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L3649" href="#L3649">3649</a> appendWithSeparator(sb3, <span class="jxr_string">"x"</span>, <strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L3650" href="#L3650">3650</a> assertEquals(<span class="jxr_string">"x"</span>, sb3.toString());
+<a class="jxr_linenumber" name="L3651" href="#L3651">3651</a> appendWithSeparator(sb3, <span class="jxr_string">"y"</span>, <strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L3652" href="#L3652">3652</a> assertEquals(<span class="jxr_string">"xy"</span>, sb3.toString());
+<a class="jxr_linenumber" name="L3653" href="#L3653">3653</a>
+<a class="jxr_linenumber" name="L3654" href="#L3654">3654</a> <strong class="jxr_keyword">var</strong> sb4 = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L3655" href="#L3655">3655</a> appendWithSeparator(sb4, <strong class="jxr_keyword">null</strong>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3656" href="#L3656">3656</a> assertEquals(<span class="jxr_string">""</span>, sb4.toString());
+<a class="jxr_linenumber" name="L3657" href="#L3657">3657</a> appendWithSeparator(sb4, <span class="jxr_string">"test"</span>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3658" href="#L3658">3658</a> assertEquals(<span class="jxr_string">"test"</span>, sb4.toString());
+<a class="jxr_linenumber" name="L3659" href="#L3659">3659</a>
+<a class="jxr_linenumber" name="L3660" href="#L3660">3660</a> <em class="jxr_comment">// Auto-create StringBuilder if null and append occurs</em>
+<a class="jxr_linenumber" name="L3661" href="#L3661">3661</a> <strong class="jxr_keyword">var</strong> sb5 = appendWithSeparator(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">"test"</span>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3662" href="#L3662">3662</a> assertNotNull(sb5);
+<a class="jxr_linenumber" name="L3663" href="#L3663">3663</a> assertEquals(<span class="jxr_string">"test"</span>, sb5.toString());
+<a class="jxr_linenumber" name="L3664" href="#L3664">3664</a>
+<a class="jxr_linenumber" name="L3665" href="#L3665">3665</a> <strong class="jxr_keyword">var</strong> sb6 = appendWithSeparator(<strong class="jxr_keyword">null</strong>, <span class="jxr_string">"first"</span>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3666" href="#L3666">3666</a> appendWithSeparator(sb6, <span class="jxr_string">"second"</span>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3667" href="#L3667">3667</a> assertEquals(<span class="jxr_string">"first, second"</span>, sb6.toString());
+<a class="jxr_linenumber" name="L3668" href="#L3668">3668</a>
+<a class="jxr_linenumber" name="L3669" href="#L3669">3669</a> <em class="jxr_comment">// Return null if null and no append occurs</em>
+<a class="jxr_linenumber" name="L3670" href="#L3670">3670</a> assertNull(appendWithSeparator(<strong class="jxr_keyword">null</strong>, <strong class="jxr_keyword">null</strong>, <span class="jxr_string">", "</span>));
+<a class="jxr_linenumber" name="L3671" href="#L3671">3671</a> }
+<a class="jxr_linenumber" name="L3672" href="#L3672">3672</a>
+<a class="jxr_linenumber" name="L3673" href="#L3673">3673</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3674" href="#L3674">3674</a> <em class="jxr_comment">// buildString(Consumer<StringBuilder>)</em>
+<a class="jxr_linenumber" name="L3675" href="#L3675">3675</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3676" href="#L3676">3676</a> @Test
+<a class="jxr_linenumber" name="L3677" href="#L3677">3677</a> <strong class="jxr_keyword">void</strong> a113_buildString() {
+<a class="jxr_linenumber" name="L3678" href="#L3678">3678</a> <strong class="jxr_keyword">var</strong> result = buildString(sb -> {
+<a class="jxr_linenumber" name="L3679" href="#L3679">3679</a> sb.append(<span class="jxr_string">"Hello"</span>);
+<a class="jxr_linenumber" name="L3680" href="#L3680">3680</a> sb.append(<span class="jxr_string">" "</span>);
+<a class="jxr_linenumber" name="L3681" href="#L3681">3681</a> sb.append(<span class="jxr_string">"World"</span>);
+<a class="jxr_linenumber" name="L3682" href="#L3682">3682</a> });
+<a class="jxr_linenumber" name="L3683" href="#L3683">3683</a> assertEquals(<span class="jxr_string">"Hello World"</span>, result);
<a class="jxr_linenumber" name="L3684" href="#L3684">3684</a>
-<a class="jxr_linenumber" name="L3685" href="#L3685">3685</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3686" href="#L3686">3686</a> <em class="jxr_comment">// String Constants</em>
-<a class="jxr_linenumber" name="L3687" href="#L3687">3687</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3688" href="#L3688">3688</a> @Test
-<a class="jxr_linenumber" name="L3689" href="#L3689">3689</a> <strong class="jxr_keyword">void</strong> a114_stringConstants() {
-<a class="jxr_linenumber" name="L3690" href="#L3690">3690</a> <em class="jxr_comment">// EMPTY</em>
-<a class="jxr_linenumber" name="L3691" href="#L3691">3691</a> assertEquals(<span class="jxr_string">""</span>, EMPTY);
-<a class="jxr_linenumber" name="L3692" href="#L3692">3692</a> assertTrue(EMPTY.isEmpty());
-<a class="jxr_linenumber" name="L3693" href="#L3693">3693</a>
-<a class="jxr_linenumber" name="L3694" href="#L3694">3694</a> <em class="jxr_comment">// SPACE</em>
-<a class="jxr_linenumber" name="L3695" href="#L3695">3695</a> assertEquals(<span class="jxr_string">" "</span>, SPACE);
-<a class="jxr_linenumber" name="L3696" href="#L3696">3696</a> assertEquals(1, SPACE.length());
-<a class="jxr_linenumber" name="L3697" href="#L3697">3697</a> assertTrue(Character.isWhitespace(SPACE.charAt(0)));
-<a class="jxr_linenumber" name="L3698" href="#L3698">3698</a>
-<a class="jxr_linenumber" name="L3699" href="#L3699">3699</a> <em class="jxr_comment">// NEWLINE</em>
-<a class="jxr_linenumber" name="L3700" href="#L3700">3700</a> assertEquals(<span class="jxr_string">"\n"</span>, NEWLINE);
-<a class="jxr_linenumber" name="L3701" href="#L3701">3701</a> assertEquals(1, NEWLINE.length());
-<a class="jxr_linenumber" name="L3702" href="#L3702">3702</a> assertEquals('\n', NEWLINE.charAt(0));
+<a class="jxr_linenumber" name="L3685" href="#L3685">3685</a> <strong class="jxr_keyword">var</strong> joined = buildString(sb -> {
+<a class="jxr_linenumber" name="L3686" href="#L3686">3686</a> appendWithSeparator(sb, <span class="jxr_string">"a"</span>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3687" href="#L3687">3687</a> appendWithSeparator(sb, <span class="jxr_string">"b"</span>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3688" href="#L3688">3688</a> appendWithSeparator(sb, <span class="jxr_string">"c"</span>, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L3689" href="#L3689">3689</a> });
+<a class="jxr_linenumber" name="L3690" href="#L3690">3690</a> assertEquals(<span class="jxr_string">"a, b, c"</span>, joined);
+<a class="jxr_linenumber" name="L3691" href="#L3691">3691</a>
+<a class="jxr_linenumber" name="L3692" href="#L3692">3692</a> <strong class="jxr_keyword">var</strong> empty = buildString(sb -> {
+<a class="jxr_linenumber" name="L3693" href="#L3693">3693</a> <em class="jxr_comment">// Do nothing</em>
+<a class="jxr_linenumber" name="L3694" href="#L3694">3694</a> });
+<a class="jxr_linenumber" name="L3695" href="#L3695">3695</a> assertEquals(<span class="jxr_string">""</span>, empty);
+<a class="jxr_linenumber" name="L3696" href="#L3696">3696</a>
+<a class="jxr_linenumber" name="L3697" href="#L3697">3697</a> <strong class="jxr_keyword">var</strong> complex = buildString(sb -> {
+<a class="jxr_linenumber" name="L3698" href="#L3698">3698</a> appendIfNotEmpty(sb, <span class="jxr_string">"prefix"</span>);
+<a class="jxr_linenumber" name="L3699" href="#L3699">3699</a> appendWithSeparator(sb, <span class="jxr_string">"middle"</span>, <span class="jxr_string">"-"</span>);
+<a class="jxr_linenumber" name="L3700" href="#L3700">3700</a> appendWithSeparator(sb, <span class="jxr_string">"suffix"</span>, <span class="jxr_string">"-"</span>);
+<a class="jxr_linenumber" name="L3701" href="#L3701">3701</a> });
+<a class="jxr_linenumber" name="L3702" href="#L3702">3702</a> assertEquals(<span class="jxr_string">"prefix-middle-suffix"</span>, complex);
<a class="jxr_linenumber" name="L3703" href="#L3703">3703</a>
-<a class="jxr_linenumber" name="L3704" href="#L3704">3704</a> <em class="jxr_comment">// TAB</em>
-<a class="jxr_linenumber" name="L3705" href="#L3705">3705</a> assertEquals(<span class="jxr_string">"\t"</span>, TAB);
-<a class="jxr_linenumber" name="L3706" href="#L3706">3706</a> assertEquals(1, TAB.length());
-<a class="jxr_linenumber" name="L3707" href="#L3707">3707</a> assertEquals('\t', TAB.charAt(0));
-<a class="jxr_linenumber" name="L3708" href="#L3708">3708</a>
-<a class="jxr_linenumber" name="L3709" href="#L3709">3709</a> <em class="jxr_comment">// CRLF</em>
-<a class="jxr_linenumber" name="L3710" href="#L3710">3710</a> assertEquals(<span class="jxr_string">"\r\n"</span>, CRLF);
-<a class="jxr_linenumber" name="L3711" href="#L3711">3711</a> assertEquals(2, CRLF.length());
-<a class="jxr_linenumber" name="L3712" href="#L3712">3712</a> assertEquals('\r', CRLF.charAt(0));
-<a class="jxr_linenumber" name="L3713" href="#L3713">3713</a> assertEquals('\n', CRLF.charAt(1));
-<a class="jxr_linenumber" name="L3714" href="#L3714">3714</a>
-<a class="jxr_linenumber" name="L3715" href="#L3715">3715</a> <em class="jxr_comment">// COMMON_SEPARATORS</em>
-<a class="jxr_linenumber" name="L3716" href="#L3716">3716</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">","</span>));
-<a class="jxr_linenumber" name="L3717" href="#L3717">3717</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">";"</span>));
-<a class="jxr_linenumber" name="L3718" href="#L3718">3718</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">":"</span>));
-<a class="jxr_linenumber" name="L3719" href="#L3719">3719</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">"|"</span>));
-<a class="jxr_linenumber" name="L3720" href="#L3720">3720</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">"\t"</span>));
-<a class="jxr_linenumber" name="L3721" href="#L3721">3721</a> assertEquals(5, COMMON_SEPARATORS.length());
-<a class="jxr_linenumber" name="L3722" href="#L3722">3722</a>
-<a class="jxr_linenumber" name="L3723" href="#L3723">3723</a> <em class="jxr_comment">// WHITESPACE_CHARS</em>
-<a class="jxr_linenumber" name="L3724" href="#L3724">3724</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">" "</span>));
-<a class="jxr_linenumber" name="L3725" href="#L3725">3725</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\t"</span>));
-<a class="jxr_linenumber" name="L3726" href="#L3726">3726</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\n"</span>));
-<a class="jxr_linenumber" name="L3727" href="#L3727">3727</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\r"</span>));
-<a class="jxr_linenumber" name="L3728" href="#L3728">3728</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\f"</span>));
-<a class="jxr_linenumber" name="L3729" href="#L3729">3729</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\u000B"</span>)); <em class="jxr_comment">// Vertical tab</em>
-<a class="jxr_linenumber" name="L3730" href="#L3730">3730</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < WHITESPACE_CHARS.length(); i++) {
-<a class="jxr_linenumber" name="L3731" href="#L3731">3731</a> assertTrue(Character.isWhitespace(WHITESPACE_CHARS.charAt(i)));
-<a class="jxr_linenumber" name="L3732" href="#L3732">3732</a> }
-<a class="jxr_linenumber" name="L3733" href="#L3733">3733</a> }
+<a class="jxr_linenumber" name="L3704" href="#L3704">3704</a> assertThrows(IllegalArgumentException.<strong class="jxr_keyword">class</strong>, () -> buildString(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L3705" href="#L3705">3705</a> }
+<a class="jxr_linenumber" name="L3706" href="#L3706">3706</a>
+<a class="jxr_linenumber" name="L3707" href="#L3707">3707</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3708" href="#L3708">3708</a> <em class="jxr_comment">// String Constants and Utilities</em>
+<a class="jxr_linenumber" name="L3709" href="#L3709">3709</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3710" href="#L3710">3710</a>
+<a class="jxr_linenumber" name="L3711" href="#L3711">3711</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3712" href="#L3712">3712</a> <em class="jxr_comment">// String Constants</em>
+<a class="jxr_linenumber" name="L3713" href="#L3713">3713</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3714" href="#L3714">3714</a> @Test
+<a class="jxr_linenumber" name="L3715" href="#L3715">3715</a> <strong class="jxr_keyword">void</strong> a114_stringConstants() {
+<a class="jxr_linenumber" name="L3716" href="#L3716">3716</a> <em class="jxr_comment">// EMPTY</em>
+<a class="jxr_linenumber" name="L3717" href="#L3717">3717</a> assertEquals(<span class="jxr_string">""</span>, EMPTY);
+<a class="jxr_linenumber" name="L3718" href="#L3718">3718</a> assertTrue(EMPTY.isEmpty());
+<a class="jxr_linenumber" name="L3719" href="#L3719">3719</a>
+<a class="jxr_linenumber" name="L3720" href="#L3720">3720</a> <em class="jxr_comment">// SPACE</em>
+<a class="jxr_linenumber" name="L3721" href="#L3721">3721</a> assertEquals(<span class="jxr_string">" "</span>, SPACE);
+<a class="jxr_linenumber" name="L3722" href="#L3722">3722</a> assertEquals(1, SPACE.length());
+<a class="jxr_linenumber" name="L3723" href="#L3723">3723</a> assertTrue(Character.isWhitespace(SPACE.charAt(0)));
+<a class="jxr_linenumber" name="L3724" href="#L3724">3724</a>
+<a class="jxr_linenumber" name="L3725" href="#L3725">3725</a> <em class="jxr_comment">// NEWLINE</em>
+<a class="jxr_linenumber" name="L3726" href="#L3726">3726</a> assertEquals(<span class="jxr_string">"\n"</span>, NEWLINE);
+<a class="jxr_linenumber" name="L3727" href="#L3727">3727</a> assertEquals(1, NEWLINE.length());
+<a class="jxr_linenumber" name="L3728" href="#L3728">3728</a> assertEquals('\n', NEWLINE.charAt(0));
+<a class="jxr_linenumber" name="L3729" href="#L3729">3729</a>
+<a class="jxr_linenumber" name="L3730" href="#L3730">3730</a> <em class="jxr_comment">// TAB</em>
+<a class="jxr_linenumber" name="L3731" href="#L3731">3731</a> assertEquals(<span class="jxr_string">"\t"</span>, TAB);
+<a class="jxr_linenumber" name="L3732" href="#L3732">3732</a> assertEquals(1, TAB.length());
+<a class="jxr_linenumber" name="L3733" href="#L3733">3733</a> assertEquals('\t', TAB.charAt(0));
<a class="jxr_linenumber" name="L3734" href="#L3734">3734</a>
-<a class="jxr_linenumber" name="L3735" href="#L3735">3735</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3736" href="#L3736">3736</a> <em class="jxr_comment">// Performance and Memory Utilities</em>
-<a class="jxr_linenumber" name="L3737" href="#L3737">3737</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3738" href="#L3738">3738</a>
-<a class="jxr_linenumber" name="L3739" href="#L3739">3739</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3740" href="#L3740">3740</a> <em class="jxr_comment">// intern(String)</em>
-<a class="jxr_linenumber" name="L3741" href="#L3741">3741</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3742" href="#L3742">3742</a> @Test
-<a class="jxr_linenumber" name="L3743" href="#L3743">3743</a> <strong class="jxr_keyword">void</strong> a115_intern() {
-<a class="jxr_linenumber" name="L3744" href="#L3744">3744</a> assertNull(intern(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L3745" href="#L3745">3745</a>
-<a class="jxr_linenumber" name="L3746" href="#L3746">3746</a> <strong class="jxr_keyword">var</strong> s1 = <strong class="jxr_keyword">new</strong> String(<span class="jxr_string">"test"</span>);
-<a class="jxr_linenumber" name="L3747" href="#L3747">3747</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(<span class="jxr_string">"test"</span>);
-<a class="jxr_linenumber" name="L3748" href="#L3748">3748</a> assertTrue(s1 != s2); <em class="jxr_comment">// Different objects</em>
-<a class="jxr_linenumber" name="L3749" href="#L3749">3749</a>
-<a class="jxr_linenumber" name="L3750" href="#L3750">3750</a> <strong class="jxr_keyword">var</strong> i1 = intern(s1);
-<a class="jxr_linenumber" name="L3751" href="#L3751">3751</a> <strong class="jxr_keyword">var</strong> i2 = intern(s2);
-<a class="jxr_linenumber" name="L3752" href="#L3752">3752</a> assertTrue(i1 == i2); <em class="jxr_comment">// Same interned object</em>
-<a class="jxr_linenumber" name="L3753" href="#L3753">3753</a> assertEquals(<span class="jxr_string">"test"</span>, i1);
-<a class="jxr_linenumber" name="L3754" href="#L3754">3754</a> assertEquals(<span class="jxr_string">"test"</span>, i2);
-<a class="jxr_linenumber" name="L3755" href="#L3755">3755</a>
-<a class="jxr_linenumber" name="L3756" href="#L3756">3756</a> <em class="jxr_comment">// String literals are automatically interned</em>
-<a class="jxr_linenumber" name="L3757" href="#L3757">3757</a> <strong class="jxr_keyword">var</strong> literal = <span class="jxr_string">"literal"</span>;
-<a class="jxr_linenumber" name="L3758" href="#L3758">3758</a> assertTrue(isInterned(literal));
-<a class="jxr_linenumber" name="L3759" href="#L3759">3759</a> assertSame(literal, intern(literal));
-<a class="jxr_linenumber" name="L3760" href="#L3760">3760</a> }
-<a class="jxr_linenumber" name="L3761" href="#L3761">3761</a>
-<a class="jxr_linenumber" name="L3762" href="#L3762">3762</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3763" href="#L3763">3763</a> <em class="jxr_comment">// isInterned(String)</em>
-<a class="jxr_linenumber" name="L3764" href="#L3764">3764</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3765" href="#L3765">3765</a> @Test
-<a class="jxr_linenumber" name="L3766" href="#L3766">3766</a> <strong class="jxr_keyword">void</strong> a116_isInterned() {
-<a class="jxr_linenumber" name="L3767" href="#L3767">3767</a> assertFalse(isInterned(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L3768" href="#L3768">3768</a>
-<a class="jxr_linenumber" name="L3769" href="#L3769">3769</a> <em class="jxr_comment">// String literals are automatically interned</em>
-<a class="jxr_linenumber" name="L3770" href="#L3770">3770</a> <strong class="jxr_keyword">var</strong> literal = <span class="jxr_string">"test"</span>;
-<a class="jxr_linenumber" name="L3771" href="#L3771">3771</a> assertTrue(isInterned(literal));
-<a class="jxr_linenumber" name="L3772" href="#L3772">3772</a>
-<a class="jxr_linenumber" name="L3773" href="#L3773">3773</a> <em class="jxr_comment">// New String objects are not interned</em>
-<a class="jxr_linenumber" name="L3774" href="#L3774">3774</a> <strong class="jxr_keyword">var</strong> s1 = <strong class="jxr_keyword">new</strong> String(<span class="jxr_string">"test"</span>);
-<a class="jxr_linenumber" name="L3775" href="#L3775">3775</a> assertFalse(isInterned(s1));
-<a class="jxr_linenumber" name="L3776" href="#L3776">3776</a>
-<a class="jxr_linenumber" name="L3777" href="#L3777">3777</a> <em class="jxr_comment">// After interning, it should be interned</em>
-<a class="jxr_linenumber" name="L3778" href="#L3778">3778</a> <strong class="jxr_keyword">var</strong> s2 = intern(s1);
-<a class="jxr_linenumber" name="L3779" href="#L3779">3779</a> assertTrue(isInterned(s2));
-<a class="jxr_linenumber" name="L3780" href="#L3780">3780</a> assertSame(s1.intern(), s2);
-<a class="jxr_linenumber" name="L3781" href="#L3781">3781</a> }
-<a class="jxr_linenumber" name="L3782" href="#L3782">3782</a>
-<a class="jxr_linenumber" name="L3783" href="#L3783">3783</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3784" href="#L3784">3784</a> <em class="jxr_comment">// getStringSize(String)</em>
-<a class="jxr_linenumber" name="L3785" href="#L3785">3785</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3786" href="#L3786">3786</a> @Test
-<a class="jxr_linenumber" name="L3787" href="#L3787">3787</a> <strong class="jxr_keyword">void</strong> a117_getStringSize() {
-<a class="jxr_linenumber" name="L3788" href="#L3788">3788</a> assertEquals(0, getStringSize(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L3789" href="#L3789">3789</a> assertEquals(40, getStringSize(<span class="jxr_string">""</span>)); <em class="jxr_comment">// 24 + 16 = 40 bytes overhead</em>
-<a class="jxr_linenumber" name="L3790" href="#L3790">3790</a> assertEquals(50, getStringSize(<span class="jxr_string">"hello"</span>)); <em class="jxr_comment">// 40 + (5 * 2) = 50 bytes</em>
-<a class="jxr_linenumber" name="L3791" href="#L3791">3791</a> assertEquals(48, getStringSize(<span class="jxr_string">"test"</span>)); <em class="jxr_comment">// 40 + (4 * 2) = 48 bytes</em>
-<a class="jxr_linenumber" name="L3792" href="#L3792">3792</a> assertEquals(60, getStringSize(<span class="jxr_string">"1234567890"</span>)); <em class="jxr_comment">// 40 + (10 * 2) = 60 bytes</em>
-<a class="jxr_linenumber" name="L3793" href="#L3793">3793</a>
-<a class="jxr_linenumber" name="L3794" href="#L3794">3794</a> <em class="jxr_comment">// Verify the calculation: 24 (String object) + 16 (char[] header) + (2 * length)</em>
-<a class="jxr_linenumber" name="L3795" href="#L3795">3795</a> <strong class="jxr_keyword">var</strong> emptySize = getStringSize(<span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L3796" href="#L3796">3796</a> assertTrue(emptySize >= 24); <em class="jxr_comment">// At least String object overhead</em>
-<a class="jxr_linenumber" name="L3797" href="#L3797">3797</a>
-<a class="jxr_linenumber" name="L3798" href="#L3798">3798</a> <strong class="jxr_keyword">var</strong> oneCharSize = getStringSize(<span class="jxr_string">"a"</span>);
-<a class="jxr_linenumber" name="L3799" href="#L3799">3799</a> assertEquals(emptySize + 2, oneCharSize); <em class="jxr_comment">// One char adds 2 bytes</em>
-<a class="jxr_linenumber" name="L3800" href="#L3800">3800</a>
-<a class="jxr_linenumber" name="L3801" href="#L3801">3801</a> <strong class="jxr_keyword">var</strong> tenCharSize = getStringSize(<span class="jxr_string">"1234567890"</span>);
-<a class="jxr_linenumber" name="L3802" href="#L3802">3802</a> assertEquals(emptySize + 20, tenCharSize); <em class="jxr_comment">// Ten chars add 20 bytes</em>
-<a class="jxr_linenumber" name="L3803" href="#L3803">3803</a> }
-<a class="jxr_linenumber" name="L3804" href="#L3804">3804</a>
-<a class="jxr_linenumber" name="L3805" href="#L3805">3805</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3806" href="#L3806">3806</a> <em class="jxr_comment">// optimizeString(String)</em>
-<a class="jxr_linenumber" name="L3807" href="#L3807">3807</a> <em class="jxr_comment">//====================================================================================================</em>
-<a class="jxr_linenumber" name="L3808" href="#L3808">3808</a> @Test
-<a class="jxr_linenumber" name="L3809" href="#L3809">3809</a> <strong class="jxr_keyword">void</strong> a118_optimizeString() {
-<a class="jxr_linenumber" name="L3810" href="#L3810">3810</a> assertNull(optimizeString(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L3811" href="#L3811">3811</a> assertNull(optimizeString(<span class="jxr_string">"short"</span>)); <em class="jxr_comment">// No suggestions for short strings</em>
-<a class="jxr_linenumber" name="L3812" href="#L3812">3812</a>
-<a class="jxr_linenumber" name="L3813" href="#L3813">3813</a> <em class="jxr_comment">// Test for large string suggestion</em>
-<a class="jxr_linenumber" name="L3814" href="#L3814">3814</a> <strong class="jxr_keyword">var</strong> largeString = <span class="jxr_string">"x"</span>.repeat(1001);
-<a class="jxr_linenumber" name="L3815" href="#L3815">3815</a> <strong class="jxr_keyword">var</strong> suggestions = optimizeString(largeString);
-<a class="jxr_linenumber" name="L3816" href="#L3816">3816</a> assertNotNull(suggestions);
-<a class="jxr_linenumber" name="L3817" href="#L3817">3817</a> assertTrue(suggestions.contains(<span class="jxr_string">"StringBuilder"</span>));
-<a class="jxr_linenumber" name="L3818" href="#L3818">3818</a>
-<a class="jxr_linenumber" name="L3819" href="#L3819">3819</a> <em class="jxr_comment">// Test for interning suggestion (medium length, not interned)</em>
-<a class="jxr_linenumber" name="L3820" href="#L3820">3820</a> <strong class="jxr_keyword">var</strong> mediumString = <strong class="jxr_keyword">new</strong> String(<span class="jxr_string">"medium length string for testing"</span>);
-<a class="jxr_linenumber" name="L3821" href="#L3821">3821</a> <strong class="jxr_keyword">var</strong> interningSuggestion = optimizeString(mediumString);
-<a class="jxr_linenumber" name="L3822" href="#L3822">3822</a> assertNotNull(interningSuggestion);
-<a class="jxr_linenumber" name="L3823" href="#L3823">3823</a> assertTrue(interningSuggestion.contains(<span class="jxr_string">"interning"</span>));
-<a class="jxr_linenumber" name="L3824" href="#L3824">3824</a>
-<a class="jxr_linenumber" name="L3825" href="#L3825">3825</a> <em class="jxr_comment">// Test for char[] suggestion (long string)</em>
-<a class="jxr_linenumber" name="L3826" href="#L3826">3826</a> <strong class="jxr_keyword">var</strong> longString = <span class="jxr_string">"x"</span>.repeat(101);
-<a class="jxr_linenumber" name="L3827" href="#L3827">3827</a> <strong class="jxr_keyword">var</strong> charArraySuggestion = optimizeString(longString);
-<a class="jxr_linenumber" name="L3828" href="#L3828">3828</a> assertNotNull(charArraySuggestion);
-<a class="jxr_linenumber" name="L3829" href="#L3829">3829</a> assertTrue(charArraySuggestion.contains(<span class="jxr_string">"char[]"</span>));
+<a class="jxr_linenumber" name="L3735" href="#L3735">3735</a> <em class="jxr_comment">// CRLF</em>
+<a class="jxr_linenumber" name="L3736" href="#L3736">3736</a> assertEquals(<span class="jxr_string">"\r\n"</span>, CRLF);
+<a class="jxr_linenumber" name="L3737" href="#L3737">3737</a> assertEquals(2, CRLF.length());
+<a class="jxr_linenumber" name="L3738" href="#L3738">3738</a> assertEquals('\r', CRLF.charAt(0));
+<a class="jxr_linenumber" name="L3739" href="#L3739">3739</a> assertEquals('\n', CRLF.charAt(1));
+<a class="jxr_linenumber" name="L3740" href="#L3740">3740</a>
+<a class="jxr_linenumber" name="L3741" href="#L3741">3741</a> <em class="jxr_comment">// COMMON_SEPARATORS</em>
+<a class="jxr_linenumber" name="L3742" href="#L3742">3742</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">","</span>));
+<a class="jxr_linenumber" name="L3743" href="#L3743">3743</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">";"</span>));
+<a class="jxr_linenumber" name="L3744" href="#L3744">3744</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">":"</span>));
+<a class="jxr_linenumber" name="L3745" href="#L3745">3745</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">"|"</span>));
+<a class="jxr_linenumber" name="L3746" href="#L3746">3746</a> assertTrue(COMMON_SEPARATORS.contains(<span class="jxr_string">"\t"</span>));
+<a class="jxr_linenumber" name="L3747" href="#L3747">3747</a> assertEquals(5, COMMON_SEPARATORS.length());
+<a class="jxr_linenumber" name="L3748" href="#L3748">3748</a>
+<a class="jxr_linenumber" name="L3749" href="#L3749">3749</a> <em class="jxr_comment">// WHITESPACE_CHARS</em>
+<a class="jxr_linenumber" name="L3750" href="#L3750">3750</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">" "</span>));
+<a class="jxr_linenumber" name="L3751" href="#L3751">3751</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\t"</span>));
+<a class="jxr_linenumber" name="L3752" href="#L3752">3752</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\n"</span>));
+<a class="jxr_linenumber" name="L3753" href="#L3753">3753</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\r"</span>));
+<a class="jxr_linenumber" name="L3754" href="#L3754">3754</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\f"</span>));
+<a class="jxr_linenumber" name="L3755" href="#L3755">3755</a> assertTrue(WHITESPACE_CHARS.contains(<span class="jxr_string">"\u000B"</span>)); <em class="jxr_comment">// Vertical tab</em>
+<a class="jxr_linenumber" name="L3756" href="#L3756">3756</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < WHITESPACE_CHARS.length(); i++) {
+<a class="jxr_linenumber" name="L3757" href="#L3757">3757</a> assertTrue(Character.isWhitespace(WHITESPACE_CHARS.charAt(i)));
+<a class="jxr_linenumber" name="L3758" href="#L3758">3758</a> }
+<a class="jxr_linenumber" name="L3759" href="#L3759">3759</a> }
+<a class="jxr_linenumber" name="L3760" href="#L3760">3760</a>
+<a class="jxr_linenumber" name="L3761" href="#L3761">3761</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3762" href="#L3762">3762</a> <em class="jxr_comment">// Performance and Memory Utilities</em>
+<a class="jxr_linenumber" name="L3763" href="#L3763">3763</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3764" href="#L3764">3764</a>
+<a class="jxr_linenumber" name="L3765" href="#L3765">3765</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3766" href="#L3766">3766</a> <em class="jxr_comment">// intern(String)</em>
+<a class="jxr_linenumber" name="L3767" href="#L3767">3767</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3768" href="#L3768">3768</a> @Test
+<a class="jxr_linenumber" name="L3769" href="#L3769">3769</a> <strong class="jxr_keyword">void</strong> a115_intern() {
+<a class="jxr_linenumber" name="L3770" href="#L3770">3770</a> assertNull(intern(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L3771" href="#L3771">3771</a>
+<a class="jxr_linenumber" name="L3772" href="#L3772">3772</a> <strong class="jxr_keyword">var</strong> s1 = <strong class="jxr_keyword">new</strong> String(<span class="jxr_string">"test"</span>);
+<a class="jxr_linenumber" name="L3773" href="#L3773">3773</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(<span class="jxr_string">"test"</span>);
+<a class="jxr_linenumber" name="L3774" href="#L3774">3774</a> assertTrue(s1 != s2); <em class="jxr_comment">// Different objects</em>
+<a class="jxr_linenumber" name="L3775" href="#L3775">3775</a>
+<a class="jxr_linenumber" name="L3776" href="#L3776">3776</a> <strong class="jxr_keyword">var</strong> i1 = intern(s1);
+<a class="jxr_linenumber" name="L3777" href="#L3777">3777</a> <strong class="jxr_keyword">var</strong> i2 = intern(s2);
+<a class="jxr_linenumber" name="L3778" href="#L3778">3778</a> assertTrue(i1 == i2); <em class="jxr_comment">// Same interned object</em>
+<a class="jxr_linenumber" name="L3779" href="#L3779">3779</a> assertEquals(<span class="jxr_string">"test"</span>, i1);
+<a class="jxr_linenumber" name="L3780" href="#L3780">3780</a> assertEquals(<span class="jxr_string">"test"</span>, i2);
+<a class="jxr_linenumber" name="L3781" href="#L3781">3781</a>
+<a class="jxr_linenumber" name="L3782" href="#L3782">3782</a> <em class="jxr_comment">// String literals are automatically interned</em>
+<a class="jxr_linenumber" name="L3783" href="#L3783">3783</a> <strong class="jxr_keyword">var</strong> literal = <span class="jxr_string">"literal"</span>;
+<a class="jxr_linenumber" name="L3784" href="#L3784">3784</a> assertTrue(isInterned(literal));
+<a class="jxr_linenumber" name="L3785" href="#L3785">3785</a> assertSame(literal, intern(literal));
+<a class="jxr_linenumber" name="L3786" href="#L3786">3786</a> }
+<a class="jxr_linenumber" name="L3787" href="#L3787">3787</a>
+<a class="jxr_linenumber" name="L3788" href="#L3788">3788</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3789" href="#L3789">3789</a> <em class="jxr_comment">// isInterned(String)</em>
+<a class="jxr_linenumber" name="L3790" href="#L3790">3790</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3791" href="#L3791">3791</a> @Test
+<a class="jxr_linenumber" name="L3792" href="#L3792">3792</a> <strong class="jxr_keyword">void</strong> a116_isInterned() {
+<a class="jxr_linenumber" name="L3793" href="#L3793">3793</a> assertFalse(isInterned(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L3794" href="#L3794">3794</a>
+<a class="jxr_linenumber" name="L3795" href="#L3795">3795</a> <em class="jxr_comment">// String literals are automatically interned</em>
+<a class="jxr_linenumber" name="L3796" href="#L3796">3796</a> <strong class="jxr_keyword">var</strong> literal = <span class="jxr_string">"test"</span>;
+<a class="jxr_linenumber" name="L3797" href="#L3797">3797</a> assertTrue(isInterned(literal));
+<a class="jxr_linenumber" name="L3798" href="#L3798">3798</a>
+<a class="jxr_linenumber" name="L3799" href="#L3799">3799</a> <em class="jxr_comment">// New String objects are not interned</em>
+<a class="jxr_linenumber" name="L3800" href="#L3800">3800</a> <strong class="jxr_keyword">var</strong> s1 = <strong class="jxr_keyword">new</strong> String(<span class="jxr_string">"test"</span>);
+<a class="jxr_linenumber" name="L3801" href="#L3801">3801</a> assertFalse(isInterned(s1));
+<a class="jxr_linenumber" name="L3802" href="#L3802">3802</a>
+<a class="jxr_linenumber" name="L3803" href="#L3803">3803</a> <em class="jxr_comment">// After interning, it should be interned</em>
+<a class="jxr_linenumber" name="L3804" href="#L3804">3804</a> <strong class="jxr_keyword">var</strong> s2 = intern(s1);
+<a class="jxr_linenumber" name="L3805" href="#L3805">3805</a> assertTrue(isInterned(s2));
+<a class="jxr_linenumber" name="L3806" href="#L3806">3806</a> assertSame(s1.intern(), s2);
+<a class="jxr_linenumber" name="L3807" href="#L3807">3807</a> }
+<a class="jxr_linenumber" name="L3808" href="#L3808">3808</a>
+<a class="jxr_linenumber" name="L3809" href="#L3809">3809</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3810" href="#L3810">3810</a> <em class="jxr_comment">// getStringSize(String)</em>
+<a class="jxr_linenumber" name="L3811" href="#L3811">3811</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3812" href="#L3812">3812</a> @Test
+<a class="jxr_linenumber" name="L3813" href="#L3813">3813</a> <strong class="jxr_keyword">void</strong> a117_getStringSize() {
+<a class="jxr_linenumber" name="L3814" href="#L3814">3814</a> assertEquals(0, getStringSize(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L3815" href="#L3815">3815</a> assertEquals(40, getStringSize(<span class="jxr_string">""</span>)); <em class="jxr_comment">// 24 + 16 = 40 bytes overhead</em>
+<a class="jxr_linenumber" name="L3816" href="#L3816">3816</a> assertEquals(50, getStringSize(<span class="jxr_string">"hello"</span>)); <em class="jxr_comment">// 40 + (5 * 2) = 50 bytes</em>
+<a class="jxr_linenumber" name="L3817" href="#L3817">3817</a> assertEquals(48, getStringSize(<span class="jxr_string">"test"</span>)); <em class="jxr_comment">// 40 + (4 * 2) = 48 bytes</em>
+<a class="jxr_linenumber" name="L3818" href="#L3818">3818</a> assertEquals(60, getStringSize(<span class="jxr_string">"1234567890"</span>)); <em class="jxr_comment">// 40 + (10 * 2) = 60 bytes</em>
+<a class="jxr_linenumber" name="L3819" href="#L3819">3819</a>
+<a class="jxr_linenumber" name="L3820" href="#L3820">3820</a> <em class="jxr_comment">// Verify the calculation: 24 (String object) + 16 (char[] header) + (2 * length)</em>
+<a class="jxr_linenumber" name="L3821" href="#L3821">3821</a> <strong class="jxr_keyword">var</strong> emptySize = getStringSize(<span class="jxr_string">""</span>);
+<a class="jxr_linenumber" name="L3822" href="#L3822">3822</a> assertTrue(emptySize >= 24); <em class="jxr_comment">// At least String object overhead</em>
+<a class="jxr_linenumber" name="L3823" href="#L3823">3823</a>
+<a class="jxr_linenumber" name="L3824" href="#L3824">3824</a> <strong class="jxr_keyword">var</strong> oneCharSize = getStringSize(<span class="jxr_string">"a"</span>);
+<a class="jxr_linenumber" name="L3825" href="#L3825">3825</a> assertEquals(emptySize + 2, oneCharSize); <em class="jxr_comment">// One char adds 2 bytes</em>
+<a class="jxr_linenumber" name="L3826" href="#L3826">3826</a>
+<a class="jxr_linenumber" name="L3827" href="#L3827">3827</a> <strong class="jxr_keyword">var</strong> tenCharSize = getStringSize(<span class="jxr_string">"1234567890"</span>);
+<a class="jxr_linenumber" name="L3828" href="#L3828">3828</a> assertEquals(emptySize + 20, tenCharSize); <em class="jxr_comment">// Ten chars add 20 bytes</em>
+<a class="jxr_linenumber" name="L3829" href="#L3829">3829</a> }
<a class="jxr_linenumber" name="L3830" href="#L3830">3830</a>
-<a class="jxr_linenumber" name="L3831" href="#L3831">3831</a> <em class="jxr_comment">// Test for compression suggestion (very large string)</em>
-<a class="jxr_linenumber" name="L3832" href="#L3832">3832</a> <strong class="jxr_keyword">var</strong> veryLargeString = <span class="jxr_string">"x"</span>.repeat(10001);
-<a class="jxr_linenumber" name="L3833" href="#L3833">3833</a> <strong class="jxr_keyword">var</strong> compressionSuggestion = optimizeString(veryLargeString);
-<a class="jxr_linenumber" name="L3834" href="#L3834">3834</a> assertNotNull(compressionSuggestion);
-<a class="jxr_linenumber" name="L3835" href="#L3835">3835</a> assertTrue(compressionSuggestion.contains(<span class="jxr_string">"compression"</span>));
-<a class="jxr_linenumber" name="L3836" href="#L3836">3836</a>
-<a class="jxr_linenumber" name="L3837" href="#L3837">3837</a> <em class="jxr_comment">// Test that interned strings don't suggest interning</em>
-<a class="jxr_linenumber" name="L3838" href="#L3838">3838</a> <strong class="jxr_keyword">var</strong> interned = intern(<span class="jxr_string">"medium length string"</span>);
-<a class="jxr_linenumber" name="L3839" href="#L3839">3839</a> <strong class="jxr_keyword">var</strong> noInterningSuggestion = optimizeString(interned);
-<a class="jxr_linenumber" name="L3840" href="#L3840">3840</a> <em class="jxr_comment">// Should not suggest interning if already interned, but may have other suggestions</em>
-<a class="jxr_linenumber" name="L3841" href="#L3841">3841</a> <strong class="jxr_keyword">if</strong> (noInterningSuggestion != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="L3842" href="#L3842">3842</a> assertFalse(noInterningSuggestion.contains(<span class="jxr_string">"interning"</span>));
-<a class="jxr_linenumber" name="L3843" href="#L3843">3843</a> }
-<a class="jxr_linenumber" name="L3844" href="#L3844">3844</a> }
-<a class="jxr_linenumber" name="L3845" href="#L3845">3845</a> }
+<a class="jxr_linenumber" name="L3831" href="#L3831">3831</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3832" href="#L3832">3832</a> <em class="jxr_comment">// optimizeString(String)</em>
+<a class="jxr_linenumber" name="L3833" href="#L3833">3833</a> <em class="jxr_comment">//====================================================================================================</em>
+<a class="jxr_linenumber" name="L3834" href="#L3834">3834</a> @Test
+<a class="jxr_linenumber" name="L3835" href="#L3835">3835</a> <strong class="jxr_keyword">void</strong> a118_optimizeString() {
+<a class="jxr_linenumber" name="L3836" href="#L3836">3836</a> assertNull(optimizeString(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L3837" href="#L3837">3837</a> assertNull(optimizeString(<span class="jxr_string">"short"</span>)); <em class="jxr_comment">// No suggestions for short strings</em>
+<a class="jxr_linenumber" name="L3838" href="#L3838">3838</a>
+<a class="jxr_linenumber" name="L3839" href="#L3839">3839</a> <em class="jxr_comment">// Test for large string suggestion</em>
+<a class="jxr_linenumber" name="L3840" href="#L3840">3840</a> <strong class="jxr_keyword">var</strong> largeString = <span class="jxr_string">"x"</span>.repeat(1001);
+<a class="jxr_linenumber" name="L3841" href="#L3841">3841</a> <strong class="jxr_keyword">var</strong> suggestions = optimizeString(largeString);
+<a class="jxr_linenumber" name="L3842" href="#L3842">3842</a> assertNotNull(suggestions);
+<a class="jxr_linenumber" name="L3843" href="#L3843">3843</a> assertTrue(suggestions.contains(<span class="jxr_string">"StringBuilder"</span>));
+<a class="jxr_linenumber" name="L3844" href="#L3844">3844</a>
+<a class="jxr_linenumber" name="L3845" href="#L3845">3845</a> <em class="jxr_comment">// Test for interning suggestion (medium length, not interned)</em>
+<a class="jxr_linenumber" name="L3846" href="#L3846">3846</a> <strong class="jxr_keyword">var</strong> mediumString = <strong class="jxr_keyword">new</strong> String(<span class="jxr_string">"medium length string for testing"</span>);
+<a class="jxr_linenumber" name="L3847" href="#L3847">3847</a> <strong class="jxr_keyword">var</strong> interningSuggestion = optimizeString(mediumString);
+<a class="jxr_linenumber" name="L3848" href="#L3848">3848</a> assertNotNull(interningSuggestion);
+<a class="jxr_linenumber" name="L3849" href="#L3849">3849</a> assertTrue(interningSuggestion.contains(<span class="jxr_string">"interning"</span>));
+<a class="jxr_linenumber" name="L3850" href="#L3850">3850</a>
+<a class="jxr_linenumber" name="L3851" href="#L3851">3851</a> <em class="jxr_comment">// Test for char[] suggestion (long string)</em>
+<a class="jxr_linenumber" name="L3852" href="#L3852">3852</a> <strong class="jxr_keyword">var</strong> longString = <span class="jxr_string">"x"</span>.repeat(101);
+<a class="jxr_linenumber" name="L3853" href="#L3853">3853</a> <strong class="jxr_keyword">var</strong> charArraySuggestion = optimizeString(longString);
+<a class="jxr_linenumber" name="L3854" href="#L3854">3854</a> assertNotNull(charArraySuggestion);
+<a class="jxr_linenumber" name="L3855" href="#L3855">3855</a> assertTrue(charArraySuggestion.contains(<span class="jxr_string">"char[]"</span>));
+<a class="jxr_linenumber" name="L3856" href="#L3856">3856</a>
+<a class="jxr_linenumber" name="L3857" href="#L3857">3857</a> <em class="jxr_comment">// Test for compression suggestion (very large string)</em>
+<a class="jxr_linenumber" name="L3858" href="#L3858">3858</a> <strong class="jxr_keyword">var</strong> veryLargeString = <span class="jxr_string">"x"</span>.repeat(10001);
+<a class="jxr_linenumber" name="L3859" href="#L3859">3859</a> <strong class="jxr_keyword">var</strong> compressionSuggestion = optimizeString(veryLargeString);
+<a class="jxr_linenumber" name="L3860" href="#L3860">3860</a> assertNotNull(compressionSuggestion);
+<a class="jxr_linenumber" name="L3861" href="#L3861">3861</a> assertTrue(compressionSuggestion.contains(<span class="jxr_string">"compression"</span>));
+<a class="jxr_linenumber" name="L3862" href="#L3862">3862</a>
+<a class="jxr_linenumber" name="L3863" href="#L3863">3863</a> <em class="jxr_comment">// Test that interned strings don't suggest interning</em>
+<a class="jxr_linenumber" name="L3864" href="#L3864">3864</a> <strong class="jxr_keyword">var</strong> interned = intern(<span class="jxr_string">"medium length string"</span>);
+<a class="jxr_linenumber" name="L3865" href="#L3865">3865</a> <strong class="jxr_keyword">var</strong> noInterningSuggestion = optimizeString(interned);
+<a class="jxr_linenumber" name="L3866" href="#L3866">3866</a> <em class="jxr_comment">// Should not suggest interning if already interned, but may have other suggestions</em>
+<a class="jxr_linenumber" name="L3867" href="#L3867">3867</a> <strong class="jxr_keyword">if</strong> (noInterningSuggestion != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="L3868" href="#L3868">3868</a> assertFalse(noInterningSuggestion.contains(<span class="jxr_string">"interning"</span>));
+<a class="jxr_linenumber" name="L3869" href="#L3869">3869</a> }
+<a class="jxr_linenumber" name="L3870" href="#L3870">3870</a> }
+<a class="jxr_linenumber" name="L3871" href="#L3871">3871</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/common/utils/StringUtils.html b/site/xref/org/apache/juneau/common/utils/StringUtils.html
index 6bbe0127e3..902d0d40e0 100644
--- a/site/xref/org/apache/juneau/common/utils/StringUtils.html
+++ b/site/xref/org/apache/juneau/common/utils/StringUtils.html
@@ -2052,12 +2052,12 @@
<a class="jxr_linenumber" name="L2044" href="#L2044">2044</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidMacAddress(String mac) {
<a class="jxr_linenumber" name="L2045" href="#L2045">2045</a> <strong class="jxr_keyword">if</strong> (isEmpty(mac))
<a class="jxr_linenumber" name="L2046" href="#L2046">2046</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2047" href="#L2047">2047</a>
+<a class="jxr_linenumber" name="L2047" href="#L2047">2047</a>
<a class="jxr_linenumber" name="L2048" href="#L2048">2048</a> <em class="jxr_comment">// Remove separators and check if it's 12 hex digits</em>
<a class="jxr_linenumber" name="L2049" href="#L2049">2049</a> <strong class="jxr_keyword">var</strong> cleaned = mac.replaceAll(<span class="jxr_string">"[:-]"</span>, <span class="jxr_string">""</span>).toUpperCase();
<a class="jxr_linenumber" name="L2050" href="#L2050">2050</a> <strong class="jxr_keyword">if</strong> (cleaned.length() != 12)
<a class="jxr_linenumber" name="L2051" href="#L2051">2051</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2052" href="#L2052">2052</a>
+<a class="jxr_linenumber" name="L2052" href="#L2052">2052</a>
<a class="jxr_linenumber" name="L2053" href="#L2053">2053</a> <em class="jxr_comment">// Check if all characters are valid hex digits</em>
<a class="jxr_linenumber" name="L2054" href="#L2054">2054</a> <strong class="jxr_keyword">return</strong> cleaned.matches(<span class="jxr_string">"^[0-9A-F]{12}$"</span>);
<a class="jxr_linenumber" name="L2055" href="#L2055">2055</a> }
@@ -2089,41 +2089,41 @@
<a class="jxr_linenumber" name="L2081" href="#L2081">2081</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidHostname(String hostname) {
<a class="jxr_linenumber" name="L2082" href="#L2082">2082</a> <strong class="jxr_keyword">if</strong> (isEmpty(hostname))
<a class="jxr_linenumber" name="L2083" href="#L2083">2083</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2084" href="#L2084">2084</a>
+<a class="jxr_linenumber" name="L2084" href="#L2084">2084</a>
<a class="jxr_linenumber" name="L2085" href="#L2085">2085</a> <em class="jxr_comment">// Cannot start or end with a dot</em>
<a class="jxr_linenumber" name="L2086" href="#L2086">2086</a> <strong class="jxr_keyword">if</strong> (hostname.startsWith(<span class="jxr_string">"."</span>) || hostname.endsWith(<span class="jxr_string">"."</span>))
<a class="jxr_linenumber" name="L2087" href="#L2087">2087</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2088" href="#L2088">2088</a>
+<a class="jxr_linenumber" name="L2088" href="#L2088">2088</a>
<a class="jxr_linenumber" name="L2089" href="#L2089">2089</a> <em class="jxr_comment">// Total length cannot exceed 253 characters</em>
<a class="jxr_linenumber" name="L2090" href="#L2090">2090</a> <strong class="jxr_keyword">if</strong> (hostname.length() > 253)
<a class="jxr_linenumber" name="L2091" href="#L2091">2091</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2092" href="#L2092">2092</a>
+<a class="jxr_linenumber" name="L2092" href="#L2092">2092</a>
<a class="jxr_linenumber" name="L2093" href="#L2093">2093</a> <em class="jxr_comment">// Split by dots (use -1 to preserve trailing empty strings)</em>
<a class="jxr_linenumber" name="L2094" href="#L2094">2094</a> <strong class="jxr_keyword">var</strong> labels = hostname.split(<span class="jxr_string">"\\."</span>, -1);
-<a class="jxr_linenumber" name="L2095" href="#L2095">2095</a>
+<a class="jxr_linenumber" name="L2095" href="#L2095">2095</a>
<a class="jxr_linenumber" name="L2096" href="#L2096">2096</a> <em class="jxr_comment">// Must have at least one label</em>
<a class="jxr_linenumber" name="L2097" href="#L2097">2097</a> <strong class="jxr_keyword">if</strong> (labels.length == 0)
<a class="jxr_linenumber" name="L2098" href="#L2098">2098</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2099" href="#L2099">2099</a>
+<a class="jxr_linenumber" name="L2099" href="#L2099">2099</a>
<a class="jxr_linenumber" name="L2100" href="#L2100">2100</a> <em class="jxr_comment">// Check each label</em>
<a class="jxr_linenumber" name="L2101" href="#L2101">2101</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> label : labels) {
<a class="jxr_linenumber" name="L2102" href="#L2102">2102</a> <em class="jxr_comment">// Label cannot be empty</em>
<a class="jxr_linenumber" name="L2103" href="#L2103">2103</a> <strong class="jxr_keyword">if</strong> (label.isEmpty())
<a class="jxr_linenumber" name="L2104" href="#L2104">2104</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2105" href="#L2105">2105</a>
+<a class="jxr_linenumber" name="L2105" href="#L2105">2105</a>
<a class="jxr_linenumber" name="L2106" href="#L2106">2106</a> <em class="jxr_comment">// Label cannot exceed 63 characters</em>
<a class="jxr_linenumber" name="L2107" href="#L2107">2107</a> <strong class="jxr_keyword">if</strong> (label.length() > 63)
<a class="jxr_linenumber" name="L2108" href="#L2108">2108</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2109" href="#L2109">2109</a>
+<a class="jxr_linenumber" name="L2109" href="#L2109">2109</a>
<a class="jxr_linenumber" name="L2110" href="#L2110">2110</a> <em class="jxr_comment">// Label cannot start or end with hyphen</em>
<a class="jxr_linenumber" name="L2111" href="#L2111">2111</a> <strong class="jxr_keyword">if</strong> (label.startsWith(<span class="jxr_string">"-"</span>) || label.endsWith(<span class="jxr_string">"-"</span>))
<a class="jxr_linenumber" name="L2112" href="#L2112">2112</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2113" href="#L2113">2113</a>
+<a class="jxr_linenumber" name="L2113" href="#L2113">2113</a>
<a class="jxr_linenumber" name="L2114" href="#L2114">2114</a> <em class="jxr_comment">// Label can only contain letters, digits, and hyphens</em>
<a class="jxr_linenumber" name="L2115" href="#L2115">2115</a> <strong class="jxr_keyword">if</strong> (! label.matches(<span class="jxr_string">"^[a-zA-Z0-9-]+$"</span>))
<a class="jxr_linenumber" name="L2116" href="#L2116">2116</a> <strong class="jxr_keyword">return</strong> false;
<a class="jxr_linenumber" name="L2117" href="#L2117">2117</a> }
-<a class="jxr_linenumber" name="L2118" href="#L2118">2118</a>
+<a class="jxr_linenumber" name="L2118" href="#L2118">2118</a>
<a class="jxr_linenumber" name="L2119" href="#L2119">2119</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
<a class="jxr_linenumber" name="L2120" href="#L2120">2120</a> }
<a class="jxr_linenumber" name="L2121" href="#L2121">2121</a>
@@ -2147,10 +2147,10 @@
<a class="jxr_linenumber" name="L2139" href="#L2139">2139</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> wordCount(String str) {
<a class="jxr_linenumber" name="L2140" href="#L2140">2140</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
<a class="jxr_linenumber" name="L2141" href="#L2141">2141</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L2142" href="#L2142">2142</a>
+<a class="jxr_linenumber" name="L2142" href="#L2142">2142</a>
<a class="jxr_linenumber" name="L2143" href="#L2143">2143</a> <strong class="jxr_keyword">var</strong> count = 0;
<a class="jxr_linenumber" name="L2144" href="#L2144">2144</a> <strong class="jxr_keyword">var</strong> inWord = false;
-<a class="jxr_linenumber" name="L2145" href="#L2145">2145</a>
+<a class="jxr_linenumber" name="L2145" href="#L2145">2145</a>
<a class="jxr_linenumber" name="L2146" href="#L2146">2146</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
<a class="jxr_linenumber" name="L2147" href="#L2147">2147</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
<a class="jxr_linenumber" name="L2148" href="#L2148">2148</a> <strong class="jxr_keyword">if</strong> (Character.isLetterOrDigit(c) || c == '_') {
@@ -2162,7 +2162,7 @@
<a class="jxr_linenumber" name="L2154" href="#L2154">2154</a> inWord = false;
<a class="jxr_linenumber" name="L2155" href="#L2155">2155</a> }
<a class="jxr_linenumber" name="L2156" href="#L2156">2156</a> }
-<a class="jxr_linenumber" name="L2157" href="#L2157">2157</a>
+<a class="jxr_linenumber" name="L2157" href="#L2157">2157</a>
<a class="jxr_linenumber" name="L2158" href="#L2158">2158</a> <strong class="jxr_keyword">return</strong> count;
<a class="jxr_linenumber" name="L2159" href="#L2159">2159</a> }
<a class="jxr_linenumber" name="L2160" href="#L2160">2160</a>
@@ -2185,7 +2185,7 @@
<a class="jxr_linenumber" name="L2177" href="#L2177">2177</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> lineCount(String str) {
<a class="jxr_linenumber" name="L2178" href="#L2178">2178</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
<a class="jxr_linenumber" name="L2179" href="#L2179">2179</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L2180" href="#L2180">2180</a>
+<a class="jxr_linenumber" name="L2180" href="#L2180">2180</a>
<a class="jxr_linenumber" name="L2181" href="#L2181">2181</a> <strong class="jxr_keyword">var</strong> count = 1; <em class="jxr_comment">// At least one line</em>
<a class="jxr_linenumber" name="L2182" href="#L2182">2182</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
<a class="jxr_linenumber" name="L2183" href="#L2183">2183</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
@@ -2199,7 +2199,7 @@
<a class="jxr_linenumber" name="L2191" href="#L2191">2191</a> count++;
<a class="jxr_linenumber" name="L2192" href="#L2192">2192</a> }
<a class="jxr_linenumber" name="L2193" href="#L2193">2193</a> }
-<a class="jxr_linenumber" name="L2194" href="#L2194">2194</a>
+<a class="jxr_linenumber" name="L2194" href="#L2194">2194</a>
<a class="jxr_linenumber" name="L2195" href="#L2195">2195</a> <strong class="jxr_keyword">return</strong> count;
<a class="jxr_linenumber" name="L2196" href="#L2196">2196</a> }
<a class="jxr_linenumber" name="L2197" href="#L2197">2197</a>
@@ -2222,11 +2222,11 @@
<a class="jxr_linenumber" name="L2214" href="#L2214">2214</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> mostFrequentChar(String str) {
<a class="jxr_linenumber" name="L2215" href="#L2215">2215</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
<a class="jxr_linenumber" name="L2216" href="#L2216">2216</a> <strong class="jxr_keyword">return</strong> '\0';
-<a class="jxr_linenumber" name="L2217" href="#L2217">2217</a>
+<a class="jxr_linenumber" name="L2217" href="#L2217">2217</a>
<a class="jxr_linenumber" name="L2218" href="#L2218">2218</a> <strong class="jxr_keyword">var</strong> charCounts = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[Character.MAX_VALUE + 1];
<a class="jxr_linenumber" name="L2219" href="#L2219">2219</a> <strong class="jxr_keyword">var</strong> maxCount = 0;
<a class="jxr_linenumber" name="L2220" href="#L2220">2220</a> <strong class="jxr_keyword">var</strong> maxChar = '\0';
-<a class="jxr_linenumber" name="L2221" href="#L2221">2221</a>
+<a class="jxr_linenumber" name="L2221" href="#L2221">2221</a>
<a class="jxr_linenumber" name="L2222" href="#L2222">2222</a> <em class="jxr_comment">// Count occurrences of each character</em>
<a class="jxr_linenumber" name="L2223" href="#L2223">2223</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
<a class="jxr_linenumber" name="L2224" href="#L2224">2224</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
@@ -2236,7 +2236,7 @@
<a class="jxr_linenumber" name="L2228" href="#L2228">2228</a> maxChar = c;
<a class="jxr_linenumber" name="L2229" href="#L2229">2229</a> }
<a class="jxr_linenumber" name="L2230" href="#L2230">2230</a> }
-<a class="jxr_linenumber" name="L2231" href="#L2231">2231</a>
+<a class="jxr_linenumber" name="L2231" href="#L2231">2231</a>
<a class="jxr_linenumber" name="L2232" href="#L2232">2232</a> <strong class="jxr_keyword">return</strong> maxChar;
<a class="jxr_linenumber" name="L2233" href="#L2233">2233</a> }
<a class="jxr_linenumber" name="L2234" href="#L2234">2234</a>
@@ -2262,17 +2262,17 @@
<a class="jxr_linenumber" name="L2254" href="#L2254">2254</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">double</strong> entropy(String str) {
<a class="jxr_linenumber" name="L2255" href="#L2255">2255</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
<a class="jxr_linenumber" name="L2256" href="#L2256">2256</a> <strong class="jxr_keyword">return</strong> 0.0;
-<a class="jxr_linenumber" name="L2257" href="#L2257">2257</a>
+<a class="jxr_linenumber" name="L2257" href="#L2257">2257</a>
<a class="jxr_linenumber" name="L2258" href="#L2258">2258</a> <strong class="jxr_keyword">var</strong> length = str.length();
<a class="jxr_linenumber" name="L2259" href="#L2259">2259</a> <strong class="jxr_keyword">if</strong> (length == 0)
<a class="jxr_linenumber" name="L2260" href="#L2260">2260</a> <strong class="jxr_keyword">return</strong> 0.0;
-<a class="jxr_linenumber" name="L2261" href="#L2261">2261</a>
+<a class="jxr_linenumber" name="L2261" href="#L2261">2261</a>
<a class="jxr_linenumber" name="L2262" href="#L2262">2262</a> <em class="jxr_comment">// Count character frequencies</em>
<a class="jxr_linenumber" name="L2263" href="#L2263">2263</a> <strong class="jxr_keyword">var</strong> charCounts = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[Character.MAX_VALUE + 1];
<a class="jxr_linenumber" name="L2264" href="#L2264">2264</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < length; i++) {
<a class="jxr_linenumber" name="L2265" href="#L2265">2265</a> charCounts[str.charAt(i)]++;
<a class="jxr_linenumber" name="L2266" href="#L2266">2266</a> }
-<a class="jxr_linenumber" name="L2267" href="#L2267">2267</a>
+<a class="jxr_linenumber" name="L2267" href="#L2267">2267</a>
<a class="jxr_linenumber" name="L2268" href="#L2268">2268</a> <em class="jxr_comment">// Calculate entropy</em>
<a class="jxr_linenumber" name="L2269" href="#L2269">2269</a> <strong class="jxr_keyword">var</strong> entropy = 0.0;
<a class="jxr_linenumber" name="L2270" href="#L2270">2270</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> count : charCounts) {
@@ -2281,7 +2281,7 @@
<a class="jxr_linenumber" name="L2273" href="#L2273">2273</a> entropy -= probability * (Math.log(probability) / Math.log(2.0));
<a class="jxr_linenumber" name="L2274" href="#L2274">2274</a> }
<a class="jxr_linenumber" name="L2275" href="#L2275">2275</a> }
-<a class="jxr_linenumber" name="L2276" href="#L2276">2276</a>
+<a class="jxr_linenumber" name="L2276" href="#L2276">2276</a>
<a class="jxr_linenumber" name="L2277" href="#L2277">2277</a> <strong class="jxr_keyword">return</strong> entropy;
<a class="jxr_linenumber" name="L2278" href="#L2278">2278</a> }
<a class="jxr_linenumber" name="L2279" href="#L2279">2279</a>
@@ -2308,11 +2308,11 @@
<a class="jxr_linenumber" name="L2300" href="#L2300">2300</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">double</strong> readabilityScore(String str) {
<a class="jxr_linenumber" name="L2301" href="#L2301">2301</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
<a class="jxr_linenumber" name="L2302" href="#L2302">2302</a> <strong class="jxr_keyword">return</strong> 0.0;
-<a class="jxr_linenumber" name="L2303" href="#L2303">2303</a>
+<a class="jxr_linenumber" name="L2303" href="#L2303">2303</a>
<a class="jxr_linenumber" name="L2304" href="#L2304">2304</a> <strong class="jxr_keyword">var</strong> words = extractWords(str);
<a class="jxr_linenumber" name="L2305" href="#L2305">2305</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
<a class="jxr_linenumber" name="L2306" href="#L2306">2306</a> <strong class="jxr_keyword">return</strong> 0.0;
-<a class="jxr_linenumber" name="L2307" href="#L2307">2307</a>
+<a class="jxr_linenumber" name="L2307" href="#L2307">2307</a>
<a class="jxr_linenumber" name="L2308" href="#L2308">2308</a> <em class="jxr_comment">// Count sentences (ending with . ! ?)</em>
<a class="jxr_linenumber" name="L2309" href="#L2309">2309</a> <strong class="jxr_keyword">var</strong> sentenceCount = 0;
<a class="jxr_linenumber" name="L2310" href="#L2310">2310</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
@@ -2323,22 +2323,22 @@
<a class="jxr_linenumber" name="L2315" href="#L2315">2315</a> }
<a class="jxr_linenumber" name="L2316" href="#L2316">2316</a> <strong class="jxr_keyword">if</strong> (sentenceCount == 0)
<a class="jxr_linenumber" name="L2317" href="#L2317">2317</a> sentenceCount = 1; <em class="jxr_comment">// At least one sentence</em>
-<a class="jxr_linenumber" name="L2318" href="#L2318">2318</a>
+<a class="jxr_linenumber" name="L2318" href="#L2318">2318</a>
<a class="jxr_linenumber" name="L2319" href="#L2319">2319</a> <em class="jxr_comment">// Calculate average words per sentence</em>
<a class="jxr_linenumber" name="L2320" href="#L2320">2320</a> <strong class="jxr_keyword">var</strong> avgWordsPerSentence = (<strong class="jxr_keyword">double</strong>)words.size() / sentenceCount;
-<a class="jxr_linenumber" name="L2321" href="#L2321">2321</a>
+<a class="jxr_linenumber" name="L2321" href="#L2321">2321</a>
<a class="jxr_linenumber" name="L2322" href="#L2322">2322</a> <em class="jxr_comment">// Estimate average syllables per word (simplified: count vowel groups)</em>
<a class="jxr_linenumber" name="L2323" href="#L2323">2323</a> <strong class="jxr_keyword">var</strong> totalSyllables = 0;
<a class="jxr_linenumber" name="L2324" href="#L2324">2324</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> word : words) {
<a class="jxr_linenumber" name="L2325" href="#L2325">2325</a> totalSyllables += estimateSyllables(word);
<a class="jxr_linenumber" name="L2326" href="#L2326">2326</a> }
<a class="jxr_linenumber" name="L2327" href="#L2327">2327</a> <strong class="jxr_keyword">var</strong> avgSyllablesPerWord = (<strong class="jxr_keyword">double</strong>)totalSyllables / words.size();
-<a class="jxr_linenumber" name="L2328" href="#L2328">2328</a>
+<a class="jxr_linenumber" name="L2328" href="#L2328">2328</a>
<a class="jxr_linenumber" name="L2329" href="#L2329">2329</a> <em class="jxr_comment">// Simplified Flesch Reading Ease formula</em>
<a class="jxr_linenumber" name="L2330" href="#L2330">2330</a> <em class="jxr_comment">// Score = 206.835 - (1.015 * ASL) - (84.6 * ASW)</em>
<a class="jxr_linenumber" name="L2331" href="#L2331">2331</a> <em class="jxr_comment">// Where ASL = average sentence length (words), ASW = average syllables per word</em>
<a class="jxr_linenumber" name="L2332" href="#L2332">2332</a> <strong class="jxr_keyword">var</strong> score = 206.835 - (1.015 * avgWordsPerSentence) - (84.6 * avgSyllablesPerWord);
-<a class="jxr_linenumber" name="L2333" href="#L2333">2333</a>
+<a class="jxr_linenumber" name="L2333" href="#L2333">2333</a>
<a class="jxr_linenumber" name="L2334" href="#L2334">2334</a> <em class="jxr_comment">// Clamp to 0-100 range</em>
<a class="jxr_linenumber" name="L2335" href="#L2335">2335</a> <strong class="jxr_keyword">return</strong> Math.max(0.0, Math.min(100.0, score));
<a class="jxr_linenumber" name="L2336" href="#L2336">2336</a> }
@@ -2349,26 +2349,26 @@
<a class="jxr_linenumber" name="L2341" href="#L2341">2341</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> estimateSyllables(String word) {
<a class="jxr_linenumber" name="L2342" href="#L2342">2342</a> <strong class="jxr_keyword">if</strong> (word == <strong class="jxr_keyword">null</strong> || word.isEmpty())
<a class="jxr_linenumber" name="L2343" href="#L2343">2343</a> <strong class="jxr_keyword">return</strong> 1;
-<a class="jxr_linenumber" name="L2344" href="#L2344">2344</a>
+<a class="jxr_linenumber" name="L2344" href="#L2344">2344</a>
<a class="jxr_linenumber" name="L2345" href="#L2345">2345</a> <strong class="jxr_keyword">var</strong> lower = word.toLowerCase();
<a class="jxr_linenumber" name="L2346" href="#L2346">2346</a> <strong class="jxr_keyword">var</strong> count = 0;
<a class="jxr_linenumber" name="L2347" href="#L2347">2347</a> <strong class="jxr_keyword">var</strong> prevWasVowel = false;
-<a class="jxr_linenumber" name="L2348" href="#L2348">2348</a>
+<a class="jxr_linenumber" name="L2348" href="#L2348">2348</a>
<a class="jxr_linenumber" name="L2349" href="#L2349">2349</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < lower.length(); i++) {
<a class="jxr_linenumber" name="L2350" href="#L2350">2350</a> <strong class="jxr_keyword">var</strong> c = lower.charAt(i);
<a class="jxr_linenumber" name="L2351" href="#L2351">2351</a> <strong class="jxr_keyword">var</strong> isVowel = (c == 'a' || c == 'e' || c == 'i' || c == 'o' || c == 'u' || c == 'y');
-<a class="jxr_linenumber" name="L2352" href="#L2352">2352</a>
+<a class="jxr_linenumber" name="L2352" href="#L2352">2352</a>
<a class="jxr_linenumber" name="L2353" href="#L2353">2353</a> <strong class="jxr_keyword">if</strong> (isVowel && ! prevWasVowel) {
<a class="jxr_linenumber" name="L2354" href="#L2354">2354</a> count++;
<a class="jxr_linenumber" name="L2355" href="#L2355">2355</a> }
<a class="jxr_linenumber" name="L2356" href="#L2356">2356</a> prevWasVowel = isVowel;
<a class="jxr_linenumber" name="L2357" href="#L2357">2357</a> }
-<a class="jxr_linenumber" name="L2358" href="#L2358">2358</a>
+<a class="jxr_linenumber" name="L2358" href="#L2358">2358</a>
<a class="jxr_linenumber" name="L2359" href="#L2359">2359</a> <em class="jxr_comment">// Handle silent 'e' at the end</em>
<a class="jxr_linenumber" name="L2360" href="#L2360">2360</a> <strong class="jxr_keyword">if</strong> (lower.endsWith(<span class="jxr_string">"e"</span>) && count > 1) {
<a class="jxr_linenumber" name="L2361" href="#L2361">2361</a> count--;
<a class="jxr_linenumber" name="L2362" href="#L2362">2362</a> }
-<a class="jxr_linenumber" name="L2363" href="#L2363">2363</a>
+<a class="jxr_linenumber" name="L2363" href="#L2363">2363</a>
<a class="jxr_linenumber" name="L2364" href="#L2364">2364</a> <em class="jxr_comment">// At least one syllable</em>
<a class="jxr_linenumber" name="L2365" href="#L2365">2365</a> <strong class="jxr_keyword">return</strong> Math.max(1, count);
<a class="jxr_linenumber" name="L2366" href="#L2366">2366</a> }
@@ -2583,11 +2583,11 @@
<a class="jxr_linenumber" name="L2575" href="#L2575">2575</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
<a class="jxr_linenumber" name="L2576" href="#L2576">2576</a> <strong class="jxr_keyword">if</strong> (variables == <strong class="jxr_keyword">null</strong> || variables.isEmpty())
<a class="jxr_linenumber" name="L2577" href="#L2577">2577</a> <strong class="jxr_keyword">return</strong> template;
-<a class="jxr_linenumber" name="L2578" href="#L2578">2578</a>
+<a class="jxr_linenumber" name="L2578" href="#L2578">2578</a>
<a class="jxr_linenumber" name="L2579" href="#L2579">2579</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
<a class="jxr_linenumber" name="L2580" href="#L2580">2580</a> <strong class="jxr_keyword">var</strong> i = 0;
<a class="jxr_linenumber" name="L2581" href="#L2581">2581</a> <strong class="jxr_keyword">var</strong> length = template.length();
-<a class="jxr_linenumber" name="L2582" href="#L2582">2582</a>
+<a class="jxr_linenumber" name="L2582" href="#L2582">2582</a>
<a class="jxr_linenumber" name="L2583" href="#L2583">2583</a> <strong class="jxr_keyword">while</strong> (i < length) {
<a class="jxr_linenumber" name="L2584" href="#L2584">2584</a> <strong class="jxr_keyword">var</strong> dollarIndex = template.indexOf(<span class="jxr_string">"${"</span>, i);
<a class="jxr_linenumber" name="L2585" href="#L2585">2585</a> <strong class="jxr_keyword">if</strong> (dollarIndex == -1) {
@@ -2595,10 +2595,10 @@
<a class="jxr_linenumber" name="L2587" href="#L2587">2587</a> result.append(template.substring(i));
<a class="jxr_linenumber" name="L2588" href="#L2588">2588</a> <strong class="jxr_keyword">break</strong>;
<a class="jxr_linenumber" name="L2589" href="#L2589">2589</a> }
-<a class="jxr_linenumber" name="L2590" href="#L2590">2590</a>
+<a class="jxr_linenumber" name="L2590" href="#L2590">2590</a>
<a class="jxr_linenumber" name="L2591" href="#L2591">2591</a> <em class="jxr_comment">// Append text before the variable</em>
<a class="jxr_linenumber" name="L2592" href="#L2592">2592</a> result.append(template.substring(i, dollarIndex));
-<a class="jxr_linenumber" name="L2593" href="#L2593">2593</a>
+<a class="jxr_linenumber" name="L2593" href="#L2593">2593</a>
<a class="jxr_linenumber" name="L2594" href="#L2594">2594</a> <em class="jxr_comment">// Find the closing brace</em>
<a class="jxr_linenumber" name="L2595" href="#L2595">2595</a> <strong class="jxr_keyword">var</strong> braceIndex = template.indexOf('}', dollarIndex + 2);
<a class="jxr_linenumber" name="L2596" href="#L2596">2596</a> <strong class="jxr_keyword">if</strong> (braceIndex == -1) {
@@ -2606,11 +2606,11 @@
<a class="jxr_linenumber" name="L2598" href="#L2598">2598</a> result.append(template.substring(dollarIndex));
<a class="jxr_linenumber" name="L2599" href="#L2599">2599</a> <strong class="jxr_keyword">break</strong>;
<a class="jxr_linenumber" name="L2600" href="#L2600">2600</a> }
-<a class="jxr_linenumber" name="L2601" href="#L2601">2601</a>
+<a class="jxr_linenumber" name="L2601" href="#L2601">2601</a>
<a class="jxr_linenumber" name="L2602" href="#L2602">2602</a> <em class="jxr_comment">// Extract variable name</em>
<a class="jxr_linenumber" name="L2603" href="#L2603">2603</a> <strong class="jxr_keyword">var</strong> varName = template.substring(dollarIndex + 2, braceIndex);
<a class="jxr_linenumber" name="L2604" href="#L2604">2604</a> <strong class="jxr_keyword">var</strong> value = variables.get(varName);
-<a class="jxr_linenumber" name="L2605" href="#L2605">2605</a>
+<a class="jxr_linenumber" name="L2605" href="#L2605">2605</a>
<a class="jxr_linenumber" name="L2606" href="#L2606">2606</a> <strong class="jxr_keyword">if</strong> (variables.containsKey(varName)) {
<a class="jxr_linenumber" name="L2607" href="#L2607">2607</a> <em class="jxr_comment">// Variable exists in map (even if null)</em>
<a class="jxr_linenumber" name="L2608" href="#L2608">2608</a> result.append(value != <strong class="jxr_keyword">null</strong> ? value.toString() : <span class="jxr_string">"null"</span>);
@@ -2618,10 +2618,10 @@
<a class="jxr_linenumber" name="L2610" href="#L2610">2610</a> <em class="jxr_comment">// Variable not found, keep the original placeholder</em>
<a class="jxr_linenumber" name="L2611" href="#L2611">2611</a> result.append(<span class="jxr_string">"${"</span>).append(varName).append(<span class="jxr_string">"}"</span>);
<a class="jxr_linenumber" name="L2612" href="#L2612">2612</a> }
-<a class="jxr_linenumber" name="L2613" href="#L2613">2613</a>
+<a class="jxr_linenumber" name="L2613" href="#L2613">2613</a>
<a class="jxr_linenumber" name="L2614" href="#L2614">2614</a> i = braceIndex + 1;
<a class="jxr_linenumber" name="L2615" href="#L2615">2615</a> }
-<a class="jxr_linenumber" name="L2616" href="#L2616">2616</a>
+<a class="jxr_linenumber" name="L2616" href="#L2616">2616</a>
<a class="jxr_linenumber" name="L2617" href="#L2617">2617</a> <strong class="jxr_keyword">return</strong> result.toString();
<a class="jxr_linenumber" name="L2618" href="#L2618">2618</a> }
<a class="jxr_linenumber" name="L2619" href="#L2619">2619</a>
@@ -2649,15 +2649,15 @@
<a class="jxr_linenumber" name="L2641" href="#L2641">2641</a> <strong class="jxr_keyword">return</strong> word;
<a class="jxr_linenumber" name="L2642" href="#L2642">2642</a> <strong class="jxr_keyword">if</strong> (count == 1)
<a class="jxr_linenumber" name="L2643" href="#L2643">2643</a> <strong class="jxr_keyword">return</strong> word;
-<a class="jxr_linenumber" name="L2644" href="#L2644">2644</a>
+<a class="jxr_linenumber" name="L2644" href="#L2644">2644</a>
<a class="jxr_linenumber" name="L2645" href="#L2645">2645</a> <strong class="jxr_keyword">var</strong> lower = word.toLowerCase();
<a class="jxr_linenumber" name="L2646" href="#L2646">2646</a> <strong class="jxr_keyword">var</strong> length = word.length();
-<a class="jxr_linenumber" name="L2647" href="#L2647">2647</a>
+<a class="jxr_linenumber" name="L2647" href="#L2647">2647</a>
<a class="jxr_linenumber" name="L2648" href="#L2648">2648</a> <em class="jxr_comment">// Words ending in s, x, z, ch, sh -> add "es"</em>
<a class="jxr_linenumber" name="L2649" href="#L2649">2649</a> <strong class="jxr_keyword">if</strong> (lower.endsWith(<span class="jxr_string">"s"</span>) || lower.endsWith(<span class="jxr_string">"x"</span>) || lower.endsWith(<span class="jxr_string">"z"</span>) || lower.endsWith(<span class="jxr_string">"ch"</span>) || lower.endsWith(<span class="jxr_string">"sh"</span>)) {
<a class="jxr_linenumber" name="L2650" href="#L2650">2650</a> <strong class="jxr_keyword">return</strong> word + <span class="jxr_string">"es"</span>;
<a class="jxr_linenumber" name="L2651" href="#L2651">2651</a> }
-<a class="jxr_linenumber" name="L2652" href="#L2652">2652</a>
+<a class="jxr_linenumber" name="L2652" href="#L2652">2652</a>
<a class="jxr_linenumber" name="L2653" href="#L2653">2653</a> <em class="jxr_comment">// Words ending in "y" preceded by a consonant -> replace "y" with "ies"</em>
<a class="jxr_linenumber" name="L2654" href="#L2654">2654</a> <strong class="jxr_keyword">if</strong> (length > 1 && lower.endsWith(<span class="jxr_string">"y"</span>)) {
<a class="jxr_linenumber" name="L2655" href="#L2655">2655</a> <strong class="jxr_keyword">var</strong> secondLast = lower.charAt(length - 2);
@@ -2665,7 +2665,7 @@
<a class="jxr_linenumber" name="L2657" href="#L2657">2657</a> <strong class="jxr_keyword">return</strong> word.substring(0, length - 1) + <span class="jxr_string">"ies"</span>;
<a class="jxr_linenumber" name="L2658" href="#L2658">2658</a> }
<a class="jxr_linenumber" name="L2659" href="#L2659">2659</a> }
-<a class="jxr_linenumber" name="L2660" href="#L2660">2660</a>
+<a class="jxr_linenumber" name="L2660" href="#L2660">2660</a>
<a class="jxr_linenumber" name="L2661" href="#L2661">2661</a> <em class="jxr_comment">// Words ending in "f" or "fe" -> replace with "ves" (basic rule)</em>
<a class="jxr_linenumber" name="L2662" href="#L2662">2662</a> <strong class="jxr_keyword">if</strong> (lower.endsWith(<span class="jxr_string">"f"</span>)) {
<a class="jxr_linenumber" name="L2663" href="#L2663">2663</a> <strong class="jxr_keyword">return</strong> word.substring(0, length - 1) + <span class="jxr_string">"ves"</span>;
@@ -2673,7 +2673,7 @@
<a class="jxr_linenumber" name="L2665" href="#L2665">2665</a> <strong class="jxr_keyword">if</strong> (lower.endsWith(<span class="jxr_string">"fe"</span>)) {
<a class="jxr_linenumber" name="L2666" href="#L2666">2666</a> <strong class="jxr_keyword">return</strong> word.substring(0, length - 2) + <span class="jxr_string">"ves"</span>;
<a class="jxr_linenumber" name="L2667" href="#L2667">2667</a> }
-<a class="jxr_linenumber" name="L2668" href="#L2668">2668</a>
+<a class="jxr_linenumber" name="L2668" href="#L2668">2668</a>
<a class="jxr_linenumber" name="L2669" href="#L2669">2669</a> <em class="jxr_comment">// Default: add "s"</em>
<a class="jxr_linenumber" name="L2670" href="#L2670">2670</a> <strong class="jxr_keyword">return</strong> word + <span class="jxr_string">"s"</span>;
<a class="jxr_linenumber" name="L2671" href="#L2671">2671</a> }
@@ -2697,7 +2697,7 @@
<a class="jxr_linenumber" name="L2689" href="#L2689">2689</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String ordinal(<strong class="jxr_keyword">int</strong> number) {
<a class="jxr_linenumber" name="L2690" href="#L2690">2690</a> <strong class="jxr_keyword">var</strong> abs = Math.abs(number);
<a class="jxr_linenumber" name="L2691" href="#L2691">2691</a> <strong class="jxr_keyword">var</strong> suffix = <span class="jxr_string">"th"</span>;
-<a class="jxr_linenumber" name="L2692" href="#L2692">2692</a>
+<a class="jxr_linenumber" name="L2692" href="#L2692">2692</a>
<a class="jxr_linenumber" name="L2693" href="#L2693">2693</a> <em class="jxr_comment">// Special cases for 11, 12, 13 (all use "th")</em>
<a class="jxr_linenumber" name="L2694" href="#L2694">2694</a> <strong class="jxr_keyword">if</strong> (abs % 100 != 11 && abs % 100 != 12 && abs % 100 != 13) {
<a class="jxr_linenumber" name="L2695" href="#L2695">2695</a> <strong class="jxr_keyword">var</strong> lastDigit = abs % 10;
@@ -2708,7 +2708,7 @@
<a class="jxr_linenumber" name="L2700" href="#L2700">2700</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (lastDigit == 3)
<a class="jxr_linenumber" name="L2701" href="#L2701">2701</a> suffix = <span class="jxr_string">"rd"</span>;
<a class="jxr_linenumber" name="L2702" href="#L2702">2702</a> }
-<a class="jxr_linenumber" name="L2703" href="#L2703">2703</a>
+<a class="jxr_linenumber" name="L2703" href="#L2703">2703</a>
<a class="jxr_linenumber" name="L2704" href="#L2704">2704</a> <strong class="jxr_keyword">return</strong> number + suffix;
<a class="jxr_linenumber" name="L2705" href="#L2705">2705</a> }
<a class="jxr_linenumber" name="L2706" href="#L2706">2706</a>
@@ -2990,16 +2990,16 @@
<a class="jxr_linenumber" name="L2982" href="#L2982">2982</a> <strong class="jxr_keyword">return</strong> -1;
<a class="jxr_linenumber" name="L2983" href="#L2983">2983</a> <strong class="jxr_keyword">if</strong> (str2 == <strong class="jxr_keyword">null</strong>)
<a class="jxr_linenumber" name="L2984" href="#L2984">2984</a> <strong class="jxr_keyword">return</strong> 1;
-<a class="jxr_linenumber" name="L2985" href="#L2985">2985</a>
+<a class="jxr_linenumber" name="L2985" href="#L2985">2985</a>
<a class="jxr_linenumber" name="L2986" href="#L2986">2986</a> <strong class="jxr_keyword">var</strong> len1 = str1.length();
<a class="jxr_linenumber" name="L2987" href="#L2987">2987</a> <strong class="jxr_keyword">var</strong> len2 = str2.length();
<a class="jxr_linenumber" name="L2988" href="#L2988">2988</a> <strong class="jxr_keyword">var</strong> i1 = 0;
<a class="jxr_linenumber" name="L2989" href="#L2989">2989</a> <strong class="jxr_keyword">var</strong> i2 = 0;
-<a class="jxr_linenumber" name="L2990" href="#L2990">2990</a>
+<a class="jxr_linenumber" name="L2990" href="#L2990">2990</a>
<a class="jxr_linenumber" name="L2991" href="#L2991">2991</a> <strong class="jxr_keyword">while</strong> (i1 < len1 && i2 < len2) {
<a class="jxr_linenumber" name="L2992" href="#L2992">2992</a> <strong class="jxr_keyword">var</strong> c1 = str1.charAt(i1);
<a class="jxr_linenumber" name="L2993" href="#L2993">2993</a> <strong class="jxr_keyword">var</strong> c2 = str2.charAt(i2);
-<a class="jxr_linenumber" name="L2994" href="#L2994">2994</a>
+<a class="jxr_linenumber" name="L2994" href="#L2994">2994</a>
<a class="jxr_linenumber" name="L2995" href="#L2995">2995</a> <em class="jxr_comment">// If both are digits, compare numerically</em>
<a class="jxr_linenumber" name="L2996" href="#L2996">2996</a> <strong class="jxr_keyword">if</strong> (Character.isDigit(c1) && Character.isDigit(c2)) {
<a class="jxr_linenumber" name="L2997" href="#L2997">2997</a> <em class="jxr_comment">// Skip leading zeros</em>
@@ -3007,7 +3007,7 @@
<a class="jxr_linenumber" name="L2999" href="#L2999">2999</a> i1++;
<a class="jxr_linenumber" name="L3000" href="#L3000">3000</a> <strong class="jxr_keyword">while</strong> (i2 < len2 && str2.charAt(i2) == '0')
<a class="jxr_linenumber" name="L3001" href="#L3001">3001</a> i2++;
-<a class="jxr_linenumber" name="L3002" href="#L3002">3002</a>
+<a class="jxr_linenumber" name="L3002" href="#L3002">3002</a>
<a class="jxr_linenumber" name="L3003" href="#L3003">3003</a> <em class="jxr_comment">// Find end of number sequences</em>
<a class="jxr_linenumber" name="L3004" href="#L3004">3004</a> <strong class="jxr_keyword">var</strong> end1 = i1;
<a class="jxr_linenumber" name="L3005" href="#L3005">3005</a> <strong class="jxr_keyword">var</strong> end2 = i2;
@@ -3015,13 +3015,13 @@
<a class="jxr_linenumber" name="L3007" href="#L3007">3007</a> end1++;
<a class="jxr_linenumber" name="L3008" href="#L3008">3008</a> <strong class="jxr_keyword">while</strong> (end2 < len2 && Character.isDigit(str2.charAt(end2)))
<a class="jxr_linenumber" name="L3009" href="#L3009">3009</a> end2++;
-<a class="jxr_linenumber" name="L3010" href="#L3010">3010</a>
+<a class="jxr_linenumber" name="L3010" href="#L3010">3010</a>
<a class="jxr_linenumber" name="L3011" href="#L3011">3011</a> <em class="jxr_comment">// Compare lengths first (longer number is larger)</em>
<a class="jxr_linenumber" name="L3012" href="#L3012">3012</a> <strong class="jxr_keyword">var</strong> lenNum1 = end1 - i1;
<a class="jxr_linenumber" name="L3013" href="#L3013">3013</a> <strong class="jxr_keyword">var</strong> lenNum2 = end2 - i2;
<a class="jxr_linenumber" name="L3014" href="#L3014">3014</a> <strong class="jxr_keyword">if</strong> (lenNum1 != lenNum2)
<a class="jxr_linenumber" name="L3015" href="#L3015">3015</a> <strong class="jxr_keyword">return</strong> lenNum1 - lenNum2;
-<a class="jxr_linenumber" name="L3016" href="#L3016">3016</a>
+<a class="jxr_linenumber" name="L3016" href="#L3016">3016</a>
<a class="jxr_linenumber" name="L3017" href="#L3017">3017</a> <em class="jxr_comment">// Same length, compare digit by digit</em>
<a class="jxr_linenumber" name="L3018" href="#L3018">3018</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 0; j < lenNum1; j++) {
<a class="jxr_linenumber" name="L3019" href="#L3019">3019</a> <strong class="jxr_keyword">var</strong> d1 = str1.charAt(i1 + j);
@@ -3029,7 +3029,7 @@
<a class="jxr_linenumber" name="L3021" href="#L3021">3021</a> <strong class="jxr_keyword">if</strong> (d1 != d2)
<a class="jxr_linenumber" name="L3022" href="#L3022">3022</a> <strong class="jxr_keyword">return</strong> d1 - d2;
<a class="jxr_linenumber" name="L3023" href="#L3023">3023</a> }
-<a class="jxr_linenumber" name="L3024" href="#L3024">3024</a>
+<a class="jxr_linenumber" name="L3024" href="#L3024">3024</a>
<a class="jxr_linenumber" name="L3025" href="#L3025">3025</a> i1 = end1;
<a class="jxr_linenumber" name="L3026" href="#L3026">3026</a> i2 = end2;
<a class="jxr_linenumber" name="L3027" href="#L3027">3027</a> } <strong class="jxr_keyword">else</strong> {
@@ -3041,7 +3041,7 @@
<a class="jxr_linenumber" name="L3033" href="#L3033">3033</a> i2++;
<a class="jxr_linenumber" name="L3034" href="#L3034">3034</a> }
<a class="jxr_linenumber" name="L3035" href="#L3035">3035</a> }
-<a class="jxr_linenumber" name="L3036" href="#L3036">3036</a>
+<a class="jxr_linenumber" name="L3036" href="#L3036">3036</a>
<a class="jxr_linenumber" name="L3037" href="#L3037">3037</a> <strong class="jxr_keyword">return</strong> len1 - len2;
<a class="jxr_linenumber" name="L3038" href="#L3038">3038</a> }
<a class="jxr_linenumber" name="L3039" href="#L3039">3039</a>
@@ -3067,18 +3067,18 @@
<a class="jxr_linenumber" name="L3059" href="#L3059">3059</a> str1 = <span class="jxr_string">""</span>;
<a class="jxr_linenumber" name="L3060" href="#L3060">3060</a> <strong class="jxr_keyword">if</strong> (str2 == <strong class="jxr_keyword">null</strong>)
<a class="jxr_linenumber" name="L3061" href="#L3061">3061</a> str2 = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L3062" href="#L3062">3062</a>
+<a class="jxr_linenumber" name="L3062" href="#L3062">3062</a>
<a class="jxr_linenumber" name="L3063" href="#L3063">3063</a> <strong class="jxr_keyword">var</strong> len1 = str1.length();
<a class="jxr_linenumber" name="L3064" href="#L3064">3064</a> <strong class="jxr_keyword">var</strong> len2 = str2.length();
-<a class="jxr_linenumber" name="L3065" href="#L3065">3065</a>
+<a class="jxr_linenumber" name="L3065" href="#L3065">3065</a>
<a class="jxr_linenumber" name="L3066" href="#L3066">3066</a> <em class="jxr_comment">// Use dynamic programming with optimized space (only need previous row)</em>
<a class="jxr_linenumber" name="L3067" href="#L3067">3067</a> <strong class="jxr_keyword">var</strong> prev = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[len2 + 1];
<a class="jxr_linenumber" name="L3068" href="#L3068">3068</a> <strong class="jxr_keyword">var</strong> curr = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[len2 + 1];
-<a class="jxr_linenumber" name="L3069" href="#L3069">3069</a>
+<a class="jxr_linenumber" name="L3069" href="#L3069">3069</a>
<a class="jxr_linenumber" name="L3070" href="#L3070">3070</a> <em class="jxr_comment">// Initialize first row</em>
<a class="jxr_linenumber" name="L3071" href="#L3071">3071</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 0; j <= len2; j++)
<a class="jxr_linenumber" name="L3072" href="#L3072">3072</a> prev[j] = j;
-<a class="jxr_linenumber" name="L3073" href="#L3073">3073</a>
+<a class="jxr_linenumber" name="L3073" href="#L3073">3073</a>
<a class="jxr_linenumber" name="L3074" href="#L3074">3074</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 1; i <= len1; i++) {
<a class="jxr_linenumber" name="L3075" href="#L3075">3075</a> curr[0] = i;
<a class="jxr_linenumber" name="L3076" href="#L3076">3076</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 1; j <= len2; j++) {
@@ -3093,7 +3093,7 @@
<a class="jxr_linenumber" name="L3085" href="#L3085">3085</a> prev = curr;
<a class="jxr_linenumber" name="L3086" href="#L3086">3086</a> curr = temp;
<a class="jxr_linenumber" name="L3087" href="#L3087">3087</a> }
-<a class="jxr_linenumber" name="L3088" href="#L3088">3088</a>
+<a class="jxr_linenumber" name="L3088" href="#L3088">3088</a>
<a class="jxr_linenumber" name="L3089" href="#L3089">3089</a> <strong class="jxr_keyword">return</strong> prev[len2];
<a class="jxr_linenumber" name="L3090" href="#L3090">3090</a> }
<a class="jxr_linenumber" name="L3091" href="#L3091">3091</a>
@@ -3119,14 +3119,14 @@
<a class="jxr_linenumber" name="L3111" href="#L3111">3111</a> str1 = <span class="jxr_string">""</span>;
<a class="jxr_linenumber" name="L3112" href="#L3112">3112</a> <strong class="jxr_keyword">if</strong> (str2 == <strong class="jxr_keyword">null</strong>)
<a class="jxr_linenumber" name="L3113" href="#L3113">3113</a> str2 = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L3114" href="#L3114">3114</a>
+<a class="jxr_linenumber" name="L3114" href="#L3114">3114</a>
<a class="jxr_linenumber" name="L3115" href="#L3115">3115</a> <strong class="jxr_keyword">if</strong> (str1.equals(str2))
<a class="jxr_linenumber" name="L3116" href="#L3116">3116</a> <strong class="jxr_keyword">return</strong> 1.0;
-<a class="jxr_linenumber" name="L3117" href="#L3117">3117</a>
+<a class="jxr_linenumber" name="L3117" href="#L3117">3117</a>
<a class="jxr_linenumber" name="L3118" href="#L3118">3118</a> <strong class="jxr_keyword">var</strong> maxLen = Math.max(str1.length(), str2.length());
<a class="jxr_linenumber" name="L3119" href="#L3119">3119</a> <strong class="jxr_keyword">if</strong> (maxLen == 0)
<a class="jxr_linenumber" name="L3120" href="#L3120">3120</a> <strong class="jxr_keyword">return</strong> 1.0;
-<a class="jxr_linenumber" name="L3121" href="#L3121">3121</a>
+<a class="jxr_linenumber" name="L3121" href="#L3121">3121</a>
<a class="jxr_linenumber" name="L3122" href="#L3122">3122</a> <strong class="jxr_keyword">var</strong> distance = levenshteinDistance(str1, str2);
<a class="jxr_linenumber" name="L3123" href="#L3123">3123</a> <strong class="jxr_keyword">return</strong> 1.0 - ((<strong class="jxr_keyword">double</strong>)distance / maxLen);
<a class="jxr_linenumber" name="L3124" href="#L3124">3124</a> }
@@ -3667,7 +3667,7 @@
<a class="jxr_linenumber" name="L3659" href="#L3659">3659</a> <em class="jxr_javadoccomment"> */</em>
<a class="jxr_linenumber" name="L3660" href="#L3660">3660</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> parseIntWithSuffix(String s) {
<a class="jxr_linenumber" name="L3661" href="#L3661">3661</a> assertArgNotNull(<span class="jxr_string">"s"</span>, s);
-<a class="jxr_linenumber" name="L3662" href="#L3662">3662</a> <strong class="jxr_keyword">var</strong> m = multiplier(s);
+<a class="jxr_linenumber" name="L3662" href="#L3662">3662</a> <strong class="jxr_keyword">var</strong> m = multiplierInt(s);
<a class="jxr_linenumber" name="L3663" href="#L3663">3663</a> <strong class="jxr_keyword">if</strong> (m == 1)
<a class="jxr_linenumber" name="L3664" href="#L3664">3664</a> <strong class="jxr_keyword">return</strong> Integer.decode(s);
<a class="jxr_linenumber" name="L3665" href="#L3665">3665</a> <strong class="jxr_keyword">return</strong> Integer.decode(s.substring(0, s.length() - 1).trim()) * m; <em class="jxr_comment">// NOSONAR - NPE not possible here.</em>
@@ -3749,7 +3749,7 @@
<a class="jxr_linenumber" name="L3741" href="#L3741">3741</a> <em class="jxr_javadoccomment"> */</em>
<a class="jxr_linenumber" name="L3742" href="#L3742">3742</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> parseLongWithSuffix(String s) {
<a class="jxr_linenumber" name="L3743" href="#L3743">3743</a> assertArgNotNull(<span class="jxr_string">"s"</span>, s);
-<a class="jxr_linenumber" name="L3744" href="#L3744">3744</a> <strong class="jxr_keyword">var</strong> m = multiplier2(s);
+<a class="jxr_linenumber" name="L3744" href="#L3744">3744</a> <strong class="jxr_keyword">var</strong> m = multiplierLong(s);
<a class="jxr_linenumber" name="L3745" href="#L3745">3745</a> <strong class="jxr_keyword">if</strong> (m == 1)
<a class="jxr_linenumber" name="L3746" href="#L3746">3746</a> <strong class="jxr_keyword">return</strong> Long.decode(s);
<a class="jxr_linenumber" name="L3747" href="#L3747">3747</a> <strong class="jxr_keyword">return</strong> Long.decode(s.substring(0, s.length() - 1).trim()) * m; <em class="jxr_comment">// NOSONAR - NPE not possible here.</em>
@@ -4257,14 +4257,14 @@
<a class="jxr_linenumber" name="L4249" href="#L4249">4249</a> <em class="jxr_comment">// Split into words first, then combine words that fit</em>
<a class="jxr_linenumber" name="L4250" href="#L4250">4250</a> <strong class="jxr_keyword">var</strong> words = line.split(<span class="jxr_string">" +"</span>); <em class="jxr_comment">// Split on one or more spaces</em>
<a class="jxr_linenumber" name="L4251" href="#L4251">4251</a> <strong class="jxr_keyword">var</strong> currentLine = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L4252" href="#L4252">4252</a>
+<a class="jxr_linenumber" name="L4252" href="#L4252">4252</a>
<a class="jxr_linenumber" name="L4253" href="#L4253">4253</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> word : words) {
<a class="jxr_linenumber" name="L4254" href="#L4254">4254</a> <strong class="jxr_keyword">if</strong> (word.isEmpty())
<a class="jxr_linenumber" name="L4255" href="#L4255">4255</a> <strong class="jxr_keyword">continue</strong>;
-<a class="jxr_linenumber" name="L4256" href="#L4256">4256</a>
+<a class="jxr_linenumber" name="L4256" href="#L4256">4256</a>
<a class="jxr_linenumber" name="L4257" href="#L4257">4257</a> <strong class="jxr_keyword">var</strong> wordLength = word.length();
<a class="jxr_linenumber" name="L4258" href="#L4258">4258</a> <strong class="jxr_keyword">var</strong> currentLength = currentLine.length();
-<a class="jxr_linenumber" name="L4259" href="#L4259">4259</a>
+<a class="jxr_linenumber" name="L4259" href="#L4259">4259</a>
<a class="jxr_linenumber" name="L4260" href="#L4260">4260</a> <strong class="jxr_keyword">if</strong> (currentLength == 0) {
<a class="jxr_linenumber" name="L4261" href="#L4261">4261</a> <em class="jxr_comment">// First word on line</em>
<a class="jxr_linenumber" name="L4262" href="#L4262">4262</a> <em class="jxr_comment">// Only break single words if there are multiple words in the input</em>
@@ -4322,7 +4322,7 @@
<a class="jxr_linenumber" name="L4314" href="#L4314">4314</a> }
<a class="jxr_linenumber" name="L4315" href="#L4315">4315</a> }
<a class="jxr_linenumber" name="L4316" href="#L4316">4316</a> }
-<a class="jxr_linenumber" name="L4317" href="#L4317">4317</a>
+<a class="jxr_linenumber" name="L4317" href="#L4317">4317</a>
<a class="jxr_linenumber" name="L4318" href="#L4318">4318</a> <em class="jxr_comment">// Append any remaining line</em>
<a class="jxr_linenumber" name="L4319" href="#L4319">4319</a> <strong class="jxr_keyword">if</strong> (currentLine.length() > 0) {
<a class="jxr_linenumber" name="L4320" href="#L4320">4320</a> <strong class="jxr_keyword">if</strong> (result.length() > 0)
@@ -4370,3090 +4370,3222 @@
<a class="jxr_linenumber" name="L4362" href="#L4362">4362</a> <em class="jxr_javadoccomment"> * For un-numbered sequential placeholders <js>"{}"</js>, use {@link #format(String, Object...)} instead.</em>
<a class="jxr_linenumber" name="L4363" href="#L4363">4363</a> <em class="jxr_javadoccomment"> *</em>
<a class="jxr_linenumber" name="L4364" href="#L4364">4364</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4365" href="#L4365">4365</a> <em class="jxr_javadoccomment"> * Nested variables are supported in both the input string and map values.</em>
-<a class="jxr_linenumber" name="L4366" href="#L4366">4366</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4367" href="#L4367">4367</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4368" href="#L4368">4368</a> <em class="jxr_javadoccomment"> * If the map does not contain the specified value, the variable is not replaced.</em>
-<a class="jxr_linenumber" name="L4369" href="#L4369">4369</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4370" href="#L4370">4370</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4371" href="#L4371">4371</a> <em class="jxr_javadoccomment"> * <jk>null</jk> values in the map are treated as blank strings.</em>
-<a class="jxr_linenumber" name="L4372" href="#L4372">4372</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4373" href="#L4373">4373</a> <em class="jxr_javadoccomment"> * @param s The string containing variables to replace.</em>
-<a class="jxr_linenumber" name="L4374" href="#L4374">4374</a> <em class="jxr_javadoccomment"> * @param m The map containing the variable values.</em>
-<a class="jxr_linenumber" name="L4375" href="#L4375">4375</a> <em class="jxr_javadoccomment"> * @return The new string with variables replaced, or the original string if it didn't have variables in it.</em>
-<a class="jxr_linenumber" name="L4376" href="#L4376">4376</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4377" href="#L4377">4377</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String formatNamed(String s, Map<String,Object> m) {
-<a class="jxr_linenumber" name="L4378" href="#L4378">4378</a>
-<a class="jxr_linenumber" name="L4379" href="#L4379">4379</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4380" href="#L4380">4380</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4381" href="#L4381">4381</a>
-<a class="jxr_linenumber" name="L4382" href="#L4382">4382</a> <strong class="jxr_keyword">if</strong> (m == <strong class="jxr_keyword">null</strong> || m.isEmpty() || s.indexOf('{') == -1)
-<a class="jxr_linenumber" name="L4383" href="#L4383">4383</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L4384" href="#L4384">4384</a>
-<a class="jxr_linenumber" name="L4385" href="#L4385">4385</a> <em class="jxr_comment">// S1: Not in variable, looking for '{'</em>
-<a class="jxr_linenumber" name="L4386" href="#L4386">4386</a> <em class="jxr_comment">// S2: Found '{', Looking for '}'</em>
-<a class="jxr_linenumber" name="L4387" href="#L4387">4387</a>
-<a class="jxr_linenumber" name="L4388" href="#L4388">4388</a> <strong class="jxr_keyword">var</strong> state = S1;
-<a class="jxr_linenumber" name="L4389" href="#L4389">4389</a> <strong class="jxr_keyword">var</strong> hasInternalVar = false;
-<a class="jxr_linenumber" name="L4390" href="#L4390">4390</a> <strong class="jxr_keyword">var</strong> x = 0;
-<a class="jxr_linenumber" name="L4391" href="#L4391">4391</a> <strong class="jxr_keyword">var</strong> depth = 0;
-<a class="jxr_linenumber" name="L4392" href="#L4392">4392</a> <strong class="jxr_keyword">var</strong> length = s.length();
-<a class="jxr_linenumber" name="L4393" href="#L4393">4393</a> <strong class="jxr_keyword">var</strong> out = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L4394" href="#L4394">4394</a>
-<a class="jxr_linenumber" name="L4395" href="#L4395">4395</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < length; i++) {
-<a class="jxr_linenumber" name="L4396" href="#L4396">4396</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L4397" href="#L4397">4397</a> <strong class="jxr_keyword">if</strong> (state == S1) {
-<a class="jxr_linenumber" name="L4398" href="#L4398">4398</a> <strong class="jxr_keyword">if</strong> (c == '{') {
-<a class="jxr_linenumber" name="L4399" href="#L4399">4399</a> state = S2;
-<a class="jxr_linenumber" name="L4400" href="#L4400">4400</a> x = i;
-<a class="jxr_linenumber" name="L4401" href="#L4401">4401</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4402" href="#L4402">4402</a> out.append(c);
-<a class="jxr_linenumber" name="L4403" href="#L4403">4403</a> }
-<a class="jxr_linenumber" name="L4404" href="#L4404">4404</a> } <strong class="jxr_keyword">else</strong> <em class="jxr_comment">/* state == S2 */</em> {
-<a class="jxr_linenumber" name="L4405" href="#L4405">4405</a> <strong class="jxr_keyword">if</strong> (c == '{') {
-<a class="jxr_linenumber" name="L4406" href="#L4406">4406</a> depth++;
-<a class="jxr_linenumber" name="L4407" href="#L4407">4407</a> hasInternalVar = <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L4408" href="#L4408">4408</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '}') {
-<a class="jxr_linenumber" name="L4409" href="#L4409">4409</a> <strong class="jxr_keyword">if</strong> (depth > 0) {
-<a class="jxr_linenumber" name="L4410" href="#L4410">4410</a> depth--;
-<a class="jxr_linenumber" name="L4411" href="#L4411">4411</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4412" href="#L4412">4412</a> <strong class="jxr_keyword">var</strong> key = s.substring(x + 1, i);
-<a class="jxr_linenumber" name="L4413" href="#L4413">4413</a> key = (hasInternalVar ? formatNamed(key, m) : key);
-<a class="jxr_linenumber" name="L4414" href="#L4414">4414</a> hasInternalVar = false;
-<a class="jxr_linenumber" name="L4415" href="#L4415">4415</a> <em class="jxr_comment">// JUNEAU-248: Check if key exists in map by attempting to get it</em>
-<a class="jxr_linenumber" name="L4416" href="#L4416">4416</a> <em class="jxr_comment">// For regular maps: use containsKey() OR nn(get()) check</em>
-<a class="jxr_linenumber" name="L4417" href="#L4417">4417</a> <em class="jxr_comment">// For BeanMaps: get() returns non-null for accessible properties (including hidden ones)</em>
-<a class="jxr_linenumber" name="L4418" href="#L4418">4418</a> <strong class="jxr_keyword">var</strong> val = m.get(key);
-<a class="jxr_linenumber" name="L4419" href="#L4419">4419</a> <em class="jxr_comment">// Check if key actually exists: either containsKey is true, or val is non-null</em>
-<a class="jxr_linenumber" name="L4420" href="#L4420">4420</a> <em class="jxr_comment">// This handles both regular maps and BeanMaps correctly</em>
-<a class="jxr_linenumber" name="L4421" href="#L4421">4421</a> <strong class="jxr_keyword">var</strong> keyExists = m.containsKey(key) || nn(val);
-<a class="jxr_linenumber" name="L4422" href="#L4422">4422</a> <strong class="jxr_keyword">if</strong> (! keyExists)
-<a class="jxr_linenumber" name="L4423" href="#L4423">4423</a> out.append('{').append(key).append('}');
-<a class="jxr_linenumber" name="L4424" href="#L4424">4424</a> <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4425" href="#L4425">4425</a> <strong class="jxr_keyword">if</strong> (val == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4426" href="#L4426">4426</a> val = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L4427" href="#L4427">4427</a> <strong class="jxr_keyword">var</strong> v = val.toString();
-<a class="jxr_linenumber" name="L4428" href="#L4428">4428</a> <em class="jxr_comment">// If the replacement also contains variables, replace them now.</em>
-<a class="jxr_linenumber" name="L4429" href="#L4429">4429</a> <strong class="jxr_keyword">if</strong> (v.indexOf('{') != -1)
-<a class="jxr_linenumber" name="L4430" href="#L4430">4430</a> v = formatNamed(v, m);
-<a class="jxr_linenumber" name="L4431" href="#L4431">4431</a> out.append(v);
-<a class="jxr_linenumber" name="L4432" href="#L4432">4432</a> }
-<a class="jxr_linenumber" name="L4433" href="#L4433">4433</a> state = S1;
-<a class="jxr_linenumber" name="L4434" href="#L4434">4434</a> }
-<a class="jxr_linenumber" name="L4435" href="#L4435">4435</a> }
-<a class="jxr_linenumber" name="L4436" href="#L4436">4436</a> }
-<a class="jxr_linenumber" name="L4437" href="#L4437">4437</a> }
-<a class="jxr_linenumber" name="L4438" href="#L4438">4438</a> <strong class="jxr_keyword">return</strong> out.toString();
-<a class="jxr_linenumber" name="L4439" href="#L4439">4439</a> }
-<a class="jxr_linenumber" name="L4440" href="#L4440">4440</a>
-<a class="jxr_linenumber" name="L4441" href="#L4441">4441</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4442" href="#L4442">4442</a> <em class="jxr_javadoccomment"> * Reverses a string.</em>
-<a class="jxr_linenumber" name="L4443" href="#L4443">4443</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4444" href="#L4444">4444</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4445" href="#L4445">4445</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4446" href="#L4446">4446</a> <em class="jxr_javadoccomment"> * reverse(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L4447" href="#L4447">4447</a> <em class="jxr_javadoccomment"> * reverse(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L4448" href="#L4448">4448</a> <em class="jxr_javadoccomment"> * reverse(<js>"hello"</js>); <jc>// "olleh"</jc></em>
-<a class="jxr_linenumber" name="L4449" href="#L4449">4449</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4450" href="#L4450">4450</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4451" href="#L4451">4451</a> <em class="jxr_javadoccomment"> * @param str The string to reverse.</em>
-<a class="jxr_linenumber" name="L4452" href="#L4452">4452</a> <em class="jxr_javadoccomment"> * @return The reversed string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4453" href="#L4453">4453</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4454" href="#L4454">4454</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String reverse(String str) {
-<a class="jxr_linenumber" name="L4455" href="#L4455">4455</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4456" href="#L4456">4456</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4457" href="#L4457">4457</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> StringBuilder(str).reverse().toString();
-<a class="jxr_linenumber" name="L4458" href="#L4458">4458</a> }
-<a class="jxr_linenumber" name="L4459" href="#L4459">4459</a>
-<a class="jxr_linenumber" name="L4460" href="#L4460">4460</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4461" href="#L4461">4461</a> <em class="jxr_javadoccomment"> * Returns the rightmost characters of a string.</em>
-<a class="jxr_linenumber" name="L4462" href="#L4462">4462</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4463" href="#L4463">4463</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4464" href="#L4464">4464</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4465" href="#L4465">4465</a> <em class="jxr_javadoccomment"> * right(<jk>null</jk>, 3); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L4466" href="#L4466">4466</a> <em class="jxr_javadoccomment"> * right(<js>""</js>, 3); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L4467" href="#L4467">4467</a> <em class="jxr_javadoccomment"> * right(<js>"hello"</js>, 3); <jc>// "llo"</jc></em>
-<a class="jxr_linenumber" name="L4468" href="#L4468">4468</a> <em class="jxr_javadoccomment"> * right(<js>"hello"</js>, 10); <jc>// "hello"</jc></em>
-<a class="jxr_linenumber" name="L4469" href="#L4469">4469</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4470" href="#L4470">4470</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4471" href="#L4471">4471</a> <em class="jxr_javadoccomment"> * @param str The string to get characters from.</em>
-<a class="jxr_linenumber" name="L4472" href="#L4472">4472</a> <em class="jxr_javadoccomment"> * @param len The number of characters to get.</em>
-<a class="jxr_linenumber" name="L4473" href="#L4473">4473</a> <em class="jxr_javadoccomment"> * @return The rightmost characters, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4474" href="#L4474">4474</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4475" href="#L4475">4475</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String right(String str, <strong class="jxr_keyword">int</strong> len) {
-<a class="jxr_linenumber" name="L4476" href="#L4476">4476</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4477" href="#L4477">4477</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4478" href="#L4478">4478</a> <strong class="jxr_keyword">if</strong> (len < 0)
-<a class="jxr_linenumber" name="L4479" href="#L4479">4479</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L4480" href="#L4480">4480</a> <strong class="jxr_keyword">if</strong> (len >= str.length())
-<a class="jxr_linenumber" name="L4481" href="#L4481">4481</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L4482" href="#L4482">4482</a> <strong class="jxr_keyword">return</strong> str.substring(str.length() - len);
-<a class="jxr_linenumber" name="L4483" href="#L4483">4483</a> }
-<a class="jxr_linenumber" name="L4484" href="#L4484">4484</a>
-<a class="jxr_linenumber" name="L4485" href="#L4485">4485</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4486" href="#L4486">4486</a> <em class="jxr_javadoccomment"> * Splits a comma-delimited list into a list of strings.</em>
-<a class="jxr_linenumber" name="L4487" href="#L4487">4487</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4488" href="#L4488">4488</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
-<a class="jxr_linenumber" name="L4489" href="#L4489">4489</a> <em class="jxr_javadoccomment"> * @return A list of split strings, or an empty list if the input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4490" href="#L4490">4490</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4491" href="#L4491">4491</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> split(String s) {
-<a class="jxr_linenumber" name="L4492" href="#L4492">4492</a> <strong class="jxr_keyword">return</strong> s == <strong class="jxr_keyword">null</strong> ? Collections.emptyList() : split(s, ',');
-<a class="jxr_linenumber" name="L4493" href="#L4493">4493</a> }
-<a class="jxr_linenumber" name="L4494" href="#L4494">4494</a>
-<a class="jxr_linenumber" name="L4495" href="#L4495">4495</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4496" href="#L4496">4496</a> <em class="jxr_javadoccomment"> * Splits a character-delimited string into a string array.</em>
-<a class="jxr_linenumber" name="L4497" href="#L4497">4497</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4498" href="#L4498">4498</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4499" href="#L4499">4499</a> <em class="jxr_javadoccomment"> * Does not split on escaped-delimiters (e.g. "\,");</em>
-<a class="jxr_linenumber" name="L4500" href="#L4500">4500</a> <em class="jxr_javadoccomment"> * Resulting tokens are trimmed of whitespace.</em>
+<a class="jxr_linenumber" name="L4365" href="#L4365">4365</a> <em class="jxr_javadoccomment"> * Variable values are converted to strings using {@link #readable(Object)} to ensure consistent,</em>
+<a class="jxr_linenumber" name="L4366" href="#L4366">4366</a> <em class="jxr_javadoccomment"> * readable formatting (e.g., byte arrays are converted to hex, collections are formatted without spaces).</em>
+<a class="jxr_linenumber" name="L4367" href="#L4367">4367</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4368" href="#L4368">4368</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4369" href="#L4369">4369</a> <em class="jxr_javadoccomment"> * Nested variables are supported in both the input string and map values.</em>
+<a class="jxr_linenumber" name="L4370" href="#L4370">4370</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4371" href="#L4371">4371</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4372" href="#L4372">4372</a> <em class="jxr_javadoccomment"> * If the map does not contain the specified value, the variable is not replaced.</em>
+<a class="jxr_linenumber" name="L4373" href="#L4373">4373</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4374" href="#L4374">4374</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4375" href="#L4375">4375</a> <em class="jxr_javadoccomment"> * <jk>null</jk> values in the map are treated as blank strings.</em>
+<a class="jxr_linenumber" name="L4376" href="#L4376">4376</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4377" href="#L4377">4377</a> <em class="jxr_javadoccomment"> * @param s The string containing variables to replace.</em>
+<a class="jxr_linenumber" name="L4378" href="#L4378">4378</a> <em class="jxr_javadoccomment"> * @param m The map containing the variable values.</em>
+<a class="jxr_linenumber" name="L4379" href="#L4379">4379</a> <em class="jxr_javadoccomment"> * @return The new string with variables replaced, or the original string if it didn't have variables in it.</em>
+<a class="jxr_linenumber" name="L4380" href="#L4380">4380</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4381" href="#L4381">4381</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String formatNamed(String s, Map<String,Object> m) {
+<a class="jxr_linenumber" name="L4382" href="#L4382">4382</a>
+<a class="jxr_linenumber" name="L4383" href="#L4383">4383</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4384" href="#L4384">4384</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4385" href="#L4385">4385</a>
+<a class="jxr_linenumber" name="L4386" href="#L4386">4386</a> <strong class="jxr_keyword">if</strong> (m == <strong class="jxr_keyword">null</strong> || m.isEmpty() || s.indexOf('{') == -1)
+<a class="jxr_linenumber" name="L4387" href="#L4387">4387</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L4388" href="#L4388">4388</a>
+<a class="jxr_linenumber" name="L4389" href="#L4389">4389</a> <em class="jxr_comment">// S1: Not in variable, looking for '{'</em>
+<a class="jxr_linenumber" name="L4390" href="#L4390">4390</a> <em class="jxr_comment">// S2: Found '{', Looking for '}'</em>
+<a class="jxr_linenumber" name="L4391" href="#L4391">4391</a>
+<a class="jxr_linenumber" name="L4392" href="#L4392">4392</a> <strong class="jxr_keyword">var</strong> state = S1;
+<a class="jxr_linenumber" name="L4393" href="#L4393">4393</a> <strong class="jxr_keyword">var</strong> hasInternalVar = false;
+<a class="jxr_linenumber" name="L4394" href="#L4394">4394</a> <strong class="jxr_keyword">var</strong> x = 0;
+<a class="jxr_linenumber" name="L4395" href="#L4395">4395</a> <strong class="jxr_keyword">var</strong> depth = 0;
+<a class="jxr_linenumber" name="L4396" href="#L4396">4396</a> <strong class="jxr_keyword">var</strong> length = s.length();
+<a class="jxr_linenumber" name="L4397" href="#L4397">4397</a> <strong class="jxr_keyword">var</strong> out = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L4398" href="#L4398">4398</a>
+<a class="jxr_linenumber" name="L4399" href="#L4399">4399</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < length; i++) {
+<a class="jxr_linenumber" name="L4400" href="#L4400">4400</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L4401" href="#L4401">4401</a> <strong class="jxr_keyword">if</strong> (state == S1) {
+<a class="jxr_linenumber" name="L4402" href="#L4402">4402</a> <strong class="jxr_keyword">if</strong> (c == '{') {
+<a class="jxr_linenumber" name="L4403" href="#L4403">4403</a> state = S2;
+<a class="jxr_linenumber" name="L4404" href="#L4404">4404</a> x = i;
+<a class="jxr_linenumber" name="L4405" href="#L4405">4405</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4406" href="#L4406">4406</a> out.append(c);
+<a class="jxr_linenumber" name="L4407" href="#L4407">4407</a> }
+<a class="jxr_linenumber" name="L4408" href="#L4408">4408</a> } <strong class="jxr_keyword">else</strong> <em class="jxr_comment">/* state == S2 */</em> {
+<a class="jxr_linenumber" name="L4409" href="#L4409">4409</a> <strong class="jxr_keyword">if</strong> (c == '{') {
+<a class="jxr_linenumber" name="L4410" href="#L4410">4410</a> depth++;
+<a class="jxr_linenumber" name="L4411" href="#L4411">4411</a> hasInternalVar = <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L4412" href="#L4412">4412</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '}') {
+<a class="jxr_linenumber" name="L4413" href="#L4413">4413</a> <strong class="jxr_keyword">if</strong> (depth > 0) {
+<a class="jxr_linenumber" name="L4414" href="#L4414">4414</a> depth--;
+<a class="jxr_linenumber" name="L4415" href="#L4415">4415</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4416" href="#L4416">4416</a> <strong class="jxr_keyword">var</strong> key = s.substring(x + 1, i);
+<a class="jxr_linenumber" name="L4417" href="#L4417">4417</a> key = (hasInternalVar ? formatNamed(key, m) : key);
+<a class="jxr_linenumber" name="L4418" href="#L4418">4418</a> hasInternalVar = false;
+<a class="jxr_linenumber" name="L4419" href="#L4419">4419</a> <em class="jxr_comment">// JUNEAU-248: Check if key exists in map by attempting to get it</em>
+<a class="jxr_linenumber" name="L4420" href="#L4420">4420</a> <em class="jxr_comment">// For regular maps: use containsKey() OR nn(get()) check</em>
+<a class="jxr_linenumber" name="L4421" href="#L4421">4421</a> <em class="jxr_comment">// For BeanMaps: get() returns non-null for accessible properties (including hidden ones)</em>
+<a class="jxr_linenumber" name="L4422" href="#L4422">4422</a> <strong class="jxr_keyword">var</strong> val = m.get(key);
+<a class="jxr_linenumber" name="L4423" href="#L4423">4423</a> <em class="jxr_comment">// Check if key actually exists: either containsKey is true, or val is non-null</em>
+<a class="jxr_linenumber" name="L4424" href="#L4424">4424</a> <em class="jxr_comment">// This handles both regular maps and BeanMaps correctly</em>
+<a class="jxr_linenumber" name="L4425" href="#L4425">4425</a> <strong class="jxr_keyword">var</strong> keyExists = m.containsKey(key) || nn(val);
+<a class="jxr_linenumber" name="L4426" href="#L4426">4426</a> <strong class="jxr_keyword">if</strong> (! keyExists)
+<a class="jxr_linenumber" name="L4427" href="#L4427">4427</a> out.append('{').append(key).append('}');
+<a class="jxr_linenumber" name="L4428" href="#L4428">4428</a> <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4429" href="#L4429">4429</a> <strong class="jxr_keyword">if</strong> (val == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4430" href="#L4430">4430</a> val = <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L4431" href="#L4431">4431</a> <strong class="jxr_keyword">var</strong> v = r(val);
+<a class="jxr_linenumber" name="L4432" href="#L4432">4432</a> <em class="jxr_comment">// If the replacement also contains variables, replace them now.</em>
+<a class="jxr_linenumber" name="L4433" href="#L4433">4433</a> <strong class="jxr_keyword">if</strong> (v.indexOf('{') != -1)
+<a class="jxr_linenumber" name="L4434" href="#L4434">4434</a> v = formatNamed(v, m);
+<a class="jxr_linenumber" name="L4435" href="#L4435">4435</a> out.append(v);
+<a class="jxr_linenumber" name="L4436" href="#L4436">4436</a> }
+<a class="jxr_linenumber" name="L4437" href="#L4437">4437</a> state = S1;
+<a class="jxr_linenumber" name="L4438" href="#L4438">4438</a> }
+<a class="jxr_linenumber" name="L4439" href="#L4439">4439</a> }
+<a class="jxr_linenumber" name="L4440" href="#L4440">4440</a> }
+<a class="jxr_linenumber" name="L4441" href="#L4441">4441</a> }
+<a class="jxr_linenumber" name="L4442" href="#L4442">4442</a> <strong class="jxr_keyword">return</strong> out.toString();
+<a class="jxr_linenumber" name="L4443" href="#L4443">4443</a> }
+<a class="jxr_linenumber" name="L4444" href="#L4444">4444</a>
+<a class="jxr_linenumber" name="L4445" href="#L4445">4445</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4446" href="#L4446">4446</a> <em class="jxr_javadoccomment"> * Reverses a string.</em>
+<a class="jxr_linenumber" name="L4447" href="#L4447">4447</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4448" href="#L4448">4448</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4449" href="#L4449">4449</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4450" href="#L4450">4450</a> <em class="jxr_javadoccomment"> * reverse(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L4451" href="#L4451">4451</a> <em class="jxr_javadoccomment"> * reverse(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L4452" href="#L4452">4452</a> <em class="jxr_javadoccomment"> * reverse(<js>"hello"</js>); <jc>// "olleh"</jc></em>
+<a class="jxr_linenumber" name="L4453" href="#L4453">4453</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4454" href="#L4454">4454</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4455" href="#L4455">4455</a> <em class="jxr_javadoccomment"> * @param str The string to reverse.</em>
+<a class="jxr_linenumber" name="L4456" href="#L4456">4456</a> <em class="jxr_javadoccomment"> * @return The reversed string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4457" href="#L4457">4457</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4458" href="#L4458">4458</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String reverse(String str) {
+<a class="jxr_linenumber" name="L4459" href="#L4459">4459</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4460" href="#L4460">4460</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4461" href="#L4461">4461</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> StringBuilder(str).reverse().toString();
+<a class="jxr_linenumber" name="L4462" href="#L4462">4462</a> }
+<a class="jxr_linenumber" name="L4463" href="#L4463">4463</a>
+<a class="jxr_linenumber" name="L4464" href="#L4464">4464</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4465" href="#L4465">4465</a> <em class="jxr_javadoccomment"> * Returns the rightmost characters of a string.</em>
+<a class="jxr_linenumber" name="L4466" href="#L4466">4466</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4467" href="#L4467">4467</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4468" href="#L4468">4468</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4469" href="#L4469">4469</a> <em class="jxr_javadoccomment"> * right(<jk>null</jk>, 3); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L4470" href="#L4470">4470</a> <em class="jxr_javadoccomment"> * right(<js>""</js>, 3); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L4471" href="#L4471">4471</a> <em class="jxr_javadoccomment"> * right(<js>"hello"</js>, 3); <jc>// "llo"</jc></em>
+<a class="jxr_linenumber" name="L4472" href="#L4472">4472</a> <em class="jxr_javadoccomment"> * right(<js>"hello"</js>, 10); <jc>// "hello"</jc></em>
+<a class="jxr_linenumber" name="L4473" href="#L4473">4473</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4474" href="#L4474">4474</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4475" href="#L4475">4475</a> <em class="jxr_javadoccomment"> * @param str The string to get characters from.</em>
+<a class="jxr_linenumber" name="L4476" href="#L4476">4476</a> <em class="jxr_javadoccomment"> * @param len The number of characters to get.</em>
+<a class="jxr_linenumber" name="L4477" href="#L4477">4477</a> <em class="jxr_javadoccomment"> * @return The rightmost characters, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4478" href="#L4478">4478</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4479" href="#L4479">4479</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String right(String str, <strong class="jxr_keyword">int</strong> len) {
+<a class="jxr_linenumber" name="L4480" href="#L4480">4480</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4481" href="#L4481">4481</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4482" href="#L4482">4482</a> <strong class="jxr_keyword">if</strong> (len < 0)
+<a class="jxr_linenumber" name="L4483" href="#L4483">4483</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L4484" href="#L4484">4484</a> <strong class="jxr_keyword">if</strong> (len >= str.length())
+<a class="jxr_linenumber" name="L4485" href="#L4485">4485</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L4486" href="#L4486">4486</a> <strong class="jxr_keyword">return</strong> str.substring(str.length() - len);
+<a class="jxr_linenumber" name="L4487" href="#L4487">4487</a> }
+<a class="jxr_linenumber" name="L4488" href="#L4488">4488</a>
+<a class="jxr_linenumber" name="L4489" href="#L4489">4489</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4490" href="#L4490">4490</a> <em class="jxr_javadoccomment"> * Splits a comma-delimited list into a list of strings.</em>
+<a class="jxr_linenumber" name="L4491" href="#L4491">4491</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4492" href="#L4492">4492</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
+<a class="jxr_linenumber" name="L4493" href="#L4493">4493</a> <em class="jxr_javadoccomment"> * @return A list of split strings, or an empty list if the input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4494" href="#L4494">4494</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4495" href="#L4495">4495</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> split(String s) {
+<a class="jxr_linenumber" name="L4496" href="#L4496">4496</a> <strong class="jxr_keyword">return</strong> s == <strong class="jxr_keyword">null</strong> ? Collections.emptyList() : split(s, ',');
+<a class="jxr_linenumber" name="L4497" href="#L4497">4497</a> }
+<a class="jxr_linenumber" name="L4498" href="#L4498">4498</a>
+<a class="jxr_linenumber" name="L4499" href="#L4499">4499</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4500" href="#L4500">4500</a> <em class="jxr_javadoccomment"> * Splits a character-delimited string into a string array.</em>
<a class="jxr_linenumber" name="L4501" href="#L4501">4501</a> <em class="jxr_javadoccomment"> *</em>
<a class="jxr_linenumber" name="L4502" href="#L4502">4502</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4503" href="#L4503">4503</a> <em class="jxr_javadoccomment"> * <b>NOTE:</b> This behavior is different than the Jakarta equivalent.</em>
-<a class="jxr_linenumber" name="L4504" href="#L4504">4504</a> <em class="jxr_javadoccomment"> * split("a,b,c",',') -&gt; {"a","b","c"}</em>
-<a class="jxr_linenumber" name="L4505" href="#L4505">4505</a> <em class="jxr_javadoccomment"> * split("a, b ,c ",',') -&gt; {"a","b","c"}</em>
-<a class="jxr_linenumber" name="L4506" href="#L4506">4506</a> <em class="jxr_javadoccomment"> * split("a,,c",',') -&gt; {"a","","c"}</em>
-<a class="jxr_linenumber" name="L4507" href="#L4507">4507</a> <em class="jxr_javadoccomment"> * split(",,",',') -&gt; {"","",""}</em>
-<a class="jxr_linenumber" name="L4508" href="#L4508">4508</a> <em class="jxr_javadoccomment"> * split("",',') -&gt; {}</em>
-<a class="jxr_linenumber" name="L4509" href="#L4509">4509</a> <em class="jxr_javadoccomment"> * split(null,',') -&gt; null</em>
-<a class="jxr_linenumber" name="L4510" href="#L4510">4510</a> <em class="jxr_javadoccomment"> * split("a,b\,c,d", ',', false) -&gt; {"a","b\,c","d"}</em>
-<a class="jxr_linenumber" name="L4511" href="#L4511">4511</a> <em class="jxr_javadoccomment"> * split("a,b\\,c,d", ',', false) -&gt; {"a","b\","c","d"}</em>
-<a class="jxr_linenumber" name="L4512" href="#L4512">4512</a> <em class="jxr_javadoccomment"> * split("a,b\,c,d", ',', true) -&gt; {"a","b,c","d"}</em>
-<a class="jxr_linenumber" name="L4513" href="#L4513">4513</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4514" href="#L4514">4514</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4515" href="#L4515">4515</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
-<a class="jxr_linenumber" name="L4516" href="#L4516">4516</a> <em class="jxr_javadoccomment"> * @return The tokens, or <jk>null</jk> if the string was null.</em>
-<a class="jxr_linenumber" name="L4517" href="#L4517">4517</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4518" href="#L4518">4518</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> split(String s, <strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L4519" href="#L4519">4519</a> <strong class="jxr_keyword">return</strong> split(s, c, Integer.MAX_VALUE);
-<a class="jxr_linenumber" name="L4520" href="#L4520">4520</a> }
-<a class="jxr_linenumber" name="L4521" href="#L4521">4521</a>
-<a class="jxr_linenumber" name="L4522" href="#L4522">4522</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4523" href="#L4523">4523</a> <em class="jxr_javadoccomment"> * Same as {@link splita} but consumes the tokens instead of creating an array.</em>
-<a class="jxr_linenumber" name="L4524" href="#L4524">4524</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4525" href="#L4525">4525</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
-<a class="jxr_linenumber" name="L4526" href="#L4526">4526</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
-<a class="jxr_linenumber" name="L4527" href="#L4527">4527</a> <em class="jxr_javadoccomment"> * @param consumer The consumer of the tokens.</em>
-<a class="jxr_linenumber" name="L4528" href="#L4528">4528</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4529" href="#L4529">4529</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> split(String s, <strong class="jxr_keyword">char</strong> c, Consumer<String> consumer) {
-<a class="jxr_linenumber" name="L4530" href="#L4530">4530</a> <strong class="jxr_keyword">var</strong> escapeChars = getEscapeSet(c);
-<a class="jxr_linenumber" name="L4531" href="#L4531">4531</a>
-<a class="jxr_linenumber" name="L4532" href="#L4532">4532</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
-<a class="jxr_linenumber" name="L4533" href="#L4533">4533</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L4534" href="#L4534">4534</a> <strong class="jxr_keyword">if</strong> (s.indexOf(c) == -1) {
-<a class="jxr_linenumber" name="L4535" href="#L4535">4535</a> consumer.accept(s);
-<a class="jxr_linenumber" name="L4536" href="#L4536">4536</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L4537" href="#L4537">4537</a> }
-<a class="jxr_linenumber" name="L4538" href="#L4538">4538</a>
-<a class="jxr_linenumber" name="L4539" href="#L4539">4539</a> <strong class="jxr_keyword">var</strong> x1 = 0;
-<a class="jxr_linenumber" name="L4540" href="#L4540">4540</a> <strong class="jxr_keyword">var</strong> escapeCount = 0;
-<a class="jxr_linenumber" name="L4541" href="#L4541">4541</a>
-<a class="jxr_linenumber" name="L4542" href="#L4542">4542</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L4543" href="#L4543">4543</a> <strong class="jxr_keyword">if</strong> (s.charAt(i) == '\\')
-<a class="jxr_linenumber" name="L4544" href="#L4544">4544</a> escapeCount++;
-<a class="jxr_linenumber" name="L4545" href="#L4545">4545</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (s.charAt(i) == c && escapeCount % 2 == 0) {
-<a class="jxr_linenumber" name="L4546" href="#L4546">4546</a> <strong class="jxr_keyword">var</strong> s2 = s.substring(x1, i);
-<a class="jxr_linenumber" name="L4547" href="#L4547">4547</a> <strong class="jxr_keyword">var</strong> s3 = unEscapeChars(s2, escapeChars);
-<a class="jxr_linenumber" name="L4548" href="#L4548">4548</a> consumer.accept(s3.trim()); <em class="jxr_comment">// NOSONAR - NPE not possible.</em>
-<a class="jxr_linenumber" name="L4549" href="#L4549">4549</a> x1 = i + 1;
-<a class="jxr_linenumber" name="L4550" href="#L4550">4550</a> }
-<a class="jxr_linenumber" name="L4551" href="#L4551">4551</a> <strong class="jxr_keyword">if</strong> (s.charAt(i) != '\\')
-<a class="jxr_linenumber" name="L4552" href="#L4552">4552</a> escapeCount = 0;
-<a class="jxr_linenumber" name="L4553" href="#L4553">4553</a> }
-<a class="jxr_linenumber" name="L4554" href="#L4554">4554</a> <strong class="jxr_keyword">var</strong> s2 = s.substring(x1);
-<a class="jxr_linenumber" name="L4555" href="#L4555">4555</a> <strong class="jxr_keyword">var</strong> s3 = unEscapeChars(s2, escapeChars);
-<a class="jxr_linenumber" name="L4556" href="#L4556">4556</a> consumer.accept(s3.trim()); <em class="jxr_comment">// NOSONAR - NPE not possible.</em>
-<a class="jxr_linenumber" name="L4557" href="#L4557">4557</a> }
-<a class="jxr_linenumber" name="L4558" href="#L4558">4558</a>
-<a class="jxr_linenumber" name="L4559" href="#L4559">4559</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4560" href="#L4560">4560</a> <em class="jxr_javadoccomment"> * Same as {@link splita} but limits the number of tokens returned.</em>
-<a class="jxr_linenumber" name="L4561" href="#L4561">4561</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4562" href="#L4562">4562</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4563" href="#L4563">4563</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
-<a class="jxr_linenumber" name="L4564" href="#L4564">4564</a> <em class="jxr_javadoccomment"> * @param limit The maximum number of tokens to return.</em>
-<a class="jxr_linenumber" name="L4565" href="#L4565">4565</a> <em class="jxr_javadoccomment"> * @return The tokens, or <jk>null</jk> if the string was null.</em>
-<a class="jxr_linenumber" name="L4566" href="#L4566">4566</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4567" href="#L4567">4567</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> split(String s, <strong class="jxr_keyword">char</strong> c, <strong class="jxr_keyword">int</strong> limit) {
-<a class="jxr_linenumber" name="L4568" href="#L4568">4568</a>
-<a class="jxr_linenumber" name="L4569" href="#L4569">4569</a> <strong class="jxr_keyword">var</strong> escapeChars = getEscapeSet(c);
-<a class="jxr_linenumber" name="L4570" href="#L4570">4570</a>
-<a class="jxr_linenumber" name="L4571" href="#L4571">4571</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4572" href="#L4572">4572</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L4573" href="#L4573">4573</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
-<a class="jxr_linenumber" name="L4574" href="#L4574">4574</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L4575" href="#L4575">4575</a> <strong class="jxr_keyword">if</strong> (s.indexOf(c) == -1)
-<a class="jxr_linenumber" name="L4576" href="#L4576">4576</a> <strong class="jxr_keyword">return</strong> Collections.singletonList(s);
-<a class="jxr_linenumber" name="L4577" href="#L4577">4577</a>
-<a class="jxr_linenumber" name="L4578" href="#L4578">4578</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> LinkedList<String>();
-<a class="jxr_linenumber" name="L4579" href="#L4579">4579</a> <strong class="jxr_keyword">var</strong> sArray = s.toCharArray();
-<a class="jxr_linenumber" name="L4580" href="#L4580">4580</a> <strong class="jxr_keyword">var</strong> x1 = 0;
-<a class="jxr_linenumber" name="L4581" href="#L4581">4581</a> <strong class="jxr_keyword">var</strong> escapeCount = 0;
-<a class="jxr_linenumber" name="L4582" href="#L4582">4582</a> limit--;
-<a class="jxr_linenumber" name="L4583" href="#L4583">4583</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < sArray.length && limit > 0; i++) {
-<a class="jxr_linenumber" name="L4584" href="#L4584">4584</a> <strong class="jxr_keyword">if</strong> (sArray[i] == '\\')
-<a class="jxr_linenumber" name="L4585" href="#L4585">4585</a> escapeCount++;
-<a class="jxr_linenumber" name="L4586" href="#L4586">4586</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (sArray[i] == c && escapeCount % 2 == 0) {
-<a class="jxr_linenumber" name="L4587" href="#L4587">4587</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(sArray, x1, i - x1);
-<a class="jxr_linenumber" name="L4588" href="#L4588">4588</a> <strong class="jxr_keyword">var</strong> s3 = unEscapeChars(s2, escapeChars);
-<a class="jxr_linenumber" name="L4589" href="#L4589">4589</a> l.add(s3.trim());
-<a class="jxr_linenumber" name="L4590" href="#L4590">4590</a> limit--;
-<a class="jxr_linenumber" name="L4591" href="#L4591">4591</a> x1 = i + 1;
-<a class="jxr_linenumber" name="L4592" href="#L4592">4592</a> }
-<a class="jxr_linenumber" name="L4593" href="#L4593">4593</a> <strong class="jxr_keyword">if</strong> (sArray[i] != '\\')
-<a class="jxr_linenumber" name="L4594" href="#L4594">4594</a> escapeCount = 0;
-<a class="jxr_linenumber" name="L4595" href="#L4595">4595</a> }
-<a class="jxr_linenumber" name="L4596" href="#L4596">4596</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(sArray, x1, sArray.length - x1);
-<a class="jxr_linenumber" name="L4597" href="#L4597">4597</a> <strong class="jxr_keyword">var</strong> s3 = unEscapeChars(s2, escapeChars);
-<a class="jxr_linenumber" name="L4598" href="#L4598">4598</a> l.add(s3.trim());
-<a class="jxr_linenumber" name="L4599" href="#L4599">4599</a>
-<a class="jxr_linenumber" name="L4600" href="#L4600">4600</a> <strong class="jxr_keyword">return</strong> l;
-<a class="jxr_linenumber" name="L4601" href="#L4601">4601</a> }
-<a class="jxr_linenumber" name="L4602" href="#L4602">4602</a>
-<a class="jxr_linenumber" name="L4603" href="#L4603">4603</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4604" href="#L4604">4604</a> <em class="jxr_javadoccomment"> * Same as {@link splita} but consumes the tokens instead of creating an array.</em>
-<a class="jxr_linenumber" name="L4605" href="#L4605">4605</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4606" href="#L4606">4606</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
-<a class="jxr_linenumber" name="L4607" href="#L4607">4607</a> <em class="jxr_javadoccomment"> * @param consumer The consumer of the tokens.</em>
-<a class="jxr_linenumber" name="L4608" href="#L4608">4608</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4609" href="#L4609">4609</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> split(String s, Consumer<String> consumer) {
-<a class="jxr_linenumber" name="L4610" href="#L4610">4610</a> StringUtils.split(s, ',', consumer);
-<a class="jxr_linenumber" name="L4611" href="#L4611">4611</a> }
-<a class="jxr_linenumber" name="L4612" href="#L4612">4612</a>
-<a class="jxr_linenumber" name="L4613" href="#L4613">4613</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L4614" href="#L4614">4614</a> <em class="jxr_comment">// String manipulation methods</em>
-<a class="jxr_linenumber" name="L4615" href="#L4615">4615</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L4503" href="#L4503">4503</a> <em class="jxr_javadoccomment"> * Does not split on escaped-delimiters (e.g. "\,");</em>
+<a class="jxr_linenumber" name="L4504" href="#L4504">4504</a> <em class="jxr_javadoccomment"> * Resulting tokens are trimmed of whitespace.</em>
+<a class="jxr_linenumber" name="L4505" href="#L4505">4505</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4506" href="#L4506">4506</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4507" href="#L4507">4507</a> <em class="jxr_javadoccomment"> * <b>NOTE:</b> This behavior is different than the Jakarta equivalent.</em>
+<a class="jxr_linenumber" name="L4508" href="#L4508">4508</a> <em class="jxr_javadoccomment"> * split("a,b,c",',') -&gt; {"a","b","c"}</em>
+<a class="jxr_linenumber" name="L4509" href="#L4509">4509</a> <em class="jxr_javadoccomment"> * split("a, b ,c ",',') -&gt; {"a","b","c"}</em>
+<a class="jxr_linenumber" name="L4510" href="#L4510">4510</a> <em class="jxr_javadoccomment"> * split("a,,c",',') -&gt; {"a","","c"}</em>
+<a class="jxr_linenumber" name="L4511" href="#L4511">4511</a> <em class="jxr_javadoccomment"> * split(",,",',') -&gt; {"","",""}</em>
+<a class="jxr_linenumber" name="L4512" href="#L4512">4512</a> <em class="jxr_javadoccomment"> * split("",',') -&gt; {}</em>
+<a class="jxr_linenumber" name="L4513" href="#L4513">4513</a> <em class="jxr_javadoccomment"> * split(null,',') -&gt; null</em>
+<a class="jxr_linenumber" name="L4514" href="#L4514">4514</a> <em class="jxr_javadoccomment"> * split("a,b\,c,d", ',', false) -&gt; {"a","b\,c","d"}</em>
+<a class="jxr_linenumber" name="L4515" href="#L4515">4515</a> <em class="jxr_javadoccomment"> * split("a,b\\,c,d", ',', false) -&gt; {"a","b\","c","d"}</em>
+<a class="jxr_linenumber" name="L4516" href="#L4516">4516</a> <em class="jxr_javadoccomment"> * split("a,b\,c,d", ',', true) -&gt; {"a","b,c","d"}</em>
+<a class="jxr_linenumber" name="L4517" href="#L4517">4517</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4518" href="#L4518">4518</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4519" href="#L4519">4519</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
+<a class="jxr_linenumber" name="L4520" href="#L4520">4520</a> <em class="jxr_javadoccomment"> * @return The tokens, or <jk>null</jk> if the string was null.</em>
+<a class="jxr_linenumber" name="L4521" href="#L4521">4521</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4522" href="#L4522">4522</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> split(String s, <strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L4523" href="#L4523">4523</a> <strong class="jxr_keyword">return</strong> split(s, c, Integer.MAX_VALUE);
+<a class="jxr_linenumber" name="L4524" href="#L4524">4524</a> }
+<a class="jxr_linenumber" name="L4525" href="#L4525">4525</a>
+<a class="jxr_linenumber" name="L4526" href="#L4526">4526</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4527" href="#L4527">4527</a> <em class="jxr_javadoccomment"> * Same as {@link splita} but consumes the tokens instead of creating an array.</em>
+<a class="jxr_linenumber" name="L4528" href="#L4528">4528</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4529" href="#L4529">4529</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
+<a class="jxr_linenumber" name="L4530" href="#L4530">4530</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
+<a class="jxr_linenumber" name="L4531" href="#L4531">4531</a> <em class="jxr_javadoccomment"> * @param consumer The consumer of the tokens.</em>
+<a class="jxr_linenumber" name="L4532" href="#L4532">4532</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4533" href="#L4533">4533</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> split(String s, <strong class="jxr_keyword">char</strong> c, Consumer<String> consumer) {
+<a class="jxr_linenumber" name="L4534" href="#L4534">4534</a> <strong class="jxr_keyword">var</strong> escapeChars = getEscapeSet(c);
+<a class="jxr_linenumber" name="L4535" href="#L4535">4535</a>
+<a class="jxr_linenumber" name="L4536" href="#L4536">4536</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
+<a class="jxr_linenumber" name="L4537" href="#L4537">4537</a> <strong class="jxr_keyword">return</strong>;
+<a class="jxr_linenumber" name="L4538" href="#L4538">4538</a> <strong class="jxr_keyword">if</strong> (s.indexOf(c) == -1) {
+<a class="jxr_linenumber" name="L4539" href="#L4539">4539</a> consumer.accept(s);
+<a class="jxr_linenumber" name="L4540" href="#L4540">4540</a> <strong class="jxr_keyword">return</strong>;
+<a class="jxr_linenumber" name="L4541" href="#L4541">4541</a> }
+<a class="jxr_linenumber" name="L4542" href="#L4542">4542</a>
+<a class="jxr_linenumber" name="L4543" href="#L4543">4543</a> <strong class="jxr_keyword">var</strong> x1 = 0;
+<a class="jxr_linenumber" name="L4544" href="#L4544">4544</a> <strong class="jxr_keyword">var</strong> escapeCount = 0;
+<a class="jxr_linenumber" name="L4545" href="#L4545">4545</a>
+<a class="jxr_linenumber" name="L4546" href="#L4546">4546</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L4547" href="#L4547">4547</a> <strong class="jxr_keyword">if</strong> (s.charAt(i) == '\\')
+<a class="jxr_linenumber" name="L4548" href="#L4548">4548</a> escapeCount++;
+<a class="jxr_linenumber" name="L4549" href="#L4549">4549</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (s.charAt(i) == c && escapeCount % 2 == 0) {
+<a class="jxr_linenumber" name="L4550" href="#L4550">4550</a> <strong class="jxr_keyword">var</strong> s2 = s.substring(x1, i);
+<a class="jxr_linenumber" name="L4551" href="#L4551">4551</a> <strong class="jxr_keyword">var</strong> s3 = unEscapeChars(s2, escapeChars);
+<a class="jxr_linenumber" name="L4552" href="#L4552">4552</a> consumer.accept(s3.trim()); <em class="jxr_comment">// NOSONAR - NPE not possible.</em>
+<a class="jxr_linenumber" name="L4553" href="#L4553">4553</a> x1 = i + 1;
+<a class="jxr_linenumber" name="L4554" href="#L4554">4554</a> }
+<a class="jxr_linenumber" name="L4555" href="#L4555">4555</a> <strong class="jxr_keyword">if</strong> (s.charAt(i) != '\\')
+<a class="jxr_linenumber" name="L4556" href="#L4556">4556</a> escapeCount = 0;
+<a class="jxr_linenumber" name="L4557" href="#L4557">4557</a> }
+<a class="jxr_linenumber" name="L4558" href="#L4558">4558</a> <strong class="jxr_keyword">var</strong> s2 = s.substring(x1);
+<a class="jxr_linenumber" name="L4559" href="#L4559">4559</a> <strong class="jxr_keyword">var</strong> s3 = unEscapeChars(s2, escapeChars);
+<a class="jxr_linenumber" name="L4560" href="#L4560">4560</a> consumer.accept(s3.trim()); <em class="jxr_comment">// NOSONAR - NPE not possible.</em>
+<a class="jxr_linenumber" name="L4561" href="#L4561">4561</a> }
+<a class="jxr_linenumber" name="L4562" href="#L4562">4562</a>
+<a class="jxr_linenumber" name="L4563" href="#L4563">4563</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4564" href="#L4564">4564</a> <em class="jxr_javadoccomment"> * Same as {@link splita} but limits the number of tokens returned.</em>
+<a class="jxr_linenumber" name="L4565" href="#L4565">4565</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4566" href="#L4566">4566</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4567" href="#L4567">4567</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
+<a class="jxr_linenumber" name="L4568" href="#L4568">4568</a> <em class="jxr_javadoccomment"> * @param limit The maximum number of tokens to return.</em>
+<a class="jxr_linenumber" name="L4569" href="#L4569">4569</a> <em class="jxr_javadoccomment"> * @return The tokens, or <jk>null</jk> if the string was null.</em>
+<a class="jxr_linenumber" name="L4570" href="#L4570">4570</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4571" href="#L4571">4571</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> split(String s, <strong class="jxr_keyword">char</strong> c, <strong class="jxr_keyword">int</strong> limit) {
+<a class="jxr_linenumber" name="L4572" href="#L4572">4572</a>
+<a class="jxr_linenumber" name="L4573" href="#L4573">4573</a> <strong class="jxr_keyword">var</strong> escapeChars = getEscapeSet(c);
+<a class="jxr_linenumber" name="L4574" href="#L4574">4574</a>
+<a class="jxr_linenumber" name="L4575" href="#L4575">4575</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4576" href="#L4576">4576</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L4577" href="#L4577">4577</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
+<a class="jxr_linenumber" name="L4578" href="#L4578">4578</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L4579" href="#L4579">4579</a> <strong class="jxr_keyword">if</strong> (s.indexOf(c) == -1)
+<a class="jxr_linenumber" name="L4580" href="#L4580">4580</a> <strong class="jxr_keyword">return</strong> Collections.singletonList(s);
+<a class="jxr_linenumber" name="L4581" href="#L4581">4581</a>
+<a class="jxr_linenumber" name="L4582" href="#L4582">4582</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> LinkedList<String>();
+<a class="jxr_linenumber" name="L4583" href="#L4583">4583</a> <strong class="jxr_keyword">var</strong> sArray = s.toCharArray();
+<a class="jxr_linenumber" name="L4584" href="#L4584">4584</a> <strong class="jxr_keyword">var</strong> x1 = 0;
+<a class="jxr_linenumber" name="L4585" href="#L4585">4585</a> <strong class="jxr_keyword">var</strong> escapeCount = 0;
+<a class="jxr_linenumber" name="L4586" href="#L4586">4586</a> limit--;
+<a class="jxr_linenumber" name="L4587" href="#L4587">4587</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < sArray.length && limit > 0; i++) {
+<a class="jxr_linenumber" name="L4588" href="#L4588">4588</a> <strong class="jxr_keyword">if</strong> (sArray[i] == '\\')
+<a class="jxr_linenumber" name="L4589" href="#L4589">4589</a> escapeCount++;
+<a class="jxr_linenumber" name="L4590" href="#L4590">4590</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (sArray[i] == c && escapeCount % 2 == 0) {
+<a class="jxr_linenumber" name="L4591" href="#L4591">4591</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(sArray, x1, i - x1);
+<a class="jxr_linenumber" name="L4592" href="#L4592">4592</a> <strong class="jxr_keyword">var</strong> s3 = unEscapeChars(s2, escapeChars);
+<a class="jxr_linenumber" name="L4593" href="#L4593">4593</a> l.add(s3.trim());
+<a class="jxr_linenumber" name="L4594" href="#L4594">4594</a> limit--;
+<a class="jxr_linenumber" name="L4595" href="#L4595">4595</a> x1 = i + 1;
+<a class="jxr_linenumber" name="L4596" href="#L4596">4596</a> }
+<a class="jxr_linenumber" name="L4597" href="#L4597">4597</a> <strong class="jxr_keyword">if</strong> (sArray[i] != '\\')
+<a class="jxr_linenumber" name="L4598" href="#L4598">4598</a> escapeCount = 0;
+<a class="jxr_linenumber" name="L4599" href="#L4599">4599</a> }
+<a class="jxr_linenumber" name="L4600" href="#L4600">4600</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(sArray, x1, sArray.length - x1);
+<a class="jxr_linenumber" name="L4601" href="#L4601">4601</a> <strong class="jxr_keyword">var</strong> s3 = unEscapeChars(s2, escapeChars);
+<a class="jxr_linenumber" name="L4602" href="#L4602">4602</a> l.add(s3.trim());
+<a class="jxr_linenumber" name="L4603" href="#L4603">4603</a>
+<a class="jxr_linenumber" name="L4604" href="#L4604">4604</a> <strong class="jxr_keyword">return</strong> l;
+<a class="jxr_linenumber" name="L4605" href="#L4605">4605</a> }
+<a class="jxr_linenumber" name="L4606" href="#L4606">4606</a>
+<a class="jxr_linenumber" name="L4607" href="#L4607">4607</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4608" href="#L4608">4608</a> <em class="jxr_javadoccomment"> * Same as {@link splita} but consumes the tokens instead of creating an array.</em>
+<a class="jxr_linenumber" name="L4609" href="#L4609">4609</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4610" href="#L4610">4610</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
+<a class="jxr_linenumber" name="L4611" href="#L4611">4611</a> <em class="jxr_javadoccomment"> * @param consumer The consumer of the tokens.</em>
+<a class="jxr_linenumber" name="L4612" href="#L4612">4612</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4613" href="#L4613">4613</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> split(String s, Consumer<String> consumer) {
+<a class="jxr_linenumber" name="L4614" href="#L4614">4614</a> StringUtils.split(s, ',', consumer);
+<a class="jxr_linenumber" name="L4615" href="#L4615">4615</a> }
<a class="jxr_linenumber" name="L4616" href="#L4616">4616</a>
-<a class="jxr_linenumber" name="L4617" href="#L4617">4617</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4618" href="#L4618">4618</a> <em class="jxr_javadoccomment"> * Splits a comma-delimited list into an array of strings.</em>
-<a class="jxr_linenumber" name="L4619" href="#L4619">4619</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4620" href="#L4620">4620</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
-<a class="jxr_linenumber" name="L4621" href="#L4621">4621</a> <em class="jxr_javadoccomment"> * @return An array of split strings.</em>
-<a class="jxr_linenumber" name="L4622" href="#L4622">4622</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4623" href="#L4623">4623</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splita(String s) {
-<a class="jxr_linenumber" name="L4624" href="#L4624">4624</a> <strong class="jxr_keyword">return</strong> splita(s, ',');
-<a class="jxr_linenumber" name="L4625" href="#L4625">4625</a> }
-<a class="jxr_linenumber" name="L4626" href="#L4626">4626</a>
-<a class="jxr_linenumber" name="L4627" href="#L4627">4627</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4628" href="#L4628">4628</a> <em class="jxr_javadoccomment"> * Splits a character-delimited string into a string array.</em>
-<a class="jxr_linenumber" name="L4629" href="#L4629">4629</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4630" href="#L4630">4630</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4631" href="#L4631">4631</a> <em class="jxr_javadoccomment"> * Does not split on escaped-delimiters (e.g. "\,");</em>
-<a class="jxr_linenumber" name="L4632" href="#L4632">4632</a> <em class="jxr_javadoccomment"> * Resulting tokens are trimmed of whitespace.</em>
+<a class="jxr_linenumber" name="L4617" href="#L4617">4617</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L4618" href="#L4618">4618</a> <em class="jxr_comment">// String manipulation methods</em>
+<a class="jxr_linenumber" name="L4619" href="#L4619">4619</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L4620" href="#L4620">4620</a>
+<a class="jxr_linenumber" name="L4621" href="#L4621">4621</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4622" href="#L4622">4622</a> <em class="jxr_javadoccomment"> * Splits a comma-delimited list into an array of strings.</em>
+<a class="jxr_linenumber" name="L4623" href="#L4623">4623</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4624" href="#L4624">4624</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
+<a class="jxr_linenumber" name="L4625" href="#L4625">4625</a> <em class="jxr_javadoccomment"> * @return An array of split strings.</em>
+<a class="jxr_linenumber" name="L4626" href="#L4626">4626</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4627" href="#L4627">4627</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splita(String s) {
+<a class="jxr_linenumber" name="L4628" href="#L4628">4628</a> <strong class="jxr_keyword">return</strong> splita(s, ',');
+<a class="jxr_linenumber" name="L4629" href="#L4629">4629</a> }
+<a class="jxr_linenumber" name="L4630" href="#L4630">4630</a>
+<a class="jxr_linenumber" name="L4631" href="#L4631">4631</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4632" href="#L4632">4632</a> <em class="jxr_javadoccomment"> * Splits a character-delimited string into a string array.</em>
<a class="jxr_linenumber" name="L4633" href="#L4633">4633</a> <em class="jxr_javadoccomment"> *</em>
<a class="jxr_linenumber" name="L4634" href="#L4634">4634</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4635" href="#L4635">4635</a> <em class="jxr_javadoccomment"> * <b>NOTE:</b> This behavior is different than the Jakarta equivalent.</em>
-<a class="jxr_linenumber" name="L4636" href="#L4636">4636</a> <em class="jxr_javadoccomment"> * split("a,b,c",',') -&gt; {"a","b","c"}</em>
-<a class="jxr_linenumber" name="L4637" href="#L4637">4637</a> <em class="jxr_javadoccomment"> * split("a, b ,c ",',') -&gt; {"a","b","c"}</em>
-<a class="jxr_linenumber" name="L4638" href="#L4638">4638</a> <em class="jxr_javadoccomment"> * split("a,,c",',') -&gt; {"a","","c"}</em>
-<a class="jxr_linenumber" name="L4639" href="#L4639">4639</a> <em class="jxr_javadoccomment"> * split(",,",',') -&gt; {"","",""}</em>
-<a class="jxr_linenumber" name="L4640" href="#L4640">4640</a> <em class="jxr_javadoccomment"> * split("",',') -&gt; {}</em>
-<a class="jxr_linenumber" name="L4641" href="#L4641">4641</a> <em class="jxr_javadoccomment"> * split(null,',') -&gt; null</em>
-<a class="jxr_linenumber" name="L4642" href="#L4642">4642</a> <em class="jxr_javadoccomment"> * split("a,b\,c,d", ',', false) -&gt; {"a","b\,c","d"}</em>
-<a class="jxr_linenumber" name="L4643" href="#L4643">4643</a> <em class="jxr_javadoccomment"> * split("a,b\\,c,d", ',', false) -&gt; {"a","b\","c","d"}</em>
-<a class="jxr_linenumber" name="L4644" href="#L4644">4644</a> <em class="jxr_javadoccomment"> * split("a,b\,c,d", ',', true) -&gt; {"a","b,c","d"}</em>
-<a class="jxr_linenumber" name="L4645" href="#L4645">4645</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4646" href="#L4646">4646</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4647" href="#L4647">4647</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
-<a class="jxr_linenumber" name="L4648" href="#L4648">4648</a> <em class="jxr_javadoccomment"> * @return The tokens, or <jk>null</jk> if the string was null.</em>
-<a class="jxr_linenumber" name="L4649" href="#L4649">4649</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4650" href="#L4650">4650</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splita(String s, <strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L4651" href="#L4651">4651</a> <strong class="jxr_keyword">return</strong> splita(s, c, Integer.MAX_VALUE);
-<a class="jxr_linenumber" name="L4652" href="#L4652">4652</a> }
-<a class="jxr_linenumber" name="L4653" href="#L4653">4653</a>
-<a class="jxr_linenumber" name="L4654" href="#L4654">4654</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4655" href="#L4655">4655</a> <em class="jxr_javadoccomment"> * Same as {@link #splita(String, char)} but limits the number of tokens returned.</em>
-<a class="jxr_linenumber" name="L4656" href="#L4656">4656</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4657" href="#L4657">4657</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4658" href="#L4658">4658</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
-<a class="jxr_linenumber" name="L4659" href="#L4659">4659</a> <em class="jxr_javadoccomment"> * @param limit The maximum number of tokens to return.</em>
-<a class="jxr_linenumber" name="L4660" href="#L4660">4660</a> <em class="jxr_javadoccomment"> * @return The tokens, or <jk>null</jk> if the string was null.</em>
-<a class="jxr_linenumber" name="L4661" href="#L4661">4661</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4662" href="#L4662">4662</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splita(String s, <strong class="jxr_keyword">char</strong> c, <strong class="jxr_keyword">int</strong> limit) {
-<a class="jxr_linenumber" name="L4663" href="#L4663">4663</a> <strong class="jxr_keyword">var</strong> l = StringUtils.split(s, c, limit);
-<a class="jxr_linenumber" name="L4664" href="#L4664">4664</a> <strong class="jxr_keyword">return</strong> l == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : l.toArray(<strong class="jxr_keyword">new</strong> String[l.size()]);
-<a class="jxr_linenumber" name="L4665" href="#L4665">4665</a> }
-<a class="jxr_linenumber" name="L4666" href="#L4666">4666</a>
-<a class="jxr_linenumber" name="L4667" href="#L4667">4667</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4668" href="#L4668">4668</a> <em class="jxr_javadoccomment"> * Same as {@link #splita(String, char)} except splits all strings in the input and returns a single result.</em>
-<a class="jxr_linenumber" name="L4669" href="#L4669">4669</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4670" href="#L4670">4670</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4671" href="#L4671">4671</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
-<a class="jxr_linenumber" name="L4672" href="#L4672">4672</a> <em class="jxr_javadoccomment"> * @return The tokens, or null if the input array was null</em>
-<a class="jxr_linenumber" name="L4673" href="#L4673">4673</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4674" href="#L4674">4674</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splita(String[] s, <strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L4675" href="#L4675">4675</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4676" href="#L4676">4676</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L4677" href="#L4677">4677</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> LinkedList<String>();
-<a class="jxr_linenumber" name="L4678" href="#L4678">4678</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> ss : s) {
-<a class="jxr_linenumber" name="L4679" href="#L4679">4679</a> <strong class="jxr_keyword">if</strong> (ss == <strong class="jxr_keyword">null</strong> || ss.indexOf(c) == -1)
-<a class="jxr_linenumber" name="L4680" href="#L4680">4680</a> l.add(ss);
-<a class="jxr_linenumber" name="L4681" href="#L4681">4681</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L4682" href="#L4682">4682</a> Collections.addAll(l, splita(ss, c));
-<a class="jxr_linenumber" name="L4683" href="#L4683">4683</a> }
-<a class="jxr_linenumber" name="L4684" href="#L4684">4684</a> <strong class="jxr_keyword">return</strong> l.toArray(<strong class="jxr_keyword">new</strong> String[l.size()]);
-<a class="jxr_linenumber" name="L4685" href="#L4685">4685</a> }
-<a class="jxr_linenumber" name="L4686" href="#L4686">4686</a>
-<a class="jxr_linenumber" name="L4687" href="#L4687">4687</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4688" href="#L4688">4688</a> <em class="jxr_javadoccomment"> * Splits a list of key-value pairs into an ordered map.</em>
-<a class="jxr_linenumber" name="L4689" href="#L4689">4689</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4690" href="#L4690">4690</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4691" href="#L4691">4691</a> <em class="jxr_javadoccomment"> * Example:</em>
-<a class="jxr_linenumber" name="L4692" href="#L4692">4692</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4693" href="#L4693">4693</a> <em class="jxr_javadoccomment"> * String <jv>in</jv> = <js>"foo=1;bar=2"</js>;</em>
-<a class="jxr_linenumber" name="L4694" href="#L4694">4694</a> <em class="jxr_javadoccomment"> * Map <jv>map</jv> = StringUtils.<jsm>splitMap</jsm>(in, <js>';'</js>, <js>'='</js>, <jk>true</jk>);</em>
-<a class="jxr_linenumber" name="L4695" href="#L4695">4695</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4696" href="#L4696">4696</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4697" href="#L4697">4697</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
-<a class="jxr_linenumber" name="L4698" href="#L4698">4698</a> <em class="jxr_javadoccomment"> * @param trim Trim strings after parsing.</em>
-<a class="jxr_linenumber" name="L4699" href="#L4699">4699</a> <em class="jxr_javadoccomment"> * @return The parsed map, or null if the string was null.</em>
-<a class="jxr_linenumber" name="L4700" href="#L4700">4700</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4701" href="#L4701">4701</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Map<String,String> splitMap(String s, <strong class="jxr_keyword">boolean</strong> trim) {
-<a class="jxr_linenumber" name="L4702" href="#L4702">4702</a>
-<a class="jxr_linenumber" name="L4703" href="#L4703">4703</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4704" href="#L4704">4704</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L4705" href="#L4705">4705</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
-<a class="jxr_linenumber" name="L4706" href="#L4706">4706</a> <strong class="jxr_keyword">return</strong> Collections.emptyMap();
-<a class="jxr_linenumber" name="L4707" href="#L4707">4707</a>
-<a class="jxr_linenumber" name="L4708" href="#L4708">4708</a> <strong class="jxr_keyword">var</strong> m = <strong class="jxr_keyword">new</strong> LinkedHashMap<String,String>();
-<a class="jxr_linenumber" name="L4709" href="#L4709">4709</a>
-<a class="jxr_linenumber" name="L4710" href="#L4710">4710</a> <em class="jxr_comment">// S1: Found start of key, looking for equals.</em>
-<a class="jxr_linenumber" name="L4711" href="#L4711">4711</a> <em class="jxr_comment">// S2: Found equals, looking for delimiter (or end).</em>
-<a class="jxr_linenumber" name="L4712" href="#L4712">4712</a>
-<a class="jxr_linenumber" name="L4713" href="#L4713">4713</a> <strong class="jxr_keyword">var</strong> state = S1;
-<a class="jxr_linenumber" name="L4714" href="#L4714">4714</a>
-<a class="jxr_linenumber" name="L4715" href="#L4715">4715</a> <strong class="jxr_keyword">var</strong> sArray = s.toCharArray();
-<a class="jxr_linenumber" name="L4716" href="#L4716">4716</a> <strong class="jxr_keyword">var</strong> x1 = 0;
-<a class="jxr_linenumber" name="L4717" href="#L4717">4717</a> <strong class="jxr_keyword">var</strong> escapeCount = 0;
-<a class="jxr_linenumber" name="L4718" href="#L4718">4718</a> <strong class="jxr_keyword">var</strong> key = (String)<strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4719" href="#L4719">4719</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < sArray.length + 1; i++) {
-<a class="jxr_linenumber" name="L4720" href="#L4720">4720</a> <strong class="jxr_keyword">var</strong> c = i == sArray.length ? ',' : sArray[i];
-<a class="jxr_linenumber" name="L4721" href="#L4721">4721</a> <strong class="jxr_keyword">if</strong> (c == '\\')
-<a class="jxr_linenumber" name="L4722" href="#L4722">4722</a> escapeCount++;
-<a class="jxr_linenumber" name="L4723" href="#L4723">4723</a> <strong class="jxr_keyword">if</strong> (escapeCount % 2 == 0) {
-<a class="jxr_linenumber" name="L4724" href="#L4724">4724</a> <strong class="jxr_keyword">if</strong> (state == S1) {
-<a class="jxr_linenumber" name="L4725" href="#L4725">4725</a> <strong class="jxr_keyword">if</strong> (c == '=') {
-<a class="jxr_linenumber" name="L4726" href="#L4726">4726</a> key = s.substring(x1, i);
-<a class="jxr_linenumber" name="L4727" href="#L4727">4727</a> <strong class="jxr_keyword">if</strong> (trim)
-<a class="jxr_linenumber" name="L4728" href="#L4728">4728</a> key = trim(key);
-<a class="jxr_linenumber" name="L4729" href="#L4729">4729</a> key = unEscapeChars(key, MAP_ESCAPE_SET);
-<a class="jxr_linenumber" name="L4730" href="#L4730">4730</a> state = S2;
-<a class="jxr_linenumber" name="L4731" href="#L4731">4731</a> x1 = i + 1;
-<a class="jxr_linenumber" name="L4732" href="#L4732">4732</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == ',') {
-<a class="jxr_linenumber" name="L4733" href="#L4733">4733</a> key = s.substring(x1, i);
-<a class="jxr_linenumber" name="L4734" href="#L4734">4734</a> <strong class="jxr_keyword">if</strong> (trim)
-<a class="jxr_linenumber" name="L4735" href="#L4735">4735</a> key = trim(key);
-<a class="jxr_linenumber" name="L4736" href="#L4736">4736</a> key = unEscapeChars(key, MAP_ESCAPE_SET);
-<a class="jxr_linenumber" name="L4737" href="#L4737">4737</a> m.put(key, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L4738" href="#L4738">4738</a> state = S1;
-<a class="jxr_linenumber" name="L4739" href="#L4739">4739</a> x1 = i + 1;
-<a class="jxr_linenumber" name="L4740" href="#L4740">4740</a> }
-<a class="jxr_linenumber" name="L4741" href="#L4741">4741</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2) {
-<a class="jxr_linenumber" name="L4742" href="#L4742">4742</a> <strong class="jxr_keyword">if</strong> (c == ',') { <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L4743" href="#L4743">4743</a> <strong class="jxr_keyword">var</strong> val = s.substring(x1, i);
-<a class="jxr_linenumber" name="L4744" href="#L4744">4744</a> <strong class="jxr_keyword">if</strong> (trim)
-<a class="jxr_linenumber" name="L4745" href="#L4745">4745</a> val = trim(val);
-<a class="jxr_linenumber" name="L4746" href="#L4746">4746</a> val = unEscapeChars(val, MAP_ESCAPE_SET);
-<a class="jxr_linenumber" name="L4747" href="#L4747">4747</a> m.put(key, val);
-<a class="jxr_linenumber" name="L4748" href="#L4748">4748</a> key = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4749" href="#L4749">4749</a> x1 = i + 1;
-<a class="jxr_linenumber" name="L4750" href="#L4750">4750</a> state = S1;
-<a class="jxr_linenumber" name="L4751" href="#L4751">4751</a> }
-<a class="jxr_linenumber" name="L4752" href="#L4752">4752</a> }
-<a class="jxr_linenumber" name="L4753" href="#L4753">4753</a> }
-<a class="jxr_linenumber" name="L4754" href="#L4754">4754</a> <strong class="jxr_keyword">if</strong> (c != '\\')
-<a class="jxr_linenumber" name="L4755" href="#L4755">4755</a> escapeCount = 0;
-<a class="jxr_linenumber" name="L4756" href="#L4756">4756</a> }
-<a class="jxr_linenumber" name="L4757" href="#L4757">4757</a>
-<a class="jxr_linenumber" name="L4758" href="#L4758">4758</a> <strong class="jxr_keyword">return</strong> m;
-<a class="jxr_linenumber" name="L4759" href="#L4759">4759</a> }
-<a class="jxr_linenumber" name="L4760" href="#L4760">4760</a>
-<a class="jxr_linenumber" name="L4761" href="#L4761">4761</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4762" href="#L4762">4762</a> <em class="jxr_javadoccomment"> * Splits the method arguments in the signature of a method.</em>
-<a class="jxr_linenumber" name="L4763" href="#L4763">4763</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4764" href="#L4764">4764</a> <em class="jxr_javadoccomment"> * @param s The arguments to split.</em>
-<a class="jxr_linenumber" name="L4765" href="#L4765">4765</a> <em class="jxr_javadoccomment"> * @return The split arguments, or null if the input string is null.</em>
-<a class="jxr_linenumber" name="L4766" href="#L4766">4766</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4767" href="#L4767">4767</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splitMethodArgs(String s) {
-<a class="jxr_linenumber" name="L4768" href="#L4768">4768</a>
-<a class="jxr_linenumber" name="L4769" href="#L4769">4769</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4770" href="#L4770">4770</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L4771" href="#L4771">4771</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
-<a class="jxr_linenumber" name="L4772" href="#L4772">4772</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[0];
-<a class="jxr_linenumber" name="L4773" href="#L4773">4773</a> <strong class="jxr_keyword">if</strong> (s.indexOf(',') == -1)
-<a class="jxr_linenumber" name="L4774" href="#L4774">4774</a> <strong class="jxr_keyword">return</strong> a(s);
-<a class="jxr_linenumber" name="L4775" href="#L4775">4775</a>
-<a class="jxr_linenumber" name="L4776" href="#L4776">4776</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> LinkedList<String>();
-<a class="jxr_linenumber" name="L4777" href="#L4777">4777</a> <strong class="jxr_keyword">var</strong> sArray = s.toCharArray();
-<a class="jxr_linenumber" name="L4778" href="#L4778">4778</a> <strong class="jxr_keyword">var</strong> x1 = 0;
-<a class="jxr_linenumber" name="L4779" href="#L4779">4779</a> <strong class="jxr_keyword">var</strong> paramDepth = 0;
-<a class="jxr_linenumber" name="L4780" href="#L4780">4780</a>
-<a class="jxr_linenumber" name="L4781" href="#L4781">4781</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < sArray.length; i++) {
-<a class="jxr_linenumber" name="L4782" href="#L4782">4782</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L4783" href="#L4783">4783</a> <strong class="jxr_keyword">if</strong> (c == '>')
-<a class="jxr_linenumber" name="L4784" href="#L4784">4784</a> paramDepth++;
-<a class="jxr_linenumber" name="L4785" href="#L4785">4785</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '<')
-<a class="jxr_linenumber" name="L4786" href="#L4786">4786</a> paramDepth--;
-<a class="jxr_linenumber" name="L4787" href="#L4787">4787</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == ',' && paramDepth == 0) {
-<a class="jxr_linenumber" name="L4788" href="#L4788">4788</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(sArray, x1, i - x1);
-<a class="jxr_linenumber" name="L4789" href="#L4789">4789</a> l.add(s2.trim());
-<a class="jxr_linenumber" name="L4790" href="#L4790">4790</a> x1 = i + 1;
-<a class="jxr_linenumber" name="L4791" href="#L4791">4791</a> }
-<a class="jxr_linenumber" name="L4792" href="#L4792">4792</a> }
-<a class="jxr_linenumber" name="L4793" href="#L4793">4793</a>
-<a class="jxr_linenumber" name="L4794" href="#L4794">4794</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(sArray, x1, sArray.length - x1);
-<a class="jxr_linenumber" name="L4795" href="#L4795">4795</a> l.add(s2.trim());
-<a class="jxr_linenumber" name="L4796" href="#L4796">4796</a>
-<a class="jxr_linenumber" name="L4797" href="#L4797">4797</a> <strong class="jxr_keyword">return</strong> l.toArray(<strong class="jxr_keyword">new</strong> String[l.size()]);
-<a class="jxr_linenumber" name="L4798" href="#L4798">4798</a> }
-<a class="jxr_linenumber" name="L4799" href="#L4799">4799</a>
-<a class="jxr_linenumber" name="L4800" href="#L4800">4800</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4801" href="#L4801">4801</a> <em class="jxr_javadoccomment"> * Splits a comma-delimited list containing "nesting constructs".</em>
-<a class="jxr_linenumber" name="L4802" href="#L4802">4802</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4803" href="#L4803">4803</a> <em class="jxr_javadoccomment"> * Nesting constructs are simple embedded "{...}" comma-delimted lists.</em>
-<a class="jxr_linenumber" name="L4804" href="#L4804">4804</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4805" href="#L4805">4805</a> <em class="jxr_javadoccomment"> * Example:</em>
-<a class="jxr_linenumber" name="L4806" href="#L4806">4806</a> <em class="jxr_javadoccomment"> * "a{b,c},d" -> ["a{b,c}","d"]</em>
-<a class="jxr_linenumber" name="L4807" href="#L4807">4807</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4808" href="#L4808">4808</a> <em class="jxr_javadoccomment"> * Handles escapes and trims whitespace from tokens.</em>
-<a class="jxr_linenumber" name="L4809" href="#L4809">4809</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4810" href="#L4810">4810</a> <em class="jxr_javadoccomment"> * @param s The input string.</em>
-<a class="jxr_linenumber" name="L4811" href="#L4811">4811</a> <em class="jxr_javadoccomment"> * @return</em>
-<a class="jxr_linenumber" name="L4812" href="#L4812">4812</a> <em class="jxr_javadoccomment"> * The results, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4813" href="#L4813">4813</a> <em class="jxr_javadoccomment"> * <br>An empty string results in an empty array.</em>
-<a class="jxr_linenumber" name="L4814" href="#L4814">4814</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4815" href="#L4815">4815</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> splitNested(String s) {
-<a class="jxr_linenumber" name="L4816" href="#L4816">4816</a> <strong class="jxr_keyword">var</strong> escapeChars = getEscapeSet(',');
-<a class="jxr_linenumber" name="L4817" href="#L4817">4817</a>
-<a class="jxr_linenumber" name="L4818" href="#L4818">4818</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4819" href="#L4819">4819</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L4820" href="#L4820">4820</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
-<a class="jxr_linenumber" name="L4821" href="#L4821">4821</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L4822" href="#L4822">4822</a> <strong class="jxr_keyword">if</strong> (s.indexOf(',') == -1)
-<a class="jxr_linenumber" name="L4823" href="#L4823">4823</a> <strong class="jxr_keyword">return</strong> Collections.singletonList(trim(s));
-<a class="jxr_linenumber" name="L4824" href="#L4824">4824</a>
-<a class="jxr_linenumber" name="L4825" href="#L4825">4825</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> LinkedList<String>();
-<a class="jxr_linenumber" name="L4826" href="#L4826">4826</a>
-<a class="jxr_linenumber" name="L4827" href="#L4827">4827</a> <strong class="jxr_keyword">var</strong> x1 = 0;
-<a class="jxr_linenumber" name="L4828" href="#L4828">4828</a> <strong class="jxr_keyword">var</strong> inEscape = false;
-<a class="jxr_linenumber" name="L4829" href="#L4829">4829</a> <strong class="jxr_keyword">var</strong> depthCount = 0;
+<a class="jxr_linenumber" name="L4635" href="#L4635">4635</a> <em class="jxr_javadoccomment"> * Does not split on escaped-delimiters (e.g. "\,");</em>
+<a class="jxr_linenumber" name="L4636" href="#L4636">4636</a> <em class="jxr_javadoccomment"> * Resulting tokens are trimmed of whitespace.</em>
+<a class="jxr_linenumber" name="L4637" href="#L4637">4637</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4638" href="#L4638">4638</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4639" href="#L4639">4639</a> <em class="jxr_javadoccomment"> * <b>NOTE:</b> This behavior is different than the Jakarta equivalent.</em>
+<a class="jxr_linenumber" name="L4640" href="#L4640">4640</a> <em class="jxr_javadoccomment"> * split("a,b,c",',') -&gt; {"a","b","c"}</em>
+<a class="jxr_linenumber" name="L4641" href="#L4641">4641</a> <em class="jxr_javadoccomment"> * split("a, b ,c ",',') -&gt; {"a","b","c"}</em>
+<a class="jxr_linenumber" name="L4642" href="#L4642">4642</a> <em class="jxr_javadoccomment"> * split("a,,c",',') -&gt; {"a","","c"}</em>
+<a class="jxr_linenumber" name="L4643" href="#L4643">4643</a> <em class="jxr_javadoccomment"> * split(",,",',') -&gt; {"","",""}</em>
+<a class="jxr_linenumber" name="L4644" href="#L4644">4644</a> <em class="jxr_javadoccomment"> * split("",',') -&gt; {}</em>
+<a class="jxr_linenumber" name="L4645" href="#L4645">4645</a> <em class="jxr_javadoccomment"> * split(null,',') -&gt; null</em>
+<a class="jxr_linenumber" name="L4646" href="#L4646">4646</a> <em class="jxr_javadoccomment"> * split("a,b\,c,d", ',', false) -&gt; {"a","b\,c","d"}</em>
+<a class="jxr_linenumber" name="L4647" href="#L4647">4647</a> <em class="jxr_javadoccomment"> * split("a,b\\,c,d", ',', false) -&gt; {"a","b\","c","d"}</em>
+<a class="jxr_linenumber" name="L4648" href="#L4648">4648</a> <em class="jxr_javadoccomment"> * split("a,b\,c,d", ',', true) -&gt; {"a","b,c","d"}</em>
+<a class="jxr_linenumber" name="L4649" href="#L4649">4649</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4650" href="#L4650">4650</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4651" href="#L4651">4651</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
+<a class="jxr_linenumber" name="L4652" href="#L4652">4652</a> <em class="jxr_javadoccomment"> * @return The tokens, or <jk>null</jk> if the string was null.</em>
+<a class="jxr_linenumber" name="L4653" href="#L4653">4653</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4654" href="#L4654">4654</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splita(String s, <strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L4655" href="#L4655">4655</a> <strong class="jxr_keyword">return</strong> splita(s, c, Integer.MAX_VALUE);
+<a class="jxr_linenumber" name="L4656" href="#L4656">4656</a> }
+<a class="jxr_linenumber" name="L4657" href="#L4657">4657</a>
+<a class="jxr_linenumber" name="L4658" href="#L4658">4658</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4659" href="#L4659">4659</a> <em class="jxr_javadoccomment"> * Same as {@link #splita(String, char)} but limits the number of tokens returned.</em>
+<a class="jxr_linenumber" name="L4660" href="#L4660">4660</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4661" href="#L4661">4661</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4662" href="#L4662">4662</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
+<a class="jxr_linenumber" name="L4663" href="#L4663">4663</a> <em class="jxr_javadoccomment"> * @param limit The maximum number of tokens to return.</em>
+<a class="jxr_linenumber" name="L4664" href="#L4664">4664</a> <em class="jxr_javadoccomment"> * @return The tokens, or <jk>null</jk> if the string was null.</em>
+<a class="jxr_linenumber" name="L4665" href="#L4665">4665</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4666" href="#L4666">4666</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splita(String s, <strong class="jxr_keyword">char</strong> c, <strong class="jxr_keyword">int</strong> limit) {
+<a class="jxr_linenumber" name="L4667" href="#L4667">4667</a> <strong class="jxr_keyword">var</strong> l = StringUtils.split(s, c, limit);
+<a class="jxr_linenumber" name="L4668" href="#L4668">4668</a> <strong class="jxr_keyword">return</strong> l == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : l.toArray(<strong class="jxr_keyword">new</strong> String[l.size()]);
+<a class="jxr_linenumber" name="L4669" href="#L4669">4669</a> }
+<a class="jxr_linenumber" name="L4670" href="#L4670">4670</a>
+<a class="jxr_linenumber" name="L4671" href="#L4671">4671</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4672" href="#L4672">4672</a> <em class="jxr_javadoccomment"> * Same as {@link #splita(String, char)} except splits all strings in the input and returns a single result.</em>
+<a class="jxr_linenumber" name="L4673" href="#L4673">4673</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4674" href="#L4674">4674</a> <em class="jxr_javadoccomment"> * @param s The string to split. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4675" href="#L4675">4675</a> <em class="jxr_javadoccomment"> * @param c The character to split on.</em>
+<a class="jxr_linenumber" name="L4676" href="#L4676">4676</a> <em class="jxr_javadoccomment"> * @return The tokens, or null if the input array was null</em>
+<a class="jxr_linenumber" name="L4677" href="#L4677">4677</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4678" href="#L4678">4678</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splita(String[] s, <strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L4679" href="#L4679">4679</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4680" href="#L4680">4680</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L4681" href="#L4681">4681</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> LinkedList<String>();
+<a class="jxr_linenumber" name="L4682" href="#L4682">4682</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> ss : s) {
+<a class="jxr_linenumber" name="L4683" href="#L4683">4683</a> <strong class="jxr_keyword">if</strong> (ss == <strong class="jxr_keyword">null</strong> || ss.indexOf(c) == -1)
+<a class="jxr_linenumber" name="L4684" href="#L4684">4684</a> l.add(ss);
+<a class="jxr_linenumber" name="L4685" href="#L4685">4685</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L4686" href="#L4686">4686</a> Collections.addAll(l, splita(ss, c));
+<a class="jxr_linenumber" name="L4687" href="#L4687">4687</a> }
+<a class="jxr_linenumber" name="L4688" href="#L4688">4688</a> <strong class="jxr_keyword">return</strong> l.toArray(<strong class="jxr_keyword">new</strong> String[l.size()]);
+<a class="jxr_linenumber" name="L4689" href="#L4689">4689</a> }
+<a class="jxr_linenumber" name="L4690" href="#L4690">4690</a>
+<a class="jxr_linenumber" name="L4691" href="#L4691">4691</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4692" href="#L4692">4692</a> <em class="jxr_javadoccomment"> * Splits a list of key-value pairs into an ordered map.</em>
+<a class="jxr_linenumber" name="L4693" href="#L4693">4693</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4694" href="#L4694">4694</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4695" href="#L4695">4695</a> <em class="jxr_javadoccomment"> * Example:</em>
+<a class="jxr_linenumber" name="L4696" href="#L4696">4696</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4697" href="#L4697">4697</a> <em class="jxr_javadoccomment"> * String <jv>in</jv> = <js>"foo=1;bar=2"</js>;</em>
+<a class="jxr_linenumber" name="L4698" href="#L4698">4698</a> <em class="jxr_javadoccomment"> * Map <jv>map</jv> = StringUtils.<jsm>splitMap</jsm>(in, <js>';'</js>, <js>'='</js>, <jk>true</jk>);</em>
+<a class="jxr_linenumber" name="L4699" href="#L4699">4699</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4700" href="#L4700">4700</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4701" href="#L4701">4701</a> <em class="jxr_javadoccomment"> * @param s The string to split.</em>
+<a class="jxr_linenumber" name="L4702" href="#L4702">4702</a> <em class="jxr_javadoccomment"> * @param trim Trim strings after parsing.</em>
+<a class="jxr_linenumber" name="L4703" href="#L4703">4703</a> <em class="jxr_javadoccomment"> * @return The parsed map, or null if the string was null.</em>
+<a class="jxr_linenumber" name="L4704" href="#L4704">4704</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4705" href="#L4705">4705</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Map<String,String> splitMap(String s, <strong class="jxr_keyword">boolean</strong> trim) {
+<a class="jxr_linenumber" name="L4706" href="#L4706">4706</a>
+<a class="jxr_linenumber" name="L4707" href="#L4707">4707</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4708" href="#L4708">4708</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L4709" href="#L4709">4709</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
+<a class="jxr_linenumber" name="L4710" href="#L4710">4710</a> <strong class="jxr_keyword">return</strong> Collections.emptyMap();
+<a class="jxr_linenumber" name="L4711" href="#L4711">4711</a>
+<a class="jxr_linenumber" name="L4712" href="#L4712">4712</a> <strong class="jxr_keyword">var</strong> m = <strong class="jxr_keyword">new</strong> LinkedHashMap<String,String>();
+<a class="jxr_linenumber" name="L4713" href="#L4713">4713</a>
+<a class="jxr_linenumber" name="L4714" href="#L4714">4714</a> <em class="jxr_comment">// S1: Found start of key, looking for equals.</em>
+<a class="jxr_linenumber" name="L4715" href="#L4715">4715</a> <em class="jxr_comment">// S2: Found equals, looking for delimiter (or end).</em>
+<a class="jxr_linenumber" name="L4716" href="#L4716">4716</a>
+<a class="jxr_linenumber" name="L4717" href="#L4717">4717</a> <strong class="jxr_keyword">var</strong> state = S1;
+<a class="jxr_linenumber" name="L4718" href="#L4718">4718</a>
+<a class="jxr_linenumber" name="L4719" href="#L4719">4719</a> <strong class="jxr_keyword">var</strong> sArray = s.toCharArray();
+<a class="jxr_linenumber" name="L4720" href="#L4720">4720</a> <strong class="jxr_keyword">var</strong> x1 = 0;
+<a class="jxr_linenumber" name="L4721" href="#L4721">4721</a> <strong class="jxr_keyword">var</strong> escapeCount = 0;
+<a class="jxr_linenumber" name="L4722" href="#L4722">4722</a> <strong class="jxr_keyword">var</strong> key = (String)<strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4723" href="#L4723">4723</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < sArray.length + 1; i++) {
+<a class="jxr_linenumber" name="L4724" href="#L4724">4724</a> <strong class="jxr_keyword">var</strong> c = i == sArray.length ? ',' : sArray[i];
+<a class="jxr_linenumber" name="L4725" href="#L4725">4725</a> <strong class="jxr_keyword">if</strong> (c == '\\')
+<a class="jxr_linenumber" name="L4726" href="#L4726">4726</a> escapeCount++;
+<a class="jxr_linenumber" name="L4727" href="#L4727">4727</a> <strong class="jxr_keyword">if</strong> (escapeCount % 2 == 0) {
+<a class="jxr_linenumber" name="L4728" href="#L4728">4728</a> <strong class="jxr_keyword">if</strong> (state == S1) {
+<a class="jxr_linenumber" name="L4729" href="#L4729">4729</a> <strong class="jxr_keyword">if</strong> (c == '=') {
+<a class="jxr_linenumber" name="L4730" href="#L4730">4730</a> key = s.substring(x1, i);
+<a class="jxr_linenumber" name="L4731" href="#L4731">4731</a> <strong class="jxr_keyword">if</strong> (trim)
+<a class="jxr_linenumber" name="L4732" href="#L4732">4732</a> key = trim(key);
+<a class="jxr_linenumber" name="L4733" href="#L4733">4733</a> key = unEscapeChars(key, MAP_ESCAPE_SET);
+<a class="jxr_linenumber" name="L4734" href="#L4734">4734</a> state = S2;
+<a class="jxr_linenumber" name="L4735" href="#L4735">4735</a> x1 = i + 1;
+<a class="jxr_linenumber" name="L4736" href="#L4736">4736</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == ',') {
+<a class="jxr_linenumber" name="L4737" href="#L4737">4737</a> key = s.substring(x1, i);
+<a class="jxr_linenumber" name="L4738" href="#L4738">4738</a> <strong class="jxr_keyword">if</strong> (trim)
+<a class="jxr_linenumber" name="L4739" href="#L4739">4739</a> key = trim(key);
+<a class="jxr_linenumber" name="L4740" href="#L4740">4740</a> key = unEscapeChars(key, MAP_ESCAPE_SET);
+<a class="jxr_linenumber" name="L4741" href="#L4741">4741</a> m.put(key, <span class="jxr_string">""</span>);
+<a class="jxr_linenumber" name="L4742" href="#L4742">4742</a> state = S1;
+<a class="jxr_linenumber" name="L4743" href="#L4743">4743</a> x1 = i + 1;
+<a class="jxr_linenumber" name="L4744" href="#L4744">4744</a> }
+<a class="jxr_linenumber" name="L4745" href="#L4745">4745</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2) {
+<a class="jxr_linenumber" name="L4746" href="#L4746">4746</a> <strong class="jxr_keyword">if</strong> (c == ',') { <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L4747" href="#L4747">4747</a> <strong class="jxr_keyword">var</strong> val = s.substring(x1, i);
+<a class="jxr_linenumber" name="L4748" href="#L4748">4748</a> <strong class="jxr_keyword">if</strong> (trim)
+<a class="jxr_linenumber" name="L4749" href="#L4749">4749</a> val = trim(val);
+<a class="jxr_linenumber" name="L4750" href="#L4750">4750</a> val = unEscapeChars(val, MAP_ESCAPE_SET);
+<a class="jxr_linenumber" name="L4751" href="#L4751">4751</a> m.put(key, val);
+<a class="jxr_linenumber" name="L4752" href="#L4752">4752</a> key = <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4753" href="#L4753">4753</a> x1 = i + 1;
+<a class="jxr_linenumber" name="L4754" href="#L4754">4754</a> state = S1;
+<a class="jxr_linenumber" name="L4755" href="#L4755">4755</a> }
+<a class="jxr_linenumber" name="L4756" href="#L4756">4756</a> }
+<a class="jxr_linenumber" name="L4757" href="#L4757">4757</a> }
+<a class="jxr_linenumber" name="L4758" href="#L4758">4758</a> <strong class="jxr_keyword">if</strong> (c != '\\')
+<a class="jxr_linenumber" name="L4759" href="#L4759">4759</a> escapeCount = 0;
+<a class="jxr_linenumber" name="L4760" href="#L4760">4760</a> }
+<a class="jxr_linenumber" name="L4761" href="#L4761">4761</a>
+<a class="jxr_linenumber" name="L4762" href="#L4762">4762</a> <strong class="jxr_keyword">return</strong> m;
+<a class="jxr_linenumber" name="L4763" href="#L4763">4763</a> }
+<a class="jxr_linenumber" name="L4764" href="#L4764">4764</a>
+<a class="jxr_linenumber" name="L4765" href="#L4765">4765</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4766" href="#L4766">4766</a> <em class="jxr_javadoccomment"> * Splits the method arguments in the signature of a method.</em>
+<a class="jxr_linenumber" name="L4767" href="#L4767">4767</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4768" href="#L4768">4768</a> <em class="jxr_javadoccomment"> * @param s The arguments to split.</em>
+<a class="jxr_linenumber" name="L4769" href="#L4769">4769</a> <em class="jxr_javadoccomment"> * @return The split arguments, or null if the input string is null.</em>
+<a class="jxr_linenumber" name="L4770" href="#L4770">4770</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4771" href="#L4771">4771</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splitMethodArgs(String s) {
+<a class="jxr_linenumber" name="L4772" href="#L4772">4772</a>
+<a class="jxr_linenumber" name="L4773" href="#L4773">4773</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4774" href="#L4774">4774</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L4775" href="#L4775">4775</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
+<a class="jxr_linenumber" name="L4776" href="#L4776">4776</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[0];
+<a class="jxr_linenumber" name="L4777" href="#L4777">4777</a> <strong class="jxr_keyword">if</strong> (s.indexOf(',') == -1)
+<a class="jxr_linenumber" name="L4778" href="#L4778">4778</a> <strong class="jxr_keyword">return</strong> a(s);
+<a class="jxr_linenumber" name="L4779" href="#L4779">4779</a>
+<a class="jxr_linenumber" name="L4780" href="#L4780">4780</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> LinkedList<String>();
+<a class="jxr_linenumber" name="L4781" href="#L4781">4781</a> <strong class="jxr_keyword">var</strong> sArray = s.toCharArray();
+<a class="jxr_linenumber" name="L4782" href="#L4782">4782</a> <strong class="jxr_keyword">var</strong> x1 = 0;
+<a class="jxr_linenumber" name="L4783" href="#L4783">4783</a> <strong class="jxr_keyword">var</strong> paramDepth = 0;
+<a class="jxr_linenumber" name="L4784" href="#L4784">4784</a>
+<a class="jxr_linenumber" name="L4785" href="#L4785">4785</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < sArray.length; i++) {
+<a class="jxr_linenumber" name="L4786" href="#L4786">4786</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L4787" href="#L4787">4787</a> <strong class="jxr_keyword">if</strong> (c == '>')
+<a class="jxr_linenumber" name="L4788" href="#L4788">4788</a> paramDepth++;
+<a class="jxr_linenumber" name="L4789" href="#L4789">4789</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '<')
+<a class="jxr_linenumber" name="L4790" href="#L4790">4790</a> paramDepth--;
+<a class="jxr_linenumber" name="L4791" href="#L4791">4791</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == ',' && paramDepth == 0) {
+<a class="jxr_linenumber" name="L4792" href="#L4792">4792</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(sArray, x1, i - x1);
+<a class="jxr_linenumber" name="L4793" href="#L4793">4793</a> l.add(s2.trim());
+<a class="jxr_linenumber" name="L4794" href="#L4794">4794</a> x1 = i + 1;
+<a class="jxr_linenumber" name="L4795" href="#L4795">4795</a> }
+<a class="jxr_linenumber" name="L4796" href="#L4796">4796</a> }
+<a class="jxr_linenumber" name="L4797" href="#L4797">4797</a>
+<a class="jxr_linenumber" name="L4798" href="#L4798">4798</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(sArray, x1, sArray.length - x1);
+<a class="jxr_linenumber" name="L4799" href="#L4799">4799</a> l.add(s2.trim());
+<a class="jxr_linenumber" name="L4800" href="#L4800">4800</a>
+<a class="jxr_linenumber" name="L4801" href="#L4801">4801</a> <strong class="jxr_keyword">return</strong> l.toArray(<strong class="jxr_keyword">new</strong> String[l.size()]);
+<a class="jxr_linenumber" name="L4802" href="#L4802">4802</a> }
+<a class="jxr_linenumber" name="L4803" href="#L4803">4803</a>
+<a class="jxr_linenumber" name="L4804" href="#L4804">4804</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4805" href="#L4805">4805</a> <em class="jxr_javadoccomment"> * Splits a comma-delimited list containing "nesting constructs".</em>
+<a class="jxr_linenumber" name="L4806" href="#L4806">4806</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4807" href="#L4807">4807</a> <em class="jxr_javadoccomment"> * Nesting constructs are simple embedded "{...}" comma-delimted lists.</em>
+<a class="jxr_linenumber" name="L4808" href="#L4808">4808</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4809" href="#L4809">4809</a> <em class="jxr_javadoccomment"> * Example:</em>
+<a class="jxr_linenumber" name="L4810" href="#L4810">4810</a> <em class="jxr_javadoccomment"> * "a{b,c},d" -> ["a{b,c}","d"]</em>
+<a class="jxr_linenumber" name="L4811" href="#L4811">4811</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4812" href="#L4812">4812</a> <em class="jxr_javadoccomment"> * Handles escapes and trims whitespace from tokens.</em>
+<a class="jxr_linenumber" name="L4813" href="#L4813">4813</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4814" href="#L4814">4814</a> <em class="jxr_javadoccomment"> * @param s The input string.</em>
+<a class="jxr_linenumber" name="L4815" href="#L4815">4815</a> <em class="jxr_javadoccomment"> * @return</em>
+<a class="jxr_linenumber" name="L4816" href="#L4816">4816</a> <em class="jxr_javadoccomment"> * The results, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4817" href="#L4817">4817</a> <em class="jxr_javadoccomment"> * <br>An empty string results in an empty array.</em>
+<a class="jxr_linenumber" name="L4818" href="#L4818">4818</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4819" href="#L4819">4819</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> splitNested(String s) {
+<a class="jxr_linenumber" name="L4820" href="#L4820">4820</a> <strong class="jxr_keyword">var</strong> escapeChars = getEscapeSet(',');
+<a class="jxr_linenumber" name="L4821" href="#L4821">4821</a>
+<a class="jxr_linenumber" name="L4822" href="#L4822">4822</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4823" href="#L4823">4823</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L4824" href="#L4824">4824</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
+<a class="jxr_linenumber" name="L4825" href="#L4825">4825</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L4826" href="#L4826">4826</a> <strong class="jxr_keyword">if</strong> (s.indexOf(',') == -1)
+<a class="jxr_linenumber" name="L4827" href="#L4827">4827</a> <strong class="jxr_keyword">return</strong> Collections.singletonList(trim(s));
+<a class="jxr_linenumber" name="L4828" href="#L4828">4828</a>
+<a class="jxr_linenumber" name="L4829" href="#L4829">4829</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> LinkedList<String>();
<a class="jxr_linenumber" name="L4830" href="#L4830">4830</a>
-<a class="jxr_linenumber" name="L4831" href="#L4831">4831</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L4832" href="#L4832">4832</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L4833" href="#L4833">4833</a> <strong class="jxr_keyword">if</strong> (inEscape) {
-<a class="jxr_linenumber" name="L4834" href="#L4834">4834</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
-<a class="jxr_linenumber" name="L4835" href="#L4835">4835</a> inEscape = false;
-<a class="jxr_linenumber" name="L4836" href="#L4836">4836</a> }
-<a class="jxr_linenumber" name="L4837" href="#L4837">4837</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4831" href="#L4831">4831</a> <strong class="jxr_keyword">var</strong> x1 = 0;
+<a class="jxr_linenumber" name="L4832" href="#L4832">4832</a> <strong class="jxr_keyword">var</strong> inEscape = false;
+<a class="jxr_linenumber" name="L4833" href="#L4833">4833</a> <strong class="jxr_keyword">var</strong> depthCount = 0;
+<a class="jxr_linenumber" name="L4834" href="#L4834">4834</a>
+<a class="jxr_linenumber" name="L4835" href="#L4835">4835</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L4836" href="#L4836">4836</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L4837" href="#L4837">4837</a> <strong class="jxr_keyword">if</strong> (inEscape) {
<a class="jxr_linenumber" name="L4838" href="#L4838">4838</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
-<a class="jxr_linenumber" name="L4839" href="#L4839">4839</a> inEscape = <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L4840" href="#L4840">4840</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '{') {
-<a class="jxr_linenumber" name="L4841" href="#L4841">4841</a> depthCount++;
-<a class="jxr_linenumber" name="L4842" href="#L4842">4842</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '}') {
-<a class="jxr_linenumber" name="L4843" href="#L4843">4843</a> depthCount--;
-<a class="jxr_linenumber" name="L4844" href="#L4844">4844</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == ',' && depthCount == 0) {
-<a class="jxr_linenumber" name="L4845" href="#L4845">4845</a> l.add(trim(unEscapeChars(s.substring(x1, i), escapeChars)));
-<a class="jxr_linenumber" name="L4846" href="#L4846">4846</a> x1 = i + 1;
-<a class="jxr_linenumber" name="L4847" href="#L4847">4847</a> }
-<a class="jxr_linenumber" name="L4848" href="#L4848">4848</a> }
-<a class="jxr_linenumber" name="L4849" href="#L4849">4849</a> }
-<a class="jxr_linenumber" name="L4850" href="#L4850">4850</a> l.add(trim(unEscapeChars(s.substring(x1, s.length()), escapeChars)));
-<a class="jxr_linenumber" name="L4851" href="#L4851">4851</a>
-<a class="jxr_linenumber" name="L4852" href="#L4852">4852</a> <strong class="jxr_keyword">return</strong> l;
-<a class="jxr_linenumber" name="L4853" href="#L4853">4853</a> }
-<a class="jxr_linenumber" name="L4854" href="#L4854">4854</a>
-<a class="jxr_linenumber" name="L4855" href="#L4855">4855</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4856" href="#L4856">4856</a> <em class="jxr_javadoccomment"> * Splits a nested comma-delimited list.</em>
-<a class="jxr_linenumber" name="L4857" href="#L4857">4857</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4858" href="#L4858">4858</a> <em class="jxr_javadoccomment"> * Nesting constructs are simple embedded "{...}" comma-delimted lists.</em>
-<a class="jxr_linenumber" name="L4859" href="#L4859">4859</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4860" href="#L4860">4860</a> <em class="jxr_javadoccomment"> * Example:</em>
-<a class="jxr_linenumber" name="L4861" href="#L4861">4861</a> <em class="jxr_javadoccomment"> * "a{b,c{d,e}}" -> ["b","c{d,e}"]</em>
-<a class="jxr_linenumber" name="L4862" href="#L4862">4862</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4863" href="#L4863">4863</a> <em class="jxr_javadoccomment"> * Handles escapes and trims whitespace from tokens.</em>
-<a class="jxr_linenumber" name="L4864" href="#L4864">4864</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4865" href="#L4865">4865</a> <em class="jxr_javadoccomment"> * @param s The input string.</em>
-<a class="jxr_linenumber" name="L4866" href="#L4866">4866</a> <em class="jxr_javadoccomment"> * @return</em>
-<a class="jxr_linenumber" name="L4867" href="#L4867">4867</a> <em class="jxr_javadoccomment"> * The results, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4868" href="#L4868">4868</a> <em class="jxr_javadoccomment"> * <br>An empty string results in an empty array.</em>
-<a class="jxr_linenumber" name="L4869" href="#L4869">4869</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4870" href="#L4870">4870</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> splitNestedInner(String s) {
-<a class="jxr_linenumber" name="L4871" href="#L4871">4871</a> assertArg(isNotNull(s), <span class="jxr_string">"String was null."</span>);
-<a class="jxr_linenumber" name="L4872" href="#L4872">4872</a> assertArg(isNotEmpty(s), <span class="jxr_string">"String was empty."</span>);
-<a class="jxr_linenumber" name="L4873" href="#L4873">4873</a>
-<a class="jxr_linenumber" name="L4874" href="#L4874">4874</a> <em class="jxr_comment">// S1: Looking for '{'</em>
-<a class="jxr_linenumber" name="L4875" href="#L4875">4875</a> <em class="jxr_comment">// S2: Found '{', looking for '}'</em>
-<a class="jxr_linenumber" name="L4876" href="#L4876">4876</a>
-<a class="jxr_linenumber" name="L4877" href="#L4877">4877</a> <strong class="jxr_keyword">var</strong> start = -1;
-<a class="jxr_linenumber" name="L4878" href="#L4878">4878</a> <strong class="jxr_keyword">var</strong> end = -1;
-<a class="jxr_linenumber" name="L4879" href="#L4879">4879</a> <strong class="jxr_keyword">var</strong> state = S1;
+<a class="jxr_linenumber" name="L4839" href="#L4839">4839</a> inEscape = false;
+<a class="jxr_linenumber" name="L4840" href="#L4840">4840</a> }
+<a class="jxr_linenumber" name="L4841" href="#L4841">4841</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4842" href="#L4842">4842</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
+<a class="jxr_linenumber" name="L4843" href="#L4843">4843</a> inEscape = <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L4844" href="#L4844">4844</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '{') {
+<a class="jxr_linenumber" name="L4845" href="#L4845">4845</a> depthCount++;
+<a class="jxr_linenumber" name="L4846" href="#L4846">4846</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '}') {
+<a class="jxr_linenumber" name="L4847" href="#L4847">4847</a> depthCount--;
+<a class="jxr_linenumber" name="L4848" href="#L4848">4848</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == ',' && depthCount == 0) {
+<a class="jxr_linenumber" name="L4849" href="#L4849">4849</a> l.add(trim(unEscapeChars(s.substring(x1, i), escapeChars)));
+<a class="jxr_linenumber" name="L4850" href="#L4850">4850</a> x1 = i + 1;
+<a class="jxr_linenumber" name="L4851" href="#L4851">4851</a> }
+<a class="jxr_linenumber" name="L4852" href="#L4852">4852</a> }
+<a class="jxr_linenumber" name="L4853" href="#L4853">4853</a> }
+<a class="jxr_linenumber" name="L4854" href="#L4854">4854</a> l.add(trim(unEscapeChars(s.substring(x1, s.length()), escapeChars)));
+<a class="jxr_linenumber" name="L4855" href="#L4855">4855</a>
+<a class="jxr_linenumber" name="L4856" href="#L4856">4856</a> <strong class="jxr_keyword">return</strong> l;
+<a class="jxr_linenumber" name="L4857" href="#L4857">4857</a> }
+<a class="jxr_linenumber" name="L4858" href="#L4858">4858</a>
+<a class="jxr_linenumber" name="L4859" href="#L4859">4859</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4860" href="#L4860">4860</a> <em class="jxr_javadoccomment"> * Splits a nested comma-delimited list.</em>
+<a class="jxr_linenumber" name="L4861" href="#L4861">4861</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4862" href="#L4862">4862</a> <em class="jxr_javadoccomment"> * Nesting constructs are simple embedded "{...}" comma-delimted lists.</em>
+<a class="jxr_linenumber" name="L4863" href="#L4863">4863</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4864" href="#L4864">4864</a> <em class="jxr_javadoccomment"> * Example:</em>
+<a class="jxr_linenumber" name="L4865" href="#L4865">4865</a> <em class="jxr_javadoccomment"> * "a{b,c{d,e}}" -> ["b","c{d,e}"]</em>
+<a class="jxr_linenumber" name="L4866" href="#L4866">4866</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4867" href="#L4867">4867</a> <em class="jxr_javadoccomment"> * Handles escapes and trims whitespace from tokens.</em>
+<a class="jxr_linenumber" name="L4868" href="#L4868">4868</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4869" href="#L4869">4869</a> <em class="jxr_javadoccomment"> * @param s The input string.</em>
+<a class="jxr_linenumber" name="L4870" href="#L4870">4870</a> <em class="jxr_javadoccomment"> * @return</em>
+<a class="jxr_linenumber" name="L4871" href="#L4871">4871</a> <em class="jxr_javadoccomment"> * The results, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4872" href="#L4872">4872</a> <em class="jxr_javadoccomment"> * <br>An empty string results in an empty array.</em>
+<a class="jxr_linenumber" name="L4873" href="#L4873">4873</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4874" href="#L4874">4874</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> splitNestedInner(String s) {
+<a class="jxr_linenumber" name="L4875" href="#L4875">4875</a> assertArg(isNotNull(s), <span class="jxr_string">"String was null."</span>);
+<a class="jxr_linenumber" name="L4876" href="#L4876">4876</a> assertArg(isNotEmpty(s), <span class="jxr_string">"String was empty."</span>);
+<a class="jxr_linenumber" name="L4877" href="#L4877">4877</a>
+<a class="jxr_linenumber" name="L4878" href="#L4878">4878</a> <em class="jxr_comment">// S1: Looking for '{'</em>
+<a class="jxr_linenumber" name="L4879" href="#L4879">4879</a> <em class="jxr_comment">// S2: Found '{', looking for '}'</em>
<a class="jxr_linenumber" name="L4880" href="#L4880">4880</a>
-<a class="jxr_linenumber" name="L4881" href="#L4881">4881</a> <strong class="jxr_keyword">var</strong> depth = 0;
-<a class="jxr_linenumber" name="L4882" href="#L4882">4882</a> <strong class="jxr_keyword">var</strong> inEscape = false;
-<a class="jxr_linenumber" name="L4883" href="#L4883">4883</a>
-<a class="jxr_linenumber" name="L4884" href="#L4884">4884</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L4885" href="#L4885">4885</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L4886" href="#L4886">4886</a> <strong class="jxr_keyword">if</strong> (inEscape) {
-<a class="jxr_linenumber" name="L4887" href="#L4887">4887</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
-<a class="jxr_linenumber" name="L4888" href="#L4888">4888</a> inEscape = false;
-<a class="jxr_linenumber" name="L4889" href="#L4889">4889</a> }
-<a class="jxr_linenumber" name="L4890" href="#L4890">4890</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4881" href="#L4881">4881</a> <strong class="jxr_keyword">var</strong> start = -1;
+<a class="jxr_linenumber" name="L4882" href="#L4882">4882</a> <strong class="jxr_keyword">var</strong> end = -1;
+<a class="jxr_linenumber" name="L4883" href="#L4883">4883</a> <strong class="jxr_keyword">var</strong> state = S1;
+<a class="jxr_linenumber" name="L4884" href="#L4884">4884</a>
+<a class="jxr_linenumber" name="L4885" href="#L4885">4885</a> <strong class="jxr_keyword">var</strong> depth = 0;
+<a class="jxr_linenumber" name="L4886" href="#L4886">4886</a> <strong class="jxr_keyword">var</strong> inEscape = false;
+<a class="jxr_linenumber" name="L4887" href="#L4887">4887</a>
+<a class="jxr_linenumber" name="L4888" href="#L4888">4888</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L4889" href="#L4889">4889</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L4890" href="#L4890">4890</a> <strong class="jxr_keyword">if</strong> (inEscape) {
<a class="jxr_linenumber" name="L4891" href="#L4891">4891</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
-<a class="jxr_linenumber" name="L4892" href="#L4892">4892</a> inEscape = <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L4893" href="#L4893">4893</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S1) {
-<a class="jxr_linenumber" name="L4894" href="#L4894">4894</a> <strong class="jxr_keyword">if</strong> (c == '{') {
-<a class="jxr_linenumber" name="L4895" href="#L4895">4895</a> start = i + 1;
-<a class="jxr_linenumber" name="L4896" href="#L4896">4896</a> state = S2;
-<a class="jxr_linenumber" name="L4897" href="#L4897">4897</a> }
-<a class="jxr_linenumber" name="L4898" href="#L4898">4898</a> } <strong class="jxr_keyword">else</strong> <em class="jxr_comment">/* state == S2 */</em> {
-<a class="jxr_linenumber" name="L4899" href="#L4899">4899</a> <strong class="jxr_keyword">if</strong> (c == '{') {
-<a class="jxr_linenumber" name="L4900" href="#L4900">4900</a> depth++;
-<a class="jxr_linenumber" name="L4901" href="#L4901">4901</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (depth > 0 && c == '}') {
-<a class="jxr_linenumber" name="L4902" href="#L4902">4902</a> depth--;
-<a class="jxr_linenumber" name="L4903" href="#L4903">4903</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '}') {
-<a class="jxr_linenumber" name="L4904" href="#L4904">4904</a> end = i;
-<a class="jxr_linenumber" name="L4905" href="#L4905">4905</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4906" href="#L4906">4906</a> }
-<a class="jxr_linenumber" name="L4907" href="#L4907">4907</a> }
-<a class="jxr_linenumber" name="L4908" href="#L4908">4908</a> }
-<a class="jxr_linenumber" name="L4909" href="#L4909">4909</a> }
-<a class="jxr_linenumber" name="L4910" href="#L4910">4910</a>
-<a class="jxr_linenumber" name="L4911" href="#L4911">4911</a> <strong class="jxr_keyword">if</strong> (start == -1)
-<a class="jxr_linenumber" name="L4912" href="#L4912">4912</a> <strong class="jxr_keyword">throw</strong> illegalArg(<span class="jxr_string">"Start character '{' not found in string: {0}"</span>, s);
-<a class="jxr_linenumber" name="L4913" href="#L4913">4913</a> <strong class="jxr_keyword">if</strong> (end == -1)
-<a class="jxr_linenumber" name="L4914" href="#L4914">4914</a> <strong class="jxr_keyword">throw</strong> illegalArg(<span class="jxr_string">"End character '}' not found in string {0}"</span>, s);
-<a class="jxr_linenumber" name="L4915" href="#L4915">4915</a> <strong class="jxr_keyword">return</strong> splitNested(s.substring(start, end));
-<a class="jxr_linenumber" name="L4916" href="#L4916">4916</a> }
-<a class="jxr_linenumber" name="L4917" href="#L4917">4917</a>
-<a class="jxr_linenumber" name="L4918" href="#L4918">4918</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4919" href="#L4919">4919</a> <em class="jxr_javadoccomment"> * Splits a space-delimited string with optionally quoted arguments.</em>
-<a class="jxr_linenumber" name="L4920" href="#L4920">4920</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4921" href="#L4921">4921</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4922" href="#L4922">4922</a> <em class="jxr_javadoccomment"> * Examples:</em>
-<a class="jxr_linenumber" name="L4923" href="#L4923">4923</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L4924" href="#L4924">4924</a> <em class="jxr_javadoccomment"> * <li><js>"foo"</js> =&gt; <c>["foo"]</c></em>
-<a class="jxr_linenumber" name="L4925" href="#L4925">4925</a> <em class="jxr_javadoccomment"> * <li><js>" foo "</js> =&gt; <c>["foo"]</c></em>
-<a class="jxr_linenumber" name="L4926" href="#L4926">4926</a> <em class="jxr_javadoccomment"> * <li><js>"foo bar baz"</js> =&gt; <c>["foo","bar","baz"]</c></em>
-<a class="jxr_linenumber" name="L4927" href="#L4927">4927</a> <em class="jxr_javadoccomment"> * <li><js>"foo 'bar baz'"</js> =&gt; <c>["foo","bar baz"]</c></em>
-<a class="jxr_linenumber" name="L4928" href="#L4928">4928</a> <em class="jxr_javadoccomment"> * <li><js>"foo \"bar baz\""</js> =&gt; <c>["foo","bar baz"]</c></em>
-<a class="jxr_linenumber" name="L4929" href="#L4929">4929</a> <em class="jxr_javadoccomment"> * <li><js>"foo 'bar\'baz'"</js> =&gt; <c>["foo","bar'baz"]</c></em>
-<a class="jxr_linenumber" name="L4930" href="#L4930">4930</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L4931" href="#L4931">4931</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4932" href="#L4932">4932</a> <em class="jxr_javadoccomment"> * @param s The input string.</em>
-<a class="jxr_linenumber" name="L4933" href="#L4933">4933</a> <em class="jxr_javadoccomment"> * @return</em>
-<a class="jxr_linenumber" name="L4934" href="#L4934">4934</a> <em class="jxr_javadoccomment"> * The results, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4935" href="#L4935">4935</a> <em class="jxr_javadoccomment"> * <br>An empty string results in an empty array.</em>
-<a class="jxr_linenumber" name="L4936" href="#L4936">4936</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4937" href="#L4937">4937</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splitQuoted(String s) {
-<a class="jxr_linenumber" name="L4938" href="#L4938">4938</a> <strong class="jxr_keyword">return</strong> splitQuoted(s, false);
-<a class="jxr_linenumber" name="L4939" href="#L4939">4939</a> }
-<a class="jxr_linenumber" name="L4940" href="#L4940">4940</a>
-<a class="jxr_linenumber" name="L4941" href="#L4941">4941</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4942" href="#L4942">4942</a> <em class="jxr_javadoccomment"> * Same as {@link StringUtils#splitQuoted(String)} but allows you to optionally keep the quote characters.</em>
-<a class="jxr_linenumber" name="L4943" href="#L4943">4943</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4944" href="#L4944">4944</a> <em class="jxr_javadoccomment"> * @param s The input string.</em>
-<a class="jxr_linenumber" name="L4945" href="#L4945">4945</a> <em class="jxr_javadoccomment"> * @param keepQuotes If <jk>true</jk>, quote characters are kept on the tokens.</em>
-<a class="jxr_linenumber" name="L4946" href="#L4946">4946</a> <em class="jxr_javadoccomment"> * @return</em>
-<a class="jxr_linenumber" name="L4947" href="#L4947">4947</a> <em class="jxr_javadoccomment"> * The results, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4948" href="#L4948">4948</a> <em class="jxr_javadoccomment"> * <br>An empty string results in an empty array.</em>
-<a class="jxr_linenumber" name="L4949" href="#L4949">4949</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4950" href="#L4950">4950</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splitQuoted(String s, <strong class="jxr_keyword">boolean</strong> keepQuotes) {
-<a class="jxr_linenumber" name="L4951" href="#L4951">4951</a>
-<a class="jxr_linenumber" name="L4952" href="#L4952">4952</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4953" href="#L4953">4953</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L4954" href="#L4954">4954</a>
-<a class="jxr_linenumber" name="L4955" href="#L4955">4955</a> s = s.trim();
-<a class="jxr_linenumber" name="L4956" href="#L4956">4956</a>
-<a class="jxr_linenumber" name="L4957" href="#L4957">4957</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
-<a class="jxr_linenumber" name="L4958" href="#L4958">4958</a> <strong class="jxr_keyword">return</strong> a();
-<a class="jxr_linenumber" name="L4959" href="#L4959">4959</a>
-<a class="jxr_linenumber" name="L4960" href="#L4960">4960</a> <strong class="jxr_keyword">if</strong> (! containsAny(s, ' ', '\t', '\'', '"'))
-<a class="jxr_linenumber" name="L4961" href="#L4961">4961</a> <strong class="jxr_keyword">return</strong> a(s);
-<a class="jxr_linenumber" name="L4962" href="#L4962">4962</a>
-<a class="jxr_linenumber" name="L4963" href="#L4963">4963</a> <em class="jxr_comment">// S1: Looking for start of token.</em>
-<a class="jxr_linenumber" name="L4964" href="#L4964">4964</a> <em class="jxr_comment">// S2: Found ', looking for end '</em>
-<a class="jxr_linenumber" name="L4965" href="#L4965">4965</a> <em class="jxr_comment">// S3: Found ", looking for end "</em>
-<a class="jxr_linenumber" name="L4966" href="#L4966">4966</a> <em class="jxr_comment">// S4: Found non-whitespace, looking for end whitespace.</em>
-<a class="jxr_linenumber" name="L4967" href="#L4967">4967</a>
-<a class="jxr_linenumber" name="L4968" href="#L4968">4968</a> <strong class="jxr_keyword">var</strong> state = S1;
-<a class="jxr_linenumber" name="L4969" href="#L4969">4969</a>
-<a class="jxr_linenumber" name="L4970" href="#L4970">4970</a> <strong class="jxr_keyword">var</strong> isInEscape = false;
-<a class="jxr_linenumber" name="L4971" href="#L4971">4971</a> <strong class="jxr_keyword">var</strong> needsUnescape = false;
-<a class="jxr_linenumber" name="L4972" href="#L4972">4972</a> <strong class="jxr_keyword">var</strong> mark = 0;
+<a class="jxr_linenumber" name="L4892" href="#L4892">4892</a> inEscape = false;
+<a class="jxr_linenumber" name="L4893" href="#L4893">4893</a> }
+<a class="jxr_linenumber" name="L4894" href="#L4894">4894</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4895" href="#L4895">4895</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
+<a class="jxr_linenumber" name="L4896" href="#L4896">4896</a> inEscape = <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L4897" href="#L4897">4897</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S1) {
+<a class="jxr_linenumber" name="L4898" href="#L4898">4898</a> <strong class="jxr_keyword">if</strong> (c == '{') {
+<a class="jxr_linenumber" name="L4899" href="#L4899">4899</a> start = i + 1;
+<a class="jxr_linenumber" name="L4900" href="#L4900">4900</a> state = S2;
+<a class="jxr_linenumber" name="L4901" href="#L4901">4901</a> }
+<a class="jxr_linenumber" name="L4902" href="#L4902">4902</a> } <strong class="jxr_keyword">else</strong> <em class="jxr_comment">/* state == S2 */</em> {
+<a class="jxr_linenumber" name="L4903" href="#L4903">4903</a> <strong class="jxr_keyword">if</strong> (c == '{') {
+<a class="jxr_linenumber" name="L4904" href="#L4904">4904</a> depth++;
+<a class="jxr_linenumber" name="L4905" href="#L4905">4905</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (depth > 0 && c == '}') {
+<a class="jxr_linenumber" name="L4906" href="#L4906">4906</a> depth--;
+<a class="jxr_linenumber" name="L4907" href="#L4907">4907</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '}') {
+<a class="jxr_linenumber" name="L4908" href="#L4908">4908</a> end = i;
+<a class="jxr_linenumber" name="L4909" href="#L4909">4909</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4910" href="#L4910">4910</a> }
+<a class="jxr_linenumber" name="L4911" href="#L4911">4911</a> }
+<a class="jxr_linenumber" name="L4912" href="#L4912">4912</a> }
+<a class="jxr_linenumber" name="L4913" href="#L4913">4913</a> }
+<a class="jxr_linenumber" name="L4914" href="#L4914">4914</a>
+<a class="jxr_linenumber" name="L4915" href="#L4915">4915</a> <strong class="jxr_keyword">if</strong> (start == -1)
+<a class="jxr_linenumber" name="L4916" href="#L4916">4916</a> <strong class="jxr_keyword">throw</strong> illegalArg(<span class="jxr_string">"Start character '{' not found in string: {0}"</span>, s);
+<a class="jxr_linenumber" name="L4917" href="#L4917">4917</a> <strong class="jxr_keyword">if</strong> (end == -1)
+<a class="jxr_linenumber" name="L4918" href="#L4918">4918</a> <strong class="jxr_keyword">throw</strong> illegalArg(<span class="jxr_string">"End character '}' not found in string {0}"</span>, s);
+<a class="jxr_linenumber" name="L4919" href="#L4919">4919</a> <strong class="jxr_keyword">return</strong> splitNested(s.substring(start, end));
+<a class="jxr_linenumber" name="L4920" href="#L4920">4920</a> }
+<a class="jxr_linenumber" name="L4921" href="#L4921">4921</a>
+<a class="jxr_linenumber" name="L4922" href="#L4922">4922</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4923" href="#L4923">4923</a> <em class="jxr_javadoccomment"> * Splits a space-delimited string with optionally quoted arguments.</em>
+<a class="jxr_linenumber" name="L4924" href="#L4924">4924</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4925" href="#L4925">4925</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4926" href="#L4926">4926</a> <em class="jxr_javadoccomment"> * Examples:</em>
+<a class="jxr_linenumber" name="L4927" href="#L4927">4927</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L4928" href="#L4928">4928</a> <em class="jxr_javadoccomment"> * <li><js>"foo"</js> =&gt; <c>["foo"]</c></em>
+<a class="jxr_linenumber" name="L4929" href="#L4929">4929</a> <em class="jxr_javadoccomment"> * <li><js>" foo "</js> =&gt; <c>["foo"]</c></em>
+<a class="jxr_linenumber" name="L4930" href="#L4930">4930</a> <em class="jxr_javadoccomment"> * <li><js>"foo bar baz"</js> =&gt; <c>["foo","bar","baz"]</c></em>
+<a class="jxr_linenumber" name="L4931" href="#L4931">4931</a> <em class="jxr_javadoccomment"> * <li><js>"foo 'bar baz'"</js> =&gt; <c>["foo","bar baz"]</c></em>
+<a class="jxr_linenumber" name="L4932" href="#L4932">4932</a> <em class="jxr_javadoccomment"> * <li><js>"foo \"bar baz\""</js> =&gt; <c>["foo","bar baz"]</c></em>
+<a class="jxr_linenumber" name="L4933" href="#L4933">4933</a> <em class="jxr_javadoccomment"> * <li><js>"foo 'bar\'baz'"</js> =&gt; <c>["foo","bar'baz"]</c></em>
+<a class="jxr_linenumber" name="L4934" href="#L4934">4934</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L4935" href="#L4935">4935</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4936" href="#L4936">4936</a> <em class="jxr_javadoccomment"> * @param s The input string.</em>
+<a class="jxr_linenumber" name="L4937" href="#L4937">4937</a> <em class="jxr_javadoccomment"> * @return</em>
+<a class="jxr_linenumber" name="L4938" href="#L4938">4938</a> <em class="jxr_javadoccomment"> * The results, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4939" href="#L4939">4939</a> <em class="jxr_javadoccomment"> * <br>An empty string results in an empty array.</em>
+<a class="jxr_linenumber" name="L4940" href="#L4940">4940</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4941" href="#L4941">4941</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splitQuoted(String s) {
+<a class="jxr_linenumber" name="L4942" href="#L4942">4942</a> <strong class="jxr_keyword">return</strong> splitQuoted(s, false);
+<a class="jxr_linenumber" name="L4943" href="#L4943">4943</a> }
+<a class="jxr_linenumber" name="L4944" href="#L4944">4944</a>
+<a class="jxr_linenumber" name="L4945" href="#L4945">4945</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4946" href="#L4946">4946</a> <em class="jxr_javadoccomment"> * Same as {@link StringUtils#splitQuoted(String)} but allows you to optionally keep the quote characters.</em>
+<a class="jxr_linenumber" name="L4947" href="#L4947">4947</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4948" href="#L4948">4948</a> <em class="jxr_javadoccomment"> * @param s The input string.</em>
+<a class="jxr_linenumber" name="L4949" href="#L4949">4949</a> <em class="jxr_javadoccomment"> * @param keepQuotes If <jk>true</jk>, quote characters are kept on the tokens.</em>
+<a class="jxr_linenumber" name="L4950" href="#L4950">4950</a> <em class="jxr_javadoccomment"> * @return</em>
+<a class="jxr_linenumber" name="L4951" href="#L4951">4951</a> <em class="jxr_javadoccomment"> * The results, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4952" href="#L4952">4952</a> <em class="jxr_javadoccomment"> * <br>An empty string results in an empty array.</em>
+<a class="jxr_linenumber" name="L4953" href="#L4953">4953</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4954" href="#L4954">4954</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] splitQuoted(String s, <strong class="jxr_keyword">boolean</strong> keepQuotes) {
+<a class="jxr_linenumber" name="L4955" href="#L4955">4955</a>
+<a class="jxr_linenumber" name="L4956" href="#L4956">4956</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4957" href="#L4957">4957</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L4958" href="#L4958">4958</a>
+<a class="jxr_linenumber" name="L4959" href="#L4959">4959</a> s = s.trim();
+<a class="jxr_linenumber" name="L4960" href="#L4960">4960</a>
+<a class="jxr_linenumber" name="L4961" href="#L4961">4961</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
+<a class="jxr_linenumber" name="L4962" href="#L4962">4962</a> <strong class="jxr_keyword">return</strong> a();
+<a class="jxr_linenumber" name="L4963" href="#L4963">4963</a>
+<a class="jxr_linenumber" name="L4964" href="#L4964">4964</a> <strong class="jxr_keyword">if</strong> (! containsAny(s, ' ', '\t', '\'', '"'))
+<a class="jxr_linenumber" name="L4965" href="#L4965">4965</a> <strong class="jxr_keyword">return</strong> a(s);
+<a class="jxr_linenumber" name="L4966" href="#L4966">4966</a>
+<a class="jxr_linenumber" name="L4967" href="#L4967">4967</a> <em class="jxr_comment">// S1: Looking for start of token.</em>
+<a class="jxr_linenumber" name="L4968" href="#L4968">4968</a> <em class="jxr_comment">// S2: Found ', looking for end '</em>
+<a class="jxr_linenumber" name="L4969" href="#L4969">4969</a> <em class="jxr_comment">// S3: Found ", looking for end "</em>
+<a class="jxr_linenumber" name="L4970" href="#L4970">4970</a> <em class="jxr_comment">// S4: Found non-whitespace, looking for end whitespace.</em>
+<a class="jxr_linenumber" name="L4971" href="#L4971">4971</a>
+<a class="jxr_linenumber" name="L4972" href="#L4972">4972</a> <strong class="jxr_keyword">var</strong> state = S1;
<a class="jxr_linenumber" name="L4973" href="#L4973">4973</a>
-<a class="jxr_linenumber" name="L4974" href="#L4974">4974</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L4975" href="#L4975">4975</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L4976" href="#L4976">4976</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L4974" href="#L4974">4974</a> <strong class="jxr_keyword">var</strong> isInEscape = false;
+<a class="jxr_linenumber" name="L4975" href="#L4975">4975</a> <strong class="jxr_keyword">var</strong> needsUnescape = false;
+<a class="jxr_linenumber" name="L4976" href="#L4976">4976</a> <strong class="jxr_keyword">var</strong> mark = 0;
<a class="jxr_linenumber" name="L4977" href="#L4977">4977</a>
-<a class="jxr_linenumber" name="L4978" href="#L4978">4978</a> <strong class="jxr_keyword">if</strong> (state == S1) {
-<a class="jxr_linenumber" name="L4979" href="#L4979">4979</a> <strong class="jxr_keyword">if</strong> (c == '\'') {
-<a class="jxr_linenumber" name="L4980" href="#L4980">4980</a> state = S2;
-<a class="jxr_linenumber" name="L4981" href="#L4981">4981</a> mark = keepQuotes ? i : i + 1;
-<a class="jxr_linenumber" name="L4982" href="#L4982">4982</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '"') {
-<a class="jxr_linenumber" name="L4983" href="#L4983">4983</a> state = S3;
-<a class="jxr_linenumber" name="L4984" href="#L4984">4984</a> mark = keepQuotes ? i : i + 1;
-<a class="jxr_linenumber" name="L4985" href="#L4985">4985</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c != ' ' && c != '\t') {
-<a class="jxr_linenumber" name="L4986" href="#L4986">4986</a> state = S4;
-<a class="jxr_linenumber" name="L4987" href="#L4987">4987</a> mark = i;
-<a class="jxr_linenumber" name="L4988" href="#L4988">4988</a> }
-<a class="jxr_linenumber" name="L4989" href="#L4989">4989</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2 || state == S3) {
-<a class="jxr_linenumber" name="L4990" href="#L4990">4990</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
-<a class="jxr_linenumber" name="L4991" href="#L4991">4991</a> isInEscape = ! isInEscape;
-<a class="jxr_linenumber" name="L4992" href="#L4992">4992</a> needsUnescape = ! keepQuotes;
-<a class="jxr_linenumber" name="L4993" href="#L4993">4993</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (! isInEscape) {
-<a class="jxr_linenumber" name="L4994" href="#L4994">4994</a> <strong class="jxr_keyword">if</strong> (c == (state == S2 ? '\'' : '"')) {
-<a class="jxr_linenumber" name="L4995" href="#L4995">4995</a> <strong class="jxr_keyword">var</strong> s2 = s.substring(mark, keepQuotes ? i + 1 : i);
-<a class="jxr_linenumber" name="L4996" href="#L4996">4996</a> <strong class="jxr_keyword">if</strong> (needsUnescape) <em class="jxr_comment">// NOSONAR - False positive check.</em>
-<a class="jxr_linenumber" name="L4997" href="#L4997">4997</a> s2 = unEscapeChars(s2, QUOTE_ESCAPE_SET);
-<a class="jxr_linenumber" name="L4998" href="#L4998">4998</a> l.add(s2);
-<a class="jxr_linenumber" name="L4999" href="#L4999">4999</a> state = S1;
-<a class="jxr_linenumber" name="L5000" href="#L5000">5000</a> isInEscape = needsUnescape = false;
-<a class="jxr_linenumber" name="L5001" href="#L5001">5001</a> }
-<a class="jxr_linenumber" name="L5002" href="#L5002">5002</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L5003" href="#L5003">5003</a> isInEscape = false;
-<a class="jxr_linenumber" name="L5004" href="#L5004">5004</a> }
-<a class="jxr_linenumber" name="L5005" href="#L5005">5005</a> } <strong class="jxr_keyword">else</strong> <em class="jxr_comment">/* state == S4 */</em> {
-<a class="jxr_linenumber" name="L5006" href="#L5006">5006</a> <strong class="jxr_keyword">if</strong> (c == ' ' || c == '\t') {
-<a class="jxr_linenumber" name="L5007" href="#L5007">5007</a> l.add(s.substring(mark, i));
-<a class="jxr_linenumber" name="L5008" href="#L5008">5008</a> state = S1;
-<a class="jxr_linenumber" name="L5009" href="#L5009">5009</a> }
-<a class="jxr_linenumber" name="L5010" href="#L5010">5010</a> }
-<a class="jxr_linenumber" name="L5011" href="#L5011">5011</a> }
-<a class="jxr_linenumber" name="L5012" href="#L5012">5012</a> <strong class="jxr_keyword">if</strong> (state == S4)
-<a class="jxr_linenumber" name="L5013" href="#L5013">5013</a> l.add(s.substring(mark));
-<a class="jxr_linenumber" name="L5014" href="#L5014">5014</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2 || state == S3)
-<a class="jxr_linenumber" name="L5015" href="#L5015">5015</a> <strong class="jxr_keyword">throw</strong> illegalArg(<span class="jxr_string">"Unmatched string quotes: {0}"</span>, s);
-<a class="jxr_linenumber" name="L5016" href="#L5016">5016</a> <strong class="jxr_keyword">return</strong> l.toArray(<strong class="jxr_keyword">new</strong> String[l.size()]);
-<a class="jxr_linenumber" name="L5017" href="#L5017">5017</a> }
-<a class="jxr_linenumber" name="L5018" href="#L5018">5018</a>
-<a class="jxr_linenumber" name="L5019" href="#L5019">5019</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5020" href="#L5020">5020</a> <em class="jxr_javadoccomment"> * An efficient method for checking if a string starts with a character.</em>
-<a class="jxr_linenumber" name="L5021" href="#L5021">5021</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5022" href="#L5022">5022</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5023" href="#L5023">5023</a> <em class="jxr_javadoccomment"> * @param c The character to check for.</em>
-<a class="jxr_linenumber" name="L5024" href="#L5024">5024</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is not <jk>null</jk> and starts with the specified character.</em>
-<a class="jxr_linenumber" name="L5025" href="#L5025">5025</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5026" href="#L5026">5026</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> startsWith(String s, <strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L5027" href="#L5027">5027</a> <strong class="jxr_keyword">if</strong> (nn(s)) {
-<a class="jxr_linenumber" name="L5028" href="#L5028">5028</a> <strong class="jxr_keyword">var</strong> i = s.length();
-<a class="jxr_linenumber" name="L5029" href="#L5029">5029</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L5030" href="#L5030">5030</a> <strong class="jxr_keyword">return</strong> s.charAt(0) == c;
-<a class="jxr_linenumber" name="L5031" href="#L5031">5031</a> }
-<a class="jxr_linenumber" name="L5032" href="#L5032">5032</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L5033" href="#L5033">5033</a> }
-<a class="jxr_linenumber" name="L5034" href="#L5034">5034</a>
-<a class="jxr_linenumber" name="L5035" href="#L5035">5035</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5036" href="#L5036">5036</a> <em class="jxr_javadoccomment"> * Strips the first and last character from a string.</em>
-<a class="jxr_linenumber" name="L5037" href="#L5037">5037</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5038" href="#L5038">5038</a> <em class="jxr_javadoccomment"> * @param s The string to strip.</em>
-<a class="jxr_linenumber" name="L5039" href="#L5039">5039</a> <em class="jxr_javadoccomment"> * @return The striped string, or the same string if the input was <jk>null</jk> or less than length 2.</em>
-<a class="jxr_linenumber" name="L5040" href="#L5040">5040</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5041" href="#L5041">5041</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String strip(String s) {
-<a class="jxr_linenumber" name="L5042" href="#L5042">5042</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.length() <= 1)
-<a class="jxr_linenumber" name="L5043" href="#L5043">5043</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L5044" href="#L5044">5044</a> <strong class="jxr_keyword">return</strong> s.substring(1, s.length() - 1);
-<a class="jxr_linenumber" name="L5045" href="#L5045">5045</a> }
-<a class="jxr_linenumber" name="L5046" href="#L5046">5046</a>
-<a class="jxr_linenumber" name="L5047" href="#L5047">5047</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5048" href="#L5048">5048</a> <em class="jxr_javadoccomment"> * Strips invalid characters such as CTRL characters from a string meant to be encoded</em>
-<a class="jxr_linenumber" name="L5049" href="#L5049">5049</a> <em class="jxr_javadoccomment"> * as an HTTP header value.</em>
-<a class="jxr_linenumber" name="L5050" href="#L5050">5050</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5051" href="#L5051">5051</a> <em class="jxr_javadoccomment"> * @param s The string to strip chars from.</em>
-<a class="jxr_linenumber" name="L5052" href="#L5052">5052</a> <em class="jxr_javadoccomment"> * @return The string with invalid characters removed.</em>
-<a class="jxr_linenumber" name="L5053" href="#L5053">5053</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5054" href="#L5054">5054</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String stripInvalidHttpHeaderChars(String s) {
-<a class="jxr_linenumber" name="L5055" href="#L5055">5055</a>
-<a class="jxr_linenumber" name="L5056" href="#L5056">5056</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5057" href="#L5057">5057</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5058" href="#L5058">5058</a>
-<a class="jxr_linenumber" name="L5059" href="#L5059">5059</a> <strong class="jxr_keyword">var</strong> needsReplace = false;
-<a class="jxr_linenumber" name="L5060" href="#L5060">5060</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsReplace; i++)
-<a class="jxr_linenumber" name="L5061" href="#L5061">5061</a> needsReplace |= httpHeaderChars.contains(s.charAt(i));
+<a class="jxr_linenumber" name="L4978" href="#L4978">4978</a> <strong class="jxr_keyword">var</strong> l = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L4979" href="#L4979">4979</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L4980" href="#L4980">4980</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L4981" href="#L4981">4981</a>
+<a class="jxr_linenumber" name="L4982" href="#L4982">4982</a> <strong class="jxr_keyword">if</strong> (state == S1) {
+<a class="jxr_linenumber" name="L4983" href="#L4983">4983</a> <strong class="jxr_keyword">if</strong> (c == '\'') {
+<a class="jxr_linenumber" name="L4984" href="#L4984">4984</a> state = S2;
+<a class="jxr_linenumber" name="L4985" href="#L4985">4985</a> mark = keepQuotes ? i : i + 1;
+<a class="jxr_linenumber" name="L4986" href="#L4986">4986</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '"') {
+<a class="jxr_linenumber" name="L4987" href="#L4987">4987</a> state = S3;
+<a class="jxr_linenumber" name="L4988" href="#L4988">4988</a> mark = keepQuotes ? i : i + 1;
+<a class="jxr_linenumber" name="L4989" href="#L4989">4989</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c != ' ' && c != '\t') {
+<a class="jxr_linenumber" name="L4990" href="#L4990">4990</a> state = S4;
+<a class="jxr_linenumber" name="L4991" href="#L4991">4991</a> mark = i;
+<a class="jxr_linenumber" name="L4992" href="#L4992">4992</a> }
+<a class="jxr_linenumber" name="L4993" href="#L4993">4993</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2 || state == S3) {
+<a class="jxr_linenumber" name="L4994" href="#L4994">4994</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
+<a class="jxr_linenumber" name="L4995" href="#L4995">4995</a> isInEscape = ! isInEscape;
+<a class="jxr_linenumber" name="L4996" href="#L4996">4996</a> needsUnescape = ! keepQuotes;
+<a class="jxr_linenumber" name="L4997" href="#L4997">4997</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (! isInEscape) {
+<a class="jxr_linenumber" name="L4998" href="#L4998">4998</a> <strong class="jxr_keyword">if</strong> (c == (state == S2 ? '\'' : '"')) {
+<a class="jxr_linenumber" name="L4999" href="#L4999">4999</a> <strong class="jxr_keyword">var</strong> s2 = s.substring(mark, keepQuotes ? i + 1 : i);
+<a class="jxr_linenumber" name="L5000" href="#L5000">5000</a> <strong class="jxr_keyword">if</strong> (needsUnescape) <em class="jxr_comment">// NOSONAR - False positive check.</em>
+<a class="jxr_linenumber" name="L5001" href="#L5001">5001</a> s2 = unEscapeChars(s2, QUOTE_ESCAPE_SET);
+<a class="jxr_linenumber" name="L5002" href="#L5002">5002</a> l.add(s2);
+<a class="jxr_linenumber" name="L5003" href="#L5003">5003</a> state = S1;
+<a class="jxr_linenumber" name="L5004" href="#L5004">5004</a> isInEscape = needsUnescape = false;
+<a class="jxr_linenumber" name="L5005" href="#L5005">5005</a> }
+<a class="jxr_linenumber" name="L5006" href="#L5006">5006</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L5007" href="#L5007">5007</a> isInEscape = false;
+<a class="jxr_linenumber" name="L5008" href="#L5008">5008</a> }
+<a class="jxr_linenumber" name="L5009" href="#L5009">5009</a> } <strong class="jxr_keyword">else</strong> <em class="jxr_comment">/* state == S4 */</em> {
+<a class="jxr_linenumber" name="L5010" href="#L5010">5010</a> <strong class="jxr_keyword">if</strong> (c == ' ' || c == '\t') {
+<a class="jxr_linenumber" name="L5011" href="#L5011">5011</a> l.add(s.substring(mark, i));
+<a class="jxr_linenumber" name="L5012" href="#L5012">5012</a> state = S1;
+<a class="jxr_linenumber" name="L5013" href="#L5013">5013</a> }
+<a class="jxr_linenumber" name="L5014" href="#L5014">5014</a> }
+<a class="jxr_linenumber" name="L5015" href="#L5015">5015</a> }
+<a class="jxr_linenumber" name="L5016" href="#L5016">5016</a> <strong class="jxr_keyword">if</strong> (state == S4)
+<a class="jxr_linenumber" name="L5017" href="#L5017">5017</a> l.add(s.substring(mark));
+<a class="jxr_linenumber" name="L5018" href="#L5018">5018</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2 || state == S3)
+<a class="jxr_linenumber" name="L5019" href="#L5019">5019</a> <strong class="jxr_keyword">throw</strong> illegalArg(<span class="jxr_string">"Unmatched string quotes: {0}"</span>, s);
+<a class="jxr_linenumber" name="L5020" href="#L5020">5020</a> <strong class="jxr_keyword">return</strong> l.toArray(<strong class="jxr_keyword">new</strong> String[l.size()]);
+<a class="jxr_linenumber" name="L5021" href="#L5021">5021</a> }
+<a class="jxr_linenumber" name="L5022" href="#L5022">5022</a>
+<a class="jxr_linenumber" name="L5023" href="#L5023">5023</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5024" href="#L5024">5024</a> <em class="jxr_javadoccomment"> * An efficient method for checking if a string starts with a character.</em>
+<a class="jxr_linenumber" name="L5025" href="#L5025">5025</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5026" href="#L5026">5026</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5027" href="#L5027">5027</a> <em class="jxr_javadoccomment"> * @param c The character to check for.</em>
+<a class="jxr_linenumber" name="L5028" href="#L5028">5028</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is not <jk>null</jk> and starts with the specified character.</em>
+<a class="jxr_linenumber" name="L5029" href="#L5029">5029</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5030" href="#L5030">5030</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> startsWith(String s, <strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L5031" href="#L5031">5031</a> <strong class="jxr_keyword">if</strong> (nn(s)) {
+<a class="jxr_linenumber" name="L5032" href="#L5032">5032</a> <strong class="jxr_keyword">var</strong> i = s.length();
+<a class="jxr_linenumber" name="L5033" href="#L5033">5033</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L5034" href="#L5034">5034</a> <strong class="jxr_keyword">return</strong> s.charAt(0) == c;
+<a class="jxr_linenumber" name="L5035" href="#L5035">5035</a> }
+<a class="jxr_linenumber" name="L5036" href="#L5036">5036</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L5037" href="#L5037">5037</a> }
+<a class="jxr_linenumber" name="L5038" href="#L5038">5038</a>
+<a class="jxr_linenumber" name="L5039" href="#L5039">5039</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5040" href="#L5040">5040</a> <em class="jxr_javadoccomment"> * Strips the first and last character from a string.</em>
+<a class="jxr_linenumber" name="L5041" href="#L5041">5041</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5042" href="#L5042">5042</a> <em class="jxr_javadoccomment"> * @param s The string to strip.</em>
+<a class="jxr_linenumber" name="L5043" href="#L5043">5043</a> <em class="jxr_javadoccomment"> * @return The striped string, or the same string if the input was <jk>null</jk> or less than length 2.</em>
+<a class="jxr_linenumber" name="L5044" href="#L5044">5044</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5045" href="#L5045">5045</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String strip(String s) {
+<a class="jxr_linenumber" name="L5046" href="#L5046">5046</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.length() <= 1)
+<a class="jxr_linenumber" name="L5047" href="#L5047">5047</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L5048" href="#L5048">5048</a> <strong class="jxr_keyword">return</strong> s.substring(1, s.length() - 1);
+<a class="jxr_linenumber" name="L5049" href="#L5049">5049</a> }
+<a class="jxr_linenumber" name="L5050" href="#L5050">5050</a>
+<a class="jxr_linenumber" name="L5051" href="#L5051">5051</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5052" href="#L5052">5052</a> <em class="jxr_javadoccomment"> * Strips invalid characters such as CTRL characters from a string meant to be encoded</em>
+<a class="jxr_linenumber" name="L5053" href="#L5053">5053</a> <em class="jxr_javadoccomment"> * as an HTTP header value.</em>
+<a class="jxr_linenumber" name="L5054" href="#L5054">5054</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5055" href="#L5055">5055</a> <em class="jxr_javadoccomment"> * @param s The string to strip chars from.</em>
+<a class="jxr_linenumber" name="L5056" href="#L5056">5056</a> <em class="jxr_javadoccomment"> * @return The string with invalid characters removed.</em>
+<a class="jxr_linenumber" name="L5057" href="#L5057">5057</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5058" href="#L5058">5058</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String stripInvalidHttpHeaderChars(String s) {
+<a class="jxr_linenumber" name="L5059" href="#L5059">5059</a>
+<a class="jxr_linenumber" name="L5060" href="#L5060">5060</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5061" href="#L5061">5061</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
<a class="jxr_linenumber" name="L5062" href="#L5062">5062</a>
-<a class="jxr_linenumber" name="L5063" href="#L5063">5063</a> <strong class="jxr_keyword">if</strong> (! needsReplace)
-<a class="jxr_linenumber" name="L5064" href="#L5064">5064</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L5065" href="#L5065">5065</a>
-<a class="jxr_linenumber" name="L5066" href="#L5066">5066</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(s.length());
-<a class="jxr_linenumber" name="L5067" href="#L5067">5067</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L5068" href="#L5068">5068</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L5069" href="#L5069">5069</a> <strong class="jxr_keyword">if</strong> (httpHeaderChars.contains(c))
-<a class="jxr_linenumber" name="L5070" href="#L5070">5070</a> sb.append(c);
-<a class="jxr_linenumber" name="L5071" href="#L5071">5071</a> }
-<a class="jxr_linenumber" name="L5072" href="#L5072">5072</a>
-<a class="jxr_linenumber" name="L5073" href="#L5073">5073</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L5074" href="#L5074">5074</a> }
-<a class="jxr_linenumber" name="L5075" href="#L5075">5075</a>
-<a class="jxr_linenumber" name="L5076" href="#L5076">5076</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5077" href="#L5077">5077</a> <em class="jxr_javadoccomment"> * Returns the substring after the first occurrence of a separator.</em>
-<a class="jxr_linenumber" name="L5078" href="#L5078">5078</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5079" href="#L5079">5079</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5080" href="#L5080">5080</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5081" href="#L5081">5081</a> <em class="jxr_javadoccomment"> * substringAfter(<jk>null</jk>, <js>"."</js>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L5082" href="#L5082">5082</a> <em class="jxr_javadoccomment"> * substringAfter(<js>"hello.world"</js>, <jk>null</jk>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L5083" href="#L5083">5083</a> <em class="jxr_javadoccomment"> * substringAfter(<js>"hello.world"</js>, <js>"."</js>); <jc>// "world"</jc></em>
-<a class="jxr_linenumber" name="L5084" href="#L5084">5084</a> <em class="jxr_javadoccomment"> * substringAfter(<js>"hello.world"</js>, <js>"xyz"</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L5085" href="#L5085">5085</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5086" href="#L5086">5086</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5087" href="#L5087">5087</a> <em class="jxr_javadoccomment"> * @param str The string to get a substring from.</em>
-<a class="jxr_linenumber" name="L5088" href="#L5088">5088</a> <em class="jxr_javadoccomment"> * @param separator The separator string.</em>
-<a class="jxr_linenumber" name="L5089" href="#L5089">5089</a> <em class="jxr_javadoccomment"> * @return The substring after the first occurrence of the separator, or empty string if separator not found.</em>
-<a class="jxr_linenumber" name="L5090" href="#L5090">5090</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5091" href="#L5091">5091</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String substringAfter(String str, String separator) {
-<a class="jxr_linenumber" name="L5092" href="#L5092">5092</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5093" href="#L5093">5093</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L5094" href="#L5094">5094</a> <strong class="jxr_keyword">if</strong> (separator == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5095" href="#L5095">5095</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L5096" href="#L5096">5096</a> <strong class="jxr_keyword">var</strong> pos = str.indexOf(separator);
-<a class="jxr_linenumber" name="L5097" href="#L5097">5097</a> <strong class="jxr_keyword">if</strong> (pos == -1)
-<a class="jxr_linenumber" name="L5098" href="#L5098">5098</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L5099" href="#L5099">5099</a> <strong class="jxr_keyword">return</strong> str.substring(pos + separator.length());
-<a class="jxr_linenumber" name="L5100" href="#L5100">5100</a> }
-<a class="jxr_linenumber" name="L5101" href="#L5101">5101</a>
-<a class="jxr_linenumber" name="L5102" href="#L5102">5102</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L5103" href="#L5103">5103</a> <em class="jxr_comment">// String joining and splitting methods</em>
-<a class="jxr_linenumber" name="L5104" href="#L5104">5104</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L5063" href="#L5063">5063</a> <strong class="jxr_keyword">var</strong> needsReplace = false;
+<a class="jxr_linenumber" name="L5064" href="#L5064">5064</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsReplace; i++)
+<a class="jxr_linenumber" name="L5065" href="#L5065">5065</a> needsReplace |= httpHeaderChars.contains(s.charAt(i));
+<a class="jxr_linenumber" name="L5066" href="#L5066">5066</a>
+<a class="jxr_linenumber" name="L5067" href="#L5067">5067</a> <strong class="jxr_keyword">if</strong> (! needsReplace)
+<a class="jxr_linenumber" name="L5068" href="#L5068">5068</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L5069" href="#L5069">5069</a>
+<a class="jxr_linenumber" name="L5070" href="#L5070">5070</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(s.length());
+<a class="jxr_linenumber" name="L5071" href="#L5071">5071</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L5072" href="#L5072">5072</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L5073" href="#L5073">5073</a> <strong class="jxr_keyword">if</strong> (httpHeaderChars.contains(c))
+<a class="jxr_linenumber" name="L5074" href="#L5074">5074</a> sb.append(c);
+<a class="jxr_linenumber" name="L5075" href="#L5075">5075</a> }
+<a class="jxr_linenumber" name="L5076" href="#L5076">5076</a>
+<a class="jxr_linenumber" name="L5077" href="#L5077">5077</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L5078" href="#L5078">5078</a> }
+<a class="jxr_linenumber" name="L5079" href="#L5079">5079</a>
+<a class="jxr_linenumber" name="L5080" href="#L5080">5080</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5081" href="#L5081">5081</a> <em class="jxr_javadoccomment"> * Returns the substring after the first occurrence of a separator.</em>
+<a class="jxr_linenumber" name="L5082" href="#L5082">5082</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5083" href="#L5083">5083</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5084" href="#L5084">5084</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5085" href="#L5085">5085</a> <em class="jxr_javadoccomment"> * substringAfter(<jk>null</jk>, <js>"."</js>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L5086" href="#L5086">5086</a> <em class="jxr_javadoccomment"> * substringAfter(<js>"hello.world"</js>, <jk>null</jk>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L5087" href="#L5087">5087</a> <em class="jxr_javadoccomment"> * substringAfter(<js>"hello.world"</js>, <js>"."</js>); <jc>// "world"</jc></em>
+<a class="jxr_linenumber" name="L5088" href="#L5088">5088</a> <em class="jxr_javadoccomment"> * substringAfter(<js>"hello.world"</js>, <js>"xyz"</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L5089" href="#L5089">5089</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5090" href="#L5090">5090</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5091" href="#L5091">5091</a> <em class="jxr_javadoccomment"> * @param str The string to get a substring from.</em>
+<a class="jxr_linenumber" name="L5092" href="#L5092">5092</a> <em class="jxr_javadoccomment"> * @param separator The separator string.</em>
+<a class="jxr_linenumber" name="L5093" href="#L5093">5093</a> <em class="jxr_javadoccomment"> * @return The substring after the first occurrence of the separator, or empty string if separator not found.</em>
+<a class="jxr_linenumber" name="L5094" href="#L5094">5094</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5095" href="#L5095">5095</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String substringAfter(String str, String separator) {
+<a class="jxr_linenumber" name="L5096" href="#L5096">5096</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L5097" href="#L5097">5097</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L5098" href="#L5098">5098</a> <strong class="jxr_keyword">if</strong> (separator == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5099" href="#L5099">5099</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L5100" href="#L5100">5100</a> <strong class="jxr_keyword">var</strong> pos = str.indexOf(separator);
+<a class="jxr_linenumber" name="L5101" href="#L5101">5101</a> <strong class="jxr_keyword">if</strong> (pos == -1)
+<a class="jxr_linenumber" name="L5102" href="#L5102">5102</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L5103" href="#L5103">5103</a> <strong class="jxr_keyword">return</strong> str.substring(pos + separator.length());
+<a class="jxr_linenumber" name="L5104" href="#L5104">5104</a> }
<a class="jxr_linenumber" name="L5105" href="#L5105">5105</a>
-<a class="jxr_linenumber" name="L5106" href="#L5106">5106</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5107" href="#L5107">5107</a> <em class="jxr_javadoccomment"> * Returns the substring before the first occurrence of a separator.</em>
-<a class="jxr_linenumber" name="L5108" href="#L5108">5108</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5109" href="#L5109">5109</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5110" href="#L5110">5110</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5111" href="#L5111">5111</a> <em class="jxr_javadoccomment"> * substringBefore(<jk>null</jk>, <js>"."</js>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L5112" href="#L5112">5112</a> <em class="jxr_javadoccomment"> * substringBefore(<js>"hello.world"</js>, <jk>null</jk>); <jc>// "hello.world"</jc></em>
-<a class="jxr_linenumber" name="L5113" href="#L5113">5113</a> <em class="jxr_javadoccomment"> * substringBefore(<js>"hello.world"</js>, <js>"."</js>); <jc>// "hello"</jc></em>
-<a class="jxr_linenumber" name="L5114" href="#L5114">5114</a> <em class="jxr_javadoccomment"> * substringBefore(<js>"hello.world"</js>, <js>"xyz"</js>); <jc>// "hello.world"</jc></em>
-<a class="jxr_linenumber" name="L5115" href="#L5115">5115</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5116" href="#L5116">5116</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5117" href="#L5117">5117</a> <em class="jxr_javadoccomment"> * @param str The string to get a substring from.</em>
-<a class="jxr_linenumber" name="L5118" href="#L5118">5118</a> <em class="jxr_javadoccomment"> * @param separator The separator string.</em>
-<a class="jxr_linenumber" name="L5119" href="#L5119">5119</a> <em class="jxr_javadoccomment"> * @return The substring before the first occurrence of the separator, or the original string if separator not found.</em>
-<a class="jxr_linenumber" name="L5120" href="#L5120">5120</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5121" href="#L5121">5121</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String substringBefore(String str, String separator) {
-<a class="jxr_linenumber" name="L5122" href="#L5122">5122</a> <strong class="jxr_keyword">if</strong> (isEmpty(str) || separator == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5123" href="#L5123">5123</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L5124" href="#L5124">5124</a> <strong class="jxr_keyword">var</strong> pos = str.indexOf(separator);
-<a class="jxr_linenumber" name="L5125" href="#L5125">5125</a> <strong class="jxr_keyword">if</strong> (pos == -1)
-<a class="jxr_linenumber" name="L5126" href="#L5126">5126</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L5127" href="#L5127">5127</a> <strong class="jxr_keyword">return</strong> str.substring(0, pos);
-<a class="jxr_linenumber" name="L5128" href="#L5128">5128</a> }
-<a class="jxr_linenumber" name="L5129" href="#L5129">5129</a>
-<a class="jxr_linenumber" name="L5130" href="#L5130">5130</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L5131" href="#L5131">5131</a> <em class="jxr_comment">// String cleaning and sanitization methods</em>
-<a class="jxr_linenumber" name="L5132" href="#L5132">5132</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L5106" href="#L5106">5106</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L5107" href="#L5107">5107</a> <em class="jxr_comment">// String joining and splitting methods</em>
+<a class="jxr_linenumber" name="L5108" href="#L5108">5108</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L5109" href="#L5109">5109</a>
+<a class="jxr_linenumber" name="L5110" href="#L5110">5110</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5111" href="#L5111">5111</a> <em class="jxr_javadoccomment"> * Returns the substring before the first occurrence of a separator.</em>
+<a class="jxr_linenumber" name="L5112" href="#L5112">5112</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5113" href="#L5113">5113</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5114" href="#L5114">5114</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5115" href="#L5115">5115</a> <em class="jxr_javadoccomment"> * substringBefore(<jk>null</jk>, <js>"."</js>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L5116" href="#L5116">5116</a> <em class="jxr_javadoccomment"> * substringBefore(<js>"hello.world"</js>, <jk>null</jk>); <jc>// "hello.world"</jc></em>
+<a class="jxr_linenumber" name="L5117" href="#L5117">5117</a> <em class="jxr_javadoccomment"> * substringBefore(<js>"hello.world"</js>, <js>"."</js>); <jc>// "hello"</jc></em>
+<a class="jxr_linenumber" name="L5118" href="#L5118">5118</a> <em class="jxr_javadoccomment"> * substringBefore(<js>"hello.world"</js>, <js>"xyz"</js>); <jc>// "hello.world"</jc></em>
+<a class="jxr_linenumber" name="L5119" href="#L5119">5119</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5120" href="#L5120">5120</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5121" href="#L5121">5121</a> <em class="jxr_javadoccomment"> * @param str The string to get a substring from.</em>
+<a class="jxr_linenumber" name="L5122" href="#L5122">5122</a> <em class="jxr_javadoccomment"> * @param separator The separator string.</em>
+<a class="jxr_linenumber" name="L5123" href="#L5123">5123</a> <em class="jxr_javadoccomment"> * @return The substring before the first occurrence of the separator, or the original string if separator not found.</em>
+<a class="jxr_linenumber" name="L5124" href="#L5124">5124</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5125" href="#L5125">5125</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String substringBefore(String str, String separator) {
+<a class="jxr_linenumber" name="L5126" href="#L5126">5126</a> <strong class="jxr_keyword">if</strong> (isEmpty(str) || separator == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5127" href="#L5127">5127</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L5128" href="#L5128">5128</a> <strong class="jxr_keyword">var</strong> pos = str.indexOf(separator);
+<a class="jxr_linenumber" name="L5129" href="#L5129">5129</a> <strong class="jxr_keyword">if</strong> (pos == -1)
+<a class="jxr_linenumber" name="L5130" href="#L5130">5130</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L5131" href="#L5131">5131</a> <strong class="jxr_keyword">return</strong> str.substring(0, pos);
+<a class="jxr_linenumber" name="L5132" href="#L5132">5132</a> }
<a class="jxr_linenumber" name="L5133" href="#L5133">5133</a>
-<a class="jxr_linenumber" name="L5134" href="#L5134">5134</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5135" href="#L5135">5135</a> <em class="jxr_javadoccomment"> * Returns the substring between two delimiters.</em>
-<a class="jxr_linenumber" name="L5136" href="#L5136">5136</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5137" href="#L5137">5137</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5138" href="#L5138">5138</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5139" href="#L5139">5139</a> <em class="jxr_javadoccomment"> * substringBetween(<jk>null</jk>, <js>"&lt;"</js>, <js>"&gt;"</js>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L5140" href="#L5140">5140</a> <em class="jxr_javadoccomment"> * substringBetween(<js>"&lt;hello&gt;"</js>, <js>"&lt;"</js>, <js>"&gt;"</js>); <jc>// "hello"</jc></em>
-<a class="jxr_linenumber" name="L5141" href="#L5141">5141</a> <em class="jxr_javadoccomment"> * substringBetween(<js>"&lt;hello&gt;"</js>, <js>"["</js>, <js>"]"</js>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L5142" href="#L5142">5142</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5143" href="#L5143">5143</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5144" href="#L5144">5144</a> <em class="jxr_javadoccomment"> * @param str The string to get a substring from.</em>
-<a class="jxr_linenumber" name="L5145" href="#L5145">5145</a> <em class="jxr_javadoccomment"> * @param open The opening delimiter.</em>
-<a class="jxr_linenumber" name="L5146" href="#L5146">5146</a> <em class="jxr_javadoccomment"> * @param close The closing delimiter.</em>
-<a class="jxr_linenumber" name="L5147" href="#L5147">5147</a> <em class="jxr_javadoccomment"> * @return The substring between the delimiters, or <jk>null</jk> if delimiters not found.</em>
-<a class="jxr_linenumber" name="L5148" href="#L5148">5148</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5149" href="#L5149">5149</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String substringBetween(String str, String open, String close) {
-<a class="jxr_linenumber" name="L5150" href="#L5150">5150</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || open == <strong class="jxr_keyword">null</strong> || close == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5151" href="#L5151">5151</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5152" href="#L5152">5152</a> <strong class="jxr_keyword">var</strong> start = str.indexOf(open);
-<a class="jxr_linenumber" name="L5153" href="#L5153">5153</a> <strong class="jxr_keyword">if</strong> (start == -1)
-<a class="jxr_linenumber" name="L5154" href="#L5154">5154</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5155" href="#L5155">5155</a> <strong class="jxr_keyword">var</strong> end = str.indexOf(close, start + open.length());
-<a class="jxr_linenumber" name="L5156" href="#L5156">5156</a> <strong class="jxr_keyword">if</strong> (end == -1)
-<a class="jxr_linenumber" name="L5157" href="#L5157">5157</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5158" href="#L5158">5158</a> <strong class="jxr_keyword">return</strong> str.substring(start + open.length(), end);
-<a class="jxr_linenumber" name="L5159" href="#L5159">5159</a> }
-<a class="jxr_linenumber" name="L5160" href="#L5160">5160</a>
-<a class="jxr_linenumber" name="L5161" href="#L5161">5161</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5162" href="#L5162">5162</a> <em class="jxr_javadoccomment"> * Parses a string containing key-value pairs into a map.</em>
-<a class="jxr_linenumber" name="L5163" href="#L5163">5163</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5164" href="#L5164">5164</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5165" href="#L5165">5165</a> <em class="jxr_javadoccomment"> * Splits the string by the entry delimiter, then splits each entry by the key-value delimiter.</em>
-<a class="jxr_linenumber" name="L5166" href="#L5166">5166</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5167" href="#L5167">5167</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5168" href="#L5168">5168</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5169" href="#L5169">5169</a> <em class="jxr_javadoccomment"> * parseMap(<js>"key1=value1,key2=value2"</js>, <js>'='</js>, <js>','</js>, <jk>false</jk>);</em>
-<a class="jxr_linenumber" name="L5170" href="#L5170">5170</a> <em class="jxr_javadoccomment"> * <jc>// {"key1":"value1","key2":"value2"}</jc></em>
-<a class="jxr_linenumber" name="L5171" href="#L5171">5171</a> <em class="jxr_javadoccomment"> * parseMap(<js>" key1 = value1 ; key2 = value2 "</js>, <js>'='</js>, <js>';'</js>, <jk>true</jk>);</em>
-<a class="jxr_linenumber" name="L5172" href="#L5172">5172</a> <em class="jxr_javadoccomment"> * <jc>// {"key1":"value1","key2":"value2"}</jc></em>
-<a class="jxr_linenumber" name="L5173" href="#L5173">5173</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5174" href="#L5174">5174</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5175" href="#L5175">5175</a> <em class="jxr_javadoccomment"> * @param str The string to parse. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5176" href="#L5176">5176</a> <em class="jxr_javadoccomment"> * @param keyValueDelimiter The character that separates keys from values.</em>
-<a class="jxr_linenumber" name="L5177" href="#L5177">5177</a> <em class="jxr_javadoccomment"> * @param entryDelimiter The character that separates entries.</em>
-<a class="jxr_linenumber" name="L5178" href="#L5178">5178</a> <em class="jxr_javadoccomment"> * @param trimKeys If <jk>true</jk>, trims whitespace from keys and values.</em>
-<a class="jxr_linenumber" name="L5179" href="#L5179">5179</a> <em class="jxr_javadoccomment"> * @return A map containing the parsed key-value pairs, or an empty map if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5180" href="#L5180">5180</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5181" href="#L5181">5181</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Map<String,String> parseMap(String str, <strong class="jxr_keyword">char</strong> keyValueDelimiter, <strong class="jxr_keyword">char</strong> entryDelimiter, <strong class="jxr_keyword">boolean</strong> trimKeys) {
-<a class="jxr_linenumber" name="L5182" href="#L5182">5182</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> LinkedHashMap<String,String>();
-<a class="jxr_linenumber" name="L5183" href="#L5183">5183</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5184" href="#L5184">5184</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L5185" href="#L5185">5185</a>
-<a class="jxr_linenumber" name="L5186" href="#L5186">5186</a> <strong class="jxr_keyword">var</strong> entries = split(str, entryDelimiter);
-<a class="jxr_linenumber" name="L5187" href="#L5187">5187</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> entry : entries) {
-<a class="jxr_linenumber" name="L5188" href="#L5188">5188</a> <strong class="jxr_keyword">if</strong> (isEmpty(entry))
-<a class="jxr_linenumber" name="L5189" href="#L5189">5189</a> <strong class="jxr_keyword">continue</strong>;
-<a class="jxr_linenumber" name="L5190" href="#L5190">5190</a> <strong class="jxr_keyword">var</strong> delimiterIndex = entry.indexOf(keyValueDelimiter);
-<a class="jxr_linenumber" name="L5191" href="#L5191">5191</a> <strong class="jxr_keyword">if</strong> (delimiterIndex == -1) {
-<a class="jxr_linenumber" name="L5192" href="#L5192">5192</a> <em class="jxr_comment">// No delimiter found, treat entire entry as key with empty value</em>
-<a class="jxr_linenumber" name="L5193" href="#L5193">5193</a> <strong class="jxr_keyword">var</strong> key = trimKeys ? entry.trim() : entry;
-<a class="jxr_linenumber" name="L5194" href="#L5194">5194</a> result.put(key, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L5195" href="#L5195">5195</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L5196" href="#L5196">5196</a> <strong class="jxr_keyword">var</strong> key = entry.substring(0, delimiterIndex);
-<a class="jxr_linenumber" name="L5197" href="#L5197">5197</a> <strong class="jxr_keyword">var</strong> value = entry.substring(delimiterIndex + 1);
-<a class="jxr_linenumber" name="L5198" href="#L5198">5198</a> <strong class="jxr_keyword">if</strong> (trimKeys) {
-<a class="jxr_linenumber" name="L5199" href="#L5199">5199</a> key = key.trim();
-<a class="jxr_linenumber" name="L5200" href="#L5200">5200</a> value = value.trim();
-<a class="jxr_linenumber" name="L5201" href="#L5201">5201</a> }
-<a class="jxr_linenumber" name="L5202" href="#L5202">5202</a> result.put(key, value);
-<a class="jxr_linenumber" name="L5203" href="#L5203">5203</a> }
-<a class="jxr_linenumber" name="L5204" href="#L5204">5204</a> }
-<a class="jxr_linenumber" name="L5205" href="#L5205">5205</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L5206" href="#L5206">5206</a> }
-<a class="jxr_linenumber" name="L5207" href="#L5207">5207</a>
-<a class="jxr_linenumber" name="L5208" href="#L5208">5208</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5209" href="#L5209">5209</a> <em class="jxr_javadoccomment"> * Extracts all numeric sequences from a string.</em>
-<a class="jxr_linenumber" name="L5210" href="#L5210">5210</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5211" href="#L5211">5211</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5212" href="#L5212">5212</a> <em class="jxr_javadoccomment"> * Finds all sequences of digits (including decimal numbers with dots).</em>
-<a class="jxr_linenumber" name="L5213" href="#L5213">5213</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5214" href="#L5214">5214</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5215" href="#L5215">5215</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5216" href="#L5216">5216</a> <em class="jxr_javadoccomment"> * extractNumbers(<js>"Price: $19.99, Quantity: 5"</js>);</em>
-<a class="jxr_linenumber" name="L5217" href="#L5217">5217</a> <em class="jxr_javadoccomment"> * <jc>// ["19.99", "5"]</jc></em>
-<a class="jxr_linenumber" name="L5218" href="#L5218">5218</a> <em class="jxr_javadoccomment"> * extractNumbers(<js>"Version 1.2.3"</js>);</em>
-<a class="jxr_linenumber" name="L5219" href="#L5219">5219</a> <em class="jxr_javadoccomment"> * <jc>// ["1.2", "3"]</jc></em>
-<a class="jxr_linenumber" name="L5220" href="#L5220">5220</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5221" href="#L5221">5221</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5222" href="#L5222">5222</a> <em class="jxr_javadoccomment"> * @param str The string to extract numbers from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5223" href="#L5223">5223</a> <em class="jxr_javadoccomment"> * @return A list of numeric strings found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5224" href="#L5224">5224</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5225" href="#L5225">5225</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractNumbers(String str) {
-<a class="jxr_linenumber" name="L5226" href="#L5226">5226</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5227" href="#L5227">5227</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L5228" href="#L5228">5228</a>
-<a class="jxr_linenumber" name="L5229" href="#L5229">5229</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L5230" href="#L5230">5230</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"\\d+(?:\\.\\d+)?"</span>);
-<a class="jxr_linenumber" name="L5231" href="#L5231">5231</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
-<a class="jxr_linenumber" name="L5232" href="#L5232">5232</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
-<a class="jxr_linenumber" name="L5233" href="#L5233">5233</a> result.add(matcher.group());
-<a class="jxr_linenumber" name="L5234" href="#L5234">5234</a> }
-<a class="jxr_linenumber" name="L5235" href="#L5235">5235</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L5236" href="#L5236">5236</a> }
-<a class="jxr_linenumber" name="L5237" href="#L5237">5237</a>
-<a class="jxr_linenumber" name="L5238" href="#L5238">5238</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5239" href="#L5239">5239</a> <em class="jxr_javadoccomment"> * Extracts all email addresses from a string.</em>
-<a class="jxr_linenumber" name="L5240" href="#L5240">5240</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5241" href="#L5241">5241</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5242" href="#L5242">5242</a> <em class="jxr_javadoccomment"> * Uses a basic email regex pattern to find email addresses.</em>
-<a class="jxr_linenumber" name="L5243" href="#L5243">5243</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5244" href="#L5244">5244</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5245" href="#L5245">5245</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5246" href="#L5246">5246</a> <em class="jxr_javadoccomment"> * extractEmails(<js>"Contact: user@example.com or admin@test.org"</js>);</em>
-<a class="jxr_linenumber" name="L5247" href="#L5247">5247</a> <em class="jxr_javadoccomment"> * <jc>// ["user@example.com", "admin@test.org"]</jc></em>
-<a class="jxr_linenumber" name="L5248" href="#L5248">5248</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5249" href="#L5249">5249</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5250" href="#L5250">5250</a> <em class="jxr_javadoccomment"> * @param str The string to extract emails from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5251" href="#L5251">5251</a> <em class="jxr_javadoccomment"> * @return A list of email addresses found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5252" href="#L5252">5252</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5253" href="#L5253">5253</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractEmails(String str) {
-<a class="jxr_linenumber" name="L5254" href="#L5254">5254</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5255" href="#L5255">5255</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L5256" href="#L5256">5256</a>
-<a class="jxr_linenumber" name="L5257" href="#L5257">5257</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L5258" href="#L5258">5258</a> <em class="jxr_comment">// Email regex pattern (same as isEmail but without ^ and $ anchors)</em>
-<a class="jxr_linenumber" name="L5259" href="#L5259">5259</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}"</span>);
-<a class="jxr_linenumber" name="L5260" href="#L5260">5260</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
-<a class="jxr_linenumber" name="L5261" href="#L5261">5261</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
-<a class="jxr_linenumber" name="L5262" href="#L5262">5262</a> result.add(matcher.group());
-<a class="jxr_linenumber" name="L5263" href="#L5263">5263</a> }
-<a class="jxr_linenumber" name="L5264" href="#L5264">5264</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L5265" href="#L5265">5265</a> }
-<a class="jxr_linenumber" name="L5266" href="#L5266">5266</a>
-<a class="jxr_linenumber" name="L5267" href="#L5267">5267</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5268" href="#L5268">5268</a> <em class="jxr_javadoccomment"> * Extracts all URLs from a string.</em>
-<a class="jxr_linenumber" name="L5269" href="#L5269">5269</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5270" href="#L5270">5270</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5271" href="#L5271">5271</a> <em class="jxr_javadoccomment"> * Uses a basic URL regex pattern to find URLs (http, https, ftp).</em>
-<a class="jxr_linenumber" name="L5272" href="#L5272">5272</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5273" href="#L5273">5273</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5274" href="#L5274">5274</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5275" href="#L5275">5275</a> <em class="jxr_javadoccomment"> * extractUrls(<js>"Visit <a href="https://example.com" target="alexandria_uri">https://example.com</a> or <a href="http://test.org" target="alexandria_uri">http://test.org</a>"</js>);</em>
-<a class="jxr_linenumber" name="L5276" href="#L5276">5276</a> <em class="jxr_javadoccomment"> * <jc>// ["<a href="https://example.com" target="alexandria_uri">https://example.com</a>", "<a href="http://test.org" target="alexandria_uri">http://test.org</a>"]</jc></em>
-<a class="jxr_linenumber" name="L5277" href="#L5277">5277</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5278" href="#L5278">5278</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5279" href="#L5279">5279</a> <em class="jxr_javadoccomment"> * @param str The string to extract URLs from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5280" href="#L5280">5280</a> <em class="jxr_javadoccomment"> * @return A list of URLs found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5281" href="#L5281">5281</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5282" href="#L5282">5282</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractUrls(String str) {
-<a class="jxr_linenumber" name="L5283" href="#L5283">5283</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5284" href="#L5284">5284</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L5285" href="#L5285">5285</a>
-<a class="jxr_linenumber" name="L5286" href="#L5286">5286</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L5287" href="#L5287">5287</a> <em class="jxr_comment">// Basic URL pattern: protocol://domain/path</em>
-<a class="jxr_linenumber" name="L5288" href="#L5288">5288</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"(?:https?|ftp)://[\\w\\-._~:/?#\\[\\]@!$&'()*+,;=%]+"</span>, Pattern.CASE_INSENSITIVE);
-<a class="jxr_linenumber" name="L5289" href="#L5289">5289</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
-<a class="jxr_linenumber" name="L5290" href="#L5290">5290</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
-<a class="jxr_linenumber" name="L5291" href="#L5291">5291</a> result.add(matcher.group());
-<a class="jxr_linenumber" name="L5292" href="#L5292">5292</a> }
-<a class="jxr_linenumber" name="L5293" href="#L5293">5293</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L5294" href="#L5294">5294</a> }
-<a class="jxr_linenumber" name="L5295" href="#L5295">5295</a>
-<a class="jxr_linenumber" name="L5296" href="#L5296">5296</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5297" href="#L5297">5297</a> <em class="jxr_javadoccomment"> * Extracts all words from a string.</em>
-<a class="jxr_linenumber" name="L5298" href="#L5298">5298</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5299" href="#L5299">5299</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5300" href="#L5300">5300</a> <em class="jxr_javadoccomment"> * A word is defined as a sequence of letters, digits, and underscores.</em>
-<a class="jxr_linenumber" name="L5301" href="#L5301">5301</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5302" href="#L5302">5302</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5303" href="#L5303">5303</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5304" href="#L5304">5304</a> <em class="jxr_javadoccomment"> * extractWords(<js>"Hello world! This is a test."</js>);</em>
-<a class="jxr_linenumber" name="L5305" href="#L5305">5305</a> <em class="jxr_javadoccomment"> * <jc>// ["Hello", "world", "This", "is", "a", "test"]</jc></em>
-<a class="jxr_linenumber" name="L5306" href="#L5306">5306</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5307" href="#L5307">5307</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5308" href="#L5308">5308</a> <em class="jxr_javadoccomment"> * @param str The string to extract words from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5309" href="#L5309">5309</a> <em class="jxr_javadoccomment"> * @return A list of words found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5310" href="#L5310">5310</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5311" href="#L5311">5311</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractWords(String str) {
-<a class="jxr_linenumber" name="L5312" href="#L5312">5312</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5313" href="#L5313">5313</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L5314" href="#L5314">5314</a>
-<a class="jxr_linenumber" name="L5315" href="#L5315">5315</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L5316" href="#L5316">5316</a> <em class="jxr_comment">// Word pattern: sequence of word characters (letters, digits, underscore)</em>
-<a class="jxr_linenumber" name="L5317" href="#L5317">5317</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"\\w+"</span>);
-<a class="jxr_linenumber" name="L5318" href="#L5318">5318</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
-<a class="jxr_linenumber" name="L5319" href="#L5319">5319</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
-<a class="jxr_linenumber" name="L5320" href="#L5320">5320</a> result.add(matcher.group());
-<a class="jxr_linenumber" name="L5321" href="#L5321">5321</a> }
-<a class="jxr_linenumber" name="L5322" href="#L5322">5322</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L5323" href="#L5323">5323</a> }
-<a class="jxr_linenumber" name="L5324" href="#L5324">5324</a>
-<a class="jxr_linenumber" name="L5325" href="#L5325">5325</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5326" href="#L5326">5326</a> <em class="jxr_javadoccomment"> * Extracts all text segments between start and end markers.</em>
-<a class="jxr_linenumber" name="L5327" href="#L5327">5327</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5328" href="#L5328">5328</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5329" href="#L5329">5329</a> <em class="jxr_javadoccomment"> * Finds all occurrences of text between the start and end markers (non-overlapping).</em>
-<a class="jxr_linenumber" name="L5330" href="#L5330">5330</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5331" href="#L5331">5331</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5332" href="#L5332">5332</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5333" href="#L5333">5333</a> <em class="jxr_javadoccomment"> * extractBetween(<js>"&lt;tag&gt;content&lt;/tag&gt;"</js>, <js>"&lt;"</js>, <js>"&gt;"</js>);</em>
-<a class="jxr_linenumber" name="L5334" href="#L5334">5334</a> <em class="jxr_javadoccomment"> * <jc>// ["tag", "/tag"]</jc></em>
-<a class="jxr_linenumber" name="L5335" href="#L5335">5335</a> <em class="jxr_javadoccomment"> * extractBetween(<js>"[one][two][three]"</js>, <js>"["</js>, <js>"]"</js>);</em>
-<a class="jxr_linenumber" name="L5336" href="#L5336">5336</a> <em class="jxr_javadoccomment"> * <jc>// ["one", "two", "three"]</jc></em>
-<a class="jxr_linenumber" name="L5337" href="#L5337">5337</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5338" href="#L5338">5338</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5339" href="#L5339">5339</a> <em class="jxr_javadoccomment"> * @param str The string to extract from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5340" href="#L5340">5340</a> <em class="jxr_javadoccomment"> * @param start The start marker. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5341" href="#L5341">5341</a> <em class="jxr_javadoccomment"> * @param end The end marker. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5342" href="#L5342">5342</a> <em class="jxr_javadoccomment"> * @return A list of text segments found between the markers, or an empty list if any parameter is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5343" href="#L5343">5343</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5344" href="#L5344">5344</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractBetween(String str, String start, String end) {
-<a class="jxr_linenumber" name="L5345" href="#L5345">5345</a> <strong class="jxr_keyword">if</strong> (isEmpty(str) || isEmpty(start) || isEmpty(end))
-<a class="jxr_linenumber" name="L5346" href="#L5346">5346</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L5347" href="#L5347">5347</a>
-<a class="jxr_linenumber" name="L5348" href="#L5348">5348</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L5349" href="#L5349">5349</a> <strong class="jxr_keyword">var</strong> startIndex = 0;
-<a class="jxr_linenumber" name="L5350" href="#L5350">5350</a> <strong class="jxr_keyword">while</strong> (<strong class="jxr_keyword">true</strong>) {
-<a class="jxr_linenumber" name="L5351" href="#L5351">5351</a> <strong class="jxr_keyword">var</strong> startPos = str.indexOf(start, startIndex);
-<a class="jxr_linenumber" name="L5352" href="#L5352">5352</a> <strong class="jxr_keyword">if</strong> (startPos == -1)
-<a class="jxr_linenumber" name="L5353" href="#L5353">5353</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5354" href="#L5354">5354</a> <strong class="jxr_keyword">var</strong> endPos = str.indexOf(end, startPos + start.length());
-<a class="jxr_linenumber" name="L5355" href="#L5355">5355</a> <strong class="jxr_keyword">if</strong> (endPos == -1)
-<a class="jxr_linenumber" name="L5356" href="#L5356">5356</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5357" href="#L5357">5357</a> result.add(str.substring(startPos + start.length(), endPos));
-<a class="jxr_linenumber" name="L5358" href="#L5358">5358</a> startIndex = endPos + end.length();
-<a class="jxr_linenumber" name="L5359" href="#L5359">5359</a> }
-<a class="jxr_linenumber" name="L5360" href="#L5360">5360</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L5361" href="#L5361">5361</a> }
-<a class="jxr_linenumber" name="L5362" href="#L5362">5362</a>
-<a class="jxr_linenumber" name="L5363" href="#L5363">5363</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5364" href="#L5364">5364</a> <em class="jxr_javadoccomment"> * Transliterates characters in a string by mapping characters from one set to another.</em>
-<a class="jxr_linenumber" name="L5365" href="#L5365">5365</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5366" href="#L5366">5366</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5367" href="#L5367">5367</a> <em class="jxr_javadoccomment"> * Performs character-by-character translation. If a character is found in <c>fromChars</c>,</em>
-<a class="jxr_linenumber" name="L5368" href="#L5368">5368</a> <em class="jxr_javadoccomment"> * it is replaced with the corresponding character at the same position in <c>toChars</c>.</em>
-<a class="jxr_linenumber" name="L5369" href="#L5369">5369</a> <em class="jxr_javadoccomment"> * Characters not found in <c>fromChars</c> are left unchanged.</em>
-<a class="jxr_linenumber" name="L5370" href="#L5370">5370</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5371" href="#L5371">5371</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5372" href="#L5372">5372</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5373" href="#L5373">5373</a> <em class="jxr_javadoccomment"> * transliterate(<js>"hello"</js>, <js>"aeiou"</js>, <js>"12345"</js>);</em>
-<a class="jxr_linenumber" name="L5374" href="#L5374">5374</a> <em class="jxr_javadoccomment"> * <jc>// "h2ll4"</jc></em>
-<a class="jxr_linenumber" name="L5375" href="#L5375">5375</a> <em class="jxr_javadoccomment"> * transliterate(<js>"ABC"</js>, <js>"ABC"</js>, <js>"XYZ"</js>);</em>
-<a class="jxr_linenumber" name="L5376" href="#L5376">5376</a> <em class="jxr_javadoccomment"> * <jc>// "XYZ"</jc></em>
-<a class="jxr_linenumber" name="L5377" href="#L5377">5377</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5378" href="#L5378">5378</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5379" href="#L5379">5379</a> <em class="jxr_javadoccomment"> * @param str The string to transliterate. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5380" href="#L5380">5380</a> <em class="jxr_javadoccomment"> * @param fromChars The source character set. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5381" href="#L5381">5381</a> <em class="jxr_javadoccomment"> * @param toChars The target character set. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5382" href="#L5382">5382</a> <em class="jxr_javadoccomment"> * @return The transliterated string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5383" href="#L5383">5383</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If <c>fromChars</c> and <c>toChars</c> have different lengths.</em>
-<a class="jxr_linenumber" name="L5384" href="#L5384">5384</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5385" href="#L5385">5385</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String transliterate(String str, String fromChars, String toChars) {
-<a class="jxr_linenumber" name="L5386" href="#L5386">5386</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5387" href="#L5387">5387</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5388" href="#L5388">5388</a> <strong class="jxr_keyword">if</strong> (fromChars == <strong class="jxr_keyword">null</strong> || toChars == <strong class="jxr_keyword">null</strong> || fromChars.isEmpty() || toChars.isEmpty())
-<a class="jxr_linenumber" name="L5389" href="#L5389">5389</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L5390" href="#L5390">5390</a> <strong class="jxr_keyword">if</strong> (fromChars.length() != toChars.length())
-<a class="jxr_linenumber" name="L5391" href="#L5391">5391</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException(<span class="jxr_string">"fromChars and toChars must have the same length"</span>);
-<a class="jxr_linenumber" name="L5392" href="#L5392">5392</a>
-<a class="jxr_linenumber" name="L5393" href="#L5393">5393</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(str.length());
-<a class="jxr_linenumber" name="L5394" href="#L5394">5394</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L5395" href="#L5395">5395</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
-<a class="jxr_linenumber" name="L5396" href="#L5396">5396</a> <strong class="jxr_keyword">var</strong> index = fromChars.indexOf(c);
-<a class="jxr_linenumber" name="L5397" href="#L5397">5397</a> <strong class="jxr_keyword">if</strong> (index >= 0)
-<a class="jxr_linenumber" name="L5398" href="#L5398">5398</a> sb.append(toChars.charAt(index));
-<a class="jxr_linenumber" name="L5399" href="#L5399">5399</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L5400" href="#L5400">5400</a> sb.append(c);
-<a class="jxr_linenumber" name="L5401" href="#L5401">5401</a> }
-<a class="jxr_linenumber" name="L5402" href="#L5402">5402</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L5403" href="#L5403">5403</a> }
-<a class="jxr_linenumber" name="L5404" href="#L5404">5404</a>
-<a class="jxr_linenumber" name="L5405" href="#L5405">5405</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5406" href="#L5406">5406</a> <em class="jxr_javadoccomment"> * Generates a Soundex code for a string.</em>
-<a class="jxr_linenumber" name="L5407" href="#L5407">5407</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5408" href="#L5408">5408</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5409" href="#L5409">5409</a> <em class="jxr_javadoccomment"> * Soundex is a phonetic algorithm for indexing names by sound. The code consists of</em>
-<a class="jxr_linenumber" name="L5410" href="#L5410">5410</a> <em class="jxr_javadoccomment"> * a letter followed by three digits. Similar-sounding names produce the same code.</em>
+<a class="jxr_linenumber" name="L5134" href="#L5134">5134</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L5135" href="#L5135">5135</a> <em class="jxr_comment">// String cleaning and sanitization methods</em>
+<a class="jxr_linenumber" name="L5136" href="#L5136">5136</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L5137" href="#L5137">5137</a>
+<a class="jxr_linenumber" name="L5138" href="#L5138">5138</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5139" href="#L5139">5139</a> <em class="jxr_javadoccomment"> * Returns the substring between two delimiters.</em>
+<a class="jxr_linenumber" name="L5140" href="#L5140">5140</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5141" href="#L5141">5141</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5142" href="#L5142">5142</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5143" href="#L5143">5143</a> <em class="jxr_javadoccomment"> * substringBetween(<jk>null</jk>, <js>"&lt;"</js>, <js>"&gt;"</js>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L5144" href="#L5144">5144</a> <em class="jxr_javadoccomment"> * substringBetween(<js>"&lt;hello&gt;"</js>, <js>"&lt;"</js>, <js>"&gt;"</js>); <jc>// "hello"</jc></em>
+<a class="jxr_linenumber" name="L5145" href="#L5145">5145</a> <em class="jxr_javadoccomment"> * substringBetween(<js>"&lt;hello&gt;"</js>, <js>"["</js>, <js>"]"</js>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L5146" href="#L5146">5146</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5147" href="#L5147">5147</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5148" href="#L5148">5148</a> <em class="jxr_javadoccomment"> * @param str The string to get a substring from.</em>
+<a class="jxr_linenumber" name="L5149" href="#L5149">5149</a> <em class="jxr_javadoccomment"> * @param open The opening delimiter.</em>
+<a class="jxr_linenumber" name="L5150" href="#L5150">5150</a> <em class="jxr_javadoccomment"> * @param close The closing delimiter.</em>
+<a class="jxr_linenumber" name="L5151" href="#L5151">5151</a> <em class="jxr_javadoccomment"> * @return The substring between the delimiters, or <jk>null</jk> if delimiters not found.</em>
+<a class="jxr_linenumber" name="L5152" href="#L5152">5152</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5153" href="#L5153">5153</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String substringBetween(String str, String open, String close) {
+<a class="jxr_linenumber" name="L5154" href="#L5154">5154</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || open == <strong class="jxr_keyword">null</strong> || close == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5155" href="#L5155">5155</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5156" href="#L5156">5156</a> <strong class="jxr_keyword">var</strong> start = str.indexOf(open);
+<a class="jxr_linenumber" name="L5157" href="#L5157">5157</a> <strong class="jxr_keyword">if</strong> (start == -1)
+<a class="jxr_linenumber" name="L5158" href="#L5158">5158</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5159" href="#L5159">5159</a> <strong class="jxr_keyword">var</strong> end = str.indexOf(close, start + open.length());
+<a class="jxr_linenumber" name="L5160" href="#L5160">5160</a> <strong class="jxr_keyword">if</strong> (end == -1)
+<a class="jxr_linenumber" name="L5161" href="#L5161">5161</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5162" href="#L5162">5162</a> <strong class="jxr_keyword">return</strong> str.substring(start + open.length(), end);
+<a class="jxr_linenumber" name="L5163" href="#L5163">5163</a> }
+<a class="jxr_linenumber" name="L5164" href="#L5164">5164</a>
+<a class="jxr_linenumber" name="L5165" href="#L5165">5165</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5166" href="#L5166">5166</a> <em class="jxr_javadoccomment"> * Parses a string containing key-value pairs into a map.</em>
+<a class="jxr_linenumber" name="L5167" href="#L5167">5167</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5168" href="#L5168">5168</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5169" href="#L5169">5169</a> <em class="jxr_javadoccomment"> * Splits the string by the entry delimiter, then splits each entry by the key-value delimiter.</em>
+<a class="jxr_linenumber" name="L5170" href="#L5170">5170</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5171" href="#L5171">5171</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5172" href="#L5172">5172</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5173" href="#L5173">5173</a> <em class="jxr_javadoccomment"> * parseMap(<js>"key1=value1,key2=value2"</js>, <js>'='</js>, <js>','</js>, <jk>false</jk>);</em>
+<a class="jxr_linenumber" name="L5174" href="#L5174">5174</a> <em class="jxr_javadoccomment"> * <jc>// {"key1":"value1","key2":"value2"}</jc></em>
+<a class="jxr_linenumber" name="L5175" href="#L5175">5175</a> <em class="jxr_javadoccomment"> * parseMap(<js>" key1 = value1 ; key2 = value2 "</js>, <js>'='</js>, <js>';'</js>, <jk>true</jk>);</em>
+<a class="jxr_linenumber" name="L5176" href="#L5176">5176</a> <em class="jxr_javadoccomment"> * <jc>// {"key1":"value1","key2":"value2"}</jc></em>
+<a class="jxr_linenumber" name="L5177" href="#L5177">5177</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5178" href="#L5178">5178</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5179" href="#L5179">5179</a> <em class="jxr_javadoccomment"> * @param str The string to parse. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5180" href="#L5180">5180</a> <em class="jxr_javadoccomment"> * @param keyValueDelimiter The character that separates keys from values.</em>
+<a class="jxr_linenumber" name="L5181" href="#L5181">5181</a> <em class="jxr_javadoccomment"> * @param entryDelimiter The character that separates entries.</em>
+<a class="jxr_linenumber" name="L5182" href="#L5182">5182</a> <em class="jxr_javadoccomment"> * @param trimKeys If <jk>true</jk>, trims whitespace from keys and values.</em>
+<a class="jxr_linenumber" name="L5183" href="#L5183">5183</a> <em class="jxr_javadoccomment"> * @return A map containing the parsed key-value pairs, or an empty map if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L5184" href="#L5184">5184</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5185" href="#L5185">5185</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Map<String,String> parseMap(String str, <strong class="jxr_keyword">char</strong> keyValueDelimiter, <strong class="jxr_keyword">char</strong> entryDelimiter, <strong class="jxr_keyword">boolean</strong> trimKeys) {
+<a class="jxr_linenumber" name="L5186" href="#L5186">5186</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> LinkedHashMap<String,String>();
+<a class="jxr_linenumber" name="L5187" href="#L5187">5187</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L5188" href="#L5188">5188</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L5189" href="#L5189">5189</a>
+<a class="jxr_linenumber" name="L5190" href="#L5190">5190</a> <strong class="jxr_keyword">var</strong> entries = split(str, entryDelimiter);
+<a class="jxr_linenumber" name="L5191" href="#L5191">5191</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> entry : entries) {
+<a class="jxr_linenumber" name="L5192" href="#L5192">5192</a> <strong class="jxr_keyword">if</strong> (isEmpty(entry))
+<a class="jxr_linenumber" name="L5193" href="#L5193">5193</a> <strong class="jxr_keyword">continue</strong>;
+<a class="jxr_linenumber" name="L5194" href="#L5194">5194</a> <strong class="jxr_keyword">var</strong> delimiterIndex = entry.indexOf(keyValueDelimiter);
+<a class="jxr_linenumber" name="L5195" href="#L5195">5195</a> <strong class="jxr_keyword">if</strong> (delimiterIndex == -1) {
+<a class="jxr_linenumber" name="L5196" href="#L5196">5196</a> <em class="jxr_comment">// No delimiter found, treat entire entry as key with empty value</em>
+<a class="jxr_linenumber" name="L5197" href="#L5197">5197</a> <strong class="jxr_keyword">var</strong> key = trimKeys ? entry.trim() : entry;
+<a class="jxr_linenumber" name="L5198" href="#L5198">5198</a> result.put(key, <span class="jxr_string">""</span>);
+<a class="jxr_linenumber" name="L5199" href="#L5199">5199</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L5200" href="#L5200">5200</a> <strong class="jxr_keyword">var</strong> key = entry.substring(0, delimiterIndex);
+<a class="jxr_linenumber" name="L5201" href="#L5201">5201</a> <strong class="jxr_keyword">var</strong> value = entry.substring(delimiterIndex + 1);
+<a class="jxr_linenumber" name="L5202" href="#L5202">5202</a> <strong class="jxr_keyword">if</strong> (trimKeys) {
+<a class="jxr_linenumber" name="L5203" href="#L5203">5203</a> key = key.trim();
+<a class="jxr_linenumber" name="L5204" href="#L5204">5204</a> value = value.trim();
+<a class="jxr_linenumber" name="L5205" href="#L5205">5205</a> }
+<a class="jxr_linenumber" name="L5206" href="#L5206">5206</a> result.put(key, value);
+<a class="jxr_linenumber" name="L5207" href="#L5207">5207</a> }
+<a class="jxr_linenumber" name="L5208" href="#L5208">5208</a> }
+<a class="jxr_linenumber" name="L5209" href="#L5209">5209</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L5210" href="#L5210">5210</a> }
+<a class="jxr_linenumber" name="L5211" href="#L5211">5211</a>
+<a class="jxr_linenumber" name="L5212" href="#L5212">5212</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5213" href="#L5213">5213</a> <em class="jxr_javadoccomment"> * Extracts all numeric sequences from a string.</em>
+<a class="jxr_linenumber" name="L5214" href="#L5214">5214</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5215" href="#L5215">5215</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5216" href="#L5216">5216</a> <em class="jxr_javadoccomment"> * Finds all sequences of digits (including decimal numbers with dots).</em>
+<a class="jxr_linenumber" name="L5217" href="#L5217">5217</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5218" href="#L5218">5218</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5219" href="#L5219">5219</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5220" href="#L5220">5220</a> <em class="jxr_javadoccomment"> * extractNumbers(<js>"Price: $19.99, Quantity: 5"</js>);</em>
+<a class="jxr_linenumber" name="L5221" href="#L5221">5221</a> <em class="jxr_javadoccomment"> * <jc>// ["19.99", "5"]</jc></em>
+<a class="jxr_linenumber" name="L5222" href="#L5222">5222</a> <em class="jxr_javadoccomment"> * extractNumbers(<js>"Version 1.2.3"</js>);</em>
+<a class="jxr_linenumber" name="L5223" href="#L5223">5223</a> <em class="jxr_javadoccomment"> * <jc>// ["1.2", "3"]</jc></em>
+<a class="jxr_linenumber" name="L5224" href="#L5224">5224</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5225" href="#L5225">5225</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5226" href="#L5226">5226</a> <em class="jxr_javadoccomment"> * @param str The string to extract numbers from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5227" href="#L5227">5227</a> <em class="jxr_javadoccomment"> * @return A list of numeric strings found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L5228" href="#L5228">5228</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5229" href="#L5229">5229</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractNumbers(String str) {
+<a class="jxr_linenumber" name="L5230" href="#L5230">5230</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L5231" href="#L5231">5231</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L5232" href="#L5232">5232</a>
+<a class="jxr_linenumber" name="L5233" href="#L5233">5233</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L5234" href="#L5234">5234</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"\\d+(?:\\.\\d+)?"</span>);
+<a class="jxr_linenumber" name="L5235" href="#L5235">5235</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
+<a class="jxr_linenumber" name="L5236" href="#L5236">5236</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
+<a class="jxr_linenumber" name="L5237" href="#L5237">5237</a> result.add(matcher.group());
+<a class="jxr_linenumber" name="L5238" href="#L5238">5238</a> }
+<a class="jxr_linenumber" name="L5239" href="#L5239">5239</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L5240" href="#L5240">5240</a> }
+<a class="jxr_linenumber" name="L5241" href="#L5241">5241</a>
+<a class="jxr_linenumber" name="L5242" href="#L5242">5242</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5243" href="#L5243">5243</a> <em class="jxr_javadoccomment"> * Extracts all email addresses from a string.</em>
+<a class="jxr_linenumber" name="L5244" href="#L5244">5244</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5245" href="#L5245">5245</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5246" href="#L5246">5246</a> <em class="jxr_javadoccomment"> * Uses a basic email regex pattern to find email addresses.</em>
+<a class="jxr_linenumber" name="L5247" href="#L5247">5247</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5248" href="#L5248">5248</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5249" href="#L5249">5249</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5250" href="#L5250">5250</a> <em class="jxr_javadoccomment"> * extractEmails(<js>"Contact: user@example.com or admin@test.org"</js>);</em>
+<a class="jxr_linenumber" name="L5251" href="#L5251">5251</a> <em class="jxr_javadoccomment"> * <jc>// ["user@example.com", "admin@test.org"]</jc></em>
+<a class="jxr_linenumber" name="L5252" href="#L5252">5252</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5253" href="#L5253">5253</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5254" href="#L5254">5254</a> <em class="jxr_javadoccomment"> * @param str The string to extract emails from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5255" href="#L5255">5255</a> <em class="jxr_javadoccomment"> * @return A list of email addresses found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L5256" href="#L5256">5256</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5257" href="#L5257">5257</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractEmails(String str) {
+<a class="jxr_linenumber" name="L5258" href="#L5258">5258</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L5259" href="#L5259">5259</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L5260" href="#L5260">5260</a>
+<a class="jxr_linenumber" name="L5261" href="#L5261">5261</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L5262" href="#L5262">5262</a> <em class="jxr_comment">// Email regex pattern (same as isEmail but without ^ and $ anchors)</em>
+<a class="jxr_linenumber" name="L5263" href="#L5263">5263</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}"</span>);
+<a class="jxr_linenumber" name="L5264" href="#L5264">5264</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
+<a class="jxr_linenumber" name="L5265" href="#L5265">5265</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
+<a class="jxr_linenumber" name="L5266" href="#L5266">5266</a> result.add(matcher.group());
+<a class="jxr_linenumber" name="L5267" href="#L5267">5267</a> }
+<a class="jxr_linenumber" name="L5268" href="#L5268">5268</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L5269" href="#L5269">5269</a> }
+<a class="jxr_linenumber" name="L5270" href="#L5270">5270</a>
+<a class="jxr_linenumber" name="L5271" href="#L5271">5271</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5272" href="#L5272">5272</a> <em class="jxr_javadoccomment"> * Extracts all URLs from a string.</em>
+<a class="jxr_linenumber" name="L5273" href="#L5273">5273</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5274" href="#L5274">5274</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5275" href="#L5275">5275</a> <em class="jxr_javadoccomment"> * Uses a basic URL regex pattern to find URLs (http, https, ftp).</em>
+<a class="jxr_linenumber" name="L5276" href="#L5276">5276</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5277" href="#L5277">5277</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5278" href="#L5278">5278</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5279" href="#L5279">5279</a> <em class="jxr_javadoccomment"> * extractUrls(<js>"Visit <a href="https://example.com" target="alexandria_uri">https://example.com</a> or <a href="http://test.org" target="alexandria_uri">http://test.org</a>"</js>);</em>
+<a class="jxr_linenumber" name="L5280" href="#L5280">5280</a> <em class="jxr_javadoccomment"> * <jc>// ["<a href="https://example.com" target="alexandria_uri">https://example.com</a>", "<a href="http://test.org" target="alexandria_uri">http://test.org</a>"]</jc></em>
+<a class="jxr_linenumber" name="L5281" href="#L5281">5281</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5282" href="#L5282">5282</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5283" href="#L5283">5283</a> <em class="jxr_javadoccomment"> * @param str The string to extract URLs from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5284" href="#L5284">5284</a> <em class="jxr_javadoccomment"> * @return A list of URLs found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L5285" href="#L5285">5285</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5286" href="#L5286">5286</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractUrls(String str) {
+<a class="jxr_linenumber" name="L5287" href="#L5287">5287</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L5288" href="#L5288">5288</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L5289" href="#L5289">5289</a>
+<a class="jxr_linenumber" name="L5290" href="#L5290">5290</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L5291" href="#L5291">5291</a> <em class="jxr_comment">// Basic URL pattern: protocol://domain/path</em>
+<a class="jxr_linenumber" name="L5292" href="#L5292">5292</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"(?:https?|ftp)://[\\w\\-._~:/?#\\[\\]@!$&'()*+,;=%]+"</span>, Pattern.CASE_INSENSITIVE);
+<a class="jxr_linenumber" name="L5293" href="#L5293">5293</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
+<a class="jxr_linenumber" name="L5294" href="#L5294">5294</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
+<a class="jxr_linenumber" name="L5295" href="#L5295">5295</a> result.add(matcher.group());
+<a class="jxr_linenumber" name="L5296" href="#L5296">5296</a> }
+<a class="jxr_linenumber" name="L5297" href="#L5297">5297</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L5298" href="#L5298">5298</a> }
+<a class="jxr_linenumber" name="L5299" href="#L5299">5299</a>
+<a class="jxr_linenumber" name="L5300" href="#L5300">5300</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5301" href="#L5301">5301</a> <em class="jxr_javadoccomment"> * Extracts all words from a string.</em>
+<a class="jxr_linenumber" name="L5302" href="#L5302">5302</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5303" href="#L5303">5303</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5304" href="#L5304">5304</a> <em class="jxr_javadoccomment"> * A word is defined as a sequence of letters, digits, and underscores.</em>
+<a class="jxr_linenumber" name="L5305" href="#L5305">5305</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5306" href="#L5306">5306</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5307" href="#L5307">5307</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5308" href="#L5308">5308</a> <em class="jxr_javadoccomment"> * extractWords(<js>"Hello world! This is a test."</js>);</em>
+<a class="jxr_linenumber" name="L5309" href="#L5309">5309</a> <em class="jxr_javadoccomment"> * <jc>// ["Hello", "world", "This", "is", "a", "test"]</jc></em>
+<a class="jxr_linenumber" name="L5310" href="#L5310">5310</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5311" href="#L5311">5311</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5312" href="#L5312">5312</a> <em class="jxr_javadoccomment"> * @param str The string to extract words from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5313" href="#L5313">5313</a> <em class="jxr_javadoccomment"> * @return A list of words found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L5314" href="#L5314">5314</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5315" href="#L5315">5315</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractWords(String str) {
+<a class="jxr_linenumber" name="L5316" href="#L5316">5316</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L5317" href="#L5317">5317</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L5318" href="#L5318">5318</a>
+<a class="jxr_linenumber" name="L5319" href="#L5319">5319</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L5320" href="#L5320">5320</a> <em class="jxr_comment">// Word pattern: sequence of word characters (letters, digits, underscore)</em>
+<a class="jxr_linenumber" name="L5321" href="#L5321">5321</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"\\w+"</span>);
+<a class="jxr_linenumber" name="L5322" href="#L5322">5322</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
+<a class="jxr_linenumber" name="L5323" href="#L5323">5323</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
+<a class="jxr_linenumber" name="L5324" href="#L5324">5324</a> result.add(matcher.group());
+<a class="jxr_linenumber" name="L5325" href="#L5325">5325</a> }
+<a class="jxr_linenumber" name="L5326" href="#L5326">5326</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L5327" href="#L5327">5327</a> }
+<a class="jxr_linenumber" name="L5328" href="#L5328">5328</a>
+<a class="jxr_linenumber" name="L5329" href="#L5329">5329</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5330" href="#L5330">5330</a> <em class="jxr_javadoccomment"> * Extracts all text segments between start and end markers.</em>
+<a class="jxr_linenumber" name="L5331" href="#L5331">5331</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5332" href="#L5332">5332</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5333" href="#L5333">5333</a> <em class="jxr_javadoccomment"> * Finds all occurrences of text between the start and end markers (non-overlapping).</em>
+<a class="jxr_linenumber" name="L5334" href="#L5334">5334</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5335" href="#L5335">5335</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5336" href="#L5336">5336</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5337" href="#L5337">5337</a> <em class="jxr_javadoccomment"> * extractBetween(<js>"&lt;tag&gt;content&lt;/tag&gt;"</js>, <js>"&lt;"</js>, <js>"&gt;"</js>);</em>
+<a class="jxr_linenumber" name="L5338" href="#L5338">5338</a> <em class="jxr_javadoccomment"> * <jc>// ["tag", "/tag"]</jc></em>
+<a class="jxr_linenumber" name="L5339" href="#L5339">5339</a> <em class="jxr_javadoccomment"> * extractBetween(<js>"[one][two][three]"</js>, <js>"["</js>, <js>"]"</js>);</em>
+<a class="jxr_linenumber" name="L5340" href="#L5340">5340</a> <em class="jxr_javadoccomment"> * <jc>// ["one", "two", "three"]</jc></em>
+<a class="jxr_linenumber" name="L5341" href="#L5341">5341</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5342" href="#L5342">5342</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5343" href="#L5343">5343</a> <em class="jxr_javadoccomment"> * @param str The string to extract from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5344" href="#L5344">5344</a> <em class="jxr_javadoccomment"> * @param start The start marker. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5345" href="#L5345">5345</a> <em class="jxr_javadoccomment"> * @param end The end marker. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5346" href="#L5346">5346</a> <em class="jxr_javadoccomment"> * @return A list of text segments found between the markers, or an empty list if any parameter is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L5347" href="#L5347">5347</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5348" href="#L5348">5348</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractBetween(String str, String start, String end) {
+<a class="jxr_linenumber" name="L5349" href="#L5349">5349</a> <strong class="jxr_keyword">if</strong> (isEmpty(str) || isEmpty(start) || isEmpty(end))
+<a class="jxr_linenumber" name="L5350" href="#L5350">5350</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L5351" href="#L5351">5351</a>
+<a class="jxr_linenumber" name="L5352" href="#L5352">5352</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L5353" href="#L5353">5353</a> <strong class="jxr_keyword">var</strong> startIndex = 0;
+<a class="jxr_linenumber" name="L5354" href="#L5354">5354</a> <strong class="jxr_keyword">while</strong> (<strong class="jxr_keyword">true</strong>) {
+<a class="jxr_linenumber" name="L5355" href="#L5355">5355</a> <strong class="jxr_keyword">var</strong> startPos = str.indexOf(start, startIndex);
+<a class="jxr_linenumber" name="L5356" href="#L5356">5356</a> <strong class="jxr_keyword">if</strong> (startPos == -1)
+<a class="jxr_linenumber" name="L5357" href="#L5357">5357</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5358" href="#L5358">5358</a> <strong class="jxr_keyword">var</strong> endPos = str.indexOf(end, startPos + start.length());
+<a class="jxr_linenumber" name="L5359" href="#L5359">5359</a> <strong class="jxr_keyword">if</strong> (endPos == -1)
+<a class="jxr_linenumber" name="L5360" href="#L5360">5360</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5361" href="#L5361">5361</a> result.add(str.substring(startPos + start.length(), endPos));
+<a class="jxr_linenumber" name="L5362" href="#L5362">5362</a> startIndex = endPos + end.length();
+<a class="jxr_linenumber" name="L5363" href="#L5363">5363</a> }
+<a class="jxr_linenumber" name="L5364" href="#L5364">5364</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L5365" href="#L5365">5365</a> }
+<a class="jxr_linenumber" name="L5366" href="#L5366">5366</a>
+<a class="jxr_linenumber" name="L5367" href="#L5367">5367</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5368" href="#L5368">5368</a> <em class="jxr_javadoccomment"> * Transliterates characters in a string by mapping characters from one set to another.</em>
+<a class="jxr_linenumber" name="L5369" href="#L5369">5369</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5370" href="#L5370">5370</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5371" href="#L5371">5371</a> <em class="jxr_javadoccomment"> * Performs character-by-character translation. If a character is found in <c>fromChars</c>,</em>
+<a class="jxr_linenumber" name="L5372" href="#L5372">5372</a> <em class="jxr_javadoccomment"> * it is replaced with the corresponding character at the same position in <c>toChars</c>.</em>
+<a class="jxr_linenumber" name="L5373" href="#L5373">5373</a> <em class="jxr_javadoccomment"> * Characters not found in <c>fromChars</c> are left unchanged.</em>
+<a class="jxr_linenumber" name="L5374" href="#L5374">5374</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5375" href="#L5375">5375</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5376" href="#L5376">5376</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5377" href="#L5377">5377</a> <em class="jxr_javadoccomment"> * transliterate(<js>"hello"</js>, <js>"aeiou"</js>, <js>"12345"</js>);</em>
+<a class="jxr_linenumber" name="L5378" href="#L5378">5378</a> <em class="jxr_javadoccomment"> * <jc>// "h2ll4"</jc></em>
+<a class="jxr_linenumber" name="L5379" href="#L5379">5379</a> <em class="jxr_javadoccomment"> * transliterate(<js>"ABC"</js>, <js>"ABC"</js>, <js>"XYZ"</js>);</em>
+<a class="jxr_linenumber" name="L5380" href="#L5380">5380</a> <em class="jxr_javadoccomment"> * <jc>// "XYZ"</jc></em>
+<a class="jxr_linenumber" name="L5381" href="#L5381">5381</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5382" href="#L5382">5382</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5383" href="#L5383">5383</a> <em class="jxr_javadoccomment"> * @param str The string to transliterate. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5384" href="#L5384">5384</a> <em class="jxr_javadoccomment"> * @param fromChars The source character set. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5385" href="#L5385">5385</a> <em class="jxr_javadoccomment"> * @param toChars The target character set. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5386" href="#L5386">5386</a> <em class="jxr_javadoccomment"> * @return The transliterated string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5387" href="#L5387">5387</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If <c>fromChars</c> and <c>toChars</c> have different lengths.</em>
+<a class="jxr_linenumber" name="L5388" href="#L5388">5388</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5389" href="#L5389">5389</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String transliterate(String str, String fromChars, String toChars) {
+<a class="jxr_linenumber" name="L5390" href="#L5390">5390</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5391" href="#L5391">5391</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5392" href="#L5392">5392</a> <strong class="jxr_keyword">if</strong> (fromChars == <strong class="jxr_keyword">null</strong> || toChars == <strong class="jxr_keyword">null</strong> || fromChars.isEmpty() || toChars.isEmpty())
+<a class="jxr_linenumber" name="L5393" href="#L5393">5393</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L5394" href="#L5394">5394</a> <strong class="jxr_keyword">if</strong> (fromChars.length() != toChars.length())
+<a class="jxr_linenumber" name="L5395" href="#L5395">5395</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> IllegalArgumentException(<span class="jxr_string">"fromChars and toChars must have the same length"</span>);
+<a class="jxr_linenumber" name="L5396" href="#L5396">5396</a>
+<a class="jxr_linenumber" name="L5397" href="#L5397">5397</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(str.length());
+<a class="jxr_linenumber" name="L5398" href="#L5398">5398</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L5399" href="#L5399">5399</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
+<a class="jxr_linenumber" name="L5400" href="#L5400">5400</a> <strong class="jxr_keyword">var</strong> index = fromChars.indexOf(c);
+<a class="jxr_linenumber" name="L5401" href="#L5401">5401</a> <strong class="jxr_keyword">if</strong> (index >= 0)
+<a class="jxr_linenumber" name="L5402" href="#L5402">5402</a> sb.append(toChars.charAt(index));
+<a class="jxr_linenumber" name="L5403" href="#L5403">5403</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L5404" href="#L5404">5404</a> sb.append(c);
+<a class="jxr_linenumber" name="L5405" href="#L5405">5405</a> }
+<a class="jxr_linenumber" name="L5406" href="#L5406">5406</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L5407" href="#L5407">5407</a> }
+<a class="jxr_linenumber" name="L5408" href="#L5408">5408</a>
+<a class="jxr_linenumber" name="L5409" href="#L5409">5409</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5410" href="#L5410">5410</a> <em class="jxr_javadoccomment"> * Generates a Soundex code for a string.</em>
<a class="jxr_linenumber" name="L5411" href="#L5411">5411</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5412" href="#L5412">5412</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5413" href="#L5413">5413</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5414" href="#L5414">5414</a> <em class="jxr_javadoccomment"> * soundex(<js>"Smith"</js>); <jc>// "S530"</jc></em>
-<a class="jxr_linenumber" name="L5415" href="#L5415">5415</a> <em class="jxr_javadoccomment"> * soundex(<js>"Smythe"</js>); <jc>// "S530"</jc></em>
-<a class="jxr_linenumber" name="L5416" href="#L5416">5416</a> <em class="jxr_javadoccomment"> * soundex(<js>"Robert"</js>); <jc>// "R163"</jc></em>
-<a class="jxr_linenumber" name="L5417" href="#L5417">5417</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5418" href="#L5418">5418</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5419" href="#L5419">5419</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Soundex code for. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5420" href="#L5420">5420</a> <em class="jxr_javadoccomment"> * @return The Soundex code (1 letter + 3 digits), or <jk>null</jk> if input is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5421" href="#L5421">5421</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5422" href="#L5422">5422</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String soundex(String str) {
-<a class="jxr_linenumber" name="L5423" href="#L5423">5423</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5424" href="#L5424">5424</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5425" href="#L5425">5425</a>
-<a class="jxr_linenumber" name="L5426" href="#L5426">5426</a> <strong class="jxr_keyword">var</strong> upper = str.toUpperCase();
-<a class="jxr_linenumber" name="L5427" href="#L5427">5427</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder(4);
-<a class="jxr_linenumber" name="L5428" href="#L5428">5428</a> result.append(upper.charAt(0));
-<a class="jxr_linenumber" name="L5429" href="#L5429">5429</a>
-<a class="jxr_linenumber" name="L5430" href="#L5430">5430</a> <em class="jxr_comment">// Soundex mapping: 0 = AEIOUHWY, 1 = BFPV, 2 = CGJKQSXZ, 3 = DT, 4 = L, 5 = MN, 6 = R</em>
-<a class="jxr_linenumber" name="L5431" href="#L5431">5431</a> <em class="jxr_comment">// H/W/Y don't get codes but don't break sequences either</em>
-<a class="jxr_linenumber" name="L5432" href="#L5432">5432</a> <em class="jxr_comment">// Initialize lastCode to a value that won't match any real code</em>
-<a class="jxr_linenumber" name="L5433" href="#L5433">5433</a> <strong class="jxr_keyword">var</strong> lastCode = '\0';
-<a class="jxr_linenumber" name="L5434" href="#L5434">5434</a>
-<a class="jxr_linenumber" name="L5435" href="#L5435">5435</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 1; i < upper.length() && result.length() < 4; i++) {
-<a class="jxr_linenumber" name="L5436" href="#L5436">5436</a> <strong class="jxr_keyword">var</strong> c = upper.charAt(i);
-<a class="jxr_linenumber" name="L5437" href="#L5437">5437</a> <strong class="jxr_keyword">var</strong> code = getSoundexCode(c);
-<a class="jxr_linenumber" name="L5438" href="#L5438">5438</a> <strong class="jxr_keyword">if</strong> (code == '0') {
-<a class="jxr_linenumber" name="L5439" href="#L5439">5439</a> <em class="jxr_comment">// H/W/Y/vowels - don't add code, but don't update lastCode either</em>
-<a class="jxr_linenumber" name="L5440" href="#L5440">5440</a> <em class="jxr_comment">// This allows sequences to continue across H/W/Y/vowels</em>
-<a class="jxr_linenumber" name="L5441" href="#L5441">5441</a> <strong class="jxr_keyword">continue</strong>;
-<a class="jxr_linenumber" name="L5442" href="#L5442">5442</a> }
-<a class="jxr_linenumber" name="L5443" href="#L5443">5443</a> <strong class="jxr_keyword">if</strong> (code != lastCode) {
-<a class="jxr_linenumber" name="L5444" href="#L5444">5444</a> result.append(code);
-<a class="jxr_linenumber" name="L5445" href="#L5445">5445</a> lastCode = code;
+<a class="jxr_linenumber" name="L5412" href="#L5412">5412</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5413" href="#L5413">5413</a> <em class="jxr_javadoccomment"> * Soundex is a phonetic algorithm for indexing names by sound. The code consists of</em>
+<a class="jxr_linenumber" name="L5414" href="#L5414">5414</a> <em class="jxr_javadoccomment"> * a letter followed by three digits. Similar-sounding names produce the same code.</em>
+<a class="jxr_linenumber" name="L5415" href="#L5415">5415</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5416" href="#L5416">5416</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5417" href="#L5417">5417</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5418" href="#L5418">5418</a> <em class="jxr_javadoccomment"> * soundex(<js>"Smith"</js>); <jc>// "S530"</jc></em>
+<a class="jxr_linenumber" name="L5419" href="#L5419">5419</a> <em class="jxr_javadoccomment"> * soundex(<js>"Smythe"</js>); <jc>// "S530"</jc></em>
+<a class="jxr_linenumber" name="L5420" href="#L5420">5420</a> <em class="jxr_javadoccomment"> * soundex(<js>"Robert"</js>); <jc>// "R163"</jc></em>
+<a class="jxr_linenumber" name="L5421" href="#L5421">5421</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5422" href="#L5422">5422</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5423" href="#L5423">5423</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Soundex code for. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5424" href="#L5424">5424</a> <em class="jxr_javadoccomment"> * @return The Soundex code (1 letter + 3 digits), or <jk>null</jk> if input is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L5425" href="#L5425">5425</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5426" href="#L5426">5426</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String soundex(String str) {
+<a class="jxr_linenumber" name="L5427" href="#L5427">5427</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L5428" href="#L5428">5428</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5429" href="#L5429">5429</a>
+<a class="jxr_linenumber" name="L5430" href="#L5430">5430</a> <strong class="jxr_keyword">var</strong> upper = str.toUpperCase();
+<a class="jxr_linenumber" name="L5431" href="#L5431">5431</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder(4);
+<a class="jxr_linenumber" name="L5432" href="#L5432">5432</a> result.append(upper.charAt(0));
+<a class="jxr_linenumber" name="L5433" href="#L5433">5433</a>
+<a class="jxr_linenumber" name="L5434" href="#L5434">5434</a> <em class="jxr_comment">// Soundex mapping: 0 = AEIOUHWY, 1 = BFPV, 2 = CGJKQSXZ, 3 = DT, 4 = L, 5 = MN, 6 = R</em>
+<a class="jxr_linenumber" name="L5435" href="#L5435">5435</a> <em class="jxr_comment">// H/W/Y don't get codes but don't break sequences either</em>
+<a class="jxr_linenumber" name="L5436" href="#L5436">5436</a> <em class="jxr_comment">// Initialize lastCode to a value that won't match any real code</em>
+<a class="jxr_linenumber" name="L5437" href="#L5437">5437</a> <strong class="jxr_keyword">var</strong> lastCode = '\0';
+<a class="jxr_linenumber" name="L5438" href="#L5438">5438</a>
+<a class="jxr_linenumber" name="L5439" href="#L5439">5439</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 1; i < upper.length() && result.length() < 4; i++) {
+<a class="jxr_linenumber" name="L5440" href="#L5440">5440</a> <strong class="jxr_keyword">var</strong> c = upper.charAt(i);
+<a class="jxr_linenumber" name="L5441" href="#L5441">5441</a> <strong class="jxr_keyword">var</strong> code = getSoundexCode(c);
+<a class="jxr_linenumber" name="L5442" href="#L5442">5442</a> <strong class="jxr_keyword">if</strong> (code == '0') {
+<a class="jxr_linenumber" name="L5443" href="#L5443">5443</a> <em class="jxr_comment">// H/W/Y/vowels - don't add code, but don't update lastCode either</em>
+<a class="jxr_linenumber" name="L5444" href="#L5444">5444</a> <em class="jxr_comment">// This allows sequences to continue across H/W/Y/vowels</em>
+<a class="jxr_linenumber" name="L5445" href="#L5445">5445</a> <strong class="jxr_keyword">continue</strong>;
<a class="jxr_linenumber" name="L5446" href="#L5446">5446</a> }
-<a class="jxr_linenumber" name="L5447" href="#L5447">5447</a> <em class="jxr_comment">// If code == lastCode, skip it (consecutive same codes)</em>
-<a class="jxr_linenumber" name="L5448" href="#L5448">5448</a> }
-<a class="jxr_linenumber" name="L5449" href="#L5449">5449</a>
-<a class="jxr_linenumber" name="L5450" href="#L5450">5450</a> <em class="jxr_comment">// Pad with zeros if needed</em>
-<a class="jxr_linenumber" name="L5451" href="#L5451">5451</a> <strong class="jxr_keyword">while</strong> (result.length() < 4) {
-<a class="jxr_linenumber" name="L5452" href="#L5452">5452</a> result.append('0');
-<a class="jxr_linenumber" name="L5453" href="#L5453">5453</a> }
-<a class="jxr_linenumber" name="L5454" href="#L5454">5454</a>
-<a class="jxr_linenumber" name="L5455" href="#L5455">5455</a> <strong class="jxr_keyword">return</strong> result.toString();
-<a class="jxr_linenumber" name="L5456" href="#L5456">5456</a> }
-<a class="jxr_linenumber" name="L5457" href="#L5457">5457</a>
-<a class="jxr_linenumber" name="L5458" href="#L5458">5458</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5459" href="#L5459">5459</a> <em class="jxr_javadoccomment"> * Helper method to get Soundex code for a character.</em>
-<a class="jxr_linenumber" name="L5460" href="#L5460">5460</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5461" href="#L5461">5461</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> getSoundexCode(<strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L5462" href="#L5462">5462</a> <strong class="jxr_keyword">if</strong> (c == 'A' || c == 'E' || c == 'I' || c == 'O' || c == 'U' || c == 'H' || c == 'W' || c == 'Y')
-<a class="jxr_linenumber" name="L5463" href="#L5463">5463</a> <strong class="jxr_keyword">return</strong> '0';
-<a class="jxr_linenumber" name="L5464" href="#L5464">5464</a> <strong class="jxr_keyword">if</strong> (c == 'B' || c == 'F' || c == 'P' || c == 'V')
-<a class="jxr_linenumber" name="L5465" href="#L5465">5465</a> <strong class="jxr_keyword">return</strong> '1';
-<a class="jxr_linenumber" name="L5466" href="#L5466">5466</a> <strong class="jxr_keyword">if</strong> (c == 'C' || c == 'G' || c == 'J' || c == 'K' || c == 'Q' || c == 'S' || c == 'X' || c == 'Z')
-<a class="jxr_linenumber" name="L5467" href="#L5467">5467</a> <strong class="jxr_keyword">return</strong> '2';
-<a class="jxr_linenumber" name="L5468" href="#L5468">5468</a> <strong class="jxr_keyword">if</strong> (c == 'D' || c == 'T')
-<a class="jxr_linenumber" name="L5469" href="#L5469">5469</a> <strong class="jxr_keyword">return</strong> '3';
-<a class="jxr_linenumber" name="L5470" href="#L5470">5470</a> <strong class="jxr_keyword">if</strong> (c == 'L')
-<a class="jxr_linenumber" name="L5471" href="#L5471">5471</a> <strong class="jxr_keyword">return</strong> '4';
-<a class="jxr_linenumber" name="L5472" href="#L5472">5472</a> <strong class="jxr_keyword">if</strong> (c == 'M' || c == 'N')
-<a class="jxr_linenumber" name="L5473" href="#L5473">5473</a> <strong class="jxr_keyword">return</strong> '5';
-<a class="jxr_linenumber" name="L5474" href="#L5474">5474</a> <strong class="jxr_keyword">if</strong> (c == 'R')
-<a class="jxr_linenumber" name="L5475" href="#L5475">5475</a> <strong class="jxr_keyword">return</strong> '6';
-<a class="jxr_linenumber" name="L5476" href="#L5476">5476</a> <strong class="jxr_keyword">return</strong> '0'; <em class="jxr_comment">// Non-letter characters</em>
-<a class="jxr_linenumber" name="L5477" href="#L5477">5477</a> }
-<a class="jxr_linenumber" name="L5478" href="#L5478">5478</a>
-<a class="jxr_linenumber" name="L5479" href="#L5479">5479</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5480" href="#L5480">5480</a> <em class="jxr_javadoccomment"> * Generates a Metaphone code for a string.</em>
-<a class="jxr_linenumber" name="L5481" href="#L5481">5481</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5482" href="#L5482">5482</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5483" href="#L5483">5483</a> <em class="jxr_javadoccomment"> * Metaphone is a phonetic algorithm that produces codes representing how words sound.</em>
-<a class="jxr_linenumber" name="L5484" href="#L5484">5484</a> <em class="jxr_javadoccomment"> * It's more accurate than Soundex for English words.</em>
+<a class="jxr_linenumber" name="L5447" href="#L5447">5447</a> <strong class="jxr_keyword">if</strong> (code != lastCode) {
+<a class="jxr_linenumber" name="L5448" href="#L5448">5448</a> result.append(code);
+<a class="jxr_linenumber" name="L5449" href="#L5449">5449</a> lastCode = code;
+<a class="jxr_linenumber" name="L5450" href="#L5450">5450</a> }
+<a class="jxr_linenumber" name="L5451" href="#L5451">5451</a> <em class="jxr_comment">// If code == lastCode, skip it (consecutive same codes)</em>
+<a class="jxr_linenumber" name="L5452" href="#L5452">5452</a> }
+<a class="jxr_linenumber" name="L5453" href="#L5453">5453</a>
+<a class="jxr_linenumber" name="L5454" href="#L5454">5454</a> <em class="jxr_comment">// Pad with zeros if needed</em>
+<a class="jxr_linenumber" name="L5455" href="#L5455">5455</a> <strong class="jxr_keyword">while</strong> (result.length() < 4) {
+<a class="jxr_linenumber" name="L5456" href="#L5456">5456</a> result.append('0');
+<a class="jxr_linenumber" name="L5457" href="#L5457">5457</a> }
+<a class="jxr_linenumber" name="L5458" href="#L5458">5458</a>
+<a class="jxr_linenumber" name="L5459" href="#L5459">5459</a> <strong class="jxr_keyword">return</strong> result.toString();
+<a class="jxr_linenumber" name="L5460" href="#L5460">5460</a> }
+<a class="jxr_linenumber" name="L5461" href="#L5461">5461</a>
+<a class="jxr_linenumber" name="L5462" href="#L5462">5462</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5463" href="#L5463">5463</a> <em class="jxr_javadoccomment"> * Helper method to get Soundex code for a character.</em>
+<a class="jxr_linenumber" name="L5464" href="#L5464">5464</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5465" href="#L5465">5465</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> getSoundexCode(<strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L5466" href="#L5466">5466</a> <strong class="jxr_keyword">if</strong> (c == 'A' || c == 'E' || c == 'I' || c == 'O' || c == 'U' || c == 'H' || c == 'W' || c == 'Y')
+<a class="jxr_linenumber" name="L5467" href="#L5467">5467</a> <strong class="jxr_keyword">return</strong> '0';
+<a class="jxr_linenumber" name="L5468" href="#L5468">5468</a> <strong class="jxr_keyword">if</strong> (c == 'B' || c == 'F' || c == 'P' || c == 'V')
+<a class="jxr_linenumber" name="L5469" href="#L5469">5469</a> <strong class="jxr_keyword">return</strong> '1';
+<a class="jxr_linenumber" name="L5470" href="#L5470">5470</a> <strong class="jxr_keyword">if</strong> (c == 'C' || c == 'G' || c == 'J' || c == 'K' || c == 'Q' || c == 'S' || c == 'X' || c == 'Z')
+<a class="jxr_linenumber" name="L5471" href="#L5471">5471</a> <strong class="jxr_keyword">return</strong> '2';
+<a class="jxr_linenumber" name="L5472" href="#L5472">5472</a> <strong class="jxr_keyword">if</strong> (c == 'D' || c == 'T')
+<a class="jxr_linenumber" name="L5473" href="#L5473">5473</a> <strong class="jxr_keyword">return</strong> '3';
+<a class="jxr_linenumber" name="L5474" href="#L5474">5474</a> <strong class="jxr_keyword">if</strong> (c == 'L')
+<a class="jxr_linenumber" name="L5475" href="#L5475">5475</a> <strong class="jxr_keyword">return</strong> '4';
+<a class="jxr_linenumber" name="L5476" href="#L5476">5476</a> <strong class="jxr_keyword">if</strong> (c == 'M' || c == 'N')
+<a class="jxr_linenumber" name="L5477" href="#L5477">5477</a> <strong class="jxr_keyword">return</strong> '5';
+<a class="jxr_linenumber" name="L5478" href="#L5478">5478</a> <strong class="jxr_keyword">if</strong> (c == 'R')
+<a class="jxr_linenumber" name="L5479" href="#L5479">5479</a> <strong class="jxr_keyword">return</strong> '6';
+<a class="jxr_linenumber" name="L5480" href="#L5480">5480</a> <strong class="jxr_keyword">return</strong> '0'; <em class="jxr_comment">// Non-letter characters</em>
+<a class="jxr_linenumber" name="L5481" href="#L5481">5481</a> }
+<a class="jxr_linenumber" name="L5482" href="#L5482">5482</a>
+<a class="jxr_linenumber" name="L5483" href="#L5483">5483</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5484" href="#L5484">5484</a> <em class="jxr_javadoccomment"> * Generates a Metaphone code for a string.</em>
<a class="jxr_linenumber" name="L5485" href="#L5485">5485</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5486" href="#L5486">5486</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5487" href="#L5487">5487</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5488" href="#L5488">5488</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Smith"</js>); <jc>// "SM0"</jc></em>
-<a class="jxr_linenumber" name="L5489" href="#L5489">5489</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Smythe"</js>); <jc>// "SM0"</jc></em>
-<a class="jxr_linenumber" name="L5490" href="#L5490">5490</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Robert"</js>); <jc>// "RBRT"</jc></em>
-<a class="jxr_linenumber" name="L5491" href="#L5491">5491</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5492" href="#L5492">5492</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5493" href="#L5493">5493</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Metaphone code for. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5494" href="#L5494">5494</a> <em class="jxr_javadoccomment"> * @return The Metaphone code, or <jk>null</jk> if input is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5495" href="#L5495">5495</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5496" href="#L5496">5496</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String metaphone(String str) {
-<a class="jxr_linenumber" name="L5497" href="#L5497">5497</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5498" href="#L5498">5498</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5499" href="#L5499">5499</a>
-<a class="jxr_linenumber" name="L5500" href="#L5500">5500</a> <strong class="jxr_keyword">var</strong> upper = str.toUpperCase().replaceAll(<span class="jxr_string">"[^A-Z]"</span>, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L5501" href="#L5501">5501</a> <strong class="jxr_keyword">if</strong> (upper.isEmpty())
-<a class="jxr_linenumber" name="L5502" href="#L5502">5502</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L5503" href="#L5503">5503</a>
-<a class="jxr_linenumber" name="L5504" href="#L5504">5504</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L5505" href="#L5505">5505</a> <strong class="jxr_keyword">var</strong> i = 0;
-<a class="jxr_linenumber" name="L5506" href="#L5506">5506</a> <strong class="jxr_keyword">var</strong> len = upper.length();
-<a class="jxr_linenumber" name="L5507" href="#L5507">5507</a>
-<a class="jxr_linenumber" name="L5508" href="#L5508">5508</a> <em class="jxr_comment">// Handle initial characters</em>
-<a class="jxr_linenumber" name="L5509" href="#L5509">5509</a> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"KN"</span>) || upper.startsWith(<span class="jxr_string">"GN"</span>) || upper.startsWith(<span class="jxr_string">"PN"</span>) || upper.startsWith(<span class="jxr_string">"AE"</span>) || upper.startsWith(<span class="jxr_string">"WR"</span>)) {
-<a class="jxr_linenumber" name="L5510" href="#L5510">5510</a> i = 1;
-<a class="jxr_linenumber" name="L5511" href="#L5511">5511</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"X"</span>)) {
-<a class="jxr_linenumber" name="L5512" href="#L5512">5512</a> result.append('S');
-<a class="jxr_linenumber" name="L5513" href="#L5513">5513</a> i = 1;
-<a class="jxr_linenumber" name="L5514" href="#L5514">5514</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"WH"</span>)) {
-<a class="jxr_linenumber" name="L5515" href="#L5515">5515</a> result.append('W');
-<a class="jxr_linenumber" name="L5516" href="#L5516">5516</a> i = 2;
-<a class="jxr_linenumber" name="L5517" href="#L5517">5517</a> }
-<a class="jxr_linenumber" name="L5518" href="#L5518">5518</a>
-<a class="jxr_linenumber" name="L5519" href="#L5519">5519</a> <em class="jxr_comment">// Process remaining characters</em>
-<a class="jxr_linenumber" name="L5520" href="#L5520">5520</a> <strong class="jxr_keyword">while</strong> (i < len && result.length() < 4) {
-<a class="jxr_linenumber" name="L5521" href="#L5521">5521</a> <strong class="jxr_keyword">var</strong> c = upper.charAt(i);
-<a class="jxr_linenumber" name="L5522" href="#L5522">5522</a> <strong class="jxr_keyword">var</strong> prev = i > 0 ? upper.charAt(i - 1) : '\0';
-<a class="jxr_linenumber" name="L5523" href="#L5523">5523</a> <strong class="jxr_keyword">var</strong> next = i < len - 1 ? upper.charAt(i + 1) : '\0';
-<a class="jxr_linenumber" name="L5524" href="#L5524">5524</a> <strong class="jxr_keyword">var</strong> next2 = i < len - 2 ? upper.charAt(i + 2) : '\0';
-<a class="jxr_linenumber" name="L5525" href="#L5525">5525</a>
-<a class="jxr_linenumber" name="L5526" href="#L5526">5526</a> <em class="jxr_comment">// Skip duplicates (except C)</em>
-<a class="jxr_linenumber" name="L5527" href="#L5527">5527</a> <strong class="jxr_keyword">if</strong> (c == prev && c != 'C') {
-<a class="jxr_linenumber" name="L5528" href="#L5528">5528</a> i++;
-<a class="jxr_linenumber" name="L5529" href="#L5529">5529</a> <strong class="jxr_keyword">continue</strong>;
-<a class="jxr_linenumber" name="L5530" href="#L5530">5530</a> }
-<a class="jxr_linenumber" name="L5531" href="#L5531">5531</a>
-<a class="jxr_linenumber" name="L5532" href="#L5532">5532</a> <strong class="jxr_keyword">switch</strong> (c) {
-<a class="jxr_linenumber" name="L5533" href="#L5533">5533</a> <strong class="jxr_keyword">case</strong> 'B':
-<a class="jxr_linenumber" name="L5534" href="#L5534">5534</a> <strong class="jxr_keyword">if</strong> (prev != 'M' || next != '\0')
-<a class="jxr_linenumber" name="L5535" href="#L5535">5535</a> result.append('B');
-<a class="jxr_linenumber" name="L5536" href="#L5536">5536</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5537" href="#L5537">5537</a> <strong class="jxr_keyword">case</strong> 'C':
-<a class="jxr_linenumber" name="L5538" href="#L5538">5538</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
-<a class="jxr_linenumber" name="L5539" href="#L5539">5539</a> <strong class="jxr_keyword">if</strong> (prev == 'S')
-<a class="jxr_linenumber" name="L5540" href="#L5540">5540</a> result.append('K');
-<a class="jxr_linenumber" name="L5541" href="#L5541">5541</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L5542" href="#L5542">5542</a> result.append('X');
-<a class="jxr_linenumber" name="L5543" href="#L5543">5543</a> i++;
-<a class="jxr_linenumber" name="L5544" href="#L5544">5544</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' || next == 'E' || next == 'Y') {
-<a class="jxr_linenumber" name="L5545" href="#L5545">5545</a> result.append('S');
-<a class="jxr_linenumber" name="L5546" href="#L5546">5546</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L5547" href="#L5547">5547</a> result.append('K');
-<a class="jxr_linenumber" name="L5548" href="#L5548">5548</a> }
-<a class="jxr_linenumber" name="L5549" href="#L5549">5549</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5550" href="#L5550">5550</a> <strong class="jxr_keyword">case</strong> 'D':
-<a class="jxr_linenumber" name="L5551" href="#L5551">5551</a> <strong class="jxr_keyword">if</strong> (next == 'G' && (next2 == 'E' || next2 == 'I' || next2 == 'Y')) {
-<a class="jxr_linenumber" name="L5552" href="#L5552">5552</a> result.append('J');
-<a class="jxr_linenumber" name="L5553" href="#L5553">5553</a> i++;
-<a class="jxr_linenumber" name="L5554" href="#L5554">5554</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L5555" href="#L5555">5555</a> result.append('T');
-<a class="jxr_linenumber" name="L5556" href="#L5556">5556</a> }
-<a class="jxr_linenumber" name="L5557" href="#L5557">5557</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5558" href="#L5558">5558</a> <strong class="jxr_keyword">case</strong> 'F':
-<a class="jxr_linenumber" name="L5559" href="#L5559">5559</a> <strong class="jxr_keyword">case</strong> 'J':
-<a class="jxr_linenumber" name="L5560" href="#L5560">5560</a> <strong class="jxr_keyword">case</strong> 'L':
-<a class="jxr_linenumber" name="L5561" href="#L5561">5561</a> <strong class="jxr_keyword">case</strong> 'M':
-<a class="jxr_linenumber" name="L5562" href="#L5562">5562</a> <strong class="jxr_keyword">case</strong> 'N':
-<a class="jxr_linenumber" name="L5563" href="#L5563">5563</a> <strong class="jxr_keyword">case</strong> 'R':
-<a class="jxr_linenumber" name="L5564" href="#L5564">5564</a> result.append(c);
-<a class="jxr_linenumber" name="L5565" href="#L5565">5565</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5566" href="#L5566">5566</a> <strong class="jxr_keyword">case</strong> 'G':
-<a class="jxr_linenumber" name="L5567" href="#L5567">5567</a> <strong class="jxr_keyword">if</strong> (next == 'H' && (next2 == 'A' || next2 == 'E' || next2 == 'I' || next2 == 'O' || next2 == 'U')) {
-<a class="jxr_linenumber" name="L5568" href="#L5568">5568</a> <em class="jxr_comment">// Silent GH</em>
-<a class="jxr_linenumber" name="L5569" href="#L5569">5569</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'N' && (next2 == 'E' || next2 == 'D')) {
-<a class="jxr_linenumber" name="L5570" href="#L5570">5570</a> <em class="jxr_comment">// Silent GN</em>
-<a class="jxr_linenumber" name="L5571" href="#L5571">5571</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> ((next == 'E' || next == 'I' || next == 'Y') && prev != 'G') {
-<a class="jxr_linenumber" name="L5572" href="#L5572">5572</a> result.append('J');
-<a class="jxr_linenumber" name="L5573" href="#L5573">5573</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L5574" href="#L5574">5574</a> result.append('K');
-<a class="jxr_linenumber" name="L5575" href="#L5575">5575</a> }
-<a class="jxr_linenumber" name="L5576" href="#L5576">5576</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5577" href="#L5577">5577</a> <strong class="jxr_keyword">case</strong> 'H':
-<a class="jxr_linenumber" name="L5578" href="#L5578">5578</a> <strong class="jxr_keyword">if</strong> (! isVowel(prev) || ! isVowel(next))
-<a class="jxr_linenumber" name="L5579" href="#L5579">5579</a> result.append('H');
+<a class="jxr_linenumber" name="L5486" href="#L5486">5486</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5487" href="#L5487">5487</a> <em class="jxr_javadoccomment"> * Metaphone is a phonetic algorithm that produces codes representing how words sound.</em>
+<a class="jxr_linenumber" name="L5488" href="#L5488">5488</a> <em class="jxr_javadoccomment"> * It's more accurate than Soundex for English words.</em>
+<a class="jxr_linenumber" name="L5489" href="#L5489">5489</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5490" href="#L5490">5490</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5491" href="#L5491">5491</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5492" href="#L5492">5492</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Smith"</js>); <jc>// "SM0"</jc></em>
+<a class="jxr_linenumber" name="L5493" href="#L5493">5493</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Smythe"</js>); <jc>// "SM0"</jc></em>
+<a class="jxr_linenumber" name="L5494" href="#L5494">5494</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Robert"</js>); <jc>// "RBRT"</jc></em>
+<a class="jxr_linenumber" name="L5495" href="#L5495">5495</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5496" href="#L5496">5496</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5497" href="#L5497">5497</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Metaphone code for. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5498" href="#L5498">5498</a> <em class="jxr_javadoccomment"> * @return The Metaphone code, or <jk>null</jk> if input is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L5499" href="#L5499">5499</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5500" href="#L5500">5500</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String metaphone(String str) {
+<a class="jxr_linenumber" name="L5501" href="#L5501">5501</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L5502" href="#L5502">5502</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5503" href="#L5503">5503</a>
+<a class="jxr_linenumber" name="L5504" href="#L5504">5504</a> <strong class="jxr_keyword">var</strong> upper = str.toUpperCase().replaceAll(<span class="jxr_string">"[^A-Z]"</span>, <span class="jxr_string">""</span>);
+<a class="jxr_linenumber" name="L5505" href="#L5505">5505</a> <strong class="jxr_keyword">if</strong> (upper.isEmpty())
+<a class="jxr_linenumber" name="L5506" href="#L5506">5506</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L5507" href="#L5507">5507</a>
+<a class="jxr_linenumber" name="L5508" href="#L5508">5508</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L5509" href="#L5509">5509</a> <strong class="jxr_keyword">var</strong> i = 0;
+<a class="jxr_linenumber" name="L5510" href="#L5510">5510</a> <strong class="jxr_keyword">var</strong> len = upper.length();
+<a class="jxr_linenumber" name="L5511" href="#L5511">5511</a>
+<a class="jxr_linenumber" name="L5512" href="#L5512">5512</a> <em class="jxr_comment">// Handle initial characters</em>
+<a class="jxr_linenumber" name="L5513" href="#L5513">5513</a> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"KN"</span>) || upper.startsWith(<span class="jxr_string">"GN"</span>) || upper.startsWith(<span class="jxr_string">"PN"</span>) || upper.startsWith(<span class="jxr_string">"AE"</span>) || upper.startsWith(<span class="jxr_string">"WR"</span>)) {
+<a class="jxr_linenumber" name="L5514" href="#L5514">5514</a> i = 1;
+<a class="jxr_linenumber" name="L5515" href="#L5515">5515</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"X"</span>)) {
+<a class="jxr_linenumber" name="L5516" href="#L5516">5516</a> result.append('S');
+<a class="jxr_linenumber" name="L5517" href="#L5517">5517</a> i = 1;
+<a class="jxr_linenumber" name="L5518" href="#L5518">5518</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"WH"</span>)) {
+<a class="jxr_linenumber" name="L5519" href="#L5519">5519</a> result.append('W');
+<a class="jxr_linenumber" name="L5520" href="#L5520">5520</a> i = 2;
+<a class="jxr_linenumber" name="L5521" href="#L5521">5521</a> }
+<a class="jxr_linenumber" name="L5522" href="#L5522">5522</a>
+<a class="jxr_linenumber" name="L5523" href="#L5523">5523</a> <em class="jxr_comment">// Process remaining characters</em>
+<a class="jxr_linenumber" name="L5524" href="#L5524">5524</a> <strong class="jxr_keyword">while</strong> (i < len && result.length() < 4) {
+<a class="jxr_linenumber" name="L5525" href="#L5525">5525</a> <strong class="jxr_keyword">var</strong> c = upper.charAt(i);
+<a class="jxr_linenumber" name="L5526" href="#L5526">5526</a> <strong class="jxr_keyword">var</strong> prev = i > 0 ? upper.charAt(i - 1) : '\0';
+<a class="jxr_linenumber" name="L5527" href="#L5527">5527</a> <strong class="jxr_keyword">var</strong> next = i < len - 1 ? upper.charAt(i + 1) : '\0';
+<a class="jxr_linenumber" name="L5528" href="#L5528">5528</a> <strong class="jxr_keyword">var</strong> next2 = i < len - 2 ? upper.charAt(i + 2) : '\0';
+<a class="jxr_linenumber" name="L5529" href="#L5529">5529</a>
+<a class="jxr_linenumber" name="L5530" href="#L5530">5530</a> <em class="jxr_comment">// Skip duplicates (except C)</em>
+<a class="jxr_linenumber" name="L5531" href="#L5531">5531</a> <strong class="jxr_keyword">if</strong> (c == prev && c != 'C') {
+<a class="jxr_linenumber" name="L5532" href="#L5532">5532</a> i++;
+<a class="jxr_linenumber" name="L5533" href="#L5533">5533</a> <strong class="jxr_keyword">continue</strong>;
+<a class="jxr_linenumber" name="L5534" href="#L5534">5534</a> }
+<a class="jxr_linenumber" name="L5535" href="#L5535">5535</a>
+<a class="jxr_linenumber" name="L5536" href="#L5536">5536</a> <strong class="jxr_keyword">switch</strong> (c) {
+<a class="jxr_linenumber" name="L5537" href="#L5537">5537</a> <strong class="jxr_keyword">case</strong> 'B':
+<a class="jxr_linenumber" name="L5538" href="#L5538">5538</a> <strong class="jxr_keyword">if</strong> (prev != 'M' || next != '\0')
+<a class="jxr_linenumber" name="L5539" href="#L5539">5539</a> result.append('B');
+<a class="jxr_linenumber" name="L5540" href="#L5540">5540</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5541" href="#L5541">5541</a> <strong class="jxr_keyword">case</strong> 'C':
+<a class="jxr_linenumber" name="L5542" href="#L5542">5542</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
+<a class="jxr_linenumber" name="L5543" href="#L5543">5543</a> <strong class="jxr_keyword">if</strong> (prev == 'S')
+<a class="jxr_linenumber" name="L5544" href="#L5544">5544</a> result.append('K');
+<a class="jxr_linenumber" name="L5545" href="#L5545">5545</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L5546" href="#L5546">5546</a> result.append('X');
+<a class="jxr_linenumber" name="L5547" href="#L5547">5547</a> i++;
+<a class="jxr_linenumber" name="L5548" href="#L5548">5548</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' || next == 'E' || next == 'Y') {
+<a class="jxr_linenumber" name="L5549" href="#L5549">5549</a> result.append('S');
+<a class="jxr_linenumber" name="L5550" href="#L5550">5550</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L5551" href="#L5551">5551</a> result.append('K');
+<a class="jxr_linenumber" name="L5552" href="#L5552">5552</a> }
+<a class="jxr_linenumber" name="L5553" href="#L5553">5553</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5554" href="#L5554">5554</a> <strong class="jxr_keyword">case</strong> 'D':
+<a class="jxr_linenumber" name="L5555" href="#L5555">5555</a> <strong class="jxr_keyword">if</strong> (next == 'G' && (next2 == 'E' || next2 == 'I' || next2 == 'Y')) {
+<a class="jxr_linenumber" name="L5556" href="#L5556">5556</a> result.append('J');
+<a class="jxr_linenumber" name="L5557" href="#L5557">5557</a> i++;
+<a class="jxr_linenumber" name="L5558" href="#L5558">5558</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L5559" href="#L5559">5559</a> result.append('T');
+<a class="jxr_linenumber" name="L5560" href="#L5560">5560</a> }
+<a class="jxr_linenumber" name="L5561" href="#L5561">5561</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5562" href="#L5562">5562</a> <strong class="jxr_keyword">case</strong> 'F':
+<a class="jxr_linenumber" name="L5563" href="#L5563">5563</a> <strong class="jxr_keyword">case</strong> 'J':
+<a class="jxr_linenumber" name="L5564" href="#L5564">5564</a> <strong class="jxr_keyword">case</strong> 'L':
+<a class="jxr_linenumber" name="L5565" href="#L5565">5565</a> <strong class="jxr_keyword">case</strong> 'M':
+<a class="jxr_linenumber" name="L5566" href="#L5566">5566</a> <strong class="jxr_keyword">case</strong> 'N':
+<a class="jxr_linenumber" name="L5567" href="#L5567">5567</a> <strong class="jxr_keyword">case</strong> 'R':
+<a class="jxr_linenumber" name="L5568" href="#L5568">5568</a> result.append(c);
+<a class="jxr_linenumber" name="L5569" href="#L5569">5569</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5570" href="#L5570">5570</a> <strong class="jxr_keyword">case</strong> 'G':
+<a class="jxr_linenumber" name="L5571" href="#L5571">5571</a> <strong class="jxr_keyword">if</strong> (next == 'H' && (next2 == 'A' || next2 == 'E' || next2 == 'I' || next2 == 'O' || next2 == 'U')) {
+<a class="jxr_linenumber" name="L5572" href="#L5572">5572</a> <em class="jxr_comment">// Silent GH</em>
+<a class="jxr_linenumber" name="L5573" href="#L5573">5573</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'N' && (next2 == 'E' || next2 == 'D')) {
+<a class="jxr_linenumber" name="L5574" href="#L5574">5574</a> <em class="jxr_comment">// Silent GN</em>
+<a class="jxr_linenumber" name="L5575" href="#L5575">5575</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> ((next == 'E' || next == 'I' || next == 'Y') && prev != 'G') {
+<a class="jxr_linenumber" name="L5576" href="#L5576">5576</a> result.append('J');
+<a class="jxr_linenumber" name="L5577" href="#L5577">5577</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L5578" href="#L5578">5578</a> result.append('K');
+<a class="jxr_linenumber" name="L5579" href="#L5579">5579</a> }
<a class="jxr_linenumber" name="L5580" href="#L5580">5580</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5581" href="#L5581">5581</a> <strong class="jxr_keyword">case</strong> 'K':
-<a class="jxr_linenumber" name="L5582" href="#L5582">5582</a> <strong class="jxr_keyword">if</strong> (prev != 'C')
-<a class="jxr_linenumber" name="L5583" href="#L5583">5583</a> result.append('K');
+<a class="jxr_linenumber" name="L5581" href="#L5581">5581</a> <strong class="jxr_keyword">case</strong> 'H':
+<a class="jxr_linenumber" name="L5582" href="#L5582">5582</a> <strong class="jxr_keyword">if</strong> (! isVowel(prev) || ! isVowel(next))
+<a class="jxr_linenumber" name="L5583" href="#L5583">5583</a> result.append('H');
<a class="jxr_linenumber" name="L5584" href="#L5584">5584</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5585" href="#L5585">5585</a> <strong class="jxr_keyword">case</strong> 'P':
-<a class="jxr_linenumber" name="L5586" href="#L5586">5586</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
-<a class="jxr_linenumber" name="L5587" href="#L5587">5587</a> result.append('F');
-<a class="jxr_linenumber" name="L5588" href="#L5588">5588</a> i++;
-<a class="jxr_linenumber" name="L5589" href="#L5589">5589</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L5590" href="#L5590">5590</a> result.append('P');
-<a class="jxr_linenumber" name="L5591" href="#L5591">5591</a> }
-<a class="jxr_linenumber" name="L5592" href="#L5592">5592</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5593" href="#L5593">5593</a> <strong class="jxr_keyword">case</strong> 'Q':
-<a class="jxr_linenumber" name="L5594" href="#L5594">5594</a> result.append('K');
-<a class="jxr_linenumber" name="L5595" href="#L5595">5595</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5596" href="#L5596">5596</a> <strong class="jxr_keyword">case</strong> 'S':
-<a class="jxr_linenumber" name="L5597" href="#L5597">5597</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
-<a class="jxr_linenumber" name="L5598" href="#L5598">5598</a> result.append('X');
-<a class="jxr_linenumber" name="L5599" href="#L5599">5599</a> i++;
-<a class="jxr_linenumber" name="L5600" href="#L5600">5600</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' && (next2 == 'O' || next2 == 'A')) {
-<a class="jxr_linenumber" name="L5601" href="#L5601">5601</a> result.append('X');
-<a class="jxr_linenumber" name="L5602" href="#L5602">5602</a> i++;
-<a class="jxr_linenumber" name="L5603" href="#L5603">5603</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L5604" href="#L5604">5604</a> result.append('S');
-<a class="jxr_linenumber" name="L5605" href="#L5605">5605</a> }
-<a class="jxr_linenumber" name="L5606" href="#L5606">5606</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5607" href="#L5607">5607</a> <strong class="jxr_keyword">case</strong> 'T':
-<a class="jxr_linenumber" name="L5608" href="#L5608">5608</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
-<a class="jxr_linenumber" name="L5609" href="#L5609">5609</a> result.append('0'); <em class="jxr_comment">// TH sound</em>
-<a class="jxr_linenumber" name="L5610" href="#L5610">5610</a> i++;
-<a class="jxr_linenumber" name="L5611" href="#L5611">5611</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' && (next2 == 'O' || next2 == 'A')) {
-<a class="jxr_linenumber" name="L5612" href="#L5612">5612</a> result.append('X');
-<a class="jxr_linenumber" name="L5613" href="#L5613">5613</a> i++;
-<a class="jxr_linenumber" name="L5614" href="#L5614">5614</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L5615" href="#L5615">5615</a> result.append('T');
-<a class="jxr_linenumber" name="L5616" href="#L5616">5616</a> }
-<a class="jxr_linenumber" name="L5617" href="#L5617">5617</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5618" href="#L5618">5618</a> <strong class="jxr_keyword">case</strong> 'V':
-<a class="jxr_linenumber" name="L5619" href="#L5619">5619</a> result.append('F');
-<a class="jxr_linenumber" name="L5620" href="#L5620">5620</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5621" href="#L5621">5621</a> <strong class="jxr_keyword">case</strong> 'W', 'Y':
-<a class="jxr_linenumber" name="L5622" href="#L5622">5622</a> <strong class="jxr_keyword">if</strong> (isVowel(next))
-<a class="jxr_linenumber" name="L5623" href="#L5623">5623</a> result.append(c);
+<a class="jxr_linenumber" name="L5585" href="#L5585">5585</a> <strong class="jxr_keyword">case</strong> 'K':
+<a class="jxr_linenumber" name="L5586" href="#L5586">5586</a> <strong class="jxr_keyword">if</strong> (prev != 'C')
+<a class="jxr_linenumber" name="L5587" href="#L5587">5587</a> result.append('K');
+<a class="jxr_linenumber" name="L5588" href="#L5588">5588</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5589" href="#L5589">5589</a> <strong class="jxr_keyword">case</strong> 'P':
+<a class="jxr_linenumber" name="L5590" href="#L5590">5590</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
+<a class="jxr_linenumber" name="L5591" href="#L5591">5591</a> result.append('F');
+<a class="jxr_linenumber" name="L5592" href="#L5592">5592</a> i++;
+<a class="jxr_linenumber" name="L5593" href="#L5593">5593</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L5594" href="#L5594">5594</a> result.append('P');
+<a class="jxr_linenumber" name="L5595" href="#L5595">5595</a> }
+<a class="jxr_linenumber" name="L5596" href="#L5596">5596</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5597" href="#L5597">5597</a> <strong class="jxr_keyword">case</strong> 'Q':
+<a class="jxr_linenumber" name="L5598" href="#L5598">5598</a> result.append('K');
+<a class="jxr_linenumber" name="L5599" href="#L5599">5599</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5600" href="#L5600">5600</a> <strong class="jxr_keyword">case</strong> 'S':
+<a class="jxr_linenumber" name="L5601" href="#L5601">5601</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
+<a class="jxr_linenumber" name="L5602" href="#L5602">5602</a> result.append('X');
+<a class="jxr_linenumber" name="L5603" href="#L5603">5603</a> i++;
+<a class="jxr_linenumber" name="L5604" href="#L5604">5604</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' && (next2 == 'O' || next2 == 'A')) {
+<a class="jxr_linenumber" name="L5605" href="#L5605">5605</a> result.append('X');
+<a class="jxr_linenumber" name="L5606" href="#L5606">5606</a> i++;
+<a class="jxr_linenumber" name="L5607" href="#L5607">5607</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L5608" href="#L5608">5608</a> result.append('S');
+<a class="jxr_linenumber" name="L5609" href="#L5609">5609</a> }
+<a class="jxr_linenumber" name="L5610" href="#L5610">5610</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5611" href="#L5611">5611</a> <strong class="jxr_keyword">case</strong> 'T':
+<a class="jxr_linenumber" name="L5612" href="#L5612">5612</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
+<a class="jxr_linenumber" name="L5613" href="#L5613">5613</a> result.append('0'); <em class="jxr_comment">// TH sound</em>
+<a class="jxr_linenumber" name="L5614" href="#L5614">5614</a> i++;
+<a class="jxr_linenumber" name="L5615" href="#L5615">5615</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' && (next2 == 'O' || next2 == 'A')) {
+<a class="jxr_linenumber" name="L5616" href="#L5616">5616</a> result.append('X');
+<a class="jxr_linenumber" name="L5617" href="#L5617">5617</a> i++;
+<a class="jxr_linenumber" name="L5618" href="#L5618">5618</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L5619" href="#L5619">5619</a> result.append('T');
+<a class="jxr_linenumber" name="L5620" href="#L5620">5620</a> }
+<a class="jxr_linenumber" name="L5621" href="#L5621">5621</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5622" href="#L5622">5622</a> <strong class="jxr_keyword">case</strong> 'V':
+<a class="jxr_linenumber" name="L5623" href="#L5623">5623</a> result.append('F');
<a class="jxr_linenumber" name="L5624" href="#L5624">5624</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5625" href="#L5625">5625</a> <strong class="jxr_keyword">case</strong> 'X':
-<a class="jxr_linenumber" name="L5626" href="#L5626">5626</a> <strong class="jxr_keyword">if</strong> (i == 0)
-<a class="jxr_linenumber" name="L5627" href="#L5627">5627</a> result.append('S');
-<a class="jxr_linenumber" name="L5628" href="#L5628">5628</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L5629" href="#L5629">5629</a> result.append(<span class="jxr_string">"KS"</span>);
-<a class="jxr_linenumber" name="L5630" href="#L5630">5630</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5631" href="#L5631">5631</a> <strong class="jxr_keyword">case</strong> 'Z':
-<a class="jxr_linenumber" name="L5632" href="#L5632">5632</a> result.append('S');
-<a class="jxr_linenumber" name="L5633" href="#L5633">5633</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5634" href="#L5634">5634</a> <strong class="jxr_keyword">default</strong>:
-<a class="jxr_linenumber" name="L5635" href="#L5635">5635</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L5636" href="#L5636">5636</a> }
-<a class="jxr_linenumber" name="L5637" href="#L5637">5637</a> i++;
-<a class="jxr_linenumber" name="L5638" href="#L5638">5638</a> }
-<a class="jxr_linenumber" name="L5639" href="#L5639">5639</a>
-<a class="jxr_linenumber" name="L5640" href="#L5640">5640</a> <strong class="jxr_keyword">return</strong> result.length() > 0 ? result.toString() : upper.substring(0, Math.min(1, upper.length()));
-<a class="jxr_linenumber" name="L5641" href="#L5641">5641</a> }
-<a class="jxr_linenumber" name="L5642" href="#L5642">5642</a>
-<a class="jxr_linenumber" name="L5643" href="#L5643">5643</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5644" href="#L5644">5644</a> <em class="jxr_javadoccomment"> * Helper method to check if a character is a vowel.</em>
-<a class="jxr_linenumber" name="L5645" href="#L5645">5645</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5646" href="#L5646">5646</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isVowel(<strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L5647" href="#L5647">5647</a> <strong class="jxr_keyword">return</strong> c == 'A' || c == 'E' || c == 'I' || c == 'O' || c == 'U';
-<a class="jxr_linenumber" name="L5648" href="#L5648">5648</a> }
-<a class="jxr_linenumber" name="L5649" href="#L5649">5649</a>
-<a class="jxr_linenumber" name="L5650" href="#L5650">5650</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5651" href="#L5651">5651</a> <em class="jxr_javadoccomment"> * Generates a Double Metaphone code for a string.</em>
-<a class="jxr_linenumber" name="L5652" href="#L5652">5652</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5653" href="#L5653">5653</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5654" href="#L5654">5654</a> <em class="jxr_javadoccomment"> * Double Metaphone is an improved version of Metaphone that returns two codes:</em>
-<a class="jxr_linenumber" name="L5655" href="#L5655">5655</a> <em class="jxr_javadoccomment"> * a primary code and an alternate code. This handles more edge cases and variations.</em>
+<a class="jxr_linenumber" name="L5625" href="#L5625">5625</a> <strong class="jxr_keyword">case</strong> 'W', 'Y':
+<a class="jxr_linenumber" name="L5626" href="#L5626">5626</a> <strong class="jxr_keyword">if</strong> (isVowel(next))
+<a class="jxr_linenumber" name="L5627" href="#L5627">5627</a> result.append(c);
+<a class="jxr_linenumber" name="L5628" href="#L5628">5628</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5629" href="#L5629">5629</a> <strong class="jxr_keyword">case</strong> 'X':
+<a class="jxr_linenumber" name="L5630" href="#L5630">5630</a> <strong class="jxr_keyword">if</strong> (i == 0)
+<a class="jxr_linenumber" name="L5631" href="#L5631">5631</a> result.append('S');
+<a class="jxr_linenumber" name="L5632" href="#L5632">5632</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L5633" href="#L5633">5633</a> result.append(<span class="jxr_string">"KS"</span>);
+<a class="jxr_linenumber" name="L5634" href="#L5634">5634</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5635" href="#L5635">5635</a> <strong class="jxr_keyword">case</strong> 'Z':
+<a class="jxr_linenumber" name="L5636" href="#L5636">5636</a> result.append('S');
+<a class="jxr_linenumber" name="L5637" href="#L5637">5637</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5638" href="#L5638">5638</a> <strong class="jxr_keyword">default</strong>:
+<a class="jxr_linenumber" name="L5639" href="#L5639">5639</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L5640" href="#L5640">5640</a> }
+<a class="jxr_linenumber" name="L5641" href="#L5641">5641</a> i++;
+<a class="jxr_linenumber" name="L5642" href="#L5642">5642</a> }
+<a class="jxr_linenumber" name="L5643" href="#L5643">5643</a>
+<a class="jxr_linenumber" name="L5644" href="#L5644">5644</a> <strong class="jxr_keyword">return</strong> result.length() > 0 ? result.toString() : upper.substring(0, Math.min(1, upper.length()));
+<a class="jxr_linenumber" name="L5645" href="#L5645">5645</a> }
+<a class="jxr_linenumber" name="L5646" href="#L5646">5646</a>
+<a class="jxr_linenumber" name="L5647" href="#L5647">5647</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5648" href="#L5648">5648</a> <em class="jxr_javadoccomment"> * Helper method to check if a character is a vowel.</em>
+<a class="jxr_linenumber" name="L5649" href="#L5649">5649</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5650" href="#L5650">5650</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isVowel(<strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L5651" href="#L5651">5651</a> <strong class="jxr_keyword">return</strong> c == 'A' || c == 'E' || c == 'I' || c == 'O' || c == 'U';
+<a class="jxr_linenumber" name="L5652" href="#L5652">5652</a> }
+<a class="jxr_linenumber" name="L5653" href="#L5653">5653</a>
+<a class="jxr_linenumber" name="L5654" href="#L5654">5654</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5655" href="#L5655">5655</a> <em class="jxr_javadoccomment"> * Generates a Double Metaphone code for a string.</em>
<a class="jxr_linenumber" name="L5656" href="#L5656">5656</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5657" href="#L5657">5657</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5658" href="#L5658">5658</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5659" href="#L5659">5659</a> <em class="jxr_javadoccomment"> * doubleMetaphone(<js>"Smith"</js>); <jc>// "SM0"</jc></em>
-<a class="jxr_linenumber" name="L5660" href="#L5660">5660</a> <em class="jxr_javadoccomment"> * doubleMetaphone(<js>"Schmidt"</js>); <jc>// "XMT"</jc></em>
-<a class="jxr_linenumber" name="L5661" href="#L5661">5661</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5662" href="#L5662">5662</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5663" href="#L5663">5663</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Double Metaphone code for. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5664" href="#L5664">5664</a> <em class="jxr_javadoccomment"> * @return An array with two elements: [primary code, alternate code]. Returns <jk>null</jk> if input is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5665" href="#L5665">5665</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5666" href="#L5666">5666</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] doubleMetaphone(String str) {
-<a class="jxr_linenumber" name="L5667" href="#L5667">5667</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5668" href="#L5668">5668</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5669" href="#L5669">5669</a>
-<a class="jxr_linenumber" name="L5670" href="#L5670">5670</a> <em class="jxr_comment">// For simplicity, return the same code for both primary and alternate</em>
-<a class="jxr_linenumber" name="L5671" href="#L5671">5671</a> <em class="jxr_comment">// A full Double Metaphone implementation would be much more complex</em>
-<a class="jxr_linenumber" name="L5672" href="#L5672">5672</a> <strong class="jxr_keyword">var</strong> primary = metaphone(str);
-<a class="jxr_linenumber" name="L5673" href="#L5673">5673</a> <strong class="jxr_keyword">if</strong> (primary == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5674" href="#L5674">5674</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5675" href="#L5675">5675</a>
-<a class="jxr_linenumber" name="L5676" href="#L5676">5676</a> <em class="jxr_comment">// Generate alternate code (simplified - full implementation would have different rules)</em>
-<a class="jxr_linenumber" name="L5677" href="#L5677">5677</a> <strong class="jxr_keyword">var</strong> alternate = primary;
-<a class="jxr_linenumber" name="L5678" href="#L5678">5678</a>
-<a class="jxr_linenumber" name="L5679" href="#L5679">5679</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[] { primary, alternate };
-<a class="jxr_linenumber" name="L5680" href="#L5680">5680</a> }
-<a class="jxr_linenumber" name="L5681" href="#L5681">5681</a>
-<a class="jxr_linenumber" name="L5682" href="#L5682">5682</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5683" href="#L5683">5683</a> <em class="jxr_javadoccomment"> * Normalizes Unicode characters in a string.</em>
-<a class="jxr_linenumber" name="L5684" href="#L5684">5684</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5685" href="#L5685">5685</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5686" href="#L5686">5686</a> <em class="jxr_javadoccomment"> * Uses Unicode normalization form NFD (Canonical Decomposition).</em>
-<a class="jxr_linenumber" name="L5687" href="#L5687">5687</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5688" href="#L5688">5688</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5689" href="#L5689">5689</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5690" href="#L5690">5690</a> <em class="jxr_javadoccomment"> * normalizeUnicode(<js>"café"</js>);</em>
-<a class="jxr_linenumber" name="L5691" href="#L5691">5691</a> <em class="jxr_javadoccomment"> * <jc>// Normalized form</jc></em>
-<a class="jxr_linenumber" name="L5692" href="#L5692">5692</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5693" href="#L5693">5693</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5694" href="#L5694">5694</a> <em class="jxr_javadoccomment"> * @param str The string to normalize. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5695" href="#L5695">5695</a> <em class="jxr_javadoccomment"> * @return The normalized string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5696" href="#L5696">5696</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5697" href="#L5697">5697</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String normalizeUnicode(String str) {
-<a class="jxr_linenumber" name="L5698" href="#L5698">5698</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5699" href="#L5699">5699</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5700" href="#L5700">5700</a> <strong class="jxr_keyword">return</strong> Normalizer.normalize(str, Normalizer.Form.NFD);
-<a class="jxr_linenumber" name="L5701" href="#L5701">5701</a> }
-<a class="jxr_linenumber" name="L5702" href="#L5702">5702</a>
-<a class="jxr_linenumber" name="L5703" href="#L5703">5703</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5704" href="#L5704">5704</a> <em class="jxr_javadoccomment"> * Removes diacritical marks (accents) from characters in a string.</em>
-<a class="jxr_linenumber" name="L5705" href="#L5705">5705</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5706" href="#L5706">5706</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5707" href="#L5707">5707</a> <em class="jxr_javadoccomment"> * Normalizes the string to NFD form and removes combining diacritical marks.</em>
-<a class="jxr_linenumber" name="L5708" href="#L5708">5708</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5709" href="#L5709">5709</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5710" href="#L5710">5710</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5711" href="#L5711">5711</a> <em class="jxr_javadoccomment"> * removeAccents(<js>"café"</js>); <jc>// "cafe"</jc></em>
-<a class="jxr_linenumber" name="L5712" href="#L5712">5712</a> <em class="jxr_javadoccomment"> * removeAccents(<js>"naïve"</js>); <jc>// "naive"</jc></em>
-<a class="jxr_linenumber" name="L5713" href="#L5713">5713</a> <em class="jxr_javadoccomment"> * removeAccents(<js>"résumé"</js>); <jc>// "resume"</jc></em>
-<a class="jxr_linenumber" name="L5714" href="#L5714">5714</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5715" href="#L5715">5715</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5716" href="#L5716">5716</a> <em class="jxr_javadoccomment"> * @param str The string to remove accents from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5717" href="#L5717">5717</a> <em class="jxr_javadoccomment"> * @return The string with accents removed, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5718" href="#L5718">5718</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5719" href="#L5719">5719</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String removeAccents(String str) {
-<a class="jxr_linenumber" name="L5720" href="#L5720">5720</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5721" href="#L5721">5721</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5722" href="#L5722">5722</a>
-<a class="jxr_linenumber" name="L5723" href="#L5723">5723</a> <em class="jxr_comment">// Normalize to NFD (decomposed form)</em>
-<a class="jxr_linenumber" name="L5724" href="#L5724">5724</a> <strong class="jxr_keyword">var</strong> normalized = Normalizer.normalize(str, Normalizer.Form.NFD);
-<a class="jxr_linenumber" name="L5725" href="#L5725">5725</a>
-<a class="jxr_linenumber" name="L5726" href="#L5726">5726</a> <em class="jxr_comment">// Remove combining diacritical marks (Unicode category Mn)</em>
-<a class="jxr_linenumber" name="L5727" href="#L5727">5727</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(normalized.length());
-<a class="jxr_linenumber" name="L5728" href="#L5728">5728</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < normalized.length(); i++) {
-<a class="jxr_linenumber" name="L5729" href="#L5729">5729</a> <strong class="jxr_keyword">var</strong> c = normalized.charAt(i);
-<a class="jxr_linenumber" name="L5730" href="#L5730">5730</a> <strong class="jxr_keyword">var</strong> type = Character.getType(c);
-<a class="jxr_linenumber" name="L5731" href="#L5731">5731</a> <em class="jxr_comment">// Mn = Nonspacing_Mark (combining marks)</em>
-<a class="jxr_linenumber" name="L5732" href="#L5732">5732</a> <strong class="jxr_keyword">if</strong> (type != Character.NON_SPACING_MARK) {
-<a class="jxr_linenumber" name="L5733" href="#L5733">5733</a> sb.append(c);
-<a class="jxr_linenumber" name="L5734" href="#L5734">5734</a> }
-<a class="jxr_linenumber" name="L5735" href="#L5735">5735</a> }
-<a class="jxr_linenumber" name="L5736" href="#L5736">5736</a>
-<a class="jxr_linenumber" name="L5737" href="#L5737">5737</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L5738" href="#L5738">5738</a> }
-<a class="jxr_linenumber" name="L5739" href="#L5739">5739</a>
-<a class="jxr_linenumber" name="L5740" href="#L5740">5740</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5741" href="#L5741">5741</a> <em class="jxr_javadoccomment"> * Swaps the case of all characters in a string.</em>
-<a class="jxr_linenumber" name="L5742" href="#L5742">5742</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5743" href="#L5743">5743</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5744" href="#L5744">5744</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5745" href="#L5745">5745</a> <em class="jxr_javadoccomment"> * swapCase(<js>"Hello World"</js>); <jc>// "hELLO wORLD"</jc></em>
-<a class="jxr_linenumber" name="L5746" href="#L5746">5746</a> <em class="jxr_javadoccomment"> * swapCase(<js>"ABC123xyz"</js>); <jc>// "abc123XYZ"</jc></em>
-<a class="jxr_linenumber" name="L5747" href="#L5747">5747</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5748" href="#L5748">5748</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5749" href="#L5749">5749</a> <em class="jxr_javadoccomment"> * @param str The string to process.</em>
-<a class="jxr_linenumber" name="L5750" href="#L5750">5750</a> <em class="jxr_javadoccomment"> * @return The string with case swapped, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5751" href="#L5751">5751</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5752" href="#L5752">5752</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String swapCase(String str) {
-<a class="jxr_linenumber" name="L5753" href="#L5753">5753</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5754" href="#L5754">5754</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5755" href="#L5755">5755</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(str.length());
-<a class="jxr_linenumber" name="L5756" href="#L5756">5756</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L5757" href="#L5757">5757</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
-<a class="jxr_linenumber" name="L5758" href="#L5758">5758</a> <strong class="jxr_keyword">if</strong> (Character.isUpperCase(c))
-<a class="jxr_linenumber" name="L5759" href="#L5759">5759</a> sb.append(Character.toLowerCase(c));
-<a class="jxr_linenumber" name="L5760" href="#L5760">5760</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (Character.isLowerCase(c))
-<a class="jxr_linenumber" name="L5761" href="#L5761">5761</a> sb.append(Character.toUpperCase(c));
-<a class="jxr_linenumber" name="L5762" href="#L5762">5762</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L5763" href="#L5763">5763</a> sb.append(c);
-<a class="jxr_linenumber" name="L5764" href="#L5764">5764</a> }
-<a class="jxr_linenumber" name="L5765" href="#L5765">5765</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L5766" href="#L5766">5766</a> }
-<a class="jxr_linenumber" name="L5767" href="#L5767">5767</a>
-<a class="jxr_linenumber" name="L5768" href="#L5768">5768</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5769" href="#L5769">5769</a> <em class="jxr_javadoccomment"> * Converts the specified object to a comma-delimited list.</em>
-<a class="jxr_linenumber" name="L5770" href="#L5770">5770</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5771" href="#L5771">5771</a> <em class="jxr_javadoccomment"> * @param o The object to convert.</em>
-<a class="jxr_linenumber" name="L5772" href="#L5772">5772</a> <em class="jxr_javadoccomment"> * @return The specified object as a comma-delimited list.</em>
-<a class="jxr_linenumber" name="L5773" href="#L5773">5773</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5774" href="#L5774">5774</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toCdl(Object o) {
-<a class="jxr_linenumber" name="L5775" href="#L5775">5775</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5776" href="#L5776">5776</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5777" href="#L5777">5777</a> <strong class="jxr_keyword">if</strong> (isArray(o)) {
-<a class="jxr_linenumber" name="L5778" href="#L5778">5778</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L5779" href="#L5779">5779</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0, j = Array.getLength(o); i < j; i++) {
-<a class="jxr_linenumber" name="L5780" href="#L5780">5780</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L5781" href="#L5781">5781</a> sb.append(<span class="jxr_string">", "</span>);
-<a class="jxr_linenumber" name="L5782" href="#L5782">5782</a> sb.append(Array.get(o, i));
-<a class="jxr_linenumber" name="L5783" href="#L5783">5783</a> }
-<a class="jxr_linenumber" name="L5784" href="#L5784">5784</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L5785" href="#L5785">5785</a> }
-<a class="jxr_linenumber" name="L5786" href="#L5786">5786</a> <strong class="jxr_keyword">if</strong> (o instanceof Collection<?> c)
-<a class="jxr_linenumber" name="L5787" href="#L5787">5787</a> <strong class="jxr_keyword">return</strong> join(c, <span class="jxr_string">", "</span>);
-<a class="jxr_linenumber" name="L5788" href="#L5788">5788</a> <strong class="jxr_keyword">return</strong> o.toString();
-<a class="jxr_linenumber" name="L5789" href="#L5789">5789</a> }
-<a class="jxr_linenumber" name="L5790" href="#L5790">5790</a>
-<a class="jxr_linenumber" name="L5791" href="#L5791">5791</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5792" href="#L5792">5792</a> <em class="jxr_javadoccomment"> * Converts the specified byte into a 2 hexadecimal characters.</em>
-<a class="jxr_linenumber" name="L5793" href="#L5793">5793</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5794" href="#L5794">5794</a> <em class="jxr_javadoccomment"> * @param b The number to convert to hex.</em>
-<a class="jxr_linenumber" name="L5795" href="#L5795">5795</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[2]</code> containing the specified characters.</em>
-<a class="jxr_linenumber" name="L5796" href="#L5796">5796</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5797" href="#L5797">5797</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toHex(byte b) {
-<a class="jxr_linenumber" name="L5798" href="#L5798">5798</a> <strong class="jxr_keyword">var</strong> c = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[2];
-<a class="jxr_linenumber" name="L5799" href="#L5799">5799</a> <strong class="jxr_keyword">var</strong> v = b & 0xFF;
-<a class="jxr_linenumber" name="L5800" href="#L5800">5800</a> c[0] = hexArray[v >>> 4];
-<a class="jxr_linenumber" name="L5801" href="#L5801">5801</a> c[1] = hexArray[v & 0x0F];
-<a class="jxr_linenumber" name="L5802" href="#L5802">5802</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String(c);
-<a class="jxr_linenumber" name="L5803" href="#L5803">5803</a> }
-<a class="jxr_linenumber" name="L5804" href="#L5804">5804</a>
-<a class="jxr_linenumber" name="L5805" href="#L5805">5805</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5806" href="#L5806">5806</a> <em class="jxr_javadoccomment"> * Converts a byte array into a simple hexadecimal character string.</em>
-<a class="jxr_linenumber" name="L5807" href="#L5807">5807</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5808" href="#L5808">5808</a> <em class="jxr_javadoccomment"> * @param bytes The bytes to convert to hexadecimal.</em>
-<a class="jxr_linenumber" name="L5809" href="#L5809">5809</a> <em class="jxr_javadoccomment"> * @return A new string consisting of hexadecimal characters.</em>
-<a class="jxr_linenumber" name="L5810" href="#L5810">5810</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5811" href="#L5811">5811</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toHex(byte[] bytes) {
-<a class="jxr_linenumber" name="L5812" href="#L5812">5812</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(bytes.length * 2);
-<a class="jxr_linenumber" name="L5813" href="#L5813">5813</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> element : bytes) {
-<a class="jxr_linenumber" name="L5814" href="#L5814">5814</a> <strong class="jxr_keyword">var</strong> v = element & 0xFF;
-<a class="jxr_linenumber" name="L5815" href="#L5815">5815</a> sb.append(HEX[v >>> 4]).append(HEX[v & 0x0F]);
-<a class="jxr_linenumber" name="L5816" href="#L5816">5816</a> }
-<a class="jxr_linenumber" name="L5817" href="#L5817">5817</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L5818" href="#L5818">5818</a> }
-<a class="jxr_linenumber" name="L5819" href="#L5819">5819</a>
-<a class="jxr_linenumber" name="L5820" href="#L5820">5820</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5821" href="#L5821">5821</a> <em class="jxr_javadoccomment"> * Converts the contents of the specified input stream to a hex string.</em>
-<a class="jxr_linenumber" name="L5822" href="#L5822">5822</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5823" href="#L5823">5823</a> <em class="jxr_javadoccomment"> * @param is The input stream to convert.</em>
-<a class="jxr_linenumber" name="L5824" href="#L5824">5824</a> <em class="jxr_javadoccomment"> * @return The hex string representation of the input stream contents, or <jk>null</jk> if the stream is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5825" href="#L5825">5825</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5826" href="#L5826">5826</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toHex(InputStream is) {
-<a class="jxr_linenumber" name="L5827" href="#L5827">5827</a> <strong class="jxr_keyword">return</strong> safe(() -> is == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : toHex(readBytes(is)));
-<a class="jxr_linenumber" name="L5828" href="#L5828">5828</a> }
-<a class="jxr_linenumber" name="L5829" href="#L5829">5829</a>
-<a class="jxr_linenumber" name="L5830" href="#L5830">5830</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5831" href="#L5831">5831</a> <em class="jxr_javadoccomment"> * Converts the specified number into a 2 hexadecimal characters.</em>
-<a class="jxr_linenumber" name="L5832" href="#L5832">5832</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5833" href="#L5833">5833</a> <em class="jxr_javadoccomment"> * @param num The number to convert to hex.</em>
-<a class="jxr_linenumber" name="L5834" href="#L5834">5834</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[2]</code> containing the specified characters.</em>
-<a class="jxr_linenumber" name="L5835" href="#L5835">5835</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5836" href="#L5836">5836</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong>[] toHex2(<strong class="jxr_keyword">int</strong> num) {
-<a class="jxr_linenumber" name="L5837" href="#L5837">5837</a> <strong class="jxr_keyword">if</strong> (num < 0 || num > 255)
-<a class="jxr_linenumber" name="L5838" href="#L5838">5838</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(<span class="jxr_string">"toHex2 can only be used on numbers between 0 and 255"</span>);
-<a class="jxr_linenumber" name="L5839" href="#L5839">5839</a> <strong class="jxr_keyword">var</strong> n = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[2];
-<a class="jxr_linenumber" name="L5840" href="#L5840">5840</a> <strong class="jxr_keyword">var</strong> a = num % 16;
-<a class="jxr_linenumber" name="L5841" href="#L5841">5841</a> n[1] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
-<a class="jxr_linenumber" name="L5842" href="#L5842">5842</a> a = (num / 16) % 16;
-<a class="jxr_linenumber" name="L5843" href="#L5843">5843</a> n[0] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
-<a class="jxr_linenumber" name="L5844" href="#L5844">5844</a> <strong class="jxr_keyword">return</strong> n;
-<a class="jxr_linenumber" name="L5845" href="#L5845">5845</a> }
-<a class="jxr_linenumber" name="L5846" href="#L5846">5846</a>
-<a class="jxr_linenumber" name="L5847" href="#L5847">5847</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5848" href="#L5848">5848</a> <em class="jxr_javadoccomment"> * Converts the specified number into a 4 hexadecimal characters.</em>
-<a class="jxr_linenumber" name="L5849" href="#L5849">5849</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5850" href="#L5850">5850</a> <em class="jxr_javadoccomment"> * @param num The number to convert to hex.</em>
-<a class="jxr_linenumber" name="L5851" href="#L5851">5851</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[4]</code> containing the specified characters.</em>
-<a class="jxr_linenumber" name="L5852" href="#L5852">5852</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the number is negative.</em>
-<a class="jxr_linenumber" name="L5853" href="#L5853">5853</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5854" href="#L5854">5854</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong>[] toHex4(<strong class="jxr_keyword">int</strong> num) {
-<a class="jxr_linenumber" name="L5855" href="#L5855">5855</a> <strong class="jxr_keyword">if</strong> (num < 0)
-<a class="jxr_linenumber" name="L5856" href="#L5856">5856</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(<span class="jxr_string">"toHex4 can only be used on non-negative numbers"</span>);
-<a class="jxr_linenumber" name="L5857" href="#L5857">5857</a> <strong class="jxr_keyword">var</strong> n = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[4];
-<a class="jxr_linenumber" name="L5858" href="#L5858">5858</a> <strong class="jxr_keyword">var</strong> a = num % 16;
-<a class="jxr_linenumber" name="L5859" href="#L5859">5859</a> n[3] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
-<a class="jxr_linenumber" name="L5860" href="#L5860">5860</a> <strong class="jxr_keyword">var</strong> base = 16;
-<a class="jxr_linenumber" name="L5861" href="#L5861">5861</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 1; i < 4; i++) {
-<a class="jxr_linenumber" name="L5862" href="#L5862">5862</a> a = (num / base) % 16;
-<a class="jxr_linenumber" name="L5863" href="#L5863">5863</a> base <<= 4;
-<a class="jxr_linenumber" name="L5864" href="#L5864">5864</a> n[3 - i] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
-<a class="jxr_linenumber" name="L5865" href="#L5865">5865</a> }
-<a class="jxr_linenumber" name="L5866" href="#L5866">5866</a> <strong class="jxr_keyword">return</strong> n;
-<a class="jxr_linenumber" name="L5867" href="#L5867">5867</a> }
-<a class="jxr_linenumber" name="L5868" href="#L5868">5868</a>
-<a class="jxr_linenumber" name="L5869" href="#L5869">5869</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5870" href="#L5870">5870</a> <em class="jxr_javadoccomment"> * Converts the specified number into a 8 hexadecimal characters.</em>
-<a class="jxr_linenumber" name="L5871" href="#L5871">5871</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5872" href="#L5872">5872</a> <em class="jxr_javadoccomment"> * @param num The number to convert to hex.</em>
-<a class="jxr_linenumber" name="L5873" href="#L5873">5873</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[8]</code> containing the specified characters.</em>
-<a class="jxr_linenumber" name="L5874" href="#L5874">5874</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the number is negative.</em>
-<a class="jxr_linenumber" name="L5875" href="#L5875">5875</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5876" href="#L5876">5876</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong>[] toHex8(<strong class="jxr_keyword">long</strong> num) {
-<a class="jxr_linenumber" name="L5877" href="#L5877">5877</a> <strong class="jxr_keyword">if</strong> (num < 0)
-<a class="jxr_linenumber" name="L5878" href="#L5878">5878</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(<span class="jxr_string">"toHex8 can only be used on non-negative numbers"</span>);
-<a class="jxr_linenumber" name="L5879" href="#L5879">5879</a> <strong class="jxr_keyword">var</strong> n = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[8];
-<a class="jxr_linenumber" name="L5880" href="#L5880">5880</a> <strong class="jxr_keyword">var</strong> a = num % 16;
-<a class="jxr_linenumber" name="L5881" href="#L5881">5881</a> n[7] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
-<a class="jxr_linenumber" name="L5882" href="#L5882">5882</a> <strong class="jxr_keyword">var</strong> base = 16;
-<a class="jxr_linenumber" name="L5883" href="#L5883">5883</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 1; i < 8; i++) {
-<a class="jxr_linenumber" name="L5884" href="#L5884">5884</a> a = (num / base) % 16;
-<a class="jxr_linenumber" name="L5885" href="#L5885">5885</a> base <<= 4;
-<a class="jxr_linenumber" name="L5886" href="#L5886">5886</a> n[7 - i] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
-<a class="jxr_linenumber" name="L5887" href="#L5887">5887</a> }
-<a class="jxr_linenumber" name="L5888" href="#L5888">5888</a> <strong class="jxr_keyword">return</strong> n;
-<a class="jxr_linenumber" name="L5889" href="#L5889">5889</a> }
-<a class="jxr_linenumber" name="L5890" href="#L5890">5890</a>
-<a class="jxr_linenumber" name="L5891" href="#L5891">5891</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5892" href="#L5892">5892</a> <em class="jxr_javadoccomment"> * Converts the specified object to an ISO8601 date string.</em>
-<a class="jxr_linenumber" name="L5893" href="#L5893">5893</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5894" href="#L5894">5894</a> <em class="jxr_javadoccomment"> * @param c The object to convert.</em>
-<a class="jxr_linenumber" name="L5895" href="#L5895">5895</a> <em class="jxr_javadoccomment"> * @return The converted object.</em>
-<a class="jxr_linenumber" name="L5896" href="#L5896">5896</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5897" href="#L5897">5897</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toIsoDate(Calendar c) {
-<a class="jxr_linenumber" name="L5898" href="#L5898">5898</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="L5899" href="#L5899">5899</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5900" href="#L5900">5900</a> }
-<a class="jxr_linenumber" name="L5901" href="#L5901">5901</a> <em class="jxr_comment">// Convert Calendar to ZonedDateTime and format as ISO8601 date (YYYY-MM-DD)</em>
-<a class="jxr_linenumber" name="L5902" href="#L5902">5902</a> ZonedDateTime zdt = c.toInstant().atZone(c.getTimeZone().toZoneId());
-<a class="jxr_linenumber" name="L5903" href="#L5903">5903</a> <strong class="jxr_keyword">return</strong> zdt.format(DateTimeFormatter.ISO_LOCAL_DATE);
-<a class="jxr_linenumber" name="L5904" href="#L5904">5904</a> }
-<a class="jxr_linenumber" name="L5905" href="#L5905">5905</a>
-<a class="jxr_linenumber" name="L5906" href="#L5906">5906</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5907" href="#L5907">5907</a> <em class="jxr_javadoccomment"> * Converts the specified object to an ISO8601 date-time string.</em>
-<a class="jxr_linenumber" name="L5908" href="#L5908">5908</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5909" href="#L5909">5909</a> <em class="jxr_javadoccomment"> * @param c The object to convert.</em>
-<a class="jxr_linenumber" name="L5910" href="#L5910">5910</a> <em class="jxr_javadoccomment"> * @return The converted object.</em>
-<a class="jxr_linenumber" name="L5911" href="#L5911">5911</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5912" href="#L5912">5912</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toIsoDateTime(Calendar c) {
-<a class="jxr_linenumber" name="L5913" href="#L5913">5913</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="L5914" href="#L5914">5914</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5915" href="#L5915">5915</a> }
-<a class="jxr_linenumber" name="L5916" href="#L5916">5916</a> <em class="jxr_comment">// Convert Calendar to ZonedDateTime and format as ISO8601 date-time with timezone</em>
-<a class="jxr_linenumber" name="L5917" href="#L5917">5917</a> ZonedDateTime zdt = c.toInstant().atZone(c.getTimeZone().toZoneId());
-<a class="jxr_linenumber" name="L5918" href="#L5918">5918</a> <strong class="jxr_keyword">return</strong> zdt.format(DateTimeFormatter.ISO_OFFSET_DATE_TIME);
-<a class="jxr_linenumber" name="L5919" href="#L5919">5919</a> }
-<a class="jxr_linenumber" name="L5920" href="#L5920">5920</a>
-<a class="jxr_linenumber" name="L5921" href="#L5921">5921</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5922" href="#L5922">5922</a> <em class="jxr_javadoccomment"> * Converts the specified bytes into a readable string.</em>
-<a class="jxr_linenumber" name="L5923" href="#L5923">5923</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5924" href="#L5924">5924</a> <em class="jxr_javadoccomment"> * @param b The number to convert to hex.</em>
-<a class="jxr_linenumber" name="L5925" href="#L5925">5925</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[2]</code> containing the specified characters.</em>
-<a class="jxr_linenumber" name="L5926" href="#L5926">5926</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5927" href="#L5927">5927</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toReadableBytes(byte[] b) {
-<a class="jxr_linenumber" name="L5928" href="#L5928">5928</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L5929" href="#L5929">5929</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> b2 : b)
-<a class="jxr_linenumber" name="L5930" href="#L5930">5930</a> sb.append((b2 < ' ' || b2 > 'z') ? String.format(<span class="jxr_string">"[%02X]"</span>, b2) : (<strong class="jxr_keyword">char</strong>)b2 + <span class="jxr_string">" "</span>);
-<a class="jxr_linenumber" name="L5931" href="#L5931">5931</a> sb.append(<span class="jxr_string">"\n"</span>);
-<a class="jxr_linenumber" name="L5932" href="#L5932">5932</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> b2 : b)
-<a class="jxr_linenumber" name="L5933" href="#L5933">5933</a> sb.append(String.format(<span class="jxr_string">"[%02X]"</span>, b2));
-<a class="jxr_linenumber" name="L5934" href="#L5934">5934</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L5935" href="#L5935">5935</a> }
-<a class="jxr_linenumber" name="L5936" href="#L5936">5936</a>
-<a class="jxr_linenumber" name="L5937" href="#L5937">5937</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5938" href="#L5938">5938</a> <em class="jxr_javadoccomment"> * Same as {@link #toHex(byte[])} but puts spaces between the byte strings.</em>
-<a class="jxr_linenumber" name="L5939" href="#L5939">5939</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5940" href="#L5940">5940</a> <em class="jxr_javadoccomment"> * @param bytes The bytes to convert to hexadecimal.</em>
-<a class="jxr_linenumber" name="L5941" href="#L5941">5941</a> <em class="jxr_javadoccomment"> * @return A new string consisting of hexadecimal characters.</em>
-<a class="jxr_linenumber" name="L5942" href="#L5942">5942</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5943" href="#L5943">5943</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toSpacedHex(byte[] bytes) {
-<a class="jxr_linenumber" name="L5944" href="#L5944">5944</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(bytes.length * 3);
-<a class="jxr_linenumber" name="L5945" href="#L5945">5945</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 0; j < bytes.length; j++) {
-<a class="jxr_linenumber" name="L5946" href="#L5946">5946</a> <strong class="jxr_keyword">if</strong> (j > 0)
-<a class="jxr_linenumber" name="L5947" href="#L5947">5947</a> sb.append(' ');
-<a class="jxr_linenumber" name="L5948" href="#L5948">5948</a> <strong class="jxr_keyword">var</strong> v = bytes[j] & 0xFF;
-<a class="jxr_linenumber" name="L5949" href="#L5949">5949</a> sb.append(HEX[v >>> 4]).append(HEX[v & 0x0F]);
-<a class="jxr_linenumber" name="L5950" href="#L5950">5950</a> }
-<a class="jxr_linenumber" name="L5951" href="#L5951">5951</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L5952" href="#L5952">5952</a> }
-<a class="jxr_linenumber" name="L5953" href="#L5953">5953</a>
-<a class="jxr_linenumber" name="L5954" href="#L5954">5954</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5955" href="#L5955">5955</a> <em class="jxr_javadoccomment"> * Converts the specified object to a URI.</em>
-<a class="jxr_linenumber" name="L5956" href="#L5956">5956</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5957" href="#L5957">5957</a> <em class="jxr_javadoccomment"> * @param o The object to convert to a URI.</em>
-<a class="jxr_linenumber" name="L5958" href="#L5958">5958</a> <em class="jxr_javadoccomment"> * @return A new URI, or the same object if the object was already a URI, or</em>
-<a class="jxr_linenumber" name="L5959" href="#L5959">5959</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5960" href="#L5960">5960</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> URI toURI(Object o) {
-<a class="jxr_linenumber" name="L5961" href="#L5961">5961</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong> || o instanceof URI)
-<a class="jxr_linenumber" name="L5962" href="#L5962">5962</a> <strong class="jxr_keyword">return</strong> (URI)o;
-<a class="jxr_linenumber" name="L5963" href="#L5963">5963</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L5964" href="#L5964">5964</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> URI(o.toString());
-<a class="jxr_linenumber" name="L5965" href="#L5965">5965</a> } <strong class="jxr_keyword">catch</strong> (URISyntaxException e) {
-<a class="jxr_linenumber" name="L5966" href="#L5966">5966</a> <strong class="jxr_keyword">throw</strong> toRex(e);
-<a class="jxr_linenumber" name="L5967" href="#L5967">5967</a> }
-<a class="jxr_linenumber" name="L5968" href="#L5968">5968</a> }
-<a class="jxr_linenumber" name="L5969" href="#L5969">5969</a>
-<a class="jxr_linenumber" name="L5970" href="#L5970">5970</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5971" href="#L5971">5971</a> <em class="jxr_javadoccomment"> * Converts the specified byte array to a UTF-8 string.</em>
-<a class="jxr_linenumber" name="L5972" href="#L5972">5972</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5973" href="#L5973">5973</a> <em class="jxr_javadoccomment"> * @param b The byte array to convert.</em>
-<a class="jxr_linenumber" name="L5974" href="#L5974">5974</a> <em class="jxr_javadoccomment"> * @return The UTF-8 string representation, or <jk>null</jk> if the array is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5975" href="#L5975">5975</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5976" href="#L5976">5976</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toUtf8(byte[] b) {
-<a class="jxr_linenumber" name="L5977" href="#L5977">5977</a> <strong class="jxr_keyword">return</strong> b == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : <strong class="jxr_keyword">new</strong> String(b, UTF8);
-<a class="jxr_linenumber" name="L5978" href="#L5978">5978</a> }
-<a class="jxr_linenumber" name="L5979" href="#L5979">5979</a>
-<a class="jxr_linenumber" name="L5980" href="#L5980">5980</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5981" href="#L5981">5981</a> <em class="jxr_javadoccomment"> * Converts the contents of the specified input stream to a UTF-8 string.</em>
-<a class="jxr_linenumber" name="L5982" href="#L5982">5982</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5983" href="#L5983">5983</a> <em class="jxr_javadoccomment"> * @param is The input stream to convert.</em>
-<a class="jxr_linenumber" name="L5984" href="#L5984">5984</a> <em class="jxr_javadoccomment"> * @return The UTF-8 string representation of the input stream contents, or <jk>null</jk> if the stream is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5985" href="#L5985">5985</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5986" href="#L5986">5986</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toUtf8(InputStream is) {
-<a class="jxr_linenumber" name="L5987" href="#L5987">5987</a> <strong class="jxr_keyword">return</strong> safe(() -> is == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : <strong class="jxr_keyword">new</strong> String(readBytes(is), UTF8));
-<a class="jxr_linenumber" name="L5988" href="#L5988">5988</a> }
-<a class="jxr_linenumber" name="L5989" href="#L5989">5989</a>
-<a class="jxr_linenumber" name="L5990" href="#L5990">5990</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5991" href="#L5991">5991</a> <em class="jxr_javadoccomment"> * Same as {@link String#trim()} but prevents <c>NullPointerExceptions</c>.</em>
-<a class="jxr_linenumber" name="L5992" href="#L5992">5992</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5993" href="#L5993">5993</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
-<a class="jxr_linenumber" name="L5994" href="#L5994">5994</a> <em class="jxr_javadoccomment"> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5995" href="#L5995">5995</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5996" href="#L5996">5996</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trim(String s) {
-<a class="jxr_linenumber" name="L5997" href="#L5997">5997</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5998" href="#L5998">5998</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5999" href="#L5999">5999</a> <strong class="jxr_keyword">return</strong> s.trim();
-<a class="jxr_linenumber" name="L6000" href="#L6000">6000</a> }
-<a class="jxr_linenumber" name="L6001" href="#L6001">6001</a>
-<a class="jxr_linenumber" name="L6002" href="#L6002">6002</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6003" href="#L6003">6003</a> <em class="jxr_javadoccomment"> * Trims whitespace characters from the end of the specified string.</em>
-<a class="jxr_linenumber" name="L6004" href="#L6004">6004</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6005" href="#L6005">6005</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
-<a class="jxr_linenumber" name="L6006" href="#L6006">6006</a> <em class="jxr_javadoccomment"> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6007" href="#L6007">6007</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6008" href="#L6008">6008</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimEnd(String s) {
-<a class="jxr_linenumber" name="L6009" href="#L6009">6009</a> <strong class="jxr_keyword">if</strong> (nn(s))
-<a class="jxr_linenumber" name="L6010" href="#L6010">6010</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && isWhitespace(s.charAt(s.length() - 1)))
-<a class="jxr_linenumber" name="L6011" href="#L6011">6011</a> s = s.substring(0, s.length() - 1);
-<a class="jxr_linenumber" name="L6012" href="#L6012">6012</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6013" href="#L6013">6013</a> }
-<a class="jxr_linenumber" name="L6014" href="#L6014">6014</a>
-<a class="jxr_linenumber" name="L6015" href="#L6015">6015</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6016" href="#L6016">6016</a> <em class="jxr_javadoccomment"> * Trims <js>'/'</js> characters from the beginning of the specified string.</em>
-<a class="jxr_linenumber" name="L6017" href="#L6017">6017</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6018" href="#L6018">6018</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
-<a class="jxr_linenumber" name="L6019" href="#L6019">6019</a> <em class="jxr_javadoccomment"> * @return A new trimmed string, or the same string if no trimming was necessary.</em>
-<a class="jxr_linenumber" name="L6020" href="#L6020">6020</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6021" href="#L6021">6021</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimLeadingSlashes(String s) {
-<a class="jxr_linenumber" name="L6022" href="#L6022">6022</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6023" href="#L6023">6023</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6024" href="#L6024">6024</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && s.charAt(0) == '/')
-<a class="jxr_linenumber" name="L6025" href="#L6025">6025</a> s = s.substring(1);
-<a class="jxr_linenumber" name="L6026" href="#L6026">6026</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6027" href="#L6027">6027</a> }
-<a class="jxr_linenumber" name="L6028" href="#L6028">6028</a>
-<a class="jxr_linenumber" name="L6029" href="#L6029">6029</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6030" href="#L6030">6030</a> <em class="jxr_javadoccomment"> * Trims <js>'/'</js> characters from both the start and end of the specified string.</em>
-<a class="jxr_linenumber" name="L6031" href="#L6031">6031</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6032" href="#L6032">6032</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
-<a class="jxr_linenumber" name="L6033" href="#L6033">6033</a> <em class="jxr_javadoccomment"> * @return A new trimmed string, or the same string if no trimming was necessary.</em>
-<a class="jxr_linenumber" name="L6034" href="#L6034">6034</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6035" href="#L6035">6035</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimSlashes(String s) {
-<a class="jxr_linenumber" name="L6036" href="#L6036">6036</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6037" href="#L6037">6037</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6038" href="#L6038">6038</a> <strong class="jxr_keyword">if</strong> (s.isEmpty())
-<a class="jxr_linenumber" name="L6039" href="#L6039">6039</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6040" href="#L6040">6040</a> <strong class="jxr_keyword">while</strong> (endsWith(s, '/'))
-<a class="jxr_linenumber" name="L6041" href="#L6041">6041</a> s = s.substring(0, s.length() - 1);
-<a class="jxr_linenumber" name="L6042" href="#L6042">6042</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && s.charAt(0) == '/') <em class="jxr_comment">// NOSONAR - NPE not possible here.</em>
-<a class="jxr_linenumber" name="L6043" href="#L6043">6043</a> s = s.substring(1);
-<a class="jxr_linenumber" name="L6044" href="#L6044">6044</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6045" href="#L6045">6045</a> }
-<a class="jxr_linenumber" name="L6046" href="#L6046">6046</a>
-<a class="jxr_linenumber" name="L6047" href="#L6047">6047</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6048" href="#L6048">6048</a> <em class="jxr_javadoccomment"> * Trims <js>'/'</js> and space characters from both the start and end of the specified string.</em>
-<a class="jxr_linenumber" name="L6049" href="#L6049">6049</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6050" href="#L6050">6050</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
-<a class="jxr_linenumber" name="L6051" href="#L6051">6051</a> <em class="jxr_javadoccomment"> * @return A new trimmed string, or the same string if no trimming was necessary.</em>
-<a class="jxr_linenumber" name="L6052" href="#L6052">6052</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6053" href="#L6053">6053</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimSlashesAndSpaces(String s) {
-<a class="jxr_linenumber" name="L6054" href="#L6054">6054</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6055" href="#L6055">6055</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6056" href="#L6056">6056</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && (s.charAt(s.length() - 1) == '/' || isWhitespace(s.charAt(s.length() - 1))))
-<a class="jxr_linenumber" name="L6057" href="#L6057">6057</a> s = s.substring(0, s.length() - 1);
-<a class="jxr_linenumber" name="L6058" href="#L6058">6058</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && (s.charAt(0) == '/' || isWhitespace(s.charAt(0))))
-<a class="jxr_linenumber" name="L6059" href="#L6059">6059</a> s = s.substring(1);
-<a class="jxr_linenumber" name="L6060" href="#L6060">6060</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6061" href="#L6061">6061</a> }
-<a class="jxr_linenumber" name="L6062" href="#L6062">6062</a>
-<a class="jxr_linenumber" name="L6063" href="#L6063">6063</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6064" href="#L6064">6064</a> <em class="jxr_javadoccomment"> * Trims whitespace characters from the beginning of the specified string.</em>
-<a class="jxr_linenumber" name="L6065" href="#L6065">6065</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6066" href="#L6066">6066</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
-<a class="jxr_linenumber" name="L6067" href="#L6067">6067</a> <em class="jxr_javadoccomment"> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6068" href="#L6068">6068</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6069" href="#L6069">6069</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimStart(String s) {
-<a class="jxr_linenumber" name="L6070" href="#L6070">6070</a> <strong class="jxr_keyword">if</strong> (nn(s))
-<a class="jxr_linenumber" name="L6071" href="#L6071">6071</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && isWhitespace(s.charAt(0)))
-<a class="jxr_linenumber" name="L6072" href="#L6072">6072</a> s = s.substring(1);
-<a class="jxr_linenumber" name="L6073" href="#L6073">6073</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6074" href="#L6074">6074</a> }
-<a class="jxr_linenumber" name="L6075" href="#L6075">6075</a>
-<a class="jxr_linenumber" name="L6076" href="#L6076">6076</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6077" href="#L6077">6077</a> <em class="jxr_javadoccomment"> * Trims <js>'/'</js> characters from the end of the specified string.</em>
-<a class="jxr_linenumber" name="L6078" href="#L6078">6078</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6079" href="#L6079">6079</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
-<a class="jxr_linenumber" name="L6080" href="#L6080">6080</a> <em class="jxr_javadoccomment"> * @return A new trimmed string, or the same string if no trimming was necessary.</em>
-<a class="jxr_linenumber" name="L6081" href="#L6081">6081</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6082" href="#L6082">6082</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimTrailingSlashes(String s) {
-<a class="jxr_linenumber" name="L6083" href="#L6083">6083</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6084" href="#L6084">6084</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6085" href="#L6085">6085</a> <strong class="jxr_keyword">while</strong> (endsWith(s, '/'))
-<a class="jxr_linenumber" name="L6086" href="#L6086">6086</a> s = s.substring(0, s.length() - 1);
-<a class="jxr_linenumber" name="L6087" href="#L6087">6087</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6088" href="#L6088">6088</a> }
-<a class="jxr_linenumber" name="L6089" href="#L6089">6089</a>
-<a class="jxr_linenumber" name="L6090" href="#L6090">6090</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6091" href="#L6091">6091</a> <em class="jxr_javadoccomment"> * Uncapitalizes the first character of a string.</em>
-<a class="jxr_linenumber" name="L6092" href="#L6092">6092</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6093" href="#L6093">6093</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L6094" href="#L6094">6094</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L6095" href="#L6095">6095</a> <em class="jxr_javadoccomment"> * uncapitalize(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L6096" href="#L6096">6096</a> <em class="jxr_javadoccomment"> * uncapitalize(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L6097" href="#L6097">6097</a> <em class="jxr_javadoccomment"> * uncapitalize(<js>"Hello"</js>); <jc>// "hello"</jc></em>
-<a class="jxr_linenumber" name="L6098" href="#L6098">6098</a> <em class="jxr_javadoccomment"> * uncapitalize(<js>"hello"</js>); <jc>// "hello"</jc></em>
-<a class="jxr_linenumber" name="L6099" href="#L6099">6099</a> <em class="jxr_javadoccomment"> * uncapitalize(<js>"HELLO"</js>); <jc>// "hELLO"</jc></em>
-<a class="jxr_linenumber" name="L6100" href="#L6100">6100</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L6101" href="#L6101">6101</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6102" href="#L6102">6102</a> <em class="jxr_javadoccomment"> * @param str The string to uncapitalize.</em>
-<a class="jxr_linenumber" name="L6103" href="#L6103">6103</a> <em class="jxr_javadoccomment"> * @return The string with the first character uncapitalized, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6104" href="#L6104">6104</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6105" href="#L6105">6105</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String uncapitalize(String str) {
-<a class="jxr_linenumber" name="L6106" href="#L6106">6106</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L6107" href="#L6107">6107</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L6108" href="#L6108">6108</a> <strong class="jxr_keyword">return</strong> Character.toLowerCase(str.charAt(0)) + str.substring(1);
-<a class="jxr_linenumber" name="L6109" href="#L6109">6109</a> }
-<a class="jxr_linenumber" name="L6110" href="#L6110">6110</a>
-<a class="jxr_linenumber" name="L6111" href="#L6111">6111</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6112" href="#L6112">6112</a> <em class="jxr_javadoccomment"> * Helper method to split a string into words.</em>
-<a class="jxr_linenumber" name="L6113" href="#L6113">6113</a> <em class="jxr_javadoccomment"> * Detects word boundaries from separators (spaces, underscores, hyphens) and case changes.</em>
-<a class="jxr_linenumber" name="L6114" href="#L6114">6114</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6115" href="#L6115">6115</a> <em class="jxr_javadoccomment"> * @param str The string to split.</em>
-<a class="jxr_linenumber" name="L6116" href="#L6116">6116</a> <em class="jxr_javadoccomment"> * @return A list of words, or empty list if input is null or empty.</em>
-<a class="jxr_linenumber" name="L6117" href="#L6117">6117</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6118" href="#L6118">6118</a> <strong class="jxr_keyword">static</strong> List<String> splitWords(String str) {
-<a class="jxr_linenumber" name="L6119" href="#L6119">6119</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || isEmpty(str))
-<a class="jxr_linenumber" name="L6120" href="#L6120">6120</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L6121" href="#L6121">6121</a>
-<a class="jxr_linenumber" name="L6122" href="#L6122">6122</a> <strong class="jxr_keyword">var</strong> words = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L6123" href="#L6123">6123</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L6124" href="#L6124">6124</a> <strong class="jxr_keyword">var</strong> wasLowerCase = false;
-<a class="jxr_linenumber" name="L6125" href="#L6125">6125</a> <strong class="jxr_keyword">var</strong> wasUpperCase = false;
-<a class="jxr_linenumber" name="L6126" href="#L6126">6126</a> <strong class="jxr_keyword">var</strong> consecutiveUpperCount = 0;
-<a class="jxr_linenumber" name="L6127" href="#L6127">6127</a>
-<a class="jxr_linenumber" name="L6128" href="#L6128">6128</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L6129" href="#L6129">6129</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
-<a class="jxr_linenumber" name="L6130" href="#L6130">6130</a> <strong class="jxr_keyword">var</strong> isSeparator = (c == ' ' || c == '_' || c == '-' || c == '\t');
-<a class="jxr_linenumber" name="L6131" href="#L6131">6131</a> <strong class="jxr_keyword">var</strong> isUpperCase = Character.isUpperCase(c);
-<a class="jxr_linenumber" name="L6132" href="#L6132">6132</a> <strong class="jxr_keyword">var</strong> isLowerCase = Character.isLowerCase(c);
-<a class="jxr_linenumber" name="L6133" href="#L6133">6133</a> <strong class="jxr_keyword">var</strong> isLetter = Character.isLetter(c);
-<a class="jxr_linenumber" name="L6134" href="#L6134">6134</a>
-<a class="jxr_linenumber" name="L6135" href="#L6135">6135</a> <strong class="jxr_keyword">if</strong> (isSeparator) {
-<a class="jxr_linenumber" name="L6136" href="#L6136">6136</a> <strong class="jxr_keyword">if</strong> (sb.length() > 0) {
-<a class="jxr_linenumber" name="L6137" href="#L6137">6137</a> words.add(sb.toString());
-<a class="jxr_linenumber" name="L6138" href="#L6138">6138</a> sb.setLength(0);
-<a class="jxr_linenumber" name="L6139" href="#L6139">6139</a> }
-<a class="jxr_linenumber" name="L6140" href="#L6140">6140</a> wasLowerCase = false;
-<a class="jxr_linenumber" name="L6141" href="#L6141">6141</a> wasUpperCase = false;
-<a class="jxr_linenumber" name="L6142" href="#L6142">6142</a> consecutiveUpperCount = 0;
-<a class="jxr_linenumber" name="L6143" href="#L6143">6143</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (isLetter) {
-<a class="jxr_linenumber" name="L6144" href="#L6144">6144</a> <em class="jxr_comment">// Detect word boundary:</em>
-<a class="jxr_linenumber" name="L6145" href="#L6145">6145</a> <em class="jxr_comment">// 1. Uppercase after lowercase (e.g., "helloWorld" → "hello", "World")</em>
-<a class="jxr_linenumber" name="L6146" href="#L6146">6146</a> <em class="jxr_comment">// 2. Uppercase after consecutive uppercase when next is lowercase (e.g., "XMLHttp" → "XML", "Http")</em>
-<a class="jxr_linenumber" name="L6147" href="#L6147">6147</a> <em class="jxr_comment">// 3. Lowercase after 2+ consecutive uppercase (e.g., "XMLHttp" → "XML", "Http")</em>
-<a class="jxr_linenumber" name="L6148" href="#L6148">6148</a> <strong class="jxr_keyword">if</strong> (sb.length() > 0) {
-<a class="jxr_linenumber" name="L6149" href="#L6149">6149</a> <strong class="jxr_keyword">if</strong> (isUpperCase && wasLowerCase) {
-<a class="jxr_linenumber" name="L6150" href="#L6150">6150</a> <em class="jxr_comment">// Case 1: uppercase after lowercase (e.g., "helloWorld" → "hello", "World")</em>
-<a class="jxr_linenumber" name="L6151" href="#L6151">6151</a> words.add(sb.toString());
-<a class="jxr_linenumber" name="L6152" href="#L6152">6152</a> sb.setLength(0);
-<a class="jxr_linenumber" name="L6153" href="#L6153">6153</a> consecutiveUpperCount = 0;
-<a class="jxr_linenumber" name="L6154" href="#L6154">6154</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (isUpperCase && wasUpperCase && consecutiveUpperCount >= 2) {
-<a class="jxr_linenumber" name="L6155" href="#L6155">6155</a> <em class="jxr_comment">// Case 2: uppercase after uppercase - check if this starts a new word</em>
-<a class="jxr_linenumber" name="L6156" href="#L6156">6156</a> <em class="jxr_comment">// Look ahead to see if next character is lowercase</em>
-<a class="jxr_linenumber" name="L6157" href="#L6157">6157</a> <em class="jxr_comment">// This handles "XMLHttp" where 'H' starts "Http"</em>
-<a class="jxr_linenumber" name="L6158" href="#L6158">6158</a> <em class="jxr_comment">// We need at least 2 consecutive uppercase letters before this one to split</em>
-<a class="jxr_linenumber" name="L6159" href="#L6159">6159</a> <strong class="jxr_keyword">if</strong> (i + 1 < str.length()) {
-<a class="jxr_linenumber" name="L6160" href="#L6160">6160</a> <strong class="jxr_keyword">var</strong> nextChar = str.charAt(i + 1);
-<a class="jxr_linenumber" name="L6161" href="#L6161">6161</a> <strong class="jxr_keyword">if</strong> (Character.isLowerCase(nextChar)) {
-<a class="jxr_linenumber" name="L6162" href="#L6162">6162</a> <em class="jxr_comment">// This uppercase starts a new word, split before it</em>
-<a class="jxr_linenumber" name="L6163" href="#L6163">6163</a> words.add(sb.toString());
-<a class="jxr_linenumber" name="L6164" href="#L6164">6164</a> sb.setLength(0);
-<a class="jxr_linenumber" name="L6165" href="#L6165">6165</a> consecutiveUpperCount = 0;
-<a class="jxr_linenumber" name="L6166" href="#L6166">6166</a> }
-<a class="jxr_linenumber" name="L6167" href="#L6167">6167</a> }
-<a class="jxr_linenumber" name="L6168" href="#L6168">6168</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (isLowerCase && wasUpperCase && consecutiveUpperCount >= 2) {
-<a class="jxr_linenumber" name="L6169" href="#L6169">6169</a> <em class="jxr_comment">// Case 3: lowercase after 2+ consecutive uppercase</em>
-<a class="jxr_linenumber" name="L6170" href="#L6170">6170</a> <em class="jxr_comment">// Split all but the last uppercase (e.g., "XMLH" → "XML" + "H")</em>
-<a class="jxr_linenumber" name="L6171" href="#L6171">6171</a> <strong class="jxr_keyword">var</strong> splitPoint = sb.length() - 1;
-<a class="jxr_linenumber" name="L6172" href="#L6172">6172</a> words.add(sb.substring(0, splitPoint));
-<a class="jxr_linenumber" name="L6173" href="#L6173">6173</a> sb.delete(0, splitPoint);
-<a class="jxr_linenumber" name="L6174" href="#L6174">6174</a> consecutiveUpperCount = 0;
-<a class="jxr_linenumber" name="L6175" href="#L6175">6175</a> }
-<a class="jxr_linenumber" name="L6176" href="#L6176">6176</a> }
-<a class="jxr_linenumber" name="L6177" href="#L6177">6177</a> sb.append(c);
-<a class="jxr_linenumber" name="L6178" href="#L6178">6178</a> <em class="jxr_comment">// Update state AFTER appending</em>
-<a class="jxr_linenumber" name="L6179" href="#L6179">6179</a> wasLowerCase = isLowerCase;
-<a class="jxr_linenumber" name="L6180" href="#L6180">6180</a> wasUpperCase = isUpperCase;
-<a class="jxr_linenumber" name="L6181" href="#L6181">6181</a> <strong class="jxr_keyword">if</strong> (isUpperCase) {
-<a class="jxr_linenumber" name="L6182" href="#L6182">6182</a> consecutiveUpperCount++;
-<a class="jxr_linenumber" name="L6183" href="#L6183">6183</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L6184" href="#L6184">6184</a> consecutiveUpperCount = 0;
-<a class="jxr_linenumber" name="L6185" href="#L6185">6185</a> }
-<a class="jxr_linenumber" name="L6186" href="#L6186">6186</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L6187" href="#L6187">6187</a> <em class="jxr_comment">// Non-letter characters (digits, etc.) - treat as part of current word</em>
-<a class="jxr_linenumber" name="L6188" href="#L6188">6188</a> sb.append(c);
-<a class="jxr_linenumber" name="L6189" href="#L6189">6189</a> wasLowerCase = false;
-<a class="jxr_linenumber" name="L6190" href="#L6190">6190</a> wasUpperCase = false;
-<a class="jxr_linenumber" name="L6191" href="#L6191">6191</a> consecutiveUpperCount = 0;
-<a class="jxr_linenumber" name="L6192" href="#L6192">6192</a> }
-<a class="jxr_linenumber" name="L6193" href="#L6193">6193</a> }
-<a class="jxr_linenumber" name="L6194" href="#L6194">6194</a>
-<a class="jxr_linenumber" name="L6195" href="#L6195">6195</a> <strong class="jxr_keyword">if</strong> (sb.length() > 0)
-<a class="jxr_linenumber" name="L6196" href="#L6196">6196</a> words.add(sb.toString());
-<a class="jxr_linenumber" name="L6197" href="#L6197">6197</a>
-<a class="jxr_linenumber" name="L6198" href="#L6198">6198</a> <strong class="jxr_keyword">return</strong> words;
-<a class="jxr_linenumber" name="L6199" href="#L6199">6199</a> }
-<a class="jxr_linenumber" name="L6200" href="#L6200">6200</a>
-<a class="jxr_linenumber" name="L6201" href="#L6201">6201</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6202" href="#L6202">6202</a> <em class="jxr_javadoccomment"> * Converts a string to camelCase format.</em>
-<a class="jxr_linenumber" name="L6203" href="#L6203">6203</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6204" href="#L6204">6204</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L6205" href="#L6205">6205</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
-<a class="jxr_linenumber" name="L6206" href="#L6206">6206</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L6207" href="#L6207">6207</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L6208" href="#L6208">6208</a> <em class="jxr_javadoccomment"> * <li>Underscore-separated: "hello_world" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L6209" href="#L6209">6209</a> <em class="jxr_javadoccomment"> * <li>Hyphen-separated: "hello-world" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L6210" href="#L6210">6210</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L6211" href="#L6211">6211</a> <em class="jxr_javadoccomment"> * <li>Already camelCase: "helloWorld" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L6212" href="#L6212">6212</a> <em class="jxr_javadoccomment"> * <li>Mixed case: "Hello_World-Test" → "helloWorldTest"</li></em>
-<a class="jxr_linenumber" name="L6213" href="#L6213">6213</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L6214" href="#L6214">6214</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6215" href="#L6215">6215</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L6216" href="#L6216">6216</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L6217" href="#L6217">6217</a> <em class="jxr_javadoccomment"> * camelCase(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L6218" href="#L6218">6218</a> <em class="jxr_javadoccomment"> * camelCase(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L6219" href="#L6219">6219</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello world"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6220" href="#L6220">6220</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello_world"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6221" href="#L6221">6221</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello-world"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6222" href="#L6222">6222</a> <em class="jxr_javadoccomment"> * camelCase(<js>"HelloWorld"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6223" href="#L6223">6223</a> <em class="jxr_javadoccomment"> * camelCase(<js>"helloWorld"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6224" href="#L6224">6224</a> <em class="jxr_javadoccomment"> * camelCase(<js>" hello world "</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6225" href="#L6225">6225</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L6226" href="#L6226">6226</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6227" href="#L6227">6227</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
-<a class="jxr_linenumber" name="L6228" href="#L6228">6228</a> <em class="jxr_javadoccomment"> * @return The camelCase string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6229" href="#L6229">6229</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6230" href="#L6230">6230</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String camelCase(String str) {
-<a class="jxr_linenumber" name="L6231" href="#L6231">6231</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6232" href="#L6232">6232</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6233" href="#L6233">6233</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L6234" href="#L6234">6234</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L6235" href="#L6235">6235</a>
-<a class="jxr_linenumber" name="L6236" href="#L6236">6236</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
-<a class="jxr_linenumber" name="L6237" href="#L6237">6237</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
-<a class="jxr_linenumber" name="L6238" href="#L6238">6238</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L5657" href="#L5657">5657</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5658" href="#L5658">5658</a> <em class="jxr_javadoccomment"> * Double Metaphone is an improved version of Metaphone that returns two codes:</em>
+<a class="jxr_linenumber" name="L5659" href="#L5659">5659</a> <em class="jxr_javadoccomment"> * a primary code and an alternate code. This handles more edge cases and variations.</em>
+<a class="jxr_linenumber" name="L5660" href="#L5660">5660</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5661" href="#L5661">5661</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5662" href="#L5662">5662</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5663" href="#L5663">5663</a> <em class="jxr_javadoccomment"> * doubleMetaphone(<js>"Smith"</js>); <jc>// "SM0"</jc></em>
+<a class="jxr_linenumber" name="L5664" href="#L5664">5664</a> <em class="jxr_javadoccomment"> * doubleMetaphone(<js>"Schmidt"</js>); <jc>// "XMT"</jc></em>
+<a class="jxr_linenumber" name="L5665" href="#L5665">5665</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5666" href="#L5666">5666</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5667" href="#L5667">5667</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Double Metaphone code for. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5668" href="#L5668">5668</a> <em class="jxr_javadoccomment"> * @return An array with two elements: [primary code, alternate code]. Returns <jk>null</jk> if input is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L5669" href="#L5669">5669</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5670" href="#L5670">5670</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] doubleMetaphone(String str) {
+<a class="jxr_linenumber" name="L5671" href="#L5671">5671</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L5672" href="#L5672">5672</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5673" href="#L5673">5673</a>
+<a class="jxr_linenumber" name="L5674" href="#L5674">5674</a> <em class="jxr_comment">// For simplicity, return the same code for both primary and alternate</em>
+<a class="jxr_linenumber" name="L5675" href="#L5675">5675</a> <em class="jxr_comment">// A full Double Metaphone implementation would be much more complex</em>
+<a class="jxr_linenumber" name="L5676" href="#L5676">5676</a> <strong class="jxr_keyword">var</strong> primary = metaphone(str);
+<a class="jxr_linenumber" name="L5677" href="#L5677">5677</a> <strong class="jxr_keyword">if</strong> (primary == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5678" href="#L5678">5678</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5679" href="#L5679">5679</a>
+<a class="jxr_linenumber" name="L5680" href="#L5680">5680</a> <em class="jxr_comment">// Generate alternate code (simplified - full implementation would have different rules)</em>
+<a class="jxr_linenumber" name="L5681" href="#L5681">5681</a> <strong class="jxr_keyword">var</strong> alternate = primary;
+<a class="jxr_linenumber" name="L5682" href="#L5682">5682</a>
+<a class="jxr_linenumber" name="L5683" href="#L5683">5683</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[] { primary, alternate };
+<a class="jxr_linenumber" name="L5684" href="#L5684">5684</a> }
+<a class="jxr_linenumber" name="L5685" href="#L5685">5685</a>
+<a class="jxr_linenumber" name="L5686" href="#L5686">5686</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5687" href="#L5687">5687</a> <em class="jxr_javadoccomment"> * Normalizes Unicode characters in a string.</em>
+<a class="jxr_linenumber" name="L5688" href="#L5688">5688</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5689" href="#L5689">5689</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5690" href="#L5690">5690</a> <em class="jxr_javadoccomment"> * Uses Unicode normalization form NFD (Canonical Decomposition).</em>
+<a class="jxr_linenumber" name="L5691" href="#L5691">5691</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5692" href="#L5692">5692</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5693" href="#L5693">5693</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5694" href="#L5694">5694</a> <em class="jxr_javadoccomment"> * normalizeUnicode(<js>"café"</js>);</em>
+<a class="jxr_linenumber" name="L5695" href="#L5695">5695</a> <em class="jxr_javadoccomment"> * <jc>// Normalized form</jc></em>
+<a class="jxr_linenumber" name="L5696" href="#L5696">5696</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5697" href="#L5697">5697</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5698" href="#L5698">5698</a> <em class="jxr_javadoccomment"> * @param str The string to normalize. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5699" href="#L5699">5699</a> <em class="jxr_javadoccomment"> * @return The normalized string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5700" href="#L5700">5700</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5701" href="#L5701">5701</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String normalizeUnicode(String str) {
+<a class="jxr_linenumber" name="L5702" href="#L5702">5702</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5703" href="#L5703">5703</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5704" href="#L5704">5704</a> <strong class="jxr_keyword">return</strong> Normalizer.normalize(str, Normalizer.Form.NFD);
+<a class="jxr_linenumber" name="L5705" href="#L5705">5705</a> }
+<a class="jxr_linenumber" name="L5706" href="#L5706">5706</a>
+<a class="jxr_linenumber" name="L5707" href="#L5707">5707</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5708" href="#L5708">5708</a> <em class="jxr_javadoccomment"> * Removes diacritical marks (accents) from characters in a string.</em>
+<a class="jxr_linenumber" name="L5709" href="#L5709">5709</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5710" href="#L5710">5710</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L5711" href="#L5711">5711</a> <em class="jxr_javadoccomment"> * Normalizes the string to NFD form and removes combining diacritical marks.</em>
+<a class="jxr_linenumber" name="L5712" href="#L5712">5712</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5713" href="#L5713">5713</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5714" href="#L5714">5714</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5715" href="#L5715">5715</a> <em class="jxr_javadoccomment"> * removeAccents(<js>"café"</js>); <jc>// "cafe"</jc></em>
+<a class="jxr_linenumber" name="L5716" href="#L5716">5716</a> <em class="jxr_javadoccomment"> * removeAccents(<js>"naïve"</js>); <jc>// "naive"</jc></em>
+<a class="jxr_linenumber" name="L5717" href="#L5717">5717</a> <em class="jxr_javadoccomment"> * removeAccents(<js>"résumé"</js>); <jc>// "resume"</jc></em>
+<a class="jxr_linenumber" name="L5718" href="#L5718">5718</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5719" href="#L5719">5719</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5720" href="#L5720">5720</a> <em class="jxr_javadoccomment"> * @param str The string to remove accents from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5721" href="#L5721">5721</a> <em class="jxr_javadoccomment"> * @return The string with accents removed, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5722" href="#L5722">5722</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5723" href="#L5723">5723</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String removeAccents(String str) {
+<a class="jxr_linenumber" name="L5724" href="#L5724">5724</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5725" href="#L5725">5725</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5726" href="#L5726">5726</a>
+<a class="jxr_linenumber" name="L5727" href="#L5727">5727</a> <em class="jxr_comment">// Normalize to NFD (decomposed form)</em>
+<a class="jxr_linenumber" name="L5728" href="#L5728">5728</a> <strong class="jxr_keyword">var</strong> normalized = Normalizer.normalize(str, Normalizer.Form.NFD);
+<a class="jxr_linenumber" name="L5729" href="#L5729">5729</a>
+<a class="jxr_linenumber" name="L5730" href="#L5730">5730</a> <em class="jxr_comment">// Remove combining diacritical marks (Unicode category Mn)</em>
+<a class="jxr_linenumber" name="L5731" href="#L5731">5731</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(normalized.length());
+<a class="jxr_linenumber" name="L5732" href="#L5732">5732</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < normalized.length(); i++) {
+<a class="jxr_linenumber" name="L5733" href="#L5733">5733</a> <strong class="jxr_keyword">var</strong> c = normalized.charAt(i);
+<a class="jxr_linenumber" name="L5734" href="#L5734">5734</a> <strong class="jxr_keyword">var</strong> type = Character.getType(c);
+<a class="jxr_linenumber" name="L5735" href="#L5735">5735</a> <em class="jxr_comment">// Mn = Nonspacing_Mark (combining marks)</em>
+<a class="jxr_linenumber" name="L5736" href="#L5736">5736</a> <strong class="jxr_keyword">if</strong> (type != Character.NON_SPACING_MARK) {
+<a class="jxr_linenumber" name="L5737" href="#L5737">5737</a> sb.append(c);
+<a class="jxr_linenumber" name="L5738" href="#L5738">5738</a> }
+<a class="jxr_linenumber" name="L5739" href="#L5739">5739</a> }
+<a class="jxr_linenumber" name="L5740" href="#L5740">5740</a>
+<a class="jxr_linenumber" name="L5741" href="#L5741">5741</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L5742" href="#L5742">5742</a> }
+<a class="jxr_linenumber" name="L5743" href="#L5743">5743</a>
+<a class="jxr_linenumber" name="L5744" href="#L5744">5744</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5745" href="#L5745">5745</a> <em class="jxr_javadoccomment"> * Swaps the case of all characters in a string.</em>
+<a class="jxr_linenumber" name="L5746" href="#L5746">5746</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5747" href="#L5747">5747</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L5748" href="#L5748">5748</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L5749" href="#L5749">5749</a> <em class="jxr_javadoccomment"> * swapCase(<js>"Hello World"</js>); <jc>// "hELLO wORLD"</jc></em>
+<a class="jxr_linenumber" name="L5750" href="#L5750">5750</a> <em class="jxr_javadoccomment"> * swapCase(<js>"ABC123xyz"</js>); <jc>// "abc123XYZ"</jc></em>
+<a class="jxr_linenumber" name="L5751" href="#L5751">5751</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L5752" href="#L5752">5752</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5753" href="#L5753">5753</a> <em class="jxr_javadoccomment"> * @param str The string to process.</em>
+<a class="jxr_linenumber" name="L5754" href="#L5754">5754</a> <em class="jxr_javadoccomment"> * @return The string with case swapped, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5755" href="#L5755">5755</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5756" href="#L5756">5756</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String swapCase(String str) {
+<a class="jxr_linenumber" name="L5757" href="#L5757">5757</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5758" href="#L5758">5758</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5759" href="#L5759">5759</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(str.length());
+<a class="jxr_linenumber" name="L5760" href="#L5760">5760</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L5761" href="#L5761">5761</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
+<a class="jxr_linenumber" name="L5762" href="#L5762">5762</a> <strong class="jxr_keyword">if</strong> (Character.isUpperCase(c))
+<a class="jxr_linenumber" name="L5763" href="#L5763">5763</a> sb.append(Character.toLowerCase(c));
+<a class="jxr_linenumber" name="L5764" href="#L5764">5764</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (Character.isLowerCase(c))
+<a class="jxr_linenumber" name="L5765" href="#L5765">5765</a> sb.append(Character.toUpperCase(c));
+<a class="jxr_linenumber" name="L5766" href="#L5766">5766</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L5767" href="#L5767">5767</a> sb.append(c);
+<a class="jxr_linenumber" name="L5768" href="#L5768">5768</a> }
+<a class="jxr_linenumber" name="L5769" href="#L5769">5769</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L5770" href="#L5770">5770</a> }
+<a class="jxr_linenumber" name="L5771" href="#L5771">5771</a>
+<a class="jxr_linenumber" name="L5772" href="#L5772">5772</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5773" href="#L5773">5773</a> <em class="jxr_javadoccomment"> * Converts the specified object to a comma-delimited list.</em>
+<a class="jxr_linenumber" name="L5774" href="#L5774">5774</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5775" href="#L5775">5775</a> <em class="jxr_javadoccomment"> * @param o The object to convert.</em>
+<a class="jxr_linenumber" name="L5776" href="#L5776">5776</a> <em class="jxr_javadoccomment"> * @return The specified object as a comma-delimited list.</em>
+<a class="jxr_linenumber" name="L5777" href="#L5777">5777</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5778" href="#L5778">5778</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toCdl(Object o) {
+<a class="jxr_linenumber" name="L5779" href="#L5779">5779</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L5780" href="#L5780">5780</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5781" href="#L5781">5781</a> <strong class="jxr_keyword">if</strong> (isArray(o)) {
+<a class="jxr_linenumber" name="L5782" href="#L5782">5782</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L5783" href="#L5783">5783</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0, j = Array.getLength(o); i < j; i++) {
+<a class="jxr_linenumber" name="L5784" href="#L5784">5784</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L5785" href="#L5785">5785</a> sb.append(<span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L5786" href="#L5786">5786</a> sb.append(Array.get(o, i));
+<a class="jxr_linenumber" name="L5787" href="#L5787">5787</a> }
+<a class="jxr_linenumber" name="L5788" href="#L5788">5788</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L5789" href="#L5789">5789</a> }
+<a class="jxr_linenumber" name="L5790" href="#L5790">5790</a> <strong class="jxr_keyword">if</strong> (o instanceof Collection<?> c)
+<a class="jxr_linenumber" name="L5791" href="#L5791">5791</a> <strong class="jxr_keyword">return</strong> join(c, <span class="jxr_string">", "</span>);
+<a class="jxr_linenumber" name="L5792" href="#L5792">5792</a> <strong class="jxr_keyword">return</strong> o.toString();
+<a class="jxr_linenumber" name="L5793" href="#L5793">5793</a> }
+<a class="jxr_linenumber" name="L5794" href="#L5794">5794</a>
+<a class="jxr_linenumber" name="L5795" href="#L5795">5795</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5796" href="#L5796">5796</a> <em class="jxr_javadoccomment"> * Converts the specified byte into a 2 hexadecimal characters.</em>
+<a class="jxr_linenumber" name="L5797" href="#L5797">5797</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5798" href="#L5798">5798</a> <em class="jxr_javadoccomment"> * @param b The number to convert to hex.</em>
+<a class="jxr_linenumber" name="L5799" href="#L5799">5799</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[2]</code> containing the specified characters.</em>
+<a class="jxr_linenumber" name="L5800" href="#L5800">5800</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5801" href="#L5801">5801</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toHex(byte b) {
+<a class="jxr_linenumber" name="L5802" href="#L5802">5802</a> <strong class="jxr_keyword">var</strong> c = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[2];
+<a class="jxr_linenumber" name="L5803" href="#L5803">5803</a> <strong class="jxr_keyword">var</strong> v = b & 0xFF;
+<a class="jxr_linenumber" name="L5804" href="#L5804">5804</a> c[0] = hexArray[v >>> 4];
+<a class="jxr_linenumber" name="L5805" href="#L5805">5805</a> c[1] = hexArray[v & 0x0F];
+<a class="jxr_linenumber" name="L5806" href="#L5806">5806</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String(c);
+<a class="jxr_linenumber" name="L5807" href="#L5807">5807</a> }
+<a class="jxr_linenumber" name="L5808" href="#L5808">5808</a>
+<a class="jxr_linenumber" name="L5809" href="#L5809">5809</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5810" href="#L5810">5810</a> <em class="jxr_javadoccomment"> * Converts a byte array into a simple hexadecimal character string.</em>
+<a class="jxr_linenumber" name="L5811" href="#L5811">5811</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5812" href="#L5812">5812</a> <em class="jxr_javadoccomment"> * @param bytes The bytes to convert to hexadecimal.</em>
+<a class="jxr_linenumber" name="L5813" href="#L5813">5813</a> <em class="jxr_javadoccomment"> * @return A new string consisting of hexadecimal characters.</em>
+<a class="jxr_linenumber" name="L5814" href="#L5814">5814</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5815" href="#L5815">5815</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toHex(byte[] bytes) {
+<a class="jxr_linenumber" name="L5816" href="#L5816">5816</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(bytes.length * 2);
+<a class="jxr_linenumber" name="L5817" href="#L5817">5817</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> element : bytes) {
+<a class="jxr_linenumber" name="L5818" href="#L5818">5818</a> <strong class="jxr_keyword">var</strong> v = element & 0xFF;
+<a class="jxr_linenumber" name="L5819" href="#L5819">5819</a> sb.append(HEX[v >>> 4]).append(HEX[v & 0x0F]);
+<a class="jxr_linenumber" name="L5820" href="#L5820">5820</a> }
+<a class="jxr_linenumber" name="L5821" href="#L5821">5821</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L5822" href="#L5822">5822</a> }
+<a class="jxr_linenumber" name="L5823" href="#L5823">5823</a>
+<a class="jxr_linenumber" name="L5824" href="#L5824">5824</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5825" href="#L5825">5825</a> <em class="jxr_javadoccomment"> * Converts the contents of the specified input stream to a hex string.</em>
+<a class="jxr_linenumber" name="L5826" href="#L5826">5826</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5827" href="#L5827">5827</a> <em class="jxr_javadoccomment"> * @param is The input stream to convert.</em>
+<a class="jxr_linenumber" name="L5828" href="#L5828">5828</a> <em class="jxr_javadoccomment"> * @return The hex string representation of the input stream contents, or <jk>null</jk> if the stream is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5829" href="#L5829">5829</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5830" href="#L5830">5830</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toHex(InputStream is) {
+<a class="jxr_linenumber" name="L5831" href="#L5831">5831</a> <strong class="jxr_keyword">return</strong> safe(() -> is == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : toHex(readBytes(is)));
+<a class="jxr_linenumber" name="L5832" href="#L5832">5832</a> }
+<a class="jxr_linenumber" name="L5833" href="#L5833">5833</a>
+<a class="jxr_linenumber" name="L5834" href="#L5834">5834</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5835" href="#L5835">5835</a> <em class="jxr_javadoccomment"> * Converts the specified number into a 2 hexadecimal characters.</em>
+<a class="jxr_linenumber" name="L5836" href="#L5836">5836</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5837" href="#L5837">5837</a> <em class="jxr_javadoccomment"> * @param num The number to convert to hex.</em>
+<a class="jxr_linenumber" name="L5838" href="#L5838">5838</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[2]</code> containing the specified characters.</em>
+<a class="jxr_linenumber" name="L5839" href="#L5839">5839</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5840" href="#L5840">5840</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong>[] toHex2(<strong class="jxr_keyword">int</strong> num) {
+<a class="jxr_linenumber" name="L5841" href="#L5841">5841</a> <strong class="jxr_keyword">if</strong> (num < 0 || num > 255)
+<a class="jxr_linenumber" name="L5842" href="#L5842">5842</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(<span class="jxr_string">"toHex2 can only be used on numbers between 0 and 255"</span>);
+<a class="jxr_linenumber" name="L5843" href="#L5843">5843</a> <strong class="jxr_keyword">var</strong> n = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[2];
+<a class="jxr_linenumber" name="L5844" href="#L5844">5844</a> <strong class="jxr_keyword">var</strong> a = num % 16;
+<a class="jxr_linenumber" name="L5845" href="#L5845">5845</a> n[1] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
+<a class="jxr_linenumber" name="L5846" href="#L5846">5846</a> a = (num / 16) % 16;
+<a class="jxr_linenumber" name="L5847" href="#L5847">5847</a> n[0] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
+<a class="jxr_linenumber" name="L5848" href="#L5848">5848</a> <strong class="jxr_keyword">return</strong> n;
+<a class="jxr_linenumber" name="L5849" href="#L5849">5849</a> }
+<a class="jxr_linenumber" name="L5850" href="#L5850">5850</a>
+<a class="jxr_linenumber" name="L5851" href="#L5851">5851</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5852" href="#L5852">5852</a> <em class="jxr_javadoccomment"> * Converts the specified number into a 4 hexadecimal characters.</em>
+<a class="jxr_linenumber" name="L5853" href="#L5853">5853</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5854" href="#L5854">5854</a> <em class="jxr_javadoccomment"> * @param num The number to convert to hex.</em>
+<a class="jxr_linenumber" name="L5855" href="#L5855">5855</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[4]</code> containing the specified characters.</em>
+<a class="jxr_linenumber" name="L5856" href="#L5856">5856</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the number is negative.</em>
+<a class="jxr_linenumber" name="L5857" href="#L5857">5857</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5858" href="#L5858">5858</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong>[] toHex4(<strong class="jxr_keyword">int</strong> num) {
+<a class="jxr_linenumber" name="L5859" href="#L5859">5859</a> <strong class="jxr_keyword">if</strong> (num < 0)
+<a class="jxr_linenumber" name="L5860" href="#L5860">5860</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(<span class="jxr_string">"toHex4 can only be used on non-negative numbers"</span>);
+<a class="jxr_linenumber" name="L5861" href="#L5861">5861</a> <strong class="jxr_keyword">var</strong> n = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[4];
+<a class="jxr_linenumber" name="L5862" href="#L5862">5862</a> <strong class="jxr_keyword">var</strong> a = num % 16;
+<a class="jxr_linenumber" name="L5863" href="#L5863">5863</a> n[3] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
+<a class="jxr_linenumber" name="L5864" href="#L5864">5864</a> <strong class="jxr_keyword">var</strong> base = 16;
+<a class="jxr_linenumber" name="L5865" href="#L5865">5865</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 1; i < 4; i++) {
+<a class="jxr_linenumber" name="L5866" href="#L5866">5866</a> a = (num / base) % 16;
+<a class="jxr_linenumber" name="L5867" href="#L5867">5867</a> base <<= 4;
+<a class="jxr_linenumber" name="L5868" href="#L5868">5868</a> n[3 - i] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
+<a class="jxr_linenumber" name="L5869" href="#L5869">5869</a> }
+<a class="jxr_linenumber" name="L5870" href="#L5870">5870</a> <strong class="jxr_keyword">return</strong> n;
+<a class="jxr_linenumber" name="L5871" href="#L5871">5871</a> }
+<a class="jxr_linenumber" name="L5872" href="#L5872">5872</a>
+<a class="jxr_linenumber" name="L5873" href="#L5873">5873</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5874" href="#L5874">5874</a> <em class="jxr_javadoccomment"> * Converts the specified number into a 8 hexadecimal characters.</em>
+<a class="jxr_linenumber" name="L5875" href="#L5875">5875</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5876" href="#L5876">5876</a> <em class="jxr_javadoccomment"> * @param num The number to convert to hex.</em>
+<a class="jxr_linenumber" name="L5877" href="#L5877">5877</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[8]</code> containing the specified characters.</em>
+<a class="jxr_linenumber" name="L5878" href="#L5878">5878</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the number is negative.</em>
+<a class="jxr_linenumber" name="L5879" href="#L5879">5879</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5880" href="#L5880">5880</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong>[] toHex8(<strong class="jxr_keyword">long</strong> num) {
+<a class="jxr_linenumber" name="L5881" href="#L5881">5881</a> <strong class="jxr_keyword">if</strong> (num < 0)
+<a class="jxr_linenumber" name="L5882" href="#L5882">5882</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(<span class="jxr_string">"toHex8 can only be used on non-negative numbers"</span>);
+<a class="jxr_linenumber" name="L5883" href="#L5883">5883</a> <strong class="jxr_keyword">var</strong> n = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[8];
+<a class="jxr_linenumber" name="L5884" href="#L5884">5884</a> <strong class="jxr_keyword">var</strong> a = num % 16;
+<a class="jxr_linenumber" name="L5885" href="#L5885">5885</a> n[7] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
+<a class="jxr_linenumber" name="L5886" href="#L5886">5886</a> <strong class="jxr_keyword">var</strong> base = 16;
+<a class="jxr_linenumber" name="L5887" href="#L5887">5887</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 1; i < 8; i++) {
+<a class="jxr_linenumber" name="L5888" href="#L5888">5888</a> a = (num / base) % 16;
+<a class="jxr_linenumber" name="L5889" href="#L5889">5889</a> base <<= 4;
+<a class="jxr_linenumber" name="L5890" href="#L5890">5890</a> n[7 - i] = (<strong class="jxr_keyword">char</strong>)(a > 9 ? 'A' + a - 10 : '0' + a);
+<a class="jxr_linenumber" name="L5891" href="#L5891">5891</a> }
+<a class="jxr_linenumber" name="L5892" href="#L5892">5892</a> <strong class="jxr_keyword">return</strong> n;
+<a class="jxr_linenumber" name="L5893" href="#L5893">5893</a> }
+<a class="jxr_linenumber" name="L5894" href="#L5894">5894</a>
+<a class="jxr_linenumber" name="L5895" href="#L5895">5895</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5896" href="#L5896">5896</a> <em class="jxr_javadoccomment"> * Converts the specified object to an ISO8601 date string.</em>
+<a class="jxr_linenumber" name="L5897" href="#L5897">5897</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5898" href="#L5898">5898</a> <em class="jxr_javadoccomment"> * @param c The object to convert.</em>
+<a class="jxr_linenumber" name="L5899" href="#L5899">5899</a> <em class="jxr_javadoccomment"> * @return The converted object.</em>
+<a class="jxr_linenumber" name="L5900" href="#L5900">5900</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5901" href="#L5901">5901</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toIsoDate(Calendar c) {
+<a class="jxr_linenumber" name="L5902" href="#L5902">5902</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="L5903" href="#L5903">5903</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5904" href="#L5904">5904</a> }
+<a class="jxr_linenumber" name="L5905" href="#L5905">5905</a> <em class="jxr_comment">// Convert Calendar to ZonedDateTime and format as ISO8601 date (YYYY-MM-DD)</em>
+<a class="jxr_linenumber" name="L5906" href="#L5906">5906</a> ZonedDateTime zdt = c.toInstant().atZone(c.getTimeZone().toZoneId());
+<a class="jxr_linenumber" name="L5907" href="#L5907">5907</a> <strong class="jxr_keyword">return</strong> zdt.format(DateTimeFormatter.ISO_LOCAL_DATE);
+<a class="jxr_linenumber" name="L5908" href="#L5908">5908</a> }
+<a class="jxr_linenumber" name="L5909" href="#L5909">5909</a>
+<a class="jxr_linenumber" name="L5910" href="#L5910">5910</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5911" href="#L5911">5911</a> <em class="jxr_javadoccomment"> * Converts the specified object to an ISO8601 date-time string.</em>
+<a class="jxr_linenumber" name="L5912" href="#L5912">5912</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5913" href="#L5913">5913</a> <em class="jxr_javadoccomment"> * @param c The object to convert.</em>
+<a class="jxr_linenumber" name="L5914" href="#L5914">5914</a> <em class="jxr_javadoccomment"> * @return The converted object.</em>
+<a class="jxr_linenumber" name="L5915" href="#L5915">5915</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5916" href="#L5916">5916</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toIsoDateTime(Calendar c) {
+<a class="jxr_linenumber" name="L5917" href="#L5917">5917</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="L5918" href="#L5918">5918</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L5919" href="#L5919">5919</a> }
+<a class="jxr_linenumber" name="L5920" href="#L5920">5920</a> <em class="jxr_comment">// Convert Calendar to ZonedDateTime and format as ISO8601 date-time with timezone</em>
+<a class="jxr_linenumber" name="L5921" href="#L5921">5921</a> ZonedDateTime zdt = c.toInstant().atZone(c.getTimeZone().toZoneId());
+<a class="jxr_linenumber" name="L5922" href="#L5922">5922</a> <strong class="jxr_keyword">return</strong> zdt.format(DateTimeFormatter.ISO_OFFSET_DATE_TIME);
+<a class="jxr_linenumber" name="L5923" href="#L5923">5923</a> }
+<a class="jxr_linenumber" name="L5924" href="#L5924">5924</a>
+<a class="jxr_linenumber" name="L5925" href="#L5925">5925</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5926" href="#L5926">5926</a> <em class="jxr_javadoccomment"> * Converts the specified bytes into a readable string.</em>
+<a class="jxr_linenumber" name="L5927" href="#L5927">5927</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5928" href="#L5928">5928</a> <em class="jxr_javadoccomment"> * @param b The number to convert to hex.</em>
+<a class="jxr_linenumber" name="L5929" href="#L5929">5929</a> <em class="jxr_javadoccomment"> * @return A <code><jk>char</jk>[2]</code> containing the specified characters.</em>
+<a class="jxr_linenumber" name="L5930" href="#L5930">5930</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5931" href="#L5931">5931</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toReadableBytes(byte[] b) {
+<a class="jxr_linenumber" name="L5932" href="#L5932">5932</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L5933" href="#L5933">5933</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> b2 : b)
+<a class="jxr_linenumber" name="L5934" href="#L5934">5934</a> sb.append((b2 < ' ' || b2 > 'z') ? String.format(<span class="jxr_string">"[%02X]"</span>, b2) : (<strong class="jxr_keyword">char</strong>)b2 + <span class="jxr_string">" "</span>);
+<a class="jxr_linenumber" name="L5935" href="#L5935">5935</a> sb.append(<span class="jxr_string">"\n"</span>);
+<a class="jxr_linenumber" name="L5936" href="#L5936">5936</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> b2 : b)
+<a class="jxr_linenumber" name="L5937" href="#L5937">5937</a> sb.append(String.format(<span class="jxr_string">"[%02X]"</span>, b2));
+<a class="jxr_linenumber" name="L5938" href="#L5938">5938</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L5939" href="#L5939">5939</a> }
+<a class="jxr_linenumber" name="L5940" href="#L5940">5940</a>
+<a class="jxr_linenumber" name="L5941" href="#L5941">5941</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5942" href="#L5942">5942</a> <em class="jxr_javadoccomment"> * Same as {@link #toHex(byte[])} but puts spaces between the byte strings.</em>
+<a class="jxr_linenumber" name="L5943" href="#L5943">5943</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5944" href="#L5944">5944</a> <em class="jxr_javadoccomment"> * @param bytes The bytes to convert to hexadecimal.</em>
+<a class="jxr_linenumber" name="L5945" href="#L5945">5945</a> <em class="jxr_javadoccomment"> * @return A new string consisting of hexadecimal characters.</em>
+<a class="jxr_linenumber" name="L5946" href="#L5946">5946</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5947" href="#L5947">5947</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toSpacedHex(byte[] bytes) {
+<a class="jxr_linenumber" name="L5948" href="#L5948">5948</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(bytes.length * 3);
+<a class="jxr_linenumber" name="L5949" href="#L5949">5949</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 0; j < bytes.length; j++) {
+<a class="jxr_linenumber" name="L5950" href="#L5950">5950</a> <strong class="jxr_keyword">if</strong> (j > 0)
+<a class="jxr_linenumber" name="L5951" href="#L5951">5951</a> sb.append(' ');
+<a class="jxr_linenumber" name="L5952" href="#L5952">5952</a> <strong class="jxr_keyword">var</strong> v = bytes[j] & 0xFF;
+<a class="jxr_linenumber" name="L5953" href="#L5953">5953</a> sb.append(HEX[v >>> 4]).append(HEX[v & 0x0F]);
+<a class="jxr_linenumber" name="L5954" href="#L5954">5954</a> }
+<a class="jxr_linenumber" name="L5955" href="#L5955">5955</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L5956" href="#L5956">5956</a> }
+<a class="jxr_linenumber" name="L5957" href="#L5957">5957</a>
+<a class="jxr_linenumber" name="L5958" href="#L5958">5958</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5959" href="#L5959">5959</a> <em class="jxr_javadoccomment"> * Converts the specified object to a URI.</em>
+<a class="jxr_linenumber" name="L5960" href="#L5960">5960</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5961" href="#L5961">5961</a> <em class="jxr_javadoccomment"> * @param o The object to convert to a URI.</em>
+<a class="jxr_linenumber" name="L5962" href="#L5962">5962</a> <em class="jxr_javadoccomment"> * @return A new URI, or the same object if the object was already a URI, or</em>
+<a class="jxr_linenumber" name="L5963" href="#L5963">5963</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5964" href="#L5964">5964</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> URI toURI(Object o) {
+<a class="jxr_linenumber" name="L5965" href="#L5965">5965</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong> || o instanceof URI)
+<a class="jxr_linenumber" name="L5966" href="#L5966">5966</a> <strong class="jxr_keyword">return</strong> (URI)o;
+<a class="jxr_linenumber" name="L5967" href="#L5967">5967</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L5968" href="#L5968">5968</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> URI(o.toString());
+<a class="jxr_linenumber" name="L5969" href="#L5969">5969</a> } <strong class="jxr_keyword">catch</strong> (URISyntaxException e) {
+<a class="jxr_linenumber" name="L5970" href="#L5970">5970</a> <strong class="jxr_keyword">throw</strong> toRex(e);
+<a class="jxr_linenumber" name="L5971" href="#L5971">5971</a> }
+<a class="jxr_linenumber" name="L5972" href="#L5972">5972</a> }
+<a class="jxr_linenumber" name="L5973" href="#L5973">5973</a>
+<a class="jxr_linenumber" name="L5974" href="#L5974">5974</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5975" href="#L5975">5975</a> <em class="jxr_javadoccomment"> * Converts the specified byte array to a UTF-8 string.</em>
+<a class="jxr_linenumber" name="L5976" href="#L5976">5976</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5977" href="#L5977">5977</a> <em class="jxr_javadoccomment"> * @param b The byte array to convert.</em>
+<a class="jxr_linenumber" name="L5978" href="#L5978">5978</a> <em class="jxr_javadoccomment"> * @return The UTF-8 string representation, or <jk>null</jk> if the array is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5979" href="#L5979">5979</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5980" href="#L5980">5980</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toUtf8(byte[] b) {
+<a class="jxr_linenumber" name="L5981" href="#L5981">5981</a> <strong class="jxr_keyword">return</strong> b == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : <strong class="jxr_keyword">new</strong> String(b, UTF8);
+<a class="jxr_linenumber" name="L5982" href="#L5982">5982</a> }
+<a class="jxr_linenumber" name="L5983" href="#L5983">5983</a>
+<a class="jxr_linenumber" name="L5984" href="#L5984">5984</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5985" href="#L5985">5985</a> <em class="jxr_javadoccomment"> * Converts the contents of the specified input stream to a UTF-8 string.</em>
+<a class="jxr_linenumber" name="L5986" href="#L5986">5986</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5987" href="#L5987">5987</a> <em class="jxr_javadoccomment"> * @param is The input stream to convert.</em>
+<a class="jxr_linenumber" name="L5988" href="#L5988">5988</a> <em class="jxr_javadoccomment"> * @return The UTF-8 string representation of the input stream contents, or <jk>null</jk> if the stream is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5989" href="#L5989">5989</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L5990" href="#L5990">5990</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String toUtf8(InputStream is) {
+<a class="jxr_linenumber" name="L5991" href="#L5991">5991</a> <strong class="jxr_keyword">return</strong> safe(() -> is == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : <strong class="jxr_keyword">new</strong> String(readBytes(is), UTF8));
+<a class="jxr_linenumber" name="L5992" href="#L5992">5992</a> }
+<a class="jxr_linenumber" name="L5993" href="#L5993">5993</a>
+<a class="jxr_linenumber" name="L5994" href="#L5994">5994</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L5995" href="#L5995">5995</a> <em class="jxr_javadoccomment"> * Same as {@link String#trim()} but prevents <c>NullPointerExceptions</c>.</em>
+<a class="jxr_linenumber" name="L5996" href="#L5996">5996</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L5997" href="#L5997">5997</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
+<a class="jxr_linenumber" name="L5998" href="#L5998">5998</a> <em class="jxr_javadoccomment"> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L5999" href="#L5999">5999</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6000" href="#L6000">6000</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trim(String s) {
+<a class="jxr_linenumber" name="L6001" href="#L6001">6001</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6002" href="#L6002">6002</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6003" href="#L6003">6003</a> <strong class="jxr_keyword">return</strong> s.trim();
+<a class="jxr_linenumber" name="L6004" href="#L6004">6004</a> }
+<a class="jxr_linenumber" name="L6005" href="#L6005">6005</a>
+<a class="jxr_linenumber" name="L6006" href="#L6006">6006</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6007" href="#L6007">6007</a> <em class="jxr_javadoccomment"> * Trims whitespace characters from the end of the specified string.</em>
+<a class="jxr_linenumber" name="L6008" href="#L6008">6008</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6009" href="#L6009">6009</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
+<a class="jxr_linenumber" name="L6010" href="#L6010">6010</a> <em class="jxr_javadoccomment"> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6011" href="#L6011">6011</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6012" href="#L6012">6012</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimEnd(String s) {
+<a class="jxr_linenumber" name="L6013" href="#L6013">6013</a> <strong class="jxr_keyword">if</strong> (nn(s))
+<a class="jxr_linenumber" name="L6014" href="#L6014">6014</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && isWhitespace(s.charAt(s.length() - 1)))
+<a class="jxr_linenumber" name="L6015" href="#L6015">6015</a> s = s.substring(0, s.length() - 1);
+<a class="jxr_linenumber" name="L6016" href="#L6016">6016</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6017" href="#L6017">6017</a> }
+<a class="jxr_linenumber" name="L6018" href="#L6018">6018</a>
+<a class="jxr_linenumber" name="L6019" href="#L6019">6019</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6020" href="#L6020">6020</a> <em class="jxr_javadoccomment"> * Trims <js>'/'</js> characters from the beginning of the specified string.</em>
+<a class="jxr_linenumber" name="L6021" href="#L6021">6021</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6022" href="#L6022">6022</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
+<a class="jxr_linenumber" name="L6023" href="#L6023">6023</a> <em class="jxr_javadoccomment"> * @return A new trimmed string, or the same string if no trimming was necessary.</em>
+<a class="jxr_linenumber" name="L6024" href="#L6024">6024</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6025" href="#L6025">6025</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimLeadingSlashes(String s) {
+<a class="jxr_linenumber" name="L6026" href="#L6026">6026</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6027" href="#L6027">6027</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6028" href="#L6028">6028</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && s.charAt(0) == '/')
+<a class="jxr_linenumber" name="L6029" href="#L6029">6029</a> s = s.substring(1);
+<a class="jxr_linenumber" name="L6030" href="#L6030">6030</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6031" href="#L6031">6031</a> }
+<a class="jxr_linenumber" name="L6032" href="#L6032">6032</a>
+<a class="jxr_linenumber" name="L6033" href="#L6033">6033</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6034" href="#L6034">6034</a> <em class="jxr_javadoccomment"> * Trims <js>'/'</js> characters from both the start and end of the specified string.</em>
+<a class="jxr_linenumber" name="L6035" href="#L6035">6035</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6036" href="#L6036">6036</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
+<a class="jxr_linenumber" name="L6037" href="#L6037">6037</a> <em class="jxr_javadoccomment"> * @return A new trimmed string, or the same string if no trimming was necessary.</em>
+<a class="jxr_linenumber" name="L6038" href="#L6038">6038</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6039" href="#L6039">6039</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimSlashes(String s) {
+<a class="jxr_linenumber" name="L6040" href="#L6040">6040</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6041" href="#L6041">6041</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6042" href="#L6042">6042</a> <strong class="jxr_keyword">if</strong> (s.isEmpty())
+<a class="jxr_linenumber" name="L6043" href="#L6043">6043</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6044" href="#L6044">6044</a> <strong class="jxr_keyword">while</strong> (endsWith(s, '/'))
+<a class="jxr_linenumber" name="L6045" href="#L6045">6045</a> s = s.substring(0, s.length() - 1);
+<a class="jxr_linenumber" name="L6046" href="#L6046">6046</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && s.charAt(0) == '/') <em class="jxr_comment">// NOSONAR - NPE not possible here.</em>
+<a class="jxr_linenumber" name="L6047" href="#L6047">6047</a> s = s.substring(1);
+<a class="jxr_linenumber" name="L6048" href="#L6048">6048</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6049" href="#L6049">6049</a> }
+<a class="jxr_linenumber" name="L6050" href="#L6050">6050</a>
+<a class="jxr_linenumber" name="L6051" href="#L6051">6051</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6052" href="#L6052">6052</a> <em class="jxr_javadoccomment"> * Trims <js>'/'</js> and space characters from both the start and end of the specified string.</em>
+<a class="jxr_linenumber" name="L6053" href="#L6053">6053</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6054" href="#L6054">6054</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
+<a class="jxr_linenumber" name="L6055" href="#L6055">6055</a> <em class="jxr_javadoccomment"> * @return A new trimmed string, or the same string if no trimming was necessary.</em>
+<a class="jxr_linenumber" name="L6056" href="#L6056">6056</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6057" href="#L6057">6057</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimSlashesAndSpaces(String s) {
+<a class="jxr_linenumber" name="L6058" href="#L6058">6058</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6059" href="#L6059">6059</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6060" href="#L6060">6060</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && (s.charAt(s.length() - 1) == '/' || isWhitespace(s.charAt(s.length() - 1))))
+<a class="jxr_linenumber" name="L6061" href="#L6061">6061</a> s = s.substring(0, s.length() - 1);
+<a class="jxr_linenumber" name="L6062" href="#L6062">6062</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && (s.charAt(0) == '/' || isWhitespace(s.charAt(0))))
+<a class="jxr_linenumber" name="L6063" href="#L6063">6063</a> s = s.substring(1);
+<a class="jxr_linenumber" name="L6064" href="#L6064">6064</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6065" href="#L6065">6065</a> }
+<a class="jxr_linenumber" name="L6066" href="#L6066">6066</a>
+<a class="jxr_linenumber" name="L6067" href="#L6067">6067</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6068" href="#L6068">6068</a> <em class="jxr_javadoccomment"> * Trims whitespace characters from the beginning of the specified string.</em>
+<a class="jxr_linenumber" name="L6069" href="#L6069">6069</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6070" href="#L6070">6070</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
+<a class="jxr_linenumber" name="L6071" href="#L6071">6071</a> <em class="jxr_javadoccomment"> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6072" href="#L6072">6072</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6073" href="#L6073">6073</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimStart(String s) {
+<a class="jxr_linenumber" name="L6074" href="#L6074">6074</a> <strong class="jxr_keyword">if</strong> (nn(s))
+<a class="jxr_linenumber" name="L6075" href="#L6075">6075</a> <strong class="jxr_keyword">while</strong> (isNotEmpty(s) && isWhitespace(s.charAt(0)))
+<a class="jxr_linenumber" name="L6076" href="#L6076">6076</a> s = s.substring(1);
+<a class="jxr_linenumber" name="L6077" href="#L6077">6077</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6078" href="#L6078">6078</a> }
+<a class="jxr_linenumber" name="L6079" href="#L6079">6079</a>
+<a class="jxr_linenumber" name="L6080" href="#L6080">6080</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6081" href="#L6081">6081</a> <em class="jxr_javadoccomment"> * Trims <js>'/'</js> characters from the end of the specified string.</em>
+<a class="jxr_linenumber" name="L6082" href="#L6082">6082</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6083" href="#L6083">6083</a> <em class="jxr_javadoccomment"> * @param s The string to trim.</em>
+<a class="jxr_linenumber" name="L6084" href="#L6084">6084</a> <em class="jxr_javadoccomment"> * @return A new trimmed string, or the same string if no trimming was necessary.</em>
+<a class="jxr_linenumber" name="L6085" href="#L6085">6085</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6086" href="#L6086">6086</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String trimTrailingSlashes(String s) {
+<a class="jxr_linenumber" name="L6087" href="#L6087">6087</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6088" href="#L6088">6088</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6089" href="#L6089">6089</a> <strong class="jxr_keyword">while</strong> (endsWith(s, '/'))
+<a class="jxr_linenumber" name="L6090" href="#L6090">6090</a> s = s.substring(0, s.length() - 1);
+<a class="jxr_linenumber" name="L6091" href="#L6091">6091</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6092" href="#L6092">6092</a> }
+<a class="jxr_linenumber" name="L6093" href="#L6093">6093</a>
+<a class="jxr_linenumber" name="L6094" href="#L6094">6094</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6095" href="#L6095">6095</a> <em class="jxr_javadoccomment"> * Uncapitalizes the first character of a string.</em>
+<a class="jxr_linenumber" name="L6096" href="#L6096">6096</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6097" href="#L6097">6097</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L6098" href="#L6098">6098</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L6099" href="#L6099">6099</a> <em class="jxr_javadoccomment"> * uncapitalize(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L6100" href="#L6100">6100</a> <em class="jxr_javadoccomment"> * uncapitalize(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L6101" href="#L6101">6101</a> <em class="jxr_javadoccomment"> * uncapitalize(<js>"Hello"</js>); <jc>// "hello"</jc></em>
+<a class="jxr_linenumber" name="L6102" href="#L6102">6102</a> <em class="jxr_javadoccomment"> * uncapitalize(<js>"hello"</js>); <jc>// "hello"</jc></em>
+<a class="jxr_linenumber" name="L6103" href="#L6103">6103</a> <em class="jxr_javadoccomment"> * uncapitalize(<js>"HELLO"</js>); <jc>// "hELLO"</jc></em>
+<a class="jxr_linenumber" name="L6104" href="#L6104">6104</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L6105" href="#L6105">6105</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6106" href="#L6106">6106</a> <em class="jxr_javadoccomment"> * @param str The string to uncapitalize.</em>
+<a class="jxr_linenumber" name="L6107" href="#L6107">6107</a> <em class="jxr_javadoccomment"> * @return The string with the first character uncapitalized, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6108" href="#L6108">6108</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6109" href="#L6109">6109</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String uncapitalize(String str) {
+<a class="jxr_linenumber" name="L6110" href="#L6110">6110</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L6111" href="#L6111">6111</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L6112" href="#L6112">6112</a> <strong class="jxr_keyword">return</strong> Character.toLowerCase(str.charAt(0)) + str.substring(1);
+<a class="jxr_linenumber" name="L6113" href="#L6113">6113</a> }
+<a class="jxr_linenumber" name="L6114" href="#L6114">6114</a>
+<a class="jxr_linenumber" name="L6115" href="#L6115">6115</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6116" href="#L6116">6116</a> <em class="jxr_javadoccomment"> * Helper method to split a string into words.</em>
+<a class="jxr_linenumber" name="L6117" href="#L6117">6117</a> <em class="jxr_javadoccomment"> * Detects word boundaries from separators (spaces, underscores, hyphens) and case changes.</em>
+<a class="jxr_linenumber" name="L6118" href="#L6118">6118</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6119" href="#L6119">6119</a> <em class="jxr_javadoccomment"> * @param str The string to split.</em>
+<a class="jxr_linenumber" name="L6120" href="#L6120">6120</a> <em class="jxr_javadoccomment"> * @return A list of words, or empty list if input is null or empty.</em>
+<a class="jxr_linenumber" name="L6121" href="#L6121">6121</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6122" href="#L6122">6122</a> <strong class="jxr_keyword">static</strong> List<String> splitWords(String str) {
+<a class="jxr_linenumber" name="L6123" href="#L6123">6123</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || isEmpty(str))
+<a class="jxr_linenumber" name="L6124" href="#L6124">6124</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L6125" href="#L6125">6125</a>
+<a class="jxr_linenumber" name="L6126" href="#L6126">6126</a> <strong class="jxr_keyword">var</strong> words = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L6127" href="#L6127">6127</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L6128" href="#L6128">6128</a> <strong class="jxr_keyword">var</strong> wasLowerCase = false;
+<a class="jxr_linenumber" name="L6129" href="#L6129">6129</a> <strong class="jxr_keyword">var</strong> wasUpperCase = false;
+<a class="jxr_linenumber" name="L6130" href="#L6130">6130</a> <strong class="jxr_keyword">var</strong> consecutiveUpperCount = 0;
+<a class="jxr_linenumber" name="L6131" href="#L6131">6131</a>
+<a class="jxr_linenumber" name="L6132" href="#L6132">6132</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L6133" href="#L6133">6133</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
+<a class="jxr_linenumber" name="L6134" href="#L6134">6134</a> <strong class="jxr_keyword">var</strong> isSeparator = (c == ' ' || c == '_' || c == '-' || c == '\t');
+<a class="jxr_linenumber" name="L6135" href="#L6135">6135</a> <strong class="jxr_keyword">var</strong> isUpperCase = Character.isUpperCase(c);
+<a class="jxr_linenumber" name="L6136" href="#L6136">6136</a> <strong class="jxr_keyword">var</strong> isLowerCase = Character.isLowerCase(c);
+<a class="jxr_linenumber" name="L6137" href="#L6137">6137</a> <strong class="jxr_keyword">var</strong> isLetter = Character.isLetter(c);
+<a class="jxr_linenumber" name="L6138" href="#L6138">6138</a>
+<a class="jxr_linenumber" name="L6139" href="#L6139">6139</a> <strong class="jxr_keyword">if</strong> (isSeparator) {
+<a class="jxr_linenumber" name="L6140" href="#L6140">6140</a> <strong class="jxr_keyword">if</strong> (sb.length() > 0) {
+<a class="jxr_linenumber" name="L6141" href="#L6141">6141</a> words.add(sb.toString());
+<a class="jxr_linenumber" name="L6142" href="#L6142">6142</a> sb.setLength(0);
+<a class="jxr_linenumber" name="L6143" href="#L6143">6143</a> }
+<a class="jxr_linenumber" name="L6144" href="#L6144">6144</a> wasLowerCase = false;
+<a class="jxr_linenumber" name="L6145" href="#L6145">6145</a> wasUpperCase = false;
+<a class="jxr_linenumber" name="L6146" href="#L6146">6146</a> consecutiveUpperCount = 0;
+<a class="jxr_linenumber" name="L6147" href="#L6147">6147</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (isLetter) {
+<a class="jxr_linenumber" name="L6148" href="#L6148">6148</a> <em class="jxr_comment">// Detect word boundary:</em>
+<a class="jxr_linenumber" name="L6149" href="#L6149">6149</a> <em class="jxr_comment">// 1. Uppercase after lowercase (e.g., "helloWorld" → "hello", "World")</em>
+<a class="jxr_linenumber" name="L6150" href="#L6150">6150</a> <em class="jxr_comment">// 2. Uppercase after consecutive uppercase when next is lowercase (e.g., "XMLHttp" → "XML", "Http")</em>
+<a class="jxr_linenumber" name="L6151" href="#L6151">6151</a> <em class="jxr_comment">// 3. Lowercase after 2+ consecutive uppercase (e.g., "XMLHttp" → "XML", "Http")</em>
+<a class="jxr_linenumber" name="L6152" href="#L6152">6152</a> <strong class="jxr_keyword">if</strong> (sb.length() > 0) {
+<a class="jxr_linenumber" name="L6153" href="#L6153">6153</a> <strong class="jxr_keyword">if</strong> (isUpperCase && wasLowerCase) {
+<a class="jxr_linenumber" name="L6154" href="#L6154">6154</a> <em class="jxr_comment">// Case 1: uppercase after lowercase (e.g., "helloWorld" → "hello", "World")</em>
+<a class="jxr_linenumber" name="L6155" href="#L6155">6155</a> words.add(sb.toString());
+<a class="jxr_linenumber" name="L6156" href="#L6156">6156</a> sb.setLength(0);
+<a class="jxr_linenumber" name="L6157" href="#L6157">6157</a> consecutiveUpperCount = 0;
+<a class="jxr_linenumber" name="L6158" href="#L6158">6158</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (isUpperCase && wasUpperCase && consecutiveUpperCount >= 2) {
+<a class="jxr_linenumber" name="L6159" href="#L6159">6159</a> <em class="jxr_comment">// Case 2: uppercase after uppercase - check if this starts a new word</em>
+<a class="jxr_linenumber" name="L6160" href="#L6160">6160</a> <em class="jxr_comment">// Look ahead to see if next character is lowercase</em>
+<a class="jxr_linenumber" name="L6161" href="#L6161">6161</a> <em class="jxr_comment">// This handles "XMLHttp" where 'H' starts "Http"</em>
+<a class="jxr_linenumber" name="L6162" href="#L6162">6162</a> <em class="jxr_comment">// We need at least 2 consecutive uppercase letters before this one to split</em>
+<a class="jxr_linenumber" name="L6163" href="#L6163">6163</a> <strong class="jxr_keyword">if</strong> (i + 1 < str.length()) {
+<a class="jxr_linenumber" name="L6164" href="#L6164">6164</a> <strong class="jxr_keyword">var</strong> nextChar = str.charAt(i + 1);
+<a class="jxr_linenumber" name="L6165" href="#L6165">6165</a> <strong class="jxr_keyword">if</strong> (Character.isLowerCase(nextChar)) {
+<a class="jxr_linenumber" name="L6166" href="#L6166">6166</a> <em class="jxr_comment">// This uppercase starts a new word, split before it</em>
+<a class="jxr_linenumber" name="L6167" href="#L6167">6167</a> words.add(sb.toString());
+<a class="jxr_linenumber" name="L6168" href="#L6168">6168</a> sb.setLength(0);
+<a class="jxr_linenumber" name="L6169" href="#L6169">6169</a> consecutiveUpperCount = 0;
+<a class="jxr_linenumber" name="L6170" href="#L6170">6170</a> }
+<a class="jxr_linenumber" name="L6171" href="#L6171">6171</a> }
+<a class="jxr_linenumber" name="L6172" href="#L6172">6172</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (isLowerCase && wasUpperCase && consecutiveUpperCount >= 2) {
+<a class="jxr_linenumber" name="L6173" href="#L6173">6173</a> <em class="jxr_comment">// Case 3: lowercase after 2+ consecutive uppercase</em>
+<a class="jxr_linenumber" name="L6174" href="#L6174">6174</a> <em class="jxr_comment">// Split all but the last uppercase (e.g., "XMLH" → "XML" + "H")</em>
+<a class="jxr_linenumber" name="L6175" href="#L6175">6175</a> <strong class="jxr_keyword">var</strong> splitPoint = sb.length() - 1;
+<a class="jxr_linenumber" name="L6176" href="#L6176">6176</a> words.add(sb.substring(0, splitPoint));
+<a class="jxr_linenumber" name="L6177" href="#L6177">6177</a> sb.delete(0, splitPoint);
+<a class="jxr_linenumber" name="L6178" href="#L6178">6178</a> consecutiveUpperCount = 0;
+<a class="jxr_linenumber" name="L6179" href="#L6179">6179</a> }
+<a class="jxr_linenumber" name="L6180" href="#L6180">6180</a> }
+<a class="jxr_linenumber" name="L6181" href="#L6181">6181</a> sb.append(c);
+<a class="jxr_linenumber" name="L6182" href="#L6182">6182</a> <em class="jxr_comment">// Update state AFTER appending</em>
+<a class="jxr_linenumber" name="L6183" href="#L6183">6183</a> wasLowerCase = isLowerCase;
+<a class="jxr_linenumber" name="L6184" href="#L6184">6184</a> wasUpperCase = isUpperCase;
+<a class="jxr_linenumber" name="L6185" href="#L6185">6185</a> <strong class="jxr_keyword">if</strong> (isUpperCase) {
+<a class="jxr_linenumber" name="L6186" href="#L6186">6186</a> consecutiveUpperCount++;
+<a class="jxr_linenumber" name="L6187" href="#L6187">6187</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L6188" href="#L6188">6188</a> consecutiveUpperCount = 0;
+<a class="jxr_linenumber" name="L6189" href="#L6189">6189</a> }
+<a class="jxr_linenumber" name="L6190" href="#L6190">6190</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L6191" href="#L6191">6191</a> <em class="jxr_comment">// Non-letter characters (digits, etc.) - treat as part of current word</em>
+<a class="jxr_linenumber" name="L6192" href="#L6192">6192</a> sb.append(c);
+<a class="jxr_linenumber" name="L6193" href="#L6193">6193</a> wasLowerCase = false;
+<a class="jxr_linenumber" name="L6194" href="#L6194">6194</a> wasUpperCase = false;
+<a class="jxr_linenumber" name="L6195" href="#L6195">6195</a> consecutiveUpperCount = 0;
+<a class="jxr_linenumber" name="L6196" href="#L6196">6196</a> }
+<a class="jxr_linenumber" name="L6197" href="#L6197">6197</a> }
+<a class="jxr_linenumber" name="L6198" href="#L6198">6198</a>
+<a class="jxr_linenumber" name="L6199" href="#L6199">6199</a> <strong class="jxr_keyword">if</strong> (sb.length() > 0)
+<a class="jxr_linenumber" name="L6200" href="#L6200">6200</a> words.add(sb.toString());
+<a class="jxr_linenumber" name="L6201" href="#L6201">6201</a>
+<a class="jxr_linenumber" name="L6202" href="#L6202">6202</a> <strong class="jxr_keyword">return</strong> words;
+<a class="jxr_linenumber" name="L6203" href="#L6203">6203</a> }
+<a class="jxr_linenumber" name="L6204" href="#L6204">6204</a>
+<a class="jxr_linenumber" name="L6205" href="#L6205">6205</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6206" href="#L6206">6206</a> <em class="jxr_javadoccomment"> * Converts a string to camelCase format.</em>
+<a class="jxr_linenumber" name="L6207" href="#L6207">6207</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6208" href="#L6208">6208</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L6209" href="#L6209">6209</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
+<a class="jxr_linenumber" name="L6210" href="#L6210">6210</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L6211" href="#L6211">6211</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L6212" href="#L6212">6212</a> <em class="jxr_javadoccomment"> * <li>Underscore-separated: "hello_world" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L6213" href="#L6213">6213</a> <em class="jxr_javadoccomment"> * <li>Hyphen-separated: "hello-world" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L6214" href="#L6214">6214</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L6215" href="#L6215">6215</a> <em class="jxr_javadoccomment"> * <li>Already camelCase: "helloWorld" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L6216" href="#L6216">6216</a> <em class="jxr_javadoccomment"> * <li>Mixed case: "Hello_World-Test" → "helloWorldTest"</li></em>
+<a class="jxr_linenumber" name="L6217" href="#L6217">6217</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L6218" href="#L6218">6218</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6219" href="#L6219">6219</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L6220" href="#L6220">6220</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L6221" href="#L6221">6221</a> <em class="jxr_javadoccomment"> * camelCase(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L6222" href="#L6222">6222</a> <em class="jxr_javadoccomment"> * camelCase(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L6223" href="#L6223">6223</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello world"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6224" href="#L6224">6224</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello_world"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6225" href="#L6225">6225</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello-world"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6226" href="#L6226">6226</a> <em class="jxr_javadoccomment"> * camelCase(<js>"HelloWorld"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6227" href="#L6227">6227</a> <em class="jxr_javadoccomment"> * camelCase(<js>"helloWorld"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6228" href="#L6228">6228</a> <em class="jxr_javadoccomment"> * camelCase(<js>" hello world "</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6229" href="#L6229">6229</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L6230" href="#L6230">6230</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6231" href="#L6231">6231</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
+<a class="jxr_linenumber" name="L6232" href="#L6232">6232</a> <em class="jxr_javadoccomment"> * @return The camelCase string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6233" href="#L6233">6233</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6234" href="#L6234">6234</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String camelCase(String str) {
+<a class="jxr_linenumber" name="L6235" href="#L6235">6235</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6236" href="#L6236">6236</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6237" href="#L6237">6237</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L6238" href="#L6238">6238</a> <strong class="jxr_keyword">return</strong> str;
<a class="jxr_linenumber" name="L6239" href="#L6239">6239</a>
-<a class="jxr_linenumber" name="L6240" href="#L6240">6240</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L6241" href="#L6241">6241</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
-<a class="jxr_linenumber" name="L6242" href="#L6242">6242</a> <strong class="jxr_keyword">var</strong> word = words.get(i);
-<a class="jxr_linenumber" name="L6243" href="#L6243">6243</a> <strong class="jxr_keyword">if</strong> (i == 0) {
-<a class="jxr_linenumber" name="L6244" href="#L6244">6244</a> result.append(uncapitalize(word));
-<a class="jxr_linenumber" name="L6245" href="#L6245">6245</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L6246" href="#L6246">6246</a> result.append(capitalize(word.toLowerCase()));
-<a class="jxr_linenumber" name="L6247" href="#L6247">6247</a> }
-<a class="jxr_linenumber" name="L6248" href="#L6248">6248</a> }
-<a class="jxr_linenumber" name="L6249" href="#L6249">6249</a>
-<a class="jxr_linenumber" name="L6250" href="#L6250">6250</a> <strong class="jxr_keyword">return</strong> result.toString();
-<a class="jxr_linenumber" name="L6251" href="#L6251">6251</a> }
-<a class="jxr_linenumber" name="L6252" href="#L6252">6252</a>
-<a class="jxr_linenumber" name="L6253" href="#L6253">6253</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6254" href="#L6254">6254</a> <em class="jxr_javadoccomment"> * Converts a string to snake_case format.</em>
-<a class="jxr_linenumber" name="L6255" href="#L6255">6255</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6256" href="#L6256">6256</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L6257" href="#L6257">6257</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
-<a class="jxr_linenumber" name="L6258" href="#L6258">6258</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L6259" href="#L6259">6259</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "hello_world"</li></em>
-<a class="jxr_linenumber" name="L6260" href="#L6260">6260</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "hello_world"</li></em>
-<a class="jxr_linenumber" name="L6261" href="#L6261">6261</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "hello_world"</li></em>
-<a class="jxr_linenumber" name="L6262" href="#L6262">6262</a> <em class="jxr_javadoccomment"> * <li>Kebab-case: "hello-world" → "hello_world"</li></em>
-<a class="jxr_linenumber" name="L6263" href="#L6263">6263</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L6264" href="#L6264">6264</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6265" href="#L6265">6265</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L6266" href="#L6266">6266</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L6267" href="#L6267">6267</a> <em class="jxr_javadoccomment"> * snakeCase(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L6268" href="#L6268">6268</a> <em class="jxr_javadoccomment"> * snakeCase(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L6269" href="#L6269">6269</a> <em class="jxr_javadoccomment"> * snakeCase(<js>"hello world"</js>); <jc>// "hello_world"</jc></em>
-<a class="jxr_linenumber" name="L6270" href="#L6270">6270</a> <em class="jxr_javadoccomment"> * snakeCase(<js>"helloWorld"</js>); <jc>// "hello_world"</jc></em>
-<a class="jxr_linenumber" name="L6271" href="#L6271">6271</a> <em class="jxr_javadoccomment"> * snakeCase(<js>"HelloWorld"</js>); <jc>// "hello_world"</jc></em>
-<a class="jxr_linenumber" name="L6272" href="#L6272">6272</a> <em class="jxr_javadoccomment"> * snakeCase(<js>"hello-world"</js>); <jc>// "hello_world"</jc></em>
-<a class="jxr_linenumber" name="L6273" href="#L6273">6273</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L6274" href="#L6274">6274</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6275" href="#L6275">6275</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
-<a class="jxr_linenumber" name="L6276" href="#L6276">6276</a> <em class="jxr_javadoccomment"> * @return The snake_case string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6277" href="#L6277">6277</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6278" href="#L6278">6278</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String snakeCase(String str) {
-<a class="jxr_linenumber" name="L6279" href="#L6279">6279</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6280" href="#L6280">6280</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6281" href="#L6281">6281</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L6282" href="#L6282">6282</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L6283" href="#L6283">6283</a>
-<a class="jxr_linenumber" name="L6284" href="#L6284">6284</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
-<a class="jxr_linenumber" name="L6285" href="#L6285">6285</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
-<a class="jxr_linenumber" name="L6286" href="#L6286">6286</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L6240" href="#L6240">6240</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
+<a class="jxr_linenumber" name="L6241" href="#L6241">6241</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
+<a class="jxr_linenumber" name="L6242" href="#L6242">6242</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L6243" href="#L6243">6243</a>
+<a class="jxr_linenumber" name="L6244" href="#L6244">6244</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L6245" href="#L6245">6245</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
+<a class="jxr_linenumber" name="L6246" href="#L6246">6246</a> <strong class="jxr_keyword">var</strong> word = words.get(i);
+<a class="jxr_linenumber" name="L6247" href="#L6247">6247</a> <strong class="jxr_keyword">if</strong> (i == 0) {
+<a class="jxr_linenumber" name="L6248" href="#L6248">6248</a> result.append(uncapitalize(word));
+<a class="jxr_linenumber" name="L6249" href="#L6249">6249</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L6250" href="#L6250">6250</a> result.append(capitalize(word.toLowerCase()));
+<a class="jxr_linenumber" name="L6251" href="#L6251">6251</a> }
+<a class="jxr_linenumber" name="L6252" href="#L6252">6252</a> }
+<a class="jxr_linenumber" name="L6253" href="#L6253">6253</a>
+<a class="jxr_linenumber" name="L6254" href="#L6254">6254</a> <strong class="jxr_keyword">return</strong> result.toString();
+<a class="jxr_linenumber" name="L6255" href="#L6255">6255</a> }
+<a class="jxr_linenumber" name="L6256" href="#L6256">6256</a>
+<a class="jxr_linenumber" name="L6257" href="#L6257">6257</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6258" href="#L6258">6258</a> <em class="jxr_javadoccomment"> * Converts a string to snake_case format.</em>
+<a class="jxr_linenumber" name="L6259" href="#L6259">6259</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6260" href="#L6260">6260</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L6261" href="#L6261">6261</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
+<a class="jxr_linenumber" name="L6262" href="#L6262">6262</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L6263" href="#L6263">6263</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "hello_world"</li></em>
+<a class="jxr_linenumber" name="L6264" href="#L6264">6264</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "hello_world"</li></em>
+<a class="jxr_linenumber" name="L6265" href="#L6265">6265</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "hello_world"</li></em>
+<a class="jxr_linenumber" name="L6266" href="#L6266">6266</a> <em class="jxr_javadoccomment"> * <li>Kebab-case: "hello-world" → "hello_world"</li></em>
+<a class="jxr_linenumber" name="L6267" href="#L6267">6267</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L6268" href="#L6268">6268</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6269" href="#L6269">6269</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L6270" href="#L6270">6270</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L6271" href="#L6271">6271</a> <em class="jxr_javadoccomment"> * snakeCase(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L6272" href="#L6272">6272</a> <em class="jxr_javadoccomment"> * snakeCase(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L6273" href="#L6273">6273</a> <em class="jxr_javadoccomment"> * snakeCase(<js>"hello world"</js>); <jc>// "hello_world"</jc></em>
+<a class="jxr_linenumber" name="L6274" href="#L6274">6274</a> <em class="jxr_javadoccomment"> * snakeCase(<js>"helloWorld"</js>); <jc>// "hello_world"</jc></em>
+<a class="jxr_linenumber" name="L6275" href="#L6275">6275</a> <em class="jxr_javadoccomment"> * snakeCase(<js>"HelloWorld"</js>); <jc>// "hello_world"</jc></em>
+<a class="jxr_linenumber" name="L6276" href="#L6276">6276</a> <em class="jxr_javadoccomment"> * snakeCase(<js>"hello-world"</js>); <jc>// "hello_world"</jc></em>
+<a class="jxr_linenumber" name="L6277" href="#L6277">6277</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L6278" href="#L6278">6278</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6279" href="#L6279">6279</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
+<a class="jxr_linenumber" name="L6280" href="#L6280">6280</a> <em class="jxr_javadoccomment"> * @return The snake_case string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6281" href="#L6281">6281</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6282" href="#L6282">6282</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String snakeCase(String str) {
+<a class="jxr_linenumber" name="L6283" href="#L6283">6283</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6284" href="#L6284">6284</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6285" href="#L6285">6285</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L6286" href="#L6286">6286</a> <strong class="jxr_keyword">return</strong> str;
<a class="jxr_linenumber" name="L6287" href="#L6287">6287</a>
-<a class="jxr_linenumber" name="L6288" href="#L6288">6288</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L6289" href="#L6289">6289</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
-<a class="jxr_linenumber" name="L6290" href="#L6290">6290</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L6291" href="#L6291">6291</a> result.append('_');
-<a class="jxr_linenumber" name="L6292" href="#L6292">6292</a> result.append(words.get(i).toLowerCase());
-<a class="jxr_linenumber" name="L6293" href="#L6293">6293</a> }
-<a class="jxr_linenumber" name="L6294" href="#L6294">6294</a>
-<a class="jxr_linenumber" name="L6295" href="#L6295">6295</a> <strong class="jxr_keyword">return</strong> result.toString();
-<a class="jxr_linenumber" name="L6296" href="#L6296">6296</a> }
-<a class="jxr_linenumber" name="L6297" href="#L6297">6297</a>
-<a class="jxr_linenumber" name="L6298" href="#L6298">6298</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6299" href="#L6299">6299</a> <em class="jxr_javadoccomment"> * Converts a string to kebab-case format.</em>
-<a class="jxr_linenumber" name="L6300" href="#L6300">6300</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6301" href="#L6301">6301</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L6302" href="#L6302">6302</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
-<a class="jxr_linenumber" name="L6303" href="#L6303">6303</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L6304" href="#L6304">6304</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "hello-world"</li></em>
-<a class="jxr_linenumber" name="L6305" href="#L6305">6305</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "hello-world"</li></em>
-<a class="jxr_linenumber" name="L6306" href="#L6306">6306</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "hello-world"</li></em>
-<a class="jxr_linenumber" name="L6307" href="#L6307">6307</a> <em class="jxr_javadoccomment"> * <li>Snake_case: "hello_world" → "hello-world"</li></em>
-<a class="jxr_linenumber" name="L6308" href="#L6308">6308</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L6309" href="#L6309">6309</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6310" href="#L6310">6310</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L6311" href="#L6311">6311</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L6312" href="#L6312">6312</a> <em class="jxr_javadoccomment"> * kebabCase(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L6313" href="#L6313">6313</a> <em class="jxr_javadoccomment"> * kebabCase(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L6314" href="#L6314">6314</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"hello world"</js>); <jc>// "hello-world"</jc></em>
-<a class="jxr_linenumber" name="L6315" href="#L6315">6315</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"helloWorld"</js>); <jc>// "hello-world"</jc></em>
-<a class="jxr_linenumber" name="L6316" href="#L6316">6316</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"HelloWorld"</js>); <jc>// "hello-world"</jc></em>
-<a class="jxr_linenumber" name="L6317" href="#L6317">6317</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"hello_world"</js>); <jc>// "hello-world"</jc></em>
-<a class="jxr_linenumber" name="L6318" href="#L6318">6318</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L6319" href="#L6319">6319</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6320" href="#L6320">6320</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
-<a class="jxr_linenumber" name="L6321" href="#L6321">6321</a> <em class="jxr_javadoccomment"> * @return The kebab-case string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6322" href="#L6322">6322</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6323" href="#L6323">6323</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String kebabCase(String str) {
-<a class="jxr_linenumber" name="L6324" href="#L6324">6324</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6325" href="#L6325">6325</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6326" href="#L6326">6326</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L6327" href="#L6327">6327</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L6328" href="#L6328">6328</a>
-<a class="jxr_linenumber" name="L6329" href="#L6329">6329</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
-<a class="jxr_linenumber" name="L6330" href="#L6330">6330</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
-<a class="jxr_linenumber" name="L6331" href="#L6331">6331</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L6288" href="#L6288">6288</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
+<a class="jxr_linenumber" name="L6289" href="#L6289">6289</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
+<a class="jxr_linenumber" name="L6290" href="#L6290">6290</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L6291" href="#L6291">6291</a>
+<a class="jxr_linenumber" name="L6292" href="#L6292">6292</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L6293" href="#L6293">6293</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
+<a class="jxr_linenumber" name="L6294" href="#L6294">6294</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L6295" href="#L6295">6295</a> result.append('_');
+<a class="jxr_linenumber" name="L6296" href="#L6296">6296</a> result.append(words.get(i).toLowerCase());
+<a class="jxr_linenumber" name="L6297" href="#L6297">6297</a> }
+<a class="jxr_linenumber" name="L6298" href="#L6298">6298</a>
+<a class="jxr_linenumber" name="L6299" href="#L6299">6299</a> <strong class="jxr_keyword">return</strong> result.toString();
+<a class="jxr_linenumber" name="L6300" href="#L6300">6300</a> }
+<a class="jxr_linenumber" name="L6301" href="#L6301">6301</a>
+<a class="jxr_linenumber" name="L6302" href="#L6302">6302</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6303" href="#L6303">6303</a> <em class="jxr_javadoccomment"> * Converts a string to kebab-case format.</em>
+<a class="jxr_linenumber" name="L6304" href="#L6304">6304</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6305" href="#L6305">6305</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L6306" href="#L6306">6306</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
+<a class="jxr_linenumber" name="L6307" href="#L6307">6307</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L6308" href="#L6308">6308</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "hello-world"</li></em>
+<a class="jxr_linenumber" name="L6309" href="#L6309">6309</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "hello-world"</li></em>
+<a class="jxr_linenumber" name="L6310" href="#L6310">6310</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "hello-world"</li></em>
+<a class="jxr_linenumber" name="L6311" href="#L6311">6311</a> <em class="jxr_javadoccomment"> * <li>Snake_case: "hello_world" → "hello-world"</li></em>
+<a class="jxr_linenumber" name="L6312" href="#L6312">6312</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L6313" href="#L6313">6313</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6314" href="#L6314">6314</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L6315" href="#L6315">6315</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L6316" href="#L6316">6316</a> <em class="jxr_javadoccomment"> * kebabCase(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L6317" href="#L6317">6317</a> <em class="jxr_javadoccomment"> * kebabCase(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L6318" href="#L6318">6318</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"hello world"</js>); <jc>// "hello-world"</jc></em>
+<a class="jxr_linenumber" name="L6319" href="#L6319">6319</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"helloWorld"</js>); <jc>// "hello-world"</jc></em>
+<a class="jxr_linenumber" name="L6320" href="#L6320">6320</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"HelloWorld"</js>); <jc>// "hello-world"</jc></em>
+<a class="jxr_linenumber" name="L6321" href="#L6321">6321</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"hello_world"</js>); <jc>// "hello-world"</jc></em>
+<a class="jxr_linenumber" name="L6322" href="#L6322">6322</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L6323" href="#L6323">6323</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6324" href="#L6324">6324</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
+<a class="jxr_linenumber" name="L6325" href="#L6325">6325</a> <em class="jxr_javadoccomment"> * @return The kebab-case string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6326" href="#L6326">6326</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6327" href="#L6327">6327</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String kebabCase(String str) {
+<a class="jxr_linenumber" name="L6328" href="#L6328">6328</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6329" href="#L6329">6329</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6330" href="#L6330">6330</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L6331" href="#L6331">6331</a> <strong class="jxr_keyword">return</strong> str;
<a class="jxr_linenumber" name="L6332" href="#L6332">6332</a>
-<a class="jxr_linenumber" name="L6333" href="#L6333">6333</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L6334" href="#L6334">6334</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
-<a class="jxr_linenumber" name="L6335" href="#L6335">6335</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L6336" href="#L6336">6336</a> result.append('-');
-<a class="jxr_linenumber" name="L6337" href="#L6337">6337</a> result.append(words.get(i).toLowerCase());
-<a class="jxr_linenumber" name="L6338" href="#L6338">6338</a> }
-<a class="jxr_linenumber" name="L6339" href="#L6339">6339</a>
-<a class="jxr_linenumber" name="L6340" href="#L6340">6340</a> <strong class="jxr_keyword">return</strong> result.toString();
-<a class="jxr_linenumber" name="L6341" href="#L6341">6341</a> }
-<a class="jxr_linenumber" name="L6342" href="#L6342">6342</a>
-<a class="jxr_linenumber" name="L6343" href="#L6343">6343</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6344" href="#L6344">6344</a> <em class="jxr_javadoccomment"> * Converts a string to PascalCase format.</em>
-<a class="jxr_linenumber" name="L6345" href="#L6345">6345</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6346" href="#L6346">6346</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L6347" href="#L6347">6347</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
-<a class="jxr_linenumber" name="L6348" href="#L6348">6348</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L6349" href="#L6349">6349</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "HelloWorld"</li></em>
-<a class="jxr_linenumber" name="L6350" href="#L6350">6350</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "HelloWorld"</li></em>
-<a class="jxr_linenumber" name="L6351" href="#L6351">6351</a> <em class="jxr_javadoccomment"> * <li>Snake_case: "hello_world" → "HelloWorld"</li></em>
-<a class="jxr_linenumber" name="L6352" href="#L6352">6352</a> <em class="jxr_javadoccomment"> * <li>Kebab-case: "hello-world" → "HelloWorld"</li></em>
-<a class="jxr_linenumber" name="L6353" href="#L6353">6353</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L6354" href="#L6354">6354</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6355" href="#L6355">6355</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L6356" href="#L6356">6356</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L6357" href="#L6357">6357</a> <em class="jxr_javadoccomment"> * pascalCase(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L6358" href="#L6358">6358</a> <em class="jxr_javadoccomment"> * pascalCase(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L6359" href="#L6359">6359</a> <em class="jxr_javadoccomment"> * pascalCase(<js>"hello world"</js>); <jc>// "HelloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6360" href="#L6360">6360</a> <em class="jxr_javadoccomment"> * pascalCase(<js>"helloWorld"</js>); <jc>// "HelloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6361" href="#L6361">6361</a> <em class="jxr_javadoccomment"> * pascalCase(<js>"hello_world"</js>); <jc>// "HelloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6362" href="#L6362">6362</a> <em class="jxr_javadoccomment"> * pascalCase(<js>"hello-world"</js>); <jc>// "HelloWorld"</jc></em>
-<a class="jxr_linenumber" name="L6363" href="#L6363">6363</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L6364" href="#L6364">6364</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6365" href="#L6365">6365</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
-<a class="jxr_linenumber" name="L6366" href="#L6366">6366</a> <em class="jxr_javadoccomment"> * @return The PascalCase string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6367" href="#L6367">6367</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6368" href="#L6368">6368</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String pascalCase(String str) {
-<a class="jxr_linenumber" name="L6369" href="#L6369">6369</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6370" href="#L6370">6370</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6371" href="#L6371">6371</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L6372" href="#L6372">6372</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L6373" href="#L6373">6373</a>
-<a class="jxr_linenumber" name="L6374" href="#L6374">6374</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
-<a class="jxr_linenumber" name="L6375" href="#L6375">6375</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
-<a class="jxr_linenumber" name="L6376" href="#L6376">6376</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L6333" href="#L6333">6333</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
+<a class="jxr_linenumber" name="L6334" href="#L6334">6334</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
+<a class="jxr_linenumber" name="L6335" href="#L6335">6335</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L6336" href="#L6336">6336</a>
+<a class="jxr_linenumber" name="L6337" href="#L6337">6337</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L6338" href="#L6338">6338</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
+<a class="jxr_linenumber" name="L6339" href="#L6339">6339</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L6340" href="#L6340">6340</a> result.append('-');
+<a class="jxr_linenumber" name="L6341" href="#L6341">6341</a> result.append(words.get(i).toLowerCase());
+<a class="jxr_linenumber" name="L6342" href="#L6342">6342</a> }
+<a class="jxr_linenumber" name="L6343" href="#L6343">6343</a>
+<a class="jxr_linenumber" name="L6344" href="#L6344">6344</a> <strong class="jxr_keyword">return</strong> result.toString();
+<a class="jxr_linenumber" name="L6345" href="#L6345">6345</a> }
+<a class="jxr_linenumber" name="L6346" href="#L6346">6346</a>
+<a class="jxr_linenumber" name="L6347" href="#L6347">6347</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6348" href="#L6348">6348</a> <em class="jxr_javadoccomment"> * Converts a string to PascalCase format.</em>
+<a class="jxr_linenumber" name="L6349" href="#L6349">6349</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6350" href="#L6350">6350</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L6351" href="#L6351">6351</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
+<a class="jxr_linenumber" name="L6352" href="#L6352">6352</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L6353" href="#L6353">6353</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "HelloWorld"</li></em>
+<a class="jxr_linenumber" name="L6354" href="#L6354">6354</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "HelloWorld"</li></em>
+<a class="jxr_linenumber" name="L6355" href="#L6355">6355</a> <em class="jxr_javadoccomment"> * <li>Snake_case: "hello_world" → "HelloWorld"</li></em>
+<a class="jxr_linenumber" name="L6356" href="#L6356">6356</a> <em class="jxr_javadoccomment"> * <li>Kebab-case: "hello-world" → "HelloWorld"</li></em>
+<a class="jxr_linenumber" name="L6357" href="#L6357">6357</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L6358" href="#L6358">6358</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6359" href="#L6359">6359</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L6360" href="#L6360">6360</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L6361" href="#L6361">6361</a> <em class="jxr_javadoccomment"> * pascalCase(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L6362" href="#L6362">6362</a> <em class="jxr_javadoccomment"> * pascalCase(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L6363" href="#L6363">6363</a> <em class="jxr_javadoccomment"> * pascalCase(<js>"hello world"</js>); <jc>// "HelloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6364" href="#L6364">6364</a> <em class="jxr_javadoccomment"> * pascalCase(<js>"helloWorld"</js>); <jc>// "HelloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6365" href="#L6365">6365</a> <em class="jxr_javadoccomment"> * pascalCase(<js>"hello_world"</js>); <jc>// "HelloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6366" href="#L6366">6366</a> <em class="jxr_javadoccomment"> * pascalCase(<js>"hello-world"</js>); <jc>// "HelloWorld"</jc></em>
+<a class="jxr_linenumber" name="L6367" href="#L6367">6367</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L6368" href="#L6368">6368</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6369" href="#L6369">6369</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
+<a class="jxr_linenumber" name="L6370" href="#L6370">6370</a> <em class="jxr_javadoccomment"> * @return The PascalCase string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6371" href="#L6371">6371</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6372" href="#L6372">6372</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String pascalCase(String str) {
+<a class="jxr_linenumber" name="L6373" href="#L6373">6373</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6374" href="#L6374">6374</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6375" href="#L6375">6375</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L6376" href="#L6376">6376</a> <strong class="jxr_keyword">return</strong> str;
<a class="jxr_linenumber" name="L6377" href="#L6377">6377</a>
-<a class="jxr_linenumber" name="L6378" href="#L6378">6378</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L6379" href="#L6379">6379</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> word : words) {
-<a class="jxr_linenumber" name="L6380" href="#L6380">6380</a> result.append(capitalize(word.toLowerCase()));
-<a class="jxr_linenumber" name="L6381" href="#L6381">6381</a> }
-<a class="jxr_linenumber" name="L6382" href="#L6382">6382</a>
-<a class="jxr_linenumber" name="L6383" href="#L6383">6383</a> <strong class="jxr_keyword">return</strong> result.toString();
-<a class="jxr_linenumber" name="L6384" href="#L6384">6384</a> }
-<a class="jxr_linenumber" name="L6385" href="#L6385">6385</a>
-<a class="jxr_linenumber" name="L6386" href="#L6386">6386</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6387" href="#L6387">6387</a> <em class="jxr_javadoccomment"> * Converts a string to Title Case format (first letter of each word capitalized, separated by spaces).</em>
-<a class="jxr_linenumber" name="L6388" href="#L6388">6388</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6389" href="#L6389">6389</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L6390" href="#L6390">6390</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
-<a class="jxr_linenumber" name="L6391" href="#L6391">6391</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L6392" href="#L6392">6392</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "Hello World"</li></em>
-<a class="jxr_linenumber" name="L6393" href="#L6393">6393</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "Hello World"</li></em>
-<a class="jxr_linenumber" name="L6394" href="#L6394">6394</a> <em class="jxr_javadoccomment"> * <li>Snake_case: "hello_world" → "Hello World"</li></em>
-<a class="jxr_linenumber" name="L6395" href="#L6395">6395</a> <em class="jxr_javadoccomment"> * <li>Kebab-case: "hello-world" → "Hello World"</li></em>
-<a class="jxr_linenumber" name="L6396" href="#L6396">6396</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L6397" href="#L6397">6397</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6398" href="#L6398">6398</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L6399" href="#L6399">6399</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L6400" href="#L6400">6400</a> <em class="jxr_javadoccomment"> * titleCase(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L6401" href="#L6401">6401</a> <em class="jxr_javadoccomment"> * titleCase(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L6402" href="#L6402">6402</a> <em class="jxr_javadoccomment"> * titleCase(<js>"hello world"</js>); <jc>// "Hello World"</jc></em>
-<a class="jxr_linenumber" name="L6403" href="#L6403">6403</a> <em class="jxr_javadoccomment"> * titleCase(<js>"helloWorld"</js>); <jc>// "Hello World"</jc></em>
-<a class="jxr_linenumber" name="L6404" href="#L6404">6404</a> <em class="jxr_javadoccomment"> * titleCase(<js>"hello_world"</js>); <jc>// "Hello World"</jc></em>
-<a class="jxr_linenumber" name="L6405" href="#L6405">6405</a> <em class="jxr_javadoccomment"> * titleCase(<js>"hello-world"</js>); <jc>// "Hello World"</jc></em>
-<a class="jxr_linenumber" name="L6406" href="#L6406">6406</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L6407" href="#L6407">6407</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6408" href="#L6408">6408</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
-<a class="jxr_linenumber" name="L6409" href="#L6409">6409</a> <em class="jxr_javadoccomment"> * @return The Title Case string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6410" href="#L6410">6410</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6411" href="#L6411">6411</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String titleCase(String str) {
-<a class="jxr_linenumber" name="L6412" href="#L6412">6412</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6413" href="#L6413">6413</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6414" href="#L6414">6414</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L6415" href="#L6415">6415</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L6416" href="#L6416">6416</a>
-<a class="jxr_linenumber" name="L6417" href="#L6417">6417</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
-<a class="jxr_linenumber" name="L6418" href="#L6418">6418</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
-<a class="jxr_linenumber" name="L6419" href="#L6419">6419</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L6378" href="#L6378">6378</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
+<a class="jxr_linenumber" name="L6379" href="#L6379">6379</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
+<a class="jxr_linenumber" name="L6380" href="#L6380">6380</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L6381" href="#L6381">6381</a>
+<a class="jxr_linenumber" name="L6382" href="#L6382">6382</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L6383" href="#L6383">6383</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> word : words) {
+<a class="jxr_linenumber" name="L6384" href="#L6384">6384</a> result.append(capitalize(word.toLowerCase()));
+<a class="jxr_linenumber" name="L6385" href="#L6385">6385</a> }
+<a class="jxr_linenumber" name="L6386" href="#L6386">6386</a>
+<a class="jxr_linenumber" name="L6387" href="#L6387">6387</a> <strong class="jxr_keyword">return</strong> result.toString();
+<a class="jxr_linenumber" name="L6388" href="#L6388">6388</a> }
+<a class="jxr_linenumber" name="L6389" href="#L6389">6389</a>
+<a class="jxr_linenumber" name="L6390" href="#L6390">6390</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6391" href="#L6391">6391</a> <em class="jxr_javadoccomment"> * Converts a string to Title Case format (first letter of each word capitalized, separated by spaces).</em>
+<a class="jxr_linenumber" name="L6392" href="#L6392">6392</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6393" href="#L6393">6393</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L6394" href="#L6394">6394</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
+<a class="jxr_linenumber" name="L6395" href="#L6395">6395</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L6396" href="#L6396">6396</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "Hello World"</li></em>
+<a class="jxr_linenumber" name="L6397" href="#L6397">6397</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "Hello World"</li></em>
+<a class="jxr_linenumber" name="L6398" href="#L6398">6398</a> <em class="jxr_javadoccomment"> * <li>Snake_case: "hello_world" → "Hello World"</li></em>
+<a class="jxr_linenumber" name="L6399" href="#L6399">6399</a> <em class="jxr_javadoccomment"> * <li>Kebab-case: "hello-world" → "Hello World"</li></em>
+<a class="jxr_linenumber" name="L6400" href="#L6400">6400</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L6401" href="#L6401">6401</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6402" href="#L6402">6402</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L6403" href="#L6403">6403</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L6404" href="#L6404">6404</a> <em class="jxr_javadoccomment"> * titleCase(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L6405" href="#L6405">6405</a> <em class="jxr_javadoccomment"> * titleCase(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L6406" href="#L6406">6406</a> <em class="jxr_javadoccomment"> * titleCase(<js>"hello world"</js>); <jc>// "Hello World"</jc></em>
+<a class="jxr_linenumber" name="L6407" href="#L6407">6407</a> <em class="jxr_javadoccomment"> * titleCase(<js>"helloWorld"</js>); <jc>// "Hello World"</jc></em>
+<a class="jxr_linenumber" name="L6408" href="#L6408">6408</a> <em class="jxr_javadoccomment"> * titleCase(<js>"hello_world"</js>); <jc>// "Hello World"</jc></em>
+<a class="jxr_linenumber" name="L6409" href="#L6409">6409</a> <em class="jxr_javadoccomment"> * titleCase(<js>"hello-world"</js>); <jc>// "Hello World"</jc></em>
+<a class="jxr_linenumber" name="L6410" href="#L6410">6410</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L6411" href="#L6411">6411</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6412" href="#L6412">6412</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
+<a class="jxr_linenumber" name="L6413" href="#L6413">6413</a> <em class="jxr_javadoccomment"> * @return The Title Case string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6414" href="#L6414">6414</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6415" href="#L6415">6415</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String titleCase(String str) {
+<a class="jxr_linenumber" name="L6416" href="#L6416">6416</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6417" href="#L6417">6417</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6418" href="#L6418">6418</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L6419" href="#L6419">6419</a> <strong class="jxr_keyword">return</strong> str;
<a class="jxr_linenumber" name="L6420" href="#L6420">6420</a>
-<a class="jxr_linenumber" name="L6421" href="#L6421">6421</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L6422" href="#L6422">6422</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
-<a class="jxr_linenumber" name="L6423" href="#L6423">6423</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L6424" href="#L6424">6424</a> result.append(' ');
-<a class="jxr_linenumber" name="L6425" href="#L6425">6425</a> result.append(capitalize(words.get(i).toLowerCase()));
-<a class="jxr_linenumber" name="L6426" href="#L6426">6426</a> }
-<a class="jxr_linenumber" name="L6427" href="#L6427">6427</a>
-<a class="jxr_linenumber" name="L6428" href="#L6428">6428</a> <strong class="jxr_keyword">return</strong> result.toString();
-<a class="jxr_linenumber" name="L6429" href="#L6429">6429</a> }
-<a class="jxr_linenumber" name="L6430" href="#L6430">6430</a>
-<a class="jxr_linenumber" name="L6431" href="#L6431">6431</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6432" href="#L6432">6432</a> <em class="jxr_javadoccomment"> * Removes escape characters from the specified characters.</em>
-<a class="jxr_linenumber" name="L6433" href="#L6433">6433</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6434" href="#L6434">6434</a> <em class="jxr_javadoccomment"> * @param s The string to remove escape characters from.</em>
-<a class="jxr_linenumber" name="L6435" href="#L6435">6435</a> <em class="jxr_javadoccomment"> * @param escaped The characters escaped.</em>
-<a class="jxr_linenumber" name="L6436" href="#L6436">6436</a> <em class="jxr_javadoccomment"> * @return A new string if characters were removed, or the same string if not or if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6437" href="#L6437">6437</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6438" href="#L6438">6438</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String unEscapeChars(String s, <a name="AsciiSet" href="../../../../../org/apache/juneau/common/utils/AsciiSet.html#AsciiSet">AsciiSet</a> escaped) {
-<a class="jxr_linenumber" name="L6439" href="#L6439">6439</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty())
-<a class="jxr_linenumber" name="L6440" href="#L6440">6440</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6441" href="#L6441">6441</a> <strong class="jxr_keyword">var</strong> count = 0;
-<a class="jxr_linenumber" name="L6442" href="#L6442">6442</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++)
-<a class="jxr_linenumber" name="L6443" href="#L6443">6443</a> <strong class="jxr_keyword">if</strong> (escaped.contains(s.charAt(i)))
-<a class="jxr_linenumber" name="L6444" href="#L6444">6444</a> count++;
-<a class="jxr_linenumber" name="L6445" href="#L6445">6445</a> <strong class="jxr_keyword">if</strong> (count == 0)
-<a class="jxr_linenumber" name="L6446" href="#L6446">6446</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6447" href="#L6447">6447</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuffer(s.length() - count);
-<a class="jxr_linenumber" name="L6448" href="#L6448">6448</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L6449" href="#L6449">6449</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L6450" href="#L6450">6450</a>
-<a class="jxr_linenumber" name="L6451" href="#L6451">6451</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
-<a class="jxr_linenumber" name="L6452" href="#L6452">6452</a> <strong class="jxr_keyword">if</strong> (i + 1 != s.length()) { <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6453" href="#L6453">6453</a> <strong class="jxr_keyword">var</strong> c2 = s.charAt(i + 1);
-<a class="jxr_linenumber" name="L6454" href="#L6454">6454</a> <strong class="jxr_keyword">if</strong> (escaped.contains(c2)) {
-<a class="jxr_linenumber" name="L6455" href="#L6455">6455</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6456" href="#L6456">6456</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c2 == '\\') {
-<a class="jxr_linenumber" name="L6457" href="#L6457">6457</a> sb.append('\\');
-<a class="jxr_linenumber" name="L6458" href="#L6458">6458</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6459" href="#L6459">6459</a> }
-<a class="jxr_linenumber" name="L6460" href="#L6460">6460</a> }
-<a class="jxr_linenumber" name="L6461" href="#L6461">6461</a> }
-<a class="jxr_linenumber" name="L6462" href="#L6462">6462</a> sb.append(s.charAt(i));
-<a class="jxr_linenumber" name="L6463" href="#L6463">6463</a> }
-<a class="jxr_linenumber" name="L6464" href="#L6464">6464</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L6465" href="#L6465">6465</a> }
-<a class="jxr_linenumber" name="L6466" href="#L6466">6466</a>
-<a class="jxr_linenumber" name="L6467" href="#L6467">6467</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6468" href="#L6468">6468</a> <em class="jxr_javadoccomment"> * Creates an escaped-unicode sequence (e.g. <js>"\\u1234"</js>) for the specified character.</em>
-<a class="jxr_linenumber" name="L6469" href="#L6469">6469</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6470" href="#L6470">6470</a> <em class="jxr_javadoccomment"> * @param c The character to create a sequence for.</em>
-<a class="jxr_linenumber" name="L6471" href="#L6471">6471</a> <em class="jxr_javadoccomment"> * @return An escaped-unicode sequence.</em>
-<a class="jxr_linenumber" name="L6472" href="#L6472">6472</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6473" href="#L6473">6473</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String unicodeSequence(<strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L6474" href="#L6474">6474</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(6);
-<a class="jxr_linenumber" name="L6475" href="#L6475">6475</a> sb.append('\\').append('u');
-<a class="jxr_linenumber" name="L6476" href="#L6476">6476</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> cc : toHex4(c))
-<a class="jxr_linenumber" name="L6477" href="#L6477">6477</a> sb.append(cc);
-<a class="jxr_linenumber" name="L6478" href="#L6478">6478</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L6479" href="#L6479">6479</a> }
-<a class="jxr_linenumber" name="L6480" href="#L6480">6480</a>
-<a class="jxr_linenumber" name="L6481" href="#L6481">6481</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6482" href="#L6482">6482</a> <em class="jxr_javadoccomment"> * Decodes a <c>application/x-www-form-urlencoded</c> string using <c>UTF-8</c> encoding scheme.</em>
-<a class="jxr_linenumber" name="L6483" href="#L6483">6483</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6484" href="#L6484">6484</a> <em class="jxr_javadoccomment"> * @param s The string to decode.</em>
-<a class="jxr_linenumber" name="L6485" href="#L6485">6485</a> <em class="jxr_javadoccomment"> * @return The decoded string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6486" href="#L6486">6486</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6487" href="#L6487">6487</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String urlDecode(String s) {
-<a class="jxr_linenumber" name="L6488" href="#L6488">6488</a>
-<a class="jxr_linenumber" name="L6489" href="#L6489">6489</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6490" href="#L6490">6490</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6491" href="#L6491">6491</a>
-<a class="jxr_linenumber" name="L6492" href="#L6492">6492</a> <strong class="jxr_keyword">var</strong> needsDecode = false;
-<a class="jxr_linenumber" name="L6493" href="#L6493">6493</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsDecode; i++) {
-<a class="jxr_linenumber" name="L6494" href="#L6494">6494</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L6495" href="#L6495">6495</a> <strong class="jxr_keyword">if</strong> (c == '+' || c == '%')
-<a class="jxr_linenumber" name="L6496" href="#L6496">6496</a> needsDecode = <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L6497" href="#L6497">6497</a> }
-<a class="jxr_linenumber" name="L6498" href="#L6498">6498</a>
-<a class="jxr_linenumber" name="L6499" href="#L6499">6499</a> <strong class="jxr_keyword">if</strong> (needsDecode) {
-<a class="jxr_linenumber" name="L6500" href="#L6500">6500</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L6501" href="#L6501">6501</a> <strong class="jxr_keyword">return</strong> URLDecoder.decode(s, <span class="jxr_string">"UTF-8"</span>);
-<a class="jxr_linenumber" name="L6502" href="#L6502">6502</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) UnsupportedEncodingException e) {<em class="jxr_comment">/* Won't happen */</em>}
-<a class="jxr_linenumber" name="L6503" href="#L6503">6503</a> }
-<a class="jxr_linenumber" name="L6504" href="#L6504">6504</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6505" href="#L6505">6505</a> }
-<a class="jxr_linenumber" name="L6506" href="#L6506">6506</a>
-<a class="jxr_linenumber" name="L6507" href="#L6507">6507</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6508" href="#L6508">6508</a> <em class="jxr_javadoccomment"> * Encodes a <c>application/x-www-form-urlencoded</c> string using <c>UTF-8</c> encoding scheme.</em>
-<a class="jxr_linenumber" name="L6509" href="#L6509">6509</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6510" href="#L6510">6510</a> <em class="jxr_javadoccomment"> * @param s The string to encode.</em>
-<a class="jxr_linenumber" name="L6511" href="#L6511">6511</a> <em class="jxr_javadoccomment"> * @return The encoded string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6512" href="#L6512">6512</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6513" href="#L6513">6513</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String urlEncode(String s) {
-<a class="jxr_linenumber" name="L6514" href="#L6514">6514</a>
-<a class="jxr_linenumber" name="L6515" href="#L6515">6515</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6516" href="#L6516">6516</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6517" href="#L6517">6517</a>
-<a class="jxr_linenumber" name="L6518" href="#L6518">6518</a> <strong class="jxr_keyword">var</strong> needsEncode = false;
-<a class="jxr_linenumber" name="L6519" href="#L6519">6519</a>
-<a class="jxr_linenumber" name="L6520" href="#L6520">6520</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsEncode; i++)
-<a class="jxr_linenumber" name="L6521" href="#L6521">6521</a> needsEncode |= (! unencodedChars.contains(s.charAt(i)));
-<a class="jxr_linenumber" name="L6522" href="#L6522">6522</a>
-<a class="jxr_linenumber" name="L6523" href="#L6523">6523</a> <strong class="jxr_keyword">if</strong> (needsEncode) {
-<a class="jxr_linenumber" name="L6524" href="#L6524">6524</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L6525" href="#L6525">6525</a> <strong class="jxr_keyword">return</strong> URLEncoder.encode(s, <span class="jxr_string">"UTF-8"</span>);
-<a class="jxr_linenumber" name="L6526" href="#L6526">6526</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) UnsupportedEncodingException e) {<em class="jxr_comment">/* Won't happen */</em>}
-<a class="jxr_linenumber" name="L6527" href="#L6527">6527</a> }
-<a class="jxr_linenumber" name="L6528" href="#L6528">6528</a>
-<a class="jxr_linenumber" name="L6529" href="#L6529">6529</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6530" href="#L6530">6530</a> }
-<a class="jxr_linenumber" name="L6531" href="#L6531">6531</a>
-<a class="jxr_linenumber" name="L6532" href="#L6532">6532</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6533" href="#L6533">6533</a> <em class="jxr_javadoccomment"> * Same as {@link #urlEncode(String)} except only escapes characters that absolutely need to be escaped.</em>
-<a class="jxr_linenumber" name="L6534" href="#L6534">6534</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6535" href="#L6535">6535</a> <em class="jxr_javadoccomment"> * @param s The string to escape.</em>
-<a class="jxr_linenumber" name="L6536" href="#L6536">6536</a> <em class="jxr_javadoccomment"> * @return The encoded string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6537" href="#L6537">6537</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6538" href="#L6538">6538</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String urlEncodeLax(String s) {
-<a class="jxr_linenumber" name="L6539" href="#L6539">6539</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6540" href="#L6540">6540</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6541" href="#L6541">6541</a> <strong class="jxr_keyword">var</strong> needsEncode = false;
-<a class="jxr_linenumber" name="L6542" href="#L6542">6542</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsEncode; i++)
-<a class="jxr_linenumber" name="L6543" href="#L6543">6543</a> needsEncode |= (! unencodedCharsLax.contains(s.charAt(i)));
-<a class="jxr_linenumber" name="L6544" href="#L6544">6544</a> <strong class="jxr_keyword">if</strong> (needsEncode) {
-<a class="jxr_linenumber" name="L6545" href="#L6545">6545</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(s.length() * 2);
-<a class="jxr_linenumber" name="L6546" href="#L6546">6546</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L6547" href="#L6547">6547</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L6548" href="#L6548">6548</a> <strong class="jxr_keyword">if</strong> (unencodedCharsLax.contains(c))
-<a class="jxr_linenumber" name="L6549" href="#L6549">6549</a> sb.append(c);
-<a class="jxr_linenumber" name="L6550" href="#L6550">6550</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == ' ')
-<a class="jxr_linenumber" name="L6551" href="#L6551">6551</a> sb.append(<span class="jxr_string">"+"</span>);
-<a class="jxr_linenumber" name="L6552" href="#L6552">6552</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c <= 127)
-<a class="jxr_linenumber" name="L6553" href="#L6553">6553</a> sb.append('%').append(toHex2(c));
-<a class="jxr_linenumber" name="L6554" href="#L6554">6554</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L6555" href="#L6555">6555</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L6556" href="#L6556">6556</a> sb.append(URLEncoder.encode(<span class="jxr_string">""</span> + c, <span class="jxr_string">"UTF-8"</span>)); <em class="jxr_comment">// Yuck.</em>
-<a class="jxr_linenumber" name="L6557" href="#L6557">6557</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) UnsupportedEncodingException e) {
-<a class="jxr_linenumber" name="L6558" href="#L6558">6558</a> <em class="jxr_comment">// Not possible.</em>
-<a class="jxr_linenumber" name="L6559" href="#L6559">6559</a> }
-<a class="jxr_linenumber" name="L6560" href="#L6560">6560</a> }
-<a class="jxr_linenumber" name="L6561" href="#L6561">6561</a> s = sb.toString();
-<a class="jxr_linenumber" name="L6562" href="#L6562">6562</a> }
-<a class="jxr_linenumber" name="L6563" href="#L6563">6563</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6564" href="#L6564">6564</a> }
-<a class="jxr_linenumber" name="L6565" href="#L6565">6565</a>
-<a class="jxr_linenumber" name="L6566" href="#L6566">6566</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6567" href="#L6567">6567</a> <em class="jxr_javadoccomment"> * Similar to {@link URLEncoder#encode(String, String)} but doesn't encode <js>"/"</js> characters.</em>
-<a class="jxr_linenumber" name="L6568" href="#L6568">6568</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6569" href="#L6569">6569</a> <em class="jxr_javadoccomment"> * @param o The object to encode.</em>
-<a class="jxr_linenumber" name="L6570" href="#L6570">6570</a> <em class="jxr_javadoccomment"> * @return The URL encoded string, or <jk>null</jk> if the object was null.</em>
-<a class="jxr_linenumber" name="L6571" href="#L6571">6571</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6572" href="#L6572">6572</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String urlEncodePath(Object o) {
-<a class="jxr_linenumber" name="L6573" href="#L6573">6573</a>
-<a class="jxr_linenumber" name="L6574" href="#L6574">6574</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6575" href="#L6575">6575</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6576" href="#L6576">6576</a>
-<a class="jxr_linenumber" name="L6577" href="#L6577">6577</a> <strong class="jxr_keyword">var</strong> s = s(o);
-<a class="jxr_linenumber" name="L6578" href="#L6578">6578</a>
-<a class="jxr_linenumber" name="L6579" href="#L6579">6579</a> <strong class="jxr_keyword">var</strong> needsEncode = false;
-<a class="jxr_linenumber" name="L6580" href="#L6580">6580</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsEncode; i++)
-<a class="jxr_linenumber" name="L6581" href="#L6581">6581</a> needsEncode = URL_ENCODE_PATHINFO_VALIDCHARS.contains(s.charAt(i));
-<a class="jxr_linenumber" name="L6582" href="#L6582">6582</a> <strong class="jxr_keyword">if</strong> (! needsEncode)
-<a class="jxr_linenumber" name="L6583" href="#L6583">6583</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L6584" href="#L6584">6584</a>
-<a class="jxr_linenumber" name="L6585" href="#L6585">6585</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L6586" href="#L6586">6586</a> <strong class="jxr_keyword">var</strong> caw = <strong class="jxr_keyword">new</strong> CharArrayWriter();
-<a class="jxr_linenumber" name="L6587" href="#L6587">6587</a> <strong class="jxr_keyword">var</strong> caseDiff = ('a' - 'A');
+<a class="jxr_linenumber" name="L6421" href="#L6421">6421</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
+<a class="jxr_linenumber" name="L6422" href="#L6422">6422</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
+<a class="jxr_linenumber" name="L6423" href="#L6423">6423</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L6424" href="#L6424">6424</a>
+<a class="jxr_linenumber" name="L6425" href="#L6425">6425</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L6426" href="#L6426">6426</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
+<a class="jxr_linenumber" name="L6427" href="#L6427">6427</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L6428" href="#L6428">6428</a> result.append(' ');
+<a class="jxr_linenumber" name="L6429" href="#L6429">6429</a> result.append(capitalize(words.get(i).toLowerCase()));
+<a class="jxr_linenumber" name="L6430" href="#L6430">6430</a> }
+<a class="jxr_linenumber" name="L6431" href="#L6431">6431</a>
+<a class="jxr_linenumber" name="L6432" href="#L6432">6432</a> <strong class="jxr_keyword">return</strong> result.toString();
+<a class="jxr_linenumber" name="L6433" href="#L6433">6433</a> }
+<a class="jxr_linenumber" name="L6434" href="#L6434">6434</a>
+<a class="jxr_linenumber" name="L6435" href="#L6435">6435</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6436" href="#L6436">6436</a> <em class="jxr_javadoccomment"> * Removes escape characters from the specified characters.</em>
+<a class="jxr_linenumber" name="L6437" href="#L6437">6437</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6438" href="#L6438">6438</a> <em class="jxr_javadoccomment"> * @param s The string to remove escape characters from.</em>
+<a class="jxr_linenumber" name="L6439" href="#L6439">6439</a> <em class="jxr_javadoccomment"> * @param escaped The characters escaped.</em>
+<a class="jxr_linenumber" name="L6440" href="#L6440">6440</a> <em class="jxr_javadoccomment"> * @return A new string if characters were removed, or the same string if not or if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6441" href="#L6441">6441</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6442" href="#L6442">6442</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String unEscapeChars(String s, <a name="AsciiSet" href="../../../../../org/apache/juneau/common/utils/AsciiSet.html#AsciiSet">AsciiSet</a> escaped) {
+<a class="jxr_linenumber" name="L6443" href="#L6443">6443</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty())
+<a class="jxr_linenumber" name="L6444" href="#L6444">6444</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6445" href="#L6445">6445</a> <strong class="jxr_keyword">var</strong> count = 0;
+<a class="jxr_linenumber" name="L6446" href="#L6446">6446</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++)
+<a class="jxr_linenumber" name="L6447" href="#L6447">6447</a> <strong class="jxr_keyword">if</strong> (escaped.contains(s.charAt(i)))
+<a class="jxr_linenumber" name="L6448" href="#L6448">6448</a> count++;
+<a class="jxr_linenumber" name="L6449" href="#L6449">6449</a> <strong class="jxr_keyword">if</strong> (count == 0)
+<a class="jxr_linenumber" name="L6450" href="#L6450">6450</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6451" href="#L6451">6451</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuffer(s.length() - count);
+<a class="jxr_linenumber" name="L6452" href="#L6452">6452</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L6453" href="#L6453">6453</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L6454" href="#L6454">6454</a>
+<a class="jxr_linenumber" name="L6455" href="#L6455">6455</a> <strong class="jxr_keyword">if</strong> (c == '\\') {
+<a class="jxr_linenumber" name="L6456" href="#L6456">6456</a> <strong class="jxr_keyword">if</strong> (i + 1 != s.length()) { <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6457" href="#L6457">6457</a> <strong class="jxr_keyword">var</strong> c2 = s.charAt(i + 1);
+<a class="jxr_linenumber" name="L6458" href="#L6458">6458</a> <strong class="jxr_keyword">if</strong> (escaped.contains(c2)) {
+<a class="jxr_linenumber" name="L6459" href="#L6459">6459</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6460" href="#L6460">6460</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c2 == '\\') {
+<a class="jxr_linenumber" name="L6461" href="#L6461">6461</a> sb.append('\\');
+<a class="jxr_linenumber" name="L6462" href="#L6462">6462</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6463" href="#L6463">6463</a> }
+<a class="jxr_linenumber" name="L6464" href="#L6464">6464</a> }
+<a class="jxr_linenumber" name="L6465" href="#L6465">6465</a> }
+<a class="jxr_linenumber" name="L6466" href="#L6466">6466</a> sb.append(s.charAt(i));
+<a class="jxr_linenumber" name="L6467" href="#L6467">6467</a> }
+<a class="jxr_linenumber" name="L6468" href="#L6468">6468</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L6469" href="#L6469">6469</a> }
+<a class="jxr_linenumber" name="L6470" href="#L6470">6470</a>
+<a class="jxr_linenumber" name="L6471" href="#L6471">6471</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6472" href="#L6472">6472</a> <em class="jxr_javadoccomment"> * Creates an escaped-unicode sequence (e.g. <js>"\\u1234"</js>) for the specified character.</em>
+<a class="jxr_linenumber" name="L6473" href="#L6473">6473</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6474" href="#L6474">6474</a> <em class="jxr_javadoccomment"> * @param c The character to create a sequence for.</em>
+<a class="jxr_linenumber" name="L6475" href="#L6475">6475</a> <em class="jxr_javadoccomment"> * @return An escaped-unicode sequence.</em>
+<a class="jxr_linenumber" name="L6476" href="#L6476">6476</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6477" href="#L6477">6477</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String unicodeSequence(<strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L6478" href="#L6478">6478</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(6);
+<a class="jxr_linenumber" name="L6479" href="#L6479">6479</a> sb.append('\\').append('u');
+<a class="jxr_linenumber" name="L6480" href="#L6480">6480</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> cc : toHex4(c))
+<a class="jxr_linenumber" name="L6481" href="#L6481">6481</a> sb.append(cc);
+<a class="jxr_linenumber" name="L6482" href="#L6482">6482</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L6483" href="#L6483">6483</a> }
+<a class="jxr_linenumber" name="L6484" href="#L6484">6484</a>
+<a class="jxr_linenumber" name="L6485" href="#L6485">6485</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6486" href="#L6486">6486</a> <em class="jxr_javadoccomment"> * Decodes a <c>application/x-www-form-urlencoded</c> string using <c>UTF-8</c> encoding scheme.</em>
+<a class="jxr_linenumber" name="L6487" href="#L6487">6487</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6488" href="#L6488">6488</a> <em class="jxr_javadoccomment"> * @param s The string to decode.</em>
+<a class="jxr_linenumber" name="L6489" href="#L6489">6489</a> <em class="jxr_javadoccomment"> * @return The decoded string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6490" href="#L6490">6490</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6491" href="#L6491">6491</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String urlDecode(String s) {
+<a class="jxr_linenumber" name="L6492" href="#L6492">6492</a>
+<a class="jxr_linenumber" name="L6493" href="#L6493">6493</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6494" href="#L6494">6494</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6495" href="#L6495">6495</a>
+<a class="jxr_linenumber" name="L6496" href="#L6496">6496</a> <strong class="jxr_keyword">var</strong> needsDecode = false;
+<a class="jxr_linenumber" name="L6497" href="#L6497">6497</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsDecode; i++) {
+<a class="jxr_linenumber" name="L6498" href="#L6498">6498</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L6499" href="#L6499">6499</a> <strong class="jxr_keyword">if</strong> (c == '+' || c == '%')
+<a class="jxr_linenumber" name="L6500" href="#L6500">6500</a> needsDecode = <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L6501" href="#L6501">6501</a> }
+<a class="jxr_linenumber" name="L6502" href="#L6502">6502</a>
+<a class="jxr_linenumber" name="L6503" href="#L6503">6503</a> <strong class="jxr_keyword">if</strong> (needsDecode) {
+<a class="jxr_linenumber" name="L6504" href="#L6504">6504</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L6505" href="#L6505">6505</a> <strong class="jxr_keyword">return</strong> URLDecoder.decode(s, <span class="jxr_string">"UTF-8"</span>);
+<a class="jxr_linenumber" name="L6506" href="#L6506">6506</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) UnsupportedEncodingException e) {<em class="jxr_comment">/* Won't happen */</em>}
+<a class="jxr_linenumber" name="L6507" href="#L6507">6507</a> }
+<a class="jxr_linenumber" name="L6508" href="#L6508">6508</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6509" href="#L6509">6509</a> }
+<a class="jxr_linenumber" name="L6510" href="#L6510">6510</a>
+<a class="jxr_linenumber" name="L6511" href="#L6511">6511</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6512" href="#L6512">6512</a> <em class="jxr_javadoccomment"> * Encodes a <c>application/x-www-form-urlencoded</c> string using <c>UTF-8</c> encoding scheme.</em>
+<a class="jxr_linenumber" name="L6513" href="#L6513">6513</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6514" href="#L6514">6514</a> <em class="jxr_javadoccomment"> * @param s The string to encode.</em>
+<a class="jxr_linenumber" name="L6515" href="#L6515">6515</a> <em class="jxr_javadoccomment"> * @return The encoded string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6516" href="#L6516">6516</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6517" href="#L6517">6517</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String urlEncode(String s) {
+<a class="jxr_linenumber" name="L6518" href="#L6518">6518</a>
+<a class="jxr_linenumber" name="L6519" href="#L6519">6519</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6520" href="#L6520">6520</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6521" href="#L6521">6521</a>
+<a class="jxr_linenumber" name="L6522" href="#L6522">6522</a> <strong class="jxr_keyword">var</strong> needsEncode = false;
+<a class="jxr_linenumber" name="L6523" href="#L6523">6523</a>
+<a class="jxr_linenumber" name="L6524" href="#L6524">6524</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsEncode; i++)
+<a class="jxr_linenumber" name="L6525" href="#L6525">6525</a> needsEncode |= (! unencodedChars.contains(s.charAt(i)));
+<a class="jxr_linenumber" name="L6526" href="#L6526">6526</a>
+<a class="jxr_linenumber" name="L6527" href="#L6527">6527</a> <strong class="jxr_keyword">if</strong> (needsEncode) {
+<a class="jxr_linenumber" name="L6528" href="#L6528">6528</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L6529" href="#L6529">6529</a> <strong class="jxr_keyword">return</strong> URLEncoder.encode(s, <span class="jxr_string">"UTF-8"</span>);
+<a class="jxr_linenumber" name="L6530" href="#L6530">6530</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) UnsupportedEncodingException e) {<em class="jxr_comment">/* Won't happen */</em>}
+<a class="jxr_linenumber" name="L6531" href="#L6531">6531</a> }
+<a class="jxr_linenumber" name="L6532" href="#L6532">6532</a>
+<a class="jxr_linenumber" name="L6533" href="#L6533">6533</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6534" href="#L6534">6534</a> }
+<a class="jxr_linenumber" name="L6535" href="#L6535">6535</a>
+<a class="jxr_linenumber" name="L6536" href="#L6536">6536</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6537" href="#L6537">6537</a> <em class="jxr_javadoccomment"> * Same as {@link #urlEncode(String)} except only escapes characters that absolutely need to be escaped.</em>
+<a class="jxr_linenumber" name="L6538" href="#L6538">6538</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6539" href="#L6539">6539</a> <em class="jxr_javadoccomment"> * @param s The string to escape.</em>
+<a class="jxr_linenumber" name="L6540" href="#L6540">6540</a> <em class="jxr_javadoccomment"> * @return The encoded string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6541" href="#L6541">6541</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6542" href="#L6542">6542</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String urlEncodeLax(String s) {
+<a class="jxr_linenumber" name="L6543" href="#L6543">6543</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6544" href="#L6544">6544</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6545" href="#L6545">6545</a> <strong class="jxr_keyword">var</strong> needsEncode = false;
+<a class="jxr_linenumber" name="L6546" href="#L6546">6546</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsEncode; i++)
+<a class="jxr_linenumber" name="L6547" href="#L6547">6547</a> needsEncode |= (! unencodedCharsLax.contains(s.charAt(i)));
+<a class="jxr_linenumber" name="L6548" href="#L6548">6548</a> <strong class="jxr_keyword">if</strong> (needsEncode) {
+<a class="jxr_linenumber" name="L6549" href="#L6549">6549</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(s.length() * 2);
+<a class="jxr_linenumber" name="L6550" href="#L6550">6550</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L6551" href="#L6551">6551</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L6552" href="#L6552">6552</a> <strong class="jxr_keyword">if</strong> (unencodedCharsLax.contains(c))
+<a class="jxr_linenumber" name="L6553" href="#L6553">6553</a> sb.append(c);
+<a class="jxr_linenumber" name="L6554" href="#L6554">6554</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == ' ')
+<a class="jxr_linenumber" name="L6555" href="#L6555">6555</a> sb.append(<span class="jxr_string">"+"</span>);
+<a class="jxr_linenumber" name="L6556" href="#L6556">6556</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c <= 127)
+<a class="jxr_linenumber" name="L6557" href="#L6557">6557</a> sb.append('%').append(toHex2(c));
+<a class="jxr_linenumber" name="L6558" href="#L6558">6558</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L6559" href="#L6559">6559</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L6560" href="#L6560">6560</a> sb.append(URLEncoder.encode(<span class="jxr_string">""</span> + c, <span class="jxr_string">"UTF-8"</span>)); <em class="jxr_comment">// Yuck.</em>
+<a class="jxr_linenumber" name="L6561" href="#L6561">6561</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) UnsupportedEncodingException e) {
+<a class="jxr_linenumber" name="L6562" href="#L6562">6562</a> <em class="jxr_comment">// Not possible.</em>
+<a class="jxr_linenumber" name="L6563" href="#L6563">6563</a> }
+<a class="jxr_linenumber" name="L6564" href="#L6564">6564</a> }
+<a class="jxr_linenumber" name="L6565" href="#L6565">6565</a> s = sb.toString();
+<a class="jxr_linenumber" name="L6566" href="#L6566">6566</a> }
+<a class="jxr_linenumber" name="L6567" href="#L6567">6567</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L6568" href="#L6568">6568</a> }
+<a class="jxr_linenumber" name="L6569" href="#L6569">6569</a>
+<a class="jxr_linenumber" name="L6570" href="#L6570">6570</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6571" href="#L6571">6571</a> <em class="jxr_javadoccomment"> * Similar to {@link URLEncoder#encode(String, String)} but doesn't encode <js>"/"</js> characters.</em>
+<a class="jxr_linenumber" name="L6572" href="#L6572">6572</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6573" href="#L6573">6573</a> <em class="jxr_javadoccomment"> * @param o The object to encode.</em>
+<a class="jxr_linenumber" name="L6574" href="#L6574">6574</a> <em class="jxr_javadoccomment"> * @return The URL encoded string, or <jk>null</jk> if the object was null.</em>
+<a class="jxr_linenumber" name="L6575" href="#L6575">6575</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6576" href="#L6576">6576</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String urlEncodePath(Object o) {
+<a class="jxr_linenumber" name="L6577" href="#L6577">6577</a>
+<a class="jxr_linenumber" name="L6578" href="#L6578">6578</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6579" href="#L6579">6579</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6580" href="#L6580">6580</a>
+<a class="jxr_linenumber" name="L6581" href="#L6581">6581</a> <strong class="jxr_keyword">var</strong> s = s(o);
+<a class="jxr_linenumber" name="L6582" href="#L6582">6582</a>
+<a class="jxr_linenumber" name="L6583" href="#L6583">6583</a> <strong class="jxr_keyword">var</strong> needsEncode = false;
+<a class="jxr_linenumber" name="L6584" href="#L6584">6584</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length() && ! needsEncode; i++)
+<a class="jxr_linenumber" name="L6585" href="#L6585">6585</a> needsEncode = URL_ENCODE_PATHINFO_VALIDCHARS.contains(s.charAt(i));
+<a class="jxr_linenumber" name="L6586" href="#L6586">6586</a> <strong class="jxr_keyword">if</strong> (! needsEncode)
+<a class="jxr_linenumber" name="L6587" href="#L6587">6587</a> <strong class="jxr_keyword">return</strong> s;
<a class="jxr_linenumber" name="L6588" href="#L6588">6588</a>
-<a class="jxr_linenumber" name="L6589" href="#L6589">6589</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length();) {
-<a class="jxr_linenumber" name="L6590" href="#L6590">6590</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L6591" href="#L6591">6591</a> <strong class="jxr_keyword">if</strong> (URL_ENCODE_PATHINFO_VALIDCHARS.contains(c)) {
-<a class="jxr_linenumber" name="L6592" href="#L6592">6592</a> sb.append(c);
-<a class="jxr_linenumber" name="L6593" href="#L6593">6593</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6594" href="#L6594">6594</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L6595" href="#L6595">6595</a> <strong class="jxr_keyword">if</strong> (c == ' ') {
-<a class="jxr_linenumber" name="L6596" href="#L6596">6596</a> sb.append('+');
-<a class="jxr_linenumber" name="L6597" href="#L6597">6597</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6598" href="#L6598">6598</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L6599" href="#L6599">6599</a> <strong class="jxr_keyword">do</strong> {
-<a class="jxr_linenumber" name="L6600" href="#L6600">6600</a> caw.write(c);
-<a class="jxr_linenumber" name="L6601" href="#L6601">6601</a> <strong class="jxr_keyword">if</strong> (c >= 0xD800 && c <= 0xDBFF) {
-<a class="jxr_linenumber" name="L6602" href="#L6602">6602</a> <strong class="jxr_keyword">if</strong> ((i + 1) < s.length()) { <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6603" href="#L6603">6603</a> <strong class="jxr_keyword">int</strong> d = s.charAt(i + 1);
-<a class="jxr_linenumber" name="L6604" href="#L6604">6604</a> <strong class="jxr_keyword">if</strong> (d >= 0xDC00 && d <= 0xDFFF) {
-<a class="jxr_linenumber" name="L6605" href="#L6605">6605</a> caw.write(d);
-<a class="jxr_linenumber" name="L6606" href="#L6606">6606</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6607" href="#L6607">6607</a> }
-<a class="jxr_linenumber" name="L6608" href="#L6608">6608</a> }
-<a class="jxr_linenumber" name="L6609" href="#L6609">6609</a> }
-<a class="jxr_linenumber" name="L6610" href="#L6610">6610</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6611" href="#L6611">6611</a> } <strong class="jxr_keyword">while</strong> (i < s.length() && ! URL_ENCODE_PATHINFO_VALIDCHARS.contains((c = s.charAt(i)))); <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6612" href="#L6612">6612</a>
-<a class="jxr_linenumber" name="L6613" href="#L6613">6613</a> caw.flush();
-<a class="jxr_linenumber" name="L6614" href="#L6614">6614</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(caw.toCharArray());
-<a class="jxr_linenumber" name="L6615" href="#L6615">6615</a> <strong class="jxr_keyword">var</strong> ba = s2.getBytes(UTF8);
-<a class="jxr_linenumber" name="L6616" href="#L6616">6616</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> element : ba) {
-<a class="jxr_linenumber" name="L6617" href="#L6617">6617</a> sb.append('%');
-<a class="jxr_linenumber" name="L6618" href="#L6618">6618</a> <strong class="jxr_keyword">var</strong> ch = forDigit((element >> 4) & 0xF, 16);
-<a class="jxr_linenumber" name="L6619" href="#L6619">6619</a> <strong class="jxr_keyword">if</strong> (isLetter(ch)) {
-<a class="jxr_linenumber" name="L6620" href="#L6620">6620</a> ch -= caseDiff;
-<a class="jxr_linenumber" name="L6621" href="#L6621">6621</a> }
-<a class="jxr_linenumber" name="L6622" href="#L6622">6622</a> sb.append(ch);
-<a class="jxr_linenumber" name="L6623" href="#L6623">6623</a> ch = forDigit(element & 0xF, 16);
-<a class="jxr_linenumber" name="L6624" href="#L6624">6624</a> <strong class="jxr_keyword">if</strong> (isLetter(ch)) {
-<a class="jxr_linenumber" name="L6625" href="#L6625">6625</a> ch -= caseDiff;
-<a class="jxr_linenumber" name="L6626" href="#L6626">6626</a> }
-<a class="jxr_linenumber" name="L6627" href="#L6627">6627</a> sb.append(ch);
-<a class="jxr_linenumber" name="L6628" href="#L6628">6628</a> }
-<a class="jxr_linenumber" name="L6629" href="#L6629">6629</a> caw.reset();
-<a class="jxr_linenumber" name="L6630" href="#L6630">6630</a> }
-<a class="jxr_linenumber" name="L6631" href="#L6631">6631</a> }
-<a class="jxr_linenumber" name="L6632" href="#L6632">6632</a> }
-<a class="jxr_linenumber" name="L6633" href="#L6633">6633</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L6634" href="#L6634">6634</a> }
-<a class="jxr_linenumber" name="L6635" href="#L6635">6635</a>
-<a class="jxr_linenumber" name="L6636" href="#L6636">6636</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6637" href="#L6637">6637</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder, creating a new one if null.</em>
-<a class="jxr_linenumber" name="L6638" href="#L6638">6638</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6639" href="#L6639">6639</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to, or <jk>null</jk> to create a new one.</em>
-<a class="jxr_linenumber" name="L6640" href="#L6640">6640</a> <em class="jxr_javadoccomment"> * @param in The string to append.</em>
-<a class="jxr_linenumber" name="L6641" href="#L6641">6641</a> <em class="jxr_javadoccomment"> * @return The StringBuilder with the string appended.</em>
-<a class="jxr_linenumber" name="L6642" href="#L6642">6642</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6643" href="#L6643">6643</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> StringBuilder append(StringBuilder sb, String in) {
-<a class="jxr_linenumber" name="L6644" href="#L6644">6644</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6645" href="#L6645">6645</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> StringBuilder(in);
-<a class="jxr_linenumber" name="L6646" href="#L6646">6646</a> sb.append(in);
-<a class="jxr_linenumber" name="L6647" href="#L6647">6647</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L6648" href="#L6648">6648</a> }
-<a class="jxr_linenumber" name="L6649" href="#L6649">6649</a>
-<a class="jxr_linenumber" name="L6650" href="#L6650">6650</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6651" href="#L6651">6651</a> <em class="jxr_javadoccomment"> * Finds the first non-whitespace, non-comment character in a string.</em>
-<a class="jxr_linenumber" name="L6652" href="#L6652">6652</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6653" href="#L6653">6653</a> <em class="jxr_javadoccomment"> * @param s The string to analyze.</em>
-<a class="jxr_linenumber" name="L6654" href="#L6654">6654</a> <em class="jxr_javadoccomment"> * @return The first real character, or <c>-1</c> if none found.</em>
-<a class="jxr_linenumber" name="L6655" href="#L6655">6655</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6656" href="#L6656">6656</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> firstRealCharacter(String s) {
-<a class="jxr_linenumber" name="L6657" href="#L6657">6657</a> <strong class="jxr_keyword">try</strong> (<strong class="jxr_keyword">var</strong> r = <strong class="jxr_keyword">new</strong> StringReader(s)) {
-<a class="jxr_linenumber" name="L6658" href="#L6658">6658</a> <strong class="jxr_keyword">var</strong> c = 0;
-<a class="jxr_linenumber" name="L6659" href="#L6659">6659</a> <strong class="jxr_keyword">while</strong> ((c = r.read()) != -1) {
-<a class="jxr_linenumber" name="L6660" href="#L6660">6660</a> <strong class="jxr_keyword">if</strong> (! isWhitespace(c)) {
-<a class="jxr_linenumber" name="L6661" href="#L6661">6661</a> <strong class="jxr_keyword">if</strong> (c == '/') {
-<a class="jxr_linenumber" name="L6662" href="#L6662">6662</a> skipComments(r);
-<a class="jxr_linenumber" name="L6663" href="#L6663">6663</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L6664" href="#L6664">6664</a> <strong class="jxr_keyword">return</strong> c;
-<a class="jxr_linenumber" name="L6665" href="#L6665">6665</a> }
-<a class="jxr_linenumber" name="L6666" href="#L6666">6666</a> }
-<a class="jxr_linenumber" name="L6667" href="#L6667">6667</a> }
-<a class="jxr_linenumber" name="L6668" href="#L6668">6668</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L6669" href="#L6669">6669</a> } <strong class="jxr_keyword">catch</strong> (Exception e) {
-<a class="jxr_linenumber" name="L6670" href="#L6670">6670</a> <strong class="jxr_keyword">throw</strong> toRex(e);
-<a class="jxr_linenumber" name="L6671" href="#L6671">6671</a> }
-<a class="jxr_linenumber" name="L6672" href="#L6672">6672</a> }
-<a class="jxr_linenumber" name="L6673" href="#L6673">6673</a>
-<a class="jxr_linenumber" name="L6674" href="#L6674">6674</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6675" href="#L6675">6675</a> <em class="jxr_javadoccomment"> * Determines the multiplier value based on the suffix character in a string.</em>
-<a class="jxr_linenumber" name="L6676" href="#L6676">6676</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6677" href="#L6677">6677</a> <em class="jxr_javadoccomment"> * @param s The string to analyze for multiplier suffix.</em>
-<a class="jxr_linenumber" name="L6678" href="#L6678">6678</a> <em class="jxr_javadoccomment"> * @return The multiplier value (1 if no valid suffix found).</em>
-<a class="jxr_linenumber" name="L6679" href="#L6679">6679</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6680" href="#L6680">6680</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> multiplier(String s) {
-<a class="jxr_linenumber" name="L6681" href="#L6681">6681</a> <strong class="jxr_keyword">var</strong> c = isEmpty(s) ? 'z' : s.charAt(s.length() - 1);
-<a class="jxr_linenumber" name="L6682" href="#L6682">6682</a> <strong class="jxr_keyword">if</strong> (c == 'G')
-<a class="jxr_linenumber" name="L6683" href="#L6683">6683</a> <strong class="jxr_keyword">return</strong> 1024 * 1024 * 1024;
-<a class="jxr_linenumber" name="L6684" href="#L6684">6684</a> <strong class="jxr_keyword">if</strong> (c == 'M')
-<a class="jxr_linenumber" name="L6685" href="#L6685">6685</a> <strong class="jxr_keyword">return</strong> 1024 * 1024;
-<a class="jxr_linenumber" name="L6686" href="#L6686">6686</a> <strong class="jxr_keyword">if</strong> (c == 'K')
-<a class="jxr_linenumber" name="L6687" href="#L6687">6687</a> <strong class="jxr_keyword">return</strong> 1024;
-<a class="jxr_linenumber" name="L6688" href="#L6688">6688</a> <strong class="jxr_keyword">if</strong> (c == 'g')
-<a class="jxr_linenumber" name="L6689" href="#L6689">6689</a> <strong class="jxr_keyword">return</strong> 1000 * 1000 * 1000;
-<a class="jxr_linenumber" name="L6690" href="#L6690">6690</a> <strong class="jxr_keyword">if</strong> (c == 'm')
-<a class="jxr_linenumber" name="L6691" href="#L6691">6691</a> <strong class="jxr_keyword">return</strong> 1000 * 1000;
-<a class="jxr_linenumber" name="L6692" href="#L6692">6692</a> <strong class="jxr_keyword">if</strong> (c == 'k')
-<a class="jxr_linenumber" name="L6693" href="#L6693">6693</a> <strong class="jxr_keyword">return</strong> 1000;
-<a class="jxr_linenumber" name="L6694" href="#L6694">6694</a> <strong class="jxr_keyword">return</strong> 1;
-<a class="jxr_linenumber" name="L6695" href="#L6695">6695</a> }
-<a class="jxr_linenumber" name="L6696" href="#L6696">6696</a>
-<a class="jxr_linenumber" name="L6697" href="#L6697">6697</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6698" href="#L6698">6698</a> <em class="jxr_javadoccomment"> * Determines the long multiplier value based on the suffix character in a string.</em>
-<a class="jxr_linenumber" name="L6699" href="#L6699">6699</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6700" href="#L6700">6700</a> <em class="jxr_javadoccomment"> * @param s The string to analyze for multiplier suffix.</em>
-<a class="jxr_linenumber" name="L6701" href="#L6701">6701</a> <em class="jxr_javadoccomment"> * @return The multiplier value (1 if no valid suffix found).</em>
-<a class="jxr_linenumber" name="L6702" href="#L6702">6702</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6703" href="#L6703">6703</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> multiplier2(String s) {
-<a class="jxr_linenumber" name="L6704" href="#L6704">6704</a> <strong class="jxr_keyword">var</strong> c = isEmpty(s) ? 'z' : s.charAt(s.length() - 1);
-<a class="jxr_linenumber" name="L6705" href="#L6705">6705</a> <strong class="jxr_keyword">if</strong> (c == 'P')
-<a class="jxr_linenumber" name="L6706" href="#L6706">6706</a> <strong class="jxr_keyword">return</strong> 1024 * 1024 * 1024 * 1024 * 1024l;
-<a class="jxr_linenumber" name="L6707" href="#L6707">6707</a> <strong class="jxr_keyword">if</strong> (c == 'T')
-<a class="jxr_linenumber" name="L6708" href="#L6708">6708</a> <strong class="jxr_keyword">return</strong> 1024 * 1024 * 1024 * 1024l;
-<a class="jxr_linenumber" name="L6709" href="#L6709">6709</a> <strong class="jxr_keyword">if</strong> (c == 'G')
-<a class="jxr_linenumber" name="L6710" href="#L6710">6710</a> <strong class="jxr_keyword">return</strong> 1024 * 1024 * 1024l;
-<a class="jxr_linenumber" name="L6711" href="#L6711">6711</a> <strong class="jxr_keyword">if</strong> (c == 'M')
-<a class="jxr_linenumber" name="L6712" href="#L6712">6712</a> <strong class="jxr_keyword">return</strong> 1024 * 1024l;
-<a class="jxr_linenumber" name="L6713" href="#L6713">6713</a> <strong class="jxr_keyword">if</strong> (c == 'K')
-<a class="jxr_linenumber" name="L6714" href="#L6714">6714</a> <strong class="jxr_keyword">return</strong> 1024l;
-<a class="jxr_linenumber" name="L6715" href="#L6715">6715</a> <strong class="jxr_keyword">if</strong> (c == 'p')
-<a class="jxr_linenumber" name="L6716" href="#L6716">6716</a> <strong class="jxr_keyword">return</strong> 1000 * 1000 * 1000 * 1000 * 1000l;
-<a class="jxr_linenumber" name="L6717" href="#L6717">6717</a> <strong class="jxr_keyword">if</strong> (c == 't')
-<a class="jxr_linenumber" name="L6718" href="#L6718">6718</a> <strong class="jxr_keyword">return</strong> 1000 * 1000 * 1000 * 1000l;
-<a class="jxr_linenumber" name="L6719" href="#L6719">6719</a> <strong class="jxr_keyword">if</strong> (c == 'g')
-<a class="jxr_linenumber" name="L6720" href="#L6720">6720</a> <strong class="jxr_keyword">return</strong> 1000 * 1000 * 1000l;
-<a class="jxr_linenumber" name="L6721" href="#L6721">6721</a> <strong class="jxr_keyword">if</strong> (c == 'm')
-<a class="jxr_linenumber" name="L6722" href="#L6722">6722</a> <strong class="jxr_keyword">return</strong> 1000 * 1000l;
-<a class="jxr_linenumber" name="L6723" href="#L6723">6723</a> <strong class="jxr_keyword">if</strong> (c == 'k')
-<a class="jxr_linenumber" name="L6724" href="#L6724">6724</a> <strong class="jxr_keyword">return</strong> 1000l;
-<a class="jxr_linenumber" name="L6725" href="#L6725">6725</a> <strong class="jxr_keyword">return</strong> 1;
-<a class="jxr_linenumber" name="L6726" href="#L6726">6726</a> }
-<a class="jxr_linenumber" name="L6727" href="#L6727">6727</a>
-<a class="jxr_linenumber" name="L6728" href="#L6728">6728</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6729" href="#L6729">6729</a> <em class="jxr_javadoccomment"> * Skips over comment sequences in a StringReader.</em>
-<a class="jxr_linenumber" name="L6730" href="#L6730">6730</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6731" href="#L6731">6731</a> <em class="jxr_javadoccomment"> * @param r The StringReader positioned at the start of a comment.</em>
-<a class="jxr_linenumber" name="L6732" href="#L6732">6732</a> <em class="jxr_javadoccomment"> * @throws IOException If an I/O error occurs.</em>
-<a class="jxr_linenumber" name="L6733" href="#L6733">6733</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6734" href="#L6734">6734</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> skipComments(StringReader r) <strong class="jxr_keyword">throws</strong> IOException {
-<a class="jxr_linenumber" name="L6735" href="#L6735">6735</a> <strong class="jxr_keyword">var</strong> c = r.read();
-<a class="jxr_linenumber" name="L6736" href="#L6736">6736</a> <em class="jxr_comment">// "/* */" style comments</em>
-<a class="jxr_linenumber" name="L6737" href="#L6737">6737</a> <strong class="jxr_keyword">if</strong> (c == '*') {
-<a class="jxr_linenumber" name="L6738" href="#L6738">6738</a> <strong class="jxr_keyword">while</strong> (c != -1)
-<a class="jxr_linenumber" name="L6739" href="#L6739">6739</a> <strong class="jxr_keyword">if</strong> ((c = r.read()) == '*')
-<a class="jxr_linenumber" name="L6740" href="#L6740">6740</a> <strong class="jxr_keyword">if</strong> ((c = r.read()) == '/') <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L6741" href="#L6741">6741</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L6742" href="#L6742">6742</a> <em class="jxr_comment">// "//" style comments</em>
-<a class="jxr_linenumber" name="L6743" href="#L6743">6743</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '/') {
-<a class="jxr_linenumber" name="L6744" href="#L6744">6744</a> <strong class="jxr_keyword">while</strong> (c != -1) {
-<a class="jxr_linenumber" name="L6745" href="#L6745">6745</a> c = r.read();
-<a class="jxr_linenumber" name="L6746" href="#L6746">6746</a> <strong class="jxr_keyword">if</strong> (c == -1 || c == '\n')
-<a class="jxr_linenumber" name="L6747" href="#L6747">6747</a> <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L6748" href="#L6748">6748</a> }
-<a class="jxr_linenumber" name="L6749" href="#L6749">6749</a> }
-<a class="jxr_linenumber" name="L6750" href="#L6750">6750</a> }
-<a class="jxr_linenumber" name="L6751" href="#L6751">6751</a>
-<a class="jxr_linenumber" name="L6752" href="#L6752">6752</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6753" href="#L6753">6753</a> <em class="jxr_javadoccomment"> * Gets or creates an AsciiSet for escaping the specified character.</em>
-<a class="jxr_linenumber" name="L6754" href="#L6754">6754</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6755" href="#L6755">6755</a> <em class="jxr_javadoccomment"> * @param c The character to create an escape set for.</em>
-<a class="jxr_linenumber" name="L6756" href="#L6756">6756</a> <em class="jxr_javadoccomment"> * @return An AsciiSet containing the character and backslash.</em>
-<a class="jxr_linenumber" name="L6757" href="#L6757">6757</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6758" href="#L6758">6758</a> <strong class="jxr_keyword">static</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/common/utils/AsciiSet.html#AsciiSet">AsciiSet</a> getEscapeSet(<strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L6759" href="#L6759">6759</a> <strong class="jxr_keyword">return</strong> ESCAPE_SETS.computeIfAbsent(c, key -> AsciiSet.create().chars(key, '\\').build());
-<a class="jxr_linenumber" name="L6760" href="#L6760">6760</a> }
-<a class="jxr_linenumber" name="L6761" href="#L6761">6761</a>
-<a class="jxr_linenumber" name="L6762" href="#L6762">6762</a> <em class="jxr_comment">//------------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L6763" href="#L6763">6763</a> <em class="jxr_comment">// Additional utility methods</em>
-<a class="jxr_linenumber" name="L6764" href="#L6764">6764</a> <em class="jxr_comment">//------------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L6589" href="#L6589">6589</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L6590" href="#L6590">6590</a> <strong class="jxr_keyword">var</strong> caw = <strong class="jxr_keyword">new</strong> CharArrayWriter();
+<a class="jxr_linenumber" name="L6591" href="#L6591">6591</a> <strong class="jxr_keyword">var</strong> caseDiff = ('a' - 'A');
+<a class="jxr_linenumber" name="L6592" href="#L6592">6592</a>
+<a class="jxr_linenumber" name="L6593" href="#L6593">6593</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length();) {
+<a class="jxr_linenumber" name="L6594" href="#L6594">6594</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L6595" href="#L6595">6595</a> <strong class="jxr_keyword">if</strong> (URL_ENCODE_PATHINFO_VALIDCHARS.contains(c)) {
+<a class="jxr_linenumber" name="L6596" href="#L6596">6596</a> sb.append(c);
+<a class="jxr_linenumber" name="L6597" href="#L6597">6597</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6598" href="#L6598">6598</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L6599" href="#L6599">6599</a> <strong class="jxr_keyword">if</strong> (c == ' ') {
+<a class="jxr_linenumber" name="L6600" href="#L6600">6600</a> sb.append('+');
+<a class="jxr_linenumber" name="L6601" href="#L6601">6601</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6602" href="#L6602">6602</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L6603" href="#L6603">6603</a> <strong class="jxr_keyword">do</strong> {
+<a class="jxr_linenumber" name="L6604" href="#L6604">6604</a> caw.write(c);
+<a class="jxr_linenumber" name="L6605" href="#L6605">6605</a> <strong class="jxr_keyword">if</strong> (c >= 0xD800 && c <= 0xDBFF) {
+<a class="jxr_linenumber" name="L6606" href="#L6606">6606</a> <strong class="jxr_keyword">if</strong> ((i + 1) < s.length()) { <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6607" href="#L6607">6607</a> <strong class="jxr_keyword">int</strong> d = s.charAt(i + 1);
+<a class="jxr_linenumber" name="L6608" href="#L6608">6608</a> <strong class="jxr_keyword">if</strong> (d >= 0xDC00 && d <= 0xDFFF) {
+<a class="jxr_linenumber" name="L6609" href="#L6609">6609</a> caw.write(d);
+<a class="jxr_linenumber" name="L6610" href="#L6610">6610</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6611" href="#L6611">6611</a> }
+<a class="jxr_linenumber" name="L6612" href="#L6612">6612</a> }
+<a class="jxr_linenumber" name="L6613" href="#L6613">6613</a> }
+<a class="jxr_linenumber" name="L6614" href="#L6614">6614</a> i++; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6615" href="#L6615">6615</a> } <strong class="jxr_keyword">while</strong> (i < s.length() && ! URL_ENCODE_PATHINFO_VALIDCHARS.contains((c = s.charAt(i)))); <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6616" href="#L6616">6616</a>
+<a class="jxr_linenumber" name="L6617" href="#L6617">6617</a> caw.flush();
+<a class="jxr_linenumber" name="L6618" href="#L6618">6618</a> <strong class="jxr_keyword">var</strong> s2 = <strong class="jxr_keyword">new</strong> String(caw.toCharArray());
+<a class="jxr_linenumber" name="L6619" href="#L6619">6619</a> <strong class="jxr_keyword">var</strong> ba = s2.getBytes(UTF8);
+<a class="jxr_linenumber" name="L6620" href="#L6620">6620</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> element : ba) {
+<a class="jxr_linenumber" name="L6621" href="#L6621">6621</a> sb.append('%');
+<a class="jxr_linenumber" name="L6622" href="#L6622">6622</a> <strong class="jxr_keyword">var</strong> ch = forDigit((element >> 4) & 0xF, 16);
+<a class="jxr_linenumber" name="L6623" href="#L6623">6623</a> <strong class="jxr_keyword">if</strong> (isLetter(ch)) {
+<a class="jxr_linenumber" name="L6624" href="#L6624">6624</a> ch -= caseDiff;
+<a class="jxr_linenumber" name="L6625" href="#L6625">6625</a> }
+<a class="jxr_linenumber" name="L6626" href="#L6626">6626</a> sb.append(ch);
+<a class="jxr_linenumber" name="L6627" href="#L6627">6627</a> ch = forDigit(element & 0xF, 16);
+<a class="jxr_linenumber" name="L6628" href="#L6628">6628</a> <strong class="jxr_keyword">if</strong> (isLetter(ch)) {
+<a class="jxr_linenumber" name="L6629" href="#L6629">6629</a> ch -= caseDiff;
+<a class="jxr_linenumber" name="L6630" href="#L6630">6630</a> }
+<a class="jxr_linenumber" name="L6631" href="#L6631">6631</a> sb.append(ch);
+<a class="jxr_linenumber" name="L6632" href="#L6632">6632</a> }
+<a class="jxr_linenumber" name="L6633" href="#L6633">6633</a> caw.reset();
+<a class="jxr_linenumber" name="L6634" href="#L6634">6634</a> }
+<a class="jxr_linenumber" name="L6635" href="#L6635">6635</a> }
+<a class="jxr_linenumber" name="L6636" href="#L6636">6636</a> }
+<a class="jxr_linenumber" name="L6637" href="#L6637">6637</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L6638" href="#L6638">6638</a> }
+<a class="jxr_linenumber" name="L6639" href="#L6639">6639</a>
+<a class="jxr_linenumber" name="L6640" href="#L6640">6640</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6641" href="#L6641">6641</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder, creating a new one if null.</em>
+<a class="jxr_linenumber" name="L6642" href="#L6642">6642</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6643" href="#L6643">6643</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to, or <jk>null</jk> to create a new one.</em>
+<a class="jxr_linenumber" name="L6644" href="#L6644">6644</a> <em class="jxr_javadoccomment"> * @param in The string to append.</em>
+<a class="jxr_linenumber" name="L6645" href="#L6645">6645</a> <em class="jxr_javadoccomment"> * @return The StringBuilder with the string appended.</em>
+<a class="jxr_linenumber" name="L6646" href="#L6646">6646</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6647" href="#L6647">6647</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder append(StringBuilder sb, String in) {
+<a class="jxr_linenumber" name="L6648" href="#L6648">6648</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6649" href="#L6649">6649</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> StringBuilder(in);
+<a class="jxr_linenumber" name="L6650" href="#L6650">6650</a> sb.append(in);
+<a class="jxr_linenumber" name="L6651" href="#L6651">6651</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L6652" href="#L6652">6652</a> }
+<a class="jxr_linenumber" name="L6653" href="#L6653">6653</a>
+<a class="jxr_linenumber" name="L6654" href="#L6654">6654</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6655" href="#L6655">6655</a> <em class="jxr_javadoccomment"> * Finds the first non-whitespace, non-comment character in a string.</em>
+<a class="jxr_linenumber" name="L6656" href="#L6656">6656</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6657" href="#L6657">6657</a> <em class="jxr_javadoccomment"> * @param s The string to analyze.</em>
+<a class="jxr_linenumber" name="L6658" href="#L6658">6658</a> <em class="jxr_javadoccomment"> * @return The first real character, or <c>-1</c> if none found.</em>
+<a class="jxr_linenumber" name="L6659" href="#L6659">6659</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6660" href="#L6660">6660</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> firstRealCharacter(String s) {
+<a class="jxr_linenumber" name="L6661" href="#L6661">6661</a> <strong class="jxr_keyword">try</strong> (<strong class="jxr_keyword">var</strong> r = <strong class="jxr_keyword">new</strong> StringReader(s)) {
+<a class="jxr_linenumber" name="L6662" href="#L6662">6662</a> <strong class="jxr_keyword">var</strong> c = 0;
+<a class="jxr_linenumber" name="L6663" href="#L6663">6663</a> <strong class="jxr_keyword">while</strong> ((c = r.read()) != -1) {
+<a class="jxr_linenumber" name="L6664" href="#L6664">6664</a> <strong class="jxr_keyword">if</strong> (! isWhitespace(c)) {
+<a class="jxr_linenumber" name="L6665" href="#L6665">6665</a> <strong class="jxr_keyword">if</strong> (c == '/') {
+<a class="jxr_linenumber" name="L6666" href="#L6666">6666</a> skipComments(r);
+<a class="jxr_linenumber" name="L6667" href="#L6667">6667</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L6668" href="#L6668">6668</a> <strong class="jxr_keyword">return</strong> c;
+<a class="jxr_linenumber" name="L6669" href="#L6669">6669</a> }
+<a class="jxr_linenumber" name="L6670" href="#L6670">6670</a> }
+<a class="jxr_linenumber" name="L6671" href="#L6671">6671</a> }
+<a class="jxr_linenumber" name="L6672" href="#L6672">6672</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L6673" href="#L6673">6673</a> } <strong class="jxr_keyword">catch</strong> (Exception e) {
+<a class="jxr_linenumber" name="L6674" href="#L6674">6674</a> <strong class="jxr_keyword">throw</strong> toRex(e);
+<a class="jxr_linenumber" name="L6675" href="#L6675">6675</a> }
+<a class="jxr_linenumber" name="L6676" href="#L6676">6676</a> }
+<a class="jxr_linenumber" name="L6677" href="#L6677">6677</a>
+<a class="jxr_linenumber" name="L6678" href="#L6678">6678</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6679" href="#L6679">6679</a> <em class="jxr_javadoccomment"> * Determines the multiplier value based on the suffix character in a string.</em>
+<a class="jxr_linenumber" name="L6680" href="#L6680">6680</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6681" href="#L6681">6681</a> <em class="jxr_javadoccomment"> * @param s The string to analyze for multiplier suffix.</em>
+<a class="jxr_linenumber" name="L6682" href="#L6682">6682</a> <em class="jxr_javadoccomment"> * @return The multiplier value (1 if no valid suffix found).</em>
+<a class="jxr_linenumber" name="L6683" href="#L6683">6683</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6684" href="#L6684">6684</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> multiplierInt(String s) {
+<a class="jxr_linenumber" name="L6685" href="#L6685">6685</a> <strong class="jxr_keyword">var</strong> c = isEmpty(s) ? 'z' : s.charAt(s.length() - 1);
+<a class="jxr_linenumber" name="L6686" href="#L6686">6686</a> <strong class="jxr_keyword">if</strong> (c == 'G')
+<a class="jxr_linenumber" name="L6687" href="#L6687">6687</a> <strong class="jxr_keyword">return</strong> 1024 * 1024 * 1024;
+<a class="jxr_linenumber" name="L6688" href="#L6688">6688</a> <strong class="jxr_keyword">if</strong> (c == 'M')
+<a class="jxr_linenumber" name="L6689" href="#L6689">6689</a> <strong class="jxr_keyword">return</strong> 1024 * 1024;
+<a class="jxr_linenumber" name="L6690" href="#L6690">6690</a> <strong class="jxr_keyword">if</strong> (c == 'K')
+<a class="jxr_linenumber" name="L6691" href="#L6691">6691</a> <strong class="jxr_keyword">return</strong> 1024;
+<a class="jxr_linenumber" name="L6692" href="#L6692">6692</a> <strong class="jxr_keyword">if</strong> (c == 'g')
+<a class="jxr_linenumber" name="L6693" href="#L6693">6693</a> <strong class="jxr_keyword">return</strong> 1000 * 1000 * 1000;
+<a class="jxr_linenumber" name="L6694" href="#L6694">6694</a> <strong class="jxr_keyword">if</strong> (c == 'm')
+<a class="jxr_linenumber" name="L6695" href="#L6695">6695</a> <strong class="jxr_keyword">return</strong> 1000 * 1000;
+<a class="jxr_linenumber" name="L6696" href="#L6696">6696</a> <strong class="jxr_keyword">if</strong> (c == 'k')
+<a class="jxr_linenumber" name="L6697" href="#L6697">6697</a> <strong class="jxr_keyword">return</strong> 1000;
+<a class="jxr_linenumber" name="L6698" href="#L6698">6698</a> <strong class="jxr_keyword">return</strong> 1;
+<a class="jxr_linenumber" name="L6699" href="#L6699">6699</a> }
+<a class="jxr_linenumber" name="L6700" href="#L6700">6700</a>
+<a class="jxr_linenumber" name="L6701" href="#L6701">6701</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6702" href="#L6702">6702</a> <em class="jxr_javadoccomment"> * Determines the long multiplier value based on the suffix character in a string.</em>
+<a class="jxr_linenumber" name="L6703" href="#L6703">6703</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6704" href="#L6704">6704</a> <em class="jxr_javadoccomment"> * @param s The string to analyze for multiplier suffix.</em>
+<a class="jxr_linenumber" name="L6705" href="#L6705">6705</a> <em class="jxr_javadoccomment"> * @return The multiplier value (1 if no valid suffix found).</em>
+<a class="jxr_linenumber" name="L6706" href="#L6706">6706</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6707" href="#L6707">6707</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> multiplierLong(String s) {
+<a class="jxr_linenumber" name="L6708" href="#L6708">6708</a> <strong class="jxr_keyword">var</strong> c = isEmpty(s) ? 'z' : s.charAt(s.length() - 1);
+<a class="jxr_linenumber" name="L6709" href="#L6709">6709</a> <strong class="jxr_keyword">if</strong> (c == 'P')
+<a class="jxr_linenumber" name="L6710" href="#L6710">6710</a> <strong class="jxr_keyword">return</strong> 1024 * 1024 * 1024 * 1024 * 1024l;
+<a class="jxr_linenumber" name="L6711" href="#L6711">6711</a> <strong class="jxr_keyword">if</strong> (c == 'T')
+<a class="jxr_linenumber" name="L6712" href="#L6712">6712</a> <strong class="jxr_keyword">return</strong> 1024 * 1024 * 1024 * 1024l;
+<a class="jxr_linenumber" name="L6713" href="#L6713">6713</a> <strong class="jxr_keyword">if</strong> (c == 'G')
+<a class="jxr_linenumber" name="L6714" href="#L6714">6714</a> <strong class="jxr_keyword">return</strong> 1024 * 1024 * 1024l;
+<a class="jxr_linenumber" name="L6715" href="#L6715">6715</a> <strong class="jxr_keyword">if</strong> (c == 'M')
+<a class="jxr_linenumber" name="L6716" href="#L6716">6716</a> <strong class="jxr_keyword">return</strong> 1024 * 1024l;
+<a class="jxr_linenumber" name="L6717" href="#L6717">6717</a> <strong class="jxr_keyword">if</strong> (c == 'K')
+<a class="jxr_linenumber" name="L6718" href="#L6718">6718</a> <strong class="jxr_keyword">return</strong> 1024l;
+<a class="jxr_linenumber" name="L6719" href="#L6719">6719</a> <strong class="jxr_keyword">if</strong> (c == 'p')
+<a class="jxr_linenumber" name="L6720" href="#L6720">6720</a> <strong class="jxr_keyword">return</strong> 1000 * 1000 * 1000 * 1000 * 1000l;
+<a class="jxr_linenumber" name="L6721" href="#L6721">6721</a> <strong class="jxr_keyword">if</strong> (c == 't')
+<a class="jxr_linenumber" name="L6722" href="#L6722">6722</a> <strong class="jxr_keyword">return</strong> 1000 * 1000 * 1000 * 1000l;
+<a class="jxr_linenumber" name="L6723" href="#L6723">6723</a> <strong class="jxr_keyword">if</strong> (c == 'g')
+<a class="jxr_linenumber" name="L6724" href="#L6724">6724</a> <strong class="jxr_keyword">return</strong> 1000 * 1000 * 1000l;
+<a class="jxr_linenumber" name="L6725" href="#L6725">6725</a> <strong class="jxr_keyword">if</strong> (c == 'm')
+<a class="jxr_linenumber" name="L6726" href="#L6726">6726</a> <strong class="jxr_keyword">return</strong> 1000 * 1000l;
+<a class="jxr_linenumber" name="L6727" href="#L6727">6727</a> <strong class="jxr_keyword">if</strong> (c == 'k')
+<a class="jxr_linenumber" name="L6728" href="#L6728">6728</a> <strong class="jxr_keyword">return</strong> 1000l;
+<a class="jxr_linenumber" name="L6729" href="#L6729">6729</a> <strong class="jxr_keyword">return</strong> 1;
+<a class="jxr_linenumber" name="L6730" href="#L6730">6730</a> }
+<a class="jxr_linenumber" name="L6731" href="#L6731">6731</a>
+<a class="jxr_linenumber" name="L6732" href="#L6732">6732</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6733" href="#L6733">6733</a> <em class="jxr_javadoccomment"> * Skips over comment sequences in a StringReader.</em>
+<a class="jxr_linenumber" name="L6734" href="#L6734">6734</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6735" href="#L6735">6735</a> <em class="jxr_javadoccomment"> * @param r The StringReader positioned at the start of a comment.</em>
+<a class="jxr_linenumber" name="L6736" href="#L6736">6736</a> <em class="jxr_javadoccomment"> * @throws IOException If an I/O error occurs.</em>
+<a class="jxr_linenumber" name="L6737" href="#L6737">6737</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6738" href="#L6738">6738</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> skipComments(StringReader r) <strong class="jxr_keyword">throws</strong> IOException {
+<a class="jxr_linenumber" name="L6739" href="#L6739">6739</a> <strong class="jxr_keyword">var</strong> c = r.read();
+<a class="jxr_linenumber" name="L6740" href="#L6740">6740</a> <em class="jxr_comment">// "/* */" style comments</em>
+<a class="jxr_linenumber" name="L6741" href="#L6741">6741</a> <strong class="jxr_keyword">if</strong> (c == '*') {
+<a class="jxr_linenumber" name="L6742" href="#L6742">6742</a> <strong class="jxr_keyword">while</strong> (c != -1)
+<a class="jxr_linenumber" name="L6743" href="#L6743">6743</a> <strong class="jxr_keyword">if</strong> ((c = r.read()) == '*')
+<a class="jxr_linenumber" name="L6744" href="#L6744">6744</a> <strong class="jxr_keyword">if</strong> ((c = r.read()) == '/') <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L6745" href="#L6745">6745</a> <strong class="jxr_keyword">return</strong>;
+<a class="jxr_linenumber" name="L6746" href="#L6746">6746</a> <em class="jxr_comment">// "//" style comments</em>
+<a class="jxr_linenumber" name="L6747" href="#L6747">6747</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '/') {
+<a class="jxr_linenumber" name="L6748" href="#L6748">6748</a> <strong class="jxr_keyword">while</strong> (c != -1) {
+<a class="jxr_linenumber" name="L6749" href="#L6749">6749</a> c = r.read();
+<a class="jxr_linenumber" name="L6750" href="#L6750">6750</a> <strong class="jxr_keyword">if</strong> (c == -1 || c == '\n')
+<a class="jxr_linenumber" name="L6751" href="#L6751">6751</a> <strong class="jxr_keyword">return</strong>;
+<a class="jxr_linenumber" name="L6752" href="#L6752">6752</a> }
+<a class="jxr_linenumber" name="L6753" href="#L6753">6753</a> }
+<a class="jxr_linenumber" name="L6754" href="#L6754">6754</a> }
+<a class="jxr_linenumber" name="L6755" href="#L6755">6755</a>
+<a class="jxr_linenumber" name="L6756" href="#L6756">6756</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6757" href="#L6757">6757</a> <em class="jxr_javadoccomment"> * Gets or creates an AsciiSet for escaping the specified character.</em>
+<a class="jxr_linenumber" name="L6758" href="#L6758">6758</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6759" href="#L6759">6759</a> <em class="jxr_javadoccomment"> * @param c The character to create an escape set for.</em>
+<a class="jxr_linenumber" name="L6760" href="#L6760">6760</a> <em class="jxr_javadoccomment"> * @return An AsciiSet containing the character and backslash.</em>
+<a class="jxr_linenumber" name="L6761" href="#L6761">6761</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6762" href="#L6762">6762</a> <strong class="jxr_keyword">static</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/common/utils/AsciiSet.html#AsciiSet">AsciiSet</a> getEscapeSet(<strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L6763" href="#L6763">6763</a> <strong class="jxr_keyword">return</strong> ESCAPE_SETS.computeIfAbsent(c, key -> AsciiSet.create().chars(key, '\\').build());
+<a class="jxr_linenumber" name="L6764" href="#L6764">6764</a> }
<a class="jxr_linenumber" name="L6765" href="#L6765">6765</a>
-<a class="jxr_linenumber" name="L6766" href="#L6766">6766</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6767" href="#L6767">6767</a> <em class="jxr_javadoccomment"> * Converts the string to lowercase if not null.</em>
-<a class="jxr_linenumber" name="L6768" href="#L6768">6768</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6769" href="#L6769">6769</a> <em class="jxr_javadoccomment"> * @param s The string to convert.</em>
-<a class="jxr_linenumber" name="L6770" href="#L6770">6770</a> <em class="jxr_javadoccomment"> * @return The lowercase string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6771" href="#L6771">6771</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6772" href="#L6772">6772</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String lc(String s) {
-<a class="jxr_linenumber" name="L6773" href="#L6773">6773</a> <strong class="jxr_keyword">return</strong> s == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : s.toLowerCase();
-<a class="jxr_linenumber" name="L6774" href="#L6774">6774</a> }
-<a class="jxr_linenumber" name="L6775" href="#L6775">6775</a>
-<a class="jxr_linenumber" name="L6776" href="#L6776">6776</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6777" href="#L6777">6777</a> <em class="jxr_javadoccomment"> * Converts the string to uppercase if not null.</em>
-<a class="jxr_linenumber" name="L6778" href="#L6778">6778</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6779" href="#L6779">6779</a> <em class="jxr_javadoccomment"> * @param s The string to convert.</em>
-<a class="jxr_linenumber" name="L6780" href="#L6780">6780</a> <em class="jxr_javadoccomment"> * @return The uppercase string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6781" href="#L6781">6781</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6782" href="#L6782">6782</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String uc(String s) {
-<a class="jxr_linenumber" name="L6783" href="#L6783">6783</a> <strong class="jxr_keyword">return</strong> s == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : s.toUpperCase();
-<a class="jxr_linenumber" name="L6784" href="#L6784">6784</a> }
-<a class="jxr_linenumber" name="L6785" href="#L6785">6785</a>
-<a class="jxr_linenumber" name="L6786" href="#L6786">6786</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6787" href="#L6787">6787</a> <em class="jxr_javadoccomment"> * Tests two objects for case-insensitive string equality.</em>
-<a class="jxr_linenumber" name="L6788" href="#L6788">6788</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6789" href="#L6789">6789</a> <em class="jxr_javadoccomment"> * <p>Converts both objects to strings using {@link Object#toString()} before comparison.</em>
-<a class="jxr_linenumber" name="L6790" href="#L6790">6790</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6791" href="#L6791">6791</a> <em class="jxr_javadoccomment"> * @param a Object 1.</em>
-<a class="jxr_linenumber" name="L6792" href="#L6792">6792</a> <em class="jxr_javadoccomment"> * @param b Object 2.</em>
-<a class="jxr_linenumber" name="L6793" href="#L6793">6793</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if both objects are equal ignoring case.</em>
-<a class="jxr_linenumber" name="L6794" href="#L6794">6794</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6795" href="#L6795">6795</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> eqic(Object a, Object b) {
-<a class="jxr_linenumber" name="L6796" href="#L6796">6796</a> <strong class="jxr_keyword">if</strong> (a == <strong class="jxr_keyword">null</strong> && b == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6797" href="#L6797">6797</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L6798" href="#L6798">6798</a> <strong class="jxr_keyword">if</strong> (a == <strong class="jxr_keyword">null</strong> || b == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6799" href="#L6799">6799</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L6800" href="#L6800">6800</a> <strong class="jxr_keyword">return</strong> a.toString().equalsIgnoreCase(b.toString());
-<a class="jxr_linenumber" name="L6801" href="#L6801">6801</a> }
-<a class="jxr_linenumber" name="L6802" href="#L6802">6802</a>
-<a class="jxr_linenumber" name="L6803" href="#L6803">6803</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6804" href="#L6804">6804</a> <em class="jxr_javadoccomment"> * Adds the appropriate indefinite article ('a' or 'an') before a word.</em>
-<a class="jxr_linenumber" name="L6805" href="#L6805">6805</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6806" href="#L6806">6806</a> <em class="jxr_javadoccomment"> * <p>Uses a simple vowel-based rule: 'an' if the word starts with a vowel, 'a' otherwise.</em>
-<a class="jxr_linenumber" name="L6807" href="#L6807">6807</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6808" href="#L6808">6808</a> <em class="jxr_javadoccomment"> * @param subject The word to articlize.</em>
-<a class="jxr_linenumber" name="L6809" href="#L6809">6809</a> <em class="jxr_javadoccomment"> * @return The word with 'a' or 'an' prepended.</em>
-<a class="jxr_linenumber" name="L6810" href="#L6810">6810</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6811" href="#L6811">6811</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String articlized(String subject) {
-<a class="jxr_linenumber" name="L6812" href="#L6812">6812</a> <strong class="jxr_keyword">var</strong> vowels = AsciiSet.of(<span class="jxr_string">"AEIOUaeiou"</span>);
-<a class="jxr_linenumber" name="L6813" href="#L6813">6813</a> <strong class="jxr_keyword">return</strong> (vowels.contains(subject.charAt(0)) ? <span class="jxr_string">"an "</span> : <span class="jxr_string">"a "</span>) + subject;
-<a class="jxr_linenumber" name="L6814" href="#L6814">6814</a> }
-<a class="jxr_linenumber" name="L6815" href="#L6815">6815</a>
-<a class="jxr_linenumber" name="L6816" href="#L6816">6816</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6817" href="#L6817">6817</a> <em class="jxr_javadoccomment"> * Returns the first non-blank string in the array.</em>
-<a class="jxr_linenumber" name="L6818" href="#L6818">6818</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6819" href="#L6819">6819</a> <em class="jxr_javadoccomment"> * @param vals The strings to check.</em>
-<a class="jxr_linenumber" name="L6820" href="#L6820">6820</a> <em class="jxr_javadoccomment"> * @return The first non-blank string, or <jk>null</jk> if all values were blank or <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6821" href="#L6821">6821</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6822" href="#L6822">6822</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String firstNonBlank(String...vals) {
-<a class="jxr_linenumber" name="L6823" href="#L6823">6823</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : vals) {
-<a class="jxr_linenumber" name="L6824" href="#L6824">6824</a> <strong class="jxr_keyword">if</strong> (isNotBlank(v))
-<a class="jxr_linenumber" name="L6825" href="#L6825">6825</a> <strong class="jxr_keyword">return</strong> v;
-<a class="jxr_linenumber" name="L6826" href="#L6826">6826</a> }
-<a class="jxr_linenumber" name="L6827" href="#L6827">6827</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6828" href="#L6828">6828</a> }
-<a class="jxr_linenumber" name="L6829" href="#L6829">6829</a>
-<a class="jxr_linenumber" name="L6830" href="#L6830">6830</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6831" href="#L6831">6831</a> <em class="jxr_javadoccomment"> * Converts a comma-delimited string to a list.</em>
-<a class="jxr_linenumber" name="L6832" href="#L6832">6832</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6833" href="#L6833">6833</a> <em class="jxr_javadoccomment"> * @param s The comma-delimited string.</em>
-<a class="jxr_linenumber" name="L6834" href="#L6834">6834</a> <em class="jxr_javadoccomment"> * @return A new modifiable list. Never <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6835" href="#L6835">6835</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6836" href="#L6836">6836</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> cdlToList(String s) {
-<a class="jxr_linenumber" name="L6837" href="#L6837">6837</a> <strong class="jxr_keyword">return</strong> split(s);
-<a class="jxr_linenumber" name="L6838" href="#L6838">6838</a> }
-<a class="jxr_linenumber" name="L6839" href="#L6839">6839</a>
-<a class="jxr_linenumber" name="L6840" href="#L6840">6840</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6841" href="#L6841">6841</a> <em class="jxr_javadoccomment"> * Combines values into a simple comma-delimited string.</em>
-<a class="jxr_linenumber" name="L6842" href="#L6842">6842</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6843" href="#L6843">6843</a> <em class="jxr_javadoccomment"> * @param values The values to join.</em>
-<a class="jxr_linenumber" name="L6844" href="#L6844">6844</a> <em class="jxr_javadoccomment"> * @return A comma-delimited string.</em>
-<a class="jxr_linenumber" name="L6845" href="#L6845">6845</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6846" href="#L6846">6846</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(String...values) {
-<a class="jxr_linenumber" name="L6847" href="#L6847">6847</a> <strong class="jxr_keyword">return</strong> join(values, ',');
-<a class="jxr_linenumber" name="L6848" href="#L6848">6848</a> }
-<a class="jxr_linenumber" name="L6849" href="#L6849">6849</a>
-<a class="jxr_linenumber" name="L6850" href="#L6850">6850</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6851" href="#L6851">6851</a> <em class="jxr_javadoccomment"> * Combines collection values into a simple comma-delimited string.</em>
-<a class="jxr_linenumber" name="L6852" href="#L6852">6852</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6853" href="#L6853">6853</a> <em class="jxr_javadoccomment"> * @param values The values to join.</em>
-<a class="jxr_linenumber" name="L6854" href="#L6854">6854</a> <em class="jxr_javadoccomment"> * @return A comma-delimited string.</em>
-<a class="jxr_linenumber" name="L6855" href="#L6855">6855</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6856" href="#L6856">6856</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Collection<?> values) {
-<a class="jxr_linenumber" name="L6857" href="#L6857">6857</a> <strong class="jxr_keyword">return</strong> joine(toList(values), ',');
-<a class="jxr_linenumber" name="L6858" href="#L6858">6858</a> }
-<a class="jxr_linenumber" name="L6859" href="#L6859">6859</a>
-<a class="jxr_linenumber" name="L6860" href="#L6860">6860</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6861" href="#L6861">6861</a> <em class="jxr_javadoccomment"> * Null-safe not-contains check for multiple string values.</em>
-<a class="jxr_linenumber" name="L6862" href="#L6862">6862</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6863" href="#L6863">6863</a> <em class="jxr_javadoccomment"> * @param s The string to search.</em>
-<a class="jxr_linenumber" name="L6864" href="#L6864">6864</a> <em class="jxr_javadoccomment"> * @param values The values to search for.</em>
-<a class="jxr_linenumber" name="L6865" href="#L6865">6865</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain any of the values.</em>
-<a class="jxr_linenumber" name="L6866" href="#L6866">6866</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6867" href="#L6867">6867</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContains(String s, String...values) {
-<a class="jxr_linenumber" name="L6868" href="#L6868">6868</a> <strong class="jxr_keyword">return</strong> ! contains(s, values);
-<a class="jxr_linenumber" name="L6869" href="#L6869">6869</a> }
-<a class="jxr_linenumber" name="L6870" href="#L6870">6870</a>
-<a class="jxr_linenumber" name="L6871" href="#L6871">6871</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6872" href="#L6872">6872</a> <em class="jxr_javadoccomment"> * Converts a comma-delimited string to a set.</em>
-<a class="jxr_linenumber" name="L6873" href="#L6873">6873</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6874" href="#L6874">6874</a> <em class="jxr_javadoccomment"> * @param s The comma-delimited string.</em>
-<a class="jxr_linenumber" name="L6875" href="#L6875">6875</a> <em class="jxr_javadoccomment"> * @return A new {@link LinkedHashSet}. Never <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6876" href="#L6876">6876</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6877" href="#L6877">6877</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> LinkedHashSet<String> cdlToSet(String s) {
-<a class="jxr_linenumber" name="L6878" href="#L6878">6878</a> <strong class="jxr_keyword">return</strong> split(s).stream().collect(Collectors.toCollection(LinkedHashSet::<strong class="jxr_keyword">new</strong>));
-<a class="jxr_linenumber" name="L6879" href="#L6879">6879</a> }
-<a class="jxr_linenumber" name="L6880" href="#L6880">6880</a>
-<a class="jxr_linenumber" name="L6881" href="#L6881">6881</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6882" href="#L6882">6882</a> <em class="jxr_javadoccomment"> * Takes a supplier of any type and returns a {@link Supplier}{@code <String>}.</em>
-<a class="jxr_linenumber" name="L6883" href="#L6883">6883</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6884" href="#L6884">6884</a> <em class="jxr_javadoccomment"> * <p>Useful when passing arguments to loggers.</em>
-<a class="jxr_linenumber" name="L6885" href="#L6885">6885</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6886" href="#L6886">6886</a> <em class="jxr_javadoccomment"> * @param s The supplier.</em>
-<a class="jxr_linenumber" name="L6887" href="#L6887">6887</a> <em class="jxr_javadoccomment"> * @return A string supplier that calls {@link #readable(Object)} on the supplied value.</em>
-<a class="jxr_linenumber" name="L6888" href="#L6888">6888</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6889" href="#L6889">6889</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Supplier<String> stringSupplier(Supplier<?> s) {
-<a class="jxr_linenumber" name="L6890" href="#L6890">6890</a> <strong class="jxr_keyword">return</strong> () -> readable(s.get());
-<a class="jxr_linenumber" name="L6891" href="#L6891">6891</a> }
-<a class="jxr_linenumber" name="L6892" href="#L6892">6892</a>
-<a class="jxr_linenumber" name="L6893" href="#L6893">6893</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L6894" href="#L6894">6894</a> <em class="jxr_javadoccomment"> * Converts an arbitrary object to a readable string format suitable for debugging and testing.</em>
-<a class="jxr_linenumber" name="L6895" href="#L6895">6895</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6896" href="#L6896">6896</a> <em class="jxr_javadoccomment"> * <p>This method provides intelligent formatting for various Java types, recursively processing</em>
-<a class="jxr_linenumber" name="L6897" href="#L6897">6897</a> <em class="jxr_javadoccomment"> * nested structures to create human-readable representations. It's extensively used throughout</em>
-<a class="jxr_linenumber" name="L6898" href="#L6898">6898</a> <em class="jxr_javadoccomment"> * the Juneau framework for test assertions and debugging output.</p></em>
+<a class="jxr_linenumber" name="L6766" href="#L6766">6766</a> <em class="jxr_comment">//------------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L6767" href="#L6767">6767</a> <em class="jxr_comment">// Additional utility methods</em>
+<a class="jxr_linenumber" name="L6768" href="#L6768">6768</a> <em class="jxr_comment">//------------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L6769" href="#L6769">6769</a>
+<a class="jxr_linenumber" name="L6770" href="#L6770">6770</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6771" href="#L6771">6771</a> <em class="jxr_javadoccomment"> * Converts the string to lowercase if not null.</em>
+<a class="jxr_linenumber" name="L6772" href="#L6772">6772</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6773" href="#L6773">6773</a> <em class="jxr_javadoccomment"> * @param s The string to convert.</em>
+<a class="jxr_linenumber" name="L6774" href="#L6774">6774</a> <em class="jxr_javadoccomment"> * @return The lowercase string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6775" href="#L6775">6775</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6776" href="#L6776">6776</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String lowerCase(String s) {
+<a class="jxr_linenumber" name="L6777" href="#L6777">6777</a> <strong class="jxr_keyword">return</strong> s == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : s.toLowerCase();
+<a class="jxr_linenumber" name="L6778" href="#L6778">6778</a> }
+<a class="jxr_linenumber" name="L6779" href="#L6779">6779</a>
+<a class="jxr_linenumber" name="L6780" href="#L6780">6780</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6781" href="#L6781">6781</a> <em class="jxr_javadoccomment"> * Converts the string to uppercase if not null.</em>
+<a class="jxr_linenumber" name="L6782" href="#L6782">6782</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6783" href="#L6783">6783</a> <em class="jxr_javadoccomment"> * @param s The string to convert.</em>
+<a class="jxr_linenumber" name="L6784" href="#L6784">6784</a> <em class="jxr_javadoccomment"> * @return The uppercase string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6785" href="#L6785">6785</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6786" href="#L6786">6786</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String upperCase(String s) {
+<a class="jxr_linenumber" name="L6787" href="#L6787">6787</a> <strong class="jxr_keyword">return</strong> s == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : s.toUpperCase();
+<a class="jxr_linenumber" name="L6788" href="#L6788">6788</a> }
+<a class="jxr_linenumber" name="L6789" href="#L6789">6789</a>
+<a class="jxr_linenumber" name="L6790" href="#L6790">6790</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6791" href="#L6791">6791</a> <em class="jxr_javadoccomment"> * Tests two objects for case-insensitive string equality.</em>
+<a class="jxr_linenumber" name="L6792" href="#L6792">6792</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6793" href="#L6793">6793</a> <em class="jxr_javadoccomment"> * <p>Converts both objects to strings using {@link Object#toString()} before comparison.</em>
+<a class="jxr_linenumber" name="L6794" href="#L6794">6794</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6795" href="#L6795">6795</a> <em class="jxr_javadoccomment"> * @param a Object 1.</em>
+<a class="jxr_linenumber" name="L6796" href="#L6796">6796</a> <em class="jxr_javadoccomment"> * @param b Object 2.</em>
+<a class="jxr_linenumber" name="L6797" href="#L6797">6797</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if both objects are equal ignoring case.</em>
+<a class="jxr_linenumber" name="L6798" href="#L6798">6798</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6799" href="#L6799">6799</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> eqic(Object a, Object b) {
+<a class="jxr_linenumber" name="L6800" href="#L6800">6800</a> <strong class="jxr_keyword">if</strong> (a == <strong class="jxr_keyword">null</strong> && b == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6801" href="#L6801">6801</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L6802" href="#L6802">6802</a> <strong class="jxr_keyword">if</strong> (a == <strong class="jxr_keyword">null</strong> || b == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6803" href="#L6803">6803</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L6804" href="#L6804">6804</a> <strong class="jxr_keyword">return</strong> a.toString().equalsIgnoreCase(b.toString());
+<a class="jxr_linenumber" name="L6805" href="#L6805">6805</a> }
+<a class="jxr_linenumber" name="L6806" href="#L6806">6806</a>
+<a class="jxr_linenumber" name="L6807" href="#L6807">6807</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6808" href="#L6808">6808</a> <em class="jxr_javadoccomment"> * Adds the appropriate indefinite article ('a' or 'an') before a word.</em>
+<a class="jxr_linenumber" name="L6809" href="#L6809">6809</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6810" href="#L6810">6810</a> <em class="jxr_javadoccomment"> * <p>Uses a simple vowel-based rule: 'an' if the word starts with a vowel, 'a' otherwise.</em>
+<a class="jxr_linenumber" name="L6811" href="#L6811">6811</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6812" href="#L6812">6812</a> <em class="jxr_javadoccomment"> * @param subject The word to articlize.</em>
+<a class="jxr_linenumber" name="L6813" href="#L6813">6813</a> <em class="jxr_javadoccomment"> * @return The word with 'a' or 'an' prepended.</em>
+<a class="jxr_linenumber" name="L6814" href="#L6814">6814</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6815" href="#L6815">6815</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String articlized(String subject) {
+<a class="jxr_linenumber" name="L6816" href="#L6816">6816</a> <strong class="jxr_keyword">var</strong> vowels = AsciiSet.of(<span class="jxr_string">"AEIOUaeiou"</span>);
+<a class="jxr_linenumber" name="L6817" href="#L6817">6817</a> <strong class="jxr_keyword">return</strong> (vowels.contains(subject.charAt(0)) ? <span class="jxr_string">"an "</span> : <span class="jxr_string">"a "</span>) + subject;
+<a class="jxr_linenumber" name="L6818" href="#L6818">6818</a> }
+<a class="jxr_linenumber" name="L6819" href="#L6819">6819</a>
+<a class="jxr_linenumber" name="L6820" href="#L6820">6820</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6821" href="#L6821">6821</a> <em class="jxr_javadoccomment"> * Returns the first non-blank string in the array.</em>
+<a class="jxr_linenumber" name="L6822" href="#L6822">6822</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6823" href="#L6823">6823</a> <em class="jxr_javadoccomment"> * @param vals The strings to check.</em>
+<a class="jxr_linenumber" name="L6824" href="#L6824">6824</a> <em class="jxr_javadoccomment"> * @return The first non-blank string, or <jk>null</jk> if all values were blank or <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6825" href="#L6825">6825</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6826" href="#L6826">6826</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String firstNonBlank(String...vals) {
+<a class="jxr_linenumber" name="L6827" href="#L6827">6827</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : vals) {
+<a class="jxr_linenumber" name="L6828" href="#L6828">6828</a> <strong class="jxr_keyword">if</strong> (isNotBlank(v))
+<a class="jxr_linenumber" name="L6829" href="#L6829">6829</a> <strong class="jxr_keyword">return</strong> v;
+<a class="jxr_linenumber" name="L6830" href="#L6830">6830</a> }
+<a class="jxr_linenumber" name="L6831" href="#L6831">6831</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6832" href="#L6832">6832</a> }
+<a class="jxr_linenumber" name="L6833" href="#L6833">6833</a>
+<a class="jxr_linenumber" name="L6834" href="#L6834">6834</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6835" href="#L6835">6835</a> <em class="jxr_javadoccomment"> * Converts a comma-delimited string to a list.</em>
+<a class="jxr_linenumber" name="L6836" href="#L6836">6836</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6837" href="#L6837">6837</a> <em class="jxr_javadoccomment"> * @param s The comma-delimited string.</em>
+<a class="jxr_linenumber" name="L6838" href="#L6838">6838</a> <em class="jxr_javadoccomment"> * @return A new modifiable list. Never <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6839" href="#L6839">6839</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6840" href="#L6840">6840</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> cdlToList(String s) {
+<a class="jxr_linenumber" name="L6841" href="#L6841">6841</a> <strong class="jxr_keyword">return</strong> split(s);
+<a class="jxr_linenumber" name="L6842" href="#L6842">6842</a> }
+<a class="jxr_linenumber" name="L6843" href="#L6843">6843</a>
+<a class="jxr_linenumber" name="L6844" href="#L6844">6844</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6845" href="#L6845">6845</a> <em class="jxr_javadoccomment"> * Combines values into a simple comma-delimited string.</em>
+<a class="jxr_linenumber" name="L6846" href="#L6846">6846</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6847" href="#L6847">6847</a> <em class="jxr_javadoccomment"> * @param values The values to join.</em>
+<a class="jxr_linenumber" name="L6848" href="#L6848">6848</a> <em class="jxr_javadoccomment"> * @return A comma-delimited string.</em>
+<a class="jxr_linenumber" name="L6849" href="#L6849">6849</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6850" href="#L6850">6850</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(String...values) {
+<a class="jxr_linenumber" name="L6851" href="#L6851">6851</a> <strong class="jxr_keyword">return</strong> join(values, ',');
+<a class="jxr_linenumber" name="L6852" href="#L6852">6852</a> }
+<a class="jxr_linenumber" name="L6853" href="#L6853">6853</a>
+<a class="jxr_linenumber" name="L6854" href="#L6854">6854</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6855" href="#L6855">6855</a> <em class="jxr_javadoccomment"> * Combines collection values into a simple comma-delimited string.</em>
+<a class="jxr_linenumber" name="L6856" href="#L6856">6856</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6857" href="#L6857">6857</a> <em class="jxr_javadoccomment"> * @param values The values to join.</em>
+<a class="jxr_linenumber" name="L6858" href="#L6858">6858</a> <em class="jxr_javadoccomment"> * @return A comma-delimited string.</em>
+<a class="jxr_linenumber" name="L6859" href="#L6859">6859</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6860" href="#L6860">6860</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Collection<?> values) {
+<a class="jxr_linenumber" name="L6861" href="#L6861">6861</a> <strong class="jxr_keyword">return</strong> joine(toList(values), ',');
+<a class="jxr_linenumber" name="L6862" href="#L6862">6862</a> }
+<a class="jxr_linenumber" name="L6863" href="#L6863">6863</a>
+<a class="jxr_linenumber" name="L6864" href="#L6864">6864</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6865" href="#L6865">6865</a> <em class="jxr_javadoccomment"> * Null-safe not-contains check for multiple string values.</em>
+<a class="jxr_linenumber" name="L6866" href="#L6866">6866</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6867" href="#L6867">6867</a> <em class="jxr_javadoccomment"> * @param s The string to search.</em>
+<a class="jxr_linenumber" name="L6868" href="#L6868">6868</a> <em class="jxr_javadoccomment"> * @param values The values to search for.</em>
+<a class="jxr_linenumber" name="L6869" href="#L6869">6869</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain any of the values.</em>
+<a class="jxr_linenumber" name="L6870" href="#L6870">6870</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6871" href="#L6871">6871</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContains(String s, String...values) {
+<a class="jxr_linenumber" name="L6872" href="#L6872">6872</a> <strong class="jxr_keyword">return</strong> ! contains(s, values);
+<a class="jxr_linenumber" name="L6873" href="#L6873">6873</a> }
+<a class="jxr_linenumber" name="L6874" href="#L6874">6874</a>
+<a class="jxr_linenumber" name="L6875" href="#L6875">6875</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6876" href="#L6876">6876</a> <em class="jxr_javadoccomment"> * Converts a comma-delimited string to a set.</em>
+<a class="jxr_linenumber" name="L6877" href="#L6877">6877</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6878" href="#L6878">6878</a> <em class="jxr_javadoccomment"> * @param s The comma-delimited string.</em>
+<a class="jxr_linenumber" name="L6879" href="#L6879">6879</a> <em class="jxr_javadoccomment"> * @return A new {@link LinkedHashSet}. Never <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6880" href="#L6880">6880</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6881" href="#L6881">6881</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> LinkedHashSet<String> cdlToSet(String s) {
+<a class="jxr_linenumber" name="L6882" href="#L6882">6882</a> <strong class="jxr_keyword">return</strong> split(s).stream().collect(Collectors.toCollection(LinkedHashSet::<strong class="jxr_keyword">new</strong>));
+<a class="jxr_linenumber" name="L6883" href="#L6883">6883</a> }
+<a class="jxr_linenumber" name="L6884" href="#L6884">6884</a>
+<a class="jxr_linenumber" name="L6885" href="#L6885">6885</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6886" href="#L6886">6886</a> <em class="jxr_javadoccomment"> * Takes a supplier of any type and returns a {@link Supplier}{@code <String>}.</em>
+<a class="jxr_linenumber" name="L6887" href="#L6887">6887</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6888" href="#L6888">6888</a> <em class="jxr_javadoccomment"> * <p>Useful when passing arguments to loggers.</em>
+<a class="jxr_linenumber" name="L6889" href="#L6889">6889</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6890" href="#L6890">6890</a> <em class="jxr_javadoccomment"> * @param s The supplier.</em>
+<a class="jxr_linenumber" name="L6891" href="#L6891">6891</a> <em class="jxr_javadoccomment"> * @return A string supplier that calls {@link #readable(Object)} on the supplied value.</em>
+<a class="jxr_linenumber" name="L6892" href="#L6892">6892</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6893" href="#L6893">6893</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Supplier<String> stringSupplier(Supplier<?> s) {
+<a class="jxr_linenumber" name="L6894" href="#L6894">6894</a> <strong class="jxr_keyword">return</strong> () -> readable(s.get());
+<a class="jxr_linenumber" name="L6895" href="#L6895">6895</a> }
+<a class="jxr_linenumber" name="L6896" href="#L6896">6896</a>
+<a class="jxr_linenumber" name="L6897" href="#L6897">6897</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L6898" href="#L6898">6898</a> <em class="jxr_javadoccomment"> * Converts an arbitrary object to a readable string format suitable for debugging and testing.</em>
<a class="jxr_linenumber" name="L6899" href="#L6899">6899</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6900" href="#L6900">6900</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Type-Specific Formatting:</h5></em>
-<a class="jxr_linenumber" name="L6901" href="#L6901">6901</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L6902" href="#L6902">6902</a> <em class="jxr_javadoccomment"> * <li><b>null:</b> Returns <js>null</js></li></em>
-<a class="jxr_linenumber" name="L6903" href="#L6903">6903</a> <em class="jxr_javadoccomment"> * <li><b>Optional:</b> Recursively formats the contained value (or <js>null</js> if empty)</li></em>
-<a class="jxr_linenumber" name="L6904" href="#L6904">6904</a> <em class="jxr_javadoccomment"> * <li><b>Collections:</b> Formats as <js>"[item1,item2,item3]"</js> with comma-separated elements</li></em>
-<a class="jxr_linenumber" name="L6905" href="#L6905">6905</a> <em class="jxr_javadoccomment"> * <li><b>Maps:</b> Formats as <js>"{key1=value1,key2=value2}"</js> with comma-separated entries</li></em>
-<a class="jxr_linenumber" name="L6906" href="#L6906">6906</a> <em class="jxr_javadoccomment"> * <li><b>Map.Entry:</b> Formats as <js>"key=value"</js></li></em>
-<a class="jxr_linenumber" name="L6907" href="#L6907">6907</a> <em class="jxr_javadoccomment"> * <li><b>Arrays:</b> Converts to list format <js>"[item1,item2,item3]"</js></li></em>
-<a class="jxr_linenumber" name="L6908" href="#L6908">6908</a> <em class="jxr_javadoccomment"> * <li><b>Iterables/Iterators/Enumerations:</b> Converts to list and formats recursively</li></em>
-<a class="jxr_linenumber" name="L6909" href="#L6909">6909</a> <em class="jxr_javadoccomment"> * <li><b>GregorianCalendar:</b> Formats as ISO instant timestamp</li></em>
-<a class="jxr_linenumber" name="L6910" href="#L6910">6910</a> <em class="jxr_javadoccomment"> * <li><b>Date:</b> Formats as ISO instant string (e.g., <js>"2023-12-25T10:30:00Z"</js>)</li></em>
-<a class="jxr_linenumber" name="L6911" href="#L6911">6911</a> <em class="jxr_javadoccomment"> * <li><b>InputStream:</b> Converts to hexadecimal representation</li></em>
-<a class="jxr_linenumber" name="L6912" href="#L6912">6912</a> <em class="jxr_javadoccomment"> * <li><b>Reader:</b> Reads content and returns as string</li></em>
-<a class="jxr_linenumber" name="L6913" href="#L6913">6913</a> <em class="jxr_javadoccomment"> * <li><b>File:</b> Reads file content and returns as string</li></em>
-<a class="jxr_linenumber" name="L6914" href="#L6914">6914</a> <em class="jxr_javadoccomment"> * <li><b>byte[]:</b> Converts to hexadecimal representation</li></em>
-<a class="jxr_linenumber" name="L6915" href="#L6915">6915</a> <em class="jxr_javadoccomment"> * <li><b>Enum:</b> Returns the enum name via {@link Enum#name()}</li></em>
-<a class="jxr_linenumber" name="L6916" href="#L6916">6916</a> <em class="jxr_javadoccomment"> * <li><b>All other types:</b> Uses {@link Object#toString()}</li></em>
-<a class="jxr_linenumber" name="L6917" href="#L6917">6917</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L6918" href="#L6918">6918</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6919" href="#L6919">6919</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L6920" href="#L6920">6920</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L6921" href="#L6921">6921</a> <em class="jxr_javadoccomment"> * <jc>// Collections</jc></em>
-<a class="jxr_linenumber" name="L6922" href="#L6922">6922</a> <em class="jxr_javadoccomment"> * readable(List.of("a", "b", "c")) <jc>// Returns: "[a,b,c]"</jc></em>
-<a class="jxr_linenumber" name="L6923" href="#L6923">6923</a> <em class="jxr_javadoccomment"> * readable(Set.of(1, 2, 3)) <jc>// Returns: "[1,2,3]" (order may vary)</jc></em>
-<a class="jxr_linenumber" name="L6924" href="#L6924">6924</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6925" href="#L6925">6925</a> <em class="jxr_javadoccomment"> * <jc>// Maps</jc></em>
-<a class="jxr_linenumber" name="L6926" href="#L6926">6926</a> <em class="jxr_javadoccomment"> * readable(Map.of("foo", "bar", "baz", 123)) <jc>// Returns: "{foo=bar,baz=123}"</jc></em>
-<a class="jxr_linenumber" name="L6927" href="#L6927">6927</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6928" href="#L6928">6928</a> <em class="jxr_javadoccomment"> * <jc>// Arrays</jc></em>
-<a class="jxr_linenumber" name="L6929" href="#L6929">6929</a> <em class="jxr_javadoccomment"> * readable(ints(1, 2, 3)) <jc>// Returns: "[1,2,3]"</jc></em>
-<a class="jxr_linenumber" name="L6930" href="#L6930">6930</a> <em class="jxr_javadoccomment"> * readable(new String[]{"a", "b"}) <jc>// Returns: "[a,b]"</jc></em>
+<a class="jxr_linenumber" name="L6900" href="#L6900">6900</a> <em class="jxr_javadoccomment"> * <p>This method provides intelligent formatting for various Java types, recursively processing</em>
+<a class="jxr_linenumber" name="L6901" href="#L6901">6901</a> <em class="jxr_javadoccomment"> * nested structures to create human-readable representations. It's extensively used throughout</em>
+<a class="jxr_linenumber" name="L6902" href="#L6902">6902</a> <em class="jxr_javadoccomment"> * the Juneau framework for test assertions and debugging output.</p></em>
+<a class="jxr_linenumber" name="L6903" href="#L6903">6903</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6904" href="#L6904">6904</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Type-Specific Formatting:</h5></em>
+<a class="jxr_linenumber" name="L6905" href="#L6905">6905</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L6906" href="#L6906">6906</a> <em class="jxr_javadoccomment"> * <li><b>null:</b> Returns <js>null</js></li></em>
+<a class="jxr_linenumber" name="L6907" href="#L6907">6907</a> <em class="jxr_javadoccomment"> * <li><b>Optional:</b> Recursively formats the contained value (or <js>null</js> if empty)</li></em>
+<a class="jxr_linenumber" name="L6908" href="#L6908">6908</a> <em class="jxr_javadoccomment"> * <li><b>Collections:</b> Formats as <js>"[item1,item2,item3]"</js> with comma-separated elements</li></em>
+<a class="jxr_linenumber" name="L6909" href="#L6909">6909</a> <em class="jxr_javadoccomment"> * <li><b>Maps:</b> Formats as <js>"{key1=value1,key2=value2}"</js> with comma-separated entries</li></em>
+<a class="jxr_linenumber" name="L6910" href="#L6910">6910</a> <em class="jxr_javadoccomment"> * <li><b>Map.Entry:</b> Formats as <js>"key=value"</js></li></em>
+<a class="jxr_linenumber" name="L6911" href="#L6911">6911</a> <em class="jxr_javadoccomment"> * <li><b>Arrays:</b> Converts to list format <js>"[item1,item2,item3]"</js></li></em>
+<a class="jxr_linenumber" name="L6912" href="#L6912">6912</a> <em class="jxr_javadoccomment"> * <li><b>Iterables/Iterators/Enumerations:</b> Converts to list and formats recursively</li></em>
+<a class="jxr_linenumber" name="L6913" href="#L6913">6913</a> <em class="jxr_javadoccomment"> * <li><b>GregorianCalendar:</b> Formats as ISO instant timestamp</li></em>
+<a class="jxr_linenumber" name="L6914" href="#L6914">6914</a> <em class="jxr_javadoccomment"> * <li><b>Date:</b> Formats as ISO instant string (e.g., <js>"2023-12-25T10:30:00Z"</js>)</li></em>
+<a class="jxr_linenumber" name="L6915" href="#L6915">6915</a> <em class="jxr_javadoccomment"> * <li><b>InputStream:</b> Converts to hexadecimal representation</li></em>
+<a class="jxr_linenumber" name="L6916" href="#L6916">6916</a> <em class="jxr_javadoccomment"> * <li><b>Reader:</b> Reads content and returns as string</li></em>
+<a class="jxr_linenumber" name="L6917" href="#L6917">6917</a> <em class="jxr_javadoccomment"> * <li><b>File:</b> Reads file content and returns as string</li></em>
+<a class="jxr_linenumber" name="L6918" href="#L6918">6918</a> <em class="jxr_javadoccomment"> * <li><b>byte[]:</b> Converts to hexadecimal representation</li></em>
+<a class="jxr_linenumber" name="L6919" href="#L6919">6919</a> <em class="jxr_javadoccomment"> * <li><b>Enum:</b> Returns the enum name via {@link Enum#name()}</li></em>
+<a class="jxr_linenumber" name="L6920" href="#L6920">6920</a> <em class="jxr_javadoccomment"> * <li><b>All other types:</b> Uses {@link Object#toString()}</li></em>
+<a class="jxr_linenumber" name="L6921" href="#L6921">6921</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L6922" href="#L6922">6922</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6923" href="#L6923">6923</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L6924" href="#L6924">6924</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L6925" href="#L6925">6925</a> <em class="jxr_javadoccomment"> * <jc>// Collections</jc></em>
+<a class="jxr_linenumber" name="L6926" href="#L6926">6926</a> <em class="jxr_javadoccomment"> * readable(List.of("a", "b", "c")) <jc>// Returns: "[a,b,c]"</jc></em>
+<a class="jxr_linenumber" name="L6927" href="#L6927">6927</a> <em class="jxr_javadoccomment"> * readable(Set.of(1, 2, 3)) <jc>// Returns: "[1,2,3]" (order may vary)</jc></em>
+<a class="jxr_linenumber" name="L6928" href="#L6928">6928</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6929" href="#L6929">6929</a> <em class="jxr_javadoccomment"> * <jc>// Maps</jc></em>
+<a class="jxr_linenumber" name="L6930" href="#L6930">6930</a> <em class="jxr_javadoccomment"> * readable(Map.of("foo", "bar", "baz", 123)) <jc>// Returns: "{foo=bar,baz=123}"</jc></em>
<a class="jxr_linenumber" name="L6931" href="#L6931">6931</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6932" href="#L6932">6932</a> <em class="jxr_javadoccomment"> * <jc>// Nested structures</jc></em>
-<a class="jxr_linenumber" name="L6933" href="#L6933">6933</a> <em class="jxr_javadoccomment"> * readable(List.of(Map.of("x", 1), Set.of("a", "b"))) <jc>// Returns: "[{x=1},[a,b]]"</jc></em>
-<a class="jxr_linenumber" name="L6934" href="#L6934">6934</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6935" href="#L6935">6935</a> <em class="jxr_javadoccomment"> * <jc>// Special types</jc></em>
-<a class="jxr_linenumber" name="L6936" href="#L6936">6936</a> <em class="jxr_javadoccomment"> * readable(Optional.of("test")) <jc>// Returns: "test"</jc></em>
-<a class="jxr_linenumber" name="L6937" href="#L6937">6937</a> <em class="jxr_javadoccomment"> * readable(Optional.empty()) <jc>// Returns: null</jc></em>
-<a class="jxr_linenumber" name="L6938" href="#L6938">6938</a> <em class="jxr_javadoccomment"> * readable(new Date(1640995200000L)) <jc>// Returns: "2022-01-01T00:00:00Z"</jc></em>
-<a class="jxr_linenumber" name="L6939" href="#L6939">6939</a> <em class="jxr_javadoccomment"> * readable(MyEnum.FOO) <jc>// Returns: "FOO"</jc></em>
-<a class="jxr_linenumber" name="L6940" href="#L6940">6940</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L6941" href="#L6941">6941</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6942" href="#L6942">6942</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Recursive Processing:</h5></em>
-<a class="jxr_linenumber" name="L6943" href="#L6943">6943</a> <em class="jxr_javadoccomment"> * <p>The method recursively processes nested structures, so complex objects containing</em>
-<a class="jxr_linenumber" name="L6944" href="#L6944">6944</a> <em class="jxr_javadoccomment"> * collections, maps, and arrays are fully flattened into readable format. This makes it</em>
-<a class="jxr_linenumber" name="L6945" href="#L6945">6945</a> <em class="jxr_javadoccomment"> * ideal for test assertions where you need to compare complex object structures.</p></em>
-<a class="jxr_linenumber" name="L6946" href="#L6946">6946</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6947" href="#L6947">6947</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Error Handling:</h5></em>
-<a class="jxr_linenumber" name="L6948" href="#L6948">6948</a> <em class="jxr_javadoccomment"> * <p>IO operations (reading files, streams) are wrapped in safe() calls, converting</em>
-<a class="jxr_linenumber" name="L6949" href="#L6949">6949</a> <em class="jxr_javadoccomment"> * any exceptions to RuntimeExceptions. Binary data (InputStreams, byte arrays) is</em>
-<a class="jxr_linenumber" name="L6950" href="#L6950">6950</a> <em class="jxr_javadoccomment"> * converted to hexadecimal representation for readability.</p></em>
-<a class="jxr_linenumber" name="L6951" href="#L6951">6951</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L6952" href="#L6952">6952</a> <em class="jxr_javadoccomment"> * @param o The object to convert to readable format. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6953" href="#L6953">6953</a> <em class="jxr_javadoccomment"> * @return A readable string representation of the object, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L6954" href="#L6954">6954</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L6955" href="#L6955">6955</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String readable(Object o) {
-<a class="jxr_linenumber" name="L6956" href="#L6956">6956</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L6957" href="#L6957">6957</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L6958" href="#L6958">6958</a> <strong class="jxr_keyword">if</strong> (o instanceof Optional<?> o2)
-<a class="jxr_linenumber" name="L6959" href="#L6959">6959</a> <strong class="jxr_keyword">return</strong> readable(o2.orElse(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L6960" href="#L6960">6960</a> <strong class="jxr_keyword">if</strong> (o instanceof Collection<?> o2)
-<a class="jxr_linenumber" name="L6961" href="#L6961">6961</a> <strong class="jxr_keyword">return</strong> o2.stream().map(StringUtils::readable).collect(Collectors.joining(<span class="jxr_string">","</span>, <span class="jxr_string">"["</span>, <span class="jxr_string">"]"</span>));
-<a class="jxr_linenumber" name="L6962" href="#L6962">6962</a> <strong class="jxr_keyword">if</strong> (o instanceof Map<?,?> o2)
-<a class="jxr_linenumber" name="L6963" href="#L6963">6963</a> <strong class="jxr_keyword">return</strong> o2.entrySet().stream().map(StringUtils::readable).collect(Collectors.joining(<span class="jxr_string">","</span>, <span class="jxr_string">"{"</span>, <span class="jxr_string">"}"</span>));
-<a class="jxr_linenumber" name="L6964" href="#L6964">6964</a> <strong class="jxr_keyword">if</strong> (o instanceof Map.Entry<?,?> o2)
-<a class="jxr_linenumber" name="L6965" href="#L6965">6965</a> <strong class="jxr_keyword">return</strong> readable(o2.getKey()) + '=' + readable(o2.getValue());
-<a class="jxr_linenumber" name="L6966" href="#L6966">6966</a> <strong class="jxr_keyword">if</strong> (o instanceof Iterable<?> o2)
-<a class="jxr_linenumber" name="L6967" href="#L6967">6967</a> <strong class="jxr_keyword">return</strong> readable(toList(o2));
-<a class="jxr_linenumber" name="L6968" href="#L6968">6968</a> <strong class="jxr_keyword">if</strong> (o instanceof Iterator<?> o2)
-<a class="jxr_linenumber" name="L6969" href="#L6969">6969</a> <strong class="jxr_keyword">return</strong> readable(toList(o2));
-<a class="jxr_linenumber" name="L6970" href="#L6970">6970</a> <strong class="jxr_keyword">if</strong> (o instanceof Enumeration<?> o2)
+<a class="jxr_linenumber" name="L6932" href="#L6932">6932</a> <em class="jxr_javadoccomment"> * <jc>// Arrays</jc></em>
+<a class="jxr_linenumber" name="L6933" href="#L6933">6933</a> <em class="jxr_javadoccomment"> * readable(ints(1, 2, 3)) <jc>// Returns: "[1,2,3]"</jc></em>
+<a class="jxr_linenumber" name="L6934" href="#L6934">6934</a> <em class="jxr_javadoccomment"> * readable(new String[]{"a", "b"}) <jc>// Returns: "[a,b]"</jc></em>
+<a class="jxr_linenumber" name="L6935" href="#L6935">6935</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6936" href="#L6936">6936</a> <em class="jxr_javadoccomment"> * <jc>// Nested structures</jc></em>
+<a class="jxr_linenumber" name="L6937" href="#L6937">6937</a> <em class="jxr_javadoccomment"> * readable(List.of(Map.of("x", 1), Set.of("a", "b"))) <jc>// Returns: "[{x=1},[a,b]]"</jc></em>
+<a class="jxr_linenumber" name="L6938" href="#L6938">6938</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6939" href="#L6939">6939</a> <em class="jxr_javadoccomment"> * <jc>// Special types</jc></em>
+<a class="jxr_linenumber" name="L6940" href="#L6940">6940</a> <em class="jxr_javadoccomment"> * readable(Optional.of("test")) <jc>// Returns: "test"</jc></em>
+<a class="jxr_linenumber" name="L6941" href="#L6941">6941</a> <em class="jxr_javadoccomment"> * readable(Optional.empty()) <jc>// Returns: null</jc></em>
+<a class="jxr_linenumber" name="L6942" href="#L6942">6942</a> <em class="jxr_javadoccomment"> * readable(new Date(1640995200000L)) <jc>// Returns: "2022-01-01T00:00:00Z"</jc></em>
+<a class="jxr_linenumber" name="L6943" href="#L6943">6943</a> <em class="jxr_javadoccomment"> * readable(MyEnum.FOO) <jc>// Returns: "FOO"</jc></em>
+<a class="jxr_linenumber" name="L6944" href="#L6944">6944</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L6945" href="#L6945">6945</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6946" href="#L6946">6946</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Recursive Processing:</h5></em>
+<a class="jxr_linenumber" name="L6947" href="#L6947">6947</a> <em class="jxr_javadoccomment"> * <p>The method recursively processes nested structures, so complex objects containing</em>
+<a class="jxr_linenumber" name="L6948" href="#L6948">6948</a> <em class="jxr_javadoccomment"> * collections, maps, and arrays are fully flattened into readable format. This makes it</em>
+<a class="jxr_linenumber" name="L6949" href="#L6949">6949</a> <em class="jxr_javadoccomment"> * ideal for test assertions where you need to compare complex object structures.</p></em>
+<a class="jxr_linenumber" name="L6950" href="#L6950">6950</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6951" href="#L6951">6951</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Error Handling:</h5></em>
+<a class="jxr_linenumber" name="L6952" href="#L6952">6952</a> <em class="jxr_javadoccomment"> * <p>IO operations (reading files, streams) are wrapped in safe() calls, converting</em>
+<a class="jxr_linenumber" name="L6953" href="#L6953">6953</a> <em class="jxr_javadoccomment"> * any exceptions to RuntimeExceptions. Binary data (InputStreams, byte arrays) is</em>
+<a class="jxr_linenumber" name="L6954" href="#L6954">6954</a> <em class="jxr_javadoccomment"> * converted to hexadecimal representation for readability.</p></em>
+<a class="jxr_linenumber" name="L6955" href="#L6955">6955</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L6956" href="#L6956">6956</a> <em class="jxr_javadoccomment"> * @param o The object to convert to readable format. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6957" href="#L6957">6957</a> <em class="jxr_javadoccomment"> * @return A readable string representation of the object, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L6958" href="#L6958">6958</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L6959" href="#L6959">6959</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String readable(Object o) {
+<a class="jxr_linenumber" name="L6960" href="#L6960">6960</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L6961" href="#L6961">6961</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L6962" href="#L6962">6962</a> <strong class="jxr_keyword">if</strong> (o instanceof Optional<?> o2)
+<a class="jxr_linenumber" name="L6963" href="#L6963">6963</a> <strong class="jxr_keyword">return</strong> readable(o2.orElse(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L6964" href="#L6964">6964</a> <strong class="jxr_keyword">if</strong> (o instanceof Collection<?> o2)
+<a class="jxr_linenumber" name="L6965" href="#L6965">6965</a> <strong class="jxr_keyword">return</strong> o2.stream().map(StringUtils::readable).collect(Collectors.joining(<span class="jxr_string">","</span>, <span class="jxr_string">"["</span>, <span class="jxr_string">"]"</span>));
+<a class="jxr_linenumber" name="L6966" href="#L6966">6966</a> <strong class="jxr_keyword">if</strong> (o instanceof Map<?,?> o2)
+<a class="jxr_linenumber" name="L6967" href="#L6967">6967</a> <strong class="jxr_keyword">return</strong> o2.entrySet().stream().map(StringUtils::readable).collect(Collectors.joining(<span class="jxr_string">","</span>, <span class="jxr_string">"{"</span>, <span class="jxr_string">"}"</span>));
+<a class="jxr_linenumber" name="L6968" href="#L6968">6968</a> <strong class="jxr_keyword">if</strong> (o instanceof Map.Entry<?,?> o2)
+<a class="jxr_linenumber" name="L6969" href="#L6969">6969</a> <strong class="jxr_keyword">return</strong> readable(o2.getKey()) + '=' + readable(o2.getValue());
+<a class="jxr_linenumber" name="L6970" href="#L6970">6970</a> <strong class="jxr_keyword">if</strong> (o instanceof Iterable<?> o2)
<a class="jxr_linenumber" name="L6971" href="#L6971">6971</a> <strong class="jxr_keyword">return</strong> readable(toList(o2));
-<a class="jxr_linenumber" name="L6972" href="#L6972">6972</a> <strong class="jxr_keyword">if</strong> (o instanceof GregorianCalendar o2)
-<a class="jxr_linenumber" name="L6973" href="#L6973">6973</a> <strong class="jxr_keyword">return</strong> o2.toZonedDateTime().format(DateTimeFormatter.ISO_INSTANT);
-<a class="jxr_linenumber" name="L6974" href="#L6974">6974</a> <strong class="jxr_keyword">if</strong> (o instanceof Date o2)
-<a class="jxr_linenumber" name="L6975" href="#L6975">6975</a> <strong class="jxr_keyword">return</strong> o2.toInstant().toString();
-<a class="jxr_linenumber" name="L6976" href="#L6976">6976</a> <strong class="jxr_keyword">if</strong> (o instanceof InputStream o2)
-<a class="jxr_linenumber" name="L6977" href="#L6977">6977</a> <strong class="jxr_keyword">return</strong> toHex(o2);
-<a class="jxr_linenumber" name="L6978" href="#L6978">6978</a> <strong class="jxr_keyword">if</strong> (o instanceof Reader o2)
-<a class="jxr_linenumber" name="L6979" href="#L6979">6979</a> <strong class="jxr_keyword">return</strong> safe(() -> read(o2));
-<a class="jxr_linenumber" name="L6980" href="#L6980">6980</a> <strong class="jxr_keyword">if</strong> (o instanceof File o2)
-<a class="jxr_linenumber" name="L6981" href="#L6981">6981</a> <strong class="jxr_keyword">return</strong> safe(() -> read(o2));
-<a class="jxr_linenumber" name="L6982" href="#L6982">6982</a> <strong class="jxr_keyword">if</strong> (o instanceof byte[] o2)
-<a class="jxr_linenumber" name="L6983" href="#L6983">6983</a> <strong class="jxr_keyword">return</strong> toHex(o2);
-<a class="jxr_linenumber" name="L6984" href="#L6984">6984</a> <strong class="jxr_keyword">if</strong> (o instanceof Enum o2)
-<a class="jxr_linenumber" name="L6985" href="#L6985">6985</a> <strong class="jxr_keyword">return</strong> o2.name();
-<a class="jxr_linenumber" name="L6986" href="#L6986">6986</a> <strong class="jxr_keyword">if</strong> (o instanceof Class o2)
-<a class="jxr_linenumber" name="L6987" href="#L6987">6987</a> <strong class="jxr_keyword">return</strong> cns(o2);
-<a class="jxr_linenumber" name="L6988" href="#L6988">6988</a> <strong class="jxr_keyword">if</strong> (o instanceof Executable o2) {
-<a class="jxr_linenumber" name="L6989" href="#L6989">6989</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(64);
-<a class="jxr_linenumber" name="L6990" href="#L6990">6990</a> sb.append(o2 instanceof Constructor ? cns(o2.getDeclaringClass()) : o2.getName()).append('(');
-<a class="jxr_linenumber" name="L6991" href="#L6991">6991</a> <strong class="jxr_keyword">var</strong> pt = o2.getParameterTypes();
-<a class="jxr_linenumber" name="L6992" href="#L6992">6992</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < pt.length; i++) {
-<a class="jxr_linenumber" name="L6993" href="#L6993">6993</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L6994" href="#L6994">6994</a> sb.append(',');
-<a class="jxr_linenumber" name="L6995" href="#L6995">6995</a> sb.append(cns(pt[i]));
-<a class="jxr_linenumber" name="L6996" href="#L6996">6996</a> }
-<a class="jxr_linenumber" name="L6997" href="#L6997">6997</a> sb.append(')');
-<a class="jxr_linenumber" name="L6998" href="#L6998">6998</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L6999" href="#L6999">6999</a> }
-<a class="jxr_linenumber" name="L7000" href="#L7000">7000</a> <strong class="jxr_keyword">if</strong> (isArray(o)) {
-<a class="jxr_linenumber" name="L7001" href="#L7001">7001</a> <strong class="jxr_keyword">var</strong> l = list();
-<a class="jxr_linenumber" name="L7002" href="#L7002">7002</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < Array.getLength(o); i++) {
-<a class="jxr_linenumber" name="L7003" href="#L7003">7003</a> l.add(Array.get(o, i));
-<a class="jxr_linenumber" name="L7004" href="#L7004">7004</a> }
-<a class="jxr_linenumber" name="L7005" href="#L7005">7005</a> <strong class="jxr_keyword">return</strong> readable(l);
-<a class="jxr_linenumber" name="L7006" href="#L7006">7006</a> }
-<a class="jxr_linenumber" name="L7007" href="#L7007">7007</a> <strong class="jxr_keyword">return</strong> o.toString();
-<a class="jxr_linenumber" name="L7008" href="#L7008">7008</a> }
-<a class="jxr_linenumber" name="L7009" href="#L7009">7009</a>
-<a class="jxr_linenumber" name="L7010" href="#L7010">7010</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L7011" href="#L7011">7011</a> <em class="jxr_comment">// String Array and Collection Utilities</em>
-<a class="jxr_linenumber" name="L7012" href="#L7012">7012</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L6972" href="#L6972">6972</a> <strong class="jxr_keyword">if</strong> (o instanceof Iterator<?> o2)
+<a class="jxr_linenumber" name="L6973" href="#L6973">6973</a> <strong class="jxr_keyword">return</strong> readable(toList(o2));
+<a class="jxr_linenumber" name="L6974" href="#L6974">6974</a> <strong class="jxr_keyword">if</strong> (o instanceof Enumeration<?> o2)
+<a class="jxr_linenumber" name="L6975" href="#L6975">6975</a> <strong class="jxr_keyword">return</strong> readable(toList(o2));
+<a class="jxr_linenumber" name="L6976" href="#L6976">6976</a> <strong class="jxr_keyword">if</strong> (o instanceof GregorianCalendar o2)
+<a class="jxr_linenumber" name="L6977" href="#L6977">6977</a> <strong class="jxr_keyword">return</strong> o2.toZonedDateTime().format(DateTimeFormatter.ISO_INSTANT);
+<a class="jxr_linenumber" name="L6978" href="#L6978">6978</a> <strong class="jxr_keyword">if</strong> (o instanceof Date o2)
+<a class="jxr_linenumber" name="L6979" href="#L6979">6979</a> <strong class="jxr_keyword">return</strong> o2.toInstant().toString();
+<a class="jxr_linenumber" name="L6980" href="#L6980">6980</a> <strong class="jxr_keyword">if</strong> (o instanceof InputStream o2)
+<a class="jxr_linenumber" name="L6981" href="#L6981">6981</a> <strong class="jxr_keyword">return</strong> toHex(o2);
+<a class="jxr_linenumber" name="L6982" href="#L6982">6982</a> <strong class="jxr_keyword">if</strong> (o instanceof Reader o2)
+<a class="jxr_linenumber" name="L6983" href="#L6983">6983</a> <strong class="jxr_keyword">return</strong> safe(() -> read(o2));
+<a class="jxr_linenumber" name="L6984" href="#L6984">6984</a> <strong class="jxr_keyword">if</strong> (o instanceof File o2)
+<a class="jxr_linenumber" name="L6985" href="#L6985">6985</a> <strong class="jxr_keyword">return</strong> safe(() -> read(o2));
+<a class="jxr_linenumber" name="L6986" href="#L6986">6986</a> <strong class="jxr_keyword">if</strong> (o instanceof byte[] o2)
+<a class="jxr_linenumber" name="L6987" href="#L6987">6987</a> <strong class="jxr_keyword">return</strong> toHex(o2);
+<a class="jxr_linenumber" name="L6988" href="#L6988">6988</a> <strong class="jxr_keyword">if</strong> (o instanceof Enum o2)
+<a class="jxr_linenumber" name="L6989" href="#L6989">6989</a> <strong class="jxr_keyword">return</strong> o2.name();
+<a class="jxr_linenumber" name="L6990" href="#L6990">6990</a> <strong class="jxr_keyword">if</strong> (o instanceof Class o2)
+<a class="jxr_linenumber" name="L6991" href="#L6991">6991</a> <strong class="jxr_keyword">return</strong> cns(o2);
+<a class="jxr_linenumber" name="L6992" href="#L6992">6992</a> <strong class="jxr_keyword">if</strong> (o instanceof Executable o2) {
+<a class="jxr_linenumber" name="L6993" href="#L6993">6993</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(64);
+<a class="jxr_linenumber" name="L6994" href="#L6994">6994</a> sb.append(o2 instanceof Constructor ? cns(o2.getDeclaringClass()) : o2.getName()).append('(');
+<a class="jxr_linenumber" name="L6995" href="#L6995">6995</a> <strong class="jxr_keyword">var</strong> pt = o2.getParameterTypes();
+<a class="jxr_linenumber" name="L6996" href="#L6996">6996</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < pt.length; i++) {
+<a class="jxr_linenumber" name="L6997" href="#L6997">6997</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L6998" href="#L6998">6998</a> sb.append(',');
+<a class="jxr_linenumber" name="L6999" href="#L6999">6999</a> sb.append(cns(pt[i]));
+<a class="jxr_linenumber" name="L7000" href="#L7000">7000</a> }
+<a class="jxr_linenumber" name="L7001" href="#L7001">7001</a> sb.append(')');
+<a class="jxr_linenumber" name="L7002" href="#L7002">7002</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L7003" href="#L7003">7003</a> }
+<a class="jxr_linenumber" name="L7004" href="#L7004">7004</a> <strong class="jxr_keyword">if</strong> (isArray(o)) {
+<a class="jxr_linenumber" name="L7005" href="#L7005">7005</a> <strong class="jxr_keyword">var</strong> l = list();
+<a class="jxr_linenumber" name="L7006" href="#L7006">7006</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < Array.getLength(o); i++) {
+<a class="jxr_linenumber" name="L7007" href="#L7007">7007</a> l.add(Array.get(o, i));
+<a class="jxr_linenumber" name="L7008" href="#L7008">7008</a> }
+<a class="jxr_linenumber" name="L7009" href="#L7009">7009</a> <strong class="jxr_keyword">return</strong> readable(l);
+<a class="jxr_linenumber" name="L7010" href="#L7010">7010</a> }
+<a class="jxr_linenumber" name="L7011" href="#L7011">7011</a> <strong class="jxr_keyword">return</strong> o.toString();
+<a class="jxr_linenumber" name="L7012" href="#L7012">7012</a> }
<a class="jxr_linenumber" name="L7013" href="#L7013">7013</a>
-<a class="jxr_linenumber" name="L7014" href="#L7014">7014</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7015" href="#L7015">7015</a> <em class="jxr_javadoccomment"> * Converts a collection of strings to a string array.</em>
-<a class="jxr_linenumber" name="L7016" href="#L7016">7016</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7017" href="#L7017">7017</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7018" href="#L7018">7018</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the collection is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7019" href="#L7019">7019</a> <em class="jxr_javadoccomment"> * Returns an empty array if the collection is empty.</em>
+<a class="jxr_linenumber" name="L7014" href="#L7014">7014</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L7015" href="#L7015">7015</a> <em class="jxr_comment">// String Array and Collection Utilities</em>
+<a class="jxr_linenumber" name="L7016" href="#L7016">7016</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L7017" href="#L7017">7017</a>
+<a class="jxr_linenumber" name="L7018" href="#L7018">7018</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7019" href="#L7019">7019</a> <em class="jxr_javadoccomment"> * Converts a collection of strings to a string array.</em>
<a class="jxr_linenumber" name="L7020" href="#L7020">7020</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7021" href="#L7021">7021</a> <em class="jxr_javadoccomment"> * @param collection The collection to convert. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7022" href="#L7022">7022</a> <em class="jxr_javadoccomment"> * @return A new string array containing the collection elements, or <jk>null</jk> if the collection was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7023" href="#L7023">7023</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7024" href="#L7024">7024</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] toStringArray(Collection<String> collection) {
-<a class="jxr_linenumber" name="L7025" href="#L7025">7025</a> <strong class="jxr_keyword">if</strong> (collection == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7026" href="#L7026">7026</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L7027" href="#L7027">7027</a> <strong class="jxr_keyword">return</strong> collection.toArray(<strong class="jxr_keyword">new</strong> String[collection.size()]);
-<a class="jxr_linenumber" name="L7028" href="#L7028">7028</a> }
-<a class="jxr_linenumber" name="L7029" href="#L7029">7029</a>
-<a class="jxr_linenumber" name="L7030" href="#L7030">7030</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7031" href="#L7031">7031</a> <em class="jxr_javadoccomment"> * Filters a string array using the specified predicate.</em>
-<a class="jxr_linenumber" name="L7032" href="#L7032">7032</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7033" href="#L7033">7033</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7034" href="#L7034">7034</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7035" href="#L7035">7035</a> <em class="jxr_javadoccomment"> * Returns an empty array if the predicate is <jk>null</jk> or no elements match.</em>
+<a class="jxr_linenumber" name="L7021" href="#L7021">7021</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7022" href="#L7022">7022</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the collection is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7023" href="#L7023">7023</a> <em class="jxr_javadoccomment"> * Returns an empty array if the collection is empty.</em>
+<a class="jxr_linenumber" name="L7024" href="#L7024">7024</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7025" href="#L7025">7025</a> <em class="jxr_javadoccomment"> * @param collection The collection to convert. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7026" href="#L7026">7026</a> <em class="jxr_javadoccomment"> * @return A new string array containing the collection elements, or <jk>null</jk> if the collection was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7027" href="#L7027">7027</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7028" href="#L7028">7028</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] toStringArray(Collection<String> collection) {
+<a class="jxr_linenumber" name="L7029" href="#L7029">7029</a> <strong class="jxr_keyword">if</strong> (collection == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7030" href="#L7030">7030</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L7031" href="#L7031">7031</a> <strong class="jxr_keyword">return</strong> collection.toArray(<strong class="jxr_keyword">new</strong> String[collection.size()]);
+<a class="jxr_linenumber" name="L7032" href="#L7032">7032</a> }
+<a class="jxr_linenumber" name="L7033" href="#L7033">7033</a>
+<a class="jxr_linenumber" name="L7034" href="#L7034">7034</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7035" href="#L7035">7035</a> <em class="jxr_javadoccomment"> * Filters a string array using the specified predicate.</em>
<a class="jxr_linenumber" name="L7036" href="#L7036">7036</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7037" href="#L7037">7037</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7038" href="#L7038">7038</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7039" href="#L7039">7039</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>""</js>, <js>"bar"</js>, <jk>null</jk>, <js>"baz"</js>};</em>
-<a class="jxr_linenumber" name="L7040" href="#L7040">7040</a> <em class="jxr_javadoccomment"> * String[] <jv>filtered</jv> = filter(<jv>array</jv>, StringUtils.<jsf>NOT_EMPTY</jsf>);</em>
-<a class="jxr_linenumber" name="L7041" href="#L7041">7041</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["foo", "bar", "baz"]</jc></em>
-<a class="jxr_linenumber" name="L7042" href="#L7042">7042</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7043" href="#L7043">7043</a> <em class="jxr_javadoccomment"> * String[] <jv>longStrings</jv> = filter(<jv>array</jv>, s -&gt; s != <jk>null</jk> &amp;&amp; s.length() &gt; 3);</em>
-<a class="jxr_linenumber" name="L7044" href="#L7044">7044</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["baz"]</jc></em>
-<a class="jxr_linenumber" name="L7045" href="#L7045">7045</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7037" href="#L7037">7037</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7038" href="#L7038">7038</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7039" href="#L7039">7039</a> <em class="jxr_javadoccomment"> * Returns an empty array if the predicate is <jk>null</jk> or no elements match.</em>
+<a class="jxr_linenumber" name="L7040" href="#L7040">7040</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7041" href="#L7041">7041</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7042" href="#L7042">7042</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7043" href="#L7043">7043</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>""</js>, <js>"bar"</js>, <jk>null</jk>, <js>"baz"</js>};</em>
+<a class="jxr_linenumber" name="L7044" href="#L7044">7044</a> <em class="jxr_javadoccomment"> * String[] <jv>filtered</jv> = filter(<jv>array</jv>, StringUtils.<jsf>NOT_EMPTY</jsf>);</em>
+<a class="jxr_linenumber" name="L7045" href="#L7045">7045</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["foo", "bar", "baz"]</jc></em>
<a class="jxr_linenumber" name="L7046" href="#L7046">7046</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7047" href="#L7047">7047</a> <em class="jxr_javadoccomment"> * @param array The array to filter. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7048" href="#L7048">7048</a> <em class="jxr_javadoccomment"> * @param predicate The predicate to apply to each element. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7049" href="#L7049">7049</a> <em class="jxr_javadoccomment"> * @return A new array containing only the elements that match the predicate, or <jk>null</jk> if the array was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7050" href="#L7050">7050</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7051" href="#L7051">7051</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] filter(String[] array, Predicate<String> predicate) {
-<a class="jxr_linenumber" name="L7052" href="#L7052">7052</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7053" href="#L7053">7053</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L7054" href="#L7054">7054</a> <strong class="jxr_keyword">if</strong> (predicate == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7055" href="#L7055">7055</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[0];
-<a class="jxr_linenumber" name="L7056" href="#L7056">7056</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).filter(predicate).toArray(String[]::<strong class="jxr_keyword">new</strong>);
-<a class="jxr_linenumber" name="L7057" href="#L7057">7057</a> }
-<a class="jxr_linenumber" name="L7058" href="#L7058">7058</a>
-<a class="jxr_linenumber" name="L7059" href="#L7059">7059</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7060" href="#L7060">7060</a> <em class="jxr_javadoccomment"> * Maps each element of a string array using the specified function.</em>
-<a class="jxr_linenumber" name="L7061" href="#L7061">7061</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7062" href="#L7062">7062</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7063" href="#L7063">7063</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7064" href="#L7064">7064</a> <em class="jxr_javadoccomment"> * Returns an array with <jk>null</jk> elements if the function is <jk>null</jk> or returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7047" href="#L7047">7047</a> <em class="jxr_javadoccomment"> * String[] <jv>longStrings</jv> = filter(<jv>array</jv>, s -&gt; s != <jk>null</jk> &amp;&amp; s.length() &gt; 3);</em>
+<a class="jxr_linenumber" name="L7048" href="#L7048">7048</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["baz"]</jc></em>
+<a class="jxr_linenumber" name="L7049" href="#L7049">7049</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7050" href="#L7050">7050</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7051" href="#L7051">7051</a> <em class="jxr_javadoccomment"> * @param array The array to filter. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7052" href="#L7052">7052</a> <em class="jxr_javadoccomment"> * @param predicate The predicate to apply to each element. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7053" href="#L7053">7053</a> <em class="jxr_javadoccomment"> * @return A new array containing only the elements that match the predicate, or <jk>null</jk> if the array was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7054" href="#L7054">7054</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7055" href="#L7055">7055</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] filter(String[] array, Predicate<String> predicate) {
+<a class="jxr_linenumber" name="L7056" href="#L7056">7056</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7057" href="#L7057">7057</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L7058" href="#L7058">7058</a> <strong class="jxr_keyword">if</strong> (predicate == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7059" href="#L7059">7059</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[0];
+<a class="jxr_linenumber" name="L7060" href="#L7060">7060</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).filter(predicate).toArray(String[]::<strong class="jxr_keyword">new</strong>);
+<a class="jxr_linenumber" name="L7061" href="#L7061">7061</a> }
+<a class="jxr_linenumber" name="L7062" href="#L7062">7062</a>
+<a class="jxr_linenumber" name="L7063" href="#L7063">7063</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7064" href="#L7064">7064</a> <em class="jxr_javadoccomment"> * Maps each element of a string array using the specified function.</em>
<a class="jxr_linenumber" name="L7065" href="#L7065">7065</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7066" href="#L7066">7066</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7067" href="#L7067">7067</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7068" href="#L7068">7068</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>"bar"</js>, <js>"baz"</js>};</em>
-<a class="jxr_linenumber" name="L7069" href="#L7069">7069</a> <em class="jxr_javadoccomment"> * String[] <jv>uppercased</jv> = map(<jv>array</jv>, String::toUpperCase);</em>
-<a class="jxr_linenumber" name="L7070" href="#L7070">7070</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["FOO", "BAR", "BAZ"]</jc></em>
-<a class="jxr_linenumber" name="L7071" href="#L7071">7071</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7072" href="#L7072">7072</a> <em class="jxr_javadoccomment"> * String[] <jv>prefixed</jv> = map(<jv>array</jv>, s -&gt; <js>"prefix-"</js> + s);</em>
-<a class="jxr_linenumber" name="L7073" href="#L7073">7073</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["prefix-foo", "prefix-bar", "prefix-baz"]</jc></em>
-<a class="jxr_linenumber" name="L7074" href="#L7074">7074</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7066" href="#L7066">7066</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7067" href="#L7067">7067</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7068" href="#L7068">7068</a> <em class="jxr_javadoccomment"> * Returns an array with <jk>null</jk> elements if the function is <jk>null</jk> or returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7069" href="#L7069">7069</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7070" href="#L7070">7070</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7071" href="#L7071">7071</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7072" href="#L7072">7072</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>"bar"</js>, <js>"baz"</js>};</em>
+<a class="jxr_linenumber" name="L7073" href="#L7073">7073</a> <em class="jxr_javadoccomment"> * String[] <jv>uppercased</jv> = map(<jv>array</jv>, String::toUpperCase);</em>
+<a class="jxr_linenumber" name="L7074" href="#L7074">7074</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["FOO", "BAR", "BAZ"]</jc></em>
<a class="jxr_linenumber" name="L7075" href="#L7075">7075</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7076" href="#L7076">7076</a> <em class="jxr_javadoccomment"> * @param array The array to map. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7077" href="#L7077">7077</a> <em class="jxr_javadoccomment"> * @param mapper The function to apply to each element. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7078" href="#L7078">7078</a> <em class="jxr_javadoccomment"> * @return A new array with the mapped elements, or <jk>null</jk> if the array was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7079" href="#L7079">7079</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7080" href="#L7080">7080</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] mapped(String[] array, Function<String,String> mapper) {
-<a class="jxr_linenumber" name="L7081" href="#L7081">7081</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7082" href="#L7082">7082</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L7083" href="#L7083">7083</a> <strong class="jxr_keyword">if</strong> (mapper == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7084" href="#L7084">7084</a> <strong class="jxr_keyword">return</strong> Arrays.copyOf(array, array.length);
-<a class="jxr_linenumber" name="L7085" href="#L7085">7085</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).map(mapper).toArray(String[]::<strong class="jxr_keyword">new</strong>);
-<a class="jxr_linenumber" name="L7086" href="#L7086">7086</a> }
-<a class="jxr_linenumber" name="L7087" href="#L7087">7087</a>
-<a class="jxr_linenumber" name="L7088" href="#L7088">7088</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7089" href="#L7089">7089</a> <em class="jxr_javadoccomment"> * Removes duplicate elements from a string array, preserving order.</em>
-<a class="jxr_linenumber" name="L7090" href="#L7090">7090</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7091" href="#L7091">7091</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7092" href="#L7092">7092</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7093" href="#L7093">7093</a> <em class="jxr_javadoccomment"> * Uses a {@link LinkedHashSet} to preserve insertion order while removing duplicates.</em>
+<a class="jxr_linenumber" name="L7076" href="#L7076">7076</a> <em class="jxr_javadoccomment"> * String[] <jv>prefixed</jv> = map(<jv>array</jv>, s -&gt; <js>"prefix-"</js> + s);</em>
+<a class="jxr_linenumber" name="L7077" href="#L7077">7077</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["prefix-foo", "prefix-bar", "prefix-baz"]</jc></em>
+<a class="jxr_linenumber" name="L7078" href="#L7078">7078</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7079" href="#L7079">7079</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7080" href="#L7080">7080</a> <em class="jxr_javadoccomment"> * @param array The array to map. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7081" href="#L7081">7081</a> <em class="jxr_javadoccomment"> * @param mapper The function to apply to each element. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7082" href="#L7082">7082</a> <em class="jxr_javadoccomment"> * @return A new array with the mapped elements, or <jk>null</jk> if the array was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7083" href="#L7083">7083</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7084" href="#L7084">7084</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] mapped(String[] array, Function<String,String> mapper) {
+<a class="jxr_linenumber" name="L7085" href="#L7085">7085</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7086" href="#L7086">7086</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L7087" href="#L7087">7087</a> <strong class="jxr_keyword">if</strong> (mapper == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7088" href="#L7088">7088</a> <strong class="jxr_keyword">return</strong> Arrays.copyOf(array, array.length);
+<a class="jxr_linenumber" name="L7089" href="#L7089">7089</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).map(mapper).toArray(String[]::<strong class="jxr_keyword">new</strong>);
+<a class="jxr_linenumber" name="L7090" href="#L7090">7090</a> }
+<a class="jxr_linenumber" name="L7091" href="#L7091">7091</a>
+<a class="jxr_linenumber" name="L7092" href="#L7092">7092</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7093" href="#L7093">7093</a> <em class="jxr_javadoccomment"> * Removes duplicate elements from a string array, preserving order.</em>
<a class="jxr_linenumber" name="L7094" href="#L7094">7094</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7095" href="#L7095">7095</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7096" href="#L7096">7096</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7097" href="#L7097">7097</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>"bar"</js>, <js>"foo"</js>, <js>"baz"</js>, <js>"bar"</js>};</em>
-<a class="jxr_linenumber" name="L7098" href="#L7098">7098</a> <em class="jxr_javadoccomment"> * String[] <jv>unique</jv> = distinct(<jv>array</jv>);</em>
-<a class="jxr_linenumber" name="L7099" href="#L7099">7099</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["foo", "bar", "baz"]</jc></em>
-<a class="jxr_linenumber" name="L7100" href="#L7100">7100</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L7101" href="#L7101">7101</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7102" href="#L7102">7102</a> <em class="jxr_javadoccomment"> * @param array The array to process. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7103" href="#L7103">7103</a> <em class="jxr_javadoccomment"> * @return A new array with duplicate elements removed, or <jk>null</jk> if the array was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7104" href="#L7104">7104</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7105" href="#L7105">7105</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] distinct(String[] array) {
-<a class="jxr_linenumber" name="L7106" href="#L7106">7106</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7107" href="#L7107">7107</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L7108" href="#L7108">7108</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).collect(Collectors.toCollection(LinkedHashSet::<strong class="jxr_keyword">new</strong>)).toArray(<strong class="jxr_keyword">new</strong> String[0]);
-<a class="jxr_linenumber" name="L7109" href="#L7109">7109</a> }
-<a class="jxr_linenumber" name="L7110" href="#L7110">7110</a>
-<a class="jxr_linenumber" name="L7111" href="#L7111">7111</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7112" href="#L7112">7112</a> <em class="jxr_javadoccomment"> * Sorts a string array in natural order.</em>
-<a class="jxr_linenumber" name="L7113" href="#L7113">7113</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7114" href="#L7114">7114</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7115" href="#L7115">7115</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7116" href="#L7116">7116</a> <em class="jxr_javadoccomment"> * This method creates a copy of the array and sorts it, leaving the original array unchanged.</em>
+<a class="jxr_linenumber" name="L7095" href="#L7095">7095</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7096" href="#L7096">7096</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7097" href="#L7097">7097</a> <em class="jxr_javadoccomment"> * Uses a {@link LinkedHashSet} to preserve insertion order while removing duplicates.</em>
+<a class="jxr_linenumber" name="L7098" href="#L7098">7098</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7099" href="#L7099">7099</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7100" href="#L7100">7100</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7101" href="#L7101">7101</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>"bar"</js>, <js>"foo"</js>, <js>"baz"</js>, <js>"bar"</js>};</em>
+<a class="jxr_linenumber" name="L7102" href="#L7102">7102</a> <em class="jxr_javadoccomment"> * String[] <jv>unique</jv> = distinct(<jv>array</jv>);</em>
+<a class="jxr_linenumber" name="L7103" href="#L7103">7103</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["foo", "bar", "baz"]</jc></em>
+<a class="jxr_linenumber" name="L7104" href="#L7104">7104</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7105" href="#L7105">7105</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7106" href="#L7106">7106</a> <em class="jxr_javadoccomment"> * @param array The array to process. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7107" href="#L7107">7107</a> <em class="jxr_javadoccomment"> * @return A new array with duplicate elements removed, or <jk>null</jk> if the array was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7108" href="#L7108">7108</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7109" href="#L7109">7109</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] distinct(String[] array) {
+<a class="jxr_linenumber" name="L7110" href="#L7110">7110</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7111" href="#L7111">7111</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L7112" href="#L7112">7112</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).collect(Collectors.toCollection(LinkedHashSet::<strong class="jxr_keyword">new</strong>)).toArray(<strong class="jxr_keyword">new</strong> String[0]);
+<a class="jxr_linenumber" name="L7113" href="#L7113">7113</a> }
+<a class="jxr_linenumber" name="L7114" href="#L7114">7114</a>
+<a class="jxr_linenumber" name="L7115" href="#L7115">7115</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7116" href="#L7116">7116</a> <em class="jxr_javadoccomment"> * Sorts a string array in natural order.</em>
<a class="jxr_linenumber" name="L7117" href="#L7117">7117</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7118" href="#L7118">7118</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7119" href="#L7119">7119</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7120" href="#L7120">7120</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"zebra"</js>, <js>"apple"</js>, <js>"banana"</js>};</em>
-<a class="jxr_linenumber" name="L7121" href="#L7121">7121</a> <em class="jxr_javadoccomment"> * String[] <jv>sorted</jv> = sort(<jv>array</jv>);</em>
-<a class="jxr_linenumber" name="L7122" href="#L7122">7122</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["apple", "banana", "zebra"]</jc></em>
-<a class="jxr_linenumber" name="L7123" href="#L7123">7123</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L7124" href="#L7124">7124</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7125" href="#L7125">7125</a> <em class="jxr_javadoccomment"> * @param array The array to sort. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7126" href="#L7126">7126</a> <em class="jxr_javadoccomment"> * @return A new sorted array, or <jk>null</jk> if the array was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7127" href="#L7127">7127</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7128" href="#L7128">7128</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] sort(String[] array) {
-<a class="jxr_linenumber" name="L7129" href="#L7129">7129</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7130" href="#L7130">7130</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L7131" href="#L7131">7131</a> <strong class="jxr_keyword">var</strong> result = Arrays.copyOf(array, array.length);
-<a class="jxr_linenumber" name="L7132" href="#L7132">7132</a> Arrays.sort(result);
-<a class="jxr_linenumber" name="L7133" href="#L7133">7133</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L7134" href="#L7134">7134</a> }
-<a class="jxr_linenumber" name="L7135" href="#L7135">7135</a>
-<a class="jxr_linenumber" name="L7136" href="#L7136">7136</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7137" href="#L7137">7137</a> <em class="jxr_javadoccomment"> * Sorts a string array in case-insensitive order.</em>
-<a class="jxr_linenumber" name="L7138" href="#L7138">7138</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7139" href="#L7139">7139</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7140" href="#L7140">7140</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7141" href="#L7141">7141</a> <em class="jxr_javadoccomment"> * This method creates a copy of the array and sorts it using case-insensitive comparison,</em>
-<a class="jxr_linenumber" name="L7142" href="#L7142">7142</a> <em class="jxr_javadoccomment"> * leaving the original array unchanged.</em>
-<a class="jxr_linenumber" name="L7143" href="#L7143">7143</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7144" href="#L7144">7144</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7145" href="#L7145">7145</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7146" href="#L7146">7146</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"Zebra"</js>, <js>"apple"</js>, <js>"Banana"</js>};</em>
-<a class="jxr_linenumber" name="L7147" href="#L7147">7147</a> <em class="jxr_javadoccomment"> * String[] <jv>sorted</jv> = sortIgnoreCase(<jv>array</jv>);</em>
-<a class="jxr_linenumber" name="L7148" href="#L7148">7148</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["apple", "Banana", "Zebra"]</jc></em>
-<a class="jxr_linenumber" name="L7149" href="#L7149">7149</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L7150" href="#L7150">7150</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7151" href="#L7151">7151</a> <em class="jxr_javadoccomment"> * @param array The array to sort. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7152" href="#L7152">7152</a> <em class="jxr_javadoccomment"> * @return A new sorted array (case-insensitive), or <jk>null</jk> if the array was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7153" href="#L7153">7153</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7154" href="#L7154">7154</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] sortIgnoreCase(String[] array) {
-<a class="jxr_linenumber" name="L7155" href="#L7155">7155</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7156" href="#L7156">7156</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L7157" href="#L7157">7157</a> <strong class="jxr_keyword">var</strong> result = Arrays.copyOf(array, array.length);
-<a class="jxr_linenumber" name="L7158" href="#L7158">7158</a> Arrays.sort(result, String.CASE_INSENSITIVE_ORDER);
-<a class="jxr_linenumber" name="L7159" href="#L7159">7159</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L7160" href="#L7160">7160</a> }
-<a class="jxr_linenumber" name="L7161" href="#L7161">7161</a>
-<a class="jxr_linenumber" name="L7162" href="#L7162">7162</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L7163" href="#L7163">7163</a> <em class="jxr_comment">// String Builder Utilities</em>
-<a class="jxr_linenumber" name="L7164" href="#L7164">7164</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L7118" href="#L7118">7118</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7119" href="#L7119">7119</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7120" href="#L7120">7120</a> <em class="jxr_javadoccomment"> * This method creates a copy of the array and sorts it, leaving the original array unchanged.</em>
+<a class="jxr_linenumber" name="L7121" href="#L7121">7121</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7122" href="#L7122">7122</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7123" href="#L7123">7123</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7124" href="#L7124">7124</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"zebra"</js>, <js>"apple"</js>, <js>"banana"</js>};</em>
+<a class="jxr_linenumber" name="L7125" href="#L7125">7125</a> <em class="jxr_javadoccomment"> * String[] <jv>sorted</jv> = sort(<jv>array</jv>);</em>
+<a class="jxr_linenumber" name="L7126" href="#L7126">7126</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["apple", "banana", "zebra"]</jc></em>
+<a class="jxr_linenumber" name="L7127" href="#L7127">7127</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7128" href="#L7128">7128</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7129" href="#L7129">7129</a> <em class="jxr_javadoccomment"> * @param array The array to sort. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7130" href="#L7130">7130</a> <em class="jxr_javadoccomment"> * @return A new sorted array, or <jk>null</jk> if the array was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7131" href="#L7131">7131</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7132" href="#L7132">7132</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] sort(String[] array) {
+<a class="jxr_linenumber" name="L7133" href="#L7133">7133</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7134" href="#L7134">7134</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L7135" href="#L7135">7135</a> <strong class="jxr_keyword">var</strong> result = Arrays.copyOf(array, array.length);
+<a class="jxr_linenumber" name="L7136" href="#L7136">7136</a> Arrays.sort(result);
+<a class="jxr_linenumber" name="L7137" href="#L7137">7137</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L7138" href="#L7138">7138</a> }
+<a class="jxr_linenumber" name="L7139" href="#L7139">7139</a>
+<a class="jxr_linenumber" name="L7140" href="#L7140">7140</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7141" href="#L7141">7141</a> <em class="jxr_javadoccomment"> * Sorts a string array in case-insensitive order.</em>
+<a class="jxr_linenumber" name="L7142" href="#L7142">7142</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7143" href="#L7143">7143</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7144" href="#L7144">7144</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7145" href="#L7145">7145</a> <em class="jxr_javadoccomment"> * This method creates a copy of the array and sorts it using case-insensitive comparison,</em>
+<a class="jxr_linenumber" name="L7146" href="#L7146">7146</a> <em class="jxr_javadoccomment"> * leaving the original array unchanged.</em>
+<a class="jxr_linenumber" name="L7147" href="#L7147">7147</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7148" href="#L7148">7148</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7149" href="#L7149">7149</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7150" href="#L7150">7150</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"Zebra"</js>, <js>"apple"</js>, <js>"Banana"</js>};</em>
+<a class="jxr_linenumber" name="L7151" href="#L7151">7151</a> <em class="jxr_javadoccomment"> * String[] <jv>sorted</jv> = sortIgnoreCase(<jv>array</jv>);</em>
+<a class="jxr_linenumber" name="L7152" href="#L7152">7152</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["apple", "Banana", "Zebra"]</jc></em>
+<a class="jxr_linenumber" name="L7153" href="#L7153">7153</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7154" href="#L7154">7154</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7155" href="#L7155">7155</a> <em class="jxr_javadoccomment"> * @param array The array to sort. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7156" href="#L7156">7156</a> <em class="jxr_javadoccomment"> * @return A new sorted array (case-insensitive), or <jk>null</jk> if the array was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7157" href="#L7157">7157</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7158" href="#L7158">7158</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] sortIgnoreCase(String[] array) {
+<a class="jxr_linenumber" name="L7159" href="#L7159">7159</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7160" href="#L7160">7160</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L7161" href="#L7161">7161</a> <strong class="jxr_keyword">var</strong> result = Arrays.copyOf(array, array.length);
+<a class="jxr_linenumber" name="L7162" href="#L7162">7162</a> Arrays.sort(result, String.CASE_INSENSITIVE_ORDER);
+<a class="jxr_linenumber" name="L7163" href="#L7163">7163</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L7164" href="#L7164">7164</a> }
<a class="jxr_linenumber" name="L7165" href="#L7165">7165</a>
-<a class="jxr_linenumber" name="L7166" href="#L7166">7166</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7167" href="#L7167">7167</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder if the string is not empty.</em>
-<a class="jxr_linenumber" name="L7168" href="#L7168">7168</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7169" href="#L7169">7169</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7170" href="#L7170">7170</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
-<a class="jxr_linenumber" name="L7171" href="#L7171">7171</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk> or empty, nothing is appended.</em>
+<a class="jxr_linenumber" name="L7166" href="#L7166">7166</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L7167" href="#L7167">7167</a> <em class="jxr_comment">// String Builder Utilities</em>
+<a class="jxr_linenumber" name="L7168" href="#L7168">7168</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L7169" href="#L7169">7169</a>
+<a class="jxr_linenumber" name="L7170" href="#L7170">7170</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7171" href="#L7171">7171</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder if the string is not empty.</em>
<a class="jxr_linenumber" name="L7172" href="#L7172">7172</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7173" href="#L7173">7173</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7174" href="#L7174">7174</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7175" href="#L7175">7175</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
-<a class="jxr_linenumber" name="L7176" href="#L7176">7176</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>"hello"</js>); <jc>// Appends "hello"</jc></em>
-<a class="jxr_linenumber" name="L7177" href="#L7177">7177</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>""</js>); <jc>// Does nothing</jc></em>
-<a class="jxr_linenumber" name="L7178" href="#L7178">7178</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <jk>null</jk>); <jc>// Does nothing</jc></em>
-<a class="jxr_linenumber" name="L7179" href="#L7179">7179</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>"world"</js>); <jc>// Appends "world"</jc></em>
-<a class="jxr_linenumber" name="L7180" href="#L7180">7180</a> <em class="jxr_javadoccomment"> * <jc>// Result: "helloworld"</jc></em>
-<a class="jxr_linenumber" name="L7181" href="#L7181">7181</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L7182" href="#L7182">7182</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7183" href="#L7183">7183</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Must not be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7184" href="#L7184">7184</a> <em class="jxr_javadoccomment"> * @param str The string to append if not empty. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7185" href="#L7185">7185</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining.</em>
-<a class="jxr_linenumber" name="L7186" href="#L7186">7186</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If <c>sb</c> is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7187" href="#L7187">7187</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7188" href="#L7188">7188</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendIfNotEmpty(StringBuilder sb, String str) {
-<a class="jxr_linenumber" name="L7189" href="#L7189">7189</a> assertArgNotNull(<span class="jxr_string">"sb"</span>, sb);
-<a class="jxr_linenumber" name="L7190" href="#L7190">7190</a> <strong class="jxr_keyword">if</strong> (isNotEmpty(str))
-<a class="jxr_linenumber" name="L7191" href="#L7191">7191</a> sb.append(str);
-<a class="jxr_linenumber" name="L7192" href="#L7192">7192</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L7193" href="#L7193">7193</a> }
-<a class="jxr_linenumber" name="L7194" href="#L7194">7194</a>
-<a class="jxr_linenumber" name="L7195" href="#L7195">7195</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7196" href="#L7196">7196</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder if the string is not blank.</em>
-<a class="jxr_linenumber" name="L7197" href="#L7197">7197</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7198" href="#L7198">7198</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7199" href="#L7199">7199</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
-<a class="jxr_linenumber" name="L7200" href="#L7200">7200</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk>, empty, or contains only whitespace, nothing is appended.</em>
-<a class="jxr_linenumber" name="L7201" href="#L7201">7201</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7202" href="#L7202">7202</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7203" href="#L7203">7203</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7204" href="#L7204">7204</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
-<a class="jxr_linenumber" name="L7205" href="#L7205">7205</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>"hello"</js>); <jc>// Appends "hello"</jc></em>
-<a class="jxr_linenumber" name="L7206" href="#L7206">7206</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>" "</js>); <jc>// Does nothing</jc></em>
-<a class="jxr_linenumber" name="L7207" href="#L7207">7207</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <jk>null</jk>); <jc>// Does nothing</jc></em>
-<a class="jxr_linenumber" name="L7208" href="#L7208">7208</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>"world"</js>); <jc>// Appends "world"</jc></em>
-<a class="jxr_linenumber" name="L7209" href="#L7209">7209</a> <em class="jxr_javadoccomment"> * <jc>// Result: "helloworld"</jc></em>
-<a class="jxr_linenumber" name="L7210" href="#L7210">7210</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L7211" href="#L7211">7211</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7212" href="#L7212">7212</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Must not be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7213" href="#L7213">7213</a> <em class="jxr_javadoccomment"> * @param str The string to append if not blank. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7214" href="#L7214">7214</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining.</em>
-<a class="jxr_linenumber" name="L7215" href="#L7215">7215</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If <c>sb</c> is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7216" href="#L7216">7216</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7217" href="#L7217">7217</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendIfNotBlank(StringBuilder sb, String str) {
-<a class="jxr_linenumber" name="L7218" href="#L7218">7218</a> assertArgNotNull(<span class="jxr_string">"sb"</span>, sb);
-<a class="jxr_linenumber" name="L7219" href="#L7219">7219</a> <strong class="jxr_keyword">if</strong> (isNotBlank(str))
-<a class="jxr_linenumber" name="L7220" href="#L7220">7220</a> sb.append(str);
-<a class="jxr_linenumber" name="L7221" href="#L7221">7221</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L7222" href="#L7222">7222</a> }
-<a class="jxr_linenumber" name="L7223" href="#L7223">7223</a>
-<a class="jxr_linenumber" name="L7224" href="#L7224">7224</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7225" href="#L7225">7225</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder with a separator, only adding the separator if the StringBuilder is not empty.</em>
+<a class="jxr_linenumber" name="L7173" href="#L7173">7173</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7174" href="#L7174">7174</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
+<a class="jxr_linenumber" name="L7175" href="#L7175">7175</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk> or empty, nothing is appended.</em>
+<a class="jxr_linenumber" name="L7176" href="#L7176">7176</a> <em class="jxr_javadoccomment"> * If <c>sb</c> is <jk>null</jk> and an append is going to occur, a new StringBuilder is automatically created.</em>
+<a class="jxr_linenumber" name="L7177" href="#L7177">7177</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7178" href="#L7178">7178</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7179" href="#L7179">7179</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7180" href="#L7180">7180</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
+<a class="jxr_linenumber" name="L7181" href="#L7181">7181</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>"hello"</js>); <jc>// Appends "hello"</jc></em>
+<a class="jxr_linenumber" name="L7182" href="#L7182">7182</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>""</js>); <jc>// Does nothing</jc></em>
+<a class="jxr_linenumber" name="L7183" href="#L7183">7183</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <jk>null</jk>); <jc>// Does nothing</jc></em>
+<a class="jxr_linenumber" name="L7184" href="#L7184">7184</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>"world"</js>); <jc>// Appends "world"</jc></em>
+<a class="jxr_linenumber" name="L7185" href="#L7185">7185</a> <em class="jxr_javadoccomment"> * <jc>// Result: "helloworld"</jc></em>
+<a class="jxr_linenumber" name="L7186" href="#L7186">7186</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7187" href="#L7187">7187</a> <em class="jxr_javadoccomment"> * <jc>// Auto-create StringBuilder if null and append occurs</jc></em>
+<a class="jxr_linenumber" name="L7188" href="#L7188">7188</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb2</jv> = appendIfNotEmpty(<jk>null</jk>, <js>"test"</js>); <jc>// Creates new StringBuilder with "test"</jc></em>
+<a class="jxr_linenumber" name="L7189" href="#L7189">7189</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb3</jv> = appendIfNotEmpty(<jk>null</jk>, <jk>null</jk>); <jc>// Returns null (no append occurred)</jc></em>
+<a class="jxr_linenumber" name="L7190" href="#L7190">7190</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7191" href="#L7191">7191</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7192" href="#L7192">7192</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7193" href="#L7193">7193</a> <em class="jxr_javadoccomment"> * @param str The string to append if not empty. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7194" href="#L7194">7194</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining, or a new StringBuilder if <c>sb</c> was <jk>null</jk> and an append occurred, or <jk>null</jk> if <c>sb</c> was <jk>null</jk> and no append occurred.</em>
+<a class="jxr_linenumber" name="L7195" href="#L7195">7195</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7196" href="#L7196">7196</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendIfNotEmpty(StringBuilder sb, String str) {
+<a class="jxr_linenumber" name="L7197" href="#L7197">7197</a> <strong class="jxr_keyword">if</strong> (isNotEmpty(str)) {
+<a class="jxr_linenumber" name="L7198" href="#L7198">7198</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7199" href="#L7199">7199</a> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L7200" href="#L7200">7200</a> sb.append(str);
+<a class="jxr_linenumber" name="L7201" href="#L7201">7201</a> }
+<a class="jxr_linenumber" name="L7202" href="#L7202">7202</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L7203" href="#L7203">7203</a> }
+<a class="jxr_linenumber" name="L7204" href="#L7204">7204</a>
+<a class="jxr_linenumber" name="L7205" href="#L7205">7205</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7206" href="#L7206">7206</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder if the string is not blank.</em>
+<a class="jxr_linenumber" name="L7207" href="#L7207">7207</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7208" href="#L7208">7208</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7209" href="#L7209">7209</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
+<a class="jxr_linenumber" name="L7210" href="#L7210">7210</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk>, empty, or contains only whitespace, nothing is appended.</em>
+<a class="jxr_linenumber" name="L7211" href="#L7211">7211</a> <em class="jxr_javadoccomment"> * If <c>sb</c> is <jk>null</jk> and an append is going to occur, a new StringBuilder is automatically created.</em>
+<a class="jxr_linenumber" name="L7212" href="#L7212">7212</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7213" href="#L7213">7213</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7214" href="#L7214">7214</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7215" href="#L7215">7215</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
+<a class="jxr_linenumber" name="L7216" href="#L7216">7216</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>"hello"</js>); <jc>// Appends "hello"</jc></em>
+<a class="jxr_linenumber" name="L7217" href="#L7217">7217</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>" "</js>); <jc>// Does nothing</jc></em>
+<a class="jxr_linenumber" name="L7218" href="#L7218">7218</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <jk>null</jk>); <jc>// Does nothing</jc></em>
+<a class="jxr_linenumber" name="L7219" href="#L7219">7219</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>"world"</js>); <jc>// Appends "world"</jc></em>
+<a class="jxr_linenumber" name="L7220" href="#L7220">7220</a> <em class="jxr_javadoccomment"> * <jc>// Result: "helloworld"</jc></em>
+<a class="jxr_linenumber" name="L7221" href="#L7221">7221</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7222" href="#L7222">7222</a> <em class="jxr_javadoccomment"> * <jc>// Auto-create StringBuilder if null and append occurs</jc></em>
+<a class="jxr_linenumber" name="L7223" href="#L7223">7223</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb2</jv> = appendIfNotBlank(<jk>null</jk>, <js>"test"</js>); <jc>// Creates new StringBuilder with "test"</jc></em>
+<a class="jxr_linenumber" name="L7224" href="#L7224">7224</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb3</jv> = appendIfNotBlank(<jk>null</jk>, <js>" "</js>); <jc>// Returns null (no append occurred)</jc></em>
+<a class="jxr_linenumber" name="L7225" href="#L7225">7225</a> <em class="jxr_javadoccomment"> * </p></em>
<a class="jxr_linenumber" name="L7226" href="#L7226">7226</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7227" href="#L7227">7227</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7228" href="#L7228">7228</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
-<a class="jxr_linenumber" name="L7229" href="#L7229">7229</a> <em class="jxr_javadoccomment"> * If the StringBuilder is empty, only the string is appended (no separator).</em>
-<a class="jxr_linenumber" name="L7230" href="#L7230">7230</a> <em class="jxr_javadoccomment"> * If the StringBuilder is not empty, the separator is appended first, then the string.</em>
-<a class="jxr_linenumber" name="L7231" href="#L7231">7231</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7232" href="#L7232">7232</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7233" href="#L7233">7233</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7234" href="#L7234">7234</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
-<a class="jxr_linenumber" name="L7235" href="#L7235">7235</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"first"</js>, <js>", "</js>); <jc>// Appends "first"</jc></em>
-<a class="jxr_linenumber" name="L7236" href="#L7236">7236</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"second"</js>, <js>", "</js>); <jc>// Appends ", second"</jc></em>
-<a class="jxr_linenumber" name="L7237" href="#L7237">7237</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"third"</js>, <js>", "</js>); <jc>// Appends ", third"</jc></em>
-<a class="jxr_linenumber" name="L7238" href="#L7238">7238</a> <em class="jxr_javadoccomment"> * <jc>// Result: "first, second, third"</jc></em>
-<a class="jxr_linenumber" name="L7239" href="#L7239">7239</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L7240" href="#L7240">7240</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7241" href="#L7241">7241</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Must not be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7242" href="#L7242">7242</a> <em class="jxr_javadoccomment"> * @param str The string to append. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7243" href="#L7243">7243</a> <em class="jxr_javadoccomment"> * @param separator The separator to add before the string if the StringBuilder is not empty. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7244" href="#L7244">7244</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining.</em>
-<a class="jxr_linenumber" name="L7245" href="#L7245">7245</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If <c>sb</c> is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7246" href="#L7246">7246</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7247" href="#L7247">7247</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendWithSeparator(StringBuilder sb, String str, String separator) {
-<a class="jxr_linenumber" name="L7248" href="#L7248">7248</a> assertArgNotNull(<span class="jxr_string">"sb"</span>, sb);
-<a class="jxr_linenumber" name="L7249" href="#L7249">7249</a> <strong class="jxr_keyword">if</strong> (str != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="L7250" href="#L7250">7250</a> <strong class="jxr_keyword">if</strong> (sb.length() > 0 && separator != <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7251" href="#L7251">7251</a> sb.append(separator);
-<a class="jxr_linenumber" name="L7252" href="#L7252">7252</a> sb.append(str);
-<a class="jxr_linenumber" name="L7253" href="#L7253">7253</a> }
-<a class="jxr_linenumber" name="L7254" href="#L7254">7254</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L7255" href="#L7255">7255</a> }
-<a class="jxr_linenumber" name="L7256" href="#L7256">7256</a>
-<a class="jxr_linenumber" name="L7257" href="#L7257">7257</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7258" href="#L7258">7258</a> <em class="jxr_javadoccomment"> * Builds a string using a functional approach with a StringBuilder.</em>
-<a class="jxr_linenumber" name="L7259" href="#L7259">7259</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7260" href="#L7260">7260</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7261" href="#L7261">7261</a> <em class="jxr_javadoccomment"> * Creates a new StringBuilder, applies the consumer to it, and returns the resulting string.</em>
-<a class="jxr_linenumber" name="L7262" href="#L7262">7262</a> <em class="jxr_javadoccomment"> * This provides a functional way to build strings without manually managing the StringBuilder.</em>
-<a class="jxr_linenumber" name="L7263" href="#L7263">7263</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7264" href="#L7264">7264</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7265" href="#L7265">7265</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7266" href="#L7266">7266</a> <em class="jxr_javadoccomment"> * String <jv>result</jv> = buildString(<jv>sb</jv> -&gt; {</em>
-<a class="jxr_linenumber" name="L7267" href="#L7267">7267</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>"Hello"</js>);</em>
-<a class="jxr_linenumber" name="L7268" href="#L7268">7268</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>" "</js>);</em>
-<a class="jxr_linenumber" name="L7269" href="#L7269">7269</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>"World"</js>);</em>
-<a class="jxr_linenumber" name="L7270" href="#L7270">7270</a> <em class="jxr_javadoccomment"> * });</em>
-<a class="jxr_linenumber" name="L7271" href="#L7271">7271</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello World"</jc></em>
-<a class="jxr_linenumber" name="L7272" href="#L7272">7272</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7273" href="#L7273">7273</a> <em class="jxr_javadoccomment"> * String <jv>joined</jv> = buildString(<jv>sb</jv> -&gt; {</em>
-<a class="jxr_linenumber" name="L7274" href="#L7274">7274</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"a"</js>, <js>", "</js>);</em>
-<a class="jxr_linenumber" name="L7275" href="#L7275">7275</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"b"</js>, <js>", "</js>);</em>
-<a class="jxr_linenumber" name="L7276" href="#L7276">7276</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"c"</js>, <js>", "</js>);</em>
-<a class="jxr_linenumber" name="L7277" href="#L7277">7277</a> <em class="jxr_javadoccomment"> * });</em>
-<a class="jxr_linenumber" name="L7278" href="#L7278">7278</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "a, b, c"</jc></em>
-<a class="jxr_linenumber" name="L7279" href="#L7279">7279</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7227" href="#L7227">7227</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7228" href="#L7228">7228</a> <em class="jxr_javadoccomment"> * @param str The string to append if not blank. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7229" href="#L7229">7229</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining, or a new StringBuilder if <c>sb</c> was <jk>null</jk> and an append occurred, or <jk>null</jk> if <c>sb</c> was <jk>null</jk> and no append occurred.</em>
+<a class="jxr_linenumber" name="L7230" href="#L7230">7230</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7231" href="#L7231">7231</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendIfNotBlank(StringBuilder sb, String str) {
+<a class="jxr_linenumber" name="L7232" href="#L7232">7232</a> <strong class="jxr_keyword">if</strong> (isNotBlank(str)) {
+<a class="jxr_linenumber" name="L7233" href="#L7233">7233</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7234" href="#L7234">7234</a> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L7235" href="#L7235">7235</a> sb.append(str);
+<a class="jxr_linenumber" name="L7236" href="#L7236">7236</a> }
+<a class="jxr_linenumber" name="L7237" href="#L7237">7237</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L7238" href="#L7238">7238</a> }
+<a class="jxr_linenumber" name="L7239" href="#L7239">7239</a>
+<a class="jxr_linenumber" name="L7240" href="#L7240">7240</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7241" href="#L7241">7241</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder with a separator, only adding the separator if the StringBuilder is not empty.</em>
+<a class="jxr_linenumber" name="L7242" href="#L7242">7242</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7243" href="#L7243">7243</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7244" href="#L7244">7244</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
+<a class="jxr_linenumber" name="L7245" href="#L7245">7245</a> <em class="jxr_javadoccomment"> * If the StringBuilder is empty, only the string is appended (no separator).</em>
+<a class="jxr_linenumber" name="L7246" href="#L7246">7246</a> <em class="jxr_javadoccomment"> * If the StringBuilder is not empty, the separator is appended first, then the string.</em>
+<a class="jxr_linenumber" name="L7247" href="#L7247">7247</a> <em class="jxr_javadoccomment"> * If <c>sb</c> is <jk>null</jk> and an append is going to occur, a new StringBuilder is automatically created.</em>
+<a class="jxr_linenumber" name="L7248" href="#L7248">7248</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7249" href="#L7249">7249</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7250" href="#L7250">7250</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7251" href="#L7251">7251</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
+<a class="jxr_linenumber" name="L7252" href="#L7252">7252</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"first"</js>, <js>", "</js>); <jc>// Appends "first"</jc></em>
+<a class="jxr_linenumber" name="L7253" href="#L7253">7253</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"second"</js>, <js>", "</js>); <jc>// Appends ", second"</jc></em>
+<a class="jxr_linenumber" name="L7254" href="#L7254">7254</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"third"</js>, <js>", "</js>); <jc>// Appends ", third"</jc></em>
+<a class="jxr_linenumber" name="L7255" href="#L7255">7255</a> <em class="jxr_javadoccomment"> * <jc>// Result: "first, second, third"</jc></em>
+<a class="jxr_linenumber" name="L7256" href="#L7256">7256</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7257" href="#L7257">7257</a> <em class="jxr_javadoccomment"> * <jc>// Auto-create StringBuilder if null and append occurs</jc></em>
+<a class="jxr_linenumber" name="L7258" href="#L7258">7258</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb2</jv> = appendWithSeparator(<jk>null</jk>, <js>"test"</js>, <js>", "</js>); <jc>// Creates new StringBuilder with "test"</jc></em>
+<a class="jxr_linenumber" name="L7259" href="#L7259">7259</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb3</jv> = appendWithSeparator(<jk>null</jk>, <jk>null</jk>, <js>", "</js>); <jc>// Returns null (no append occurred)</jc></em>
+<a class="jxr_linenumber" name="L7260" href="#L7260">7260</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7261" href="#L7261">7261</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7262" href="#L7262">7262</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7263" href="#L7263">7263</a> <em class="jxr_javadoccomment"> * @param str The string to append. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7264" href="#L7264">7264</a> <em class="jxr_javadoccomment"> * @param separator The separator to add before the string if the StringBuilder is not empty. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7265" href="#L7265">7265</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining, or a new StringBuilder if <c>sb</c> was <jk>null</jk> and an append occurred, or <jk>null</jk> if <c>sb</c> was <jk>null</jk> and no append occurred.</em>
+<a class="jxr_linenumber" name="L7266" href="#L7266">7266</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7267" href="#L7267">7267</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendWithSeparator(StringBuilder sb, String str, String separator) {
+<a class="jxr_linenumber" name="L7268" href="#L7268">7268</a> <strong class="jxr_keyword">if</strong> (str != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="L7269" href="#L7269">7269</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7270" href="#L7270">7270</a> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L7271" href="#L7271">7271</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (sb.length() > 0 && separator != <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7272" href="#L7272">7272</a> sb.append(separator);
+<a class="jxr_linenumber" name="L7273" href="#L7273">7273</a> sb.append(str);
+<a class="jxr_linenumber" name="L7274" href="#L7274">7274</a> }
+<a class="jxr_linenumber" name="L7275" href="#L7275">7275</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L7276" href="#L7276">7276</a> }
+<a class="jxr_linenumber" name="L7277" href="#L7277">7277</a>
+<a class="jxr_linenumber" name="L7278" href="#L7278">7278</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7279" href="#L7279">7279</a> <em class="jxr_javadoccomment"> * Builds a string using a functional approach with a StringBuilder.</em>
<a class="jxr_linenumber" name="L7280" href="#L7280">7280</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7281" href="#L7281">7281</a> <em class="jxr_javadoccomment"> * @param builder The consumer that builds the string using the provided StringBuilder.</em>
-<a class="jxr_linenumber" name="L7282" href="#L7282">7282</a> <em class="jxr_javadoccomment"> * @return The built string.</em>
-<a class="jxr_linenumber" name="L7283" href="#L7283">7283</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If <c>builder</c> is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7284" href="#L7284">7284</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7285" href="#L7285">7285</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String buildString(Consumer<StringBuilder> builder) {
-<a class="jxr_linenumber" name="L7286" href="#L7286">7286</a> assertArgNotNull(<span class="jxr_string">"builder"</span>, builder);
-<a class="jxr_linenumber" name="L7287" href="#L7287">7287</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L7288" href="#L7288">7288</a> builder.accept(sb);
-<a class="jxr_linenumber" name="L7289" href="#L7289">7289</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L7290" href="#L7290">7290</a> }
-<a class="jxr_linenumber" name="L7291" href="#L7291">7291</a>
-<a class="jxr_linenumber" name="L7292" href="#L7292">7292</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L7293" href="#L7293">7293</a> <em class="jxr_comment">// Performance and Memory Utilities</em>
-<a class="jxr_linenumber" name="L7294" href="#L7294">7294</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L7295" href="#L7295">7295</a>
-<a class="jxr_linenumber" name="L7296" href="#L7296">7296</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7297" href="#L7297">7297</a> <em class="jxr_javadoccomment"> * Interns a string, returning the canonical representation.</em>
-<a class="jxr_linenumber" name="L7298" href="#L7298">7298</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7299" href="#L7299">7299</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7300" href="#L7300">7300</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the input string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7301" href="#L7301">7301</a> <em class="jxr_javadoccomment"> * This method provides a null-safe wrapper around {@link String#intern()}.</em>
-<a class="jxr_linenumber" name="L7302" href="#L7302">7302</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7303" href="#L7303">7303</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7304" href="#L7304">7304</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7305" href="#L7305">7305</a> <em class="jxr_javadoccomment"> * String <jv>s1</jv> = <jk>new</jk> String(<js>"test"</js>);</em>
-<a class="jxr_linenumber" name="L7306" href="#L7306">7306</a> <em class="jxr_javadoccomment"> * String <jv>s2</jv> = <jk>new</jk> String(<js>"test"</js>);</em>
-<a class="jxr_linenumber" name="L7307" href="#L7307">7307</a> <em class="jxr_javadoccomment"> * assertTrue(<jv>s1</jv> != <jv>s2</jv>); <jc>// Different objects</jc></em>
-<a class="jxr_linenumber" name="L7308" href="#L7308">7308</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7309" href="#L7309">7309</a> <em class="jxr_javadoccomment"> * String <jv>i1</jv> = intern(<jv>s1</jv>);</em>
-<a class="jxr_linenumber" name="L7310" href="#L7310">7310</a> <em class="jxr_javadoccomment"> * String <jv>i2</jv> = intern(<jv>s2</jv>);</em>
-<a class="jxr_linenumber" name="L7311" href="#L7311">7311</a> <em class="jxr_javadoccomment"> * assertTrue(<jv>i1</jv> == <jv>i2</jv>); <jc>// Same interned object</jc></em>
-<a class="jxr_linenumber" name="L7312" href="#L7312">7312</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L7313" href="#L7313">7313</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7314" href="#L7314">7314</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Performance Note:</h5></em>
-<a class="jxr_linenumber" name="L7315" href="#L7315">7315</a> <em class="jxr_javadoccomment"> * <p>String interning stores strings in a special pool, which can save memory when the same string</em>
-<a class="jxr_linenumber" name="L7316" href="#L7316">7316</a> <em class="jxr_javadoccomment"> * values are used repeatedly. However, the intern pool has limited size and interning can be slow,</em>
-<a class="jxr_linenumber" name="L7317" href="#L7317">7317</a> <em class="jxr_javadoccomment"> * so use judiciously for strings that are known to be repeated frequently.</p></em>
-<a class="jxr_linenumber" name="L7318" href="#L7318">7318</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7319" href="#L7319">7319</a> <em class="jxr_javadoccomment"> * @param str The string to intern. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7320" href="#L7320">7320</a> <em class="jxr_javadoccomment"> * @return The interned string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7321" href="#L7321">7321</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7322" href="#L7322">7322</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String intern(String str) {
-<a class="jxr_linenumber" name="L7323" href="#L7323">7323</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : str.intern();
-<a class="jxr_linenumber" name="L7324" href="#L7324">7324</a> }
-<a class="jxr_linenumber" name="L7325" href="#L7325">7325</a>
-<a class="jxr_linenumber" name="L7326" href="#L7326">7326</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7327" href="#L7327">7327</a> <em class="jxr_javadoccomment"> * Checks if a string is already interned.</em>
-<a class="jxr_linenumber" name="L7328" href="#L7328">7328</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7329" href="#L7329">7329</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7330" href="#L7330">7330</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the input string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7331" href="#L7331">7331</a> <em class="jxr_javadoccomment"> * A string is considered interned if it is the same object reference as its interned version.</em>
-<a class="jxr_linenumber" name="L7332" href="#L7332">7332</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7333" href="#L7333">7333</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7334" href="#L7334">7334</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7335" href="#L7335">7335</a> <em class="jxr_javadoccomment"> * String <jv>s1</jv> = <js>"test"</js>; <jc>// String literal is automatically interned</jc></em>
-<a class="jxr_linenumber" name="L7336" href="#L7336">7336</a> <em class="jxr_javadoccomment"> * assertTrue(isInterned(<jv>s1</jv>));</em>
-<a class="jxr_linenumber" name="L7337" href="#L7337">7337</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7338" href="#L7338">7338</a> <em class="jxr_javadoccomment"> * String <jv>s2</jv> = <jk>new</jk> String(<js>"test"</js>); <jc>// New object, not interned</jc></em>
-<a class="jxr_linenumber" name="L7339" href="#L7339">7339</a> <em class="jxr_javadoccomment"> * assertFalse(isInterned(<jv>s2</jv>));</em>
-<a class="jxr_linenumber" name="L7340" href="#L7340">7340</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7341" href="#L7341">7341</a> <em class="jxr_javadoccomment"> * String <jv>s3</jv> = intern(<jv>s2</jv>); <jc>// Now interned</jc></em>
-<a class="jxr_linenumber" name="L7342" href="#L7342">7342</a> <em class="jxr_javadoccomment"> * assertTrue(isInterned(<jv>s3</jv>));</em>
-<a class="jxr_linenumber" name="L7343" href="#L7343">7343</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L7344" href="#L7344">7344</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7345" href="#L7345">7345</a> <em class="jxr_javadoccomment"> * @param str The string to check. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7346" href="#L7346">7346</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is interned, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L7347" href="#L7347">7347</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7348" href="#L7348">7348</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isInterned(String str) {
-<a class="jxr_linenumber" name="L7349" href="#L7349">7349</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7350" href="#L7350">7350</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L7351" href="#L7351">7351</a> <strong class="jxr_keyword">return</strong> str == str.intern();
-<a class="jxr_linenumber" name="L7352" href="#L7352">7352</a> }
-<a class="jxr_linenumber" name="L7353" href="#L7353">7353</a>
-<a class="jxr_linenumber" name="L7354" href="#L7354">7354</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7355" href="#L7355">7355</a> <em class="jxr_javadoccomment"> * Calculates the approximate memory size of a string in bytes.</em>
-<a class="jxr_linenumber" name="L7356" href="#L7356">7356</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7357" href="#L7357">7357</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7358" href="#L7358">7358</a> <em class="jxr_javadoccomment"> * Returns <c>0</c> if the input string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7359" href="#L7359">7359</a> <em class="jxr_javadoccomment"> * This method provides an estimate based on typical JVM object layout:</em>
-<a class="jxr_linenumber" name="L7360" href="#L7360">7360</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L7361" href="#L7361">7361</a> <em class="jxr_javadoccomment"> * <li>String object overhead: ~24 bytes (object header + fields)</li></em>
-<a class="jxr_linenumber" name="L7362" href="#L7362">7362</a> <em class="jxr_javadoccomment"> * <li>char[] array overhead: ~16 bytes (array header)</li></em>
-<a class="jxr_linenumber" name="L7363" href="#L7363">7363</a> <em class="jxr_javadoccomment"> * <li>Character data: 2 bytes per character</li></em>
-<a class="jxr_linenumber" name="L7364" href="#L7364">7364</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L7281" href="#L7281">7281</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7282" href="#L7282">7282</a> <em class="jxr_javadoccomment"> * Creates a new StringBuilder, applies the consumer to it, and returns the resulting string.</em>
+<a class="jxr_linenumber" name="L7283" href="#L7283">7283</a> <em class="jxr_javadoccomment"> * This provides a functional way to build strings without manually managing the StringBuilder.</em>
+<a class="jxr_linenumber" name="L7284" href="#L7284">7284</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7285" href="#L7285">7285</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7286" href="#L7286">7286</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7287" href="#L7287">7287</a> <em class="jxr_javadoccomment"> * String <jv>result</jv> = buildString(<jv>sb</jv> -&gt; {</em>
+<a class="jxr_linenumber" name="L7288" href="#L7288">7288</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>"Hello"</js>);</em>
+<a class="jxr_linenumber" name="L7289" href="#L7289">7289</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>" "</js>);</em>
+<a class="jxr_linenumber" name="L7290" href="#L7290">7290</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>"World"</js>);</em>
+<a class="jxr_linenumber" name="L7291" href="#L7291">7291</a> <em class="jxr_javadoccomment"> * });</em>
+<a class="jxr_linenumber" name="L7292" href="#L7292">7292</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello World"</jc></em>
+<a class="jxr_linenumber" name="L7293" href="#L7293">7293</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7294" href="#L7294">7294</a> <em class="jxr_javadoccomment"> * String <jv>joined</jv> = buildString(<jv>sb</jv> -&gt; {</em>
+<a class="jxr_linenumber" name="L7295" href="#L7295">7295</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"a"</js>, <js>", "</js>);</em>
+<a class="jxr_linenumber" name="L7296" href="#L7296">7296</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"b"</js>, <js>", "</js>);</em>
+<a class="jxr_linenumber" name="L7297" href="#L7297">7297</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"c"</js>, <js>", "</js>);</em>
+<a class="jxr_linenumber" name="L7298" href="#L7298">7298</a> <em class="jxr_javadoccomment"> * });</em>
+<a class="jxr_linenumber" name="L7299" href="#L7299">7299</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "a, b, c"</jc></em>
+<a class="jxr_linenumber" name="L7300" href="#L7300">7300</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7301" href="#L7301">7301</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7302" href="#L7302">7302</a> <em class="jxr_javadoccomment"> * @param builder The consumer that builds the string using the provided StringBuilder.</em>
+<a class="jxr_linenumber" name="L7303" href="#L7303">7303</a> <em class="jxr_javadoccomment"> * @return The built string.</em>
+<a class="jxr_linenumber" name="L7304" href="#L7304">7304</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If <c>builder</c> is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7305" href="#L7305">7305</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7306" href="#L7306">7306</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String buildString(Consumer<StringBuilder> builder) {
+<a class="jxr_linenumber" name="L7307" href="#L7307">7307</a> assertArgNotNull(<span class="jxr_string">"builder"</span>, builder);
+<a class="jxr_linenumber" name="L7308" href="#L7308">7308</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L7309" href="#L7309">7309</a> builder.accept(sb);
+<a class="jxr_linenumber" name="L7310" href="#L7310">7310</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L7311" href="#L7311">7311</a> }
+<a class="jxr_linenumber" name="L7312" href="#L7312">7312</a>
+<a class="jxr_linenumber" name="L7313" href="#L7313">7313</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L7314" href="#L7314">7314</a> <em class="jxr_comment">// Performance and Memory Utilities</em>
+<a class="jxr_linenumber" name="L7315" href="#L7315">7315</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
+<a class="jxr_linenumber" name="L7316" href="#L7316">7316</a>
+<a class="jxr_linenumber" name="L7317" href="#L7317">7317</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7318" href="#L7318">7318</a> <em class="jxr_javadoccomment"> * Interns a string, returning the canonical representation.</em>
+<a class="jxr_linenumber" name="L7319" href="#L7319">7319</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7320" href="#L7320">7320</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7321" href="#L7321">7321</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7322" href="#L7322">7322</a> <em class="jxr_javadoccomment"> * This method provides a null-safe wrapper around {@link String#intern()}.</em>
+<a class="jxr_linenumber" name="L7323" href="#L7323">7323</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7324" href="#L7324">7324</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7325" href="#L7325">7325</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7326" href="#L7326">7326</a> <em class="jxr_javadoccomment"> * String <jv>s1</jv> = <jk>new</jk> String(<js>"test"</js>);</em>
+<a class="jxr_linenumber" name="L7327" href="#L7327">7327</a> <em class="jxr_javadoccomment"> * String <jv>s2</jv> = <jk>new</jk> String(<js>"test"</js>);</em>
+<a class="jxr_linenumber" name="L7328" href="#L7328">7328</a> <em class="jxr_javadoccomment"> * assertTrue(<jv>s1</jv> != <jv>s2</jv>); <jc>// Different objects</jc></em>
+<a class="jxr_linenumber" name="L7329" href="#L7329">7329</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7330" href="#L7330">7330</a> <em class="jxr_javadoccomment"> * String <jv>i1</jv> = intern(<jv>s1</jv>);</em>
+<a class="jxr_linenumber" name="L7331" href="#L7331">7331</a> <em class="jxr_javadoccomment"> * String <jv>i2</jv> = intern(<jv>s2</jv>);</em>
+<a class="jxr_linenumber" name="L7332" href="#L7332">7332</a> <em class="jxr_javadoccomment"> * assertTrue(<jv>i1</jv> == <jv>i2</jv>); <jc>// Same interned object</jc></em>
+<a class="jxr_linenumber" name="L7333" href="#L7333">7333</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7334" href="#L7334">7334</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7335" href="#L7335">7335</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Performance Note:</h5></em>
+<a class="jxr_linenumber" name="L7336" href="#L7336">7336</a> <em class="jxr_javadoccomment"> * <p>String interning stores strings in a special pool, which can save memory when the same string</em>
+<a class="jxr_linenumber" name="L7337" href="#L7337">7337</a> <em class="jxr_javadoccomment"> * values are used repeatedly. However, the intern pool has limited size and interning can be slow,</em>
+<a class="jxr_linenumber" name="L7338" href="#L7338">7338</a> <em class="jxr_javadoccomment"> * so use judiciously for strings that are known to be repeated frequently.</p></em>
+<a class="jxr_linenumber" name="L7339" href="#L7339">7339</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7340" href="#L7340">7340</a> <em class="jxr_javadoccomment"> * @param str The string to intern. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7341" href="#L7341">7341</a> <em class="jxr_javadoccomment"> * @return The interned string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7342" href="#L7342">7342</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7343" href="#L7343">7343</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String intern(String str) {
+<a class="jxr_linenumber" name="L7344" href="#L7344">7344</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : str.intern();
+<a class="jxr_linenumber" name="L7345" href="#L7345">7345</a> }
+<a class="jxr_linenumber" name="L7346" href="#L7346">7346</a>
+<a class="jxr_linenumber" name="L7347" href="#L7347">7347</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7348" href="#L7348">7348</a> <em class="jxr_javadoccomment"> * Checks if a string is already interned.</em>
+<a class="jxr_linenumber" name="L7349" href="#L7349">7349</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7350" href="#L7350">7350</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7351" href="#L7351">7351</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7352" href="#L7352">7352</a> <em class="jxr_javadoccomment"> * A string is considered interned if it is the same object reference as its interned version.</em>
+<a class="jxr_linenumber" name="L7353" href="#L7353">7353</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7354" href="#L7354">7354</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7355" href="#L7355">7355</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7356" href="#L7356">7356</a> <em class="jxr_javadoccomment"> * String <jv>s1</jv> = <js>"test"</js>; <jc>// String literal is automatically interned</jc></em>
+<a class="jxr_linenumber" name="L7357" href="#L7357">7357</a> <em class="jxr_javadoccomment"> * assertTrue(isInterned(<jv>s1</jv>));</em>
+<a class="jxr_linenumber" name="L7358" href="#L7358">7358</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7359" href="#L7359">7359</a> <em class="jxr_javadoccomment"> * String <jv>s2</jv> = <jk>new</jk> String(<js>"test"</js>); <jc>// New object, not interned</jc></em>
+<a class="jxr_linenumber" name="L7360" href="#L7360">7360</a> <em class="jxr_javadoccomment"> * assertFalse(isInterned(<jv>s2</jv>));</em>
+<a class="jxr_linenumber" name="L7361" href="#L7361">7361</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7362" href="#L7362">7362</a> <em class="jxr_javadoccomment"> * String <jv>s3</jv> = intern(<jv>s2</jv>); <jc>// Now interned</jc></em>
+<a class="jxr_linenumber" name="L7363" href="#L7363">7363</a> <em class="jxr_javadoccomment"> * assertTrue(isInterned(<jv>s3</jv>));</em>
+<a class="jxr_linenumber" name="L7364" href="#L7364">7364</a> <em class="jxr_javadoccomment"> * </p></em>
<a class="jxr_linenumber" name="L7365" href="#L7365">7365</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7366" href="#L7366">7366</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7367" href="#L7367">7367</a> <em class="jxr_javadoccomment"> * <b>Note:</b> Actual memory usage may vary based on JVM implementation, object alignment,</em>
-<a class="jxr_linenumber" name="L7368" href="#L7368">7368</a> <em class="jxr_javadoccomment"> * and whether compressed OOPs are enabled. This is an approximation for informational purposes.</em>
-<a class="jxr_linenumber" name="L7369" href="#L7369">7369</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7370" href="#L7370">7370</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7371" href="#L7371">7371</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7372" href="#L7372">7372</a> <em class="jxr_javadoccomment"> * getStringSize(<jk>null</jk>); <jc>// Returns: 0</jc></em>
-<a class="jxr_linenumber" name="L7373" href="#L7373">7373</a> <em class="jxr_javadoccomment"> * getStringSize(<js>""</js>); <jc>// Returns: ~40 bytes</jc></em>
-<a class="jxr_linenumber" name="L7374" href="#L7374">7374</a> <em class="jxr_javadoccomment"> * getStringSize(<js>"hello"</js>); <jc>// Returns: ~50 bytes (40 + 10)</jc></em>
-<a class="jxr_linenumber" name="L7375" href="#L7375">7375</a> <em class="jxr_javadoccomment"> * getStringSize(<js>"test"</js>); <jc>// Returns: ~48 bytes (40 + 8)</jc></em>
-<a class="jxr_linenumber" name="L7376" href="#L7376">7376</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7366" href="#L7366">7366</a> <em class="jxr_javadoccomment"> * @param str The string to check. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7367" href="#L7367">7367</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is interned, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L7368" href="#L7368">7368</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7369" href="#L7369">7369</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isInterned(String str) {
+<a class="jxr_linenumber" name="L7370" href="#L7370">7370</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7371" href="#L7371">7371</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L7372" href="#L7372">7372</a> <strong class="jxr_keyword">return</strong> str == str.intern();
+<a class="jxr_linenumber" name="L7373" href="#L7373">7373</a> }
+<a class="jxr_linenumber" name="L7374" href="#L7374">7374</a>
+<a class="jxr_linenumber" name="L7375" href="#L7375">7375</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7376" href="#L7376">7376</a> <em class="jxr_javadoccomment"> * Calculates the approximate memory size of a string in bytes.</em>
<a class="jxr_linenumber" name="L7377" href="#L7377">7377</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7378" href="#L7378">7378</a> <em class="jxr_javadoccomment"> * @param str The string to measure. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7379" href="#L7379">7379</a> <em class="jxr_javadoccomment"> * @return The approximate memory size in bytes, or <c>0</c> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7380" href="#L7380">7380</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7381" href="#L7381">7381</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> getStringSize(String str) {
-<a class="jxr_linenumber" name="L7382" href="#L7382">7382</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7383" href="#L7383">7383</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L7384" href="#L7384">7384</a> <em class="jxr_comment">// String object overhead: ~24 bytes (object header + fields: value, hash, coder)</em>
-<a class="jxr_linenumber" name="L7385" href="#L7385">7385</a> <em class="jxr_comment">// char[] array overhead: ~16 bytes (array header)</em>
-<a class="jxr_linenumber" name="L7386" href="#L7386">7386</a> <em class="jxr_comment">// Character data: 2 bytes per character</em>
-<a class="jxr_linenumber" name="L7387" href="#L7387">7387</a> <strong class="jxr_keyword">return</strong> 24L + 16L + (2L * str.length());
-<a class="jxr_linenumber" name="L7388" href="#L7388">7388</a> }
-<a class="jxr_linenumber" name="L7389" href="#L7389">7389</a>
-<a class="jxr_linenumber" name="L7390" href="#L7390">7390</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7391" href="#L7391">7391</a> <em class="jxr_javadoccomment"> * Provides optimization suggestions for a string based on its characteristics.</em>
-<a class="jxr_linenumber" name="L7392" href="#L7392">7392</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7393" href="#L7393">7393</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L7394" href="#L7394">7394</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the input string is <jk>null</jk> or if no optimizations are suggested.</em>
-<a class="jxr_linenumber" name="L7395" href="#L7395">7395</a> <em class="jxr_javadoccomment"> * Returns a string containing optimization suggestions separated by newlines.</em>
-<a class="jxr_linenumber" name="L7396" href="#L7396">7396</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7397" href="#L7397">7397</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Optimization Suggestions:</h5></em>
-<a class="jxr_linenumber" name="L7398" href="#L7398">7398</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L7399" href="#L7399">7399</a> <em class="jxr_javadoccomment"> * <li><b>Large strings:</b> Suggests using StringBuilder for concatenation</li></em>
-<a class="jxr_linenumber" name="L7400" href="#L7400">7400</a> <em class="jxr_javadoccomment"> * <li><b>Frequently used strings:</b> Suggests interning</li></em>
-<a class="jxr_linenumber" name="L7401" href="#L7401">7401</a> <em class="jxr_javadoccomment"> * <li><b>Character manipulation:</b> Suggests using char[] for intensive operations</li></em>
-<a class="jxr_linenumber" name="L7402" href="#L7402">7402</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L7403" href="#L7403">7403</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7404" href="#L7404">7404</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L7405" href="#L7405">7405</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L7406" href="#L7406">7406</a> <em class="jxr_javadoccomment"> * optimizeString(<jk>null</jk>); <jc>// Returns: null</jc></em>
-<a class="jxr_linenumber" name="L7407" href="#L7407">7407</a> <em class="jxr_javadoccomment"> * optimizeString(<js>"short"</js>); <jc>// Returns: null (no suggestions)</jc></em>
-<a class="jxr_linenumber" name="L7408" href="#L7408">7408</a> <em class="jxr_javadoccomment"> * optimizeString(<js>"very long string..."</js>); <jc>// Returns: suggestions for large strings</jc></em>
-<a class="jxr_linenumber" name="L7409" href="#L7409">7409</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L7410" href="#L7410">7410</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L7411" href="#L7411">7411</a> <em class="jxr_javadoccomment"> * @param str The string to analyze. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7412" href="#L7412">7412</a> <em class="jxr_javadoccomment"> * @return A string with optimization suggestions, or <jk>null</jk> if no suggestions or input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L7413" href="#L7413">7413</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7414" href="#L7414">7414</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String optimizeString(String str) {
-<a class="jxr_linenumber" name="L7415" href="#L7415">7415</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L7416" href="#L7416">7416</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L7417" href="#L7417">7417</a>
-<a class="jxr_linenumber" name="L7418" href="#L7418">7418</a> <strong class="jxr_keyword">var</strong> suggestions = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L7419" href="#L7419">7419</a> <strong class="jxr_keyword">var</strong> length = str.length();
-<a class="jxr_linenumber" name="L7420" href="#L7420">7420</a>
-<a class="jxr_linenumber" name="L7421" href="#L7421">7421</a> <em class="jxr_comment">// Suggest StringBuilder for large strings or frequent concatenation scenarios</em>
-<a class="jxr_linenumber" name="L7422" href="#L7422">7422</a> <strong class="jxr_keyword">if</strong> (length > 1000) {
-<a class="jxr_linenumber" name="L7423" href="#L7423">7423</a> suggestions.add(<span class="jxr_string">"Consider using StringBuilder for concatenation operations"</span>);
-<a class="jxr_linenumber" name="L7424" href="#L7424">7424</a> }
-<a class="jxr_linenumber" name="L7425" href="#L7425">7425</a>
-<a class="jxr_linenumber" name="L7426" href="#L7426">7426</a> <em class="jxr_comment">// Suggest interning for medium-length strings that might be repeated</em>
-<a class="jxr_linenumber" name="L7427" href="#L7427">7427</a> <strong class="jxr_keyword">if</strong> (length > 10 && length < 100 && ! isInterned(str)) {
-<a class="jxr_linenumber" name="L7428" href="#L7428">7428</a> suggestions.add(<span class="jxr_string">"Consider interning if this string is used frequently"</span>);
-<a class="jxr_linenumber" name="L7429" href="#L7429">7429</a> }
-<a class="jxr_linenumber" name="L7430" href="#L7430">7430</a>
-<a class="jxr_linenumber" name="L7431" href="#L7431">7431</a> <em class="jxr_comment">// Suggest char[] for intensive character manipulation</em>
-<a class="jxr_linenumber" name="L7432" href="#L7432">7432</a> <strong class="jxr_keyword">if</strong> (length > 100) {
-<a class="jxr_linenumber" name="L7433" href="#L7433">7433</a> suggestions.add(<span class="jxr_string">"For intensive character manipulation, consider using char[]"</span>);
-<a class="jxr_linenumber" name="L7434" href="#L7434">7434</a> }
-<a class="jxr_linenumber" name="L7435" href="#L7435">7435</a>
-<a class="jxr_linenumber" name="L7436" href="#L7436">7436</a> <em class="jxr_comment">// Suggest compression for very large strings</em>
-<a class="jxr_linenumber" name="L7437" href="#L7437">7437</a> <strong class="jxr_keyword">if</strong> (length > 10000) {
-<a class="jxr_linenumber" name="L7438" href="#L7438">7438</a> suggestions.add(<span class="jxr_string">"For very large strings, consider compression if storage is a concern"</span>);
-<a class="jxr_linenumber" name="L7439" href="#L7439">7439</a> }
-<a class="jxr_linenumber" name="L7440" href="#L7440">7440</a>
-<a class="jxr_linenumber" name="L7441" href="#L7441">7441</a> <strong class="jxr_keyword">return</strong> suggestions.isEmpty() ? <strong class="jxr_keyword">null</strong> : String.join(NEWLINE, suggestions);
-<a class="jxr_linenumber" name="L7442" href="#L7442">7442</a> }
-<a class="jxr_linenumber" name="L7443" href="#L7443">7443</a>
-<a class="jxr_linenumber" name="L7444" href="#L7444">7444</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L7445" href="#L7445">7445</a> <em class="jxr_javadoccomment"> * Constructor.</em>
-<a class="jxr_linenumber" name="L7446" href="#L7446">7446</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L7447" href="#L7447">7447</a> <strong class="jxr_keyword">protected</strong> <a name="StringUtils" href="../../../../../org/apache/juneau/common/utils/StringUtils.html#StringUtils">StringUtils</a>() {}
-<a class="jxr_linenumber" name="L7448" href="#L7448">7448</a> }
+<a class="jxr_linenumber" name="L7378" href="#L7378">7378</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7379" href="#L7379">7379</a> <em class="jxr_javadoccomment"> * Returns <c>0</c> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7380" href="#L7380">7380</a> <em class="jxr_javadoccomment"> * This method provides an estimate based on typical JVM object layout:</em>
+<a class="jxr_linenumber" name="L7381" href="#L7381">7381</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L7382" href="#L7382">7382</a> <em class="jxr_javadoccomment"> * <li>String object overhead: ~24 bytes (object header + fields)</li></em>
+<a class="jxr_linenumber" name="L7383" href="#L7383">7383</a> <em class="jxr_javadoccomment"> * <li>char[] array overhead: ~16 bytes (array header)</li></em>
+<a class="jxr_linenumber" name="L7384" href="#L7384">7384</a> <em class="jxr_javadoccomment"> * <li>Character data: 2 bytes per character</li></em>
+<a class="jxr_linenumber" name="L7385" href="#L7385">7385</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L7386" href="#L7386">7386</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7387" href="#L7387">7387</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7388" href="#L7388">7388</a> <em class="jxr_javadoccomment"> * <b>Note:</b> Actual memory usage may vary based on JVM implementation, object alignment,</em>
+<a class="jxr_linenumber" name="L7389" href="#L7389">7389</a> <em class="jxr_javadoccomment"> * and whether compressed OOPs are enabled. This is an approximation for informational purposes.</em>
+<a class="jxr_linenumber" name="L7390" href="#L7390">7390</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7391" href="#L7391">7391</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7392" href="#L7392">7392</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7393" href="#L7393">7393</a> <em class="jxr_javadoccomment"> * getStringSize(<jk>null</jk>); <jc>// Returns: 0</jc></em>
+<a class="jxr_linenumber" name="L7394" href="#L7394">7394</a> <em class="jxr_javadoccomment"> * getStringSize(<js>""</js>); <jc>// Returns: ~40 bytes</jc></em>
+<a class="jxr_linenumber" name="L7395" href="#L7395">7395</a> <em class="jxr_javadoccomment"> * getStringSize(<js>"hello"</js>); <jc>// Returns: ~50 bytes (40 + 10)</jc></em>
+<a class="jxr_linenumber" name="L7396" href="#L7396">7396</a> <em class="jxr_javadoccomment"> * getStringSize(<js>"test"</js>); <jc>// Returns: ~48 bytes (40 + 8)</jc></em>
+<a class="jxr_linenumber" name="L7397" href="#L7397">7397</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7398" href="#L7398">7398</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7399" href="#L7399">7399</a> <em class="jxr_javadoccomment"> * @param str The string to measure. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7400" href="#L7400">7400</a> <em class="jxr_javadoccomment"> * @return The approximate memory size in bytes, or <c>0</c> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7401" href="#L7401">7401</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7402" href="#L7402">7402</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> getStringSize(String str) {
+<a class="jxr_linenumber" name="L7403" href="#L7403">7403</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7404" href="#L7404">7404</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L7405" href="#L7405">7405</a> <em class="jxr_comment">// String object overhead: ~24 bytes (object header + fields: value, hash, coder)</em>
+<a class="jxr_linenumber" name="L7406" href="#L7406">7406</a> <em class="jxr_comment">// char[] array overhead: ~16 bytes (array header)</em>
+<a class="jxr_linenumber" name="L7407" href="#L7407">7407</a> <em class="jxr_comment">// Character data: 2 bytes per character</em>
+<a class="jxr_linenumber" name="L7408" href="#L7408">7408</a> <strong class="jxr_keyword">return</strong> 24L + 16L + (2L * str.length());
+<a class="jxr_linenumber" name="L7409" href="#L7409">7409</a> }
+<a class="jxr_linenumber" name="L7410" href="#L7410">7410</a>
+<a class="jxr_linenumber" name="L7411" href="#L7411">7411</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7412" href="#L7412">7412</a> <em class="jxr_javadoccomment"> * Provides optimization suggestions for a string based on its characteristics.</em>
+<a class="jxr_linenumber" name="L7413" href="#L7413">7413</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7414" href="#L7414">7414</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L7415" href="#L7415">7415</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the input string is <jk>null</jk> or if no optimizations are suggested.</em>
+<a class="jxr_linenumber" name="L7416" href="#L7416">7416</a> <em class="jxr_javadoccomment"> * Returns a string containing optimization suggestions separated by newlines.</em>
+<a class="jxr_linenumber" name="L7417" href="#L7417">7417</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7418" href="#L7418">7418</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Optimization Suggestions:</h5></em>
+<a class="jxr_linenumber" name="L7419" href="#L7419">7419</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L7420" href="#L7420">7420</a> <em class="jxr_javadoccomment"> * <li><b>Large strings:</b> Suggests using StringBuilder for concatenation</li></em>
+<a class="jxr_linenumber" name="L7421" href="#L7421">7421</a> <em class="jxr_javadoccomment"> * <li><b>Frequently used strings:</b> Suggests interning</li></em>
+<a class="jxr_linenumber" name="L7422" href="#L7422">7422</a> <em class="jxr_javadoccomment"> * <li><b>Character manipulation:</b> Suggests using char[] for intensive operations</li></em>
+<a class="jxr_linenumber" name="L7423" href="#L7423">7423</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L7424" href="#L7424">7424</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7425" href="#L7425">7425</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L7426" href="#L7426">7426</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7427" href="#L7427">7427</a> <em class="jxr_javadoccomment"> * optimizeString(<jk>null</jk>); <jc>// Returns: null</jc></em>
+<a class="jxr_linenumber" name="L7428" href="#L7428">7428</a> <em class="jxr_javadoccomment"> * optimizeString(<js>"short"</js>); <jc>// Returns: null (no suggestions)</jc></em>
+<a class="jxr_linenumber" name="L7429" href="#L7429">7429</a> <em class="jxr_javadoccomment"> * optimizeString(<js>"very long string..."</js>); <jc>// Returns: suggestions for large strings</jc></em>
+<a class="jxr_linenumber" name="L7430" href="#L7430">7430</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7431" href="#L7431">7431</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7432" href="#L7432">7432</a> <em class="jxr_javadoccomment"> * @param str The string to analyze. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7433" href="#L7433">7433</a> <em class="jxr_javadoccomment"> * @return A string with optimization suggestions, or <jk>null</jk> if no suggestions or input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7434" href="#L7434">7434</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7435" href="#L7435">7435</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String optimizeString(String str) {
+<a class="jxr_linenumber" name="L7436" href="#L7436">7436</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7437" href="#L7437">7437</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L7438" href="#L7438">7438</a>
+<a class="jxr_linenumber" name="L7439" href="#L7439">7439</a> <strong class="jxr_keyword">var</strong> suggestions = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L7440" href="#L7440">7440</a> <strong class="jxr_keyword">var</strong> length = str.length();
+<a class="jxr_linenumber" name="L7441" href="#L7441">7441</a>
+<a class="jxr_linenumber" name="L7442" href="#L7442">7442</a> <em class="jxr_comment">// Suggest StringBuilder for large strings or frequent concatenation scenarios</em>
+<a class="jxr_linenumber" name="L7443" href="#L7443">7443</a> <strong class="jxr_keyword">if</strong> (length > 1000) {
+<a class="jxr_linenumber" name="L7444" href="#L7444">7444</a> suggestions.add(<span class="jxr_string">"Consider using StringBuilder for concatenation operations"</span>);
+<a class="jxr_linenumber" name="L7445" href="#L7445">7445</a> }
+<a class="jxr_linenumber" name="L7446" href="#L7446">7446</a>
+<a class="jxr_linenumber" name="L7447" href="#L7447">7447</a> <em class="jxr_comment">// Suggest interning for medium-length strings that might be repeated</em>
+<a class="jxr_linenumber" name="L7448" href="#L7448">7448</a> <strong class="jxr_keyword">if</strong> (length > 10 && length < 100 && ! isInterned(str)) {
+<a class="jxr_linenumber" name="L7449" href="#L7449">7449</a> suggestions.add(<span class="jxr_string">"Consider interning if this string is used frequently"</span>);
+<a class="jxr_linenumber" name="L7450" href="#L7450">7450</a> }
+<a class="jxr_linenumber" name="L7451" href="#L7451">7451</a>
+<a class="jxr_linenumber" name="L7452" href="#L7452">7452</a> <em class="jxr_comment">// Suggest char[] for intensive character manipulation</em>
+<a class="jxr_linenumber" name="L7453" href="#L7453">7453</a> <strong class="jxr_keyword">if</strong> (length > 100) {
+<a class="jxr_linenumber" name="L7454" href="#L7454">7454</a> suggestions.add(<span class="jxr_string">"For intensive character manipulation, consider using char[]"</span>);
+<a class="jxr_linenumber" name="L7455" href="#L7455">7455</a> }
+<a class="jxr_linenumber" name="L7456" href="#L7456">7456</a>
+<a class="jxr_linenumber" name="L7457" href="#L7457">7457</a> <em class="jxr_comment">// Suggest compression for very large strings</em>
+<a class="jxr_linenumber" name="L7458" href="#L7458">7458</a> <strong class="jxr_keyword">if</strong> (length > 10000) {
+<a class="jxr_linenumber" name="L7459" href="#L7459">7459</a> suggestions.add(<span class="jxr_string">"For very large strings, consider compression if storage is a concern"</span>);
+<a class="jxr_linenumber" name="L7460" href="#L7460">7460</a> }
+<a class="jxr_linenumber" name="L7461" href="#L7461">7461</a>
+<a class="jxr_linenumber" name="L7462" href="#L7462">7462</a> <strong class="jxr_keyword">return</strong> suggestions.isEmpty() ? <strong class="jxr_keyword">null</strong> : String.join(NEWLINE, suggestions);
+<a class="jxr_linenumber" name="L7463" href="#L7463">7463</a> }
+<a class="jxr_linenumber" name="L7464" href="#L7464">7464</a>
+<a class="jxr_linenumber" name="L7465" href="#L7465">7465</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7466" href="#L7466">7466</a> <em class="jxr_javadoccomment"> * Constructor.</em>
+<a class="jxr_linenumber" name="L7467" href="#L7467">7467</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7468" href="#L7468">7468</a> <strong class="jxr_keyword">protected</strong> <a name="StringUtils" href="../../../../../org/apache/juneau/common/utils/StringUtils.html#StringUtils">StringUtils</a>() {}
+<a class="jxr_linenumber" name="L7469" href="#L7469">7469</a>
+<a class="jxr_linenumber" name="L7470" href="#L7470">7470</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7471" href="#L7471">7471</a> <em class="jxr_javadoccomment"> * Same as {@link Float#parseFloat(String)} but removes any underscore characters first.</em>
+<a class="jxr_linenumber" name="L7472" href="#L7472">7472</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7473" href="#L7473">7473</a> <em class="jxr_javadoccomment"> * <p>Allows for better readability of numeric literals (e.g., <js>"1_000.5"</js>).</em>
+<a class="jxr_linenumber" name="L7474" href="#L7474">7474</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7475" href="#L7475">7475</a> <em class="jxr_javadoccomment"> * @param value The string to parse.</em>
+<a class="jxr_linenumber" name="L7476" href="#L7476">7476</a> <em class="jxr_javadoccomment"> * @return The parsed float value.</em>
+<a class="jxr_linenumber" name="L7477" href="#L7477">7477</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the string cannot be parsed.</em>
+<a class="jxr_linenumber" name="L7478" href="#L7478">7478</a> <em class="jxr_javadoccomment"> * @throws NullPointerException If the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7479" href="#L7479">7479</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7480" href="#L7480">7480</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">float</strong> parseFloat(String value) {
+<a class="jxr_linenumber" name="L7481" href="#L7481">7481</a> <strong class="jxr_keyword">return</strong> Float.parseFloat(StringUtils.removeUnderscores(value));
+<a class="jxr_linenumber" name="L7482" href="#L7482">7482</a> }
+<a class="jxr_linenumber" name="L7483" href="#L7483">7483</a>
+<a class="jxr_linenumber" name="L7484" href="#L7484">7484</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7485" href="#L7485">7485</a> <em class="jxr_javadoccomment"> * Same as {@link Integer#parseInt(String)} but removes any underscore characters first.</em>
+<a class="jxr_linenumber" name="L7486" href="#L7486">7486</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7487" href="#L7487">7487</a> <em class="jxr_javadoccomment"> * <p>Allows for better readability of numeric literals (e.g., <js>"1_000_000"</js>).</em>
+<a class="jxr_linenumber" name="L7488" href="#L7488">7488</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7489" href="#L7489">7489</a> <em class="jxr_javadoccomment"> * @param value The string to parse.</em>
+<a class="jxr_linenumber" name="L7490" href="#L7490">7490</a> <em class="jxr_javadoccomment"> * @return The parsed integer value.</em>
+<a class="jxr_linenumber" name="L7491" href="#L7491">7491</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the string cannot be parsed.</em>
+<a class="jxr_linenumber" name="L7492" href="#L7492">7492</a> <em class="jxr_javadoccomment"> * @throws NullPointerException If the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7493" href="#L7493">7493</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7494" href="#L7494">7494</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> parseInt(String value) {
+<a class="jxr_linenumber" name="L7495" href="#L7495">7495</a> <strong class="jxr_keyword">return</strong> Integer.parseInt(StringUtils.removeUnderscores(value));
+<a class="jxr_linenumber" name="L7496" href="#L7496">7496</a> }
+<a class="jxr_linenumber" name="L7497" href="#L7497">7497</a>
+<a class="jxr_linenumber" name="L7498" href="#L7498">7498</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7499" href="#L7499">7499</a> <em class="jxr_javadoccomment"> * Same as {@link Long#parseLong(String)} but removes any underscore characters first.</em>
+<a class="jxr_linenumber" name="L7500" href="#L7500">7500</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7501" href="#L7501">7501</a> <em class="jxr_javadoccomment"> * <p>Allows for better readability of numeric literals (e.g., <js>"1_000_000"</js>).</em>
+<a class="jxr_linenumber" name="L7502" href="#L7502">7502</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7503" href="#L7503">7503</a> <em class="jxr_javadoccomment"> * @param value The string to parse.</em>
+<a class="jxr_linenumber" name="L7504" href="#L7504">7504</a> <em class="jxr_javadoccomment"> * @return The parsed long value.</em>
+<a class="jxr_linenumber" name="L7505" href="#L7505">7505</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the string cannot be parsed.</em>
+<a class="jxr_linenumber" name="L7506" href="#L7506">7506</a> <em class="jxr_javadoccomment"> * @throws NullPointerException If the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7507" href="#L7507">7507</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7508" href="#L7508">7508</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> parseLong(String value) {
+<a class="jxr_linenumber" name="L7509" href="#L7509">7509</a> <strong class="jxr_keyword">return</strong> Long.parseLong(StringUtils.removeUnderscores(value));
+<a class="jxr_linenumber" name="L7510" href="#L7510">7510</a> }
+<a class="jxr_linenumber" name="L7511" href="#L7511">7511</a>
+<a class="jxr_linenumber" name="L7512" href="#L7512">7512</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7513" href="#L7513">7513</a> <em class="jxr_javadoccomment"> * Converts a string containing glob-style wildcard characters to a regular expression {@link java.util.regex.Pattern}.</em>
+<a class="jxr_linenumber" name="L7514" href="#L7514">7514</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7515" href="#L7515">7515</a> <em class="jxr_javadoccomment"> * <p>This method converts glob-style patterns to regular expressions with the following mappings:</em>
+<a class="jxr_linenumber" name="L7516" href="#L7516">7516</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L7517" href="#L7517">7517</a> <em class="jxr_javadoccomment"> * <li>{@code *} matches any sequence of characters (including none)</li></em>
+<a class="jxr_linenumber" name="L7518" href="#L7518">7518</a> <em class="jxr_javadoccomment"> * <li>{@code ?} matches exactly one character</li></em>
+<a class="jxr_linenumber" name="L7519" href="#L7519">7519</a> <em class="jxr_javadoccomment"> * <li>All other characters are treated literally</li></em>
+<a class="jxr_linenumber" name="L7520" href="#L7520">7520</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L7521" href="#L7521">7521</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7522" href="#L7522">7522</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L7523" href="#L7523">7523</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7524" href="#L7524">7524</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>pattern</jv> = <jsm>getGlobMatchPattern</jsm>(<js>"user_*_temp"</js>);</em>
+<a class="jxr_linenumber" name="L7525" href="#L7525">7525</a> <em class="jxr_javadoccomment"> * <jk>boolean</jk> <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_alice_temp"</js>).matches(); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L7526" href="#L7526">7526</a> <em class="jxr_javadoccomment"> * <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_bob_temp"</js>).matches(); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L7527" href="#L7527">7527</a> <em class="jxr_javadoccomment"> * <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"admin_alice_temp"</js>).matches(); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L7528" href="#L7528">7528</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7529" href="#L7529">7529</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7530" href="#L7530">7530</a> <em class="jxr_javadoccomment"> * @param s The glob-style wildcard pattern string.</em>
+<a class="jxr_linenumber" name="L7531" href="#L7531">7531</a> <em class="jxr_javadoccomment"> * @return A compiled {@link java.util.regex.Pattern} object, or <jk>null</jk> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7532" href="#L7532">7532</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7533" href="#L7533">7533</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> java.util.regex.Pattern getGlobMatchPattern(String s) {
+<a class="jxr_linenumber" name="L7534" href="#L7534">7534</a> <strong class="jxr_keyword">return</strong> getGlobMatchPattern(s, 0);
+<a class="jxr_linenumber" name="L7535" href="#L7535">7535</a> }
+<a class="jxr_linenumber" name="L7536" href="#L7536">7536</a>
+<a class="jxr_linenumber" name="L7537" href="#L7537">7537</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L7538" href="#L7538">7538</a> <em class="jxr_javadoccomment"> * Converts a string containing glob-style wildcard characters to a regular expression {@link java.util.regex.Pattern} with flags.</em>
+<a class="jxr_linenumber" name="L7539" href="#L7539">7539</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7540" href="#L7540">7540</a> <em class="jxr_javadoccomment"> * <p>This method converts glob-style patterns to regular expressions with the following mappings:</em>
+<a class="jxr_linenumber" name="L7541" href="#L7541">7541</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L7542" href="#L7542">7542</a> <em class="jxr_javadoccomment"> * <li>{@code *} matches any sequence of characters (including none)</li></em>
+<a class="jxr_linenumber" name="L7543" href="#L7543">7543</a> <em class="jxr_javadoccomment"> * <li>{@code ?} matches exactly one character</li></em>
+<a class="jxr_linenumber" name="L7544" href="#L7544">7544</a> <em class="jxr_javadoccomment"> * <li>All other characters are treated literally</li></em>
+<a class="jxr_linenumber" name="L7545" href="#L7545">7545</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L7546" href="#L7546">7546</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7547" href="#L7547">7547</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L7548" href="#L7548">7548</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L7549" href="#L7549">7549</a> <em class="jxr_javadoccomment"> * <jc>// Case-insensitive matching</jc></em>
+<a class="jxr_linenumber" name="L7550" href="#L7550">7550</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>pattern</jv> = <jsm>getGlobMatchPattern</jsm>(<js>"USER_*"</js>, Pattern.<jsf>CASE_INSENSITIVE</jsf>);</em>
+<a class="jxr_linenumber" name="L7551" href="#L7551">7551</a> <em class="jxr_javadoccomment"> * <jk>boolean</jk> <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_alice"</js>).matches(); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L7552" href="#L7552">7552</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L7553" href="#L7553">7553</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L7554" href="#L7554">7554</a> <em class="jxr_javadoccomment"> * @param s The glob-style wildcard pattern string.</em>
+<a class="jxr_linenumber" name="L7555" href="#L7555">7555</a> <em class="jxr_javadoccomment"> * @param flags Regular expression flags (see {@link java.util.regex.Pattern} constants).</em>
+<a class="jxr_linenumber" name="L7556" href="#L7556">7556</a> <em class="jxr_javadoccomment"> * @return A compiled {@link java.util.regex.Pattern} object, or <jk>null</jk> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L7557" href="#L7557">7557</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L7558" href="#L7558">7558</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> java.util.regex.Pattern getGlobMatchPattern(String s, <strong class="jxr_keyword">int</strong> flags) {
+<a class="jxr_linenumber" name="L7559" href="#L7559">7559</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L7560" href="#L7560">7560</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L7561" href="#L7561">7561</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L7562" href="#L7562">7562</a> sb.append(<span class="jxr_string">"\\Q"</span>);
+<a class="jxr_linenumber" name="L7563" href="#L7563">7563</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L7564" href="#L7564">7564</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L7565" href="#L7565">7565</a> <strong class="jxr_keyword">if</strong> (c == '*')
+<a class="jxr_linenumber" name="L7566" href="#L7566">7566</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">".*"</span>).append(<span class="jxr_string">"\\Q"</span>);
+<a class="jxr_linenumber" name="L7567" href="#L7567">7567</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '?')
+<a class="jxr_linenumber" name="L7568" href="#L7568">7568</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">"."</span>).append(<span class="jxr_string">"\\Q"</span>);
+<a class="jxr_linenumber" name="L7569" href="#L7569">7569</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L7570" href="#L7570">7570</a> sb.append(c);
+<a class="jxr_linenumber" name="L7571" href="#L7571">7571</a> }
+<a class="jxr_linenumber" name="L7572" href="#L7572">7572</a> sb.append(<span class="jxr_string">"\\E"</span>);
+<a class="jxr_linenumber" name="L7573" href="#L7573">7573</a> <strong class="jxr_keyword">return</strong> java.util.regex.Pattern.compile(sb.toString(), flags);
+<a class="jxr_linenumber" name="L7574" href="#L7574">7574</a> }
+<a class="jxr_linenumber" name="L7575" href="#L7575">7575</a>
+<a class="jxr_linenumber" name="L7576" href="#L7576">7576</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String removeUnderscores(String value) {
+<a class="jxr_linenumber" name="L7577" href="#L7577">7577</a> assertArgNotNull(<span class="jxr_string">"value"</span>, value);
+<a class="jxr_linenumber" name="L7578" href="#L7578">7578</a> <strong class="jxr_keyword">return</strong> notContains(value, '_') ? value : value.replace(<span class="jxr_string">"_"</span>, <span class="jxr_string">""</span>);
+<a class="jxr_linenumber" name="L7579" href="#L7579">7579</a> }
+<a class="jxr_linenumber" name="L7580" href="#L7580">7580</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/common/utils/Utils.html b/site/xref/org/apache/juneau/common/utils/Utils.html
index 951679b3cd..d70f211733 100644
--- a/site/xref/org/apache/juneau/common/utils/Utils.html
+++ b/site/xref/org/apache/juneau/common/utils/Utils.html
@@ -198,1094 +198,912 @@
<a class="jxr_linenumber" name="L190" href="#L190">190</a> <em class="jxr_javadoccomment">/**</em>
<a class="jxr_linenumber" name="L191" href="#L191">191</a> <em class="jxr_javadoccomment"> * Tests two objects for equality, gracefully handling nulls and arrays.</em>
<a class="jxr_linenumber" name="L192" href="#L192">192</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L193" href="#L193">193</a> <em class="jxr_javadoccomment"> * @param <T> The value types.</em>
-<a class="jxr_linenumber" name="L194" href="#L194">194</a> <em class="jxr_javadoccomment"> * @param o1 Object 1.</em>
-<a class="jxr_linenumber" name="L195" href="#L195">195</a> <em class="jxr_javadoccomment"> * @param o2 Object 2.</em>
-<a class="jxr_linenumber" name="L196" href="#L196">196</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if both objects are equal based on the {@link Object#equals(Object)} method.</em>
-<a class="jxr_linenumber" name="L197" href="#L197">197</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L198" href="#L198">198</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> <strong class="jxr_keyword">boolean</strong> eq(T o1, T o2) {
-<a class="jxr_linenumber" name="L199" href="#L199">199</a> <strong class="jxr_keyword">if</strong> (isArray(o1) && isArray(o2)) {
-<a class="jxr_linenumber" name="L200" href="#L200">200</a> <strong class="jxr_keyword">int</strong> l1 = Array.getLength(o1), l2 = Array.getLength(o2);
-<a class="jxr_linenumber" name="L201" href="#L201">201</a> <strong class="jxr_keyword">if</strong> (l1 != l2)
-<a class="jxr_linenumber" name="L202" href="#L202">202</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L203" href="#L203">203</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < l1; i++)
-<a class="jxr_linenumber" name="L204" href="#L204">204</a> <strong class="jxr_keyword">if</strong> (ne(Array.get(o1, i), Array.get(o2, i)))
-<a class="jxr_linenumber" name="L205" href="#L205">205</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L206" href="#L206">206</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L207" href="#L207">207</a> }
-<a class="jxr_linenumber" name="L208" href="#L208">208</a> <strong class="jxr_keyword">return</strong> Objects.equals(o1, o2);
-<a class="jxr_linenumber" name="L209" href="#L209">209</a> }
-<a class="jxr_linenumber" name="L210" href="#L210">210</a>
-<a class="jxr_linenumber" name="L211" href="#L211">211</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L212" href="#L212">212</a> <em class="jxr_javadoccomment"> * Tests two objects for equality, gracefully handling nulls.</em>
-<a class="jxr_linenumber" name="L213" href="#L213">213</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L214" href="#L214">214</a> <em class="jxr_javadoccomment"> * Allows you to simplify object comparison without sacrificing efficiency.</em>
-<a class="jxr_linenumber" name="L215" href="#L215">215</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L216" href="#L216">216</a> <em class="jxr_javadoccomment"> * Example:</em>
-<a class="jxr_linenumber" name="L217" href="#L217">217</a> <em class="jxr_javadoccomment"> * <code></em>
-<a class="jxr_linenumber" name="L218" href="#L218">218</a> <em class="jxr_javadoccomment"> * public boolean equals(Object o)</em>
-<a class="jxr_linenumber" name="L219" href="#L219">219</a> <em class="jxr_javadoccomment"> * return eq(this, (Role)o, (x,y)-&gt;eq(x.id,y.id) &amp;&amp; eq(x.name,y.name) &amp;&amp; eq(x.created,y.created) &amp;&amp; eq(x.createdBy,y.createdBy));</em>
-<a class="jxr_linenumber" name="L220" href="#L220">220</a> <em class="jxr_javadoccomment"> * }</em>
-<a class="jxr_linenumber" name="L221" href="#L221">221</a> <em class="jxr_javadoccomment"> * </code></em>
+<a class="jxr_linenumber" name="L193" href="#L193">193</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L194" href="#L194">194</a> <em class="jxr_javadoccomment"> * This method handles annotations specially by delegating to {@link AnnotationUtils#equals(Annotation, Annotation)}</em>
+<a class="jxr_linenumber" name="L195" href="#L195">195</a> <em class="jxr_javadoccomment"> * to ensure proper annotation comparison according to the annotation equality contract.</em>
+<a class="jxr_linenumber" name="L196" href="#L196">196</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L197" href="#L197">197</a> <em class="jxr_javadoccomment"> * @param <T> The value types.</em>
+<a class="jxr_linenumber" name="L198" href="#L198">198</a> <em class="jxr_javadoccomment"> * @param o1 Object 1.</em>
+<a class="jxr_linenumber" name="L199" href="#L199">199</a> <em class="jxr_javadoccomment"> * @param o2 Object 2.</em>
+<a class="jxr_linenumber" name="L200" href="#L200">200</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if both objects are equal based on the {@link Object#equals(Object)} method.</em>
+<a class="jxr_linenumber" name="L201" href="#L201">201</a> <em class="jxr_javadoccomment"> * @see AnnotationUtils#equals(Annotation, Annotation)</em>
+<a class="jxr_linenumber" name="L202" href="#L202">202</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L203" href="#L203">203</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> <strong class="jxr_keyword">boolean</strong> eq(T o1, T o2) {
+<a class="jxr_linenumber" name="L204" href="#L204">204</a> <em class="jxr_comment">// Handle annotations specially</em>
+<a class="jxr_linenumber" name="L205" href="#L205">205</a> <strong class="jxr_keyword">if</strong> (o1 instanceof java.lang.annotation.Annotation o1a && o2 instanceof java.lang.annotation.Annotation o2a)
+<a class="jxr_linenumber" name="L206" href="#L206">206</a> <strong class="jxr_keyword">return</strong> AnnotationUtils.equals(o1a, o2a);
+<a class="jxr_linenumber" name="L207" href="#L207">207</a>
+<a class="jxr_linenumber" name="L208" href="#L208">208</a> <strong class="jxr_keyword">if</strong> (isArray(o1) && isArray(o2)) {
+<a class="jxr_linenumber" name="L209" href="#L209">209</a> <strong class="jxr_keyword">int</strong> l1 = Array.getLength(o1), l2 = Array.getLength(o2);
+<a class="jxr_linenumber" name="L210" href="#L210">210</a> <strong class="jxr_keyword">if</strong> (l1 != l2)
+<a class="jxr_linenumber" name="L211" href="#L211">211</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L212" href="#L212">212</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < l1; i++)
+<a class="jxr_linenumber" name="L213" href="#L213">213</a> <strong class="jxr_keyword">if</strong> (ne(Array.get(o1, i), Array.get(o2, i)))
+<a class="jxr_linenumber" name="L214" href="#L214">214</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L215" href="#L215">215</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L216" href="#L216">216</a> }
+<a class="jxr_linenumber" name="L217" href="#L217">217</a> <strong class="jxr_keyword">return</strong> Objects.equals(o1, o2);
+<a class="jxr_linenumber" name="L218" href="#L218">218</a> }
+<a class="jxr_linenumber" name="L219" href="#L219">219</a>
+<a class="jxr_linenumber" name="L220" href="#L220">220</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L221" href="#L221">221</a> <em class="jxr_javadoccomment"> * Tests two objects for equality, gracefully handling nulls.</em>
<a class="jxr_linenumber" name="L222" href="#L222">222</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L223" href="#L223">223</a> <em class="jxr_javadoccomment"> * @param <T> Object 1 type.</em>
-<a class="jxr_linenumber" name="L224" href="#L224">224</a> <em class="jxr_javadoccomment"> * @param <U> Object 2 type.</em>
-<a class="jxr_linenumber" name="L225" href="#L225">225</a> <em class="jxr_javadoccomment"> * @param o1 Object 1.</em>
-<a class="jxr_linenumber" name="L226" href="#L226">226</a> <em class="jxr_javadoccomment"> * @param o2 Object 2.</em>
-<a class="jxr_linenumber" name="L227" href="#L227">227</a> <em class="jxr_javadoccomment"> * @param test The test to use for equality.</em>
-<a class="jxr_linenumber" name="L228" href="#L228">228</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if both objects are equal based on the test.</em>
-<a class="jxr_linenumber" name="L229" href="#L229">229</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L230" href="#L230">230</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T,U> <strong class="jxr_keyword">boolean</strong> eq(T o1, U o2, BiPredicate<T,U> test) {
-<a class="jxr_linenumber" name="L231" href="#L231">231</a> <strong class="jxr_keyword">if</strong> (o1 == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="L232" href="#L232">232</a> <strong class="jxr_keyword">return</strong> o2 == <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L233" href="#L233">233</a> }
-<a class="jxr_linenumber" name="L234" href="#L234">234</a> <strong class="jxr_keyword">if</strong> (o2 == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="L235" href="#L235">235</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L236" href="#L236">236</a> }
-<a class="jxr_linenumber" name="L237" href="#L237">237</a> <strong class="jxr_keyword">if</strong> (o1 == o2) {
-<a class="jxr_linenumber" name="L238" href="#L238">238</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L239" href="#L239">239</a> }
-<a class="jxr_linenumber" name="L240" href="#L240">240</a> <strong class="jxr_keyword">return</strong> test.test(o1, o2);
-<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="L243" href="#L243">243</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L244" href="#L244">244</a> <em class="jxr_javadoccomment"> * Tests two annotations for equality using the criteria presented in the {@link java.lang.annotation.Annotation#equals(Object)} API docs.</em>
-<a class="jxr_linenumber" name="L245" href="#L245">245</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L246" href="#L246">246</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L247" href="#L247">247</a> <em class="jxr_javadoccomment"> * This method delegates to {@link AnnotationUtils#equals(java.lang.annotation.Annotation, java.lang.annotation.Annotation)}</em>
-<a class="jxr_linenumber" name="L248" href="#L248">248</a> <em class="jxr_javadoccomment"> * to ensure proper annotation comparison according to the annotation equality contract.</em>
-<a class="jxr_linenumber" name="L249" href="#L249">249</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L250" href="#L250">250</a> <em class="jxr_javadoccomment"> * @param a1 Annotation 1.</em>
-<a class="jxr_linenumber" name="L251" href="#L251">251</a> <em class="jxr_javadoccomment"> * @param a2 Annotation 2.</em>
-<a class="jxr_linenumber" name="L252" href="#L252">252</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the two annotations are equal or both are <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L253" href="#L253">253</a> <em class="jxr_javadoccomment"> * @see AnnotationUtils#equals(java.lang.annotation.Annotation, java.lang.annotation.Annotation)</em>
-<a class="jxr_linenumber" name="L254" href="#L254">254</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L255" href="#L255">255</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> eq(java.lang.annotation.Annotation a1, java.lang.annotation.Annotation a2) {
-<a class="jxr_linenumber" name="L256" href="#L256">256</a> <strong class="jxr_keyword">return</strong> AnnotationUtils.equals(a1, a2);
-<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> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L260" href="#L260">260</a> <em class="jxr_javadoccomment"> * Tests two annotations for inequality using the criteria presented in the {@link java.lang.annotation.Annotation#equals(Object)} API docs.</em>
-<a class="jxr_linenumber" name="L261" href="#L261">261</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L262" href="#L262">262</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L263" href="#L263">263</a> <em class="jxr_javadoccomment"> * This method is the negation of {@link #eq(java.lang.annotation.Annotation, java.lang.annotation.Annotation)},</em>
-<a class="jxr_linenumber" name="L264" href="#L264">264</a> <em class="jxr_javadoccomment"> * which delegates to {@link AnnotationUtils#equals(java.lang.annotation.Annotation, java.lang.annotation.Annotation)}.</em>
-<a class="jxr_linenumber" name="L265" href="#L265">265</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L266" href="#L266">266</a> <em class="jxr_javadoccomment"> * @param a1 Annotation 1.</em>
-<a class="jxr_linenumber" name="L267" href="#L267">267</a> <em class="jxr_javadoccomment"> * @param a2 Annotation 2.</em>
-<a class="jxr_linenumber" name="L268" href="#L268">268</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the two annotations are not equal.</em>
-<a class="jxr_linenumber" name="L269" href="#L269">269</a> <em class="jxr_javadoccomment"> * @see #eq(java.lang.annotation.Annotation, java.lang.annotation.Annotation)</em>
-<a class="jxr_linenumber" name="L270" href="#L270">270</a> <em class="jxr_javadoccomment"> * @see AnnotationUtils#equals(java.lang.annotation.Annotation, java.lang.annotation.Annotation)</em>
-<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> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> ne(java.lang.annotation.Annotation a1, java.lang.annotation.Annotation a2) {
-<a class="jxr_linenumber" name="L273" href="#L273">273</a> <strong class="jxr_keyword">return</strong> ! eq(a1, a2);
-<a class="jxr_linenumber" name="L274" href="#L274">274</a> }
-<a class="jxr_linenumber" name="L275" href="#L275">275</a>
-<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"> * Tests two strings for case-insensitive equality, but gracefully handles nulls.</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> <em class="jxr_javadoccomment"> * @param s1 String 1.</em>
-<a class="jxr_linenumber" name="L280" href="#L280">280</a> <em class="jxr_javadoccomment"> * @param s2 String 2.</em>
-<a class="jxr_linenumber" name="L281" href="#L281">281</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the strings are equal.</em>
-<a class="jxr_linenumber" name="L282" href="#L282">282</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L283" href="#L283">283</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> eqic(String s1, String s2) {
-<a class="jxr_linenumber" name="L284" href="#L284">284</a> <strong class="jxr_keyword">if</strong> (s1 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L285" href="#L285">285</a> <strong class="jxr_keyword">return</strong> s2 == <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L286" href="#L286">286</a> <strong class="jxr_keyword">if</strong> (s2 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L287" href="#L287">287</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L288" href="#L288">288</a> <strong class="jxr_keyword">return</strong> s1.equalsIgnoreCase(s2);
-<a class="jxr_linenumber" name="L289" href="#L289">289</a> }
-<a class="jxr_linenumber" name="L290" href="#L290">290</a>
-<a class="jxr_linenumber" name="L291" href="#L291">291</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L292" href="#L292">292</a> <em class="jxr_javadoccomment"> * Returns the first non-null value in the specified array</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> <em class="jxr_javadoccomment"> * @param <T> The value types.</em>
-<a class="jxr_linenumber" name="L295" href="#L295">295</a> <em class="jxr_javadoccomment"> * @param t The values to check.</em>
-<a class="jxr_linenumber" name="L296" href="#L296">296</a> <em class="jxr_javadoccomment"> * @return The first non-null value, or <jk>null</jk> if the array is null or empty or contains only <jk>null</jk> values.</em>
-<a class="jxr_linenumber" name="L297" href="#L297">297</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L298" href="#L298">298</a> @SafeVarargs
-<a class="jxr_linenumber" name="L299" href="#L299">299</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> T firstNonNull(T...t) {
-<a class="jxr_linenumber" name="L300" href="#L300">300</a> <strong class="jxr_keyword">if</strong> (nn(t))
-<a class="jxr_linenumber" name="L301" href="#L301">301</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> tt : t)
-<a class="jxr_linenumber" name="L302" href="#L302">302</a> <strong class="jxr_keyword">if</strong> (nn(tt))
-<a class="jxr_linenumber" name="L303" href="#L303">303</a> <strong class="jxr_keyword">return</strong> tt;
-<a class="jxr_linenumber" name="L304" href="#L304">304</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L305" href="#L305">305</a> }
-<a class="jxr_linenumber" name="L306" href="#L306">306</a>
-<a class="jxr_linenumber" name="L307" href="#L307">307</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L308" href="#L308">308</a> <em class="jxr_javadoccomment"> * Converts a string containing glob-style wildcard characters to a regular expression {@link java.util.regex.Pattern}.</em>
-<a class="jxr_linenumber" name="L309" href="#L309">309</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L310" href="#L310">310</a> <em class="jxr_javadoccomment"> * <p>This method converts glob-style patterns to regular expressions with the following mappings:</em>
-<a class="jxr_linenumber" name="L311" href="#L311">311</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L312" href="#L312">312</a> <em class="jxr_javadoccomment"> * <li>{@code *} matches any sequence of characters (including none)</li></em>
-<a class="jxr_linenumber" name="L313" href="#L313">313</a> <em class="jxr_javadoccomment"> * <li>{@code ?} matches exactly one character</li></em>
-<a class="jxr_linenumber" name="L314" href="#L314">314</a> <em class="jxr_javadoccomment"> * <li>All other characters are treated literally</li></em>
-<a class="jxr_linenumber" name="L315" href="#L315">315</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L316" href="#L316">316</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L317" href="#L317">317</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L318" href="#L318">318</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L319" href="#L319">319</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>pattern</jv> = <jsm>getGlobMatchPattern</jsm>(<js>"user_*_temp"</js>);</em>
-<a class="jxr_linenumber" name="L320" href="#L320">320</a> <em class="jxr_javadoccomment"> * <jk>boolean</jk> <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_alice_temp"</js>).matches(); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L321" href="#L321">321</a> <em class="jxr_javadoccomment"> * <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_bob_temp"</js>).matches(); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L322" href="#L322">322</a> <em class="jxr_javadoccomment"> * <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"admin_alice_temp"</js>).matches(); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L323" href="#L323">323</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L324" href="#L324">324</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L325" href="#L325">325</a> <em class="jxr_javadoccomment"> * @param s The glob-style wildcard pattern string.</em>
-<a class="jxr_linenumber" name="L326" href="#L326">326</a> <em class="jxr_javadoccomment"> * @return A compiled {@link java.util.regex.Pattern} object, or <jk>null</jk> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L223" href="#L223">223</a> <em class="jxr_javadoccomment"> * Allows you to simplify object comparison without sacrificing efficiency.</em>
+<a class="jxr_linenumber" name="L224" href="#L224">224</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L225" href="#L225">225</a> <em class="jxr_javadoccomment"> * Example:</em>
+<a class="jxr_linenumber" name="L226" href="#L226">226</a> <em class="jxr_javadoccomment"> * <code></em>
+<a class="jxr_linenumber" name="L227" href="#L227">227</a> <em class="jxr_javadoccomment"> * public boolean equals(Object o)</em>
+<a class="jxr_linenumber" name="L228" href="#L228">228</a> <em class="jxr_javadoccomment"> * return eq(this, (Role)o, (x,y)-&gt;eq(x.id,y.id) &amp;&amp; eq(x.name,y.name) &amp;&amp; eq(x.created,y.created) &amp;&amp; eq(x.createdBy,y.createdBy));</em>
+<a class="jxr_linenumber" name="L229" href="#L229">229</a> <em class="jxr_javadoccomment"> * }</em>
+<a class="jxr_linenumber" name="L230" href="#L230">230</a> <em class="jxr_javadoccomment"> * </code></em>
+<a class="jxr_linenumber" name="L231" href="#L231">231</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L232" href="#L232">232</a> <em class="jxr_javadoccomment"> * @param <T> Object 1 type.</em>
+<a class="jxr_linenumber" name="L233" href="#L233">233</a> <em class="jxr_javadoccomment"> * @param <U> Object 2 type.</em>
+<a class="jxr_linenumber" name="L234" href="#L234">234</a> <em class="jxr_javadoccomment"> * @param o1 Object 1.</em>
+<a class="jxr_linenumber" name="L235" href="#L235">235</a> <em class="jxr_javadoccomment"> * @param o2 Object 2.</em>
+<a class="jxr_linenumber" name="L236" href="#L236">236</a> <em class="jxr_javadoccomment"> * @param test The test to use for equality.</em>
+<a class="jxr_linenumber" name="L237" href="#L237">237</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if both objects are equal based on the test.</em>
+<a class="jxr_linenumber" name="L238" href="#L238">238</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L239" href="#L239">239</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T,U> <strong class="jxr_keyword">boolean</strong> eq(T o1, U o2, BiPredicate<T,U> test) {
+<a class="jxr_linenumber" name="L240" href="#L240">240</a> <strong class="jxr_keyword">if</strong> (o1 == <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="L241" href="#L241">241</a> <strong class="jxr_keyword">return</strong> o2 == <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L242" href="#L242">242</a> }
+<a class="jxr_linenumber" name="L243" href="#L243">243</a> <strong class="jxr_keyword">if</strong> (o2 == <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="L244" href="#L244">244</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L245" href="#L245">245</a> }
+<a class="jxr_linenumber" name="L246" href="#L246">246</a> <strong class="jxr_keyword">if</strong> (o1 == o2) {
+<a class="jxr_linenumber" name="L247" href="#L247">247</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L248" href="#L248">248</a> }
+<a class="jxr_linenumber" name="L249" href="#L249">249</a> <strong class="jxr_keyword">return</strong> test.test(o1, o2);
+<a class="jxr_linenumber" name="L250" href="#L250">250</a> }
+<a class="jxr_linenumber" name="L251" href="#L251">251</a>
+<a class="jxr_linenumber" name="L252" href="#L252">252</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L253" href="#L253">253</a> <em class="jxr_javadoccomment"> * Tests two strings for case-insensitive equality, but gracefully handles nulls.</em>
+<a class="jxr_linenumber" name="L254" href="#L254">254</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L255" href="#L255">255</a> <em class="jxr_javadoccomment"> * @param s1 String 1.</em>
+<a class="jxr_linenumber" name="L256" href="#L256">256</a> <em class="jxr_javadoccomment"> * @param s2 String 2.</em>
+<a class="jxr_linenumber" name="L257" href="#L257">257</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the strings are equal.</em>
+<a class="jxr_linenumber" name="L258" href="#L258">258</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L259" href="#L259">259</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> eqic(String s1, String s2) {
+<a class="jxr_linenumber" name="L260" href="#L260">260</a> <strong class="jxr_keyword">if</strong> (s1 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L261" href="#L261">261</a> <strong class="jxr_keyword">return</strong> s2 == <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L262" href="#L262">262</a> <strong class="jxr_keyword">if</strong> (s2 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L263" href="#L263">263</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L264" href="#L264">264</a> <strong class="jxr_keyword">return</strong> s1.equalsIgnoreCase(s2);
+<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> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L268" href="#L268">268</a> <em class="jxr_javadoccomment"> * Returns the first non-null value in the specified array</em>
+<a class="jxr_linenumber" name="L269" href="#L269">269</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L270" href="#L270">270</a> <em class="jxr_javadoccomment"> * @param <T> The value types.</em>
+<a class="jxr_linenumber" name="L271" href="#L271">271</a> <em class="jxr_javadoccomment"> * @param t The values to check.</em>
+<a class="jxr_linenumber" name="L272" href="#L272">272</a> <em class="jxr_javadoccomment"> * @return The first non-null value, or <jk>null</jk> if the array is null or empty or contains only <jk>null</jk> values.</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> @SafeVarargs
+<a class="jxr_linenumber" name="L275" href="#L275">275</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> T firstNonNull(T...t) {
+<a class="jxr_linenumber" name="L276" href="#L276">276</a> <strong class="jxr_keyword">if</strong> (nn(t))
+<a class="jxr_linenumber" name="L277" href="#L277">277</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> tt : t)
+<a class="jxr_linenumber" name="L278" href="#L278">278</a> <strong class="jxr_keyword">if</strong> (nn(tt))
+<a class="jxr_linenumber" name="L279" href="#L279">279</a> <strong class="jxr_keyword">return</strong> tt;
+<a class="jxr_linenumber" name="L280" href="#L280">280</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L281" href="#L281">281</a> }
+<a class="jxr_linenumber" name="L282" href="#L282">282</a>
+<a class="jxr_linenumber" name="L283" href="#L283">283</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L284" href="#L284">284</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link StringUtils#format(String, Object...)}.</em>
+<a class="jxr_linenumber" name="L285" href="#L285">285</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L286" href="#L286">286</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L287" href="#L287">287</a> <em class="jxr_javadoccomment"> * This method provides a convenient shorthand for string formatting that supports both</em>
+<a class="jxr_linenumber" name="L288" href="#L288">288</a> <em class="jxr_javadoccomment"> * MessageFormat-style and printf-style formatting in the same pattern.</em>
+<a class="jxr_linenumber" name="L289" href="#L289">289</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L290" href="#L290">290</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Format Support:</h5></em>
+<a class="jxr_linenumber" name="L291" href="#L291">291</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L292" href="#L292">292</a> <em class="jxr_javadoccomment"> * <li><b>Printf-style:</b> <js>"%s"</js>, <js>"%d"</js>, <js>"%.2f"</js>, <js>"%1$s"</js>, etc.</li></em>
+<a class="jxr_linenumber" name="L293" href="#L293">293</a> <em class="jxr_javadoccomment"> * <li><b>MessageFormat-style:</b> <js>"{0}"</js>, <js>"{1,number}"</js>, <js>"{2,date}"</js>, etc.</li></em>
+<a class="jxr_linenumber" name="L294" href="#L294">294</a> <em class="jxr_javadoccomment"> * <li><b>Un-numbered MessageFormat:</b> <js>"{}"</js> - Sequential placeholders that are automatically numbered</li></em>
+<a class="jxr_linenumber" name="L295" href="#L295">295</a> <em class="jxr_javadoccomment"> * <li><b>Mixed formats:</b> Both styles can be used in the same pattern</li></em>
+<a class="jxr_linenumber" name="L296" href="#L296">296</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L297" href="#L297">297</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L298" href="#L298">298</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L299" href="#L299">299</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L300" href="#L300">300</a> <em class="jxr_javadoccomment"> * <jc>// Printf-style formatting</jc></em>
+<a class="jxr_linenumber" name="L301" href="#L301">301</a> <em class="jxr_javadoccomment"> * f(<js>"Hello %s, you have %d items"</js>, <js>"John"</js>, 5);</em>
+<a class="jxr_linenumber" name="L302" href="#L302">302</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
+<a class="jxr_linenumber" name="L303" href="#L303">303</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L304" href="#L304">304</a> <em class="jxr_javadoccomment"> * <jc>// Floating point</jc></em>
+<a class="jxr_linenumber" name="L305" href="#L305">305</a> <em class="jxr_javadoccomment"> * f(<js>"Price: $%.2f"</js>, 19.99);</em>
+<a class="jxr_linenumber" name="L306" href="#L306">306</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Price: $19.99"</jc></em>
+<a class="jxr_linenumber" name="L307" href="#L307">307</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L308" href="#L308">308</a> <em class="jxr_javadoccomment"> * <jc>// MessageFormat-style formatting</jc></em>
+<a class="jxr_linenumber" name="L309" href="#L309">309</a> <em class="jxr_javadoccomment"> * f(<js>"Hello {0}, you have {1} items"</js>, <js>"John"</js>, 5);</em>
+<a class="jxr_linenumber" name="L310" href="#L310">310</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
+<a class="jxr_linenumber" name="L311" href="#L311">311</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L312" href="#L312">312</a> <em class="jxr_javadoccomment"> * <jc>// Un-numbered MessageFormat placeholders (sequential)</jc></em>
+<a class="jxr_linenumber" name="L313" href="#L313">313</a> <em class="jxr_javadoccomment"> * f(<js>"Hello {}, you have {} items"</js>, <js>"John"</js>, 5);</em>
+<a class="jxr_linenumber" name="L314" href="#L314">314</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
+<a class="jxr_linenumber" name="L315" href="#L315">315</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L316" href="#L316">316</a> <em class="jxr_javadoccomment"> * <jc>// Mixed format styles in the same pattern</jc></em>
+<a class="jxr_linenumber" name="L317" href="#L317">317</a> <em class="jxr_javadoccomment"> * f(<js>"User {0} has %d items and %s status"</js>, <js>"Alice"</js>, 10, <js>"active"</js>);</em>
+<a class="jxr_linenumber" name="L318" href="#L318">318</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "User Alice has 10 items and active status"</jc></em>
+<a class="jxr_linenumber" name="L319" href="#L319">319</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L320" href="#L320">320</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L321" href="#L321">321</a> <em class="jxr_javadoccomment"> * @param pattern The format string supporting both MessageFormat and printf-style placeholders.</em>
+<a class="jxr_linenumber" name="L322" href="#L322">322</a> <em class="jxr_javadoccomment"> * @param args The arguments to format.</em>
+<a class="jxr_linenumber" name="L323" href="#L323">323</a> <em class="jxr_javadoccomment"> * @return The formatted string.</em>
+<a class="jxr_linenumber" name="L324" href="#L324">324</a> <em class="jxr_javadoccomment"> * @see StringUtils#format(String, Object...)</em>
+<a class="jxr_linenumber" name="L325" href="#L325">325</a> <em class="jxr_javadoccomment"> * @see StringFormat for detailed format specification</em>
+<a class="jxr_linenumber" name="L326" href="#L326">326</a> <em class="jxr_javadoccomment"> * @see #mf(String, Object...) for MessageFormat-only formatting</em>
<a class="jxr_linenumber" name="L327" href="#L327">327</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L328" href="#L328">328</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> java.util.regex.Pattern getGlobMatchPattern(String s) {
-<a class="jxr_linenumber" name="L329" href="#L329">329</a> <strong class="jxr_keyword">return</strong> getGlobMatchPattern(s, 0);
+<a class="jxr_linenumber" name="L328" href="#L328">328</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String f(String pattern, Object...args) {
+<a class="jxr_linenumber" name="L329" href="#L329">329</a> <strong class="jxr_keyword">return</strong> format(pattern, args);
<a class="jxr_linenumber" name="L330" href="#L330">330</a> }
<a class="jxr_linenumber" name="L331" href="#L331">331</a>
<a class="jxr_linenumber" name="L332" href="#L332">332</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L333" href="#L333">333</a> <em class="jxr_javadoccomment"> * Converts a string containing glob-style wildcard characters to a regular expression {@link java.util.regex.Pattern} with flags.</em>
+<a class="jxr_linenumber" name="L333" href="#L333">333</a> <em class="jxr_javadoccomment"> * Creates a formatted string supplier with format arguments for lazy evaluation.</em>
<a class="jxr_linenumber" name="L334" href="#L334">334</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L335" href="#L335">335</a> <em class="jxr_javadoccomment"> * <p>This method converts glob-style patterns to regular expressions with the following mappings:</em>
-<a class="jxr_linenumber" name="L336" href="#L336">336</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L337" href="#L337">337</a> <em class="jxr_javadoccomment"> * <li>{@code *} matches any sequence of characters (including none)</li></em>
-<a class="jxr_linenumber" name="L338" href="#L338">338</a> <em class="jxr_javadoccomment"> * <li>{@code ?} matches exactly one character</li></em>
-<a class="jxr_linenumber" name="L339" href="#L339">339</a> <em class="jxr_javadoccomment"> * <li>All other characters are treated literally</li></em>
-<a class="jxr_linenumber" name="L340" href="#L340">340</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L341" href="#L341">341</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L342" href="#L342">342</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L343" href="#L343">343</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L344" href="#L344">344</a> <em class="jxr_javadoccomment"> * <jc>// Case-insensitive matching</jc></em>
-<a class="jxr_linenumber" name="L345" href="#L345">345</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>pattern</jv> = <jsm>getGlobMatchPattern</jsm>(<js>"USER_*"</js>, Pattern.<jsf>CASE_INSENSITIVE</jsf>);</em>
-<a class="jxr_linenumber" name="L346" href="#L346">346</a> <em class="jxr_javadoccomment"> * <jk>boolean</jk> <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_alice"</js>).matches(); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L347" href="#L347">347</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L348" href="#L348">348</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L349" href="#L349">349</a> <em class="jxr_javadoccomment"> * @param s The glob-style wildcard pattern string.</em>
-<a class="jxr_linenumber" name="L350" href="#L350">350</a> <em class="jxr_javadoccomment"> * @param flags Regular expression flags (see {@link java.util.regex.Pattern} constants).</em>
-<a class="jxr_linenumber" name="L351" href="#L351">351</a> <em class="jxr_javadoccomment"> * @return A compiled {@link java.util.regex.Pattern} object, or <jk>null</jk> if the input string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L352" href="#L352">352</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L353" href="#L353">353</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> java.util.regex.Pattern getGlobMatchPattern(String s, <strong class="jxr_keyword">int</strong> flags) {
-<a class="jxr_linenumber" name="L354" href="#L354">354</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L355" href="#L355">355</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L356" href="#L356">356</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L357" href="#L357">357</a> sb.append(<span class="jxr_string">"\\Q"</span>);
-<a class="jxr_linenumber" name="L358" href="#L358">358</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L359" href="#L359">359</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L360" href="#L360">360</a> <strong class="jxr_keyword">if</strong> (c == '*')
-<a class="jxr_linenumber" name="L361" href="#L361">361</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">".*"</span>).append(<span class="jxr_string">"\\Q"</span>);
-<a class="jxr_linenumber" name="L362" href="#L362">362</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '?')
-<a class="jxr_linenumber" name="L363" href="#L363">363</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">"."</span>).append(<span class="jxr_string">"\\Q"</span>);
-<a class="jxr_linenumber" name="L364" href="#L364">364</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L365" href="#L365">365</a> sb.append(c);
-<a class="jxr_linenumber" name="L366" href="#L366">366</a> }
-<a class="jxr_linenumber" name="L367" href="#L367">367</a> sb.append(<span class="jxr_string">"\\E"</span>);
-<a class="jxr_linenumber" name="L368" href="#L368">368</a> <strong class="jxr_keyword">return</strong> java.util.regex.Pattern.compile(sb.toString(), flags);
-<a class="jxr_linenumber" name="L369" href="#L369">369</a> }
-<a class="jxr_linenumber" name="L370" href="#L370">370</a>
-<a class="jxr_linenumber" name="L371" href="#L371">371</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L372" href="#L372">372</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link StringUtils#format(String, Object...)}.</em>
-<a class="jxr_linenumber" name="L373" href="#L373">373</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L374" href="#L374">374</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L375" href="#L375">375</a> <em class="jxr_javadoccomment"> * This method provides a convenient shorthand for string formatting that supports both</em>
-<a class="jxr_linenumber" name="L376" href="#L376">376</a> <em class="jxr_javadoccomment"> * MessageFormat-style and printf-style formatting in the same pattern.</em>
-<a class="jxr_linenumber" name="L377" href="#L377">377</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L378" href="#L378">378</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Format Support:</h5></em>
-<a class="jxr_linenumber" name="L379" href="#L379">379</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L380" href="#L380">380</a> <em class="jxr_javadoccomment"> * <li><b>Printf-style:</b> <js>"%s"</js>, <js>"%d"</js>, <js>"%.2f"</js>, <js>"%1$s"</js>, etc.</li></em>
-<a class="jxr_linenumber" name="L381" href="#L381">381</a> <em class="jxr_javadoccomment"> * <li><b>MessageFormat-style:</b> <js>"{0}"</js>, <js>"{1,number}"</js>, <js>"{2,date}"</js>, etc.</li></em>
-<a class="jxr_linenumber" name="L382" href="#L382">382</a> <em class="jxr_javadoccomment"> * <li><b>Un-numbered MessageFormat:</b> <js>"{}"</js> - Sequential placeholders that are automatically numbered</li></em>
-<a class="jxr_linenumber" name="L383" href="#L383">383</a> <em class="jxr_javadoccomment"> * <li><b>Mixed formats:</b> Both styles can be used in the same pattern</li></em>
-<a class="jxr_linenumber" name="L384" href="#L384">384</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L385" href="#L385">385</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L386" href="#L386">386</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L387" href="#L387">387</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L388" href="#L388">388</a> <em class="jxr_javadoccomment"> * <jc>// Printf-style formatting</jc></em>
-<a class="jxr_linenumber" name="L389" href="#L389">389</a> <em class="jxr_javadoccomment"> * f(<js>"Hello %s, you have %d items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L390" href="#L390">390</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
-<a class="jxr_linenumber" name="L391" href="#L391">391</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L392" href="#L392">392</a> <em class="jxr_javadoccomment"> * <jc>// Floating point</jc></em>
-<a class="jxr_linenumber" name="L393" href="#L393">393</a> <em class="jxr_javadoccomment"> * f(<js>"Price: $%.2f"</js>, 19.99);</em>
-<a class="jxr_linenumber" name="L394" href="#L394">394</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Price: $19.99"</jc></em>
+<a class="jxr_linenumber" name="L335" href="#L335">335</a> <em class="jxr_javadoccomment"> * <p>This method returns a {@link Supplier} that formats the string pattern with the provided arguments</em>
+<a class="jxr_linenumber" name="L336" href="#L336">336</a> <em class="jxr_javadoccomment"> * only when the supplier's {@code get()} method is called. This is useful for expensive string formatting</em>
+<a class="jxr_linenumber" name="L337" href="#L337">337</a> <em class="jxr_javadoccomment"> * operations that may not always be needed, such as error messages in assertions.</p></em>
+<a class="jxr_linenumber" name="L338" href="#L338">338</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L339" href="#L339">339</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L340" href="#L340">340</a> <em class="jxr_javadoccomment"> * Supports both MessageFormat-style and printf-style formatting in the same pattern.</em>
+<a class="jxr_linenumber" name="L341" href="#L341">341</a> <em class="jxr_javadoccomment"> * Also supports un-numbered MessageFormat placeholders: <js>"{}"</js> - Sequential placeholders that are automatically numbered.</em>
+<a class="jxr_linenumber" name="L342" href="#L342">342</a> <em class="jxr_javadoccomment"> * See {@link #f(String, Object...)} for format specification details.</em>
+<a class="jxr_linenumber" name="L343" href="#L343">343</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L344" href="#L344">344</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L345" href="#L345">345</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Usage Examples:</h5></em>
+<a class="jxr_linenumber" name="L346" href="#L346">346</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L347" href="#L347">347</a> <em class="jxr_javadoccomment"> * <jc>// Lazy evaluation - string is only formatted if assertion fails</jc></em>
+<a class="jxr_linenumber" name="L348" href="#L348">348</a> <em class="jxr_javadoccomment"> * assertTrue(condition, fs(<js>"Expected %s but got %s"</js>, expected, actual));</em>
+<a class="jxr_linenumber" name="L349" href="#L349">349</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L350" href="#L350">350</a> <em class="jxr_javadoccomment"> * <jc>// Can be used anywhere a Supplier&lt;String&gt; is expected</jc></em>
+<a class="jxr_linenumber" name="L351" href="#L351">351</a> <em class="jxr_javadoccomment"> * Supplier&lt;String&gt; <jv>messageSupplier</jv> = fs(<js>"Processing item %d of %d"</js>, i, total);</em>
+<a class="jxr_linenumber" name="L352" href="#L352">352</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L353" href="#L353">353</a> <em class="jxr_javadoccomment"> * <jc>// Mixed format styles</jc></em>
+<a class="jxr_linenumber" name="L354" href="#L354">354</a> <em class="jxr_javadoccomment"> * Supplier&lt;String&gt; <jv>msg</jv> = fs(<js>"User {0} has %d items"</js>, <js>"Alice"</js>, 10);</em>
+<a class="jxr_linenumber" name="L355" href="#L355">355</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L356" href="#L356">356</a> <em class="jxr_javadoccomment"> * <jc>// Un-numbered MessageFormat placeholders</jc></em>
+<a class="jxr_linenumber" name="L357" href="#L357">357</a> <em class="jxr_javadoccomment"> * Supplier&lt;String&gt; <jv>msg2</jv> = fs(<js>"Hello {}, you have {} items"</js>, <js>"John"</js>, 5);</em>
+<a class="jxr_linenumber" name="L358" href="#L358">358</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L359" href="#L359">359</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L360" href="#L360">360</a> <em class="jxr_javadoccomment"> * @param pattern The format string supporting both MessageFormat and printf-style placeholders</em>
+<a class="jxr_linenumber" name="L361" href="#L361">361</a> <em class="jxr_javadoccomment"> * (e.g., <js>"{0}"</js>, <js>"%s"</js>, <js>"%d"</js>, etc.).</em>
+<a class="jxr_linenumber" name="L362" href="#L362">362</a> <em class="jxr_javadoccomment"> * @param args The arguments to substitute into the pattern placeholders.</em>
+<a class="jxr_linenumber" name="L363" href="#L363">363</a> <em class="jxr_javadoccomment"> * @return A {@link Supplier} that will format the string when {@code get()} is called.</em>
+<a class="jxr_linenumber" name="L364" href="#L364">364</a> <em class="jxr_javadoccomment"> * @see StringUtils#format(String, Object...)</em>
+<a class="jxr_linenumber" name="L365" href="#L365">365</a> <em class="jxr_javadoccomment"> * @see #f(String, Object...) for format specification details</em>
+<a class="jxr_linenumber" name="L366" href="#L366">366</a> <em class="jxr_javadoccomment"> * @see #mfs(String, Object...) for MessageFormat-only formatting</em>
+<a class="jxr_linenumber" name="L367" href="#L367">367</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L368" href="#L368">368</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Supplier<String> fs(String pattern, Object...args) {
+<a class="jxr_linenumber" name="L369" href="#L369">369</a> <strong class="jxr_keyword">return</strong> () -> format(pattern, args);
+<a class="jxr_linenumber" name="L370" href="#L370">370</a> }
+<a class="jxr_linenumber" name="L371" href="#L371">371</a>
+<a class="jxr_linenumber" name="L372" href="#L372">372</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L373" href="#L373">373</a> <em class="jxr_javadoccomment"> * Calculates a hash code for the specified values.</em>
+<a class="jxr_linenumber" name="L374" href="#L374">374</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L375" href="#L375">375</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L376" href="#L376">376</a> <em class="jxr_javadoccomment"> * This method handles annotations specially by delegating to {@link AnnotationUtils#hash(Annotation)}</em>
+<a class="jxr_linenumber" name="L377" href="#L377">377</a> <em class="jxr_javadoccomment"> * to ensure consistent hashing according to the {@link java.lang.annotation.Annotation#hashCode()} contract.</em>
+<a class="jxr_linenumber" name="L378" href="#L378">378</a> <em class="jxr_javadoccomment"> * For non-annotation values, it uses {@link Objects#hashCode(Object)}.</em>
+<a class="jxr_linenumber" name="L379" href="#L379">379</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L380" href="#L380">380</a> <em class="jxr_javadoccomment"> * @param values The values to hash.</em>
+<a class="jxr_linenumber" name="L381" href="#L381">381</a> <em class="jxr_javadoccomment"> * @return A hash code value for the given values.</em>
+<a class="jxr_linenumber" name="L382" href="#L382">382</a> <em class="jxr_javadoccomment"> * @see AnnotationUtils#hash(Annotation)</em>
+<a class="jxr_linenumber" name="L383" href="#L383">383</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L384" href="#L384">384</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> hash(Object...values) {
+<a class="jxr_linenumber" name="L385" href="#L385">385</a> assertArgNotNull(<span class="jxr_string">"values"</span>, values);
+<a class="jxr_linenumber" name="L386" href="#L386">386</a> <strong class="jxr_keyword">var</strong> result = 1;
+<a class="jxr_linenumber" name="L387" href="#L387">387</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> value : values) {
+<a class="jxr_linenumber" name="L388" href="#L388">388</a> result = 31 * result + (value instanceof java.lang.annotation.Annotation ? AnnotationUtils.hash((java.lang.annotation.Annotation)value) : Objects.hashCode(value));
+<a class="jxr_linenumber" name="L389" href="#L389">389</a> }
+<a class="jxr_linenumber" name="L390" href="#L390">390</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L391" href="#L391">391</a> }
+<a class="jxr_linenumber" name="L392" href="#L392">392</a>
+<a class="jxr_linenumber" name="L393" href="#L393">393</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L394" href="#L394">394</a> <em class="jxr_javadoccomment"> * Checks if the specified object is an array.</em>
<a class="jxr_linenumber" name="L395" href="#L395">395</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L396" href="#L396">396</a> <em class="jxr_javadoccomment"> * <jc>// MessageFormat-style formatting</jc></em>
-<a class="jxr_linenumber" name="L397" href="#L397">397</a> <em class="jxr_javadoccomment"> * f(<js>"Hello {0}, you have {1} items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L398" href="#L398">398</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
-<a class="jxr_linenumber" name="L399" href="#L399">399</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L400" href="#L400">400</a> <em class="jxr_javadoccomment"> * <jc>// Un-numbered MessageFormat placeholders (sequential)</jc></em>
-<a class="jxr_linenumber" name="L401" href="#L401">401</a> <em class="jxr_javadoccomment"> * f(<js>"Hello {}, you have {} items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L402" href="#L402">402</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
-<a class="jxr_linenumber" name="L403" href="#L403">403</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L404" href="#L404">404</a> <em class="jxr_javadoccomment"> * <jc>// Mixed format styles in the same pattern</jc></em>
-<a class="jxr_linenumber" name="L405" href="#L405">405</a> <em class="jxr_javadoccomment"> * f(<js>"User {0} has %d items and %s status"</js>, <js>"Alice"</js>, 10, <js>"active"</js>);</em>
-<a class="jxr_linenumber" name="L406" href="#L406">406</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "User Alice has 10 items and active status"</jc></em>
-<a class="jxr_linenumber" name="L407" href="#L407">407</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L408" href="#L408">408</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L409" href="#L409">409</a> <em class="jxr_javadoccomment"> * @param pattern The format string supporting both MessageFormat and printf-style placeholders.</em>
-<a class="jxr_linenumber" name="L410" href="#L410">410</a> <em class="jxr_javadoccomment"> * @param args The arguments to format.</em>
-<a class="jxr_linenumber" name="L411" href="#L411">411</a> <em class="jxr_javadoccomment"> * @return The formatted string.</em>
-<a class="jxr_linenumber" name="L412" href="#L412">412</a> <em class="jxr_javadoccomment"> * @see StringUtils#format(String, Object...)</em>
-<a class="jxr_linenumber" name="L413" href="#L413">413</a> <em class="jxr_javadoccomment"> * @see StringFormat for detailed format specification</em>
-<a class="jxr_linenumber" name="L414" href="#L414">414</a> <em class="jxr_javadoccomment"> * @see #mf(String, Object...) for MessageFormat-only formatting</em>
-<a class="jxr_linenumber" name="L415" href="#L415">415</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L416" href="#L416">416</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String f(String pattern, Object...args) {
-<a class="jxr_linenumber" name="L417" href="#L417">417</a> <strong class="jxr_keyword">return</strong> format(pattern, args);
-<a class="jxr_linenumber" name="L418" href="#L418">418</a> }
-<a class="jxr_linenumber" name="L419" href="#L419">419</a>
-<a class="jxr_linenumber" name="L420" href="#L420">420</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L421" href="#L421">421</a> <em class="jxr_javadoccomment"> * Creates a formatted string supplier with format arguments for lazy evaluation.</em>
-<a class="jxr_linenumber" name="L422" href="#L422">422</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L423" href="#L423">423</a> <em class="jxr_javadoccomment"> * <p>This method returns a {@link Supplier} that formats the string pattern with the provided arguments</em>
-<a class="jxr_linenumber" name="L424" href="#L424">424</a> <em class="jxr_javadoccomment"> * only when the supplier's {@code get()} method is called. This is useful for expensive string formatting</em>
-<a class="jxr_linenumber" name="L425" href="#L425">425</a> <em class="jxr_javadoccomment"> * operations that may not always be needed, such as error messages in assertions.</p></em>
-<a class="jxr_linenumber" name="L426" href="#L426">426</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L427" href="#L427">427</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L428" href="#L428">428</a> <em class="jxr_javadoccomment"> * Supports both MessageFormat-style and printf-style formatting in the same pattern.</em>
-<a class="jxr_linenumber" name="L429" href="#L429">429</a> <em class="jxr_javadoccomment"> * Also supports un-numbered MessageFormat placeholders: <js>"{}"</js> - Sequential placeholders that are automatically numbered.</em>
-<a class="jxr_linenumber" name="L430" href="#L430">430</a> <em class="jxr_javadoccomment"> * See {@link #f(String, Object...)} for format specification details.</em>
-<a class="jxr_linenumber" name="L431" href="#L431">431</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L432" href="#L432">432</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L433" href="#L433">433</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Usage Examples:</h5></em>
-<a class="jxr_linenumber" name="L434" href="#L434">434</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L435" href="#L435">435</a> <em class="jxr_javadoccomment"> * <jc>// Lazy evaluation - string is only formatted if assertion fails</jc></em>
-<a class="jxr_linenumber" name="L436" href="#L436">436</a> <em class="jxr_javadoccomment"> * assertTrue(condition, fs(<js>"Expected %s but got %s"</js>, expected, actual));</em>
-<a class="jxr_linenumber" name="L437" href="#L437">437</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L438" href="#L438">438</a> <em class="jxr_javadoccomment"> * <jc>// Can be used anywhere a Supplier&lt;String&gt; is expected</jc></em>
-<a class="jxr_linenumber" name="L439" href="#L439">439</a> <em class="jxr_javadoccomment"> * Supplier&lt;String&gt; <jv>messageSupplier</jv> = fs(<js>"Processing item %d of %d"</js>, i, total);</em>
-<a class="jxr_linenumber" name="L440" href="#L440">440</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L441" href="#L441">441</a> <em class="jxr_javadoccomment"> * <jc>// Mixed format styles</jc></em>
-<a class="jxr_linenumber" name="L442" href="#L442">442</a> <em class="jxr_javadoccomment"> * Supplier&lt;String&gt; <jv>msg</jv> = fs(<js>"User {0} has %d items"</js>, <js>"Alice"</js>, 10);</em>
-<a class="jxr_linenumber" name="L443" href="#L443">443</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L444" href="#L444">444</a> <em class="jxr_javadoccomment"> * <jc>// Un-numbered MessageFormat placeholders</jc></em>
-<a class="jxr_linenumber" name="L445" href="#L445">445</a> <em class="jxr_javadoccomment"> * Supplier&lt;String&gt; <jv>msg2</jv> = fs(<js>"Hello {}, you have {} items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L446" href="#L446">446</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L447" href="#L447">447</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L448" href="#L448">448</a> <em class="jxr_javadoccomment"> * @param pattern The format string supporting both MessageFormat and printf-style placeholders</em>
-<a class="jxr_linenumber" name="L449" href="#L449">449</a> <em class="jxr_javadoccomment"> * (e.g., <js>"{0}"</js>, <js>"%s"</js>, <js>"%d"</js>, etc.).</em>
-<a class="jxr_linenumber" name="L450" href="#L450">450</a> <em class="jxr_javadoccomment"> * @param args The arguments to substitute into the pattern placeholders.</em>
-<a class="jxr_linenumber" name="L451" href="#L451">451</a> <em class="jxr_javadoccomment"> * @return A {@link Supplier} that will format the string when {@code get()} is called.</em>
-<a class="jxr_linenumber" name="L452" href="#L452">452</a> <em class="jxr_javadoccomment"> * @see StringUtils#format(String, Object...)</em>
-<a class="jxr_linenumber" name="L453" href="#L453">453</a> <em class="jxr_javadoccomment"> * @see #f(String, Object...) for format specification details</em>
-<a class="jxr_linenumber" name="L454" href="#L454">454</a> <em class="jxr_javadoccomment"> * @see #mfs(String, Object...) for MessageFormat-only formatting</em>
-<a class="jxr_linenumber" name="L455" href="#L455">455</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L456" href="#L456">456</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Supplier<String> fs(String pattern, Object...args) {
-<a class="jxr_linenumber" name="L457" href="#L457">457</a> <strong class="jxr_keyword">return</strong> () -> format(pattern, args);
-<a class="jxr_linenumber" name="L458" href="#L458">458</a> }
-<a class="jxr_linenumber" name="L459" href="#L459">459</a>
-<a class="jxr_linenumber" name="L460" href="#L460">460</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L461" href="#L461">461</a> <em class="jxr_javadoccomment"> * Calculates a hash code for the specified values.</em>
-<a class="jxr_linenumber" name="L462" href="#L462">462</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L463" href="#L463">463</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L464" href="#L464">464</a> <em class="jxr_javadoccomment"> * This method handles annotations specially by delegating to {@link AnnotationUtils#hash(Annotation)}</em>
-<a class="jxr_linenumber" name="L465" href="#L465">465</a> <em class="jxr_javadoccomment"> * to ensure consistent hashing according to the {@link java.lang.annotation.Annotation#hashCode()} contract.</em>
-<a class="jxr_linenumber" name="L466" href="#L466">466</a> <em class="jxr_javadoccomment"> * For non-annotation values, it uses {@link Objects#hashCode(Object)}.</em>
-<a class="jxr_linenumber" name="L467" href="#L467">467</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L468" href="#L468">468</a> <em class="jxr_javadoccomment"> * @param values The values to hash.</em>
-<a class="jxr_linenumber" name="L469" href="#L469">469</a> <em class="jxr_javadoccomment"> * @return A hash code value for the given values.</em>
-<a class="jxr_linenumber" name="L470" href="#L470">470</a> <em class="jxr_javadoccomment"> * @see AnnotationUtils#hash(Annotation)</em>
-<a class="jxr_linenumber" name="L471" href="#L471">471</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L472" href="#L472">472</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> hash(Object...values) {
-<a class="jxr_linenumber" name="L473" href="#L473">473</a> assertArgNotNull(<span class="jxr_string">"values"</span>, values);
-<a class="jxr_linenumber" name="L474" href="#L474">474</a> <strong class="jxr_keyword">var</strong> result = 1;
-<a class="jxr_linenumber" name="L475" href="#L475">475</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> value : values) {
-<a class="jxr_linenumber" name="L476" href="#L476">476</a> result = 31 * result + (value instanceof java.lang.annotation.Annotation ? AnnotationUtils.hash((java.lang.annotation.Annotation)value) : Objects.hashCode(value));
-<a class="jxr_linenumber" name="L477" href="#L477">477</a> }
-<a class="jxr_linenumber" name="L478" href="#L478">478</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L479" href="#L479">479</a> }
-<a class="jxr_linenumber" name="L480" href="#L480">480</a>
-<a class="jxr_linenumber" name="L481" href="#L481">481</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L482" href="#L482">482</a> <em class="jxr_javadoccomment"> * Checks if the specified object is an array.</em>
-<a class="jxr_linenumber" name="L483" href="#L483">483</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L484" href="#L484">484</a> <em class="jxr_javadoccomment"> * @param o The object to check.</em>
-<a class="jxr_linenumber" name="L485" href="#L485">485</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the object is not <jk>null</jk> and is an array.</em>
-<a class="jxr_linenumber" name="L486" href="#L486">486</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L487" href="#L487">487</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isArray(Object o) {
-<a class="jxr_linenumber" name="L488" href="#L488">488</a> <strong class="jxr_keyword">return</strong> nn(o) && o.getClass().isArray();
-<a class="jxr_linenumber" name="L489" href="#L489">489</a> }
-<a class="jxr_linenumber" name="L490" href="#L490">490</a>
-<a class="jxr_linenumber" name="L491" href="#L491">491</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L492" href="#L492">492</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified object can be converted to a list.</em>
-<a class="jxr_linenumber" name="L493" href="#L493">493</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L494" href="#L494">494</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L495" href="#L495">495</a> <em class="jxr_javadoccomment"> * The following types are considered convertible:</em>
-<a class="jxr_linenumber" name="L496" href="#L496">496</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L497" href="#L497">497</a> <em class="jxr_javadoccomment"> * <li>Collections</em>
-<a class="jxr_linenumber" name="L498" href="#L498">498</a> <em class="jxr_javadoccomment"> * <li>Iterables</em>
-<a class="jxr_linenumber" name="L499" href="#L499">499</a> <em class="jxr_javadoccomment"> * <li>Iterators</em>
-<a class="jxr_linenumber" name="L500" href="#L500">500</a> <em class="jxr_javadoccomment"> * <li>Enumerations</em>
-<a class="jxr_linenumber" name="L501" href="#L501">501</a> <em class="jxr_javadoccomment"> * <li>Streams</em>
-<a class="jxr_linenumber" name="L502" href="#L502">502</a> <em class="jxr_javadoccomment"> * <li>Maps</em>
-<a class="jxr_linenumber" name="L503" href="#L503">503</a> <em class="jxr_javadoccomment"> * <li>Optional</em>
-<a class="jxr_linenumber" name="L504" href="#L504">504</a> <em class="jxr_javadoccomment"> * <li>Arrays</em>
-<a class="jxr_linenumber" name="L505" href="#L505">505</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L506" href="#L506">506</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L507" href="#L507">507</a> <em class="jxr_javadoccomment"> * @param o The object to check.</em>
-<a class="jxr_linenumber" name="L508" href="#L508">508</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the object can be converted to a list.</em>
-<a class="jxr_linenumber" name="L509" href="#L509">509</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L510" href="#L510">510</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isConvertibleToList(Object o) {
-<a class="jxr_linenumber" name="L511" href="#L511">511</a> <strong class="jxr_keyword">return</strong> nn(o) && (o instanceof Collection || o instanceof Iterable || o instanceof Iterator || o instanceof Enumeration || o instanceof Stream || o instanceof Map || o instanceof Optional
-<a class="jxr_linenumber" name="L512" href="#L512">512</a> || isArray(o));
-<a class="jxr_linenumber" name="L513" href="#L513">513</a> }
-<a class="jxr_linenumber" name="L514" href="#L514">514</a>
-<a class="jxr_linenumber" name="L515" href="#L515">515</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L516" href="#L516">516</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified object is empty.</em>
-<a class="jxr_linenumber" name="L517" href="#L517">517</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L518" href="#L518">518</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L519" href="#L519">519</a> <em class="jxr_javadoccomment"> * Return <jk>true</jk> if the value is any of the following:</em>
-<a class="jxr_linenumber" name="L520" href="#L520">520</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L521" href="#L521">521</a> <em class="jxr_javadoccomment"> * <li><jk>null</jk></em>
-<a class="jxr_linenumber" name="L522" href="#L522">522</a> <em class="jxr_javadoccomment"> * <li>An empty Collection</em>
-<a class="jxr_linenumber" name="L523" href="#L523">523</a> <em class="jxr_javadoccomment"> * <li>An empty Map</em>
-<a class="jxr_linenumber" name="L524" href="#L524">524</a> <em class="jxr_javadoccomment"> * <li>An empty array</em>
-<a class="jxr_linenumber" name="L525" href="#L525">525</a> <em class="jxr_javadoccomment"> * <li>An empty CharSequence</em>
-<a class="jxr_linenumber" name="L526" href="#L526">526</a> <em class="jxr_javadoccomment"> * <li>An empty String when serialized to a string using {@link Object#toString()}.</em>
-<a class="jxr_linenumber" name="L527" href="#L527">527</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L528" href="#L528">528</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L529" href="#L529">529</a> <em class="jxr_javadoccomment"> * @param o The object to test.</em>
-<a class="jxr_linenumber" name="L530" href="#L530">530</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified object is empty.</em>
-<a class="jxr_linenumber" name="L531" href="#L531">531</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L532" href="#L532">532</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(Object o) {
-<a class="jxr_linenumber" name="L533" href="#L533">533</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L534" href="#L534">534</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L535" href="#L535">535</a> <strong class="jxr_keyword">if</strong> (o instanceof Collection<?> o2)
-<a class="jxr_linenumber" name="L536" href="#L536">536</a> <strong class="jxr_keyword">return</strong> o2.isEmpty();
-<a class="jxr_linenumber" name="L537" href="#L537">537</a> <strong class="jxr_keyword">if</strong> (o instanceof Map<?,?> o2)
-<a class="jxr_linenumber" name="L538" href="#L538">538</a> <strong class="jxr_keyword">return</strong> o2.isEmpty();
-<a class="jxr_linenumber" name="L539" href="#L539">539</a> <strong class="jxr_keyword">if</strong> (isArray(o))
-<a class="jxr_linenumber" name="L540" href="#L540">540</a> <strong class="jxr_keyword">return</strong> (Array.getLength(o) == 0);
-<a class="jxr_linenumber" name="L541" href="#L541">541</a> <strong class="jxr_keyword">return</strong> o.toString().isEmpty();
-<a class="jxr_linenumber" name="L542" href="#L542">542</a> }
-<a class="jxr_linenumber" name="L543" href="#L543">543</a>
-<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"> * Returns <jk>true</jk> if the specified collection is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L546" href="#L546">546</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L547" href="#L547">547</a> <em class="jxr_javadoccomment"> * @param o The collection to check.</em>
-<a class="jxr_linenumber" name="L548" href="#L548">548</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified collection is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L549" href="#L549">549</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L550" href="#L550">550</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(Collection<?> o) {
-<a class="jxr_linenumber" name="L551" href="#L551">551</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L552" href="#L552">552</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L553" href="#L553">553</a> <strong class="jxr_keyword">return</strong> o.isEmpty();
-<a class="jxr_linenumber" name="L554" href="#L554">554</a> }
-<a class="jxr_linenumber" name="L555" href="#L555">555</a>
-<a class="jxr_linenumber" name="L556" href="#L556">556</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L557" href="#L557">557</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified map is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L558" href="#L558">558</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L559" href="#L559">559</a> <em class="jxr_javadoccomment"> * @param o The map to check.</em>
-<a class="jxr_linenumber" name="L560" href="#L560">560</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified map is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L561" href="#L561">561</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L562" href="#L562">562</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(Map<?,?> o) {
-<a class="jxr_linenumber" name="L563" href="#L563">563</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L564" href="#L564">564</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L565" href="#L565">565</a> <strong class="jxr_keyword">return</strong> o.isEmpty();
-<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="L568" href="#L568">568</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L569" href="#L569">569</a> <em class="jxr_javadoccomment"> * Checks if a string is empty (null or zero length).</em>
-<a class="jxr_linenumber" name="L570" href="#L570">570</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L571" href="#L571">571</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L572" href="#L572">572</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L573" href="#L573">573</a> <em class="jxr_javadoccomment"> * isEmpty(<jk>null</jk>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L574" href="#L574">574</a> <em class="jxr_javadoccomment"> * isEmpty(<js>""</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L575" href="#L575">575</a> <em class="jxr_javadoccomment"> * isEmpty(<js>" "</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L576" href="#L576">576</a> <em class="jxr_javadoccomment"> * isEmpty(<js>"hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L577" href="#L577">577</a> <em class="jxr_javadoccomment"> * </p></em>
-<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"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L580" href="#L580">580</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is null or has zero length.</em>
-<a class="jxr_linenumber" name="L581" href="#L581">581</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L582" href="#L582">582</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(CharSequence str) {
-<a class="jxr_linenumber" name="L583" href="#L583">583</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> || str.isEmpty();
-<a class="jxr_linenumber" name="L584" href="#L584">584</a> }
-<a class="jxr_linenumber" name="L585" href="#L585">585</a>
-<a class="jxr_linenumber" name="L586" href="#L586">586</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L587" href="#L587">587</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified object is not <jk>null</jk> and not empty.</em>
-<a class="jxr_linenumber" name="L588" href="#L588">588</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L589" href="#L589">589</a> <em class="jxr_javadoccomment"> * Works on any of the following data types: String, CharSequence, Collection, Map, array.</em>
-<a class="jxr_linenumber" name="L590" href="#L590">590</a> <em class="jxr_javadoccomment"> * All other types are stringified and then checked as a String.</em>
-<a class="jxr_linenumber" name="L591" href="#L591">591</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L592" href="#L592">592</a> <em class="jxr_javadoccomment"> * @param value The value being checked.</em>
-<a class="jxr_linenumber" name="L593" href="#L593">593</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified object is not <jk>null</jk> and not empty.</em>
-<a class="jxr_linenumber" name="L594" href="#L594">594</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L595" href="#L595">595</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotEmpty(Object value) {
-<a class="jxr_linenumber" name="L596" href="#L596">596</a> <strong class="jxr_keyword">if</strong> (value == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L597" href="#L597">597</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L598" href="#L598">598</a> <strong class="jxr_keyword">if</strong> (value instanceof CharSequence value2)
-<a class="jxr_linenumber" name="L599" href="#L599">599</a> <strong class="jxr_keyword">return</strong> ! value2.isEmpty();
-<a class="jxr_linenumber" name="L600" href="#L600">600</a> <strong class="jxr_keyword">if</strong> (value instanceof Collection<?> value2)
-<a class="jxr_linenumber" name="L601" href="#L601">601</a> <strong class="jxr_keyword">return</strong> ! value2.isEmpty();
-<a class="jxr_linenumber" name="L602" href="#L602">602</a> <strong class="jxr_keyword">if</strong> (value instanceof Map<?,?> value2)
-<a class="jxr_linenumber" name="L603" href="#L603">603</a> <strong class="jxr_keyword">return</strong> ! value2.isEmpty();
-<a class="jxr_linenumber" name="L604" href="#L604">604</a> <strong class="jxr_keyword">if</strong> (isArray(value))
-<a class="jxr_linenumber" name="L605" href="#L605">605</a> <strong class="jxr_keyword">return</strong> Array.getLength(value) > 0;
-<a class="jxr_linenumber" name="L606" href="#L606">606</a> <strong class="jxr_keyword">return</strong> isNotEmpty(s(value));
-<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 <jk>true</jk> if the specified collection is not <jk>null</jk> and not empty.</em>
+<a class="jxr_linenumber" name="L396" href="#L396">396</a> <em class="jxr_javadoccomment"> * @param o The object to check.</em>
+<a class="jxr_linenumber" name="L397" href="#L397">397</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the object is not <jk>null</jk> and is an array.</em>
+<a class="jxr_linenumber" name="L398" href="#L398">398</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L399" href="#L399">399</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isArray(Object o) {
+<a class="jxr_linenumber" name="L400" href="#L400">400</a> <strong class="jxr_keyword">return</strong> nn(o) && o.getClass().isArray();
+<a class="jxr_linenumber" name="L401" href="#L401">401</a> }
+<a class="jxr_linenumber" name="L402" href="#L402">402</a>
+<a class="jxr_linenumber" name="L403" href="#L403">403</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L404" href="#L404">404</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified object is empty.</em>
+<a class="jxr_linenumber" name="L405" href="#L405">405</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L406" href="#L406">406</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L407" href="#L407">407</a> <em class="jxr_javadoccomment"> * Return <jk>true</jk> if the value is any of the following:</em>
+<a class="jxr_linenumber" name="L408" href="#L408">408</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L409" href="#L409">409</a> <em class="jxr_javadoccomment"> * <li><jk>null</jk></em>
+<a class="jxr_linenumber" name="L410" href="#L410">410</a> <em class="jxr_javadoccomment"> * <li>An empty Collection</em>
+<a class="jxr_linenumber" name="L411" href="#L411">411</a> <em class="jxr_javadoccomment"> * <li>An empty Map</em>
+<a class="jxr_linenumber" name="L412" href="#L412">412</a> <em class="jxr_javadoccomment"> * <li>An empty array</em>
+<a class="jxr_linenumber" name="L413" href="#L413">413</a> <em class="jxr_javadoccomment"> * <li>An empty CharSequence</em>
+<a class="jxr_linenumber" name="L414" href="#L414">414</a> <em class="jxr_javadoccomment"> * <li>An empty String when serialized to a string using {@link Object#toString()}.</em>
+<a class="jxr_linenumber" name="L415" href="#L415">415</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L416" href="#L416">416</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L417" href="#L417">417</a> <em class="jxr_javadoccomment"> * @param o The object to test.</em>
+<a class="jxr_linenumber" name="L418" href="#L418">418</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified object is empty.</em>
+<a class="jxr_linenumber" name="L419" href="#L419">419</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L420" href="#L420">420</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(Object o) {
+<a class="jxr_linenumber" name="L421" href="#L421">421</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L422" href="#L422">422</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L423" href="#L423">423</a> <strong class="jxr_keyword">if</strong> (o instanceof Collection<?> o2)
+<a class="jxr_linenumber" name="L424" href="#L424">424</a> <strong class="jxr_keyword">return</strong> o2.isEmpty();
+<a class="jxr_linenumber" name="L425" href="#L425">425</a> <strong class="jxr_keyword">if</strong> (o instanceof Map<?,?> o2)
+<a class="jxr_linenumber" name="L426" href="#L426">426</a> <strong class="jxr_keyword">return</strong> o2.isEmpty();
+<a class="jxr_linenumber" name="L427" href="#L427">427</a> <strong class="jxr_keyword">if</strong> (isArray(o))
+<a class="jxr_linenumber" name="L428" href="#L428">428</a> <strong class="jxr_keyword">return</strong> (Array.getLength(o) == 0);
+<a class="jxr_linenumber" name="L429" href="#L429">429</a> <strong class="jxr_keyword">return</strong> o.toString().isEmpty();
+<a class="jxr_linenumber" name="L430" href="#L430">430</a> }
+<a class="jxr_linenumber" name="L431" href="#L431">431</a>
+<a class="jxr_linenumber" name="L432" href="#L432">432</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L433" href="#L433">433</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified collection is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L434" href="#L434">434</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L435" href="#L435">435</a> <em class="jxr_javadoccomment"> * @param o The collection to check.</em>
+<a class="jxr_linenumber" name="L436" href="#L436">436</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified collection is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L437" href="#L437">437</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L438" href="#L438">438</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(Collection<?> o) {
+<a class="jxr_linenumber" name="L439" href="#L439">439</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L440" href="#L440">440</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L441" href="#L441">441</a> <strong class="jxr_keyword">return</strong> o.isEmpty();
+<a class="jxr_linenumber" name="L442" href="#L442">442</a> }
+<a class="jxr_linenumber" name="L443" href="#L443">443</a>
+<a class="jxr_linenumber" name="L444" href="#L444">444</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L445" href="#L445">445</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified map is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L446" href="#L446">446</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L447" href="#L447">447</a> <em class="jxr_javadoccomment"> * @param o The map to check.</em>
+<a class="jxr_linenumber" name="L448" href="#L448">448</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified map is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L449" href="#L449">449</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L450" href="#L450">450</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(Map<?,?> o) {
+<a class="jxr_linenumber" name="L451" href="#L451">451</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L452" href="#L452">452</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L453" href="#L453">453</a> <strong class="jxr_keyword">return</strong> o.isEmpty();
+<a class="jxr_linenumber" name="L454" href="#L454">454</a> }
+<a class="jxr_linenumber" name="L455" href="#L455">455</a>
+<a class="jxr_linenumber" name="L456" href="#L456">456</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L457" href="#L457">457</a> <em class="jxr_javadoccomment"> * Checks if a string is empty (null or zero length).</em>
+<a class="jxr_linenumber" name="L458" href="#L458">458</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L459" href="#L459">459</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L460" href="#L460">460</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L461" href="#L461">461</a> <em class="jxr_javadoccomment"> * isEmpty(<jk>null</jk>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L462" href="#L462">462</a> <em class="jxr_javadoccomment"> * isEmpty(<js>""</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L463" href="#L463">463</a> <em class="jxr_javadoccomment"> * isEmpty(<js>" "</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L464" href="#L464">464</a> <em class="jxr_javadoccomment"> * isEmpty(<js>"hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L465" href="#L465">465</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L466" href="#L466">466</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L467" href="#L467">467</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L468" href="#L468">468</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is null or has zero length.</em>
+<a class="jxr_linenumber" name="L469" href="#L469">469</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L470" href="#L470">470</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(CharSequence str) {
+<a class="jxr_linenumber" name="L471" href="#L471">471</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> || str.isEmpty();
+<a class="jxr_linenumber" name="L472" href="#L472">472</a> }
+<a class="jxr_linenumber" name="L473" href="#L473">473</a>
+<a class="jxr_linenumber" name="L474" href="#L474">474</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L475" href="#L475">475</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified object is not <jk>null</jk> and not empty.</em>
+<a class="jxr_linenumber" name="L476" href="#L476">476</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L477" href="#L477">477</a> <em class="jxr_javadoccomment"> * Works on any of the following data types: String, CharSequence, Collection, Map, array.</em>
+<a class="jxr_linenumber" name="L478" href="#L478">478</a> <em class="jxr_javadoccomment"> * All other types are stringified and then checked as a String.</em>
+<a class="jxr_linenumber" name="L479" href="#L479">479</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L480" href="#L480">480</a> <em class="jxr_javadoccomment"> * @param value The value being checked.</em>
+<a class="jxr_linenumber" name="L481" href="#L481">481</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified object is not <jk>null</jk> and not empty.</em>
+<a class="jxr_linenumber" name="L482" href="#L482">482</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L483" href="#L483">483</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotEmpty(Object value) {
+<a class="jxr_linenumber" name="L484" href="#L484">484</a> <strong class="jxr_keyword">if</strong> (value == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L485" href="#L485">485</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L486" href="#L486">486</a> <strong class="jxr_keyword">if</strong> (value instanceof CharSequence value2)
+<a class="jxr_linenumber" name="L487" href="#L487">487</a> <strong class="jxr_keyword">return</strong> ! value2.isEmpty();
+<a class="jxr_linenumber" name="L488" href="#L488">488</a> <strong class="jxr_keyword">if</strong> (value instanceof Collection<?> value2)
+<a class="jxr_linenumber" name="L489" href="#L489">489</a> <strong class="jxr_keyword">return</strong> ! value2.isEmpty();
+<a class="jxr_linenumber" name="L490" href="#L490">490</a> <strong class="jxr_keyword">if</strong> (value instanceof Map<?,?> value2)
+<a class="jxr_linenumber" name="L491" href="#L491">491</a> <strong class="jxr_keyword">return</strong> ! value2.isEmpty();
+<a class="jxr_linenumber" name="L492" href="#L492">492</a> <strong class="jxr_keyword">if</strong> (isArray(value))
+<a class="jxr_linenumber" name="L493" href="#L493">493</a> <strong class="jxr_keyword">return</strong> Array.getLength(value) > 0;
+<a class="jxr_linenumber" name="L494" href="#L494">494</a> <strong class="jxr_keyword">return</strong> isNotEmpty(s(value));
+<a class="jxr_linenumber" name="L495" href="#L495">495</a> }
+<a class="jxr_linenumber" name="L496" href="#L496">496</a>
+<a class="jxr_linenumber" name="L497" href="#L497">497</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L498" href="#L498">498</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified collection is not <jk>null</jk> and not empty.</em>
+<a class="jxr_linenumber" name="L499" href="#L499">499</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L500" href="#L500">500</a> <em class="jxr_javadoccomment"> * @param value The collection to check.</em>
+<a class="jxr_linenumber" name="L501" href="#L501">501</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified collection is not <jk>null</jk> and not empty.</em>
+<a class="jxr_linenumber" name="L502" href="#L502">502</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L503" href="#L503">503</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotEmpty(Collection<?> value) {
+<a class="jxr_linenumber" name="L504" href="#L504">504</a> <strong class="jxr_keyword">return</strong> ! isEmpty(value);
+<a class="jxr_linenumber" name="L505" href="#L505">505</a> }
+<a class="jxr_linenumber" name="L506" href="#L506">506</a>
+<a class="jxr_linenumber" name="L507" href="#L507">507</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L508" href="#L508">508</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified map is not <jk>null</jk> and not empty.</em>
+<a class="jxr_linenumber" name="L509" href="#L509">509</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L510" href="#L510">510</a> <em class="jxr_javadoccomment"> * @param value The map to check.</em>
+<a class="jxr_linenumber" name="L511" href="#L511">511</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified map is not <jk>null</jk> and not empty.</em>
+<a class="jxr_linenumber" name="L512" href="#L512">512</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L513" href="#L513">513</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotEmpty(Map<?,?> value) {
+<a class="jxr_linenumber" name="L514" href="#L514">514</a> <strong class="jxr_keyword">return</strong> ! isEmpty(value);
+<a class="jxr_linenumber" name="L515" href="#L515">515</a> }
+<a class="jxr_linenumber" name="L516" href="#L516">516</a>
+<a class="jxr_linenumber" name="L517" href="#L517">517</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L518" href="#L518">518</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if string is not <jk>null</jk> and not empty.</em>
+<a class="jxr_linenumber" name="L519" href="#L519">519</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L520" href="#L520">520</a> <em class="jxr_javadoccomment"> * @param o The string to check.</em>
+<a class="jxr_linenumber" name="L521" href="#L521">521</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if string is not <jk>null</jk> and not empty.</em>
+<a class="jxr_linenumber" name="L522" href="#L522">522</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L523" href="#L523">523</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotEmpty(CharSequence o) {
+<a class="jxr_linenumber" name="L524" href="#L524">524</a> <strong class="jxr_keyword">return</strong> ! isEmpty(o);
+<a class="jxr_linenumber" name="L525" href="#L525">525</a> }
+<a class="jxr_linenumber" name="L526" href="#L526">526</a>
+<a class="jxr_linenumber" name="L527" href="#L527">527</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L528" href="#L528">528</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified number is not <jk>null</jk> and not <c>-1</c>.</em>
+<a class="jxr_linenumber" name="L529" href="#L529">529</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L530" href="#L530">530</a> <em class="jxr_javadoccomment"> * @param <T> The value types.</em>
+<a class="jxr_linenumber" name="L531" href="#L531">531</a> <em class="jxr_javadoccomment"> * @param value The value being checked.</em>
+<a class="jxr_linenumber" name="L532" href="#L532">532</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified number is not <jk>null</jk> and not <c>-1</c>.</em>
+<a class="jxr_linenumber" name="L533" href="#L533">533</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L534" href="#L534">534</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T <strong class="jxr_keyword">extends</strong> Number> <strong class="jxr_keyword">boolean</strong> isNotMinusOne(T value) {
+<a class="jxr_linenumber" name="L535" href="#L535">535</a> <strong class="jxr_keyword">return</strong> nn(value) && value.intValue() != -1;
+<a class="jxr_linenumber" name="L536" href="#L536">536</a> }
+<a class="jxr_linenumber" name="L537" href="#L537">537</a>
+<a class="jxr_linenumber" name="L538" href="#L538">538</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L539" href="#L539">539</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified object is not <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L540" href="#L540">540</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L541" href="#L541">541</a> <em class="jxr_javadoccomment"> * @param <T> The value type.</em>
+<a class="jxr_linenumber" name="L542" href="#L542">542</a> <em class="jxr_javadoccomment"> * @param value The value being checked.</em>
+<a class="jxr_linenumber" name="L543" href="#L543">543</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified object is not <jk>null</jk>.</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> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> <strong class="jxr_keyword">boolean</strong> isNotNull(T value) {
+<a class="jxr_linenumber" name="L546" href="#L546">546</a> <strong class="jxr_keyword">return</strong> value != <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L547" href="#L547">547</a> }
+<a class="jxr_linenumber" name="L548" href="#L548">548</a>
+<a class="jxr_linenumber" name="L549" href="#L549">549</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L550" href="#L550">550</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified boolean is not <jk>null</jk> and is <jk>true</jk>.</em>
+<a class="jxr_linenumber" name="L551" href="#L551">551</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L552" href="#L552">552</a> <em class="jxr_javadoccomment"> * @param value The value being checked.</em>
+<a class="jxr_linenumber" name="L553" href="#L553">553</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified boolean is not <jk>null</jk> and is <jk>true</jk>.</em>
+<a class="jxr_linenumber" name="L554" href="#L554">554</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L555" href="#L555">555</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isTrue(Boolean value) {
+<a class="jxr_linenumber" name="L556" href="#L556">556</a> <strong class="jxr_keyword">return</strong> nn(value) && value;
+<a class="jxr_linenumber" name="L557" href="#L557">557</a> }
+<a class="jxr_linenumber" name="L558" href="#L558">558</a>
+<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"> * Returns <jk>null</jk> for the specified type.</em>
+<a class="jxr_linenumber" name="L561" href="#L561">561</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L562" href="#L562">562</a> <em class="jxr_javadoccomment"> * @param <T> The type.</em>
+<a class="jxr_linenumber" name="L563" href="#L563">563</a> <em class="jxr_javadoccomment"> * @param type The type class.</em>
+<a class="jxr_linenumber" name="L564" href="#L564">564</a> <em class="jxr_javadoccomment"> * @return <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L565" href="#L565">565</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L566" href="#L566">566</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> T n(Class<T> type) {
+<a class="jxr_linenumber" name="L567" href="#L567">567</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L568" href="#L568">568</a> }
+<a class="jxr_linenumber" name="L569" href="#L569">569</a>
+<a class="jxr_linenumber" name="L570" href="#L570">570</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L571" href="#L571">571</a> <em class="jxr_javadoccomment"> * Null-safe not-equals check.</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> <em class="jxr_javadoccomment"> * @param <T> The object type.</em>
+<a class="jxr_linenumber" name="L574" href="#L574">574</a> <em class="jxr_javadoccomment"> * @param s1 Object 1.</em>
+<a class="jxr_linenumber" name="L575" href="#L575">575</a> <em class="jxr_javadoccomment"> * @param s2 Object 2.</em>
+<a class="jxr_linenumber" name="L576" href="#L576">576</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the objects are not equal.</em>
+<a class="jxr_linenumber" name="L577" href="#L577">577</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L578" href="#L578">578</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> <strong class="jxr_keyword">boolean</strong> ne(T s1, T s2) {
+<a class="jxr_linenumber" name="L579" href="#L579">579</a> <strong class="jxr_keyword">return</strong> ! eq(s1, s2);
+<a class="jxr_linenumber" name="L580" href="#L580">580</a> }
+<a class="jxr_linenumber" name="L581" href="#L581">581</a>
+<a class="jxr_linenumber" name="L582" href="#L582">582</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L583" href="#L583">583</a> <em class="jxr_javadoccomment"> * Tests two objects for inequality, gracefully handling nulls.</em>
+<a class="jxr_linenumber" name="L584" href="#L584">584</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L585" href="#L585">585</a> <em class="jxr_javadoccomment"> * @param <T> Object 1 type.</em>
+<a class="jxr_linenumber" name="L586" href="#L586">586</a> <em class="jxr_javadoccomment"> * @param <U> Object 2 type.</em>
+<a class="jxr_linenumber" name="L587" href="#L587">587</a> <em class="jxr_javadoccomment"> * @param o1 Object 1.</em>
+<a class="jxr_linenumber" name="L588" href="#L588">588</a> <em class="jxr_javadoccomment"> * @param o2 Object 2.</em>
+<a class="jxr_linenumber" name="L589" href="#L589">589</a> <em class="jxr_javadoccomment"> * @param test The test to use for equality.</em>
+<a class="jxr_linenumber" name="L590" href="#L590">590</a> <em class="jxr_javadoccomment"> * @return <jk>false</jk> if both objects are equal based on the test.</em>
+<a class="jxr_linenumber" name="L591" href="#L591">591</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L592" href="#L592">592</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T,U> <strong class="jxr_keyword">boolean</strong> ne(T o1, U o2, BiPredicate<T,U> test) {
+<a class="jxr_linenumber" name="L593" href="#L593">593</a> <strong class="jxr_keyword">if</strong> (o1 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L594" href="#L594">594</a> <strong class="jxr_keyword">return</strong> nn(o2);
+<a class="jxr_linenumber" name="L595" href="#L595">595</a> <strong class="jxr_keyword">if</strong> (o2 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L596" href="#L596">596</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L597" href="#L597">597</a> <strong class="jxr_keyword">if</strong> (o1 == o2)
+<a class="jxr_linenumber" name="L598" href="#L598">598</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L599" href="#L599">599</a> <strong class="jxr_keyword">return</strong> ! test.test(o1, o2);
+<a class="jxr_linenumber" name="L600" href="#L600">600</a> }
+<a class="jxr_linenumber" name="L601" href="#L601">601</a>
+<a class="jxr_linenumber" name="L602" href="#L602">602</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L603" href="#L603">603</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified object is not <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L604" href="#L604">604</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L605" href="#L605">605</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L606" href="#L606">606</a> <em class="jxr_javadoccomment"> * Equivalent to <c><jv>o</jv> != <jk>null</jk></c>, but with a more readable method name.</em>
+<a class="jxr_linenumber" name="L607" href="#L607">607</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L608" href="#L608">608</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L609" href="#L609">609</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L610" href="#L610">610</a> <em class="jxr_javadoccomment"> * <jk>import static</jk> org.apache.juneau.common.utils.Utils.*;</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"> * @param value The collection to check.</em>
-<a class="jxr_linenumber" name="L613" href="#L613">613</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified collection is not <jk>null</jk> and not empty.</em>
-<a class="jxr_linenumber" name="L614" href="#L614">614</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L615" href="#L615">615</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotEmpty(Collection<?> value) {
-<a class="jxr_linenumber" name="L616" href="#L616">616</a> <strong class="jxr_keyword">return</strong> ! isEmpty(value);
-<a class="jxr_linenumber" name="L617" href="#L617">617</a> }
-<a class="jxr_linenumber" name="L618" href="#L618">618</a>
-<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> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified map is not <jk>null</jk> and not empty.</em>
-<a class="jxr_linenumber" name="L621" href="#L621">621</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L622" href="#L622">622</a> <em class="jxr_javadoccomment"> * @param value The map to check.</em>
-<a class="jxr_linenumber" name="L623" href="#L623">623</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified map is not <jk>null</jk> and not empty.</em>
-<a class="jxr_linenumber" name="L624" href="#L624">624</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L625" href="#L625">625</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotEmpty(Map<?,?> value) {
-<a class="jxr_linenumber" name="L626" href="#L626">626</a> <strong class="jxr_keyword">return</strong> ! isEmpty(value);
-<a class="jxr_linenumber" name="L627" href="#L627">627</a> }
-<a class="jxr_linenumber" name="L628" href="#L628">628</a>
-<a class="jxr_linenumber" name="L629" href="#L629">629</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L630" href="#L630">630</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if string is not <jk>null</jk> and not empty.</em>
-<a class="jxr_linenumber" name="L631" href="#L631">631</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L632" href="#L632">632</a> <em class="jxr_javadoccomment"> * @param o The string to check.</em>
-<a class="jxr_linenumber" name="L633" href="#L633">633</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if string is not <jk>null</jk> and not empty.</em>
-<a class="jxr_linenumber" name="L634" href="#L634">634</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L635" href="#L635">635</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotEmpty(CharSequence o) {
-<a class="jxr_linenumber" name="L636" href="#L636">636</a> <strong class="jxr_keyword">return</strong> ! isEmpty(o);
-<a class="jxr_linenumber" name="L637" href="#L637">637</a> }
-<a class="jxr_linenumber" name="L638" href="#L638">638</a>
-<a class="jxr_linenumber" name="L639" href="#L639">639</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L640" href="#L640">640</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified number is not <jk>null</jk> and not <c>-1</c>.</em>
-<a class="jxr_linenumber" name="L641" href="#L641">641</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L642" href="#L642">642</a> <em class="jxr_javadoccomment"> * @param <T> The value types.</em>
-<a class="jxr_linenumber" name="L643" href="#L643">643</a> <em class="jxr_javadoccomment"> * @param value The value being checked.</em>
-<a class="jxr_linenumber" name="L644" href="#L644">644</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified number is not <jk>null</jk> and not <c>-1</c>.</em>
-<a class="jxr_linenumber" name="L645" href="#L645">645</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L646" href="#L646">646</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T <strong class="jxr_keyword">extends</strong> Number> <strong class="jxr_keyword">boolean</strong> isNotMinusOne(T value) {
-<a class="jxr_linenumber" name="L647" href="#L647">647</a> <strong class="jxr_keyword">return</strong> nn(value) && value.intValue() != -1;
-<a class="jxr_linenumber" name="L648" href="#L648">648</a> }
-<a class="jxr_linenumber" name="L649" href="#L649">649</a>
-<a class="jxr_linenumber" name="L650" href="#L650">650</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L651" href="#L651">651</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified object is not <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L652" href="#L652">652</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L653" href="#L653">653</a> <em class="jxr_javadoccomment"> * @param <T> The value type.</em>
-<a class="jxr_linenumber" name="L654" href="#L654">654</a> <em class="jxr_javadoccomment"> * @param value The value being checked.</em>
-<a class="jxr_linenumber" name="L655" href="#L655">655</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified object is not <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L656" href="#L656">656</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L657" href="#L657">657</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> <strong class="jxr_keyword">boolean</strong> isNotNull(T value) {
-<a class="jxr_linenumber" name="L658" href="#L658">658</a> <strong class="jxr_keyword">return</strong> value != <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L659" href="#L659">659</a> }
-<a class="jxr_linenumber" name="L660" href="#L660">660</a>
-<a class="jxr_linenumber" name="L661" href="#L661">661</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L662" href="#L662">662</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified boolean is not <jk>null</jk> and is <jk>true</jk>.</em>
-<a class="jxr_linenumber" name="L663" href="#L663">663</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L664" href="#L664">664</a> <em class="jxr_javadoccomment"> * @param value The value being checked.</em>
-<a class="jxr_linenumber" name="L665" href="#L665">665</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified boolean is not <jk>null</jk> and is <jk>true</jk>.</em>
-<a class="jxr_linenumber" name="L666" href="#L666">666</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L667" href="#L667">667</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isTrue(Boolean value) {
-<a class="jxr_linenumber" name="L668" href="#L668">668</a> <strong class="jxr_keyword">return</strong> nn(value) && value;
-<a class="jxr_linenumber" name="L669" href="#L669">669</a> }
-<a class="jxr_linenumber" name="L670" href="#L670">670</a>
-<a class="jxr_linenumber" name="L671" href="#L671">671</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L672" href="#L672">672</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> for the specified type.</em>
-<a class="jxr_linenumber" name="L673" href="#L673">673</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L674" href="#L674">674</a> <em class="jxr_javadoccomment"> * @param <T> The type.</em>
-<a class="jxr_linenumber" name="L675" href="#L675">675</a> <em class="jxr_javadoccomment"> * @param type The type class.</em>
-<a class="jxr_linenumber" name="L676" href="#L676">676</a> <em class="jxr_javadoccomment"> * @return <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L677" href="#L677">677</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L678" href="#L678">678</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> T n(Class<T> type) {
-<a class="jxr_linenumber" name="L679" href="#L679">679</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L680" href="#L680">680</a> }
-<a class="jxr_linenumber" name="L681" href="#L681">681</a>
-<a class="jxr_linenumber" name="L682" href="#L682">682</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L683" href="#L683">683</a> <em class="jxr_javadoccomment"> * Null-safe not-equals check.</em>
-<a class="jxr_linenumber" name="L684" href="#L684">684</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L685" href="#L685">685</a> <em class="jxr_javadoccomment"> * @param <T> The object type.</em>
-<a class="jxr_linenumber" name="L686" href="#L686">686</a> <em class="jxr_javadoccomment"> * @param s1 Object 1.</em>
-<a class="jxr_linenumber" name="L687" href="#L687">687</a> <em class="jxr_javadoccomment"> * @param s2 Object 2.</em>
-<a class="jxr_linenumber" name="L688" href="#L688">688</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the objects are not equal.</em>
-<a class="jxr_linenumber" name="L689" href="#L689">689</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L690" href="#L690">690</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> <strong class="jxr_keyword">boolean</strong> ne(T s1, T s2) {
-<a class="jxr_linenumber" name="L691" href="#L691">691</a> <strong class="jxr_keyword">return</strong> ! eq(s1, s2);
-<a class="jxr_linenumber" name="L692" href="#L692">692</a> }
-<a class="jxr_linenumber" name="L693" href="#L693">693</a>
-<a class="jxr_linenumber" name="L694" href="#L694">694</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L695" href="#L695">695</a> <em class="jxr_javadoccomment"> * Tests two objects for inequality, gracefully handling nulls.</em>
-<a class="jxr_linenumber" name="L696" href="#L696">696</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L697" href="#L697">697</a> <em class="jxr_javadoccomment"> * @param <T> Object 1 type.</em>
-<a class="jxr_linenumber" name="L698" href="#L698">698</a> <em class="jxr_javadoccomment"> * @param <U> Object 2 type.</em>
-<a class="jxr_linenumber" name="L699" href="#L699">699</a> <em class="jxr_javadoccomment"> * @param o1 Object 1.</em>
-<a class="jxr_linenumber" name="L700" href="#L700">700</a> <em class="jxr_javadoccomment"> * @param o2 Object 2.</em>
-<a class="jxr_linenumber" name="L701" href="#L701">701</a> <em class="jxr_javadoccomment"> * @param test The test to use for equality.</em>
-<a class="jxr_linenumber" name="L702" href="#L702">702</a> <em class="jxr_javadoccomment"> * @return <jk>false</jk> if both objects are equal based on the test.</em>
-<a class="jxr_linenumber" name="L703" href="#L703">703</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L704" href="#L704">704</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T,U> <strong class="jxr_keyword">boolean</strong> ne(T o1, U o2, BiPredicate<T,U> test) {
-<a class="jxr_linenumber" name="L705" href="#L705">705</a> <strong class="jxr_keyword">if</strong> (o1 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L706" href="#L706">706</a> <strong class="jxr_keyword">return</strong> nn(o2);
-<a class="jxr_linenumber" name="L707" href="#L707">707</a> <strong class="jxr_keyword">if</strong> (o2 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L708" href="#L708">708</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L709" href="#L709">709</a> <strong class="jxr_keyword">if</strong> (o1 == o2)
-<a class="jxr_linenumber" name="L710" href="#L710">710</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L711" href="#L711">711</a> <strong class="jxr_keyword">return</strong> ! test.test(o1, o2);
-<a class="jxr_linenumber" name="L712" href="#L712">712</a> }
-<a class="jxr_linenumber" name="L713" href="#L713">713</a>
-<a class="jxr_linenumber" name="L714" href="#L714">714</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L715" href="#L715">715</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified object is not <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L716" href="#L716">716</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L717" href="#L717">717</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L718" href="#L718">718</a> <em class="jxr_javadoccomment"> * Equivalent to <c><jv>o</jv> != <jk>null</jk></c>, but with a more readable method name.</em>
-<a class="jxr_linenumber" name="L719" href="#L719">719</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L720" href="#L720">720</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L721" href="#L721">721</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L722" href="#L722">722</a> <em class="jxr_javadoccomment"> * <jk>import static</jk> org.apache.juneau.common.utils.Utils.*;</em>
-<a class="jxr_linenumber" name="L723" href="#L723">723</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L724" href="#L724">724</a> <em class="jxr_javadoccomment"> * <jk>if</jk> (<jsm>nn</jsm>(<jv>myObject</jv>)) {</em>
-<a class="jxr_linenumber" name="L725" href="#L725">725</a> <em class="jxr_javadoccomment"> * <jc>// Do something with non-null object</jc></em>
-<a class="jxr_linenumber" name="L726" href="#L726">726</a> <em class="jxr_javadoccomment"> * }</em>
-<a class="jxr_linenumber" name="L727" href="#L727">727</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L728" href="#L728">728</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L729" href="#L729">729</a> <em class="jxr_javadoccomment"> * @param o The object to check.</em>
-<a class="jxr_linenumber" name="L730" href="#L730">730</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified object is not <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L731" href="#L731">731</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L732" href="#L732">732</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> nn(Object o) {
-<a class="jxr_linenumber" name="L733" href="#L733">733</a> <strong class="jxr_keyword">return</strong> isNotNull(o);
-<a class="jxr_linenumber" name="L734" href="#L734">734</a> }
-<a class="jxr_linenumber" name="L735" href="#L735">735</a>
-<a class="jxr_linenumber" name="L736" href="#L736">736</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L737" href="#L737">737</a> <em class="jxr_javadoccomment"> * Tests two strings for non-equality ignoring case, but gracefully handles nulls.</em>
-<a class="jxr_linenumber" name="L738" href="#L738">738</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L739" href="#L739">739</a> <em class="jxr_javadoccomment"> * @param s1 String 1.</em>
-<a class="jxr_linenumber" name="L740" href="#L740">740</a> <em class="jxr_javadoccomment"> * @param s2 String 2.</em>
-<a class="jxr_linenumber" name="L741" href="#L741">741</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the strings are not equal ignoring case.</em>
-<a class="jxr_linenumber" name="L742" href="#L742">742</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L743" href="#L743">743</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> neic(String s1, String s2) {
-<a class="jxr_linenumber" name="L744" href="#L744">744</a> <strong class="jxr_keyword">return</strong> ! eqic(s1, s2);
-<a class="jxr_linenumber" name="L745" href="#L745">745</a> }
-<a class="jxr_linenumber" name="L746" href="#L746">746</a>
-<a class="jxr_linenumber" name="L747" href="#L747">747</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L748" href="#L748">748</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link Optional#ofNullable(Object)}.</em>
-<a class="jxr_linenumber" name="L749" href="#L749">749</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L750" href="#L750">750</a> <em class="jxr_javadoccomment"> * @param <T> The object type.</em>
-<a class="jxr_linenumber" name="L751" href="#L751">751</a> <em class="jxr_javadoccomment"> * @param t The object to wrap in an Optional.</em>
-<a class="jxr_linenumber" name="L752" href="#L752">752</a> <em class="jxr_javadoccomment"> * @return An Optional containing the specified object, or empty if <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L753" href="#L753">753</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L754" href="#L754">754</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <T> Optional<T> opt(T t) {
-<a class="jxr_linenumber" name="L755" href="#L755">755</a> <strong class="jxr_keyword">return</strong> Optional.ofNullable(t);
-<a class="jxr_linenumber" name="L756" href="#L756">756</a> }
-<a class="jxr_linenumber" name="L757" href="#L757">757</a>
-<a class="jxr_linenumber" name="L758" href="#L758">758</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L759" href="#L759">759</a> <em class="jxr_javadoccomment"> * Returns an empty Optional.</em>
-<a class="jxr_linenumber" name="L760" href="#L760">760</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L761" href="#L761">761</a> <em class="jxr_javadoccomment"> * @param <T> The object type.</em>
-<a class="jxr_linenumber" name="L762" href="#L762">762</a> <em class="jxr_javadoccomment"> * @return An empty Optional.</em>
-<a class="jxr_linenumber" name="L763" href="#L763">763</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L764" href="#L764">764</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <T> Optional<T> opte() {
-<a class="jxr_linenumber" name="L765" href="#L765">765</a> <strong class="jxr_keyword">return</strong> Optional.empty();
-<a class="jxr_linenumber" name="L766" href="#L766">766</a> }
-<a class="jxr_linenumber" name="L767" href="#L767">767</a>
-<a class="jxr_linenumber" name="L768" href="#L768">768</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L769" href="#L769">769</a> <em class="jxr_javadoccomment"> * Prints all the specified lines to System.out.</em>
-<a class="jxr_linenumber" name="L770" href="#L770">770</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L771" href="#L771">771</a> <em class="jxr_javadoccomment"> * @param lines The lines to print.</em>
-<a class="jxr_linenumber" name="L772" href="#L772">772</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L773" href="#L773">773</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">void</strong> printLines(String[] lines) {
-<a class="jxr_linenumber" name="L774" href="#L774">774</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < lines.length; i++)
-<a class="jxr_linenumber" name="L775" href="#L775">775</a> System.out.println(String.format(<span class="jxr_string">"%4s:"</span> + lines[i], i + 1)); <em class="jxr_comment">// NOSONAR - NOT DEBUG</em>
-<a class="jxr_linenumber" name="L776" href="#L776">776</a> }
-<a class="jxr_linenumber" name="L777" href="#L777">777</a>
-<a class="jxr_linenumber" name="L778" href="#L778">778</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L779" href="#L779">779</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link StringUtils#readable(Object)}.</em>
-<a class="jxr_linenumber" name="L780" href="#L780">780</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L781" href="#L781">781</a> <em class="jxr_javadoccomment"> * <p>Converts an arbitrary object to a readable string format suitable for debugging and testing.</em>
-<a class="jxr_linenumber" name="L782" href="#L782">782</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L783" href="#L783">783</a> <em class="jxr_javadoccomment"> * @param o The object to convert to readable format. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L784" href="#L784">784</a> <em class="jxr_javadoccomment"> * @return A readable string representation of the object, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L785" href="#L785">785</a> <em class="jxr_javadoccomment"> * @see StringUtils#readable(Object)</em>
-<a class="jxr_linenumber" name="L786" href="#L786">786</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L787" href="#L787">787</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String r(Object o) {
-<a class="jxr_linenumber" name="L788" href="#L788">788</a> <strong class="jxr_keyword">return</strong> readable(o);
-<a class="jxr_linenumber" name="L789" href="#L789">789</a> }
-<a class="jxr_linenumber" name="L790" href="#L790">790</a>
-<a class="jxr_linenumber" name="L791" href="#L791">791</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L792" href="#L792">792</a> <em class="jxr_javadoccomment"> * Shortcut for converting an object to a string.</em>
-<a class="jxr_linenumber" name="L793" href="#L793">793</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L794" href="#L794">794</a> <em class="jxr_javadoccomment"> * @param val The object to convert.</em>
-<a class="jxr_linenumber" name="L795" href="#L795">795</a> <em class="jxr_javadoccomment"> * @return The string representation of the object, or <jk>null</jk> if the object is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L796" href="#L796">796</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L797" href="#L797">797</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String s(Object val) {
-<a class="jxr_linenumber" name="L798" href="#L798">798</a> <strong class="jxr_keyword">return</strong> val == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : val.toString();
-<a class="jxr_linenumber" name="L799" href="#L799">799</a> }
-<a class="jxr_linenumber" name="L800" href="#L800">800</a>
-<a class="jxr_linenumber" name="L801" href="#L801">801</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L802" href="#L802">802</a> <em class="jxr_javadoccomment"> * Runs a snippet of code and encapsulates any throwable inside a {@link RuntimeException}.</em>
-<a class="jxr_linenumber" name="L803" href="#L803">803</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L804" href="#L804">804</a> <em class="jxr_javadoccomment"> * @param snippet The snippet of code to run.</em>
-<a class="jxr_linenumber" name="L805" href="#L805">805</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L806" href="#L806">806</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> safe(<a name="Snippet" href="../../../../../org/apache/juneau/common/function/Snippet.html#Snippet">Snippet</a> snippet) {
-<a class="jxr_linenumber" name="L807" href="#L807">807</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L808" href="#L808">808</a> snippet.run();
-<a class="jxr_linenumber" name="L809" href="#L809">809</a> } <strong class="jxr_keyword">catch</strong> (RuntimeException t) {
-<a class="jxr_linenumber" name="L810" href="#L810">810</a> <strong class="jxr_keyword">throw</strong> t;
-<a class="jxr_linenumber" name="L811" href="#L811">811</a> } <strong class="jxr_keyword">catch</strong> (Throwable t) {
-<a class="jxr_linenumber" name="L812" href="#L812">812</a> <strong class="jxr_keyword">throw</strong> ThrowableUtils.toRex(t);
-<a class="jxr_linenumber" name="L813" href="#L813">813</a> }
-<a class="jxr_linenumber" name="L814" href="#L814">814</a> }
-<a class="jxr_linenumber" name="L815" href="#L815">815</a>
-<a class="jxr_linenumber" name="L816" href="#L816">816</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L817" href="#L817">817</a> <em class="jxr_javadoccomment"> * Used to wrap code that returns a value but throws an exception.</em>
-<a class="jxr_linenumber" name="L818" href="#L818">818</a> <em class="jxr_javadoccomment"> * Useful in cases where you're trying to execute code in a fluent method call</em>
-<a class="jxr_linenumber" name="L819" href="#L819">819</a> <em class="jxr_javadoccomment"> * or are trying to eliminate untestable catch blocks in code.</em>
-<a class="jxr_linenumber" name="L820" href="#L820">820</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L821" href="#L821">821</a> <em class="jxr_javadoccomment"> * @param <T> The return type.</em>
-<a class="jxr_linenumber" name="L822" href="#L822">822</a> <em class="jxr_javadoccomment"> * @param s The supplier that may throw an exception.</em>
-<a class="jxr_linenumber" name="L823" href="#L823">823</a> <em class="jxr_javadoccomment"> * @return The result of the supplier execution.</em>
-<a class="jxr_linenumber" name="L824" href="#L824">824</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L825" href="#L825">825</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> T safe(ThrowingSupplier<T> s) {
-<a class="jxr_linenumber" name="L826" href="#L826">826</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L827" href="#L827">827</a> <strong class="jxr_keyword">return</strong> s.get();
-<a class="jxr_linenumber" name="L828" href="#L828">828</a> } <strong class="jxr_keyword">catch</strong> (RuntimeException e) {
-<a class="jxr_linenumber" name="L829" href="#L829">829</a> <strong class="jxr_keyword">throw</strong> e;
-<a class="jxr_linenumber" name="L830" href="#L830">830</a> } <strong class="jxr_keyword">catch</strong> (Exception e) {
-<a class="jxr_linenumber" name="L831" href="#L831">831</a> <strong class="jxr_keyword">throw</strong> rex(e);
-<a class="jxr_linenumber" name="L832" href="#L832">832</a> }
-<a class="jxr_linenumber" name="L833" href="#L833">833</a> }
-<a class="jxr_linenumber" name="L834" href="#L834">834</a>
-<a class="jxr_linenumber" name="L835" href="#L835">835</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L836" href="#L836">836</a> <em class="jxr_javadoccomment"> * Allows you to wrap a supplier that throws an exception so that it can be used in a fluent interface.</em>
-<a class="jxr_linenumber" name="L837" href="#L837">837</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L838" href="#L838">838</a> <em class="jxr_javadoccomment"> * @param <T> The supplier type.</em>
-<a class="jxr_linenumber" name="L839" href="#L839">839</a> <em class="jxr_javadoccomment"> * @param supplier The supplier throwing an exception.</em>
-<a class="jxr_linenumber" name="L840" href="#L840">840</a> <em class="jxr_javadoccomment"> * @return The supplied result.</em>
-<a class="jxr_linenumber" name="L841" href="#L841">841</a> <em class="jxr_javadoccomment"> * @throws RuntimeException if supplier threw an exception.</em>
+<a class="jxr_linenumber" name="L612" href="#L612">612</a> <em class="jxr_javadoccomment"> * <jk>if</jk> (<jsm>nn</jsm>(<jv>myObject</jv>)) {</em>
+<a class="jxr_linenumber" name="L613" href="#L613">613</a> <em class="jxr_javadoccomment"> * <jc>// Do something with non-null object</jc></em>
+<a class="jxr_linenumber" name="L614" href="#L614">614</a> <em class="jxr_javadoccomment"> * }</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 o The object to check.</em>
+<a class="jxr_linenumber" name="L618" href="#L618">618</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified object is not <jk>null</jk>.</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> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> nn(Object o) {
+<a class="jxr_linenumber" name="L621" href="#L621">621</a> <strong class="jxr_keyword">return</strong> isNotNull(o);
+<a class="jxr_linenumber" name="L622" href="#L622">622</a> }
+<a class="jxr_linenumber" name="L623" href="#L623">623</a>
+<a class="jxr_linenumber" name="L624" href="#L624">624</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L625" href="#L625">625</a> <em class="jxr_javadoccomment"> * Tests two strings for non-equality ignoring case, but gracefully handles nulls.</em>
+<a class="jxr_linenumber" name="L626" href="#L626">626</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L627" href="#L627">627</a> <em class="jxr_javadoccomment"> * @param s1 String 1.</em>
+<a class="jxr_linenumber" name="L628" href="#L628">628</a> <em class="jxr_javadoccomment"> * @param s2 String 2.</em>
+<a class="jxr_linenumber" name="L629" href="#L629">629</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the strings are not equal ignoring case.</em>
+<a class="jxr_linenumber" name="L630" href="#L630">630</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L631" href="#L631">631</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> neic(String s1, String s2) {
+<a class="jxr_linenumber" name="L632" href="#L632">632</a> <strong class="jxr_keyword">return</strong> ! eqic(s1, s2);
+<a class="jxr_linenumber" name="L633" href="#L633">633</a> }
+<a class="jxr_linenumber" name="L634" href="#L634">634</a>
+<a class="jxr_linenumber" name="L635" href="#L635">635</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L636" href="#L636">636</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link Optional#ofNullable(Object)}.</em>
+<a class="jxr_linenumber" name="L637" href="#L637">637</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L638" href="#L638">638</a> <em class="jxr_javadoccomment"> * @param <T> The object type.</em>
+<a class="jxr_linenumber" name="L639" href="#L639">639</a> <em class="jxr_javadoccomment"> * @param t The object to wrap in an Optional.</em>
+<a class="jxr_linenumber" name="L640" href="#L640">640</a> <em class="jxr_javadoccomment"> * @return An Optional containing the specified object, or empty if <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L641" href="#L641">641</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L642" href="#L642">642</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <T> Optional<T> opt(T t) {
+<a class="jxr_linenumber" name="L643" href="#L643">643</a> <strong class="jxr_keyword">return</strong> Optional.ofNullable(t);
+<a class="jxr_linenumber" name="L644" href="#L644">644</a> }
+<a class="jxr_linenumber" name="L645" href="#L645">645</a>
+<a class="jxr_linenumber" name="L646" href="#L646">646</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L647" href="#L647">647</a> <em class="jxr_javadoccomment"> * Returns an empty Optional.</em>
+<a class="jxr_linenumber" name="L648" href="#L648">648</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L649" href="#L649">649</a> <em class="jxr_javadoccomment"> * @param <T> The object type.</em>
+<a class="jxr_linenumber" name="L650" href="#L650">650</a> <em class="jxr_javadoccomment"> * @return An empty Optional.</em>
+<a class="jxr_linenumber" name="L651" href="#L651">651</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L652" href="#L652">652</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <T> Optional<T> opte() {
+<a class="jxr_linenumber" name="L653" href="#L653">653</a> <strong class="jxr_keyword">return</strong> Optional.empty();
+<a class="jxr_linenumber" name="L654" href="#L654">654</a> }
+<a class="jxr_linenumber" name="L655" href="#L655">655</a>
+<a class="jxr_linenumber" name="L656" href="#L656">656</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L657" href="#L657">657</a> <em class="jxr_javadoccomment"> * Prints all the specified lines to System.out.</em>
+<a class="jxr_linenumber" name="L658" href="#L658">658</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L659" href="#L659">659</a> <em class="jxr_javadoccomment"> * @param lines The lines to print.</em>
+<a class="jxr_linenumber" name="L660" href="#L660">660</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L661" href="#L661">661</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">void</strong> printLines(String[] lines) {
+<a class="jxr_linenumber" name="L662" href="#L662">662</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < lines.length; i++)
+<a class="jxr_linenumber" name="L663" href="#L663">663</a> System.out.println(String.format(<span class="jxr_string">"%4s:"</span> + lines[i], i + 1)); <em class="jxr_comment">// NOSONAR - NOT DEBUG</em>
+<a class="jxr_linenumber" name="L664" href="#L664">664</a> }
+<a class="jxr_linenumber" name="L665" href="#L665">665</a>
+<a class="jxr_linenumber" name="L666" href="#L666">666</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L667" href="#L667">667</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link StringUtils#readable(Object)}.</em>
+<a class="jxr_linenumber" name="L668" href="#L668">668</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L669" href="#L669">669</a> <em class="jxr_javadoccomment"> * <p>Converts an arbitrary object to a readable string format suitable for debugging and testing.</em>
+<a class="jxr_linenumber" name="L670" href="#L670">670</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L671" href="#L671">671</a> <em class="jxr_javadoccomment"> * @param o The object to convert to readable format. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L672" href="#L672">672</a> <em class="jxr_javadoccomment"> * @return A readable string representation of the object, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L673" href="#L673">673</a> <em class="jxr_javadoccomment"> * @see StringUtils#readable(Object)</em>
+<a class="jxr_linenumber" name="L674" href="#L674">674</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L675" href="#L675">675</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String r(Object o) {
+<a class="jxr_linenumber" name="L676" href="#L676">676</a> <strong class="jxr_keyword">return</strong> readable(o);
+<a class="jxr_linenumber" name="L677" href="#L677">677</a> }
+<a class="jxr_linenumber" name="L678" href="#L678">678</a>
+<a class="jxr_linenumber" name="L679" href="#L679">679</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L680" href="#L680">680</a> <em class="jxr_javadoccomment"> * Shortcut for converting an object to a string.</em>
+<a class="jxr_linenumber" name="L681" href="#L681">681</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L682" href="#L682">682</a> <em class="jxr_javadoccomment"> * @param val The object to convert.</em>
+<a class="jxr_linenumber" name="L683" href="#L683">683</a> <em class="jxr_javadoccomment"> * @return The string representation of the object, or <jk>null</jk> if the object is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L684" href="#L684">684</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L685" href="#L685">685</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String s(Object val) {
+<a class="jxr_linenumber" name="L686" href="#L686">686</a> <strong class="jxr_keyword">return</strong> val == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : val.toString();
+<a class="jxr_linenumber" name="L687" href="#L687">687</a> }
+<a class="jxr_linenumber" name="L688" href="#L688">688</a>
+<a class="jxr_linenumber" name="L689" href="#L689">689</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L690" href="#L690">690</a> <em class="jxr_javadoccomment"> * Runs a snippet of code and encapsulates any throwable inside a {@link RuntimeException}.</em>
+<a class="jxr_linenumber" name="L691" href="#L691">691</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L692" href="#L692">692</a> <em class="jxr_javadoccomment"> * @param snippet The snippet of code to run.</em>
+<a class="jxr_linenumber" name="L693" href="#L693">693</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L694" href="#L694">694</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">void</strong> safe(<a name="Snippet" href="../../../../../org/apache/juneau/common/function/Snippet.html#Snippet">Snippet</a> snippet) {
+<a class="jxr_linenumber" name="L695" href="#L695">695</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L696" href="#L696">696</a> snippet.run();
+<a class="jxr_linenumber" name="L697" href="#L697">697</a> } <strong class="jxr_keyword">catch</strong> (RuntimeException t) {
+<a class="jxr_linenumber" name="L698" href="#L698">698</a> <strong class="jxr_keyword">throw</strong> t;
+<a class="jxr_linenumber" name="L699" href="#L699">699</a> } <strong class="jxr_keyword">catch</strong> (Throwable t) {
+<a class="jxr_linenumber" name="L700" href="#L700">700</a> <strong class="jxr_keyword">throw</strong> ThrowableUtils.toRex(t);
+<a class="jxr_linenumber" name="L701" href="#L701">701</a> }
+<a class="jxr_linenumber" name="L702" href="#L702">702</a> }
+<a class="jxr_linenumber" name="L703" href="#L703">703</a>
+<a class="jxr_linenumber" name="L704" href="#L704">704</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L705" href="#L705">705</a> <em class="jxr_javadoccomment"> * Used to wrap code that returns a value but throws an exception.</em>
+<a class="jxr_linenumber" name="L706" href="#L706">706</a> <em class="jxr_javadoccomment"> * Useful in cases where you're trying to execute code in a fluent method call</em>
+<a class="jxr_linenumber" name="L707" href="#L707">707</a> <em class="jxr_javadoccomment"> * or are trying to eliminate untestable catch blocks in code.</em>
+<a class="jxr_linenumber" name="L708" href="#L708">708</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L709" href="#L709">709</a> <em class="jxr_javadoccomment"> * @param <T> The return type.</em>
+<a class="jxr_linenumber" name="L710" href="#L710">710</a> <em class="jxr_javadoccomment"> * @param s The supplier that may throw an exception.</em>
+<a class="jxr_linenumber" name="L711" href="#L711">711</a> <em class="jxr_javadoccomment"> * @return The result of the supplier execution.</em>
+<a class="jxr_linenumber" name="L712" href="#L712">712</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L713" href="#L713">713</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> T safe(ThrowingSupplier<T> s) {
+<a class="jxr_linenumber" name="L714" href="#L714">714</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L715" href="#L715">715</a> <strong class="jxr_keyword">return</strong> s.get();
+<a class="jxr_linenumber" name="L716" href="#L716">716</a> } <strong class="jxr_keyword">catch</strong> (RuntimeException e) {
+<a class="jxr_linenumber" name="L717" href="#L717">717</a> <strong class="jxr_keyword">throw</strong> e;
+<a class="jxr_linenumber" name="L718" href="#L718">718</a> } <strong class="jxr_keyword">catch</strong> (Exception e) {
+<a class="jxr_linenumber" name="L719" href="#L719">719</a> <strong class="jxr_keyword">throw</strong> rex(e);
+<a class="jxr_linenumber" name="L720" href="#L720">720</a> }
+<a class="jxr_linenumber" name="L721" href="#L721">721</a> }
+<a class="jxr_linenumber" name="L722" href="#L722">722</a>
+<a class="jxr_linenumber" name="L723" href="#L723">723</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L724" href="#L724">724</a> <em class="jxr_javadoccomment"> * Allows you to wrap a supplier that throws an exception so that it can be used in a fluent interface.</em>
+<a class="jxr_linenumber" name="L725" href="#L725">725</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L726" href="#L726">726</a> <em class="jxr_javadoccomment"> * @param <T> The supplier type.</em>
+<a class="jxr_linenumber" name="L727" href="#L727">727</a> <em class="jxr_javadoccomment"> * @param supplier The supplier throwing an exception.</em>
+<a class="jxr_linenumber" name="L728" href="#L728">728</a> <em class="jxr_javadoccomment"> * @return The supplied result.</em>
+<a class="jxr_linenumber" name="L729" href="#L729">729</a> <em class="jxr_javadoccomment"> * @throws RuntimeException if supplier threw an exception.</em>
+<a class="jxr_linenumber" name="L730" href="#L730">730</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L731" href="#L731">731</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> T safeSupplier(ThrowableUtils.SupplierWithThrowable<T> supplier) {
+<a class="jxr_linenumber" name="L732" href="#L732">732</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L733" href="#L733">733</a> <strong class="jxr_keyword">return</strong> supplier.get();
+<a class="jxr_linenumber" name="L734" href="#L734">734</a> } <strong class="jxr_keyword">catch</strong> (RuntimeException t) {
+<a class="jxr_linenumber" name="L735" href="#L735">735</a> <strong class="jxr_keyword">throw</strong> t;
+<a class="jxr_linenumber" name="L736" href="#L736">736</a> } <strong class="jxr_keyword">catch</strong> (Throwable t) {
+<a class="jxr_linenumber" name="L737" href="#L737">737</a> <strong class="jxr_keyword">throw</strong> toRex(t);
+<a class="jxr_linenumber" name="L738" href="#L738">738</a> }
+<a class="jxr_linenumber" name="L739" href="#L739">739</a> }
+<a class="jxr_linenumber" name="L740" href="#L740">740</a>
+<a class="jxr_linenumber" name="L741" href="#L741">741</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L742" href="#L742">742</a> <em class="jxr_javadoccomment"> * Helper method for creating StringBuilder objects.</em>
+<a class="jxr_linenumber" name="L743" href="#L743">743</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L744" href="#L744">744</a> <em class="jxr_javadoccomment"> * @param value The string value to wrap in a StringBuilder.</em>
+<a class="jxr_linenumber" name="L745" href="#L745">745</a> <em class="jxr_javadoccomment"> * @return A new StringBuilder containing the specified value.</em>
+<a class="jxr_linenumber" name="L746" href="#L746">746</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L747" href="#L747">747</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder sb(String value) {
+<a class="jxr_linenumber" name="L748" href="#L748">748</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> StringBuilder(value);
+<a class="jxr_linenumber" name="L749" href="#L749">749</a> }
+<a class="jxr_linenumber" name="L750" href="#L750">750</a>
+<a class="jxr_linenumber" name="L751" href="#L751">751</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L752" href="#L752">752</a> <em class="jxr_javadoccomment"> * Converts a property name to an environment variable name.</em>
+<a class="jxr_linenumber" name="L753" href="#L753">753</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L754" href="#L754">754</a> <em class="jxr_javadoccomment"> * @param name The property name to convert.</em>
+<a class="jxr_linenumber" name="L755" href="#L755">755</a> <em class="jxr_javadoccomment"> * @return The environment variable name (uppercase with dots replaced by underscores).</em>
+<a class="jxr_linenumber" name="L756" href="#L756">756</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L757" href="#L757">757</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> String envName(String name) {
+<a class="jxr_linenumber" name="L758" href="#L758">758</a> <strong class="jxr_keyword">return</strong> PROPERTY_TO_ENV.computeIfAbsent(name, x -> x.toUpperCase().replace(<span class="jxr_string">"."</span>, <span class="jxr_string">"_"</span>));
+<a class="jxr_linenumber" name="L759" href="#L759">759</a> }
+<a class="jxr_linenumber" name="L760" href="#L760">760</a>
+<a class="jxr_linenumber" name="L761" href="#L761">761</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L762" href="#L762">762</a> <em class="jxr_javadoccomment"> * Converts a string to the specified type using registered conversion functions.</em>
+<a class="jxr_linenumber" name="L763" href="#L763">763</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L764" href="#L764">764</a> <em class="jxr_javadoccomment"> * @param <T> The target type.</em>
+<a class="jxr_linenumber" name="L765" href="#L765">765</a> <em class="jxr_javadoccomment"> * @param s The string to convert.</em>
+<a class="jxr_linenumber" name="L766" href="#L766">766</a> <em class="jxr_javadoccomment"> * @param def The default value (used to determine the target type).</em>
+<a class="jxr_linenumber" name="L767" href="#L767">767</a> <em class="jxr_javadoccomment"> * @return The converted value, or <jk>null</jk> if the string or default is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L768" href="#L768">768</a> <em class="jxr_javadoccomment"> * @throws RuntimeException If the type is not supported for conversion.</em>
+<a class="jxr_linenumber" name="L769" href="#L769">769</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L770" href="#L770">770</a> @SuppressWarnings({ <span class="jxr_string">"unchecked"</span>, <span class="jxr_string">"rawtypes"</span> })
+<a class="jxr_linenumber" name="L771" href="#L771">771</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <T> T toType(String s, T def) {
+<a class="jxr_linenumber" name="L772" href="#L772">772</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || def == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L773" href="#L773">773</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L774" href="#L774">774</a> <strong class="jxr_keyword">var</strong> c = (Class<T>)def.getClass();
+<a class="jxr_linenumber" name="L775" href="#L775">775</a> <strong class="jxr_keyword">if</strong> (c == String.<strong class="jxr_keyword">class</strong>)
+<a class="jxr_linenumber" name="L776" href="#L776">776</a> <strong class="jxr_keyword">return</strong> (T)s;
+<a class="jxr_linenumber" name="L777" href="#L777">777</a> <strong class="jxr_keyword">if</strong> (c.isEnum())
+<a class="jxr_linenumber" name="L778" href="#L778">778</a> <strong class="jxr_keyword">return</strong> (T)Enum.valueOf((Class<? <strong class="jxr_keyword">extends</strong> Enum>)c, s);
+<a class="jxr_linenumber" name="L779" href="#L779">779</a> <strong class="jxr_keyword">var</strong> f = (Function<String,T>)ENV_FUNCTIONS.get(c);
+<a class="jxr_linenumber" name="L780" href="#L780">780</a> <strong class="jxr_keyword">if</strong> (f == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L781" href="#L781">781</a> <strong class="jxr_keyword">throw</strong> rex(<span class="jxr_string">"Invalid env type: {0}"</span>, c);
+<a class="jxr_linenumber" name="L782" href="#L782">782</a> <strong class="jxr_keyword">return</strong> f.apply(s);
+<a class="jxr_linenumber" name="L783" href="#L783">783</a> }
+<a class="jxr_linenumber" name="L784" href="#L784">784</a>
+<a class="jxr_linenumber" name="L785" href="#L785">785</a> <em class="jxr_javadoccomment">/** Constructor - This class is meant to be subclasses. */</em>
+<a class="jxr_linenumber" name="L786" href="#L786">786</a> <strong class="jxr_keyword">protected</strong> <a name="Utils" href="../../../../../org/apache/juneau/common/utils/Utils.html#Utils">Utils</a>() {}
+<a class="jxr_linenumber" name="L787" href="#L787">787</a>
+<a class="jxr_linenumber" name="L788" href="#L788">788</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L789" href="#L789">789</a> <em class="jxr_javadoccomment"> * If the specified object is a {@link Supplier} or {@link Value}, returns the inner value, otherwise the same value.</em>
+<a class="jxr_linenumber" name="L790" href="#L790">790</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L791" href="#L791">791</a> <em class="jxr_javadoccomment"> * @param o The object to unwrap.</em>
+<a class="jxr_linenumber" name="L792" href="#L792">792</a> <em class="jxr_javadoccomment"> * @return The unwrapped object.</em>
+<a class="jxr_linenumber" name="L793" href="#L793">793</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L794" href="#L794">794</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Object unwrap(Object o) {
+<a class="jxr_linenumber" name="L795" href="#L795">795</a> <strong class="jxr_keyword">if</strong> (o instanceof Supplier<?> o2)
+<a class="jxr_linenumber" name="L796" href="#L796">796</a> o = unwrap(o2.get());
+<a class="jxr_linenumber" name="L797" href="#L797">797</a> <strong class="jxr_keyword">if</strong> (o instanceof Value<?> o2)
+<a class="jxr_linenumber" name="L798" href="#L798">798</a> o = unwrap(o2.get());
+<a class="jxr_linenumber" name="L799" href="#L799">799</a> <strong class="jxr_keyword">if</strong> (o instanceof Optional<?> o2)
+<a class="jxr_linenumber" name="L800" href="#L800">800</a> o = unwrap(o2.orElse(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L801" href="#L801">801</a> <strong class="jxr_keyword">return</strong> o;
+<a class="jxr_linenumber" name="L802" href="#L802">802</a> }
+<a class="jxr_linenumber" name="L803" href="#L803">803</a>
+<a class="jxr_linenumber" name="L804" href="#L804">804</a> <em class="jxr_comment">// TODO: Look for cases of getClass().getName() and getClass().getSimpleName() in the code and replace with cn() and scn().</em>
+<a class="jxr_linenumber" name="L805" href="#L805">805</a> <em class="jxr_comment">// These utility methods provide cleaner, more concise syntax and null-safe handling.</em>
+<a class="jxr_linenumber" name="L806" href="#L806">806</a> <em class="jxr_comment">// Search patterns:</em>
+<a class="jxr_linenumber" name="L807" href="#L807">807</a> <em class="jxr_comment">// - Replace: getClass().getName() -> cn(this) or cn(object)</em>
+<a class="jxr_linenumber" name="L808" href="#L808">808</a> <em class="jxr_comment">// - Replace: getClass().getSimpleName() -> scn(this) or scn(object)</em>
+<a class="jxr_linenumber" name="L809" href="#L809">809</a> <em class="jxr_comment">// - Replace: obj.getClass().getName() -> cn(obj)</em>
+<a class="jxr_linenumber" name="L810" href="#L810">810</a> <em class="jxr_comment">// - Replace: obj.getClass().getSimpleName() -> scn(obj)</em>
+<a class="jxr_linenumber" name="L811" href="#L811">811</a>
+<a class="jxr_linenumber" name="L812" href="#L812">812</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L813" href="#L813">813</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link ClassUtils#className(Object)}.</em>
+<a class="jxr_linenumber" name="L814" href="#L814">814</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L815" href="#L815">815</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L816" href="#L816">816</a> <em class="jxr_javadoccomment"> * Returns the fully-qualified class name including the full package path.</em>
+<a class="jxr_linenumber" name="L817" href="#L817">817</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L818" href="#L818">818</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L819" href="#L819">819</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L820" href="#L820">820</a> <em class="jxr_javadoccomment"> * <jc>// Regular classes</jc></em>
+<a class="jxr_linenumber" name="L821" href="#L821">821</a> <em class="jxr_javadoccomment"> * cn(String.<jk>class</jk>); <jc>// "java.lang.String"</jc></em>
+<a class="jxr_linenumber" name="L822" href="#L822">822</a> <em class="jxr_javadoccomment"> * cn(<jk>new</jk> HashMap&lt;&gt;()); <jc>// "java.util.HashMap"</jc></em>
+<a class="jxr_linenumber" name="L823" href="#L823">823</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L824" href="#L824">824</a> <em class="jxr_javadoccomment"> * <jc>// Inner classes</jc></em>
+<a class="jxr_linenumber" name="L825" href="#L825">825</a> <em class="jxr_javadoccomment"> * cn(Map.Entry.<jk>class</jk>); <jc>// "java.util.Map$Entry"</jc></em>
+<a class="jxr_linenumber" name="L826" href="#L826">826</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L827" href="#L827">827</a> <em class="jxr_javadoccomment"> * <jc>// Primitives</jc></em>
+<a class="jxr_linenumber" name="L828" href="#L828">828</a> <em class="jxr_javadoccomment"> * cn(<jk>int</jk>.<jk>class</jk>); <jc>// "int"</jc></em>
+<a class="jxr_linenumber" name="L829" href="#L829">829</a> <em class="jxr_javadoccomment"> * cn(<jk>boolean</jk>.<jk>class</jk>); <jc>// "boolean"</jc></em>
+<a class="jxr_linenumber" name="L830" href="#L830">830</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L831" href="#L831">831</a> <em class="jxr_javadoccomment"> * <jc>// Arrays</jc></em>
+<a class="jxr_linenumber" name="L832" href="#L832">832</a> <em class="jxr_javadoccomment"> * cn(String[].<jk>class</jk>); <jc>// "[Ljava.lang.String;"</jc></em>
+<a class="jxr_linenumber" name="L833" href="#L833">833</a> <em class="jxr_javadoccomment"> * cn(<jk>int</jk>[].<jk>class</jk>); <jc>// "[I"</jc></em>
+<a class="jxr_linenumber" name="L834" href="#L834">834</a> <em class="jxr_javadoccomment"> * cn(String[][].<jk>class</jk>); <jc>// "[[Ljava.lang.String;"</jc></em>
+<a class="jxr_linenumber" name="L835" href="#L835">835</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L836" href="#L836">836</a> <em class="jxr_javadoccomment"> * <jc>// Null</jc></em>
+<a class="jxr_linenumber" name="L837" href="#L837">837</a> <em class="jxr_javadoccomment"> * cn(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L838" href="#L838">838</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L839" href="#L839">839</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L840" href="#L840">840</a> <em class="jxr_javadoccomment"> * @param value The object to get the class name for.</em>
+<a class="jxr_linenumber" name="L841" href="#L841">841</a> <em class="jxr_javadoccomment"> * @return The name of the class or <jk>null</jk> if the value was null.</em>
<a class="jxr_linenumber" name="L842" href="#L842">842</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L843" href="#L843">843</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> T safeSupplier(ThrowableUtils.SupplierWithThrowable<T> supplier) {
-<a class="jxr_linenumber" name="L844" href="#L844">844</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L845" href="#L845">845</a> <strong class="jxr_keyword">return</strong> supplier.get();
-<a class="jxr_linenumber" name="L846" href="#L846">846</a> } <strong class="jxr_keyword">catch</strong> (RuntimeException t) {
-<a class="jxr_linenumber" name="L847" href="#L847">847</a> <strong class="jxr_keyword">throw</strong> t;
-<a class="jxr_linenumber" name="L848" href="#L848">848</a> } <strong class="jxr_keyword">catch</strong> (Throwable t) {
-<a class="jxr_linenumber" name="L849" href="#L849">849</a> <strong class="jxr_keyword">throw</strong> toRex(t);
-<a class="jxr_linenumber" name="L850" href="#L850">850</a> }
-<a class="jxr_linenumber" name="L851" href="#L851">851</a> }
-<a class="jxr_linenumber" name="L852" href="#L852">852</a>
-<a class="jxr_linenumber" name="L853" href="#L853">853</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L854" href="#L854">854</a> <em class="jxr_javadoccomment"> * Safely converts an object to its string representation, handling any exceptions that may occur.</em>
-<a class="jxr_linenumber" name="L855" href="#L855">855</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L856" href="#L856">856</a> <em class="jxr_javadoccomment"> * <p>This method provides a fail-safe way to call {@code toString()} on any object, ensuring that</em>
-<a class="jxr_linenumber" name="L857" href="#L857">857</a> <em class="jxr_javadoccomment"> * exceptions thrown by problematic {@code toString()} implementations don't propagate up the call stack.</em>
-<a class="jxr_linenumber" name="L858" href="#L858">858</a> <em class="jxr_javadoccomment"> * Instead, it returns a descriptive error message containing the exception type and message.</p></em>
+<a class="jxr_linenumber" name="L843" href="#L843">843</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String cn(Object value) {
+<a class="jxr_linenumber" name="L844" href="#L844">844</a> <strong class="jxr_keyword">return</strong> ClassUtils.className(value);
+<a class="jxr_linenumber" name="L845" href="#L845">845</a> }
+<a class="jxr_linenumber" name="L846" href="#L846">846</a>
+<a class="jxr_linenumber" name="L847" href="#L847">847</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L848" href="#L848">848</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link ClassUtils#classNameSimple(Object)}.</em>
+<a class="jxr_linenumber" name="L849" href="#L849">849</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L850" href="#L850">850</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L851" href="#L851">851</a> <em class="jxr_javadoccomment"> * Returns only the simple class name without any package or outer class information.</em>
+<a class="jxr_linenumber" name="L852" href="#L852">852</a> <em class="jxr_javadoccomment"> * For inner classes, only the innermost class name is returned.</em>
+<a class="jxr_linenumber" name="L853" href="#L853">853</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L854" href="#L854">854</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L855" href="#L855">855</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L856" href="#L856">856</a> <em class="jxr_javadoccomment"> * <jc>// Regular classes</jc></em>
+<a class="jxr_linenumber" name="L857" href="#L857">857</a> <em class="jxr_javadoccomment"> * scn(String.<jk>class</jk>); <jc>// "String"</jc></em>
+<a class="jxr_linenumber" name="L858" href="#L858">858</a> <em class="jxr_javadoccomment"> * scn(<jk>new</jk> HashMap&lt;&gt;()); <jc>// "HashMap"</jc></em>
<a class="jxr_linenumber" name="L859" href="#L859">859</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L860" href="#L860">860</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Exception Handling:</h5></em>
-<a class="jxr_linenumber" name="L861" href="#L861">861</a> <em class="jxr_javadoccomment"> * <p>If the object's {@code toString()} method throws any {@code Throwable}, this method catches it</em>
-<a class="jxr_linenumber" name="L862" href="#L862">862</a> <em class="jxr_javadoccomment"> * and returns a formatted string in the form: {@code "<ExceptionType>: <exception message>"}.</p></em>
-<a class="jxr_linenumber" name="L863" href="#L863">863</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L864" href="#L864">864</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L865" href="#L865">865</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L866" href="#L866">866</a> <em class="jxr_javadoccomment"> * <jc>// Normal case - returns object's toString() result</jc></em>
-<a class="jxr_linenumber" name="L867" href="#L867">867</a> <em class="jxr_javadoccomment"> * String <jv>result</jv> = <jsm>safeToString</jsm>(<js>"Hello"</js>);</em>
-<a class="jxr_linenumber" name="L868" href="#L868">868</a> <em class="jxr_javadoccomment"> * <jc>// result = "Hello"</jc></em>
-<a class="jxr_linenumber" name="L869" href="#L869">869</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L870" href="#L870">870</a> <em class="jxr_javadoccomment"> * <jc>// Exception case - returns formatted error message</jc></em>
-<a class="jxr_linenumber" name="L871" href="#L871">871</a> <em class="jxr_javadoccomment"> * Object <jv>problematic</jv> = <jk>new</jk> Object() {</em>
-<a class="jxr_linenumber" name="L872" href="#L872">872</a> <em class="jxr_javadoccomment"> * <ja>@Override</ja></em>
-<a class="jxr_linenumber" name="L873" href="#L873">873</a> <em class="jxr_javadoccomment"> * <jk>public</jk> String toString() {</em>
-<a class="jxr_linenumber" name="L874" href="#L874">874</a> <em class="jxr_javadoccomment"> * <jk>throw new</jk> RuntimeException(<js>"Cannot convert"</js>);</em>
-<a class="jxr_linenumber" name="L875" href="#L875">875</a> <em class="jxr_javadoccomment"> * }</em>
-<a class="jxr_linenumber" name="L876" href="#L876">876</a> <em class="jxr_javadoccomment"> * };</em>
-<a class="jxr_linenumber" name="L877" href="#L877">877</a> <em class="jxr_javadoccomment"> * String <jv>result</jv> = <jsm>safeToString</jsm>(<jv>problematic</jv>);</em>
-<a class="jxr_linenumber" name="L878" href="#L878">878</a> <em class="jxr_javadoccomment"> * <jc>// result = "RuntimeException: Cannot convert"</jc></em>
-<a class="jxr_linenumber" name="L879" href="#L879">879</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L880" href="#L880">880</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L881" href="#L881">881</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Use Cases:</h5></em>
-<a class="jxr_linenumber" name="L882" href="#L882">882</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L883" href="#L883">883</a> <em class="jxr_javadoccomment"> * <li><b>Object stringification in converters:</b> Safe conversion of arbitrary objects to strings</li></em>
-<a class="jxr_linenumber" name="L884" href="#L884">884</a> <em class="jxr_javadoccomment"> * <li><b>Debugging and logging:</b> Ensures log statements never fail due to toString() exceptions</li></em>
-<a class="jxr_linenumber" name="L885" href="#L885">885</a> <em class="jxr_javadoccomment"> * <li><b>Error handling:</b> Graceful degradation when objects have problematic string representations</li></em>
-<a class="jxr_linenumber" name="L886" href="#L886">886</a> <em class="jxr_javadoccomment"> * <li><b>Third-party object integration:</b> Safe handling of objects from external libraries</li></em>
-<a class="jxr_linenumber" name="L887" href="#L887">887</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L888" href="#L888">888</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L889" href="#L889">889</a> <em class="jxr_javadoccomment"> * @param o The object to convert to a string. May be any object including <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L890" href="#L890">890</a> <em class="jxr_javadoccomment"> * @return The string representation of the object, or a formatted error message if toString() throws an exception.</em>
-<a class="jxr_linenumber" name="L891" href="#L891">891</a> <em class="jxr_javadoccomment"> * Returns <js>"null"</js> if the object is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L892" href="#L892">892</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L893" href="#L893">893</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String safeToString(Object o) {
-<a class="jxr_linenumber" name="L894" href="#L894">894</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L895" href="#L895">895</a> <strong class="jxr_keyword">return</strong> o.toString();
-<a class="jxr_linenumber" name="L896" href="#L896">896</a> } <strong class="jxr_keyword">catch</strong> (Throwable t) { <em class="jxr_comment">// NOSONAR</em>
-<a class="jxr_linenumber" name="L897" href="#L897">897</a> <strong class="jxr_keyword">return</strong> cns(t) + <span class="jxr_string">": "</span> + t.getMessage();
-<a class="jxr_linenumber" name="L898" href="#L898">898</a> }
-<a class="jxr_linenumber" name="L899" href="#L899">899</a> }
-<a class="jxr_linenumber" name="L900" href="#L900">900</a>
-<a class="jxr_linenumber" name="L901" href="#L901">901</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L902" href="#L902">902</a> <em class="jxr_javadoccomment"> * Helper method for creating StringBuilder objects.</em>
-<a class="jxr_linenumber" name="L903" href="#L903">903</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L904" href="#L904">904</a> <em class="jxr_javadoccomment"> * @param value The string value to wrap in a StringBuilder.</em>
-<a class="jxr_linenumber" name="L905" href="#L905">905</a> <em class="jxr_javadoccomment"> * @return A new StringBuilder containing the specified value.</em>
-<a class="jxr_linenumber" name="L906" href="#L906">906</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L907" href="#L907">907</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder sb(String value) {
-<a class="jxr_linenumber" name="L908" href="#L908">908</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> StringBuilder(value);
-<a class="jxr_linenumber" name="L909" href="#L909">909</a> }
-<a class="jxr_linenumber" name="L910" href="#L910">910</a>
-<a class="jxr_linenumber" name="L911" href="#L911">911</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L912" href="#L912">912</a> <em class="jxr_javadoccomment"> * Converts a property name to an environment variable name.</em>
+<a class="jxr_linenumber" name="L860" href="#L860">860</a> <em class="jxr_javadoccomment"> * <jc>// Inner classes</jc></em>
+<a class="jxr_linenumber" name="L861" href="#L861">861</a> <em class="jxr_javadoccomment"> * scn(Map.Entry.<jk>class</jk>); <jc>// "Entry"</jc></em>
+<a class="jxr_linenumber" name="L862" href="#L862">862</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L863" href="#L863">863</a> <em class="jxr_javadoccomment"> * <jc>// Primitives</jc></em>
+<a class="jxr_linenumber" name="L864" href="#L864">864</a> <em class="jxr_javadoccomment"> * scn(<jk>int</jk>.<jk>class</jk>); <jc>// "int"</jc></em>
+<a class="jxr_linenumber" name="L865" href="#L865">865</a> <em class="jxr_javadoccomment"> * scn(<jk>boolean</jk>.<jk>class</jk>); <jc>// "boolean"</jc></em>
+<a class="jxr_linenumber" name="L866" href="#L866">866</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L867" href="#L867">867</a> <em class="jxr_javadoccomment"> * <jc>// Arrays</jc></em>
+<a class="jxr_linenumber" name="L868" href="#L868">868</a> <em class="jxr_javadoccomment"> * scn(String[].<jk>class</jk>); <jc>// "String[]"</jc></em>
+<a class="jxr_linenumber" name="L869" href="#L869">869</a> <em class="jxr_javadoccomment"> * scn(<jk>int</jk>[].<jk>class</jk>); <jc>// "int[]"</jc></em>
+<a class="jxr_linenumber" name="L870" href="#L870">870</a> <em class="jxr_javadoccomment"> * scn(String[][].<jk>class</jk>); <jc>// "String[][]"</jc></em>
+<a class="jxr_linenumber" name="L871" href="#L871">871</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L872" href="#L872">872</a> <em class="jxr_javadoccomment"> * <jc>// Null</jc></em>
+<a class="jxr_linenumber" name="L873" href="#L873">873</a> <em class="jxr_javadoccomment"> * scn(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L874" href="#L874">874</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L875" href="#L875">875</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L876" href="#L876">876</a> <em class="jxr_javadoccomment"> * @param value The object to get the simple class name for.</em>
+<a class="jxr_linenumber" name="L877" href="#L877">877</a> <em class="jxr_javadoccomment"> * @return The simple name of the class or <jk>null</jk> if the value was null.</em>
+<a class="jxr_linenumber" name="L878" href="#L878">878</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L879" href="#L879">879</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String cns(Object value) {
+<a class="jxr_linenumber" name="L880" href="#L880">880</a> <strong class="jxr_keyword">return</strong> ClassUtils.classNameSimple(value);
+<a class="jxr_linenumber" name="L881" href="#L881">881</a> }
+<a class="jxr_linenumber" name="L882" href="#L882">882</a>
+<a class="jxr_linenumber" name="L883" href="#L883">883</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L884" href="#L884">884</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link ClassUtils#classNameSimpleQualified(Object)}.</em>
+<a class="jxr_linenumber" name="L885" href="#L885">885</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L886" href="#L886">886</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L887" href="#L887">887</a> <em class="jxr_javadoccomment"> * Returns the simple class name including outer class names, but without the package.</em>
+<a class="jxr_linenumber" name="L888" href="#L888">888</a> <em class="jxr_javadoccomment"> * Inner class separators ($) are replaced with dots (.).</em>
+<a class="jxr_linenumber" name="L889" href="#L889">889</a> <em class="jxr_javadoccomment"> * Array types are properly formatted with brackets.</em>
+<a class="jxr_linenumber" name="L890" href="#L890">890</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L891" href="#L891">891</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L892" href="#L892">892</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L893" href="#L893">893</a> <em class="jxr_javadoccomment"> * <jc>// Regular classes</jc></em>
+<a class="jxr_linenumber" name="L894" href="#L894">894</a> <em class="jxr_javadoccomment"> * sqcn(String.<jk>class</jk>); <jc>// "String"</jc></em>
+<a class="jxr_linenumber" name="L895" href="#L895">895</a> <em class="jxr_javadoccomment"> * sqcn(<jk>new</jk> HashMap&lt;&gt;()); <jc>// "HashMap"</jc></em>
+<a class="jxr_linenumber" name="L896" href="#L896">896</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L897" href="#L897">897</a> <em class="jxr_javadoccomment"> * <jc>// Inner classes</jc></em>
+<a class="jxr_linenumber" name="L898" href="#L898">898</a> <em class="jxr_javadoccomment"> * sqcn(Map.Entry.<jk>class</jk>); <jc>// "Map.Entry"</jc></em>
+<a class="jxr_linenumber" name="L899" href="#L899">899</a> <em class="jxr_javadoccomment"> * sqcn(Outer.Inner.Deep.<jk>class</jk>); <jc>// "Outer.Inner.Deep"</jc></em>
+<a class="jxr_linenumber" name="L900" href="#L900">900</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L901" href="#L901">901</a> <em class="jxr_javadoccomment"> * <jc>// Primitives</jc></em>
+<a class="jxr_linenumber" name="L902" href="#L902">902</a> <em class="jxr_javadoccomment"> * sqcn(<jk>int</jk>.<jk>class</jk>); <jc>// "int"</jc></em>
+<a class="jxr_linenumber" name="L903" href="#L903">903</a> <em class="jxr_javadoccomment"> * sqcn(<jk>boolean</jk>.<jk>class</jk>); <jc>// "boolean"</jc></em>
+<a class="jxr_linenumber" name="L904" href="#L904">904</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L905" href="#L905">905</a> <em class="jxr_javadoccomment"> * <jc>// Object arrays</jc></em>
+<a class="jxr_linenumber" name="L906" href="#L906">906</a> <em class="jxr_javadoccomment"> * sqcn(String[].<jk>class</jk>); <jc>// "String[]"</jc></em>
+<a class="jxr_linenumber" name="L907" href="#L907">907</a> <em class="jxr_javadoccomment"> * sqcn(Map.Entry[].<jk>class</jk>); <jc>// "Map.Entry[]"</jc></em>
+<a class="jxr_linenumber" name="L908" href="#L908">908</a> <em class="jxr_javadoccomment"> * sqcn(String[][].<jk>class</jk>); <jc>// "String[][]"</jc></em>
+<a class="jxr_linenumber" name="L909" href="#L909">909</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L910" href="#L910">910</a> <em class="jxr_javadoccomment"> * <jc>// Primitive arrays</jc></em>
+<a class="jxr_linenumber" name="L911" href="#L911">911</a> <em class="jxr_javadoccomment"> * sqcn(<jk>int</jk>[].<jk>class</jk>); <jc>// "int[]"</jc></em>
+<a class="jxr_linenumber" name="L912" href="#L912">912</a> <em class="jxr_javadoccomment"> * sqcn(<jk>boolean</jk>[][].<jk>class</jk>); <jc>// "boolean[][]"</jc></em>
<a class="jxr_linenumber" name="L913" href="#L913">913</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L914" href="#L914">914</a> <em class="jxr_javadoccomment"> * @param name The property name to convert.</em>
-<a class="jxr_linenumber" name="L915" href="#L915">915</a> <em class="jxr_javadoccomment"> * @return The environment variable name (uppercase with dots replaced by underscores).</em>
-<a class="jxr_linenumber" name="L916" href="#L916">916</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L917" href="#L917">917</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> String envName(String name) {
-<a class="jxr_linenumber" name="L918" href="#L918">918</a> <strong class="jxr_keyword">return</strong> PROPERTY_TO_ENV.computeIfAbsent(name, x -> x.toUpperCase().replace(<span class="jxr_string">"."</span>, <span class="jxr_string">"_"</span>));
-<a class="jxr_linenumber" name="L919" href="#L919">919</a> }
-<a class="jxr_linenumber" name="L920" href="#L920">920</a>
-<a class="jxr_linenumber" name="L921" href="#L921">921</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L922" href="#L922">922</a> <em class="jxr_javadoccomment"> * Converts a string to the specified type using registered conversion functions.</em>
-<a class="jxr_linenumber" name="L923" href="#L923">923</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L924" href="#L924">924</a> <em class="jxr_javadoccomment"> * @param <T> The target type.</em>
-<a class="jxr_linenumber" name="L925" href="#L925">925</a> <em class="jxr_javadoccomment"> * @param s The string to convert.</em>
-<a class="jxr_linenumber" name="L926" href="#L926">926</a> <em class="jxr_javadoccomment"> * @param def The default value (used to determine the target type).</em>
-<a class="jxr_linenumber" name="L927" href="#L927">927</a> <em class="jxr_javadoccomment"> * @return The converted value, or <jk>null</jk> if the string or default is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L928" href="#L928">928</a> <em class="jxr_javadoccomment"> * @throws RuntimeException If the type is not supported for conversion.</em>
-<a class="jxr_linenumber" name="L929" href="#L929">929</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L930" href="#L930">930</a> @SuppressWarnings({ <span class="jxr_string">"unchecked"</span>, <span class="jxr_string">"rawtypes"</span> })
-<a class="jxr_linenumber" name="L931" href="#L931">931</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <T> T toType(String s, T def) {
-<a class="jxr_linenumber" name="L932" href="#L932">932</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || def == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L933" href="#L933">933</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L934" href="#L934">934</a> <strong class="jxr_keyword">var</strong> c = (Class<T>)def.getClass();
-<a class="jxr_linenumber" name="L935" href="#L935">935</a> <strong class="jxr_keyword">if</strong> (c == String.<strong class="jxr_keyword">class</strong>)
-<a class="jxr_linenumber" name="L936" href="#L936">936</a> <strong class="jxr_keyword">return</strong> (T)s;
-<a class="jxr_linenumber" name="L937" href="#L937">937</a> <strong class="jxr_keyword">if</strong> (c.isEnum())
-<a class="jxr_linenumber" name="L938" href="#L938">938</a> <strong class="jxr_keyword">return</strong> (T)Enum.valueOf((Class<? <strong class="jxr_keyword">extends</strong> Enum>)c, s);
-<a class="jxr_linenumber" name="L939" href="#L939">939</a> <strong class="jxr_keyword">var</strong> f = (Function<String,T>)ENV_FUNCTIONS.get(c);
-<a class="jxr_linenumber" name="L940" href="#L940">940</a> <strong class="jxr_keyword">if</strong> (f == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L941" href="#L941">941</a> <strong class="jxr_keyword">throw</strong> rex(<span class="jxr_string">"Invalid env type: {0}"</span>, c);
-<a class="jxr_linenumber" name="L942" href="#L942">942</a> <strong class="jxr_keyword">return</strong> f.apply(s);
-<a class="jxr_linenumber" name="L943" href="#L943">943</a> }
-<a class="jxr_linenumber" name="L944" href="#L944">944</a>
-<a class="jxr_linenumber" name="L945" href="#L945">945</a> <em class="jxr_javadoccomment">/** Constructor - This class is meant to be subclasses. */</em>
-<a class="jxr_linenumber" name="L946" href="#L946">946</a> <strong class="jxr_keyword">protected</strong> <a name="Utils" href="../../../../../org/apache/juneau/common/utils/Utils.html#Utils">Utils</a>() {}
-<a class="jxr_linenumber" name="L947" href="#L947">947</a>
-<a class="jxr_linenumber" name="L948" href="#L948">948</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L949" href="#L949">949</a> <em class="jxr_javadoccomment"> * If the specified object is a {@link Supplier} or {@link Value}, returns the inner value, otherwise the same value.</em>
-<a class="jxr_linenumber" name="L950" href="#L950">950</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L951" href="#L951">951</a> <em class="jxr_javadoccomment"> * @param o The object to unwrap.</em>
-<a class="jxr_linenumber" name="L952" href="#L952">952</a> <em class="jxr_javadoccomment"> * @return The unwrapped object.</em>
-<a class="jxr_linenumber" name="L953" href="#L953">953</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L954" href="#L954">954</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Object unwrap(Object o) {
-<a class="jxr_linenumber" name="L955" href="#L955">955</a> <strong class="jxr_keyword">if</strong> (o instanceof Supplier<?> o2)
-<a class="jxr_linenumber" name="L956" href="#L956">956</a> o = unwrap(o2.get());
-<a class="jxr_linenumber" name="L957" href="#L957">957</a> <strong class="jxr_keyword">if</strong> (o instanceof Value<?> o2)
-<a class="jxr_linenumber" name="L958" href="#L958">958</a> o = unwrap(o2.get());
-<a class="jxr_linenumber" name="L959" href="#L959">959</a> <strong class="jxr_keyword">if</strong> (o instanceof Optional<?> o2)
-<a class="jxr_linenumber" name="L960" href="#L960">960</a> o = unwrap(o2.orElse(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L961" href="#L961">961</a> <strong class="jxr_keyword">return</strong> o;
-<a class="jxr_linenumber" name="L962" href="#L962">962</a> }
-<a class="jxr_linenumber" name="L963" href="#L963">963</a>
-<a class="jxr_linenumber" name="L964" href="#L964">964</a> <em class="jxr_comment">// TODO: Look for cases of getClass().getName() and getClass().getSimpleName() in the code and replace with cn() and scn().</em>
-<a class="jxr_linenumber" name="L965" href="#L965">965</a> <em class="jxr_comment">// These utility methods provide cleaner, more concise syntax and null-safe handling.</em>
-<a class="jxr_linenumber" name="L966" href="#L966">966</a> <em class="jxr_comment">// Search patterns:</em>
-<a class="jxr_linenumber" name="L967" href="#L967">967</a> <em class="jxr_comment">// - Replace: getClass().getName() -> cn(this) or cn(object)</em>
-<a class="jxr_linenumber" name="L968" href="#L968">968</a> <em class="jxr_comment">// - Replace: getClass().getSimpleName() -> scn(this) or scn(object)</em>
-<a class="jxr_linenumber" name="L969" href="#L969">969</a> <em class="jxr_comment">// - Replace: obj.getClass().getName() -> cn(obj)</em>
-<a class="jxr_linenumber" name="L970" href="#L970">970</a> <em class="jxr_comment">// - Replace: obj.getClass().getSimpleName() -> scn(obj)</em>
-<a class="jxr_linenumber" name="L971" href="#L971">971</a>
-<a class="jxr_linenumber" name="L972" href="#L972">972</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L973" href="#L973">973</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link ClassUtils#className(Object)}.</em>
-<a class="jxr_linenumber" name="L974" href="#L974">974</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L975" href="#L975">975</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L976" href="#L976">976</a> <em class="jxr_javadoccomment"> * Returns the fully-qualified class name including the full package path.</em>
-<a class="jxr_linenumber" name="L977" href="#L977">977</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L978" href="#L978">978</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L979" href="#L979">979</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L980" href="#L980">980</a> <em class="jxr_javadoccomment"> * <jc>// Regular classes</jc></em>
-<a class="jxr_linenumber" name="L981" href="#L981">981</a> <em class="jxr_javadoccomment"> * cn(String.<jk>class</jk>); <jc>// "java.lang.String"</jc></em>
-<a class="jxr_linenumber" name="L982" href="#L982">982</a> <em class="jxr_javadoccomment"> * cn(<jk>new</jk> HashMap&lt;&gt;()); <jc>// "java.util.HashMap"</jc></em>
-<a class="jxr_linenumber" name="L983" href="#L983">983</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L984" href="#L984">984</a> <em class="jxr_javadoccomment"> * <jc>// Inner classes</jc></em>
-<a class="jxr_linenumber" name="L985" href="#L985">985</a> <em class="jxr_javadoccomment"> * cn(Map.Entry.<jk>class</jk>); <jc>// "java.util.Map$Entry"</jc></em>
-<a class="jxr_linenumber" name="L986" href="#L986">986</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L987" href="#L987">987</a> <em class="jxr_javadoccomment"> * <jc>// Primitives</jc></em>
-<a class="jxr_linenumber" name="L988" href="#L988">988</a> <em class="jxr_javadoccomment"> * cn(<jk>int</jk>.<jk>class</jk>); <jc>// "int"</jc></em>
-<a class="jxr_linenumber" name="L989" href="#L989">989</a> <em class="jxr_javadoccomment"> * cn(<jk>boolean</jk>.<jk>class</jk>); <jc>// "boolean"</jc></em>
-<a class="jxr_linenumber" name="L990" href="#L990">990</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L991" href="#L991">991</a> <em class="jxr_javadoccomment"> * <jc>// Arrays</jc></em>
-<a class="jxr_linenumber" name="L992" href="#L992">992</a> <em class="jxr_javadoccomment"> * cn(String[].<jk>class</jk>); <jc>// "[Ljava.lang.String;"</jc></em>
-<a class="jxr_linenumber" name="L993" href="#L993">993</a> <em class="jxr_javadoccomment"> * cn(<jk>int</jk>[].<jk>class</jk>); <jc>// "[I"</jc></em>
-<a class="jxr_linenumber" name="L994" href="#L994">994</a> <em class="jxr_javadoccomment"> * cn(String[][].<jk>class</jk>); <jc>// "[[Ljava.lang.String;"</jc></em>
-<a class="jxr_linenumber" name="L995" href="#L995">995</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L996" href="#L996">996</a> <em class="jxr_javadoccomment"> * <jc>// Null</jc></em>
-<a class="jxr_linenumber" name="L997" href="#L997">997</a> <em class="jxr_javadoccomment"> * cn(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L998" href="#L998">998</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L999" href="#L999">999</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1000" href="#L1000">1000</a> <em class="jxr_javadoccomment"> * @param value The object to get the class name for.</em>
-<a class="jxr_linenumber" name="L1001" href="#L1001">1001</a> <em class="jxr_javadoccomment"> * @return The name of the class or <jk>null</jk> if the value was null.</em>
-<a class="jxr_linenumber" name="L1002" href="#L1002">1002</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1003" href="#L1003">1003</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String cn(Object value) {
-<a class="jxr_linenumber" name="L1004" href="#L1004">1004</a> <strong class="jxr_keyword">return</strong> ClassUtils.className(value);
-<a class="jxr_linenumber" name="L1005" href="#L1005">1005</a> }
-<a class="jxr_linenumber" name="L1006" href="#L1006">1006</a>
-<a class="jxr_linenumber" name="L1007" href="#L1007">1007</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1008" href="#L1008">1008</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link ClassUtils#classNameSimple(Object)}.</em>
-<a class="jxr_linenumber" name="L1009" href="#L1009">1009</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1010" href="#L1010">1010</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1011" href="#L1011">1011</a> <em class="jxr_javadoccomment"> * Returns only the simple class name without any package or outer class information.</em>
-<a class="jxr_linenumber" name="L1012" href="#L1012">1012</a> <em class="jxr_javadoccomment"> * For inner classes, only the innermost class name is returned.</em>
-<a class="jxr_linenumber" name="L1013" href="#L1013">1013</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1014" href="#L1014">1014</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L1015" href="#L1015">1015</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1016" href="#L1016">1016</a> <em class="jxr_javadoccomment"> * <jc>// Regular classes</jc></em>
-<a class="jxr_linenumber" name="L1017" href="#L1017">1017</a> <em class="jxr_javadoccomment"> * scn(String.<jk>class</jk>); <jc>// "String"</jc></em>
-<a class="jxr_linenumber" name="L1018" href="#L1018">1018</a> <em class="jxr_javadoccomment"> * scn(<jk>new</jk> HashMap&lt;&gt;()); <jc>// "HashMap"</jc></em>
+<a class="jxr_linenumber" name="L914" href="#L914">914</a> <em class="jxr_javadoccomment"> * <jc>// Null</jc></em>
+<a class="jxr_linenumber" name="L915" href="#L915">915</a> <em class="jxr_javadoccomment"> * sqcn(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L916" href="#L916">916</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L917" href="#L917">917</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L918" href="#L918">918</a> <em class="jxr_javadoccomment"> * @param value The object to get the simple qualified class name for.</em>
+<a class="jxr_linenumber" name="L919" href="#L919">919</a> <em class="jxr_javadoccomment"> * @return The simple qualified name of the class or <jk>null</jk> if the value was null.</em>
+<a class="jxr_linenumber" name="L920" href="#L920">920</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L921" href="#L921">921</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String cnsq(Object value) {
+<a class="jxr_linenumber" name="L922" href="#L922">922</a> <strong class="jxr_keyword">return</strong> ClassUtils.classNameSimpleQualified(value);
+<a class="jxr_linenumber" name="L923" href="#L923">923</a> }
+<a class="jxr_linenumber" name="L924" href="#L924">924</a>
+<a class="jxr_linenumber" name="L925" href="#L925">925</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L926" href="#L926">926</a> <em class="jxr_javadoccomment"> * Converts an object to a boolean.</em>
+<a class="jxr_linenumber" name="L927" href="#L927">927</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L928" href="#L928">928</a> <em class="jxr_javadoccomment"> * @param val The object to convert.</em>
+<a class="jxr_linenumber" name="L929" href="#L929">929</a> <em class="jxr_javadoccomment"> * @return The boolean value, or <jk>false</jk> if the value was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L930" href="#L930">930</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L931" href="#L931">931</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> b(Object val) {
+<a class="jxr_linenumber" name="L932" href="#L932">932</a> <strong class="jxr_keyword">return</strong> opt(val).map(Object::toString).map(Boolean::valueOf).orElse(false);
+<a class="jxr_linenumber" name="L933" href="#L933">933</a> }
+<a class="jxr_linenumber" name="L934" href="#L934">934</a>
+<a class="jxr_linenumber" name="L935" href="#L935">935</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L936" href="#L936">936</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified number is inclusively between the two values.</em>
+<a class="jxr_linenumber" name="L937" href="#L937">937</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L938" href="#L938">938</a> <em class="jxr_javadoccomment"> * @param n The number to check.</em>
+<a class="jxr_linenumber" name="L939" href="#L939">939</a> <em class="jxr_javadoccomment"> * @param lower The lower bound (inclusive).</em>
+<a class="jxr_linenumber" name="L940" href="#L940">940</a> <em class="jxr_javadoccomment"> * @param higher The upper bound (inclusive).</em>
+<a class="jxr_linenumber" name="L941" href="#L941">941</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the number is between the bounds.</em>
+<a class="jxr_linenumber" name="L942" href="#L942">942</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L943" href="#L943">943</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isBetween(<strong class="jxr_keyword">int</strong> n, <strong class="jxr_keyword">int</strong> lower, <strong class="jxr_keyword">int</strong> higher) {
+<a class="jxr_linenumber" name="L944" href="#L944">944</a> <strong class="jxr_keyword">return</strong> n >= lower && n <= higher;
+<a class="jxr_linenumber" name="L945" href="#L945">945</a> }
+<a class="jxr_linenumber" name="L946" href="#L946">946</a>
+<a class="jxr_linenumber" name="L947" href="#L947">947</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L948" href="#L948">948</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link StringUtils#stringSupplier(Supplier)}.</em>
+<a class="jxr_linenumber" name="L949" href="#L949">949</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L950" href="#L950">950</a> <em class="jxr_javadoccomment"> * @param s The supplier.</em>
+<a class="jxr_linenumber" name="L951" href="#L951">951</a> <em class="jxr_javadoccomment"> * @return A string supplier that calls {@link #r(Object)} on the supplied value.</em>
+<a class="jxr_linenumber" name="L952" href="#L952">952</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L953" href="#L953">953</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Supplier<String> ss(Supplier<?> s) {
+<a class="jxr_linenumber" name="L954" href="#L954">954</a> <strong class="jxr_keyword">return</strong> stringSupplier(s);
+<a class="jxr_linenumber" name="L955" href="#L955">955</a> }
+<a class="jxr_linenumber" name="L956" href="#L956">956</a>
+<a class="jxr_linenumber" name="L957" href="#L957">957</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L958" href="#L958">958</a> <em class="jxr_javadoccomment"> * Creates a thread-safe memoizing supplier that computes a value once and caches it.</em>
+<a class="jxr_linenumber" name="L959" href="#L959">959</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L960" href="#L960">960</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L961" href="#L961">961</a> <em class="jxr_javadoccomment"> * The returned supplier is thread-safe and guarantees that the underlying supplier's {@link Supplier#get() get()}</em>
+<a class="jxr_linenumber" name="L962" href="#L962">962</a> <em class="jxr_javadoccomment"> * method is called at most once, even under concurrent access. The computed value is cached and returned</em>
+<a class="jxr_linenumber" name="L963" href="#L963">963</a> <em class="jxr_javadoccomment"> * on all subsequent calls.</em>
+<a class="jxr_linenumber" name="L964" href="#L964">964</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L965" href="#L965">965</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L966" href="#L966">966</a> <em class="jxr_javadoccomment"> * This is useful for lazy initialization of expensive-to-compute values that should only be calculated once.</em>
+<a class="jxr_linenumber" name="L967" href="#L967">967</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L968" href="#L968">968</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L969" href="#L969">969</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L970" href="#L970">970</a> <em class="jxr_javadoccomment"> * <jc>// Create a memoizing supplier</jc></em>
+<a class="jxr_linenumber" name="L971" href="#L971">971</a> <em class="jxr_javadoccomment"> * Supplier&lt;ExpensiveObject&gt; <jv>supplier</jv> = memoize(() -&gt; <jk>new</jk> ExpensiveObject());</em>
+<a class="jxr_linenumber" name="L972" href="#L972">972</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L973" href="#L973">973</a> <em class="jxr_javadoccomment"> * <jc>// First call computes and caches the value</jc></em>
+<a class="jxr_linenumber" name="L974" href="#L974">974</a> <em class="jxr_javadoccomment"> * ExpensiveObject <jv>obj1</jv> = <jv>supplier</jv>.get();</em>
+<a class="jxr_linenumber" name="L975" href="#L975">975</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L976" href="#L976">976</a> <em class="jxr_javadoccomment"> * <jc>// Subsequent calls return the cached value (no recomputation)</jc></em>
+<a class="jxr_linenumber" name="L977" href="#L977">977</a> <em class="jxr_javadoccomment"> * ExpensiveObject <jv>obj2</jv> = <jv>supplier</jv>.get(); <jc>// Same instance as obj1</jc></em>
+<a class="jxr_linenumber" name="L978" href="#L978">978</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L979" href="#L979">979</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L980" href="#L980">980</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Thread Safety:</h5></em>
+<a class="jxr_linenumber" name="L981" href="#L981">981</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L982" href="#L982">982</a> <em class="jxr_javadoccomment"> * The implementation uses {@link java.util.concurrent.atomic.AtomicReference} with double-checked locking</em>
+<a class="jxr_linenumber" name="L983" href="#L983">983</a> <em class="jxr_javadoccomment"> * to ensure thread-safe lazy initialization. Under high contention, multiple threads may compute the value,</em>
+<a class="jxr_linenumber" name="L984" href="#L984">984</a> <em class="jxr_javadoccomment"> * but only one result is stored and returned to all callers.</em>
+<a class="jxr_linenumber" name="L985" href="#L985">985</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L986" href="#L986">986</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Notes:</h5></em>
+<a class="jxr_linenumber" name="L987" href="#L987">987</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L988" href="#L988">988</a> <em class="jxr_javadoccomment"> * <li>The supplier may be called multiple times if threads race, but only one result is cached.</em>
+<a class="jxr_linenumber" name="L989" href="#L989">989</a> <em class="jxr_javadoccomment"> * <li>The cached value can be <jk>null</jk> if the supplier returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L990" href="#L990">990</a> <em class="jxr_javadoccomment"> * <li>Once cached, the value never changes (immutable after first computation).</em>
+<a class="jxr_linenumber" name="L991" href="#L991">991</a> <em class="jxr_javadoccomment"> * <li>The returned supplier does not support {@link #toString()}, {@link #equals(Object)}, or {@link #hashCode()}.</em>
+<a class="jxr_linenumber" name="L992" href="#L992">992</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L993" href="#L993">993</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L994" href="#L994">994</a> <em class="jxr_javadoccomment"> * @param <T> The type of value supplied.</em>
+<a class="jxr_linenumber" name="L995" href="#L995">995</a> <em class="jxr_javadoccomment"> * @param supplier The supplier to memoize. Must not be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L996" href="#L996">996</a> <em class="jxr_javadoccomment"> * @return A thread-safe memoizing wrapper around the supplier.</em>
+<a class="jxr_linenumber" name="L997" href="#L997">997</a> <em class="jxr_javadoccomment"> * @throws NullPointerException if supplier is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L998" href="#L998">998</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L999" href="#L999">999</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> Supplier<T> memoize(Supplier<T> supplier) {
+<a class="jxr_linenumber" name="L1000" href="#L1000">1000</a> assertArgNotNull(<span class="jxr_string">"supplier"</span>, supplier);
+<a class="jxr_linenumber" name="L1001" href="#L1001">1001</a>
+<a class="jxr_linenumber" name="L1002" href="#L1002">1002</a> <strong class="jxr_keyword">var</strong> cache = <strong class="jxr_keyword">new</strong> AtomicReference<Optional<T>>();
+<a class="jxr_linenumber" name="L1003" href="#L1003">1003</a>
+<a class="jxr_linenumber" name="L1004" href="#L1004">1004</a> <strong class="jxr_keyword">return</strong> () -> {
+<a class="jxr_linenumber" name="L1005" href="#L1005">1005</a> <strong class="jxr_keyword">var</strong> h = cache.get();
+<a class="jxr_linenumber" name="L1006" href="#L1006">1006</a> <strong class="jxr_keyword">if</strong> (h == <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="L1007" href="#L1007">1007</a> h = opt(supplier.get());
+<a class="jxr_linenumber" name="L1008" href="#L1008">1008</a> <strong class="jxr_keyword">if</strong> (! cache.compareAndSet(<strong class="jxr_keyword">null</strong>, h)) {
+<a class="jxr_linenumber" name="L1009" href="#L1009">1009</a> <em class="jxr_comment">// Another thread beat us, use their value</em>
+<a class="jxr_linenumber" name="L1010" href="#L1010">1010</a> h = cache.get();
+<a class="jxr_linenumber" name="L1011" href="#L1011">1011</a> }
+<a class="jxr_linenumber" name="L1012" href="#L1012">1012</a> }
+<a class="jxr_linenumber" name="L1013" href="#L1013">1013</a> <strong class="jxr_keyword">return</strong> h.orElse(<strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L1014" href="#L1014">1014</a> };
+<a class="jxr_linenumber" name="L1015" href="#L1015">1015</a> }
+<a class="jxr_linenumber" name="L1016" href="#L1016">1016</a>
+<a class="jxr_linenumber" name="L1017" href="#L1017">1017</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1018" href="#L1018">1018</a> <em class="jxr_javadoccomment"> * Creates a resettable memoizing supplier that caches the result of the first call and optionally allows resetting.</em>
<a class="jxr_linenumber" name="L1019" href="#L1019">1019</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1020" href="#L1020">1020</a> <em class="jxr_javadoccomment"> * <jc>// Inner classes</jc></em>
-<a class="jxr_linenumber" name="L1021" href="#L1021">1021</a> <em class="jxr_javadoccomment"> * scn(Map.Entry.<jk>class</jk>); <jc>// "Entry"</jc></em>
-<a class="jxr_linenumber" name="L1022" href="#L1022">1022</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1023" href="#L1023">1023</a> <em class="jxr_javadoccomment"> * <jc>// Primitives</jc></em>
-<a class="jxr_linenumber" name="L1024" href="#L1024">1024</a> <em class="jxr_javadoccomment"> * scn(<jk>int</jk>.<jk>class</jk>); <jc>// "int"</jc></em>
-<a class="jxr_linenumber" name="L1025" href="#L1025">1025</a> <em class="jxr_javadoccomment"> * scn(<jk>boolean</jk>.<jk>class</jk>); <jc>// "boolean"</jc></em>
-<a class="jxr_linenumber" name="L1026" href="#L1026">1026</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1027" href="#L1027">1027</a> <em class="jxr_javadoccomment"> * <jc>// Arrays</jc></em>
-<a class="jxr_linenumber" name="L1028" href="#L1028">1028</a> <em class="jxr_javadoccomment"> * scn(String[].<jk>class</jk>); <jc>// "String[]"</jc></em>
-<a class="jxr_linenumber" name="L1029" href="#L1029">1029</a> <em class="jxr_javadoccomment"> * scn(<jk>int</jk>[].<jk>class</jk>); <jc>// "int[]"</jc></em>
-<a class="jxr_linenumber" name="L1030" href="#L1030">1030</a> <em class="jxr_javadoccomment"> * scn(String[][].<jk>class</jk>); <jc>// "String[][]"</jc></em>
-<a class="jxr_linenumber" name="L1031" href="#L1031">1031</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1032" href="#L1032">1032</a> <em class="jxr_javadoccomment"> * <jc>// Null</jc></em>
-<a class="jxr_linenumber" name="L1033" href="#L1033">1033</a> <em class="jxr_javadoccomment"> * scn(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L1034" href="#L1034">1034</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1035" href="#L1035">1035</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1036" href="#L1036">1036</a> <em class="jxr_javadoccomment"> * @param value The object to get the simple class name for.</em>
-<a class="jxr_linenumber" name="L1037" href="#L1037">1037</a> <em class="jxr_javadoccomment"> * @return The simple name of the class or <jk>null</jk> if the value was null.</em>
-<a class="jxr_linenumber" name="L1038" href="#L1038">1038</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1039" href="#L1039">1039</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String cns(Object value) {
-<a class="jxr_linenumber" name="L1040" href="#L1040">1040</a> <strong class="jxr_keyword">return</strong> ClassUtils.classNameSimple(value);
-<a class="jxr_linenumber" name="L1041" href="#L1041">1041</a> }
-<a class="jxr_linenumber" name="L1042" href="#L1042">1042</a>
-<a class="jxr_linenumber" name="L1043" href="#L1043">1043</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1044" href="#L1044">1044</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link ClassUtils#classNameSimpleQualified(Object)}.</em>
-<a class="jxr_linenumber" name="L1045" href="#L1045">1045</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1046" href="#L1046">1046</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1047" href="#L1047">1047</a> <em class="jxr_javadoccomment"> * Returns the simple class name including outer class names, but without the package.</em>
-<a class="jxr_linenumber" name="L1048" href="#L1048">1048</a> <em class="jxr_javadoccomment"> * Inner class separators ($) are replaced with dots (.).</em>
-<a class="jxr_linenumber" name="L1049" href="#L1049">1049</a> <em class="jxr_javadoccomment"> * Array types are properly formatted with brackets.</em>
-<a class="jxr_linenumber" name="L1050" href="#L1050">1050</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1051" href="#L1051">1051</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L1052" href="#L1052">1052</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1053" href="#L1053">1053</a> <em class="jxr_javadoccomment"> * <jc>// Regular classes</jc></em>
-<a class="jxr_linenumber" name="L1054" href="#L1054">1054</a> <em class="jxr_javadoccomment"> * sqcn(String.<jk>class</jk>); <jc>// "String"</jc></em>
-<a class="jxr_linenumber" name="L1055" href="#L1055">1055</a> <em class="jxr_javadoccomment"> * sqcn(<jk>new</jk> HashMap&lt;&gt;()); <jc>// "HashMap"</jc></em>
-<a class="jxr_linenumber" name="L1056" href="#L1056">1056</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1057" href="#L1057">1057</a> <em class="jxr_javadoccomment"> * <jc>// Inner classes</jc></em>
-<a class="jxr_linenumber" name="L1058" href="#L1058">1058</a> <em class="jxr_javadoccomment"> * sqcn(Map.Entry.<jk>class</jk>); <jc>// "Map.Entry"</jc></em>
-<a class="jxr_linenumber" name="L1059" href="#L1059">1059</a> <em class="jxr_javadoccomment"> * sqcn(Outer.Inner.Deep.<jk>class</jk>); <jc>// "Outer.Inner.Deep"</jc></em>
-<a class="jxr_linenumber" name="L1060" href="#L1060">1060</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1061" href="#L1061">1061</a> <em class="jxr_javadoccomment"> * <jc>// Primitives</jc></em>
-<a class="jxr_linenumber" name="L1062" href="#L1062">1062</a> <em class="jxr_javadoccomment"> * sqcn(<jk>int</jk>.<jk>class</jk>); <jc>// "int"</jc></em>
-<a class="jxr_linenumber" name="L1063" href="#L1063">1063</a> <em class="jxr_javadoccomment"> * sqcn(<jk>boolean</jk>.<jk>class</jk>); <jc>// "boolean"</jc></em>
-<a class="jxr_linenumber" name="L1064" href="#L1064">1064</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1065" href="#L1065">1065</a> <em class="jxr_javadoccomment"> * <jc>// Object arrays</jc></em>
-<a class="jxr_linenumber" name="L1066" href="#L1066">1066</a> <em class="jxr_javadoccomment"> * sqcn(String[].<jk>class</jk>); <jc>// "String[]"</jc></em>
-<a class="jxr_linenumber" name="L1067" href="#L1067">1067</a> <em class="jxr_javadoccomment"> * sqcn(Map.Entry[].<jk>class</jk>); <jc>// "Map.Entry[]"</jc></em>
-<a class="jxr_linenumber" name="L1068" href="#L1068">1068</a> <em class="jxr_javadoccomment"> * sqcn(String[][].<jk>class</jk>); <jc>// "String[][]"</jc></em>
-<a class="jxr_linenumber" name="L1069" href="#L1069">1069</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1070" href="#L1070">1070</a> <em class="jxr_javadoccomment"> * <jc>// Primitive arrays</jc></em>
-<a class="jxr_linenumber" name="L1071" href="#L1071">1071</a> <em class="jxr_javadoccomment"> * sqcn(<jk>int</jk>[].<jk>class</jk>); <jc>// "int[]"</jc></em>
-<a class="jxr_linenumber" name="L1072" href="#L1072">1072</a> <em class="jxr_javadoccomment"> * sqcn(<jk>boolean</jk>[][].<jk>class</jk>); <jc>// "boolean[][]"</jc></em>
-<a class="jxr_linenumber" name="L1073" href="#L1073">1073</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1074" href="#L1074">1074</a> <em class="jxr_javadoccomment"> * <jc>// Null</jc></em>
-<a class="jxr_linenumber" name="L1075" href="#L1075">1075</a> <em class="jxr_javadoccomment"> * sqcn(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L1076" href="#L1076">1076</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1077" href="#L1077">1077</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1078" href="#L1078">1078</a> <em class="jxr_javadoccomment"> * @param value The object to get the simple qualified class name for.</em>
-<a class="jxr_linenumber" name="L1079" href="#L1079">1079</a> <em class="jxr_javadoccomment"> * @return The simple qualified name of the class or <jk>null</jk> if the value was null.</em>
-<a class="jxr_linenumber" name="L1080" href="#L1080">1080</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1081" href="#L1081">1081</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String cnsq(Object value) {
-<a class="jxr_linenumber" name="L1082" href="#L1082">1082</a> <strong class="jxr_keyword">return</strong> ClassUtils.classNameSimpleQualified(value);
-<a class="jxr_linenumber" name="L1083" href="#L1083">1083</a> }
-<a class="jxr_linenumber" name="L1084" href="#L1084">1084</a>
-<a class="jxr_linenumber" name="L1085" href="#L1085">1085</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1086" href="#L1086">1086</a> <em class="jxr_javadoccomment"> * Converts an object to a boolean.</em>
-<a class="jxr_linenumber" name="L1087" href="#L1087">1087</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1088" href="#L1088">1088</a> <em class="jxr_javadoccomment"> * @param val The object to convert.</em>
-<a class="jxr_linenumber" name="L1089" href="#L1089">1089</a> <em class="jxr_javadoccomment"> * @return The boolean value, or <jk>false</jk> if the value was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1090" href="#L1090">1090</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1091" href="#L1091">1091</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> b(Object val) {
-<a class="jxr_linenumber" name="L1092" href="#L1092">1092</a> <strong class="jxr_keyword">return</strong> opt(val).map(Object::toString).map(Boolean::valueOf).orElse(false);
-<a class="jxr_linenumber" name="L1093" href="#L1093">1093</a> }
-<a class="jxr_linenumber" name="L1094" href="#L1094">1094</a>
-<a class="jxr_linenumber" name="L1095" href="#L1095">1095</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1096" href="#L1096">1096</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified number is inclusively between the two values.</em>
-<a class="jxr_linenumber" name="L1097" href="#L1097">1097</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1098" href="#L1098">1098</a> <em class="jxr_javadoccomment"> * @param n The number to check.</em>
-<a class="jxr_linenumber" name="L1099" href="#L1099">1099</a> <em class="jxr_javadoccomment"> * @param lower The lower bound (inclusive).</em>
-<a class="jxr_linenumber" name="L1100" href="#L1100">1100</a> <em class="jxr_javadoccomment"> * @param higher The upper bound (inclusive).</em>
-<a class="jxr_linenumber" name="L1101" href="#L1101">1101</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the number is between the bounds.</em>
-<a class="jxr_linenumber" name="L1102" href="#L1102">1102</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1103" href="#L1103">1103</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isBetween(<strong class="jxr_keyword">int</strong> n, <strong class="jxr_keyword">int</strong> lower, <strong class="jxr_keyword">int</strong> higher) {
-<a class="jxr_linenumber" name="L1104" href="#L1104">1104</a> <strong class="jxr_keyword">return</strong> n >= lower && n <= higher;
-<a class="jxr_linenumber" name="L1105" href="#L1105">1105</a> }
-<a class="jxr_linenumber" name="L1106" href="#L1106">1106</a>
-<a class="jxr_linenumber" name="L1107" href="#L1107">1107</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1108" href="#L1108">1108</a> <em class="jxr_javadoccomment"> * Same as {@link Integer#parseInt(String)} but removes any underscore characters first.</em>
-<a class="jxr_linenumber" name="L1109" href="#L1109">1109</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1110" href="#L1110">1110</a> <em class="jxr_javadoccomment"> * <p>Allows for better readability of numeric literals (e.g., <js>"1_000_000"</js>).</em>
-<a class="jxr_linenumber" name="L1111" href="#L1111">1111</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1112" href="#L1112">1112</a> <em class="jxr_javadoccomment"> * @param value The string to parse.</em>
-<a class="jxr_linenumber" name="L1113" href="#L1113">1113</a> <em class="jxr_javadoccomment"> * @return The parsed integer value.</em>
-<a class="jxr_linenumber" name="L1114" href="#L1114">1114</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the string cannot be parsed.</em>
-<a class="jxr_linenumber" name="L1115" href="#L1115">1115</a> <em class="jxr_javadoccomment"> * @throws NullPointerException If the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1116" href="#L1116">1116</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1117" href="#L1117">1117</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> parseInt(String value) {
-<a class="jxr_linenumber" name="L1118" href="#L1118">1118</a> <strong class="jxr_keyword">return</strong> Integer.parseInt(removeUnderscores(value));
-<a class="jxr_linenumber" name="L1119" href="#L1119">1119</a> }
-<a class="jxr_linenumber" name="L1120" href="#L1120">1120</a>
-<a class="jxr_linenumber" name="L1121" href="#L1121">1121</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1122" href="#L1122">1122</a> <em class="jxr_javadoccomment"> * Same as {@link Long#parseLong(String)} but removes any underscore characters first.</em>
-<a class="jxr_linenumber" name="L1123" href="#L1123">1123</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1124" href="#L1124">1124</a> <em class="jxr_javadoccomment"> * <p>Allows for better readability of numeric literals (e.g., <js>"1_000_000"</js>).</em>
-<a class="jxr_linenumber" name="L1125" href="#L1125">1125</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1126" href="#L1126">1126</a> <em class="jxr_javadoccomment"> * @param value The string to parse.</em>
-<a class="jxr_linenumber" name="L1127" href="#L1127">1127</a> <em class="jxr_javadoccomment"> * @return The parsed long value.</em>
-<a class="jxr_linenumber" name="L1128" href="#L1128">1128</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the string cannot be parsed.</em>
-<a class="jxr_linenumber" name="L1129" href="#L1129">1129</a> <em class="jxr_javadoccomment"> * @throws NullPointerException If the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1130" href="#L1130">1130</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1131" href="#L1131">1131</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> parseLong(String value) {
-<a class="jxr_linenumber" name="L1132" href="#L1132">1132</a> <strong class="jxr_keyword">return</strong> Long.parseLong(removeUnderscores(value));
-<a class="jxr_linenumber" name="L1133" href="#L1133">1133</a> }
-<a class="jxr_linenumber" name="L1134" href="#L1134">1134</a>
-<a class="jxr_linenumber" name="L1135" href="#L1135">1135</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1136" href="#L1136">1136</a> <em class="jxr_javadoccomment"> * Same as {@link Float#parseFloat(String)} but removes any underscore characters first.</em>
-<a class="jxr_linenumber" name="L1137" href="#L1137">1137</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1138" href="#L1138">1138</a> <em class="jxr_javadoccomment"> * <p>Allows for better readability of numeric literals (e.g., <js>"1_000.5"</js>).</em>
-<a class="jxr_linenumber" name="L1139" href="#L1139">1139</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1140" href="#L1140">1140</a> <em class="jxr_javadoccomment"> * @param value The string to parse.</em>
-<a class="jxr_linenumber" name="L1141" href="#L1141">1141</a> <em class="jxr_javadoccomment"> * @return The parsed float value.</em>
-<a class="jxr_linenumber" name="L1142" href="#L1142">1142</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the string cannot be parsed.</em>
-<a class="jxr_linenumber" name="L1143" href="#L1143">1143</a> <em class="jxr_javadoccomment"> * @throws NullPointerException If the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1144" href="#L1144">1144</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1145" href="#L1145">1145</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">float</strong> parseFloat(String value) {
-<a class="jxr_linenumber" name="L1146" href="#L1146">1146</a> <strong class="jxr_keyword">return</strong> Float.parseFloat(removeUnderscores(value));
-<a class="jxr_linenumber" name="L1147" href="#L1147">1147</a> }
-<a class="jxr_linenumber" name="L1148" href="#L1148">1148</a>
-<a class="jxr_linenumber" name="L1149" href="#L1149">1149</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> String removeUnderscores(String value) {
-<a class="jxr_linenumber" name="L1150" href="#L1150">1150</a> <strong class="jxr_keyword">if</strong> (value == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1151" href="#L1151">1151</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NullPointerException(<span class="jxr_string">"Trying to parse null string."</span>);
-<a class="jxr_linenumber" name="L1152" href="#L1152">1152</a> <strong class="jxr_keyword">return</strong> notContains(value, '_') ? value : value.replace(<span class="jxr_string">"_"</span>, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L1153" href="#L1153">1153</a> }
-<a class="jxr_linenumber" name="L1154" href="#L1154">1154</a>
-<a class="jxr_linenumber" name="L1155" href="#L1155">1155</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1156" href="#L1156">1156</a> <em class="jxr_javadoccomment"> * Shortcut for calling {@link StringUtils#stringSupplier(Supplier)}.</em>
-<a class="jxr_linenumber" name="L1157" href="#L1157">1157</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1158" href="#L1158">1158</a> <em class="jxr_javadoccomment"> * @param s The supplier.</em>
-<a class="jxr_linenumber" name="L1159" href="#L1159">1159</a> <em class="jxr_javadoccomment"> * @return A string supplier that calls {@link #r(Object)} on the supplied value.</em>
-<a class="jxr_linenumber" name="L1160" href="#L1160">1160</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1161" href="#L1161">1161</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Supplier<String> ss(Supplier<?> s) {
-<a class="jxr_linenumber" name="L1162" href="#L1162">1162</a> <strong class="jxr_keyword">return</strong> stringSupplier(s);
-<a class="jxr_linenumber" name="L1163" href="#L1163">1163</a> }
-<a class="jxr_linenumber" name="L1164" href="#L1164">1164</a>
-<a class="jxr_linenumber" name="L1165" href="#L1165">1165</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1166" href="#L1166">1166</a> <em class="jxr_javadoccomment"> * Creates a thread-safe memoizing supplier that computes a value once and caches it.</em>
-<a class="jxr_linenumber" name="L1167" href="#L1167">1167</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1168" href="#L1168">1168</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1169" href="#L1169">1169</a> <em class="jxr_javadoccomment"> * The returned supplier is thread-safe and guarantees that the underlying supplier's {@link Supplier#get() get()}</em>
-<a class="jxr_linenumber" name="L1170" href="#L1170">1170</a> <em class="jxr_javadoccomment"> * method is called at most once, even under concurrent access. The computed value is cached and returned</em>
-<a class="jxr_linenumber" name="L1171" href="#L1171">1171</a> <em class="jxr_javadoccomment"> * on all subsequent calls.</em>
-<a class="jxr_linenumber" name="L1172" href="#L1172">1172</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1173" href="#L1173">1173</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1174" href="#L1174">1174</a> <em class="jxr_javadoccomment"> * This is useful for lazy initialization of expensive-to-compute values that should only be calculated once.</em>
-<a class="jxr_linenumber" name="L1175" href="#L1175">1175</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1176" href="#L1176">1176</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1177" href="#L1177">1177</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1178" href="#L1178">1178</a> <em class="jxr_javadoccomment"> * <jc>// Create a memoizing supplier</jc></em>
-<a class="jxr_linenumber" name="L1179" href="#L1179">1179</a> <em class="jxr_javadoccomment"> * Supplier&lt;ExpensiveObject&gt; <jv>supplier</jv> = memoize(() -&gt; <jk>new</jk> ExpensiveObject());</em>
-<a class="jxr_linenumber" name="L1180" href="#L1180">1180</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1181" href="#L1181">1181</a> <em class="jxr_javadoccomment"> * <jc>// First call computes and caches the value</jc></em>
-<a class="jxr_linenumber" name="L1182" href="#L1182">1182</a> <em class="jxr_javadoccomment"> * ExpensiveObject <jv>obj1</jv> = <jv>supplier</jv>.get();</em>
-<a class="jxr_linenumber" name="L1183" href="#L1183">1183</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1184" href="#L1184">1184</a> <em class="jxr_javadoccomment"> * <jc>// Subsequent calls return the cached value (no recomputation)</jc></em>
-<a class="jxr_linenumber" name="L1185" href="#L1185">1185</a> <em class="jxr_javadoccomment"> * ExpensiveObject <jv>obj2</jv> = <jv>supplier</jv>.get(); <jc>// Same instance as obj1</jc></em>
-<a class="jxr_linenumber" name="L1186" href="#L1186">1186</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1187" href="#L1187">1187</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1188" href="#L1188">1188</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Thread Safety:</h5></em>
-<a class="jxr_linenumber" name="L1189" href="#L1189">1189</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1190" href="#L1190">1190</a> <em class="jxr_javadoccomment"> * The implementation uses {@link java.util.concurrent.atomic.AtomicReference} with double-checked locking</em>
-<a class="jxr_linenumber" name="L1191" href="#L1191">1191</a> <em class="jxr_javadoccomment"> * to ensure thread-safe lazy initialization. Under high contention, multiple threads may compute the value,</em>
-<a class="jxr_linenumber" name="L1192" href="#L1192">1192</a> <em class="jxr_javadoccomment"> * but only one result is stored and returned to all callers.</em>
-<a class="jxr_linenumber" name="L1193" href="#L1193">1193</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1194" href="#L1194">1194</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Notes:</h5></em>
-<a class="jxr_linenumber" name="L1195" href="#L1195">1195</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1196" href="#L1196">1196</a> <em class="jxr_javadoccomment"> * <li>The supplier may be called multiple times if threads race, but only one result is cached.</em>
-<a class="jxr_linenumber" name="L1197" href="#L1197">1197</a> <em class="jxr_javadoccomment"> * <li>The cached value can be <jk>null</jk> if the supplier returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1198" href="#L1198">1198</a> <em class="jxr_javadoccomment"> * <li>Once cached, the value never changes (immutable after first computation).</em>
-<a class="jxr_linenumber" name="L1199" href="#L1199">1199</a> <em class="jxr_javadoccomment"> * <li>The returned supplier does not support {@link #toString()}, {@link #equals(Object)}, or {@link #hashCode()}.</em>
-<a class="jxr_linenumber" name="L1200" href="#L1200">1200</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1201" href="#L1201">1201</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1202" href="#L1202">1202</a> <em class="jxr_javadoccomment"> * @param <T> The type of value supplied.</em>
-<a class="jxr_linenumber" name="L1203" href="#L1203">1203</a> <em class="jxr_javadoccomment"> * @param supplier The supplier to memoize. Must not be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1204" href="#L1204">1204</a> <em class="jxr_javadoccomment"> * @return A thread-safe memoizing wrapper around the supplier.</em>
-<a class="jxr_linenumber" name="L1205" href="#L1205">1205</a> <em class="jxr_javadoccomment"> * @throws NullPointerException if supplier is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1206" href="#L1206">1206</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1207" href="#L1207">1207</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> Supplier<T> memoize(Supplier<T> supplier) {
-<a class="jxr_linenumber" name="L1208" href="#L1208">1208</a> assertArgNotNull(<span class="jxr_string">"supplier"</span>, supplier);
-<a class="jxr_linenumber" name="L1209" href="#L1209">1209</a>
-<a class="jxr_linenumber" name="L1210" href="#L1210">1210</a> <strong class="jxr_keyword">var</strong> cache = <strong class="jxr_keyword">new</strong> AtomicReference<Optional<T>>();
-<a class="jxr_linenumber" name="L1211" href="#L1211">1211</a>
-<a class="jxr_linenumber" name="L1212" href="#L1212">1212</a> <strong class="jxr_keyword">return</strong> () -> {
-<a class="jxr_linenumber" name="L1213" href="#L1213">1213</a> <strong class="jxr_keyword">var</strong> h = cache.get();
-<a class="jxr_linenumber" name="L1214" href="#L1214">1214</a> <strong class="jxr_keyword">if</strong> (h == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="L1215" href="#L1215">1215</a> h = opt(supplier.get());
-<a class="jxr_linenumber" name="L1216" href="#L1216">1216</a> <strong class="jxr_keyword">if</strong> (! cache.compareAndSet(<strong class="jxr_keyword">null</strong>, h)) {
-<a class="jxr_linenumber" name="L1217" href="#L1217">1217</a> <em class="jxr_comment">// Another thread beat us, use their value</em>
-<a class="jxr_linenumber" name="L1218" href="#L1218">1218</a> h = cache.get();
-<a class="jxr_linenumber" name="L1219" href="#L1219">1219</a> }
-<a class="jxr_linenumber" name="L1220" href="#L1220">1220</a> }
-<a class="jxr_linenumber" name="L1221" href="#L1221">1221</a> <strong class="jxr_keyword">return</strong> h.orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L1222" href="#L1222">1222</a> };
-<a class="jxr_linenumber" name="L1223" href="#L1223">1223</a> }
-<a class="jxr_linenumber" name="L1224" href="#L1224">1224</a>
-<a class="jxr_linenumber" name="L1225" href="#L1225">1225</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1226" href="#L1226">1226</a> <em class="jxr_javadoccomment"> * Creates a resettable memoizing supplier that caches the result of the first call and optionally allows resetting.</em>
-<a class="jxr_linenumber" name="L1227" href="#L1227">1227</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1228" href="#L1228">1228</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1229" href="#L1229">1229</a> <em class="jxr_javadoccomment"> * This is similar to {@link #memoize(Supplier)}, but returns a {@link ResettableSupplier} that supports</em>
-<a class="jxr_linenumber" name="L1230" href="#L1230">1230</a> <em class="jxr_javadoccomment"> * clearing the cached value, forcing recomputation on the next call.</em>
-<a class="jxr_linenumber" name="L1231" href="#L1231">1231</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1232" href="#L1232">1232</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Usage:</h5></em>
-<a class="jxr_linenumber" name="L1233" href="#L1233">1233</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1234" href="#L1234">1234</a> <em class="jxr_javadoccomment"> * ResettableSupplier&lt;String&gt; <jv>supplier</jv> = Utils.<jsm>memoizeResettable</jsm>(() -&gt; expensiveComputation());</em>
-<a class="jxr_linenumber" name="L1235" href="#L1235">1235</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1236" href="#L1236">1236</a> <em class="jxr_javadoccomment"> * <jc>// First call computes and caches</jc></em>
-<a class="jxr_linenumber" name="L1237" href="#L1237">1237</a> <em class="jxr_javadoccomment"> * String <jv>result1</jv> = <jv>supplier</jv>.get();</em>
-<a class="jxr_linenumber" name="L1238" href="#L1238">1238</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1239" href="#L1239">1239</a> <em class="jxr_javadoccomment"> * <jc>// Subsequent calls return cached value</jc></em>
-<a class="jxr_linenumber" name="L1240" href="#L1240">1240</a> <em class="jxr_javadoccomment"> * String <jv>result2</jv> = <jv>supplier</jv>.get();</em>
-<a class="jxr_linenumber" name="L1241" href="#L1241">1241</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1242" href="#L1242">1242</a> <em class="jxr_javadoccomment"> * <jc>// Reset forces recomputation on next get()</jc></em>
-<a class="jxr_linenumber" name="L1243" href="#L1243">1243</a> <em class="jxr_javadoccomment"> * <jv>supplier</jv>.reset();</em>
-<a class="jxr_linenumber" name="L1244" href="#L1244">1244</a> <em class="jxr_javadoccomment"> * String <jv>result3</jv> = <jv>supplier</jv>.get(); <jc>// Recomputes</jc></em>
-<a class="jxr_linenumber" name="L1245" href="#L1245">1245</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1246" href="#L1246">1246</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1247" href="#L1247">1247</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Thread Safety:</h5></em>
-<a class="jxr_linenumber" name="L1248" href="#L1248">1248</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1249" href="#L1249">1249</a> <em class="jxr_javadoccomment"> * The returned supplier is thread-safe for both {@link ResettableSupplier#get()} and</em>
-<a class="jxr_linenumber" name="L1250" href="#L1250">1250</a> <em class="jxr_javadoccomment"> * {@link ResettableSupplier#reset()} operations. If multiple threads call get() simultaneously</em>
-<a class="jxr_linenumber" name="L1251" href="#L1251">1251</a> <em class="jxr_javadoccomment"> * after a reset, the supplier may be invoked multiple times, but only one result will be cached.</em>
-<a class="jxr_linenumber" name="L1252" href="#L1252">1252</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1253" href="#L1253">1253</a> <em class="jxr_javadoccomment"> * <h5 class='section'>See Also:</h5></em>
-<a class="jxr_linenumber" name="L1254" href="#L1254">1254</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1255" href="#L1255">1255</a> <em class="jxr_javadoccomment"> * <li class='jc'>{@link ResettableSupplier}</em>
-<a class="jxr_linenumber" name="L1256" href="#L1256">1256</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1257" href="#L1257">1257</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1258" href="#L1258">1258</a> <em class="jxr_javadoccomment"> * @param <T> The type of value supplied.</em>
-<a class="jxr_linenumber" name="L1259" href="#L1259">1259</a> <em class="jxr_javadoccomment"> * @param supplier The supplier to memoize. Must not be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1260" href="#L1260">1260</a> <em class="jxr_javadoccomment"> * @return A thread-safe resettable memoizing wrapper around the supplier.</em>
-<a class="jxr_linenumber" name="L1261" href="#L1261">1261</a> <em class="jxr_javadoccomment"> * @throws NullPointerException if supplier is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1262" href="#L1262">1262</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1263" href="#L1263">1263</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> ResettableSupplier<T> memoizeResettable(Supplier<T> supplier) {
-<a class="jxr_linenumber" name="L1264" href="#L1264">1264</a> assertArgNotNull(<span class="jxr_string">"supplier"</span>, supplier);
-<a class="jxr_linenumber" name="L1265" href="#L1265">1265</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> ResettableSupplier<>(supplier);
-<a class="jxr_linenumber" name="L1266" href="#L1266">1266</a> }
-<a class="jxr_linenumber" name="L1267" href="#L1267">1267</a>
-<a class="jxr_linenumber" name="L1268" href="#L1268">1268</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1269" href="#L1269">1269</a> <em class="jxr_javadoccomment"> * Converts the specified object into an identifiable string of the form "Class[identityHashCode]"</em>
-<a class="jxr_linenumber" name="L1270" href="#L1270">1270</a> <em class="jxr_javadoccomment"> * @param o The object to convert to a string.</em>
-<a class="jxr_linenumber" name="L1271" href="#L1271">1271</a> <em class="jxr_javadoccomment"> * @return An identity string.</em>
-<a class="jxr_linenumber" name="L1272" href="#L1272">1272</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1273" href="#L1273">1273</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String identity(Object o) {
-<a class="jxr_linenumber" name="L1274" href="#L1274">1274</a> <strong class="jxr_keyword">if</strong> (o instanceof Optional<?> opt)
-<a class="jxr_linenumber" name="L1275" href="#L1275">1275</a> o = opt.orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L1276" href="#L1276">1276</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1277" href="#L1277">1277</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1278" href="#L1278">1278</a> <strong class="jxr_keyword">return</strong> cnsq(o) + <span class="jxr_string">"@"</span> + System.identityHashCode(o);
-<a class="jxr_linenumber" name="L1279" href="#L1279">1279</a> }
-<a class="jxr_linenumber" name="L1280" href="#L1280">1280</a> }
+<a class="jxr_linenumber" name="L1020" href="#L1020">1020</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1021" href="#L1021">1021</a> <em class="jxr_javadoccomment"> * This is similar to {@link #memoize(Supplier)}, but returns a {@link ResettableSupplier} that supports</em>
+<a class="jxr_linenumber" name="L1022" href="#L1022">1022</a> <em class="jxr_javadoccomment"> * clearing the cached value, forcing recomputation on the next call.</em>
+<a class="jxr_linenumber" name="L1023" href="#L1023">1023</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1024" href="#L1024">1024</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Usage:</h5></em>
+<a class="jxr_linenumber" name="L1025" href="#L1025">1025</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1026" href="#L1026">1026</a> <em class="jxr_javadoccomment"> * ResettableSupplier&lt;String&gt; <jv>supplier</jv> = Utils.<jsm>memoizeResettable</jsm>(() -&gt; expensiveComputation());</em>
+<a class="jxr_linenumber" name="L1027" href="#L1027">1027</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1028" href="#L1028">1028</a> <em class="jxr_javadoccomment"> * <jc>// First call computes and caches</jc></em>
+<a class="jxr_linenumber" name="L1029" href="#L1029">1029</a> <em class="jxr_javadoccomment"> * String <jv>result1</jv> = <jv>supplier</jv>.get();</em>
+<a class="jxr_linenumber" name="L1030" href="#L1030">1030</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1031" href="#L1031">1031</a> <em class="jxr_javadoccomment"> * <jc>// Subsequent calls return cached value</jc></em>
+<a class="jxr_linenumber" name="L1032" href="#L1032">1032</a> <em class="jxr_javadoccomment"> * String <jv>result2</jv> = <jv>supplier</jv>.get();</em>
+<a class="jxr_linenumber" name="L1033" href="#L1033">1033</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1034" href="#L1034">1034</a> <em class="jxr_javadoccomment"> * <jc>// Reset forces recomputation on next get()</jc></em>
+<a class="jxr_linenumber" name="L1035" href="#L1035">1035</a> <em class="jxr_javadoccomment"> * <jv>supplier</jv>.reset();</em>
+<a class="jxr_linenumber" name="L1036" href="#L1036">1036</a> <em class="jxr_javadoccomment"> * String <jv>result3</jv> = <jv>supplier</jv>.get(); <jc>// Recomputes</jc></em>
+<a class="jxr_linenumber" name="L1037" href="#L1037">1037</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1038" href="#L1038">1038</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1039" href="#L1039">1039</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Thread Safety:</h5></em>
+<a class="jxr_linenumber" name="L1040" href="#L1040">1040</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1041" href="#L1041">1041</a> <em class="jxr_javadoccomment"> * The returned supplier is thread-safe for both {@link ResettableSupplier#get()} and</em>
+<a class="jxr_linenumber" name="L1042" href="#L1042">1042</a> <em class="jxr_javadoccomment"> * {@link ResettableSupplier#reset()} operations. If multiple threads call get() simultaneously</em>
+<a class="jxr_linenumber" name="L1043" href="#L1043">1043</a> <em class="jxr_javadoccomment"> * after a reset, the supplier may be invoked multiple times, but only one result will be cached.</em>
+<a class="jxr_linenumber" name="L1044" href="#L1044">1044</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1045" href="#L1045">1045</a> <em class="jxr_javadoccomment"> * <h5 class='section'>See Also:</h5></em>
+<a class="jxr_linenumber" name="L1046" href="#L1046">1046</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L1047" href="#L1047">1047</a> <em class="jxr_javadoccomment"> * <li class='jc'>{@link ResettableSupplier}</em>
+<a class="jxr_linenumber" name="L1048" href="#L1048">1048</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L1049" href="#L1049">1049</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1050" href="#L1050">1050</a> <em class="jxr_javadoccomment"> * @param <T> The type of value supplied.</em>
+<a class="jxr_linenumber" name="L1051" href="#L1051">1051</a> <em class="jxr_javadoccomment"> * @param supplier The supplier to memoize. Must not be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1052" href="#L1052">1052</a> <em class="jxr_javadoccomment"> * @return A thread-safe resettable memoizing wrapper around the supplier.</em>
+<a class="jxr_linenumber" name="L1053" href="#L1053">1053</a> <em class="jxr_javadoccomment"> * @throws NullPointerException if supplier is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1054" href="#L1054">1054</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1055" href="#L1055">1055</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <T> ResettableSupplier<T> memoizeResettable(Supplier<T> supplier) {
+<a class="jxr_linenumber" name="L1056" href="#L1056">1056</a> assertArgNotNull(<span class="jxr_string">"supplier"</span>, supplier);
+<a class="jxr_linenumber" name="L1057" href="#L1057">1057</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> ResettableSupplier<>(supplier);
+<a class="jxr_linenumber" name="L1058" href="#L1058">1058</a> }
+<a class="jxr_linenumber" name="L1059" href="#L1059">1059</a>
+<a class="jxr_linenumber" name="L1060" href="#L1060">1060</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1061" href="#L1061">1061</a> <em class="jxr_javadoccomment"> * Converts the specified object into an identifiable string of the form "Class[identityHashCode]"</em>
+<a class="jxr_linenumber" name="L1062" href="#L1062">1062</a> <em class="jxr_javadoccomment"> * @param o The object to convert to a string.</em>
+<a class="jxr_linenumber" name="L1063" href="#L1063">1063</a> <em class="jxr_javadoccomment"> * @return An identity string.</em>
+<a class="jxr_linenumber" name="L1064" href="#L1064">1064</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1065" href="#L1065">1065</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String identity(Object o) {
+<a class="jxr_linenumber" name="L1066" href="#L1066">1066</a> <strong class="jxr_keyword">if</strong> (o instanceof Optional<?> opt)
+<a class="jxr_linenumber" name="L1067" href="#L1067">1067</a> o = opt.orElse(<strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L1068" href="#L1068">1068</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1069" href="#L1069">1069</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L1070" href="#L1070">1070</a> <strong class="jxr_keyword">return</strong> cnsq(o) + <span class="jxr_string">"@"</span> + System.identityHashCode(o);
+<a class="jxr_linenumber" name="L1071" href="#L1071">1071</a> }
+<a class="jxr_linenumber" name="L1072" href="#L1072">1072</a>
+<a class="jxr_linenumber" name="L1073" href="#L1073">1073</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1074" href="#L1074">1074</a> <em class="jxr_javadoccomment"> * Convenience method for calling {@link StringUtils#upperCase(String)}.</em>
+<a class="jxr_linenumber" name="L1075" href="#L1075">1075</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1076" href="#L1076">1076</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1077" href="#L1077">1077</a> <em class="jxr_javadoccomment"> * Converts the string to uppercase if not null.</em>
+<a class="jxr_linenumber" name="L1078" href="#L1078">1078</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1079" href="#L1079">1079</a> <em class="jxr_javadoccomment"> * @param value The string to convert.</em>
+<a class="jxr_linenumber" name="L1080" href="#L1080">1080</a> <em class="jxr_javadoccomment"> * @return The uppercase string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1081" href="#L1081">1081</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1082" href="#L1082">1082</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String uc(String value) {
+<a class="jxr_linenumber" name="L1083" href="#L1083">1083</a> <strong class="jxr_keyword">return</strong> StringUtils.upperCase(value);
+<a class="jxr_linenumber" name="L1084" href="#L1084">1084</a> }
+<a class="jxr_linenumber" name="L1085" href="#L1085">1085</a>
+<a class="jxr_linenumber" name="L1086" href="#L1086">1086</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1087" href="#L1087">1087</a> <em class="jxr_javadoccomment"> * Convenience method for calling {@link StringUtils#lowerCase(String)}.</em>
+<a class="jxr_linenumber" name="L1088" href="#L1088">1088</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1089" href="#L1089">1089</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1090" href="#L1090">1090</a> <em class="jxr_javadoccomment"> * Converts the string to lowercase if not null.</em>
+<a class="jxr_linenumber" name="L1091" href="#L1091">1091</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1092" href="#L1092">1092</a> <em class="jxr_javadoccomment"> * @param value The string to convert.</em>
+<a class="jxr_linenumber" name="L1093" href="#L1093">1093</a> <em class="jxr_javadoccomment"> * @return The lowercase string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1094" href="#L1094">1094</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1095" href="#L1095">1095</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String lc(String value) {
+<a class="jxr_linenumber" name="L1096" href="#L1096">1096</a> <strong class="jxr_keyword">return</strong> StringUtils.lowerCase(value);
+<a class="jxr_linenumber" name="L1097" href="#L1097">1097</a> }
+<a class="jxr_linenumber" name="L1098" href="#L1098">1098</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/junit/bct/BasicBeanConverter.html b/site/xref/org/apache/juneau/junit/bct/BasicBeanConverter.html
index 995aa35755..8d66effa6d 100644
--- a/site/xref/org/apache/juneau/junit/bct/BasicBeanConverter.html
+++ b/site/xref/org/apache/juneau/junit/bct/BasicBeanConverter.html
@@ -907,114 +907,134 @@
<a class="jxr_linenumber" name="L899" href="#L899">899</a> <strong class="jxr_keyword">var</strong> c = o.getClass();
<a class="jxr_linenumber" name="L900" href="#L900">900</a> <strong class="jxr_keyword">var</strong> stringifier = stringifierMap.computeIfAbsent(c, <strong class="jxr_keyword">this</strong>::findStringifier);
<a class="jxr_linenumber" name="L901" href="#L901">901</a> <strong class="jxr_keyword">if</strong> (stringifier.isEmpty()) {
-<a class="jxr_linenumber" name="L902" href="#L902">902</a> stringifier = of(canListify(o) ? (bc, o2) -> bc.stringify(bc.listify(o2)) : (bc, o2) -> safeToString(o2));
+<a class="jxr_linenumber" name="L902" href="#L902">902</a> stringifier = of(canListify(o) ? (bc, o2) -> bc.stringify(bc.listify(o2)) : (bc, o2) -> <strong class="jxr_keyword">this</strong>.safeToString(o2));
<a class="jxr_linenumber" name="L903" href="#L903">903</a> stringifierMap.putIfAbsent(c, stringifier);
<a class="jxr_linenumber" name="L904" href="#L904">904</a> }
<a class="jxr_linenumber" name="L905" href="#L905">905</a> <strong class="jxr_keyword">var</strong> o2 = o;
-<a class="jxr_linenumber" name="L906" href="#L906">906</a> <strong class="jxr_keyword">return</strong> stringifier.map(x -> (<a name="Stringifier" href="../../../../../org/apache/juneau/junit/bct/Stringifier.html#Stringifier">Stringifier</a>)x).map(x -> x.apply(<strong class="jxr_keyword">this</strong>, o2)).map(Utils::safeToString).orElse(<strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L906" href="#L906">906</a> <strong class="jxr_keyword">return</strong> stringifier.map(x -> (<a name="Stringifier" href="../../../../../org/apache/juneau/junit/bct/Stringifier.html#Stringifier">Stringifier</a>)x).map(x -> x.apply(<strong class="jxr_keyword">this</strong>, o2)).map(<strong class="jxr_keyword">this</strong>::safeToString).orElse(<strong class="jxr_keyword">null</strong>);
<a class="jxr_linenumber" name="L907" href="#L907">907</a> }
<a class="jxr_linenumber" name="L908" href="#L908">908</a>
<a class="jxr_linenumber" name="L909" href="#L909">909</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L910" href="#L910">910</a> <em class="jxr_javadoccomment"> * Builder class for configuring BasicBeanConverter instances.</em>
+<a class="jxr_linenumber" name="L910" href="#L910">910</a> <em class="jxr_javadoccomment"> * Safely converts an object to a string, catching any exceptions thrown by toString().</em>
<a class="jxr_linenumber" name="L911" href="#L911">911</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L912" href="#L912">912</a> <em class="jxr_javadoccomment"> * <p>This builder provides a fluent interface for registering custom type handlers</em>
-<a class="jxr_linenumber" name="L913" href="#L913">913</a> <em class="jxr_javadoccomment"> * and configuring conversion settings. All registration methods support method chaining</em>
-<a class="jxr_linenumber" name="L914" href="#L914">914</a> <em class="jxr_javadoccomment"> * for convenient configuration.</p></em>
-<a class="jxr_linenumber" name="L915" href="#L915">915</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L916" href="#L916">916</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Handler Registration:</h5></em>
-<a class="jxr_linenumber" name="L917" href="#L917">917</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L918" href="#L918">918</a> <em class="jxr_javadoccomment"> * <li><b>Stringifiers:</b> Custom string conversion logic for specific types</li></em>
-<a class="jxr_linenumber" name="L919" href="#L919">919</a> <em class="jxr_javadoccomment"> * <li><b>Listifiers:</b> Custom list conversion logic for collection-like types</li></em>
-<a class="jxr_linenumber" name="L920" href="#L920">920</a> <em class="jxr_javadoccomment"> * <li><b>Swappers:</b> Pre-processing transformation logic for wrapper types</li></em>
-<a class="jxr_linenumber" name="L921" href="#L921">921</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L922" href="#L922">922</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L923" href="#L923">923</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Registration Order:</h5></em>
-<a class="jxr_linenumber" name="L924" href="#L924">924</a> <em class="jxr_javadoccomment"> * <p>Handlers are checked in reverse registration order (last registered wins).</em>
-<a class="jxr_linenumber" name="L925" href="#L925">925</a> <em class="jxr_javadoccomment"> * This allows overriding default handlers by registering more specific ones later.</p></em>
-<a class="jxr_linenumber" name="L926" href="#L926">926</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L927" href="#L927">927</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Inheritance Support:</h5></em>
-<a class="jxr_linenumber" name="L928" href="#L928">928</a> <em class="jxr_javadoccomment"> * <p>All handlers support class inheritance and interface implementation.</em>
-<a class="jxr_linenumber" name="L929" href="#L929">929</a> <em class="jxr_javadoccomment"> * When looking up a handler, the system checks:</p></em>
-<a class="jxr_linenumber" name="L930" href="#L930">930</a> <em class="jxr_javadoccomment"> * <ol></em>
-<a class="jxr_linenumber" name="L931" href="#L931">931</a> <em class="jxr_javadoccomment"> * <li>Exact class match</li></em>
-<a class="jxr_linenumber" name="L932" href="#L932">932</a> <em class="jxr_javadoccomment"> * <li>Interface matches (in order of interface declaration)</li></em>
-<a class="jxr_linenumber" name="L933" href="#L933">933</a> <em class="jxr_javadoccomment"> * <li>Superclass matches (walking up the inheritance hierarchy)</li></em>
-<a class="jxr_linenumber" name="L934" href="#L934">934</a> <em class="jxr_javadoccomment"> * </ol></em>
+<a class="jxr_linenumber" name="L912" href="#L912">912</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L913" href="#L913">913</a> <em class="jxr_javadoccomment"> * This helper method ensures that exceptions thrown by problematic {@code toString()} implementations</em>
+<a class="jxr_linenumber" name="L914" href="#L914">914</a> <em class="jxr_javadoccomment"> * don't propagate up the call stack. Instead, it returns a descriptive error message containing</em>
+<a class="jxr_linenumber" name="L915" href="#L915">915</a> <em class="jxr_javadoccomment"> * the exception type and message.</em>
+<a class="jxr_linenumber" name="L916" href="#L916">916</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L917" href="#L917">917</a> <em class="jxr_javadoccomment"> * @param o The object to convert to a string. May be any object including <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L918" href="#L918">918</a> <em class="jxr_javadoccomment"> * @return The string representation of the object, or a formatted error message if toString() throws an exception.</em>
+<a class="jxr_linenumber" name="L919" href="#L919">919</a> <em class="jxr_javadoccomment"> * Returns <js>"null"</js> if the object is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L920" href="#L920">920</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L921" href="#L921">921</a> <strong class="jxr_keyword">private</strong> String safeToString(Object o) {
+<a class="jxr_linenumber" name="L922" href="#L922">922</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L923" href="#L923">923</a> <strong class="jxr_keyword">return</strong> o.toString();
+<a class="jxr_linenumber" name="L924" href="#L924">924</a> } <strong class="jxr_keyword">catch</strong> (Throwable t) { <em class="jxr_comment">// NOSONAR</em>
+<a class="jxr_linenumber" name="L925" href="#L925">925</a> <strong class="jxr_keyword">return</strong> cns(t) + <span class="jxr_string">": "</span> + t.getMessage();
+<a class="jxr_linenumber" name="L926" href="#L926">926</a> }
+<a class="jxr_linenumber" name="L927" href="#L927">927</a> }
+<a class="jxr_linenumber" name="L928" href="#L928">928</a>
+<a class="jxr_linenumber" name="L929" href="#L929">929</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L930" href="#L930">930</a> <em class="jxr_javadoccomment"> * Builder class for configuring BasicBeanConverter instances.</em>
+<a class="jxr_linenumber" name="L931" href="#L931">931</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L932" href="#L932">932</a> <em class="jxr_javadoccomment"> * <p>This builder provides a fluent interface for registering custom type handlers</em>
+<a class="jxr_linenumber" name="L933" href="#L933">933</a> <em class="jxr_javadoccomment"> * and configuring conversion settings. All registration methods support method chaining</em>
+<a class="jxr_linenumber" name="L934" href="#L934">934</a> <em class="jxr_javadoccomment"> * for convenient configuration.</p></em>
<a class="jxr_linenumber" name="L935" href="#L935">935</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L936" href="#L936">936</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Usage Example:</h5></em>
-<a class="jxr_linenumber" name="L937" href="#L937">937</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L938" href="#L938">938</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>converter</jv> = BasicBeanConverter.<jsm>builder</jsm>()</em>
-<a class="jxr_linenumber" name="L939" href="#L939">939</a> <em class="jxr_javadoccomment"> * .defaultSettings()</em>
-<a class="jxr_linenumber" name="L940" href="#L940">940</a> <em class="jxr_javadoccomment"> * <jc>// Custom stringification for LocalDateTime</jc></em>
-<a class="jxr_linenumber" name="L941" href="#L941">941</a> <em class="jxr_javadoccomment"> * .addStringifier(LocalDateTime.<jk>class</jk>, (<jp>dt</jp>, <jp>conv</jp>) -></em>
-<a class="jxr_linenumber" name="L942" href="#L942">942</a> <em class="jxr_javadoccomment"> * <jp>dt</jp>.format(DateTimeFormatter.<jsf>ISO_LOCAL_DATE_TIME</jsf>))</em>
-<a class="jxr_linenumber" name="L943" href="#L943">943</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L944" href="#L944">944</a> <em class="jxr_javadoccomment"> * <jc>// Custom collection handling for custom type</jc></em>
-<a class="jxr_linenumber" name="L945" href="#L945">945</a> <em class="jxr_javadoccomment"> * .addListifier(MyIterable.<jk>class</jk>, (<jp>iter</jp>, <jp>conv</jp>) -></em>
-<a class="jxr_linenumber" name="L946" href="#L946">946</a> <em class="jxr_javadoccomment"> * <jp>iter</jp>.stream().collect(toList()))</em>
-<a class="jxr_linenumber" name="L947" href="#L947">947</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L948" href="#L948">948</a> <em class="jxr_javadoccomment"> * <jc>// Custom transformation for wrapper type</jc></em>
-<a class="jxr_linenumber" name="L949" href="#L949">949</a> <em class="jxr_javadoccomment"> * .addSwapper(LazyValue.<jk>class</jk>, (<jp>lazy</jp>, <jp>conv</jp>) -></em>
-<a class="jxr_linenumber" name="L950" href="#L950">950</a> <em class="jxr_javadoccomment"> * <jp>lazy</jp>.isComputed() ? <jp>lazy</jp>.get() : <jk>null</jk>)</em>
-<a class="jxr_linenumber" name="L951" href="#L951">951</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L952" href="#L952">952</a> <em class="jxr_javadoccomment"> * <jc>// Configure settings</jc></em>
-<a class="jxr_linenumber" name="L953" href="#L953">953</a> <em class="jxr_javadoccomment"> * .addSetting(<jsf>SETTING_nullValue</jsf>, <js>"&lt;null&gt;"</js>)</em>
-<a class="jxr_linenumber" name="L954" href="#L954">954</a> <em class="jxr_javadoccomment"> * .addSetting(<jsf>SETTING_fieldSeparator</jsf>, <js>" | "</js>)</em>
+<a class="jxr_linenumber" name="L936" href="#L936">936</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Handler Registration:</h5></em>
+<a class="jxr_linenumber" name="L937" href="#L937">937</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L938" href="#L938">938</a> <em class="jxr_javadoccomment"> * <li><b>Stringifiers:</b> Custom string conversion logic for specific types</li></em>
+<a class="jxr_linenumber" name="L939" href="#L939">939</a> <em class="jxr_javadoccomment"> * <li><b>Listifiers:</b> Custom list conversion logic for collection-like types</li></em>
+<a class="jxr_linenumber" name="L940" href="#L940">940</a> <em class="jxr_javadoccomment"> * <li><b>Swappers:</b> Pre-processing transformation logic for wrapper types</li></em>
+<a class="jxr_linenumber" name="L941" href="#L941">941</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L942" href="#L942">942</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L943" href="#L943">943</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Registration Order:</h5></em>
+<a class="jxr_linenumber" name="L944" href="#L944">944</a> <em class="jxr_javadoccomment"> * <p>Handlers are checked in reverse registration order (last registered wins).</em>
+<a class="jxr_linenumber" name="L945" href="#L945">945</a> <em class="jxr_javadoccomment"> * This allows overriding default handlers by registering more specific ones later.</p></em>
+<a class="jxr_linenumber" name="L946" href="#L946">946</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L947" href="#L947">947</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Inheritance Support:</h5></em>
+<a class="jxr_linenumber" name="L948" href="#L948">948</a> <em class="jxr_javadoccomment"> * <p>All handlers support class inheritance and interface implementation.</em>
+<a class="jxr_linenumber" name="L949" href="#L949">949</a> <em class="jxr_javadoccomment"> * When looking up a handler, the system checks:</p></em>
+<a class="jxr_linenumber" name="L950" href="#L950">950</a> <em class="jxr_javadoccomment"> * <ol></em>
+<a class="jxr_linenumber" name="L951" href="#L951">951</a> <em class="jxr_javadoccomment"> * <li>Exact class match</li></em>
+<a class="jxr_linenumber" name="L952" href="#L952">952</a> <em class="jxr_javadoccomment"> * <li>Interface matches (in order of interface declaration)</li></em>
+<a class="jxr_linenumber" name="L953" href="#L953">953</a> <em class="jxr_javadoccomment"> * <li>Superclass matches (walking up the inheritance hierarchy)</li></em>
+<a class="jxr_linenumber" name="L954" href="#L954">954</a> <em class="jxr_javadoccomment"> * </ol></em>
<a class="jxr_linenumber" name="L955" href="#L955">955</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L956" href="#L956">956</a> <em class="jxr_javadoccomment"> * <jc>// Add default handlers for common types</jc></em>
-<a class="jxr_linenumber" name="L957" href="#L957">957</a> <em class="jxr_javadoccomment"> * .defaultSettings()</em>
-<a class="jxr_linenumber" name="L958" href="#L958">958</a> <em class="jxr_javadoccomment"> * .build();</em>
-<a class="jxr_linenumber" name="L959" href="#L959">959</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L960" href="#L960">960</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L961" href="#L961">961</a>
-<a class="jxr_linenumber" name="L962" href="#L962">962</a> @Override
-<a class="jxr_linenumber" name="L963" href="#L963">963</a> @SuppressWarnings(<span class="jxr_string">"unchecked"</span>)
-<a class="jxr_linenumber" name="L964" href="#L964">964</a> <strong class="jxr_keyword">public</strong> Object swap(Object o) {
-<a class="jxr_linenumber" name="L965" href="#L965">965</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L966" href="#L966">966</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L967" href="#L967">967</a> <strong class="jxr_keyword">var</strong> c = o.getClass();
-<a class="jxr_linenumber" name="L968" href="#L968">968</a> <strong class="jxr_keyword">var</strong> swapper = swapperMap.computeIfAbsent(c, <strong class="jxr_keyword">this</strong>::findSwapper);
-<a class="jxr_linenumber" name="L969" href="#L969">969</a> <strong class="jxr_keyword">if</strong> (swapper.isPresent())
-<a class="jxr_linenumber" name="L970" href="#L970">970</a> <strong class="jxr_keyword">return</strong> swap(swapper.map(x -> (<a name="Swapper" href="../../../../../org/apache/juneau/junit/bct/Swapper.html#Swapper">Swapper</a>)x).map(x -> x.apply(<strong class="jxr_keyword">this</strong>, o)).orElse(<strong class="jxr_keyword">null</strong>));
-<a class="jxr_linenumber" name="L971" href="#L971">971</a> <strong class="jxr_keyword">return</strong> o;
-<a class="jxr_linenumber" name="L972" href="#L972">972</a> }
-<a class="jxr_linenumber" name="L973" href="#L973">973</a>
-<a class="jxr_linenumber" name="L974" href="#L974">974</a> <strong class="jxr_keyword">private</strong> Optional<Listifier<?>> findListifier(Class<?> c) {
-<a class="jxr_linenumber" name="L975" href="#L975">975</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L976" href="#L976">976</a> <strong class="jxr_keyword">return</strong> empty();
-<a class="jxr_linenumber" name="L977" href="#L977">977</a> <strong class="jxr_keyword">var</strong> l = listifiers.stream().filter(x -> x.forClass.isAssignableFrom(c)).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L978" href="#L978">978</a> <strong class="jxr_keyword">if</strong> (nn(l))
-<a class="jxr_linenumber" name="L979" href="#L979">979</a> <strong class="jxr_keyword">return</strong> of(l.function);
-<a class="jxr_linenumber" name="L980" href="#L980">980</a> <strong class="jxr_keyword">return</strong> findListifier(c.getSuperclass());
-<a class="jxr_linenumber" name="L981" href="#L981">981</a> }
-<a class="jxr_linenumber" name="L982" href="#L982">982</a>
-<a class="jxr_linenumber" name="L983" href="#L983">983</a> <strong class="jxr_keyword">private</strong> Optional<Sizer<?>> findSizer(Class<?> c) {
-<a class="jxr_linenumber" name="L984" href="#L984">984</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L985" href="#L985">985</a> <strong class="jxr_keyword">return</strong> empty();
-<a class="jxr_linenumber" name="L986" href="#L986">986</a> <strong class="jxr_keyword">var</strong> s = sizers.stream().filter(x -> x.forClass.isAssignableFrom(c)).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L987" href="#L987">987</a> <strong class="jxr_keyword">if</strong> (nn(s))
-<a class="jxr_linenumber" name="L988" href="#L988">988</a> <strong class="jxr_keyword">return</strong> of(s.function);
-<a class="jxr_linenumber" name="L989" href="#L989">989</a> <strong class="jxr_keyword">return</strong> findSizer(c.getSuperclass());
-<a class="jxr_linenumber" name="L990" href="#L990">990</a> }
-<a class="jxr_linenumber" name="L991" href="#L991">991</a>
-<a class="jxr_linenumber" name="L992" href="#L992">992</a> <strong class="jxr_keyword">private</strong> Optional<Stringifier<?>> findStringifier(Class<?> c) {
-<a class="jxr_linenumber" name="L993" href="#L993">993</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L994" href="#L994">994</a> <strong class="jxr_keyword">return</strong> empty();
-<a class="jxr_linenumber" name="L995" href="#L995">995</a> <strong class="jxr_keyword">var</strong> s = stringifiers.stream().filter(x -> x.forClass.isAssignableFrom(c)).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L996" href="#L996">996</a> <strong class="jxr_keyword">if</strong> (nn(s))
-<a class="jxr_linenumber" name="L997" href="#L997">997</a> <strong class="jxr_keyword">return</strong> of(s.function);
-<a class="jxr_linenumber" name="L998" href="#L998">998</a> <strong class="jxr_keyword">return</strong> findStringifier(c.getSuperclass());
-<a class="jxr_linenumber" name="L999" href="#L999">999</a> }
-<a class="jxr_linenumber" name="L1000" href="#L1000">1000</a>
-<a class="jxr_linenumber" name="L1001" href="#L1001">1001</a> <strong class="jxr_keyword">private</strong> Optional<Swapper<?>> findSwapper(Class<?> c) {
-<a class="jxr_linenumber" name="L1002" href="#L1002">1002</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1003" href="#L1003">1003</a> <strong class="jxr_keyword">return</strong> empty();
-<a class="jxr_linenumber" name="L1004" href="#L1004">1004</a> <strong class="jxr_keyword">var</strong> s = swappers.stream().filter(x -> x.forClass.isAssignableFrom(c)).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L1005" href="#L1005">1005</a> <strong class="jxr_keyword">if</strong> (nn(s))
-<a class="jxr_linenumber" name="L1006" href="#L1006">1006</a> <strong class="jxr_keyword">return</strong> of(s.function);
-<a class="jxr_linenumber" name="L1007" href="#L1007">1007</a> <strong class="jxr_keyword">return</strong> findSwapper(c.getSuperclass());
-<a class="jxr_linenumber" name="L1008" href="#L1008">1008</a> }
-<a class="jxr_linenumber" name="L1009" href="#L1009">1009</a> }
+<a class="jxr_linenumber" name="L956" href="#L956">956</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Usage Example:</h5></em>
+<a class="jxr_linenumber" name="L957" href="#L957">957</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L958" href="#L958">958</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>converter</jv> = BasicBeanConverter.<jsm>builder</jsm>()</em>
+<a class="jxr_linenumber" name="L959" href="#L959">959</a> <em class="jxr_javadoccomment"> * .defaultSettings()</em>
+<a class="jxr_linenumber" name="L960" href="#L960">960</a> <em class="jxr_javadoccomment"> * <jc>// Custom stringification for LocalDateTime</jc></em>
+<a class="jxr_linenumber" name="L961" href="#L961">961</a> <em class="jxr_javadoccomment"> * .addStringifier(LocalDateTime.<jk>class</jk>, (<jp>dt</jp>, <jp>conv</jp>) -></em>
+<a class="jxr_linenumber" name="L962" href="#L962">962</a> <em class="jxr_javadoccomment"> * <jp>dt</jp>.format(DateTimeFormatter.<jsf>ISO_LOCAL_DATE_TIME</jsf>))</em>
+<a class="jxr_linenumber" name="L963" href="#L963">963</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L964" href="#L964">964</a> <em class="jxr_javadoccomment"> * <jc>// Custom collection handling for custom type</jc></em>
+<a class="jxr_linenumber" name="L965" href="#L965">965</a> <em class="jxr_javadoccomment"> * .addListifier(MyIterable.<jk>class</jk>, (<jp>iter</jp>, <jp>conv</jp>) -></em>
+<a class="jxr_linenumber" name="L966" href="#L966">966</a> <em class="jxr_javadoccomment"> * <jp>iter</jp>.stream().collect(toList()))</em>
+<a class="jxr_linenumber" name="L967" href="#L967">967</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L968" href="#L968">968</a> <em class="jxr_javadoccomment"> * <jc>// Custom transformation for wrapper type</jc></em>
+<a class="jxr_linenumber" name="L969" href="#L969">969</a> <em class="jxr_javadoccomment"> * .addSwapper(LazyValue.<jk>class</jk>, (<jp>lazy</jp>, <jp>conv</jp>) -></em>
+<a class="jxr_linenumber" name="L970" href="#L970">970</a> <em class="jxr_javadoccomment"> * <jp>lazy</jp>.isComputed() ? <jp>lazy</jp>.get() : <jk>null</jk>)</em>
+<a class="jxr_linenumber" name="L971" href="#L971">971</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L972" href="#L972">972</a> <em class="jxr_javadoccomment"> * <jc>// Configure settings</jc></em>
+<a class="jxr_linenumber" name="L973" href="#L973">973</a> <em class="jxr_javadoccomment"> * .addSetting(<jsf>SETTING_nullValue</jsf>, <js>"&lt;null&gt;"</js>)</em>
+<a class="jxr_linenumber" name="L974" href="#L974">974</a> <em class="jxr_javadoccomment"> * .addSetting(<jsf>SETTING_fieldSeparator</jsf>, <js>" | "</js>)</em>
+<a class="jxr_linenumber" name="L975" href="#L975">975</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L976" href="#L976">976</a> <em class="jxr_javadoccomment"> * <jc>// Add default handlers for common types</jc></em>
+<a class="jxr_linenumber" name="L977" href="#L977">977</a> <em class="jxr_javadoccomment"> * .defaultSettings()</em>
+<a class="jxr_linenumber" name="L978" href="#L978">978</a> <em class="jxr_javadoccomment"> * .build();</em>
+<a class="jxr_linenumber" name="L979" href="#L979">979</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L980" href="#L980">980</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L981" href="#L981">981</a>
+<a class="jxr_linenumber" name="L982" href="#L982">982</a> @Override
+<a class="jxr_linenumber" name="L983" href="#L983">983</a> @SuppressWarnings(<span class="jxr_string">"unchecked"</span>)
+<a class="jxr_linenumber" name="L984" href="#L984">984</a> <strong class="jxr_keyword">public</strong> Object swap(Object o) {
+<a class="jxr_linenumber" name="L985" href="#L985">985</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L986" href="#L986">986</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L987" href="#L987">987</a> <strong class="jxr_keyword">var</strong> c = o.getClass();
+<a class="jxr_linenumber" name="L988" href="#L988">988</a> <strong class="jxr_keyword">var</strong> swapper = swapperMap.computeIfAbsent(c, <strong class="jxr_keyword">this</strong>::findSwapper);
+<a class="jxr_linenumber" name="L989" href="#L989">989</a> <strong class="jxr_keyword">if</strong> (swapper.isPresent())
+<a class="jxr_linenumber" name="L990" href="#L990">990</a> <strong class="jxr_keyword">return</strong> swap(swapper.map(x -> (<a name="Swapper" href="../../../../../org/apache/juneau/junit/bct/Swapper.html#Swapper">Swapper</a>)x).map(x -> x.apply(<strong class="jxr_keyword">this</strong>, o)).orElse(<strong class="jxr_keyword">null</strong>));
+<a class="jxr_linenumber" name="L991" href="#L991">991</a> <strong class="jxr_keyword">return</strong> o;
+<a class="jxr_linenumber" name="L992" href="#L992">992</a> }
+<a class="jxr_linenumber" name="L993" href="#L993">993</a>
+<a class="jxr_linenumber" name="L994" href="#L994">994</a> <strong class="jxr_keyword">private</strong> Optional<Listifier<?>> findListifier(Class<?> c) {
+<a class="jxr_linenumber" name="L995" href="#L995">995</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L996" href="#L996">996</a> <strong class="jxr_keyword">return</strong> empty();
+<a class="jxr_linenumber" name="L997" href="#L997">997</a> <strong class="jxr_keyword">var</strong> l = listifiers.stream().filter(x -> x.forClass.isAssignableFrom(c)).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L998" href="#L998">998</a> <strong class="jxr_keyword">if</strong> (nn(l))
+<a class="jxr_linenumber" name="L999" href="#L999">999</a> <strong class="jxr_keyword">return</strong> of(l.function);
+<a class="jxr_linenumber" name="L1000" href="#L1000">1000</a> <strong class="jxr_keyword">return</strong> findListifier(c.getSuperclass());
+<a class="jxr_linenumber" name="L1001" href="#L1001">1001</a> }
+<a class="jxr_linenumber" name="L1002" href="#L1002">1002</a>
+<a class="jxr_linenumber" name="L1003" href="#L1003">1003</a> <strong class="jxr_keyword">private</strong> Optional<Sizer<?>> findSizer(Class<?> c) {
+<a class="jxr_linenumber" name="L1004" href="#L1004">1004</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1005" href="#L1005">1005</a> <strong class="jxr_keyword">return</strong> empty();
+<a class="jxr_linenumber" name="L1006" href="#L1006">1006</a> <strong class="jxr_keyword">var</strong> s = sizers.stream().filter(x -> x.forClass.isAssignableFrom(c)).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L1007" href="#L1007">1007</a> <strong class="jxr_keyword">if</strong> (nn(s))
+<a class="jxr_linenumber" name="L1008" href="#L1008">1008</a> <strong class="jxr_keyword">return</strong> of(s.function);
+<a class="jxr_linenumber" name="L1009" href="#L1009">1009</a> <strong class="jxr_keyword">return</strong> findSizer(c.getSuperclass());
+<a class="jxr_linenumber" name="L1010" href="#L1010">1010</a> }
+<a class="jxr_linenumber" name="L1011" href="#L1011">1011</a>
+<a class="jxr_linenumber" name="L1012" href="#L1012">1012</a> <strong class="jxr_keyword">private</strong> Optional<Stringifier<?>> findStringifier(Class<?> c) {
+<a class="jxr_linenumber" name="L1013" href="#L1013">1013</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1014" href="#L1014">1014</a> <strong class="jxr_keyword">return</strong> empty();
+<a class="jxr_linenumber" name="L1015" href="#L1015">1015</a> <strong class="jxr_keyword">var</strong> s = stringifiers.stream().filter(x -> x.forClass.isAssignableFrom(c)).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L1016" href="#L1016">1016</a> <strong class="jxr_keyword">if</strong> (nn(s))
+<a class="jxr_linenumber" name="L1017" href="#L1017">1017</a> <strong class="jxr_keyword">return</strong> of(s.function);
+<a class="jxr_linenumber" name="L1018" href="#L1018">1018</a> <strong class="jxr_keyword">return</strong> findStringifier(c.getSuperclass());
+<a class="jxr_linenumber" name="L1019" href="#L1019">1019</a> }
+<a class="jxr_linenumber" name="L1020" href="#L1020">1020</a>
+<a class="jxr_linenumber" name="L1021" href="#L1021">1021</a> <strong class="jxr_keyword">private</strong> Optional<Swapper<?>> findSwapper(Class<?> c) {
+<a class="jxr_linenumber" name="L1022" href="#L1022">1022</a> <strong class="jxr_keyword">if</strong> (c == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1023" href="#L1023">1023</a> <strong class="jxr_keyword">return</strong> empty();
+<a class="jxr_linenumber" name="L1024" href="#L1024">1024</a> <strong class="jxr_keyword">var</strong> s = swappers.stream().filter(x -> x.forClass.isAssignableFrom(c)).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
+<a class="jxr_linenumber" name="L1025" href="#L1025">1025</a> <strong class="jxr_keyword">if</strong> (nn(s))
+<a class="jxr_linenumber" name="L1026" href="#L1026">1026</a> <strong class="jxr_keyword">return</strong> of(s.function);
+<a class="jxr_linenumber" name="L1027" href="#L1027">1027</a> <strong class="jxr_keyword">return</strong> findSwapper(c.getSuperclass());
+<a class="jxr_linenumber" name="L1028" href="#L1028">1028</a> }
+<a class="jxr_linenumber" name="L1029" href="#L1029">1029</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/junit/bct/BctAssertions.html b/site/xref/org/apache/juneau/junit/bct/BctAssertions.html
index 29cef496e3..012cd18d7e 100644
--- a/site/xref/org/apache/juneau/junit/bct/BctAssertions.html
+++ b/site/xref/org/apache/juneau/junit/bct/BctAssertions.html
@@ -920,7 +920,7 @@
<a class="jxr_linenumber" name="L912" href="#L912">912</a> assertNotNull(value, <span class="jxr_string">"Value was null."</span>);
<a class="jxr_linenumber" name="L913" href="#L913">913</a>
<a class="jxr_linenumber" name="L914" href="#L914">914</a> <strong class="jxr_keyword">var</strong> v = args.getBeanConverter().orElse(DEFAULT_CONVERTER).stringify(value);
-<a class="jxr_linenumber" name="L915" href="#L915">915</a> <strong class="jxr_keyword">var</strong> m = getGlobMatchPattern(pattern).matcher(v);
+<a class="jxr_linenumber" name="L915" href="#L915">915</a> <strong class="jxr_keyword">var</strong> m = StringUtils.getGlobMatchPattern(pattern).matcher(v);
<a class="jxr_linenumber" name="L916" href="#L916">916</a> assertTrue(m.matches(), args.getMessage(<span class="jxr_string">"Pattern didn''t match. ==> pattern: <{0}> but was: <{1}>"</span>, pattern, v));
<a class="jxr_linenumber" name="L917" href="#L917">917</a> }
<a class="jxr_linenumber" name="L918" href="#L918">918</a>
diff --git a/site/xref/org/apache/juneau/junit/bct/PropertyExtractors.html b/site/xref/org/apache/juneau/junit/bct/PropertyExtractors.html
index bd12d90e23..17c9f90266 100644
--- a/site/xref/org/apache/juneau/junit/bct/PropertyExtractors.html
+++ b/site/xref/org/apache/juneau/junit/bct/PropertyExtractors.html
@@ -29,256 +29,258 @@
<a class="jxr_linenumber" name="L21" href="#L21">21</a> <strong class="jxr_keyword">import</strong> java.lang.reflect.*;
<a class="jxr_linenumber" name="L22" href="#L22">22</a> <strong class="jxr_keyword">import</strong> java.util.*;
<a class="jxr_linenumber" name="L23" href="#L23">23</a>
-<a class="jxr_linenumber" name="L24" href="#L24">24</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L25" href="#L25">25</a> <em class="jxr_javadoccomment"> * Collection of standard property extractor implementations for the Bean-Centric Testing framework.</em>
-<a class="jxr_linenumber" name="L26" href="#L26">26</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L27" href="#L27">27</a> <em class="jxr_javadoccomment"> * <p>This class provides the built-in property extraction strategies that handle the most common</em>
-<a class="jxr_linenumber" name="L28" href="#L28">28</a> <em class="jxr_javadoccomment"> * object types and property access patterns. These extractors are automatically registered when</em>
-<a class="jxr_linenumber" name="L29" href="#L29">29</a> <em class="jxr_javadoccomment"> * using {@link BasicBeanConverter.Builder#defaultSettings()}.</p></em>
-<a class="jxr_linenumber" name="L30" href="#L30">30</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L31" href="#L31">31</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Extractor Hierarchy:</h5></em>
-<a class="jxr_linenumber" name="L32" href="#L32">32</a> <em class="jxr_javadoccomment"> * <p>The extractors form an inheritance hierarchy for code reuse:</p></em>
-<a class="jxr_linenumber" name="L33" href="#L33">33</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L34" href="#L34">34</a> <em class="jxr_javadoccomment"> * <li><b>{@link ObjectPropertyExtractor}</b> - Base class with JavaBean property access</li></em>
-<a class="jxr_linenumber" name="L35" href="#L35">35</a> <em class="jxr_javadoccomment"> * <li><b>{@link ListPropertyExtractor}</b> - Extends ObjectPropertyExtractor with array/collection support</li></em>
-<a class="jxr_linenumber" name="L36" href="#L36">36</a> <em class="jxr_javadoccomment"> * <li><b>{@link MapPropertyExtractor}</b> - Extends ObjectPropertyExtractor with Map key access</li></em>
-<a class="jxr_linenumber" name="L37" href="#L37">37</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L38" href="#L38">38</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L39" href="#L39">39</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Execution Order:</h5></em>
-<a class="jxr_linenumber" name="L40" href="#L40">40</a> <em class="jxr_javadoccomment"> * <p>In {@link BasicBeanConverter}, the extractors are tried in this order:</p></em>
-<a class="jxr_linenumber" name="L41" href="#L41">41</a> <em class="jxr_javadoccomment"> * <ol></em>
-<a class="jxr_linenumber" name="L42" href="#L42">42</a> <em class="jxr_javadoccomment"> * <li><b>Custom extractors</b> - User-registered extractors via {@link BasicBeanConverter.Builder#addPropertyExtractor(PropertyExtractor)}</li></em>
-<a class="jxr_linenumber" name="L43" href="#L43">43</a> <em class="jxr_javadoccomment"> * <li><b>{@link ObjectPropertyExtractor}</b> - JavaBean properties, fields, and methods</li></em>
-<a class="jxr_linenumber" name="L44" href="#L44">44</a> <em class="jxr_javadoccomment"> * <li><b>{@link ListPropertyExtractor}</b> - Array/collection indices and size properties</li></em>
-<a class="jxr_linenumber" name="L45" href="#L45">45</a> <em class="jxr_javadoccomment"> * <li><b>{@link MapPropertyExtractor}</b> - Map key access and size property</li></em>
-<a class="jxr_linenumber" name="L46" href="#L46">46</a> <em class="jxr_javadoccomment"> * </ol></em>
-<a class="jxr_linenumber" name="L47" href="#L47">47</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L48" href="#L48">48</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Property Access Strategy:</h5></em>
-<a class="jxr_linenumber" name="L49" href="#L49">49</a> <em class="jxr_javadoccomment"> * <p>Each extractor implements a comprehensive fallback strategy for maximum compatibility:</p></em>
-<a class="jxr_linenumber" name="L50" href="#L50">50</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L51" href="#L51">51</a> <em class="jxr_javadoccomment"> * @see PropertyExtractor</em>
-<a class="jxr_linenumber" name="L52" href="#L52">52</a> <em class="jxr_javadoccomment"> * @see BasicBeanConverter.Builder#defaultSettings()</em>
-<a class="jxr_linenumber" name="L53" href="#L53">53</a> <em class="jxr_javadoccomment"> * @see BasicBeanConverter.Builder#addPropertyExtractor(PropertyExtractor)</em>
-<a class="jxr_linenumber" name="L54" href="#L54">54</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L55" href="#L55">55</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">class</strong> <a name="PropertyExtractors" href="../../../../../org/apache/juneau/junit/bct/PropertyExtractors.html#PropertyExtractors">PropertyExtractors</a> {
-<a class="jxr_linenumber" name="L56" href="#L56">56</a>
-<a class="jxr_linenumber" name="L57" href="#L57">57</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L58" href="#L58">58</a> <em class="jxr_javadoccomment"> * Property extractor for array and collection objects with numeric indexing and size access.</em>
-<a class="jxr_linenumber" name="L59" href="#L59">59</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L60" href="#L60">60</a> <em class="jxr_javadoccomment"> * <p>This extractor extends {@link ObjectPropertyExtractor} to add special handling for</em>
-<a class="jxr_linenumber" name="L61" href="#L61">61</a> <em class="jxr_javadoccomment"> * collection-like objects. It provides array-style access using numeric indices and</em>
-<a class="jxr_linenumber" name="L62" href="#L62">62</a> <em class="jxr_javadoccomment"> * universal size/length properties for any listifiable object.</p></em>
-<a class="jxr_linenumber" name="L63" href="#L63">63</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L64" href="#L64">64</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Additional Properties:</h5></em>
-<a class="jxr_linenumber" name="L65" href="#L65">65</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L66" href="#L66">66</a> <em class="jxr_javadoccomment"> * <li><b>Numeric indices:</b> <js>"0"</js>, <js>"1"</js>, <js>"2"</js>, etc. for element access</li></em>
-<a class="jxr_linenumber" name="L67" href="#L67">67</a> <em class="jxr_javadoccomment"> * <li><b>Negative indices:</b> <js>"-1"</js>, <js>"-2"</js> for reverse indexing (from end)</li></em>
-<a class="jxr_linenumber" name="L68" href="#L68">68</a> <em class="jxr_javadoccomment"> * <li><b>Size properties:</b> <js>"length"</js> and <js>"size"</js> return collection size</li></em>
-<a class="jxr_linenumber" name="L69" href="#L69">69</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L70" href="#L70">70</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L71" href="#L71">71</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Supported Types:</h5></em>
-<a class="jxr_linenumber" name="L72" href="#L72">72</a> <em class="jxr_javadoccomment"> * <p>Works with any object that can be listified by the converter:</p></em>
-<a class="jxr_linenumber" name="L73" href="#L73">73</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L74" href="#L74">74</a> <em class="jxr_javadoccomment"> * <li><b>Arrays:</b> All array types (primitive and object)</li></em>
-<a class="jxr_linenumber" name="L75" href="#L75">75</a> <em class="jxr_javadoccomment"> * <li><b>Collections:</b> List, Set, Queue, and all Collection subtypes</li></em>
-<a class="jxr_linenumber" name="L76" href="#L76">76</a> <em class="jxr_javadoccomment"> * <li><b>Iterables:</b> Any object implementing Iterable</li></em>
-<a class="jxr_linenumber" name="L77" href="#L77">77</a> <em class="jxr_javadoccomment"> * <li><b>Streams:</b> Stream objects and other lazy sequences</li></em>
-<a class="jxr_linenumber" name="L78" href="#L78">78</a> <em class="jxr_javadoccomment"> * <li><b>Maps:</b> Converted to list of entries for iteration</li></em>
-<a class="jxr_linenumber" name="L79" href="#L79">79</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L80" href="#L80">80</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L81" href="#L81">81</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L82" href="#L82">82</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L83" href="#L83">83</a> <em class="jxr_javadoccomment"> * <jc>// Array/List access</jc></em>
-<a class="jxr_linenumber" name="L84" href="#L84">84</a> <em class="jxr_javadoccomment"> * <jv>list</jv>.get(0) <jc>// "0" property</jc></em>
-<a class="jxr_linenumber" name="L85" href="#L85">85</a> <em class="jxr_javadoccomment"> * <jv>array</jv>[2] <jc>// "2" property</jc></em>
-<a class="jxr_linenumber" name="L86" href="#L86">86</a> <em class="jxr_javadoccomment"> * <jv>list</jv>.get(-1) <jc>// "-1" property (last element)</jc></em>
-<a class="jxr_linenumber" name="L87" href="#L87">87</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L88" href="#L88">88</a> <em class="jxr_javadoccomment"> * <jc>// Size access</jc></em>
-<a class="jxr_linenumber" name="L89" href="#L89">89</a> <em class="jxr_javadoccomment"> * <jv>array</jv>.length <jc>// "length" property</jc></em>
-<a class="jxr_linenumber" name="L90" href="#L90">90</a> <em class="jxr_javadoccomment"> * <jv>collection</jv>.size() <jc>// "size" property</jc></em>
-<a class="jxr_linenumber" name="L91" href="#L91">91</a> <em class="jxr_javadoccomment"> * <jv>stream</jv>.count() <jc>// "length" or "size" property</jc></em>
-<a class="jxr_linenumber" name="L92" href="#L92">92</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L93" href="#L93">93</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L94" href="#L94">94</a> <em class="jxr_javadoccomment"> * <p><b>Fallback:</b> If the property is not a numeric index or size property,</em>
-<a class="jxr_linenumber" name="L95" href="#L95">95</a> <em class="jxr_javadoccomment"> * delegates to {@link ObjectPropertyExtractor} for standard property access.</p></em>
-<a class="jxr_linenumber" name="L96" href="#L96">96</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L97" href="#L97">97</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">class</strong> ListPropertyExtractor <strong class="jxr_keyword">extends</strong> ObjectPropertyExtractor {
-<a class="jxr_linenumber" name="L98" href="#L98">98</a>
-<a class="jxr_linenumber" name="L99" href="#L99">99</a> @Override
-<a class="jxr_linenumber" name="L100" href="#L100">100</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> canExtract(<a name="BeanConverter" href="../../../../../org/apache/juneau/junit/bct/BeanConverter.html#BeanConverter">BeanConverter</a> converter, Object o, String name) {
-<a class="jxr_linenumber" name="L101" href="#L101">101</a> <strong class="jxr_keyword">return</strong> converter.canListify(o);
-<a class="jxr_linenumber" name="L102" href="#L102">102</a> }
-<a class="jxr_linenumber" name="L103" href="#L103">103</a>
-<a class="jxr_linenumber" name="L104" href="#L104">104</a> @Override
-<a class="jxr_linenumber" name="L105" href="#L105">105</a> <strong class="jxr_keyword">public</strong> Object extract(<a name="BeanConverter" href="../../../../../org/apache/juneau/junit/bct/BeanConverter.html#BeanConverter">BeanConverter</a> converter, Object o, String name) {
-<a class="jxr_linenumber" name="L106" href="#L106">106</a> <strong class="jxr_keyword">var</strong> l = converter.listify(o);
-<a class="jxr_linenumber" name="L107" href="#L107">107</a> <strong class="jxr_keyword">if</strong> (name.matches(<span class="jxr_string">"-?\\d+"</span>)) {
-<a class="jxr_linenumber" name="L108" href="#L108">108</a> <strong class="jxr_keyword">var</strong> index = parseInt(name);
-<a class="jxr_linenumber" name="L109" href="#L109">109</a> <strong class="jxr_keyword">if</strong> (index < 0) {
-<a class="jxr_linenumber" name="L110" href="#L110">110</a> index = l.size() + index; <em class="jxr_comment">// Convert negative index to positive</em>
-<a class="jxr_linenumber" name="L111" href="#L111">111</a> }
-<a class="jxr_linenumber" name="L112" href="#L112">112</a> <strong class="jxr_keyword">return</strong> l.get(index);
-<a class="jxr_linenumber" name="L113" href="#L113">113</a> }
-<a class="jxr_linenumber" name="L114" href="#L114">114</a> <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"length"</span>.equals(name))
-<a class="jxr_linenumber" name="L115" href="#L115">115</a> <strong class="jxr_keyword">return</strong> l.size();
-<a class="jxr_linenumber" name="L116" href="#L116">116</a> <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"size"</span>.equals(name))
+<a class="jxr_linenumber" name="L24" href="#L24">24</a> <strong class="jxr_keyword">import</strong> org.apache.juneau.common.utils.*;
+<a class="jxr_linenumber" name="L25" href="#L25">25</a>
+<a class="jxr_linenumber" name="L26" href="#L26">26</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L27" href="#L27">27</a> <em class="jxr_javadoccomment"> * Collection of standard property extractor implementations for the Bean-Centric Testing framework.</em>
+<a class="jxr_linenumber" name="L28" href="#L28">28</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L29" href="#L29">29</a> <em class="jxr_javadoccomment"> * <p>This class provides the built-in property extraction strategies that handle the most common</em>
+<a class="jxr_linenumber" name="L30" href="#L30">30</a> <em class="jxr_javadoccomment"> * object types and property access patterns. These extractors are automatically registered when</em>
+<a class="jxr_linenumber" name="L31" href="#L31">31</a> <em class="jxr_javadoccomment"> * using {@link BasicBeanConverter.Builder#defaultSettings()}.</p></em>
+<a class="jxr_linenumber" name="L32" href="#L32">32</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L33" href="#L33">33</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Extractor Hierarchy:</h5></em>
+<a class="jxr_linenumber" name="L34" href="#L34">34</a> <em class="jxr_javadoccomment"> * <p>The extractors form an inheritance hierarchy for code reuse:</p></em>
+<a class="jxr_linenumber" name="L35" href="#L35">35</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L36" href="#L36">36</a> <em class="jxr_javadoccomment"> * <li><b>{@link ObjectPropertyExtractor}</b> - Base class with JavaBean property access</li></em>
+<a class="jxr_linenumber" name="L37" href="#L37">37</a> <em class="jxr_javadoccomment"> * <li><b>{@link ListPropertyExtractor}</b> - Extends ObjectPropertyExtractor with array/collection support</li></em>
+<a class="jxr_linenumber" name="L38" href="#L38">38</a> <em class="jxr_javadoccomment"> * <li><b>{@link MapPropertyExtractor}</b> - Extends ObjectPropertyExtractor with Map key access</li></em>
+<a class="jxr_linenumber" name="L39" href="#L39">39</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L40" href="#L40">40</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L41" href="#L41">41</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Execution Order:</h5></em>
+<a class="jxr_linenumber" name="L42" href="#L42">42</a> <em class="jxr_javadoccomment"> * <p>In {@link BasicBeanConverter}, the extractors are tried in this order:</p></em>
+<a class="jxr_linenumber" name="L43" href="#L43">43</a> <em class="jxr_javadoccomment"> * <ol></em>
+<a class="jxr_linenumber" name="L44" href="#L44">44</a> <em class="jxr_javadoccomment"> * <li><b>Custom extractors</b> - User-registered extractors via {@link BasicBeanConverter.Builder#addPropertyExtractor(PropertyExtractor)}</li></em>
+<a class="jxr_linenumber" name="L45" href="#L45">45</a> <em class="jxr_javadoccomment"> * <li><b>{@link ObjectPropertyExtractor}</b> - JavaBean properties, fields, and methods</li></em>
+<a class="jxr_linenumber" name="L46" href="#L46">46</a> <em class="jxr_javadoccomment"> * <li><b>{@link ListPropertyExtractor}</b> - Array/collection indices and size properties</li></em>
+<a class="jxr_linenumber" name="L47" href="#L47">47</a> <em class="jxr_javadoccomment"> * <li><b>{@link MapPropertyExtractor}</b> - Map key access and size property</li></em>
+<a class="jxr_linenumber" name="L48" href="#L48">48</a> <em class="jxr_javadoccomment"> * </ol></em>
+<a class="jxr_linenumber" name="L49" href="#L49">49</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L50" href="#L50">50</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Property Access Strategy:</h5></em>
+<a class="jxr_linenumber" name="L51" href="#L51">51</a> <em class="jxr_javadoccomment"> * <p>Each extractor implements a comprehensive fallback strategy for maximum compatibility:</p></em>
+<a class="jxr_linenumber" name="L52" href="#L52">52</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L53" href="#L53">53</a> <em class="jxr_javadoccomment"> * @see PropertyExtractor</em>
+<a class="jxr_linenumber" name="L54" href="#L54">54</a> <em class="jxr_javadoccomment"> * @see BasicBeanConverter.Builder#defaultSettings()</em>
+<a class="jxr_linenumber" name="L55" href="#L55">55</a> <em class="jxr_javadoccomment"> * @see BasicBeanConverter.Builder#addPropertyExtractor(PropertyExtractor)</em>
+<a class="jxr_linenumber" name="L56" href="#L56">56</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L57" href="#L57">57</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">class</strong> <a name="PropertyExtractors" href="../../../../../org/apache/juneau/junit/bct/PropertyExtractors.html#PropertyExtractors">PropertyExtractors</a> {
+<a class="jxr_linenumber" name="L58" href="#L58">58</a>
+<a class="jxr_linenumber" name="L59" href="#L59">59</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L60" href="#L60">60</a> <em class="jxr_javadoccomment"> * Property extractor for array and collection objects with numeric indexing and size access.</em>
+<a class="jxr_linenumber" name="L61" href="#L61">61</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L62" href="#L62">62</a> <em class="jxr_javadoccomment"> * <p>This extractor extends {@link ObjectPropertyExtractor} to add special handling for</em>
+<a class="jxr_linenumber" name="L63" href="#L63">63</a> <em class="jxr_javadoccomment"> * collection-like objects. It provides array-style access using numeric indices and</em>
+<a class="jxr_linenumber" name="L64" href="#L64">64</a> <em class="jxr_javadoccomment"> * universal size/length properties for any listifiable object.</p></em>
+<a class="jxr_linenumber" name="L65" href="#L65">65</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L66" href="#L66">66</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Additional Properties:</h5></em>
+<a class="jxr_linenumber" name="L67" href="#L67">67</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L68" href="#L68">68</a> <em class="jxr_javadoccomment"> * <li><b>Numeric indices:</b> <js>"0"</js>, <js>"1"</js>, <js>"2"</js>, etc. for element access</li></em>
+<a class="jxr_linenumber" name="L69" href="#L69">69</a> <em class="jxr_javadoccomment"> * <li><b>Negative indices:</b> <js>"-1"</js>, <js>"-2"</js> for reverse indexing (from end)</li></em>
+<a class="jxr_linenumber" name="L70" href="#L70">70</a> <em class="jxr_javadoccomment"> * <li><b>Size properties:</b> <js>"length"</js> and <js>"size"</js> return collection size</li></em>
+<a class="jxr_linenumber" name="L71" href="#L71">71</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L72" href="#L72">72</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L73" href="#L73">73</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Supported Types:</h5></em>
+<a class="jxr_linenumber" name="L74" href="#L74">74</a> <em class="jxr_javadoccomment"> * <p>Works with any object that can be listified by the converter:</p></em>
+<a class="jxr_linenumber" name="L75" href="#L75">75</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L76" href="#L76">76</a> <em class="jxr_javadoccomment"> * <li><b>Arrays:</b> All array types (primitive and object)</li></em>
+<a class="jxr_linenumber" name="L77" href="#L77">77</a> <em class="jxr_javadoccomment"> * <li><b>Collections:</b> List, Set, Queue, and all Collection subtypes</li></em>
+<a class="jxr_linenumber" name="L78" href="#L78">78</a> <em class="jxr_javadoccomment"> * <li><b>Iterables:</b> Any object implementing Iterable</li></em>
+<a class="jxr_linenumber" name="L79" href="#L79">79</a> <em class="jxr_javadoccomment"> * <li><b>Streams:</b> Stream objects and other lazy sequences</li></em>
+<a class="jxr_linenumber" name="L80" href="#L80">80</a> <em class="jxr_javadoccomment"> * <li><b>Maps:</b> Converted to list of entries for iteration</li></em>
+<a class="jxr_linenumber" name="L81" href="#L81">81</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L82" href="#L82">82</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L83" href="#L83">83</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L84" href="#L84">84</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L85" href="#L85">85</a> <em class="jxr_javadoccomment"> * <jc>// Array/List access</jc></em>
+<a class="jxr_linenumber" name="L86" href="#L86">86</a> <em class="jxr_javadoccomment"> * <jv>list</jv>.get(0) <jc>// "0" property</jc></em>
+<a class="jxr_linenumber" name="L87" href="#L87">87</a> <em class="jxr_javadoccomment"> * <jv>array</jv>[2] <jc>// "2" property</jc></em>
+<a class="jxr_linenumber" name="L88" href="#L88">88</a> <em class="jxr_javadoccomment"> * <jv>list</jv>.get(-1) <jc>// "-1" property (last element)</jc></em>
+<a class="jxr_linenumber" name="L89" href="#L89">89</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L90" href="#L90">90</a> <em class="jxr_javadoccomment"> * <jc>// Size access</jc></em>
+<a class="jxr_linenumber" name="L91" href="#L91">91</a> <em class="jxr_javadoccomment"> * <jv>array</jv>.length <jc>// "length" property</jc></em>
+<a class="jxr_linenumber" name="L92" href="#L92">92</a> <em class="jxr_javadoccomment"> * <jv>collection</jv>.size() <jc>// "size" property</jc></em>
+<a class="jxr_linenumber" name="L93" href="#L93">93</a> <em class="jxr_javadoccomment"> * <jv>stream</jv>.count() <jc>// "length" or "size" property</jc></em>
+<a class="jxr_linenumber" name="L94" href="#L94">94</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L95" href="#L95">95</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L96" href="#L96">96</a> <em class="jxr_javadoccomment"> * <p><b>Fallback:</b> If the property is not a numeric index or size property,</em>
+<a class="jxr_linenumber" name="L97" href="#L97">97</a> <em class="jxr_javadoccomment"> * delegates to {@link ObjectPropertyExtractor} for standard property access.</p></em>
+<a class="jxr_linenumber" name="L98" href="#L98">98</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L99" href="#L99">99</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">class</strong> ListPropertyExtractor <strong class="jxr_keyword">extends</strong> ObjectPropertyExtractor {
+<a class="jxr_linenumber" name="L100" href="#L100">100</a>
+<a class="jxr_linenumber" name="L101" href="#L101">101</a> @Override
+<a class="jxr_linenumber" name="L102" href="#L102">102</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> canExtract(<a name="BeanConverter" href="../../../../../org/apache/juneau/junit/bct/BeanConverter.html#BeanConverter">BeanConverter</a> converter, Object o, String name) {
+<a class="jxr_linenumber" name="L103" href="#L103">103</a> <strong class="jxr_keyword">return</strong> converter.canListify(o);
+<a class="jxr_linenumber" name="L104" href="#L104">104</a> }
+<a class="jxr_linenumber" name="L105" href="#L105">105</a>
+<a class="jxr_linenumber" name="L106" href="#L106">106</a> @Override
+<a class="jxr_linenumber" name="L107" href="#L107">107</a> <strong class="jxr_keyword">public</strong> Object extract(<a name="BeanConverter" href="../../../../../org/apache/juneau/junit/bct/BeanConverter.html#BeanConverter">BeanConverter</a> converter, Object o, String name) {
+<a class="jxr_linenumber" name="L108" href="#L108">108</a> <strong class="jxr_keyword">var</strong> l = converter.listify(o);
+<a class="jxr_linenumber" name="L109" href="#L109">109</a> <strong class="jxr_keyword">if</strong> (name.matches(<span class="jxr_string">"-?\\d+"</span>)) {
+<a class="jxr_linenumber" name="L110" href="#L110">110</a> <strong class="jxr_keyword">var</strong> index = StringUtils.parseInt(name);
+<a class="jxr_linenumber" name="L111" href="#L111">111</a> <strong class="jxr_keyword">if</strong> (index < 0) {
+<a class="jxr_linenumber" name="L112" href="#L112">112</a> index = l.size() + index; <em class="jxr_comment">// Convert negative index to positive</em>
+<a class="jxr_linenumber" name="L113" href="#L113">113</a> }
+<a class="jxr_linenumber" name="L114" href="#L114">114</a> <strong class="jxr_keyword">return</strong> l.get(index);
+<a class="jxr_linenumber" name="L115" href="#L115">115</a> }
+<a class="jxr_linenumber" name="L116" href="#L116">116</a> <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"length"</span>.equals(name))
<a class="jxr_linenumber" name="L117" href="#L117">117</a> <strong class="jxr_keyword">return</strong> l.size();
-<a class="jxr_linenumber" name="L118" href="#L118">118</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">super</strong>.extract(converter, o, name);
-<a class="jxr_linenumber" name="L119" href="#L119">119</a> }
-<a class="jxr_linenumber" name="L120" href="#L120">120</a> }
-<a class="jxr_linenumber" name="L121" href="#L121">121</a>
-<a class="jxr_linenumber" name="L122" href="#L122">122</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L123" href="#L123">123</a> <em class="jxr_javadoccomment"> * Property extractor for Map objects with direct key access and size property.</em>
-<a class="jxr_linenumber" name="L124" href="#L124">124</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L125" href="#L125">125</a> <em class="jxr_javadoccomment"> * <p>This extractor extends {@link ObjectPropertyExtractor} to add special handling for</em>
-<a class="jxr_linenumber" name="L126" href="#L126">126</a> <em class="jxr_javadoccomment"> * Map objects. It provides direct key-based property access and a universal size</em>
-<a class="jxr_linenumber" name="L127" href="#L127">127</a> <em class="jxr_javadoccomment"> * property for Map objects.</p></em>
-<a class="jxr_linenumber" name="L128" href="#L128">128</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L129" href="#L129">129</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Map-Specific Properties:</h5></em>
-<a class="jxr_linenumber" name="L130" href="#L130">130</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L131" href="#L131">131</a> <em class="jxr_javadoccomment"> * <li><b>Direct key access:</b> Any property name that exists as a Map key</li></em>
-<a class="jxr_linenumber" name="L132" href="#L132">132</a> <em class="jxr_javadoccomment"> * <li><b>Size property:</b> {@code "size"} returns {@code map.size()}</li></em>
-<a class="jxr_linenumber" name="L133" href="#L133">133</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L134" href="#L134">134</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L135" href="#L135">135</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Supported Types:</h5></em>
-<a class="jxr_linenumber" name="L136" href="#L136">136</a> <em class="jxr_javadoccomment"> * <p>Works with any object implementing the {@code Map} interface:</p></em>
-<a class="jxr_linenumber" name="L137" href="#L137">137</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L138" href="#L138">138</a> <em class="jxr_javadoccomment"> * <li><b>HashMap, LinkedHashMap:</b> Standard Map implementations</li></em>
-<a class="jxr_linenumber" name="L139" href="#L139">139</a> <em class="jxr_javadoccomment"> * <li><b>TreeMap, ConcurrentHashMap:</b> Specialized Map implementations</li></em>
-<a class="jxr_linenumber" name="L140" href="#L140">140</a> <em class="jxr_javadoccomment"> * <li><b>Properties:</b> Java Properties objects</li></em>
-<a class="jxr_linenumber" name="L141" href="#L141">141</a> <em class="jxr_javadoccomment"> * <li><b>Custom Maps:</b> Any Map implementation</li></em>
-<a class="jxr_linenumber" name="L142" href="#L142">142</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L143" href="#L143">143</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L144" href="#L144">144</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L145" href="#L145">145</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L146" href="#L146">146</a> <em class="jxr_javadoccomment"> * <jc>// Direct key access</jc></em>
-<a class="jxr_linenumber" name="L147" href="#L147">147</a> <em class="jxr_javadoccomment"> * <jv>map</jv>.get(<js>"name"</js>) <jc>// "name" property</jc></em>
-<a class="jxr_linenumber" name="L148" href="#L148">148</a> <em class="jxr_javadoccomment"> * <jv>map</jv>.get(<js>"timeout"</js>) <jc>// "timeout" property</jc></em>
-<a class="jxr_linenumber" name="L149" href="#L149">149</a> <em class="jxr_javadoccomment"> * <jv>props</jv>.getProperty(<js>"key"</js>) <jc>// "key" property</jc></em>
-<a class="jxr_linenumber" name="L150" href="#L150">150</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L151" href="#L151">151</a> <em class="jxr_javadoccomment"> * <jc>// Size access</jc></em>
-<a class="jxr_linenumber" name="L152" href="#L152">152</a> <em class="jxr_javadoccomment"> * <jv>map</jv>.size() <jc>// "size" property</jc></em>
-<a class="jxr_linenumber" name="L153" href="#L153">153</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L154" href="#L154">154</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L155" href="#L155">155</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Key Priority:</h5></em>
-<a class="jxr_linenumber" name="L156" href="#L156">156</a> <em class="jxr_javadoccomment"> * <p>Map key access takes priority over JavaBean properties. If a Map contains</em>
-<a class="jxr_linenumber" name="L157" href="#L157">157</a> <em class="jxr_javadoccomment"> * a key with the same name as a property/method, the Map value is returned first.</p></em>
-<a class="jxr_linenumber" name="L158" href="#L158">158</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L159" href="#L159">159</a> <em class="jxr_javadoccomment"> * <p><b>Fallback:</b> If the property is not found as a Map key and is not "size",</em>
-<a class="jxr_linenumber" name="L160" href="#L160">160</a> <em class="jxr_javadoccomment"> * delegates to {@link ObjectPropertyExtractor} for standard property access.</p></em>
-<a class="jxr_linenumber" name="L161" href="#L161">161</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L162" href="#L162">162</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">class</strong> MapPropertyExtractor <strong class="jxr_keyword">extends</strong> ObjectPropertyExtractor {
-<a class="jxr_linenumber" name="L163" href="#L163">163</a>
-<a class="jxr_linenumber" name="L164" href="#L164">164</a> @Override
-<a class="jxr_linenumber" name="L165" href="#L165">165</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> canExtract(<a name="BeanConverter" href="../../../../../org/apache/juneau/junit/bct/BeanConverter.html#BeanConverter">BeanConverter</a> converter, Object o, String name) {
-<a class="jxr_linenumber" name="L166" href="#L166">166</a> <strong class="jxr_keyword">return</strong> o instanceof Map;
-<a class="jxr_linenumber" name="L167" href="#L167">167</a> }
-<a class="jxr_linenumber" name="L168" href="#L168">168</a>
-<a class="jxr_linenumber" name="L169" href="#L169">169</a> @Override
-<a class="jxr_linenumber" name="L170" href="#L170">170</a> <strong class="jxr_keyword">public</strong> Object extract(<a name="BeanConverter" href="../../../../../org/apache/juneau/junit/bct/BeanConverter.html#BeanConverter">BeanConverter</a> converter, Object o, String name) {
-<a class="jxr_linenumber" name="L171" href="#L171">171</a> <strong class="jxr_keyword">var</strong> m = (Map<?,?>)o;
-<a class="jxr_linenumber" name="L172" href="#L172">172</a> <strong class="jxr_keyword">if</strong> (eq(name, converter.getSetting(BasicBeanConverter.SETTING_nullValue, <span class="jxr_string">"<null>"</span>)))
-<a class="jxr_linenumber" name="L173" href="#L173">173</a> name = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L174" href="#L174">174</a> <strong class="jxr_keyword">if</strong> (m.containsKey(name))
-<a class="jxr_linenumber" name="L175" href="#L175">175</a> <strong class="jxr_keyword">return</strong> m.get(name);
-<a class="jxr_linenumber" name="L176" href="#L176">176</a> <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"size"</span>.equals(name))
-<a class="jxr_linenumber" name="L177" href="#L177">177</a> <strong class="jxr_keyword">return</strong> m.size();
-<a class="jxr_linenumber" name="L178" href="#L178">178</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">super</strong>.extract(converter, o, name);
-<a class="jxr_linenumber" name="L179" href="#L179">179</a> }
-<a class="jxr_linenumber" name="L180" href="#L180">180</a> }
-<a class="jxr_linenumber" name="L181" href="#L181">181</a>
-<a class="jxr_linenumber" name="L182" href="#L182">182</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L183" href="#L183">183</a> <em class="jxr_javadoccomment"> * Standard JavaBean property extractor using reflection.</em>
-<a class="jxr_linenumber" name="L184" href="#L184">184</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L185" href="#L185">185</a> <em class="jxr_javadoccomment"> * <p>This extractor serves as the universal fallback for property access, implementing</em>
-<a class="jxr_linenumber" name="L186" href="#L186">186</a> <em class="jxr_javadoccomment"> * comprehensive JavaBean property access patterns. It tries multiple approaches to</em>
-<a class="jxr_linenumber" name="L187" href="#L187">187</a> <em class="jxr_javadoccomment"> * access object properties, providing maximum compatibility with different coding styles.</p></em>
-<a class="jxr_linenumber" name="L188" href="#L188">188</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L189" href="#L189">189</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Property Access Order:</h5></em>
-<a class="jxr_linenumber" name="L190" href="#L190">190</a> <em class="jxr_javadoccomment"> * <ol></em>
-<a class="jxr_linenumber" name="L191" href="#L191">191</a> <em class="jxr_javadoccomment"> * <li><b>{@code is{Property}()}</b> - Boolean property getters (e.g., {@code isActive()})</li></em>
-<a class="jxr_linenumber" name="L192" href="#L192">192</a> <em class="jxr_javadoccomment"> * <li><b>{@code get{Property}()}</b> - Standard getter methods (e.g., {@code getName()})</li></em>
-<a class="jxr_linenumber" name="L193" href="#L193">193</a> <em class="jxr_javadoccomment"> * <li><b>{@code get(String)}</b> - Map-style property access with property name as parameter</li></em>
-<a class="jxr_linenumber" name="L194" href="#L194">194</a> <em class="jxr_javadoccomment"> * <li><b>Fields</b> - Public fields with matching names (searches inheritance hierarchy)</li></em>
-<a class="jxr_linenumber" name="L195" href="#L195">195</a> <em class="jxr_javadoccomment"> * <li><b>{@code {property}()}</b> - No-argument methods with exact property name</li></em>
-<a class="jxr_linenumber" name="L196" href="#L196">196</a> <em class="jxr_javadoccomment"> * </ol></em>
-<a class="jxr_linenumber" name="L197" href="#L197">197</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L198" href="#L198">198</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L199" href="#L199">199</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L200" href="#L200">200</a> <em class="jxr_javadoccomment"> * <jc>// Property "name" can be accessed via:</jc></em>
-<a class="jxr_linenumber" name="L201" href="#L201">201</a> <em class="jxr_javadoccomment"> * <jv>obj</jv>.getName() <jc>// Standard getter</jc></em>
-<a class="jxr_linenumber" name="L202" href="#L202">202</a> <em class="jxr_javadoccomment"> * <jv>obj</jv>.name <jc>// Public field</jc></em>
-<a class="jxr_linenumber" name="L203" href="#L203">203</a> <em class="jxr_javadoccomment"> * <jv>obj</jv>.name() <jc>// Method with property name</jc></em>
-<a class="jxr_linenumber" name="L204" href="#L204">204</a> <em class="jxr_javadoccomment"> * <jv>obj</jv>.get(<js>"name"</js>) <jc>// Map-style getter</jc></em>
-<a class="jxr_linenumber" name="L205" href="#L205">205</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L206" href="#L206">206</a> <em class="jxr_javadoccomment"> * <jc>// Property "active" (boolean) can be accessed via:</jc></em>
-<a class="jxr_linenumber" name="L207" href="#L207">207</a> <em class="jxr_javadoccomment"> * <jv>obj</jv>.isActive() <jc>// Boolean getter</jc></em>
-<a class="jxr_linenumber" name="L208" href="#L208">208</a> <em class="jxr_javadoccomment"> * <jv>obj</jv>.getActive() <jc>// Standard getter alternative</jc></em>
-<a class="jxr_linenumber" name="L209" href="#L209">209</a> <em class="jxr_javadoccomment"> * <jv>obj</jv>.active <jc>// Public field</jc></em>
-<a class="jxr_linenumber" name="L210" href="#L210">210</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L211" href="#L211">211</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L212" href="#L212">212</a> <em class="jxr_javadoccomment"> * <p><b>Compatibility:</b> This extractor can handle any object type, making it the</em>
-<a class="jxr_linenumber" name="L213" href="#L213">213</a> <em class="jxr_javadoccomment"> * universal fallback. It always returns {@code true} from {@link #canExtract(BeanConverter, Object, String)}.</p></em>
-<a class="jxr_linenumber" name="L214" href="#L214">214</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L215" href="#L215">215</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">class</strong> ObjectPropertyExtractor <strong class="jxr_keyword">implements</strong> <a name="PropertyExtractor" href="../../../../../org/apache/juneau/junit/bct/PropertyExtractor.html#PropertyExtractor">PropertyExtractor</a> {
-<a class="jxr_linenumber" name="L216" href="#L216">216</a>
-<a class="jxr_linenumber" name="L217" href="#L217">217</a> @Override
-<a class="jxr_linenumber" name="L218" href="#L218">218</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> canExtract(<a name="BeanConverter" href="../../../../../org/apache/juneau/junit/bct/BeanConverter.html#BeanConverter">BeanConverter</a> converter, Object o, String name) {
-<a class="jxr_linenumber" name="L219" href="#L219">219</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L220" href="#L220">220</a> }
-<a class="jxr_linenumber" name="L221" href="#L221">221</a>
-<a class="jxr_linenumber" name="L222" href="#L222">222</a> @SuppressWarnings(<span class="jxr_string">"null"</span>)
-<a class="jxr_linenumber" name="L223" href="#L223">223</a> @Override
-<a class="jxr_linenumber" name="L224" href="#L224">224</a> <strong class="jxr_keyword">public</strong> Object extract(<a name="BeanConverter" href="../../../../../org/apache/juneau/junit/bct/BeanConverter.html#BeanConverter">BeanConverter</a> converter, Object o, String name) {
-<a class="jxr_linenumber" name="L225" href="#L225">225</a> <strong class="jxr_keyword">return</strong> safe(() -> {
-<a class="jxr_linenumber" name="L226" href="#L226">226</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L227" href="#L227">227</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L228" href="#L228">228</a> <strong class="jxr_keyword">var</strong> f = (Field)<strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L229" href="#L229">229</a> <strong class="jxr_keyword">var</strong> c = o.getClass();
-<a class="jxr_linenumber" name="L230" href="#L230">230</a> <strong class="jxr_keyword">var</strong> n = Character.toUpperCase(name.charAt(0)) + name.substring(1);
-<a class="jxr_linenumber" name="L231" href="#L231">231</a> <strong class="jxr_keyword">var</strong> m = Arrays.stream(c.getMethods()).filter(x -> x.getName().equals(<span class="jxr_string">"is"</span> + n) && x.getParameterCount() == 0).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L232" href="#L232">232</a> <strong class="jxr_keyword">if</strong> (nn(m)) {
-<a class="jxr_linenumber" name="L233" href="#L233">233</a> m.setAccessible(<strong class="jxr_keyword">true</strong>);
-<a class="jxr_linenumber" name="L234" href="#L234">234</a> <strong class="jxr_keyword">return</strong> m.invoke(o);
-<a class="jxr_linenumber" name="L235" href="#L235">235</a> }
-<a class="jxr_linenumber" name="L236" href="#L236">236</a> <strong class="jxr_keyword">if</strong> (o instanceof Map.Entry<?,?> me) {
-<a class="jxr_linenumber" name="L237" href="#L237">237</a> <em class="jxr_comment">// Reflection to classes inside java.util are restricted in Java 9+.</em>
-<a class="jxr_linenumber" name="L238" href="#L238">238</a> <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"key"</span>.equals(name))
-<a class="jxr_linenumber" name="L239" href="#L239">239</a> <strong class="jxr_keyword">return</strong> me.getKey();
-<a class="jxr_linenumber" name="L240" href="#L240">240</a> <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"value"</span>.equals(name))
-<a class="jxr_linenumber" name="L241" href="#L241">241</a> <strong class="jxr_keyword">return</strong> me.getValue();
-<a class="jxr_linenumber" name="L242" href="#L242">242</a> }
-<a class="jxr_linenumber" name="L243" href="#L243">243</a> m = Arrays.stream(c.getMethods()).filter(x -> x.getName().equals(<span class="jxr_string">"get"</span> + n) && x.getParameterCount() == 0).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L244" href="#L244">244</a> <strong class="jxr_keyword">if</strong> (nn(m)) {
-<a class="jxr_linenumber" name="L245" href="#L245">245</a> m.setAccessible(<strong class="jxr_keyword">true</strong>);
-<a class="jxr_linenumber" name="L246" href="#L246">246</a> <strong class="jxr_keyword">return</strong> m.invoke(o);
-<a class="jxr_linenumber" name="L247" href="#L247">247</a> }
-<a class="jxr_linenumber" name="L248" href="#L248">248</a> m = Arrays.stream(c.getMethods()).filter(x -> x.getName().equals(<span class="jxr_string">"get"</span>) && x.getParameterCount() == 1 && x.getParameterTypes()[0] == String.<strong class="jxr_keyword">class</strong>).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L249" href="#L249">249</a> <strong class="jxr_keyword">if</strong> (nn(m)) {
-<a class="jxr_linenumber" name="L250" href="#L250">250</a> m.setAccessible(<strong class="jxr_keyword">true</strong>);
-<a class="jxr_linenumber" name="L251" href="#L251">251</a> <strong class="jxr_keyword">return</strong> m.invoke(o, name);
-<a class="jxr_linenumber" name="L252" href="#L252">252</a> }
-<a class="jxr_linenumber" name="L253" href="#L253">253</a> <strong class="jxr_keyword">var</strong> c2 = c;
-<a class="jxr_linenumber" name="L254" href="#L254">254</a> <strong class="jxr_keyword">while</strong> (f == <strong class="jxr_keyword">null</strong> && nn(c2)) {
-<a class="jxr_linenumber" name="L255" href="#L255">255</a> f = Arrays.stream(c2.getDeclaredFields()).filter(x -> x.getName().equals(name)).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L256" href="#L256">256</a> c2 = c2.getSuperclass();
-<a class="jxr_linenumber" name="L257" href="#L257">257</a> }
-<a class="jxr_linenumber" name="L258" href="#L258">258</a> <strong class="jxr_keyword">if</strong> (nn(f)) {
-<a class="jxr_linenumber" name="L259" href="#L259">259</a> f.setAccessible(<strong class="jxr_keyword">true</strong>);
-<a class="jxr_linenumber" name="L260" href="#L260">260</a> <strong class="jxr_keyword">return</strong> f.get(o);
-<a class="jxr_linenumber" name="L261" href="#L261">261</a> }
-<a class="jxr_linenumber" name="L262" href="#L262">262</a> m = Arrays.stream(c.getMethods()).filter(x -> x.getName().equals(name) && x.getParameterCount() == 0).findFirst().orElse(<strong class="jxr_keyword">null</strong>);
-<a class="jxr_linenumber" name="L263" href="#L263">263</a> <strong class="jxr_keyword">if</strong> (nn(m)) {
-<a class="jxr_linenumber" name="L264" href="#L264">264</a> m.setAccessible(<strong class="jxr_keyword">true</strong>);
-<a class="jxr_linenumber" name="L265" href="#L265">265</a> <strong class="jxr_keyword">return</strong> m.invoke(o);
-<a class="jxr_linenumber" name="L266" href="#L266">266</a> }
-<a class="jxr_linenumber" name="L267" href="#L267">267</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="PropertyNotFoundException" href="../../../../../org/apache/juneau/junit/bct/PropertyNotFoundException.html#PropertyNotFoundException">PropertyNotFoundException</a>(name, o.getClass());
-<a class="jxr_linenumber" name="L268" href="#L268">268</a> });
-<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="L271" href="#L271">271</a>
-<a class="jxr_linenumber" name="L272" href="#L272">272</a> <strong class="jxr_keyword">private</strong> <a name="PropertyExtractors" href="../../../../../org/apache/juneau/junit/bct/PropertyExtractors.html#PropertyExtractors">PropertyExtractors</a>() {}
-<a class="jxr_linenumber" name="L273" href="#L273">273</a> }
+<a class="jxr_linenumber" name="L118" href="#L118">118</a> <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"size"</span>.equals(name))
+<a class="jxr_linenumber" name="L119" href="#L119">119</a> <strong class="jxr_keyword">return</strong> l.size();
+<a class="jxr_linenumber" name="L120" href="#L120">120</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">super</strong>.extract(converter, o, name);
+<a class="jxr_linenumber" name="L121" href="#L121">121</a> }
+<a class="jxr_linenumber" name="L122" href="#L122">122</a> }
+<a class="jxr_linenumber" name="L123" href="#L123">123</a>
+<a class="jxr_linenumber" name="L124" href="#L124">124</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L125" href="#L125">125</a> <em class="jxr_javadoccomment"> * Property extractor for Map objects with direct key access and size property.</em>
+<a class="jxr_linenumber" name="L126" href="#L126">126</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L127" href="#L127">127</a> <em class="jxr_javadoccomment"> * <p>This extractor extends {@link ObjectPropertyExtractor} to add special handling for</em>
+<a class="jxr_linenumber" name="L128" href="#L128">128</a> <em class="jxr_javadoccomment"> * Map objects. It provides direct key-based property access and a universal size</em>
+<a class="jxr_linenumber" name="L129" href="#L129">129</a> <em class="jxr_javadoccomment"> * property for Map objects.</p></em>
+<a class="jxr_linenumber" name="L130" href="#L130">130</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L131" href="#L131">131</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Map-Specific Properties:</h5></em>
+<a class="jxr_linenumber" name="L132" href="#L132">132</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L133" href="#L133">133</a> <em class="jxr_javadoccomment"> * <li><b>Direct key access:</b> Any property name that exists as a Map key</li></em>
+<a class="jxr_linenumber" name="L134" href="#L134">134</a> <em class="jxr_javadoccomment"> * <li><b>Size property:</b> {@code "size"} returns {@code map.size()}</li></em>
+<a class="jxr_linenumber" name="L135" href="#L135">135</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L136" href="#L136">136</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L137" href="#L137">137</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Supported Types:</h5></em>
+<a class="jxr_linenumber" name="L138" href="#L138">138</a> <em class="jxr_javadoccomment"> * <p>Works with any object implementing the {@code Map} interface:</p></em>
+<a class="jxr_linenumber" name="L139" href="#L139">139</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L140" href="#L140">140</a> <em class="jxr_javadoccomment"> * <li><b>HashMap, LinkedHashMap:</b> Standard Map implementations</li></em>
+<a class="jxr_linenumber" name="L141" href="#L141">141</a> <em class="jxr_javadoccomment"> * <li><b>TreeMap, ConcurrentHashMap:</b> Specialized Map implementations</li></em>
+<a class="jxr_linenumber" name="L142" href="#L142">142</a> <em class="jxr_javadoccomment"> * <li><b>Properties:</b> Java Properties objects</li></em>
+<a class="jxr_linenumber" name="L143" href="#L143">143</a> <em class="jxr_javadoccomment"> * <li><b>Custom Maps:</b> Any Map implementation</li></em>
... 3095 lines suppressed ...