You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2017/08/14 00:27:48 UTC
[12/25] incubator-juneau-website git commit: Add @RestHook support.
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/84931d4d/content/site/apidocs/src-html/org/apache/juneau/internal/StringUtils.html
----------------------------------------------------------------------
diff --git a/content/site/apidocs/src-html/org/apache/juneau/internal/StringUtils.html b/content/site/apidocs/src-html/org/apache/juneau/internal/StringUtils.html
index e37c845..a7608b4 100644
--- a/content/site/apidocs/src-html/org/apache/juneau/internal/StringUtils.html
+++ b/content/site/apidocs/src-html/org/apache/juneau/internal/StringUtils.html
@@ -1018,628 +1018,631 @@
<span class="sourceLineNo">1010</span> */<a name="line.1010"></a>
<span class="sourceLineNo">1011</span> public static String replaceVars(String s, Map<String,Object> m) {<a name="line.1011"></a>
<span class="sourceLineNo">1012</span><a name="line.1012"></a>
-<span class="sourceLineNo">1013</span> if (s.indexOf('{') == -1)<a name="line.1013"></a>
-<span class="sourceLineNo">1014</span> return s;<a name="line.1014"></a>
+<span class="sourceLineNo">1013</span> if (s == null)<a name="line.1013"></a>
+<span class="sourceLineNo">1014</span> return null;<a name="line.1014"></a>
<span class="sourceLineNo">1015</span><a name="line.1015"></a>
-<span class="sourceLineNo">1016</span> int S1 = 1; // Not in variable, looking for {<a name="line.1016"></a>
-<span class="sourceLineNo">1017</span> int S2 = 2; // Found {, Looking for }<a name="line.1017"></a>
+<span class="sourceLineNo">1016</span> if (s.indexOf('{') == -1)<a name="line.1016"></a>
+<span class="sourceLineNo">1017</span> return s;<a name="line.1017"></a>
<span class="sourceLineNo">1018</span><a name="line.1018"></a>
-<span class="sourceLineNo">1019</span> int state = S1;<a name="line.1019"></a>
-<span class="sourceLineNo">1020</span> boolean hasInternalVar = false;<a name="line.1020"></a>
-<span class="sourceLineNo">1021</span> int x = 0;<a name="line.1021"></a>
-<span class="sourceLineNo">1022</span> int depth = 0;<a name="line.1022"></a>
-<span class="sourceLineNo">1023</span> int length = s.length();<a name="line.1023"></a>
-<span class="sourceLineNo">1024</span> StringBuilder out = new StringBuilder();<a name="line.1024"></a>
-<span class="sourceLineNo">1025</span> for (int i = 0; i < length; i++) {<a name="line.1025"></a>
-<span class="sourceLineNo">1026</span> char c = s.charAt(i);<a name="line.1026"></a>
-<span class="sourceLineNo">1027</span> if (state == S1) {<a name="line.1027"></a>
-<span class="sourceLineNo">1028</span> if (c == '{') {<a name="line.1028"></a>
-<span class="sourceLineNo">1029</span> state = S2;<a name="line.1029"></a>
-<span class="sourceLineNo">1030</span> x = i;<a name="line.1030"></a>
-<span class="sourceLineNo">1031</span> } else {<a name="line.1031"></a>
-<span class="sourceLineNo">1032</span> out.append(c);<a name="line.1032"></a>
-<span class="sourceLineNo">1033</span> }<a name="line.1033"></a>
-<span class="sourceLineNo">1034</span> } else /* state == S2 */ {<a name="line.1034"></a>
-<span class="sourceLineNo">1035</span> if (c == '{') {<a name="line.1035"></a>
-<span class="sourceLineNo">1036</span> depth++;<a name="line.1036"></a>
-<span class="sourceLineNo">1037</span> hasInternalVar = true;<a name="line.1037"></a>
-<span class="sourceLineNo">1038</span> } else if (c == '}') {<a name="line.1038"></a>
-<span class="sourceLineNo">1039</span> if (depth > 0) {<a name="line.1039"></a>
-<span class="sourceLineNo">1040</span> depth--;<a name="line.1040"></a>
-<span class="sourceLineNo">1041</span> } else {<a name="line.1041"></a>
-<span class="sourceLineNo">1042</span> String key = s.substring(x+1, i);<a name="line.1042"></a>
-<span class="sourceLineNo">1043</span> key = (hasInternalVar ? replaceVars(key, m) : key);<a name="line.1043"></a>
-<span class="sourceLineNo">1044</span> hasInternalVar = false;<a name="line.1044"></a>
-<span class="sourceLineNo">1045</span> if (! m.containsKey(key))<a name="line.1045"></a>
-<span class="sourceLineNo">1046</span> out.append('{').append(key).append('}');<a name="line.1046"></a>
-<span class="sourceLineNo">1047</span> else {<a name="line.1047"></a>
-<span class="sourceLineNo">1048</span> Object val = m.get(key);<a name="line.1048"></a>
-<span class="sourceLineNo">1049</span> if (val == null)<a name="line.1049"></a>
-<span class="sourceLineNo">1050</span> val = "";<a name="line.1050"></a>
-<span class="sourceLineNo">1051</span> String v = val.toString();<a name="line.1051"></a>
-<span class="sourceLineNo">1052</span> // If the replacement also contains variables, replace them now.<a name="line.1052"></a>
-<span class="sourceLineNo">1053</span> if (v.indexOf('{') != -1)<a name="line.1053"></a>
-<span class="sourceLineNo">1054</span> v = replaceVars(v, m);<a name="line.1054"></a>
-<span class="sourceLineNo">1055</span> out.append(v);<a name="line.1055"></a>
-<span class="sourceLineNo">1056</span> }<a name="line.1056"></a>
-<span class="sourceLineNo">1057</span> state = 1;<a name="line.1057"></a>
-<span class="sourceLineNo">1058</span> }<a name="line.1058"></a>
-<span class="sourceLineNo">1059</span> }<a name="line.1059"></a>
-<span class="sourceLineNo">1060</span> }<a name="line.1060"></a>
-<span class="sourceLineNo">1061</span> }<a name="line.1061"></a>
-<span class="sourceLineNo">1062</span> return out.toString();<a name="line.1062"></a>
-<span class="sourceLineNo">1063</span> }<a name="line.1063"></a>
-<span class="sourceLineNo">1064</span><a name="line.1064"></a>
-<span class="sourceLineNo">1065</span> /**<a name="line.1065"></a>
-<span class="sourceLineNo">1066</span> * Returns <jk>true</jk> if the specified path string is prefixed with the specified prefix.<a name="line.1066"></a>
-<span class="sourceLineNo">1067</span> *<a name="line.1067"></a>
-<span class="sourceLineNo">1068</span> * <h5 class='section'>Example:</h5><a name="line.1068"></a>
-<span class="sourceLineNo">1069</span> * <p class='bcode'><a name="line.1069"></a>
-<span class="sourceLineNo">1070</span> * pathStartsWith(<js>"foo"</js>, <js>"foo"</js>); <jc>// true</jc><a name="line.1070"></a>
-<span class="sourceLineNo">1071</span> * pathStartsWith(<js>"foo/bar"</js>, <js>"foo"</js>); <jc>// true</jc><a name="line.1071"></a>
-<span class="sourceLineNo">1072</span> * pathStartsWith(<js>"foo2"</js>, <js>"foo"</js>); <jc>// false</jc><a name="line.1072"></a>
-<span class="sourceLineNo">1073</span> * pathStartsWith(<js>"foo2"</js>, <js>""</js>); <jc>// false</jc><a name="line.1073"></a>
-<span class="sourceLineNo">1074</span> * </p><a name="line.1074"></a>
-<span class="sourceLineNo">1075</span> *<a name="line.1075"></a>
-<span class="sourceLineNo">1076</span> * @param path The path to check.<a name="line.1076"></a>
-<span class="sourceLineNo">1077</span> * @param pathPrefix The prefix.<a name="line.1077"></a>
-<span class="sourceLineNo">1078</span> * @return <jk>true</jk> if the specified path string is prefixed with the specified prefix.<a name="line.1078"></a>
-<span class="sourceLineNo">1079</span> */<a name="line.1079"></a>
-<span class="sourceLineNo">1080</span> public static boolean pathStartsWith(String path, String pathPrefix) {<a name="line.1080"></a>
-<span class="sourceLineNo">1081</span> if (path == null || pathPrefix == null)<a name="line.1081"></a>
-<span class="sourceLineNo">1082</span> return false;<a name="line.1082"></a>
-<span class="sourceLineNo">1083</span> if (path.startsWith(pathPrefix))<a name="line.1083"></a>
-<span class="sourceLineNo">1084</span> return path.length() == pathPrefix.length() || path.charAt(pathPrefix.length()) == '/';<a name="line.1084"></a>
-<span class="sourceLineNo">1085</span> return false;<a name="line.1085"></a>
-<span class="sourceLineNo">1086</span> }<a name="line.1086"></a>
-<span class="sourceLineNo">1087</span><a name="line.1087"></a>
-<span class="sourceLineNo">1088</span> /**<a name="line.1088"></a>
-<span class="sourceLineNo">1089</span> * Same as {@link #pathStartsWith(String, String)} but returns <jk>true</jk> if at least one prefix matches.<a name="line.1089"></a>
-<span class="sourceLineNo">1090</span> *<a name="line.1090"></a>
-<span class="sourceLineNo">1091</span> * @param path The path to check.<a name="line.1091"></a>
-<span class="sourceLineNo">1092</span> * @param pathPrefixes The prefixes.<a name="line.1092"></a>
-<span class="sourceLineNo">1093</span> * @return <jk>true</jk> if the specified path string is prefixed with any of the specified prefixes.<a name="line.1093"></a>
-<span class="sourceLineNo">1094</span> */<a name="line.1094"></a>
-<span class="sourceLineNo">1095</span> public static boolean pathStartsWith(String path, String[] pathPrefixes) {<a name="line.1095"></a>
-<span class="sourceLineNo">1096</span> for (String p : pathPrefixes)<a name="line.1096"></a>
-<span class="sourceLineNo">1097</span> if (pathStartsWith(path, p))<a name="line.1097"></a>
-<span class="sourceLineNo">1098</span> return true;<a name="line.1098"></a>
-<span class="sourceLineNo">1099</span> return false;<a name="line.1099"></a>
-<span class="sourceLineNo">1100</span> }<a name="line.1100"></a>
-<span class="sourceLineNo">1101</span><a name="line.1101"></a>
-<span class="sourceLineNo">1102</span> /**<a name="line.1102"></a>
-<span class="sourceLineNo">1103</span> * Replaces <js>"\\uXXXX"</js> character sequences with their unicode characters.<a name="line.1103"></a>
-<span class="sourceLineNo">1104</span> *<a name="line.1104"></a>
-<span class="sourceLineNo">1105</span> * @param s The string to replace unicode sequences in.<a name="line.1105"></a>
-<span class="sourceLineNo">1106</span> * @return A string with unicode sequences replaced.<a name="line.1106"></a>
-<span class="sourceLineNo">1107</span> */<a name="line.1107"></a>
-<span class="sourceLineNo">1108</span> public static String replaceUnicodeSequences(String s) {<a name="line.1108"></a>
-<span class="sourceLineNo">1109</span> if (s.indexOf('\\') == -1)<a name="line.1109"></a>
-<span class="sourceLineNo">1110</span> return s;<a name="line.1110"></a>
-<span class="sourceLineNo">1111</span> Pattern p = Pattern.compile("\\\\u(\\p{XDigit}{4})");<a name="line.1111"></a>
-<span class="sourceLineNo">1112</span> Matcher m = p.matcher(s);<a name="line.1112"></a>
-<span class="sourceLineNo">1113</span> StringBuffer sb = new StringBuffer(s.length());<a name="line.1113"></a>
-<span class="sourceLineNo">1114</span> while (m.find()) {<a name="line.1114"></a>
-<span class="sourceLineNo">1115</span> String ch = String.valueOf((char) Integer.parseInt(m.group(1), 16));<a name="line.1115"></a>
-<span class="sourceLineNo">1116</span> m.appendReplacement(sb, Matcher.quoteReplacement(ch));<a name="line.1116"></a>
-<span class="sourceLineNo">1117</span> }<a name="line.1117"></a>
-<span class="sourceLineNo">1118</span> m.appendTail(sb);<a name="line.1118"></a>
-<span class="sourceLineNo">1119</span> return sb.toString();<a name="line.1119"></a>
-<span class="sourceLineNo">1120</span> }<a name="line.1120"></a>
-<span class="sourceLineNo">1121</span><a name="line.1121"></a>
-<span class="sourceLineNo">1122</span> /**<a name="line.1122"></a>
-<span class="sourceLineNo">1123</span> * Returns the specified field in a delimited string without splitting the string.<a name="line.1123"></a>
-<span class="sourceLineNo">1124</span> *<a name="line.1124"></a>
-<span class="sourceLineNo">1125</span> * <p><a name="line.1125"></a>
-<span class="sourceLineNo">1126</span> * Equivalent to the following:<a name="line.1126"></a>
-<span class="sourceLineNo">1127</span> * <p class='bcode'><a name="line.1127"></a>
-<span class="sourceLineNo">1128</span> * String in = <js>"0,1,2"</js>;<a name="line.1128"></a>
-<span class="sourceLineNo">1129</span> * String[] parts = in.split(<js>","</js>);<a name="line.1129"></a>
-<span class="sourceLineNo">1130</span> * String p1 = (parts.<jk>length</jk> > 1 ? parts[1] : <js>""</js>);<a name="line.1130"></a>
-<span class="sourceLineNo">1131</span> * </p><a name="line.1131"></a>
-<span class="sourceLineNo">1132</span> *<a name="line.1132"></a>
-<span class="sourceLineNo">1133</span> * @param fieldNum The field number. Zero-indexed.<a name="line.1133"></a>
-<span class="sourceLineNo">1134</span> * @param s The input string.<a name="line.1134"></a>
-<span class="sourceLineNo">1135</span> * @param delim The delimiter character.<a name="line.1135"></a>
-<span class="sourceLineNo">1136</span> * @return The field entry in the string, or a blank string if it doesn't exist or the string is null.<a name="line.1136"></a>
-<span class="sourceLineNo">1137</span> */<a name="line.1137"></a>
-<span class="sourceLineNo">1138</span> public static String getField(int fieldNum, String s, char delim) {<a name="line.1138"></a>
-<span class="sourceLineNo">1139</span> return getField(fieldNum, s, delim, "");<a name="line.1139"></a>
-<span class="sourceLineNo">1140</span> }<a name="line.1140"></a>
-<span class="sourceLineNo">1141</span><a name="line.1141"></a>
-<span class="sourceLineNo">1142</span> /**<a name="line.1142"></a>
-<span class="sourceLineNo">1143</span> * Same as {@link #getField(int, String, char)} except allows you to specify the default value.<a name="line.1143"></a>
-<span class="sourceLineNo">1144</span> *<a name="line.1144"></a>
-<span class="sourceLineNo">1145</span> * @param fieldNum The field number. Zero-indexed.<a name="line.1145"></a>
-<span class="sourceLineNo">1146</span> * @param s The input string.<a name="line.1146"></a>
-<span class="sourceLineNo">1147</span> * @param delim The delimiter character.<a name="line.1147"></a>
-<span class="sourceLineNo">1148</span> * @param def The default value if the field does not exist.<a name="line.1148"></a>
-<span class="sourceLineNo">1149</span> * @return The field entry in the string, or the default value if it doesn't exist or the string is null.<a name="line.1149"></a>
-<span class="sourceLineNo">1150</span> */<a name="line.1150"></a>
-<span class="sourceLineNo">1151</span> public static String getField(int fieldNum, String s, char delim, String def) {<a name="line.1151"></a>
-<span class="sourceLineNo">1152</span> if (s == null || fieldNum < 0)<a name="line.1152"></a>
-<span class="sourceLineNo">1153</span> return def;<a name="line.1153"></a>
-<span class="sourceLineNo">1154</span> int start = 0;<a name="line.1154"></a>
-<span class="sourceLineNo">1155</span> for (int i = 0; i < s.length(); i++) {<a name="line.1155"></a>
-<span class="sourceLineNo">1156</span> char c = s.charAt(i);<a name="line.1156"></a>
-<span class="sourceLineNo">1157</span> if (c == delim) {<a name="line.1157"></a>
-<span class="sourceLineNo">1158</span> fieldNum--;<a name="line.1158"></a>
-<span class="sourceLineNo">1159</span> if (fieldNum == 0)<a name="line.1159"></a>
-<span class="sourceLineNo">1160</span> start = i+1;<a name="line.1160"></a>
-<span class="sourceLineNo">1161</span> }<a name="line.1161"></a>
-<span class="sourceLineNo">1162</span> if (fieldNum < 0)<a name="line.1162"></a>
-<span class="sourceLineNo">1163</span> return s.substring(start, i);<a name="line.1163"></a>
-<span class="sourceLineNo">1164</span> }<a name="line.1164"></a>
-<span class="sourceLineNo">1165</span> if (start == 0)<a name="line.1165"></a>
-<span class="sourceLineNo">1166</span> return def;<a name="line.1166"></a>
-<span class="sourceLineNo">1167</span> return s.substring(start);<a name="line.1167"></a>
-<span class="sourceLineNo">1168</span> }<a name="line.1168"></a>
-<span class="sourceLineNo">1169</span><a name="line.1169"></a>
-<span class="sourceLineNo">1170</span> /**<a name="line.1170"></a>
-<span class="sourceLineNo">1171</span> * Calls {@link #toString()} on the specified object if it's not null.<a name="line.1171"></a>
-<span class="sourceLineNo">1172</span> *<a name="line.1172"></a>
-<span class="sourceLineNo">1173</span> * @param o The object to convert to a string.<a name="line.1173"></a>
-<span class="sourceLineNo">1174</span> * @return The object converted to a string, or <jk>null</jk> if the object was null.<a name="line.1174"></a>
-<span class="sourceLineNo">1175</span> */<a name="line.1175"></a>
-<span class="sourceLineNo">1176</span> public static String toString(Object o) {<a name="line.1176"></a>
-<span class="sourceLineNo">1177</span> return (o == null ? null : o.toString());<a name="line.1177"></a>
-<span class="sourceLineNo">1178</span> }<a name="line.1178"></a>
-<span class="sourceLineNo">1179</span><a name="line.1179"></a>
-<span class="sourceLineNo">1180</span> /**<a name="line.1180"></a>
-<span class="sourceLineNo">1181</span> * Converts a hexadecimal byte stream (e.g. "34A5BC") into a UTF-8 encoded string.<a name="line.1181"></a>
-<span class="sourceLineNo">1182</span> *<a name="line.1182"></a>
-<span class="sourceLineNo">1183</span> * @param hex The hexadecimal string.<a name="line.1183"></a>
-<span class="sourceLineNo">1184</span> * @return The UTF-8 string.<a name="line.1184"></a>
-<span class="sourceLineNo">1185</span> */<a name="line.1185"></a>
-<span class="sourceLineNo">1186</span> public static String fromHexToUTF8(String hex) {<a name="line.1186"></a>
-<span class="sourceLineNo">1187</span> ByteBuffer buff = ByteBuffer.allocate(hex.length()/2);<a name="line.1187"></a>
-<span class="sourceLineNo">1188</span> for (int i = 0; i < hex.length(); i+=2)<a name="line.1188"></a>
-<span class="sourceLineNo">1189</span> buff.put((byte)Integer.parseInt(hex.substring(i, i+2), 16));<a name="line.1189"></a>
-<span class="sourceLineNo">1190</span> buff.rewind();<a name="line.1190"></a>
-<span class="sourceLineNo">1191</span> Charset cs = Charset.forName("UTF-8");<a name="line.1191"></a>
-<span class="sourceLineNo">1192</span> return cs.decode(buff).toString();<a name="line.1192"></a>
-<span class="sourceLineNo">1193</span> }<a name="line.1193"></a>
-<span class="sourceLineNo">1194</span><a name="line.1194"></a>
-<span class="sourceLineNo">1195</span> private final static char[] HEX = "0123456789ABCDEF".toCharArray();<a name="line.1195"></a>
-<span class="sourceLineNo">1196</span><a name="line.1196"></a>
-<span class="sourceLineNo">1197</span> /**<a name="line.1197"></a>
-<span class="sourceLineNo">1198</span> * Converts a byte array into a simple hexadecimal character string.<a name="line.1198"></a>
-<span class="sourceLineNo">1199</span> *<a name="line.1199"></a>
-<span class="sourceLineNo">1200</span> * @param bytes The bytes to convert to hexadecimal.<a name="line.1200"></a>
-<span class="sourceLineNo">1201</span> * @return A new string consisting of hexadecimal characters.<a name="line.1201"></a>
-<span class="sourceLineNo">1202</span> */<a name="line.1202"></a>
-<span class="sourceLineNo">1203</span> public static String toHex(byte[] bytes) {<a name="line.1203"></a>
-<span class="sourceLineNo">1204</span> StringBuilder sb = new StringBuilder(bytes.length * 2);<a name="line.1204"></a>
-<span class="sourceLineNo">1205</span> for ( int j = 0; j < bytes.length; j++ ) {<a name="line.1205"></a>
-<span class="sourceLineNo">1206</span> int v = bytes[j] & 0xFF;<a name="line.1206"></a>
-<span class="sourceLineNo">1207</span> sb.append(HEX[v >>> 4]).append(HEX[v & 0x0F]);<a name="line.1207"></a>
-<span class="sourceLineNo">1208</span> }<a name="line.1208"></a>
-<span class="sourceLineNo">1209</span> return sb.toString();<a name="line.1209"></a>
-<span class="sourceLineNo">1210</span> }<a name="line.1210"></a>
-<span class="sourceLineNo">1211</span><a name="line.1211"></a>
-<span class="sourceLineNo">1212</span> /**<a name="line.1212"></a>
-<span class="sourceLineNo">1213</span> * Converts a hexadecimal character string to a byte array.<a name="line.1213"></a>
-<span class="sourceLineNo">1214</span> *<a name="line.1214"></a>
-<span class="sourceLineNo">1215</span> * @param hex The string to convert to a byte array.<a name="line.1215"></a>
-<span class="sourceLineNo">1216</span> * @return A new byte array.<a name="line.1216"></a>
-<span class="sourceLineNo">1217</span> */<a name="line.1217"></a>
-<span class="sourceLineNo">1218</span> public static byte[] fromHex(String hex) {<a name="line.1218"></a>
-<span class="sourceLineNo">1219</span> ByteBuffer buff = ByteBuffer.allocate(hex.length()/2);<a name="line.1219"></a>
-<span class="sourceLineNo">1220</span> for (int i = 0; i < hex.length(); i+=2)<a name="line.1220"></a>
-<span class="sourceLineNo">1221</span> buff.put((byte)Integer.parseInt(hex.substring(i, i+2), 16));<a name="line.1221"></a>
-<span class="sourceLineNo">1222</span> buff.rewind();<a name="line.1222"></a>
-<span class="sourceLineNo">1223</span> return buff.array();<a name="line.1223"></a>
-<span class="sourceLineNo">1224</span> }<a name="line.1224"></a>
-<span class="sourceLineNo">1225</span><a name="line.1225"></a>
-<span class="sourceLineNo">1226</span> /**<a name="line.1226"></a>
-<span class="sourceLineNo">1227</span> * Creates a repeated pattern.<a name="line.1227"></a>
-<span class="sourceLineNo">1228</span> *<a name="line.1228"></a>
-<span class="sourceLineNo">1229</span> * @param count The number of times to repeat the pattern.<a name="line.1229"></a>
-<span class="sourceLineNo">1230</span> * @param pattern The pattern to repeat.<a name="line.1230"></a>
-<span class="sourceLineNo">1231</span> * @return A new string consisting of the repeated pattern.<a name="line.1231"></a>
-<span class="sourceLineNo">1232</span> */<a name="line.1232"></a>
-<span class="sourceLineNo">1233</span> public static String repeat(int count, String pattern) {<a name="line.1233"></a>
-<span class="sourceLineNo">1234</span> StringBuilder sb = new StringBuilder(pattern.length() * count);<a name="line.1234"></a>
-<span class="sourceLineNo">1235</span> for (int i = 0; i < count; i++)<a name="line.1235"></a>
-<span class="sourceLineNo">1236</span> sb.append(pattern);<a name="line.1236"></a>
-<span class="sourceLineNo">1237</span> return sb.toString();<a name="line.1237"></a>
-<span class="sourceLineNo">1238</span> }<a name="line.1238"></a>
-<span class="sourceLineNo">1239</span><a name="line.1239"></a>
-<span class="sourceLineNo">1240</span> /**<a name="line.1240"></a>
-<span class="sourceLineNo">1241</span> * Trims whitespace characters from the beginning of the specified string.<a name="line.1241"></a>
-<span class="sourceLineNo">1242</span> *<a name="line.1242"></a>
-<span class="sourceLineNo">1243</span> * @param s The string to trim.<a name="line.1243"></a>
-<span class="sourceLineNo">1244</span> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.<a name="line.1244"></a>
-<span class="sourceLineNo">1245</span> */<a name="line.1245"></a>
-<span class="sourceLineNo">1246</span> public static String trimStart(String s) {<a name="line.1246"></a>
-<span class="sourceLineNo">1247</span> if (s != null)<a name="line.1247"></a>
-<span class="sourceLineNo">1248</span> while (s.length() > 0 && Character.isWhitespace(s.charAt(0)))<a name="line.1248"></a>
-<span class="sourceLineNo">1249</span> s = s.substring(1);<a name="line.1249"></a>
-<span class="sourceLineNo">1250</span> return s;<a name="line.1250"></a>
-<span class="sourceLineNo">1251</span> }<a name="line.1251"></a>
-<span class="sourceLineNo">1252</span><a name="line.1252"></a>
-<span class="sourceLineNo">1253</span> /**<a name="line.1253"></a>
-<span class="sourceLineNo">1254</span> * Trims whitespace characters from the end of the specified string.<a name="line.1254"></a>
-<span class="sourceLineNo">1255</span> *<a name="line.1255"></a>
-<span class="sourceLineNo">1256</span> * @param s The string to trim.<a name="line.1256"></a>
-<span class="sourceLineNo">1257</span> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.<a name="line.1257"></a>
-<span class="sourceLineNo">1258</span> */<a name="line.1258"></a>
-<span class="sourceLineNo">1259</span> public static String trimEnd(String s) {<a name="line.1259"></a>
-<span class="sourceLineNo">1260</span> if (s != null)<a name="line.1260"></a>
-<span class="sourceLineNo">1261</span> while (s.length() > 0 && Character.isWhitespace(s.charAt(s.length()-1)))<a name="line.1261"></a>
-<span class="sourceLineNo">1262</span> s = s.substring(0, s.length()-1);<a name="line.1262"></a>
-<span class="sourceLineNo">1263</span> return s;<a name="line.1263"></a>
-<span class="sourceLineNo">1264</span> }<a name="line.1264"></a>
-<span class="sourceLineNo">1265</span><a name="line.1265"></a>
-<span class="sourceLineNo">1266</span> /**<a name="line.1266"></a>
-<span class="sourceLineNo">1267</span> * Returns <jk>true</jk> if the specified string is one of the specified values.<a name="line.1267"></a>
-<span class="sourceLineNo">1268</span> *<a name="line.1268"></a>
-<span class="sourceLineNo">1269</span> * @param s<a name="line.1269"></a>
-<span class="sourceLineNo">1270</span> * The string to test.<a name="line.1270"></a>
-<span class="sourceLineNo">1271</span> * Can be <jk>null</jk>.<a name="line.1271"></a>
-<span class="sourceLineNo">1272</span> * @param values<a name="line.1272"></a>
-<span class="sourceLineNo">1273</span> * The values to test.<a name="line.1273"></a>
-<span class="sourceLineNo">1274</span> * Can contain <jk>null</jk>.<a name="line.1274"></a>
-<span class="sourceLineNo">1275</span> * @return <jk>true</jk> if the specified string is one of the specified values.<a name="line.1275"></a>
-<span class="sourceLineNo">1276</span> */<a name="line.1276"></a>
-<span class="sourceLineNo">1277</span> public static boolean isOneOf(String s, String...values) {<a name="line.1277"></a>
-<span class="sourceLineNo">1278</span> for (int i = 0; i < values.length; i++)<a name="line.1278"></a>
-<span class="sourceLineNo">1279</span> if (StringUtils.isEquals(s, values[i]))<a name="line.1279"></a>
-<span class="sourceLineNo">1280</span> return true;<a name="line.1280"></a>
-<span class="sourceLineNo">1281</span> return false;<a name="line.1281"></a>
-<span class="sourceLineNo">1282</span> }<a name="line.1282"></a>
-<span class="sourceLineNo">1283</span><a name="line.1283"></a>
-<span class="sourceLineNo">1284</span> /**<a name="line.1284"></a>
-<span class="sourceLineNo">1285</span> * Trims <js>'/'</js> characters from both the start and end of the specified string.<a name="line.1285"></a>
-<span class="sourceLineNo">1286</span> *<a name="line.1286"></a>
-<span class="sourceLineNo">1287</span> * @param s The string to trim.<a name="line.1287"></a>
-<span class="sourceLineNo">1288</span> * @return A new trimmed string, or the same string if no trimming was necessary.<a name="line.1288"></a>
-<span class="sourceLineNo">1289</span> */<a name="line.1289"></a>
-<span class="sourceLineNo">1290</span> public static String trimSlashes(String s) {<a name="line.1290"></a>
-<span class="sourceLineNo">1291</span> if (s == null)<a name="line.1291"></a>
-<span class="sourceLineNo">1292</span> return null;<a name="line.1292"></a>
-<span class="sourceLineNo">1293</span> while (endsWith(s, '/'))<a name="line.1293"></a>
-<span class="sourceLineNo">1294</span> s = s.substring(0, s.length()-1);<a name="line.1294"></a>
-<span class="sourceLineNo">1295</span> while (s.length() > 0 && s.charAt(0) == '/')<a name="line.1295"></a>
-<span class="sourceLineNo">1296</span> s = s.substring(1);<a name="line.1296"></a>
-<span class="sourceLineNo">1297</span> return s;<a name="line.1297"></a>
-<span class="sourceLineNo">1298</span> }<a name="line.1298"></a>
-<span class="sourceLineNo">1299</span><a name="line.1299"></a>
-<span class="sourceLineNo">1300</span> /**<a name="line.1300"></a>
-<span class="sourceLineNo">1301</span> * Trims <js>'/'</js> characters from the end of the specified string.<a name="line.1301"></a>
-<span class="sourceLineNo">1302</span> *<a name="line.1302"></a>
-<span class="sourceLineNo">1303</span> * @param s The string to trim.<a name="line.1303"></a>
-<span class="sourceLineNo">1304</span> * @return A new trimmed string, or the same string if no trimming was necessary.<a name="line.1304"></a>
-<span class="sourceLineNo">1305</span> */<a name="line.1305"></a>
-<span class="sourceLineNo">1306</span> public static String trimTrailingSlashes(String s) {<a name="line.1306"></a>
-<span class="sourceLineNo">1307</span> if (s == null)<a name="line.1307"></a>
-<span class="sourceLineNo">1308</span> return null;<a name="line.1308"></a>
-<span class="sourceLineNo">1309</span> while (endsWith(s, '/'))<a name="line.1309"></a>
-<span class="sourceLineNo">1310</span> s = s.substring(0, s.length()-1);<a name="line.1310"></a>
-<span class="sourceLineNo">1311</span> return s;<a name="line.1311"></a>
-<span class="sourceLineNo">1312</span> }<a name="line.1312"></a>
-<span class="sourceLineNo">1313</span><a name="line.1313"></a>
-<span class="sourceLineNo">1314</span> /**<a name="line.1314"></a>
-<span class="sourceLineNo">1315</span> * Trims <js>'/'</js> characters from the end of the specified string.<a name="line.1315"></a>
-<span class="sourceLineNo">1316</span> *<a name="line.1316"></a>
-<span class="sourceLineNo">1317</span> * @param s The string to trim.<a name="line.1317"></a>
-<span class="sourceLineNo">1318</span> * @return The same string buffer.<a name="line.1318"></a>
-<span class="sourceLineNo">1319</span> */<a name="line.1319"></a>
-<span class="sourceLineNo">1320</span> public static StringBuffer trimTrailingSlashes(StringBuffer s) {<a name="line.1320"></a>
-<span class="sourceLineNo">1321</span> if (s == null)<a name="line.1321"></a>
-<span class="sourceLineNo">1322</span> return null;<a name="line.1322"></a>
-<span class="sourceLineNo">1323</span> while (s.length() > 0 && s.charAt(s.length()-1) == '/')<a name="line.1323"></a>
-<span class="sourceLineNo">1324</span> s.setLength(s.length()-1);<a name="line.1324"></a>
-<span class="sourceLineNo">1325</span> return s;<a name="line.1325"></a>
-<span class="sourceLineNo">1326</span> }<a name="line.1326"></a>
-<span class="sourceLineNo">1327</span><a name="line.1327"></a>
-<span class="sourceLineNo">1328</span> /**<a name="line.1328"></a>
-<span class="sourceLineNo">1329</span> * Decodes a <code>application/x-www-form-urlencoded</code> string using <code>UTF-8</code> encoding scheme.<a name="line.1329"></a>
-<span class="sourceLineNo">1330</span> *<a name="line.1330"></a>
-<span class="sourceLineNo">1331</span> * @param s The string to decode.<a name="line.1331"></a>
-<span class="sourceLineNo">1332</span> * @return The decoded string, or <jk>null</jk> if input is <jk>null</jk>.<a name="line.1332"></a>
-<span class="sourceLineNo">1333</span> */<a name="line.1333"></a>
-<span class="sourceLineNo">1334</span> public static String urlDecode(String s) {<a name="line.1334"></a>
-<span class="sourceLineNo">1335</span> if (s == null)<a name="line.1335"></a>
-<span class="sourceLineNo">1336</span> return s;<a name="line.1336"></a>
-<span class="sourceLineNo">1337</span> boolean needsDecode = false;<a name="line.1337"></a>
-<span class="sourceLineNo">1338</span> for (int i = 0; i < s.length() && ! needsDecode; i++) {<a name="line.1338"></a>
-<span class="sourceLineNo">1339</span> char c = s.charAt(i);<a name="line.1339"></a>
-<span class="sourceLineNo">1340</span> if (c == '+' || c == '%')<a name="line.1340"></a>
-<span class="sourceLineNo">1341</span> needsDecode = true;<a name="line.1341"></a>
-<span class="sourceLineNo">1342</span> }<a name="line.1342"></a>
-<span class="sourceLineNo">1343</span> if (needsDecode)<a name="line.1343"></a>
-<span class="sourceLineNo">1344</span> try {<a name="line.1344"></a>
-<span class="sourceLineNo">1345</span> return URLDecoder.decode(s, "UTF-8");<a name="line.1345"></a>
-<span class="sourceLineNo">1346</span> } catch (UnsupportedEncodingException e) {/* Won't happen */}<a name="line.1346"></a>
-<span class="sourceLineNo">1347</span> return s;<a name="line.1347"></a>
-<span class="sourceLineNo">1348</span> }<a name="line.1348"></a>
-<span class="sourceLineNo">1349</span><a name="line.1349"></a>
-<span class="sourceLineNo">1350</span> /**<a name="line.1350"></a>
-<span class="sourceLineNo">1351</span> * Encodes a <code>application/x-www-form-urlencoded</code> string using <code>UTF-8</code> encoding scheme.<a name="line.1351"></a>
-<span class="sourceLineNo">1352</span> *<a name="line.1352"></a>
-<span class="sourceLineNo">1353</span> * @param s The string to encode.<a name="line.1353"></a>
-<span class="sourceLineNo">1354</span> * @return The encoded string, or <jk>null</jk> if input is <jk>null</jk>.<a name="line.1354"></a>
-<span class="sourceLineNo">1355</span> */<a name="line.1355"></a>
-<span class="sourceLineNo">1356</span> public static String urlEncode(String s) {<a name="line.1356"></a>
-<span class="sourceLineNo">1357</span> if (s == null)<a name="line.1357"></a>
-<span class="sourceLineNo">1358</span> return null;<a name="line.1358"></a>
-<span class="sourceLineNo">1359</span> boolean needsEncode = false;<a name="line.1359"></a>
-<span class="sourceLineNo">1360</span> for (int i = 0; i < s.length() && ! needsEncode; i++)<a name="line.1360"></a>
-<span class="sourceLineNo">1361</span> needsEncode |= (! unencodedChars.contains(s.charAt(i)));<a name="line.1361"></a>
-<span class="sourceLineNo">1362</span> if (needsEncode) {<a name="line.1362"></a>
-<span class="sourceLineNo">1363</span> try {<a name="line.1363"></a>
-<span class="sourceLineNo">1364</span> return URLEncoder.encode(s, "UTF-8");<a name="line.1364"></a>
-<span class="sourceLineNo">1365</span> } catch (UnsupportedEncodingException e) {/* Won't happen */}<a name="line.1365"></a>
-<span class="sourceLineNo">1366</span> }<a name="line.1366"></a>
-<span class="sourceLineNo">1367</span> return s;<a name="line.1367"></a>
-<span class="sourceLineNo">1368</span> }<a name="line.1368"></a>
-<span class="sourceLineNo">1369</span><a name="line.1369"></a>
-<span class="sourceLineNo">1370</span> /**<a name="line.1370"></a>
-<span class="sourceLineNo">1371</span> * Returns the first non-whitespace character in the string.<a name="line.1371"></a>
-<span class="sourceLineNo">1372</span> *<a name="line.1372"></a>
-<span class="sourceLineNo">1373</span> * @param s The string to check.<a name="line.1373"></a>
-<span class="sourceLineNo">1374</span> * @return<a name="line.1374"></a>
-<span class="sourceLineNo">1375</span> * The first non-whitespace character, or <code>0</code> if the string is <jk>null</jk>, empty, or composed<a name="line.1375"></a>
-<span class="sourceLineNo">1376</span> * of only whitespace.<a name="line.1376"></a>
-<span class="sourceLineNo">1377</span> */<a name="line.1377"></a>
-<span class="sourceLineNo">1378</span> public static char firstNonWhitespaceChar(String s) {<a name="line.1378"></a>
-<span class="sourceLineNo">1379</span> if (s != null)<a name="line.1379"></a>
-<span class="sourceLineNo">1380</span> for (int i = 0; i < s.length(); i++)<a name="line.1380"></a>
-<span class="sourceLineNo">1381</span> if (! Character.isWhitespace(s.charAt(i)))<a name="line.1381"></a>
-<span class="sourceLineNo">1382</span> return s.charAt(i);<a name="line.1382"></a>
-<span class="sourceLineNo">1383</span> return 0;<a name="line.1383"></a>
-<span class="sourceLineNo">1384</span> }<a name="line.1384"></a>
-<span class="sourceLineNo">1385</span><a name="line.1385"></a>
-<span class="sourceLineNo">1386</span> /**<a name="line.1386"></a>
-<span class="sourceLineNo">1387</span> * Returns the character at the specified index in the string without throwing exceptions.<a name="line.1387"></a>
-<span class="sourceLineNo">1388</span> *<a name="line.1388"></a>
-<span class="sourceLineNo">1389</span> * @param s The string.<a name="line.1389"></a>
-<span class="sourceLineNo">1390</span> * @param i The index position.<a name="line.1390"></a>
-<span class="sourceLineNo">1391</span> * @return<a name="line.1391"></a>
-<span class="sourceLineNo">1392</span> * The character at the specified index, or <code>0</code> if the index is out-of-range or the string<a name="line.1392"></a>
-<span class="sourceLineNo">1393</span> * is <jk>null</jk>.<a name="line.1393"></a>
-<span class="sourceLineNo">1394</span> */<a name="line.1394"></a>
-<span class="sourceLineNo">1395</span> public static char charAt(String s, int i) {<a name="line.1395"></a>
-<span class="sourceLineNo">1396</span> if (s == null)<a name="line.1396"></a>
-<span class="sourceLineNo">1397</span> return 0;<a name="line.1397"></a>
-<span class="sourceLineNo">1398</span> if (i < 0 || i >= s.length())<a name="line.1398"></a>
-<span class="sourceLineNo">1399</span> return 0;<a name="line.1399"></a>
-<span class="sourceLineNo">1400</span> return s.charAt(i);<a name="line.1400"></a>
-<span class="sourceLineNo">1401</span> }<a name="line.1401"></a>
-<span class="sourceLineNo">1402</span><a name="line.1402"></a>
-<span class="sourceLineNo">1403</span> /**<a name="line.1403"></a>
-<span class="sourceLineNo">1404</span> * Efficiently determines whether a URL is of the pattern "xxx://xxx"<a name="line.1404"></a>
-<span class="sourceLineNo">1405</span> *<a name="line.1405"></a>
-<span class="sourceLineNo">1406</span> * @param s The string to test.<a name="line.1406"></a>
-<span class="sourceLineNo">1407</span> * @return <jk>true</jk> if it's an absolute path.<a name="line.1407"></a>
-<span class="sourceLineNo">1408</span> */<a name="line.1408"></a>
-<span class="sourceLineNo">1409</span> public static boolean isAbsoluteUri(String s) {<a name="line.1409"></a>
-<span class="sourceLineNo">1410</span><a name="line.1410"></a>
-<span class="sourceLineNo">1411</span> if (isEmpty(s))<a name="line.1411"></a>
-<span class="sourceLineNo">1412</span> return false;<a name="line.1412"></a>
+<span class="sourceLineNo">1019</span> int S1 = 1; // Not in variable, looking for {<a name="line.1019"></a>
+<span class="sourceLineNo">1020</span> int S2 = 2; // Found {, Looking for }<a name="line.1020"></a>
+<span class="sourceLineNo">1021</span><a name="line.1021"></a>
+<span class="sourceLineNo">1022</span> int state = S1;<a name="line.1022"></a>
+<span class="sourceLineNo">1023</span> boolean hasInternalVar = false;<a name="line.1023"></a>
+<span class="sourceLineNo">1024</span> int x = 0;<a name="line.1024"></a>
+<span class="sourceLineNo">1025</span> int depth = 0;<a name="line.1025"></a>
+<span class="sourceLineNo">1026</span> int length = s.length();<a name="line.1026"></a>
+<span class="sourceLineNo">1027</span> StringBuilder out = new StringBuilder();<a name="line.1027"></a>
+<span class="sourceLineNo">1028</span> for (int i = 0; i < length; i++) {<a name="line.1028"></a>
+<span class="sourceLineNo">1029</span> char c = s.charAt(i);<a name="line.1029"></a>
+<span class="sourceLineNo">1030</span> if (state == S1) {<a name="line.1030"></a>
+<span class="sourceLineNo">1031</span> if (c == '{') {<a name="line.1031"></a>
+<span class="sourceLineNo">1032</span> state = S2;<a name="line.1032"></a>
+<span class="sourceLineNo">1033</span> x = i;<a name="line.1033"></a>
+<span class="sourceLineNo">1034</span> } else {<a name="line.1034"></a>
+<span class="sourceLineNo">1035</span> out.append(c);<a name="line.1035"></a>
+<span class="sourceLineNo">1036</span> }<a name="line.1036"></a>
+<span class="sourceLineNo">1037</span> } else /* state == S2 */ {<a name="line.1037"></a>
+<span class="sourceLineNo">1038</span> if (c == '{') {<a name="line.1038"></a>
+<span class="sourceLineNo">1039</span> depth++;<a name="line.1039"></a>
+<span class="sourceLineNo">1040</span> hasInternalVar = true;<a name="line.1040"></a>
+<span class="sourceLineNo">1041</span> } else if (c == '}') {<a name="line.1041"></a>
+<span class="sourceLineNo">1042</span> if (depth > 0) {<a name="line.1042"></a>
+<span class="sourceLineNo">1043</span> depth--;<a name="line.1043"></a>
+<span class="sourceLineNo">1044</span> } else {<a name="line.1044"></a>
+<span class="sourceLineNo">1045</span> String key = s.substring(x+1, i);<a name="line.1045"></a>
+<span class="sourceLineNo">1046</span> key = (hasInternalVar ? replaceVars(key, m) : key);<a name="line.1046"></a>
+<span class="sourceLineNo">1047</span> hasInternalVar = false;<a name="line.1047"></a>
+<span class="sourceLineNo">1048</span> if (! m.containsKey(key))<a name="line.1048"></a>
+<span class="sourceLineNo">1049</span> out.append('{').append(key).append('}');<a name="line.1049"></a>
+<span class="sourceLineNo">1050</span> else {<a name="line.1050"></a>
+<span class="sourceLineNo">1051</span> Object val = m.get(key);<a name="line.1051"></a>
+<span class="sourceLineNo">1052</span> if (val == null)<a name="line.1052"></a>
+<span class="sourceLineNo">1053</span> val = "";<a name="line.1053"></a>
+<span class="sourceLineNo">1054</span> String v = val.toString();<a name="line.1054"></a>
+<span class="sourceLineNo">1055</span> // If the replacement also contains variables, replace them now.<a name="line.1055"></a>
+<span class="sourceLineNo">1056</span> if (v.indexOf('{') != -1)<a name="line.1056"></a>
+<span class="sourceLineNo">1057</span> v = replaceVars(v, m);<a name="line.1057"></a>
+<span class="sourceLineNo">1058</span> out.append(v);<a name="line.1058"></a>
+<span class="sourceLineNo">1059</span> }<a name="line.1059"></a>
+<span class="sourceLineNo">1060</span> state = 1;<a name="line.1060"></a>
+<span class="sourceLineNo">1061</span> }<a name="line.1061"></a>
+<span class="sourceLineNo">1062</span> }<a name="line.1062"></a>
+<span class="sourceLineNo">1063</span> }<a name="line.1063"></a>
+<span class="sourceLineNo">1064</span> }<a name="line.1064"></a>
+<span class="sourceLineNo">1065</span> return out.toString();<a name="line.1065"></a>
+<span class="sourceLineNo">1066</span> }<a name="line.1066"></a>
+<span class="sourceLineNo">1067</span><a name="line.1067"></a>
+<span class="sourceLineNo">1068</span> /**<a name="line.1068"></a>
+<span class="sourceLineNo">1069</span> * Returns <jk>true</jk> if the specified path string is prefixed with the specified prefix.<a name="line.1069"></a>
+<span class="sourceLineNo">1070</span> *<a name="line.1070"></a>
+<span class="sourceLineNo">1071</span> * <h5 class='section'>Example:</h5><a name="line.1071"></a>
+<span class="sourceLineNo">1072</span> * <p class='bcode'><a name="line.1072"></a>
+<span class="sourceLineNo">1073</span> * pathStartsWith(<js>"foo"</js>, <js>"foo"</js>); <jc>// true</jc><a name="line.1073"></a>
+<span class="sourceLineNo">1074</span> * pathStartsWith(<js>"foo/bar"</js>, <js>"foo"</js>); <jc>// true</jc><a name="line.1074"></a>
+<span class="sourceLineNo">1075</span> * pathStartsWith(<js>"foo2"</js>, <js>"foo"</js>); <jc>// false</jc><a name="line.1075"></a>
+<span class="sourceLineNo">1076</span> * pathStartsWith(<js>"foo2"</js>, <js>""</js>); <jc>// false</jc><a name="line.1076"></a>
+<span class="sourceLineNo">1077</span> * </p><a name="line.1077"></a>
+<span class="sourceLineNo">1078</span> *<a name="line.1078"></a>
+<span class="sourceLineNo">1079</span> * @param path The path to check.<a name="line.1079"></a>
+<span class="sourceLineNo">1080</span> * @param pathPrefix The prefix.<a name="line.1080"></a>
+<span class="sourceLineNo">1081</span> * @return <jk>true</jk> if the specified path string is prefixed with the specified prefix.<a name="line.1081"></a>
+<span class="sourceLineNo">1082</span> */<a name="line.1082"></a>
+<span class="sourceLineNo">1083</span> public static boolean pathStartsWith(String path, String pathPrefix) {<a name="line.1083"></a>
+<span class="sourceLineNo">1084</span> if (path == null || pathPrefix == null)<a name="line.1084"></a>
+<span class="sourceLineNo">1085</span> return false;<a name="line.1085"></a>
+<span class="sourceLineNo">1086</span> if (path.startsWith(pathPrefix))<a name="line.1086"></a>
+<span class="sourceLineNo">1087</span> return path.length() == pathPrefix.length() || path.charAt(pathPrefix.length()) == '/';<a name="line.1087"></a>
+<span class="sourceLineNo">1088</span> return false;<a name="line.1088"></a>
+<span class="sourceLineNo">1089</span> }<a name="line.1089"></a>
+<span class="sourceLineNo">1090</span><a name="line.1090"></a>
+<span class="sourceLineNo">1091</span> /**<a name="line.1091"></a>
+<span class="sourceLineNo">1092</span> * Same as {@link #pathStartsWith(String, String)} but returns <jk>true</jk> if at least one prefix matches.<a name="line.1092"></a>
+<span class="sourceLineNo">1093</span> *<a name="line.1093"></a>
+<span class="sourceLineNo">1094</span> * @param path The path to check.<a name="line.1094"></a>
+<span class="sourceLineNo">1095</span> * @param pathPrefixes The prefixes.<a name="line.1095"></a>
+<span class="sourceLineNo">1096</span> * @return <jk>true</jk> if the specified path string is prefixed with any of the specified prefixes.<a name="line.1096"></a>
+<span class="sourceLineNo">1097</span> */<a name="line.1097"></a>
+<span class="sourceLineNo">1098</span> public static boolean pathStartsWith(String path, String[] pathPrefixes) {<a name="line.1098"></a>
+<span class="sourceLineNo">1099</span> for (String p : pathPrefixes)<a name="line.1099"></a>
+<span class="sourceLineNo">1100</span> if (pathStartsWith(path, p))<a name="line.1100"></a>
+<span class="sourceLineNo">1101</span> return true;<a name="line.1101"></a>
+<span class="sourceLineNo">1102</span> return false;<a name="line.1102"></a>
+<span class="sourceLineNo">1103</span> }<a name="line.1103"></a>
+<span class="sourceLineNo">1104</span><a name="line.1104"></a>
+<span class="sourceLineNo">1105</span> /**<a name="line.1105"></a>
+<span class="sourceLineNo">1106</span> * Replaces <js>"\\uXXXX"</js> character sequences with their unicode characters.<a name="line.1106"></a>
+<span class="sourceLineNo">1107</span> *<a name="line.1107"></a>
+<span class="sourceLineNo">1108</span> * @param s The string to replace unicode sequences in.<a name="line.1108"></a>
+<span class="sourceLineNo">1109</span> * @return A string with unicode sequences replaced.<a name="line.1109"></a>
+<span class="sourceLineNo">1110</span> */<a name="line.1110"></a>
+<span class="sourceLineNo">1111</span> public static String replaceUnicodeSequences(String s) {<a name="line.1111"></a>
+<span class="sourceLineNo">1112</span> if (s.indexOf('\\') == -1)<a name="line.1112"></a>
+<span class="sourceLineNo">1113</span> return s;<a name="line.1113"></a>
+<span class="sourceLineNo">1114</span> Pattern p = Pattern.compile("\\\\u(\\p{XDigit}{4})");<a name="line.1114"></a>
+<span class="sourceLineNo">1115</span> Matcher m = p.matcher(s);<a name="line.1115"></a>
+<span class="sourceLineNo">1116</span> StringBuffer sb = new StringBuffer(s.length());<a name="line.1116"></a>
+<span class="sourceLineNo">1117</span> while (m.find()) {<a name="line.1117"></a>
+<span class="sourceLineNo">1118</span> String ch = String.valueOf((char) Integer.parseInt(m.group(1), 16));<a name="line.1118"></a>
+<span class="sourceLineNo">1119</span> m.appendReplacement(sb, Matcher.quoteReplacement(ch));<a name="line.1119"></a>
+<span class="sourceLineNo">1120</span> }<a name="line.1120"></a>
+<span class="sourceLineNo">1121</span> m.appendTail(sb);<a name="line.1121"></a>
+<span class="sourceLineNo">1122</span> return sb.toString();<a name="line.1122"></a>
+<span class="sourceLineNo">1123</span> }<a name="line.1123"></a>
+<span class="sourceLineNo">1124</span><a name="line.1124"></a>
+<span class="sourceLineNo">1125</span> /**<a name="line.1125"></a>
+<span class="sourceLineNo">1126</span> * Returns the specified field in a delimited string without splitting the string.<a name="line.1126"></a>
+<span class="sourceLineNo">1127</span> *<a name="line.1127"></a>
+<span class="sourceLineNo">1128</span> * <p><a name="line.1128"></a>
+<span class="sourceLineNo">1129</span> * Equivalent to the following:<a name="line.1129"></a>
+<span class="sourceLineNo">1130</span> * <p class='bcode'><a name="line.1130"></a>
+<span class="sourceLineNo">1131</span> * String in = <js>"0,1,2"</js>;<a name="line.1131"></a>
+<span class="sourceLineNo">1132</span> * String[] parts = in.split(<js>","</js>);<a name="line.1132"></a>
+<span class="sourceLineNo">1133</span> * String p1 = (parts.<jk>length</jk> > 1 ? parts[1] : <js>""</js>);<a name="line.1133"></a>
+<span class="sourceLineNo">1134</span> * </p><a name="line.1134"></a>
+<span class="sourceLineNo">1135</span> *<a name="line.1135"></a>
+<span class="sourceLineNo">1136</span> * @param fieldNum The field number. Zero-indexed.<a name="line.1136"></a>
+<span class="sourceLineNo">1137</span> * @param s The input string.<a name="line.1137"></a>
+<span class="sourceLineNo">1138</span> * @param delim The delimiter character.<a name="line.1138"></a>
+<span class="sourceLineNo">1139</span> * @return The field entry in the string, or a blank string if it doesn't exist or the string is null.<a name="line.1139"></a>
+<span class="sourceLineNo">1140</span> */<a name="line.1140"></a>
+<span class="sourceLineNo">1141</span> public static String getField(int fieldNum, String s, char delim) {<a name="line.1141"></a>
+<span class="sourceLineNo">1142</span> return getField(fieldNum, s, delim, "");<a name="line.1142"></a>
+<span class="sourceLineNo">1143</span> }<a name="line.1143"></a>
+<span class="sourceLineNo">1144</span><a name="line.1144"></a>
+<span class="sourceLineNo">1145</span> /**<a name="line.1145"></a>
+<span class="sourceLineNo">1146</span> * Same as {@link #getField(int, String, char)} except allows you to specify the default value.<a name="line.1146"></a>
+<span class="sourceLineNo">1147</span> *<a name="line.1147"></a>
+<span class="sourceLineNo">1148</span> * @param fieldNum The field number. Zero-indexed.<a name="line.1148"></a>
+<span class="sourceLineNo">1149</span> * @param s The input string.<a name="line.1149"></a>
+<span class="sourceLineNo">1150</span> * @param delim The delimiter character.<a name="line.1150"></a>
+<span class="sourceLineNo">1151</span> * @param def The default value if the field does not exist.<a name="line.1151"></a>
+<span class="sourceLineNo">1152</span> * @return The field entry in the string, or the default value if it doesn't exist or the string is null.<a name="line.1152"></a>
+<span class="sourceLineNo">1153</span> */<a name="line.1153"></a>
+<span class="sourceLineNo">1154</span> public static String getField(int fieldNum, String s, char delim, String def) {<a name="line.1154"></a>
+<span class="sourceLineNo">1155</span> if (s == null || fieldNum < 0)<a name="line.1155"></a>
+<span class="sourceLineNo">1156</span> return def;<a name="line.1156"></a>
+<span class="sourceLineNo">1157</span> int start = 0;<a name="line.1157"></a>
+<span class="sourceLineNo">1158</span> for (int i = 0; i < s.length(); i++) {<a name="line.1158"></a>
+<span class="sourceLineNo">1159</span> char c = s.charAt(i);<a name="line.1159"></a>
+<span class="sourceLineNo">1160</span> if (c == delim) {<a name="line.1160"></a>
+<span class="sourceLineNo">1161</span> fieldNum--;<a name="line.1161"></a>
+<span class="sourceLineNo">1162</span> if (fieldNum == 0)<a name="line.1162"></a>
+<span class="sourceLineNo">1163</span> start = i+1;<a name="line.1163"></a>
+<span class="sourceLineNo">1164</span> }<a name="line.1164"></a>
+<span class="sourceLineNo">1165</span> if (fieldNum < 0)<a name="line.1165"></a>
+<span class="sourceLineNo">1166</span> return s.substring(start, i);<a name="line.1166"></a>
+<span class="sourceLineNo">1167</span> }<a name="line.1167"></a>
+<span class="sourceLineNo">1168</span> if (start == 0)<a name="line.1168"></a>
+<span class="sourceLineNo">1169</span> return def;<a name="line.1169"></a>
+<span class="sourceLineNo">1170</span> return s.substring(start);<a name="line.1170"></a>
+<span class="sourceLineNo">1171</span> }<a name="line.1171"></a>
+<span class="sourceLineNo">1172</span><a name="line.1172"></a>
+<span class="sourceLineNo">1173</span> /**<a name="line.1173"></a>
+<span class="sourceLineNo">1174</span> * Calls {@link #toString()} on the specified object if it's not null.<a name="line.1174"></a>
+<span class="sourceLineNo">1175</span> *<a name="line.1175"></a>
+<span class="sourceLineNo">1176</span> * @param o The object to convert to a string.<a name="line.1176"></a>
+<span class="sourceLineNo">1177</span> * @return The object converted to a string, or <jk>null</jk> if the object was null.<a name="line.1177"></a>
+<span class="sourceLineNo">1178</span> */<a name="line.1178"></a>
+<span class="sourceLineNo">1179</span> public static String toString(Object o) {<a name="line.1179"></a>
+<span class="sourceLineNo">1180</span> return (o == null ? null : o.toString());<a name="line.1180"></a>
+<span class="sourceLineNo">1181</span> }<a name="line.1181"></a>
+<span class="sourceLineNo">1182</span><a name="line.1182"></a>
+<span class="sourceLineNo">1183</span> /**<a name="line.1183"></a>
+<span class="sourceLineNo">1184</span> * Converts a hexadecimal byte stream (e.g. "34A5BC") into a UTF-8 encoded string.<a name="line.1184"></a>
+<span class="sourceLineNo">1185</span> *<a name="line.1185"></a>
+<span class="sourceLineNo">1186</span> * @param hex The hexadecimal string.<a name="line.1186"></a>
+<span class="sourceLineNo">1187</span> * @return The UTF-8 string.<a name="line.1187"></a>
+<span class="sourceLineNo">1188</span> */<a name="line.1188"></a>
+<span class="sourceLineNo">1189</span> public static String fromHexToUTF8(String hex) {<a name="line.1189"></a>
+<span class="sourceLineNo">1190</span> ByteBuffer buff = ByteBuffer.allocate(hex.length()/2);<a name="line.1190"></a>
+<span class="sourceLineNo">1191</span> for (int i = 0; i < hex.length(); i+=2)<a name="line.1191"></a>
+<span class="sourceLineNo">1192</span> buff.put((byte)Integer.parseInt(hex.substring(i, i+2), 16));<a name="line.1192"></a>
+<span class="sourceLineNo">1193</span> buff.rewind();<a name="line.1193"></a>
+<span class="sourceLineNo">1194</span> Charset cs = Charset.forName("UTF-8");<a name="line.1194"></a>
+<span class="sourceLineNo">1195</span> return cs.decode(buff).toString();<a name="line.1195"></a>
+<span class="sourceLineNo">1196</span> }<a name="line.1196"></a>
+<span class="sourceLineNo">1197</span><a name="line.1197"></a>
+<span class="sourceLineNo">1198</span> private final static char[] HEX = "0123456789ABCDEF".toCharArray();<a name="line.1198"></a>
+<span class="sourceLineNo">1199</span><a name="line.1199"></a>
+<span class="sourceLineNo">1200</span> /**<a name="line.1200"></a>
+<span class="sourceLineNo">1201</span> * Converts a byte array into a simple hexadecimal character string.<a name="line.1201"></a>
+<span class="sourceLineNo">1202</span> *<a name="line.1202"></a>
+<span class="sourceLineNo">1203</span> * @param bytes The bytes to convert to hexadecimal.<a name="line.1203"></a>
+<span class="sourceLineNo">1204</span> * @return A new string consisting of hexadecimal characters.<a name="line.1204"></a>
+<span class="sourceLineNo">1205</span> */<a name="line.1205"></a>
+<span class="sourceLineNo">1206</span> public static String toHex(byte[] bytes) {<a name="line.1206"></a>
+<span class="sourceLineNo">1207</span> StringBuilder sb = new StringBuilder(bytes.length * 2);<a name="line.1207"></a>
+<span class="sourceLineNo">1208</span> for ( int j = 0; j < bytes.length; j++ ) {<a name="line.1208"></a>
+<span class="sourceLineNo">1209</span> int v = bytes[j] & 0xFF;<a name="line.1209"></a>
+<span class="sourceLineNo">1210</span> sb.append(HEX[v >>> 4]).append(HEX[v & 0x0F]);<a name="line.1210"></a>
+<span class="sourceLineNo">1211</span> }<a name="line.1211"></a>
+<span class="sourceLineNo">1212</span> return sb.toString();<a name="line.1212"></a>
+<span class="sourceLineNo">1213</span> }<a name="line.1213"></a>
+<span class="sourceLineNo">1214</span><a name="line.1214"></a>
+<span class="sourceLineNo">1215</span> /**<a name="line.1215"></a>
+<span class="sourceLineNo">1216</span> * Converts a hexadecimal character string to a byte array.<a name="line.1216"></a>
+<span class="sourceLineNo">1217</span> *<a name="line.1217"></a>
+<span class="sourceLineNo">1218</span> * @param hex The string to convert to a byte array.<a name="line.1218"></a>
+<span class="sourceLineNo">1219</span> * @return A new byte array.<a name="line.1219"></a>
+<span class="sourceLineNo">1220</span> */<a name="line.1220"></a>
+<span class="sourceLineNo">1221</span> public static byte[] fromHex(String hex) {<a name="line.1221"></a>
+<span class="sourceLineNo">1222</span> ByteBuffer buff = ByteBuffer.allocate(hex.length()/2);<a name="line.1222"></a>
+<span class="sourceLineNo">1223</span> for (int i = 0; i < hex.length(); i+=2)<a name="line.1223"></a>
+<span class="sourceLineNo">1224</span> buff.put((byte)Integer.parseInt(hex.substring(i, i+2), 16));<a name="line.1224"></a>
+<span class="sourceLineNo">1225</span> buff.rewind();<a name="line.1225"></a>
+<span class="sourceLineNo">1226</span> return buff.array();<a name="line.1226"></a>
+<span class="sourceLineNo">1227</span> }<a name="line.1227"></a>
+<span class="sourceLineNo">1228</span><a name="line.1228"></a>
+<span class="sourceLineNo">1229</span> /**<a name="line.1229"></a>
+<span class="sourceLineNo">1230</span> * Creates a repeated pattern.<a name="line.1230"></a>
+<span class="sourceLineNo">1231</span> *<a name="line.1231"></a>
+<span class="sourceLineNo">1232</span> * @param count The number of times to repeat the pattern.<a name="line.1232"></a>
+<span class="sourceLineNo">1233</span> * @param pattern The pattern to repeat.<a name="line.1233"></a>
+<span class="sourceLineNo">1234</span> * @return A new string consisting of the repeated pattern.<a name="line.1234"></a>
+<span class="sourceLineNo">1235</span> */<a name="line.1235"></a>
+<span class="sourceLineNo">1236</span> public static String repeat(int count, String pattern) {<a name="line.1236"></a>
+<span class="sourceLineNo">1237</span> StringBuilder sb = new StringBuilder(pattern.length() * count);<a name="line.1237"></a>
+<span class="sourceLineNo">1238</span> for (int i = 0; i < count; i++)<a name="line.1238"></a>
+<span class="sourceLineNo">1239</span> sb.append(pattern);<a name="line.1239"></a>
+<span class="sourceLineNo">1240</span> return sb.toString();<a name="line.1240"></a>
+<span class="sourceLineNo">1241</span> }<a name="line.1241"></a>
+<span class="sourceLineNo">1242</span><a name="line.1242"></a>
+<span class="sourceLineNo">1243</span> /**<a name="line.1243"></a>
+<span class="sourceLineNo">1244</span> * Trims whitespace characters from the beginning of the specified string.<a name="line.1244"></a>
+<span class="sourceLineNo">1245</span> *<a name="line.1245"></a>
+<span class="sourceLineNo">1246</span> * @param s The string to trim.<a name="line.1246"></a>
+<span class="sourceLineNo">1247</span> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.<a name="line.1247"></a>
+<span class="sourceLineNo">1248</span> */<a name="line.1248"></a>
+<span class="sourceLineNo">1249</span> public static String trimStart(String s) {<a name="line.1249"></a>
+<span class="sourceLineNo">1250</span> if (s != null)<a name="line.1250"></a>
+<span class="sourceLineNo">1251</span> while (s.length() > 0 && Character.isWhitespace(s.charAt(0)))<a name="line.1251"></a>
+<span class="sourceLineNo">1252</span> s = s.substring(1);<a name="line.1252"></a>
+<span class="sourceLineNo">1253</span> return s;<a name="line.1253"></a>
+<span class="sourceLineNo">1254</span> }<a name="line.1254"></a>
+<span class="sourceLineNo">1255</span><a name="line.1255"></a>
+<span class="sourceLineNo">1256</span> /**<a name="line.1256"></a>
+<span class="sourceLineNo">1257</span> * Trims whitespace characters from the end of the specified string.<a name="line.1257"></a>
+<span class="sourceLineNo">1258</span> *<a name="line.1258"></a>
+<span class="sourceLineNo">1259</span> * @param s The string to trim.<a name="line.1259"></a>
+<span class="sourceLineNo">1260</span> * @return The trimmed string, or <jk>null</jk> if the string was <jk>null</jk>.<a name="line.1260"></a>
+<span class="sourceLineNo">1261</span> */<a name="line.1261"></a>
+<span class="sourceLineNo">1262</span> public static String trimEnd(String s) {<a name="line.1262"></a>
+<span class="sourceLineNo">1263</span> if (s != null)<a name="line.1263"></a>
+<span class="sourceLineNo">1264</span> while (s.length() > 0 && Character.isWhitespace(s.charAt(s.length()-1)))<a name="line.1264"></a>
+<span class="sourceLineNo">1265</span> s = s.substring(0, s.length()-1);<a name="line.1265"></a>
+<span class="sourceLineNo">1266</span> return s;<a name="line.1266"></a>
+<span class="sourceLineNo">1267</span> }<a name="line.1267"></a>
+<span class="sourceLineNo">1268</span><a name="line.1268"></a>
+<span class="sourceLineNo">1269</span> /**<a name="line.1269"></a>
+<span class="sourceLineNo">1270</span> * Returns <jk>true</jk> if the specified string is one of the specified values.<a name="line.1270"></a>
+<span class="sourceLineNo">1271</span> *<a name="line.1271"></a>
+<span class="sourceLineNo">1272</span> * @param s<a name="line.1272"></a>
+<span class="sourceLineNo">1273</span> * The string to test.<a name="line.1273"></a>
+<span class="sourceLineNo">1274</span> * Can be <jk>null</jk>.<a name="line.1274"></a>
+<span class="sourceLineNo">1275</span> * @param values<a name="line.1275"></a>
+<span class="sourceLineNo">1276</span> * The values to test.<a name="line.1276"></a>
+<span class="sourceLineNo">1277</span> * Can contain <jk>null</jk>.<a name="line.1277"></a>
+<span class="sourceLineNo">1278</span> * @return <jk>true</jk> if the specified string is one of the specified values.<a name="line.1278"></a>
+<span class="sourceLineNo">1279</span> */<a name="line.1279"></a>
+<span class="sourceLineNo">1280</span> public static boolean isOneOf(String s, String...values) {<a name="line.1280"></a>
+<span class="sourceLineNo">1281</span> for (int i = 0; i < values.length; i++)<a name="line.1281"></a>
+<span class="sourceLineNo">1282</span> if (StringUtils.isEquals(s, values[i]))<a name="line.1282"></a>
+<span class="sourceLineNo">1283</span> return true;<a name="line.1283"></a>
+<span class="sourceLineNo">1284</span> return false;<a name="line.1284"></a>
+<span class="sourceLineNo">1285</span> }<a name="line.1285"></a>
+<span class="sourceLineNo">1286</span><a name="line.1286"></a>
+<span class="sourceLineNo">1287</span> /**<a name="line.1287"></a>
+<span class="sourceLineNo">1288</span> * Trims <js>'/'</js> characters from both the start and end of the specified string.<a name="line.1288"></a>
+<span class="sourceLineNo">1289</span> *<a name="line.1289"></a>
+<span class="sourceLineNo">1290</span> * @param s The string to trim.<a name="line.1290"></a>
+<span class="sourceLineNo">1291</span> * @return A new trimmed string, or the same string if no trimming was necessary.<a name="line.1291"></a>
+<span class="sourceLineNo">1292</span> */<a name="line.1292"></a>
+<span class="sourceLineNo">1293</span> public static String trimSlashes(String s) {<a name="line.1293"></a>
+<span class="sourceLineNo">1294</span> if (s == null)<a name="line.1294"></a>
+<span class="sourceLineNo">1295</span> return null;<a name="line.1295"></a>
+<span class="sourceLineNo">1296</span> while (endsWith(s, '/'))<a name="line.1296"></a>
+<span class="sourceLineNo">1297</span> s = s.substring(0, s.length()-1);<a name="line.1297"></a>
+<span class="sourceLineNo">1298</span> while (s.length() > 0 && s.charAt(0) == '/')<a name="line.1298"></a>
+<span class="sourceLineNo">1299</span> s = s.substring(1);<a name="line.1299"></a>
+<span class="sourceLineNo">1300</span> return s;<a name="line.1300"></a>
+<span class="sourceLineNo">1301</span> }<a name="line.1301"></a>
+<span class="sourceLineNo">1302</span><a name="line.1302"></a>
+<span class="sourceLineNo">1303</span> /**<a name="line.1303"></a>
+<span class="sourceLineNo">1304</span> * Trims <js>'/'</js> characters from the end of the specified string.<a name="line.1304"></a>
+<span class="sourceLineNo">1305</span> *<a name="line.1305"></a>
+<span class="sourceLineNo">1306</span> * @param s The string to trim.<a name="line.1306"></a>
+<span class="sourceLineNo">1307</span> * @return A new trimmed string, or the same string if no trimming was necessary.<a name="line.1307"></a>
+<span class="sourceLineNo">1308</span> */<a name="line.1308"></a>
+<span class="sourceLineNo">1309</span> public static String trimTrailingSlashes(String s) {<a name="line.1309"></a>
+<span class="sourceLineNo">1310</span> if (s == null)<a name="line.1310"></a>
+<span class="sourceLineNo">1311</span> return null;<a name="line.1311"></a>
+<span class="sourceLineNo">1312</span> while (endsWith(s, '/'))<a name="line.1312"></a>
+<span class="sourceLineNo">1313</span> s = s.substring(0, s.length()-1);<a name="line.1313"></a>
+<span class="sourceLineNo">1314</span> return s;<a name="line.1314"></a>
+<span class="sourceLineNo">1315</span> }<a name="line.1315"></a>
+<span class="sourceLineNo">1316</span><a name="line.1316"></a>
+<span class="sourceLineNo">1317</span> /**<a name="line.1317"></a>
+<span class="sourceLineNo">1318</span> * Trims <js>'/'</js> characters from the end of the specified string.<a name="line.1318"></a>
+<span class="sourceLineNo">1319</span> *<a name="line.1319"></a>
+<span class="sourceLineNo">1320</span> * @param s The string to trim.<a name="line.1320"></a>
+<span class="sourceLineNo">1321</span> * @return The same string buffer.<a name="line.1321"></a>
+<span class="sourceLineNo">1322</span> */<a name="line.1322"></a>
+<span class="sourceLineNo">1323</span> public static StringBuffer trimTrailingSlashes(StringBuffer s) {<a name="line.1323"></a>
+<span class="sourceLineNo">1324</span> if (s == null)<a name="line.1324"></a>
+<span class="sourceLineNo">1325</span> return null;<a name="line.1325"></a>
+<span class="sourceLineNo">1326</span> while (s.length() > 0 && s.charAt(s.length()-1) == '/')<a name="line.1326"></a>
+<span class="sourceLineNo">1327</span> s.setLength(s.length()-1);<a name="line.1327"></a>
+<span class="sourceLineNo">1328</span> return s;<a name="line.1328"></a>
+<span class="sourceLineNo">1329</span> }<a name="line.1329"></a>
+<span class="sourceLineNo">1330</span><a name="line.1330"></a>
+<span class="sourceLineNo">1331</span> /**<a name="line.1331"></a>
+<span class="sourceLineNo">1332</span> * Decodes a <code>application/x-www-form-urlencoded</code> string using <code>UTF-8</code> encoding scheme.<a name="line.1332"></a>
+<span class="sourceLineNo">1333</span> *<a name="line.1333"></a>
+<span class="sourceLineNo">1334</span> * @param s The string to decode.<a name="line.1334"></a>
+<span class="sourceLineNo">1335</span> * @return The decoded string, or <jk>null</jk> if input is <jk>null</jk>.<a name="line.1335"></a>
+<span class="sourceLineNo">1336</span> */<a name="line.1336"></a>
+<span class="sourceLineNo">1337</span> public static String urlDecode(String s) {<a name="line.1337"></a>
+<span class="sourceLineNo">1338</span> if (s == null)<a name="line.1338"></a>
+<span class="sourceLineNo">1339</span> return s;<a name="line.1339"></a>
+<span class="sourceLineNo">1340</span> boolean needsDecode = false;<a name="line.1340"></a>
+<span class="sourceLineNo">1341</span> for (int i = 0; i < s.length() && ! needsDecode; i++) {<a name="line.1341"></a>
+<span class="sourceLineNo">1342</span> char c = s.charAt(i);<a name="line.1342"></a>
+<span class="sourceLineNo">1343</span> if (c == '+' || c == '%')<a name="line.1343"></a>
+<span class="sourceLineNo">1344</span> needsDecode = true;<a name="line.1344"></a>
+<span class="sourceLineNo">1345</span> }<a name="line.1345"></a>
+<span class="sourceLineNo">1346</span> if (needsDecode)<a name="line.1346"></a>
+<span class="sourceLineNo">1347</span> try {<a name="line.1347"></a>
+<span class="sourceLineNo">1348</span> return URLDecoder.decode(s, "UTF-8");<a name="line.1348"></a>
+<span class="sourceLineNo">1349</span> } catch (UnsupportedEncodingException e) {/* Won't happen */}<a name="line.1349"></a>
+<span class="sourceLineNo">1350</span> return s;<a name="line.1350"></a>
+<span class="sourceLineNo">1351</span> }<a name="line.1351"></a>
+<span class="sourceLineNo">1352</span><a name="line.1352"></a>
+<span class="sourceLineNo">1353</span> /**<a name="line.1353"></a>
+<span class="sourceLineNo">1354</span> * Encodes a <code>application/x-www-form-urlencoded</code> string using <code>UTF-8</code> encoding scheme.<a name="line.1354"></a>
+<span class="sourceLineNo">1355</span> *<a name="line.1355"></a>
+<span class="sourceLineNo">1356</span> * @param s The string to encode.<a name="line.1356"></a>
+<span class="sourceLineNo">1357</span> * @return The encoded string, or <jk>null</jk> if input is <jk>null</jk>.<a name="line.1357"></a>
+<span class="sourceLineNo">1358</span> */<a name="line.1358"></a>
+<span class="sourceLineNo">1359</span> public static String urlEncode(String s) {<a name="line.1359"></a>
+<span class="sourceLineNo">1360</span> if (s == null)<a name="line.1360"></a>
+<span class="sourceLineNo">1361</span> return null;<a name="line.1361"></a>
+<span class="sourceLineNo">1362</span> boolean needsEncode = false;<a name="line.1362"></a>
+<span class="sourceLineNo">1363</span> for (int i = 0; i < s.length() && ! needsEncode; i++)<a name="line.1363"></a>
+<span class="sourceLineNo">1364</span> needsEncode |= (! unencodedChars.contains(s.charAt(i)));<a name="line.1364"></a>
+<span class="sourceLineNo">1365</span> if (needsEncode) {<a name="line.1365"></a>
+<span class="sourceLineNo">1366</span> try {<a name="line.1366"></a>
+<span class="sourceLineNo">1367</span> return URLEncoder.encode(s, "UTF-8");<a name="line.1367"></a>
+<span class="sourceLineNo">1368</span> } catch (UnsupportedEncodingException e) {/* Won't happen */}<a name="line.1368"></a>
+<span class="sourceLineNo">1369</span> }<a name="line.1369"></a>
+<span class="sourceLineNo">1370</span> return s;<a name="line.1370"></a>
+<span class="sourceLineNo">1371</span> }<a name="line.1371"></a>
+<span class="sourceLineNo">1372</span><a name="line.1372"></a>
+<span class="sourceLineNo">1373</span> /**<a name="line.1373"></a>
+<span class="sourceLineNo">1374</span> * Returns the first non-whitespace character in the string.<a name="line.1374"></a>
+<span class="sourceLineNo">1375</span> *<a name="line.1375"></a>
+<span class="sourceLineNo">1376</span> * @param s The string to check.<a name="line.1376"></a>
+<span class="sourceLineNo">1377</span> * @return<a name="line.1377"></a>
+<span class="sourceLineNo">1378</span> * The first non-whitespace character, or <code>0</code> if the string is <jk>null</jk>, empty, or composed<a name="line.1378"></a>
+<span class="sourceLineNo">1379</span> * of only whitespace.<a name="line.1379"></a>
+<span class="sourceLineNo">1380</span> */<a name="line.1380"></a>
+<span class="sourceLineNo">1381</span> public static char firstNonWhitespaceChar(String s) {<a name="line.1381"></a>
+<span class="sourceLineNo">1382</span> if (s != null)<a name="line.1382"></a>
+<span class="sourceLineNo">1383</span> for (int i = 0; i < s.length(); i++)<a name="line.1383"></a>
+<span class="sourceLineNo">1384</span> if (! Character.isWhitespace(s.charAt(i)))<a name="line.1384"></a>
+<span class="sourceLineNo">1385</span> return s.charAt(i);<a name="line.1385"></a>
+<span class="sourceLineNo">1386</span> return 0;<a name="line.1386"></a>
+<span class="sourceLineNo">1387</span> }<a name="line.1387"></a>
+<span class="sourceLineNo">1388</span><a name="line.1388"></a>
+<span class="sourceLineNo">1389</span> /**<a name="line.1389"></a>
+<span class="sourceLineNo">1390</span> * Returns the character at the specified index in the string without throwing exceptions.<a name="line.1390"></a>
+<span class="sourceLineNo">1391</span> *<a name="line.1391"></a>
+<span class="sourceLineNo">1392</span> * @param s The string.<a name="line.1392"></a>
+<span class="sourceLineNo">1393</span> * @param i The index position.<a name="line.1393"></a>
+<span class="sourceLineNo">1394</span> * @return<a name="line.1394"></a>
+<span class="sourceLineNo">1395</span> * The character at the specified index, or <code>0</code> if the index is out-of-range or the string<a name="line.1395"></a>
+<span class="sourceLineNo">1396</span> * is <jk>null</jk>.<a name="line.1396"></a>
+<span class="sourceLineNo">1397</span> */<a name="line.1397"></a>
+<span class="sourceLineNo">1398</span> public static char charAt(String s, int i) {<a name="line.1398"></a>
+<span class="sourceLineNo">1399</span> if (s == null)<a name="line.1399"></a>
+<span class="sourceLineNo">1400</span> return 0;<a name="line.1400"></a>
+<span class="sourceLineNo">1401</span> if (i < 0 || i >= s.length())<a name="line.1401"></a>
+<span class="sourceLineNo">1402</span> return 0;<a name="line.1402"></a>
+<span class="sourceLineNo">1403</span> return s.charAt(i);<a name="line.1403"></a>
+<span class="sourceLineNo">1404</span> }<a name="line.1404"></a>
+<span class="sourceLineNo">1405</span><a name="line.1405"></a>
+<span class="sourceLineNo">1406</span> /**<a name="line.1406"></a>
+<span class="sourceLineNo">1407</span> * Efficiently determines whether a URL is of the pattern "xxx://xxx"<a name="line.1407"></a>
+<span class="sourceLineNo">1408</span> *<a name="line.1408"></a>
+<span class="sourceLineNo">1409</span> * @param s The string to test.<a name="line.1409"></a>
+<span class="sourceLineNo">1410</span> * @return <jk>true</jk> if it's an absolute path.<a name="line.1410"></a>
+<span class="sourceLineNo">1411</span> */<a name="line.1411"></a>
+<span class="sourceLineNo">1412</span> public static boolean isAbsoluteUri(String s) {<a name="line.1412"></a>
<span class="sourceLineNo">1413</span><a name="line.1413"></a>
-<span class="sourceLineNo">1414</span> // Use a state machine for maximum performance.<a name="line.1414"></a>
-<span class="sourceLineNo">1415</span><a name="line.1415"></a>
-<span class="sourceLineNo">1416</span> int S1 = 1; // Looking for http<a name="line.1416"></a>
-<span class="sourceLineNo">1417</span> int S2 = 2; // Found http, looking for :<a name="line.1417"></a>
-<span class="sourceLineNo">1418</span> int S3 = 3; // Found :, looking for /<a name="line.1418"></a>
-<span class="sourceLineNo">1419</span> int S4 = 4; // Found /, looking for /<a name="line.1419"></a>
-<span class="sourceLineNo">1420</span> int S5 = 5; // Found /, looking for x<a name="line.1420"></a>
-<span class="sourceLineNo">1421</span><a name="line.1421"></a>
-<span class="sourceLineNo">1422</span> int state = S1;<a name="line.1422"></a>
-<span class="sourceLineNo">1423</span> for (int i = 0; i < s.length(); i++) {<a name="line.1423"></a>
-<span class="sourceLineNo">1424</span> char c = s.charAt(i);<a name="line.1424"></a>
-<span class="sourceLineNo">1425</span> if (state == S1) {<a name="line.1425"></a>
-<span class="sourceLineNo">1426</span> if (c >= 'a' && c <= 'z')<a name="line.1426"></a>
-<span class="sourceLineNo">1427</span> state = S2;<a name="line.1427"></a>
-<span class="sourceLineNo">1428</span> else<a name="line.1428"></a>
-<span class="sourceLineNo">1429</span> return false;<a name="line.1429"></a>
-<span class="sourceLineNo">1430</span> } else if (state == S2) {<a name="line.1430"></a>
-<span class="sourceLineNo">1431</span> if (c == ':')<a name="line.1431"></a>
-<span class="sourceLineNo">1432</span> state = S3;<a name="line.1432"></a>
-<span class="sourceLineNo">1433</span> else if (c < 'a' || c > 'z')<a name="line.1433"></a>
-<span class="sourceLineNo">1434</span> return false;<a name="line.1434"></a>
-<span class="sourceLineNo">1435</span> } else if (state == S3) {<a name="line.1435"></a>
-<span class="sourceLineNo">1436</span> if (c == '/')<a name="line.1436"></a>
-<span class="sourceLineNo">1437</span> state = S4;<a name="line.1437"></a>
-<span class="sourceLineNo">1438</span> else<a name="line.1438"></a>
-<span class="sourceLineNo">1439</span> return false;<a name="line.1439"></a>
-<span class="sourceLineNo">1440</span> } else if (state == S4) {<a name="line.1440"></a>
-<span class="sourceLineNo">1441</span> if (c == '/')<a name="line.1441"></a>
-<span class="sourceLineNo">1442</span> state = S5;<a name="line.1442"></a>
-<span class="sourceLineNo">1443</span> else<a name="line.1443"></a>
-<span class="sourceLineNo">1444</span> return false;<a name="line.1444"></a>
-<span class="sourceLineNo">1445</span> } else if (state == S5) {<a name="line.1445"></a>
-<span class="sourceLineNo">1446</span> return true;<a name="line.1446"></a>
-<span class="sourceLineNo">1447</span> }<a name="line.1447"></a>
-<span class="sourceLineNo">1448</span> }<a name="line.1448"></a>
-<span class="sourceLineNo">1449</span> return false;<a name="line.1449"></a>
-<span class="sourceLineNo">1450</span> }<a name="line.1450"></a>
-<span class="sourceLineNo">1451</span><a name="line.1451"></a>
-<span class="sourceLineNo">1452</span> /**<a name="line.1452"></a>
-<span class="sourceLineNo">1453</span> * Efficiently determines whether a URL is of the pattern "xxx:/xxx".<a name="line.1453"></a>
-<span class="sourceLineNo">1454</span> *<a name="line.1454"></a>
-<span class="sourceLineNo">1455</span> * <p><a name="line.1455"></a>
-<span class="sourceLineNo">1456</span> * The pattern matched is: <code>[a-z]{2,}\:\/.*</code><a name="line.1456"></a>
+<span class="sourceLineNo">1414</span> if (isEmpty(s))<a name="line.1414"></a>
+<span class="sourceLineNo">1415</span> return false;<a name="line.1415"></a>
+<span class="sourceLineNo">1416</span><a name="line.1416"></a>
+<span class="sourceLineNo">1417</span> // Use a state machine for maximum performance.<a name="line.1417"></a>
+<span class="sourceLineNo">1418</span><a name="line.1418"></a>
+<span class="sourceLineNo">1419</span> int S1 = 1; // Looking for http<a name="line.1419"></a>
+<span class="sourceLineNo">1420</span> int S2 = 2; // Found http, looking for :<a name="line.1420"></a>
+<span class="sourceLineNo">1421</span> int S3 = 3; // Found :, looking for /<a name="line.1421"></a>
+<span class="sourceLineNo">1422</span> int S4 = 4; // Found /, looking for /<a name="line.1422"></a>
+<span class="sourceLineNo">1423</span> int S5 = 5; // Found /, looking for x<a name="line.1423"></a>
+<span class="sourceLineNo">1424</span><a name="line.1424"></a>
+<span class="sourceLineNo">1425</span> int state = S1;<a name="line.1425"></a>
+<span class="sourceLineNo">1426</span> for (int i = 0; i < s.length(); i++) {<a name="line.1426"></a>
+<span class="sourceLineNo">1427</span> char c = s.charAt(i);<a name="line.1427"></a>
+<span class="sourceLineNo">1428</span> if (state == S1) {<a name="line.1428"></a>
+<span class="sourceLineNo">1429</span> if (c >= 'a' && c <= 'z')<a name="line.1429"></a>
+<span class="sourceLineNo">1430</span> state = S2;<a name="line.1430"></a>
+<span class="sourceLineNo">1431</span> else<a name="line.1431"></a>
+<span class="sourceLineNo">1432</span> return false;<a name="line.1432"></a>
+<span class="sourceLineNo">1433</span> } else if (state == S2) {<a name="line.1433"></a>
+<span class="sourceLineNo">1434</span> if (c == ':')<a name="line.1434"></a>
+<span class="sourceLineNo">1435</span> state = S3;<a name="line.1435"></a>
+<span class="sourceLineNo">1436</span> else if (c < 'a' || c > 'z')<a name="line.1436"></a>
+<span class="sourceLineNo">1437</span> return false;<a name="line.1437"></a>
+<span class="sourceLineNo">1438</span> } else if (state == S3) {<a name="line.1438"></a>
+<span class="sourceLineNo">1439</span> if (c == '/')<a name="line.1439"></a>
+<span class="sourceLineNo">1440</span> state = S4;<a name="line.1440"></a>
+<span class="sourceLineNo">1441</span> else<a name="line.1441"></a>
+<span class="sourceLineNo">1442</span> return false;<a name="line.1442"></a>
+<span class="sourceLineNo">1443</span> } else if (state == S4) {<a name="line.1443"></a>
+<span class="sourceLineNo">1444</span> if (c == '/')<a name="line.1444"></a>
+<span class="sourceLineNo">1445</span> state = S5;<a name="line.1445"></a>
+<span class="sourceLineNo">1446</span> else<a name="line.1446"></a>
+<span class="sourceLineNo">1447</span> return false;<a name="line.1447"></a>
+<span class="sourceLineNo">1448</span> } else if (state == S5) {<a name="line.1448"></a>
+<span class="sourceLineNo">1449</span> return true;<a name="line.1449"></a>
+<span class="sourceLineNo">1450</span> }<a name="line.1450"></a>
+<span class="sourceLineNo">1451</span> }<a name="line.1451"></a>
+<span class="sourceLineNo">1452</span> return false;<a name="line.1452"></a>
+<span class="sourceLineNo">1453</span> }<a name="line.1453"></a>
+<span class="sourceLineNo">1454</span><a name="line.1454"></a>
+<span class="sourceLineNo">1455</span> /**<a name="line.1455"></a>
+<span class="sourceLineNo">1456</span> * Efficiently determines whether a URL is of the pattern "xxx:/xxx".<a name="line.1456"></a>
<span class="sourceLineNo">1457</span> *<a name="line.1457"></a>
<span class="sourceLineNo">1458</span> * <p><a name="line.1458"></a>
-<span class="sourceLineNo">1459</span> * Note that this excludes filesystem paths such as <js>"C:/temp"</js>.<a name="line.1459"></a>
+<span class="sourceLineNo">1459</span> * The pattern matched is: <code>[a-z]{2,}\:\/.*</code><a name="line.1459"></a>
<span class="sourceLineNo">1460</span> *<a name="line.1460"></a>
-<span class="sourceLineNo">1461</span> * @param s The string to test.<a name="line.1461"></a>
-<span class="sourceLineNo">1462</span> * @return <jk>true</jk> if it's an absolute path.<a name="line.1462"></a>
-<span class="sourceLineNo">1463</span> */<a name="line.1463"></a>
-<span class="sourceLineNo">1464</span> public static boolean isUri(String s) {<a name="line.1464"></a>
-<span class="sourceLineNo">1465</span><a name="line.1465"></a>
-<span class="sourceLineNo">1466</span> if (isEmpty(s))<a name="line.1466"></a>
-<span class="sourceLineNo">1467</span> return false;<a name="line.1467"></a>
+<span class="sourceLineNo">1461</span> * <p><a name="line.1461"></a>
+<span class="sourceLineNo">1462</span> * Note that this excludes filesystem paths such as <js>"C:/temp"</js>.<a name="line.1462"></a>
+<span class="sourceLineNo">1463</span> *<a name="line.1463"></a>
+<span class="sourceLineNo">1464</span> * @param s The string to test.<a name="line.1464"></a>
+<span class="sourceLineNo">1465</span> * @return <jk>true</jk> if it's an absolute path.<a name="line.1465"></a>
+<span class="sourceLineNo">1466</span> */<a name="line.1466"></a>
+<span class="sourceLineNo">1467</span> public static boolean isUri(String s) {<a name="line.1467"></a>
<span class="sourceLineNo">1468</span><a name="line.1468"></a>
-<span class="sourceLineNo">1469</span> // Use a state machine for maximum performance.<a name="line.1469"></a>
-<span class="sourceLineNo">1470</span><a name="line.1470"></a>
-<span class="sourceLineNo">1471</span> int S1 = 1; // Looking for protocol char 1<a name="line.1471"></a>
-<span class="sourceLineNo">1472</span> int S2 = 2; // Found protocol char 1, looking for protocol char 2<a name="line.1472"></a>
-<span class="sourceLineNo">1473</span> int S3 = 3; // Found protocol char 2, looking for :<a name="line.1473"></a>
-<span class="sourceLineNo">1474</span> int S4 = 4; // Found :, looking for /<a name="line.1474"></a>
-<sp
<TRUNCATED>