You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@commons.apache.org by gg...@apache.org on 2024/03/20 21:47:56 UTC
svn commit: r1085947 [17/32] - in /websites/production/commons/content/proper/commons-configuration: ./ apidocs/ apidocs/org/apache/commons/configuration2/ apidocs/org/apache/commons/configuration2/beanutils/ apidocs/org/apache/commons/configuration2/b...
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/convert/PropertyConverter.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/convert/PropertyConverter.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/convert/PropertyConverter.html Wed Mar 20 21:47:44 2024
@@ -90,11 +90,11 @@
<span class="source-line-no">077</span><span id="line-77"> * Private constructor prevents instances from being created.</span>
<span class="source-line-no">078</span><span id="line-78"> */</span>
<span class="source-line-no">079</span><span id="line-79"> private PropertyConverter() {</span>
-<span class="source-line-no">080</span><span id="line-80"> // to prevent instantiation...</span>
+<span class="source-line-no">080</span><span id="line-80"> // presvents instantiation.</span>
<span class="source-line-no">081</span><span id="line-81"> }</span>
<span class="source-line-no">082</span><span id="line-82"></span>
<span class="source-line-no">083</span><span id="line-83"> /**</span>
-<span class="source-line-no">084</span><span id="line-84"> * Performs a data type conversion from the specified value object to the given target data class. If additional</span>
+<span class="source-line-no">084</span><span id="line-84"> * Converts the specified value object to the given target data class. If additional</span>
<span class="source-line-no">085</span><span id="line-85"> * information is required for this conversion, it is obtained from the passed in {@code DefaultConversionHandler}</span>
<span class="source-line-no">086</span><span id="line-86"> * object. If the class is a primitive type (Integer.TYPE, Boolean.TYPE, etc), the value returned will use the wrapper</span>
<span class="source-line-no">087</span><span id="line-87"> * type (Integer.class, Boolean.class, etc).</span>
@@ -160,7 +160,7 @@
<span class="source-line-no">147</span><span id="line-147"> return toPattern(value);</span>
<span class="source-line-no">148</span><span id="line-148"> } else if (Locale.class.equals(cls)) {</span>
<span class="source-line-no">149</span><span id="line-149"> return toLocale(value);</span>
-<span class="source-line-no">150</span><span id="line-150"> } else if (isEnum(cls)) {</span>
+<span class="source-line-no">150</span><span id="line-150"> } else if (cls.isEnum()) {</span>
<span class="source-line-no">151</span><span id="line-151"> return convertToEnum(cls, value);</span>
<span class="source-line-no">152</span><span id="line-152"> } else if (Color.class.equals(cls)) {</span>
<span class="source-line-no">153</span><span id="line-153"> return toColor(value);</span>
@@ -180,7 +180,7 @@
<span class="source-line-no">167</span><span id="line-167"> }</span>
<span class="source-line-no">168</span><span id="line-168"></span>
<span class="source-line-no">169</span><span id="line-169"> /**</span>
-<span class="source-line-no">170</span><span id="line-170"> * Convert the specified object into a Boolean. Internally the {@code org.apache.commons.lang.BooleanUtils} class from</span>
+<span class="source-line-no">170</span><span id="line-170"> * Converts the specified object into a Boolean. Internally the {@code org.apache.commons.lang.BooleanUtils} class from</span>
<span class="source-line-no">171</span><span id="line-171"> * the <a href="https://commons.apache.org/lang/">Commons Lang</a> project is used to perform this conversion. This</span>
<span class="source-line-no">172</span><span id="line-172"> * class accepts some more tokens for the boolean value of <b>true</b>, e.g. {@code yes} and {@code on}. Please refer to</span>
<span class="source-line-no">173</span><span id="line-173"> * the documentation of this class for more details.</span>
@@ -220,7 +220,7 @@
<span class="source-line-no">207</span><span id="line-207"> }</span>
<span class="source-line-no">208</span><span id="line-208"></span>
<span class="source-line-no">209</span><span id="line-209"> /**</span>
-<span class="source-line-no">210</span><span id="line-210"> * Convert the specified object into a Byte.</span>
+<span class="source-line-no">210</span><span id="line-210"> * Converts the specified object into a Byte.</span>
<span class="source-line-no">211</span><span id="line-211"> *</span>
<span class="source-line-no">212</span><span id="line-212"> * @param value the value to convert</span>
<span class="source-line-no">213</span><span id="line-213"> * @return the converted value</span>
@@ -235,7 +235,7 @@
<span class="source-line-no">222</span><span id="line-222"> }</span>
<span class="source-line-no">223</span><span id="line-223"></span>
<span class="source-line-no">224</span><span id="line-224"> /**</span>
-<span class="source-line-no">225</span><span id="line-225"> * Convert the specified object into a Short.</span>
+<span class="source-line-no">225</span><span id="line-225"> * Converts the specified object into a Short.</span>
<span class="source-line-no">226</span><span id="line-226"> *</span>
<span class="source-line-no">227</span><span id="line-227"> * @param value the value to convert</span>
<span class="source-line-no">228</span><span id="line-228"> * @return the converted value</span>
@@ -250,7 +250,7 @@
<span class="source-line-no">237</span><span id="line-237"> }</span>
<span class="source-line-no">238</span><span id="line-238"></span>
<span class="source-line-no">239</span><span id="line-239"> /**</span>
-<span class="source-line-no">240</span><span id="line-240"> * Convert the specified object into an Integer.</span>
+<span class="source-line-no">240</span><span id="line-240"> * Converts the specified object into an Integer.</span>
<span class="source-line-no">241</span><span id="line-241"> *</span>
<span class="source-line-no">242</span><span id="line-242"> * @param value the value to convert</span>
<span class="source-line-no">243</span><span id="line-243"> * @return the converted value</span>
@@ -265,7 +265,7 @@
<span class="source-line-no">252</span><span id="line-252"> }</span>
<span class="source-line-no">253</span><span id="line-253"></span>
<span class="source-line-no">254</span><span id="line-254"> /**</span>
-<span class="source-line-no">255</span><span id="line-255"> * Convert the specified object into a Long.</span>
+<span class="source-line-no">255</span><span id="line-255"> * Converts the specified object into a Long.</span>
<span class="source-line-no">256</span><span id="line-256"> *</span>
<span class="source-line-no">257</span><span id="line-257"> * @param value the value to convert</span>
<span class="source-line-no">258</span><span id="line-258"> * @return the converted value</span>
@@ -280,7 +280,7 @@
<span class="source-line-no">267</span><span id="line-267"> }</span>
<span class="source-line-no">268</span><span id="line-268"></span>
<span class="source-line-no">269</span><span id="line-269"> /**</span>
-<span class="source-line-no">270</span><span id="line-270"> * Convert the specified object into a Float.</span>
+<span class="source-line-no">270</span><span id="line-270"> * Converts the specified object into a Float.</span>
<span class="source-line-no">271</span><span id="line-271"> *</span>
<span class="source-line-no">272</span><span id="line-272"> * @param value the value to convert</span>
<span class="source-line-no">273</span><span id="line-273"> * @return the converted value</span>
@@ -295,7 +295,7 @@
<span class="source-line-no">282</span><span id="line-282"> }</span>
<span class="source-line-no">283</span><span id="line-283"></span>
<span class="source-line-no">284</span><span id="line-284"> /**</span>
-<span class="source-line-no">285</span><span id="line-285"> * Convert the specified object into a Double.</span>
+<span class="source-line-no">285</span><span id="line-285"> * Converts the specified object into a Double.</span>
<span class="source-line-no">286</span><span id="line-286"> *</span>
<span class="source-line-no">287</span><span id="line-287"> * @param value the value to convert</span>
<span class="source-line-no">288</span><span id="line-288"> * @return the converted value</span>
@@ -310,7 +310,7 @@
<span class="source-line-no">297</span><span id="line-297"> }</span>
<span class="source-line-no">298</span><span id="line-298"></span>
<span class="source-line-no">299</span><span id="line-299"> /**</span>
-<span class="source-line-no">300</span><span id="line-300"> * Convert the specified object into a Duration.</span>
+<span class="source-line-no">300</span><span id="line-300"> * Converts the specified object into a Duration.</span>
<span class="source-line-no">301</span><span id="line-301"> *</span>
<span class="source-line-no">302</span><span id="line-302"> * @param value the value to convert</span>
<span class="source-line-no">303</span><span id="line-303"> * @return the converted value</span>
@@ -332,7 +332,7 @@
<span class="source-line-no">319</span><span id="line-319"> }</span>
<span class="source-line-no">320</span><span id="line-320"></span>
<span class="source-line-no">321</span><span id="line-321"> /**</span>
-<span class="source-line-no">322</span><span id="line-322"> * Convert the specified object into a BigInteger.</span>
+<span class="source-line-no">322</span><span id="line-322"> * Converts the specified object into a BigInteger.</span>
<span class="source-line-no">323</span><span id="line-323"> *</span>
<span class="source-line-no">324</span><span id="line-324"> * @param value the value to convert</span>
<span class="source-line-no">325</span><span id="line-325"> * @return the converted value</span>
@@ -347,7 +347,7 @@
<span class="source-line-no">334</span><span id="line-334"> }</span>
<span class="source-line-no">335</span><span id="line-335"></span>
<span class="source-line-no">336</span><span id="line-336"> /**</span>
-<span class="source-line-no">337</span><span id="line-337"> * Convert the specified object into a BigDecimal.</span>
+<span class="source-line-no">337</span><span id="line-337"> * Converts the specified object into a BigDecimal.</span>
<span class="source-line-no">338</span><span id="line-338"> *</span>
<span class="source-line-no">339</span><span id="line-339"> * @param value the value to convert</span>
<span class="source-line-no">340</span><span id="line-340"> * @return the converted value</span>
@@ -404,7 +404,7 @@
<span class="source-line-no">391</span><span id="line-391"> }</span>
<span class="source-line-no">392</span><span id="line-392"></span>
<span class="source-line-no">393</span><span id="line-393"> /**</span>
-<span class="source-line-no">394</span><span id="line-394"> * Convert the specified object into a File.</span>
+<span class="source-line-no">394</span><span id="line-394"> * Converts the specified object into a File.</span>
<span class="source-line-no">395</span><span id="line-395"> *</span>
<span class="source-line-no">396</span><span id="line-396"> * @param value the value to convert</span>
<span class="source-line-no">397</span><span id="line-397"> * @return the converted value</span>
@@ -425,7 +425,7 @@
<span class="source-line-no">412</span><span id="line-412"> }</span>
<span class="source-line-no">413</span><span id="line-413"></span>
<span class="source-line-no">414</span><span id="line-414"> /**</span>
-<span class="source-line-no">415</span><span id="line-415"> * Convert the specified object into a Path.</span>
+<span class="source-line-no">415</span><span id="line-415"> * Converts the specified object into a Path.</span>
<span class="source-line-no">416</span><span id="line-416"> *</span>
<span class="source-line-no">417</span><span id="line-417"> * @param value the value to convert</span>
<span class="source-line-no">418</span><span id="line-418"> * @return the converted value</span>
@@ -446,7 +446,7 @@
<span class="source-line-no">433</span><span id="line-433"> }</span>
<span class="source-line-no">434</span><span id="line-434"></span>
<span class="source-line-no">435</span><span id="line-435"> /**</span>
-<span class="source-line-no">436</span><span id="line-436"> * Convert the specified object into an URI.</span>
+<span class="source-line-no">436</span><span id="line-436"> * Converts the specified object into an URI.</span>
<span class="source-line-no">437</span><span id="line-437"> *</span>
<span class="source-line-no">438</span><span id="line-438"> * @param value the value to convert</span>
<span class="source-line-no">439</span><span id="line-439"> * @return the converted value</span>
@@ -467,7 +467,7 @@
<span class="source-line-no">454</span><span id="line-454"> }</span>
<span class="source-line-no">455</span><span id="line-455"></span>
<span class="source-line-no">456</span><span id="line-456"> /**</span>
-<span class="source-line-no">457</span><span id="line-457"> * Convert the specified object into an URL.</span>
+<span class="source-line-no">457</span><span id="line-457"> * Converts the specified object into an URL.</span>
<span class="source-line-no">458</span><span id="line-458"> *</span>
<span class="source-line-no">459</span><span id="line-459"> * @param value the value to convert</span>
<span class="source-line-no">460</span><span id="line-460"> * @return the converted value</span>
@@ -488,7 +488,7 @@
<span class="source-line-no">475</span><span id="line-475"> }</span>
<span class="source-line-no">476</span><span id="line-476"></span>
<span class="source-line-no">477</span><span id="line-477"> /**</span>
-<span class="source-line-no">478</span><span id="line-478"> * Convert the specified object into a Pattern.</span>
+<span class="source-line-no">478</span><span id="line-478"> * Converts the specified object into a Pattern.</span>
<span class="source-line-no">479</span><span id="line-479"> *</span>
<span class="source-line-no">480</span><span id="line-480"> * @param value the value to convert</span>
<span class="source-line-no">481</span><span id="line-481"> * @return the converted value</span>
@@ -509,7 +509,7 @@
<span class="source-line-no">496</span><span id="line-496"> }</span>
<span class="source-line-no">497</span><span id="line-497"></span>
<span class="source-line-no">498</span><span id="line-498"> /**</span>
-<span class="source-line-no">499</span><span id="line-499"> * Convert the specified object into a Locale.</span>
+<span class="source-line-no">499</span><span id="line-499"> * Converts the specified object into a Locale.</span>
<span class="source-line-no">500</span><span id="line-500"> *</span>
<span class="source-line-no">501</span><span id="line-501"> * @param value the value to convert</span>
<span class="source-line-no">502</span><span id="line-502"> * @return the converted value</span>
@@ -536,7 +536,7 @@
<span class="source-line-no">523</span><span id="line-523"> }</span>
<span class="source-line-no">524</span><span id="line-524"></span>
<span class="source-line-no">525</span><span id="line-525"> /**</span>
-<span class="source-line-no">526</span><span id="line-526"> * Convert the specified object into a Color. If the value is a String, the format allowed is</span>
+<span class="source-line-no">526</span><span id="line-526"> * Converts the specified object into a Color. If the value is a String, the format allowed is</span>
<span class="source-line-no">527</span><span id="line-527"> * (#)?[0-9A-F]{6}([0-9A-F]{2})?. Examples:</span>
<span class="source-line-no">528</span><span id="line-528"> * <ul></span>
<span class="source-line-no">529</span><span id="line-529"> * <li>FF0000 (red)</li></span>
@@ -592,7 +592,7 @@
<span class="source-line-no">579</span><span id="line-579"> }</span>
<span class="source-line-no">580</span><span id="line-580"></span>
<span class="source-line-no">581</span><span id="line-581"> /**</span>
-<span class="source-line-no">582</span><span id="line-582"> * Convert the specified value into an internet address.</span>
+<span class="source-line-no">582</span><span id="line-582"> * Converts the specified value into an internet address.</span>
<span class="source-line-no">583</span><span id="line-583"> *</span>
<span class="source-line-no">584</span><span id="line-584"> * @param value the value to convert</span>
<span class="source-line-no">585</span><span id="line-585"> * @return the converted value</span>
@@ -615,7 +615,7 @@
<span class="source-line-no">602</span><span id="line-602"> }</span>
<span class="source-line-no">603</span><span id="line-603"></span>
<span class="source-line-no">604</span><span id="line-604"> /**</span>
-<span class="source-line-no">605</span><span id="line-605"> * Convert the specified value into an email address with the given class name.</span>
+<span class="source-line-no">605</span><span id="line-605"> * Converts the specified value into an email address with the given class name.</span>
<span class="source-line-no">606</span><span id="line-606"> *</span>
<span class="source-line-no">607</span><span id="line-607"> * @param value the value to convert</span>
<span class="source-line-no">608</span><span id="line-608"> * @param targetClassName the fully qualified name of the {@code InternetAddress} class to convert to, e.g.,</span>
@@ -641,111 +641,104 @@
<span class="source-line-no">628</span><span id="line-628"> }</span>
<span class="source-line-no">629</span><span id="line-629"></span>
<span class="source-line-no">630</span><span id="line-630"> /**</span>
-<span class="source-line-no">631</span><span id="line-631"> * Calls Class.isEnum() on Java 5, returns false on older JRE.</span>
-<span class="source-line-no">632</span><span id="line-632"> */</span>
-<span class="source-line-no">633</span><span id="line-633"> static boolean isEnum(final Class<?> cls) {</span>
-<span class="source-line-no">634</span><span id="line-634"> return cls.isEnum();</span>
-<span class="source-line-no">635</span><span id="line-635"> }</span>
-<span class="source-line-no">636</span><span id="line-636"></span>
-<span class="source-line-no">637</span><span id="line-637"> /**</span>
-<span class="source-line-no">638</span><span id="line-638"> * Convert the specified value into a Java 5 enum.</span>
-<span class="source-line-no">639</span><span id="line-639"> *</span>
-<span class="source-line-no">640</span><span id="line-640"> * @param value the value to convert</span>
-<span class="source-line-no">641</span><span id="line-641"> * @param cls the type of the enumeration</span>
-<span class="source-line-no">642</span><span id="line-642"> * @return the converted value</span>
-<span class="source-line-no">643</span><span id="line-643"> * @throws ConversionException thrown if the value cannot be converted to an enumeration</span>
-<span class="source-line-no">644</span><span id="line-644"> *</span>
-<span class="source-line-no">645</span><span id="line-645"> * @since 1.5</span>
-<span class="source-line-no">646</span><span id="line-646"> */</span>
-<span class="source-line-no">647</span><span id="line-647"> static <E extends Enum<E>> E toEnum(final Object value, final Class<E> cls) throws ConversionException {</span>
-<span class="source-line-no">648</span><span id="line-648"> if (value.getClass().equals(cls)) {</span>
-<span class="source-line-no">649</span><span id="line-649"> return cls.cast(value);</span>
+<span class="source-line-no">631</span><span id="line-631"> * Converts the specified value into an {@link Enum}.</span>
+<span class="source-line-no">632</span><span id="line-632"> *</span>
+<span class="source-line-no">633</span><span id="line-633"> * @param value the value to convert</span>
+<span class="source-line-no">634</span><span id="line-634"> * @param cls the type of the enumeration</span>
+<span class="source-line-no">635</span><span id="line-635"> * @return the converted value</span>
+<span class="source-line-no">636</span><span id="line-636"> * @throws ConversionException thrown if the value cannot be converted to an enumeration</span>
+<span class="source-line-no">637</span><span id="line-637"> *</span>
+<span class="source-line-no">638</span><span id="line-638"> * @since 1.5</span>
+<span class="source-line-no">639</span><span id="line-639"> */</span>
+<span class="source-line-no">640</span><span id="line-640"> static <E extends Enum<E>> E toEnum(final Object value, final Class<E> cls) throws ConversionException {</span>
+<span class="source-line-no">641</span><span id="line-641"> if (value.getClass().equals(cls)) {</span>
+<span class="source-line-no">642</span><span id="line-642"> return cls.cast(value);</span>
+<span class="source-line-no">643</span><span id="line-643"> }</span>
+<span class="source-line-no">644</span><span id="line-644"> if (value instanceof String) {</span>
+<span class="source-line-no">645</span><span id="line-645"> try {</span>
+<span class="source-line-no">646</span><span id="line-646"> return Enum.valueOf(cls, (String) value);</span>
+<span class="source-line-no">647</span><span id="line-647"> } catch (final Exception e) {</span>
+<span class="source-line-no">648</span><span id="line-648"> throw new ConversionException("The value " + value + " can't be converted to a " + cls.getName());</span>
+<span class="source-line-no">649</span><span id="line-649"> }</span>
<span class="source-line-no">650</span><span id="line-650"> }</span>
-<span class="source-line-no">651</span><span id="line-651"> if (value instanceof String) {</span>
-<span class="source-line-no">652</span><span id="line-652"> try {</span>
-<span class="source-line-no">653</span><span id="line-653"> return Enum.valueOf(cls, (String) value);</span>
-<span class="source-line-no">654</span><span id="line-654"> } catch (final Exception e) {</span>
-<span class="source-line-no">655</span><span id="line-655"> throw new ConversionException("The value " + value + " can't be converted to a " + cls.getName());</span>
-<span class="source-line-no">656</span><span id="line-656"> }</span>
-<span class="source-line-no">657</span><span id="line-657"> }</span>
-<span class="source-line-no">658</span><span id="line-658"> if (!(value instanceof Number)) {</span>
-<span class="source-line-no">659</span><span id="line-659"> throw new ConversionException("The value " + value + " can't be converted to a " + cls.getName());</span>
-<span class="source-line-no">660</span><span id="line-660"> }</span>
-<span class="source-line-no">661</span><span id="line-661"> try {</span>
-<span class="source-line-no">662</span><span id="line-662"> final E[] enumConstants = cls.getEnumConstants();</span>
-<span class="source-line-no">663</span><span id="line-663"> return enumConstants[((Number) value).intValue()];</span>
-<span class="source-line-no">664</span><span id="line-664"> } catch (final Exception e) {</span>
-<span class="source-line-no">665</span><span id="line-665"> throw new ConversionException("The value " + value + " can't be converted to a " + cls.getName());</span>
-<span class="source-line-no">666</span><span id="line-666"> }</span>
-<span class="source-line-no">667</span><span id="line-667"> }</span>
-<span class="source-line-no">668</span><span id="line-668"></span>
-<span class="source-line-no">669</span><span id="line-669"> /**</span>
-<span class="source-line-no">670</span><span id="line-670"> * Convert the specified object into a Date.</span>
-<span class="source-line-no">671</span><span id="line-671"> *</span>
-<span class="source-line-no">672</span><span id="line-672"> * @param value the value to convert</span>
-<span class="source-line-no">673</span><span id="line-673"> * @param format the DateFormat pattern to parse String values</span>
-<span class="source-line-no">674</span><span id="line-674"> * @return the converted value</span>
-<span class="source-line-no">675</span><span id="line-675"> * @throws ConversionException thrown if the value cannot be converted to a Calendar</span>
-<span class="source-line-no">676</span><span id="line-676"> */</span>
-<span class="source-line-no">677</span><span id="line-677"> public static Date toDate(final Object value, final String format) throws ConversionException {</span>
-<span class="source-line-no">678</span><span id="line-678"> if (value instanceof Date) {</span>
-<span class="source-line-no">679</span><span id="line-679"> return (Date) value;</span>
-<span class="source-line-no">680</span><span id="line-680"> }</span>
-<span class="source-line-no">681</span><span id="line-681"> if (value instanceof Calendar) {</span>
-<span class="source-line-no">682</span><span id="line-682"> return ((Calendar) value).getTime();</span>
-<span class="source-line-no">683</span><span id="line-683"> }</span>
-<span class="source-line-no">684</span><span id="line-684"> if (!(value instanceof String)) {</span>
-<span class="source-line-no">685</span><span id="line-685"> throw new ConversionException("The value " + value + " can't be converted to a Date");</span>
-<span class="source-line-no">686</span><span id="line-686"> }</span>
-<span class="source-line-no">687</span><span id="line-687"> try {</span>
-<span class="source-line-no">688</span><span id="line-688"> return new SimpleDateFormat(format).parse((String) value);</span>
-<span class="source-line-no">689</span><span id="line-689"> } catch (final ParseException e) {</span>
-<span class="source-line-no">690</span><span id="line-690"> throw new ConversionException("The value " + value + " can't be converted to a Date", e);</span>
-<span class="source-line-no">691</span><span id="line-691"> }</span>
-<span class="source-line-no">692</span><span id="line-692"> }</span>
-<span class="source-line-no">693</span><span id="line-693"></span>
-<span class="source-line-no">694</span><span id="line-694"> /**</span>
-<span class="source-line-no">695</span><span id="line-695"> * Convert the specified object into a Calendar.</span>
-<span class="source-line-no">696</span><span id="line-696"> *</span>
-<span class="source-line-no">697</span><span id="line-697"> * @param value the value to convert</span>
-<span class="source-line-no">698</span><span id="line-698"> * @param format the DateFormat pattern to parse String values</span>
-<span class="source-line-no">699</span><span id="line-699"> * @return the converted value</span>
-<span class="source-line-no">700</span><span id="line-700"> * @throws ConversionException thrown if the value cannot be converted to a Calendar</span>
-<span class="source-line-no">701</span><span id="line-701"> */</span>
-<span class="source-line-no">702</span><span id="line-702"> public static Calendar toCalendar(final Object value, final String format) throws ConversionException {</span>
-<span class="source-line-no">703</span><span id="line-703"> if (value instanceof Calendar) {</span>
-<span class="source-line-no">704</span><span id="line-704"> return (Calendar) value;</span>
-<span class="source-line-no">705</span><span id="line-705"> }</span>
-<span class="source-line-no">706</span><span id="line-706"> if (value instanceof Date) {</span>
-<span class="source-line-no">707</span><span id="line-707"> final Calendar calendar = Calendar.getInstance();</span>
-<span class="source-line-no">708</span><span id="line-708"> calendar.setTime((Date) value);</span>
-<span class="source-line-no">709</span><span id="line-709"> return calendar;</span>
-<span class="source-line-no">710</span><span id="line-710"> }</span>
-<span class="source-line-no">711</span><span id="line-711"> if (!(value instanceof String)) {</span>
-<span class="source-line-no">712</span><span id="line-712"> throw new ConversionException("The value " + value + " can't be converted to a Calendar");</span>
+<span class="source-line-no">651</span><span id="line-651"> if (!(value instanceof Number)) {</span>
+<span class="source-line-no">652</span><span id="line-652"> throw new ConversionException("The value " + value + " can't be converted to a " + cls.getName());</span>
+<span class="source-line-no">653</span><span id="line-653"> }</span>
+<span class="source-line-no">654</span><span id="line-654"> try {</span>
+<span class="source-line-no">655</span><span id="line-655"> final E[] enumConstants = cls.getEnumConstants();</span>
+<span class="source-line-no">656</span><span id="line-656"> return enumConstants[((Number) value).intValue()];</span>
+<span class="source-line-no">657</span><span id="line-657"> } catch (final Exception e) {</span>
+<span class="source-line-no">658</span><span id="line-658"> throw new ConversionException("The value " + value + " can't be converted to a " + cls.getName());</span>
+<span class="source-line-no">659</span><span id="line-659"> }</span>
+<span class="source-line-no">660</span><span id="line-660"> }</span>
+<span class="source-line-no">661</span><span id="line-661"></span>
+<span class="source-line-no">662</span><span id="line-662"> /**</span>
+<span class="source-line-no">663</span><span id="line-663"> * Converts the specified object into a Date.</span>
+<span class="source-line-no">664</span><span id="line-664"> *</span>
+<span class="source-line-no">665</span><span id="line-665"> * @param value the value to convert</span>
+<span class="source-line-no">666</span><span id="line-666"> * @param format the DateFormat pattern to parse String values</span>
+<span class="source-line-no">667</span><span id="line-667"> * @return the converted value</span>
+<span class="source-line-no">668</span><span id="line-668"> * @throws ConversionException thrown if the value cannot be converted to a Calendar</span>
+<span class="source-line-no">669</span><span id="line-669"> */</span>
+<span class="source-line-no">670</span><span id="line-670"> public static Date toDate(final Object value, final String format) throws ConversionException {</span>
+<span class="source-line-no">671</span><span id="line-671"> if (value instanceof Date) {</span>
+<span class="source-line-no">672</span><span id="line-672"> return (Date) value;</span>
+<span class="source-line-no">673</span><span id="line-673"> }</span>
+<span class="source-line-no">674</span><span id="line-674"> if (value instanceof Calendar) {</span>
+<span class="source-line-no">675</span><span id="line-675"> return ((Calendar) value).getTime();</span>
+<span class="source-line-no">676</span><span id="line-676"> }</span>
+<span class="source-line-no">677</span><span id="line-677"> if (!(value instanceof String)) {</span>
+<span class="source-line-no">678</span><span id="line-678"> throw new ConversionException("The value " + value + " can't be converted to a Date");</span>
+<span class="source-line-no">679</span><span id="line-679"> }</span>
+<span class="source-line-no">680</span><span id="line-680"> try {</span>
+<span class="source-line-no">681</span><span id="line-681"> return new SimpleDateFormat(format).parse((String) value);</span>
+<span class="source-line-no">682</span><span id="line-682"> } catch (final ParseException e) {</span>
+<span class="source-line-no">683</span><span id="line-683"> throw new ConversionException("The value " + value + " can't be converted to a Date", e);</span>
+<span class="source-line-no">684</span><span id="line-684"> }</span>
+<span class="source-line-no">685</span><span id="line-685"> }</span>
+<span class="source-line-no">686</span><span id="line-686"></span>
+<span class="source-line-no">687</span><span id="line-687"> /**</span>
+<span class="source-line-no">688</span><span id="line-688"> * Converts the specified object into a Calendar.</span>
+<span class="source-line-no">689</span><span id="line-689"> *</span>
+<span class="source-line-no">690</span><span id="line-690"> * @param value the value to convert</span>
+<span class="source-line-no">691</span><span id="line-691"> * @param format the DateFormat pattern to parse String values</span>
+<span class="source-line-no">692</span><span id="line-692"> * @return the converted value</span>
+<span class="source-line-no">693</span><span id="line-693"> * @throws ConversionException thrown if the value cannot be converted to a Calendar</span>
+<span class="source-line-no">694</span><span id="line-694"> */</span>
+<span class="source-line-no">695</span><span id="line-695"> public static Calendar toCalendar(final Object value, final String format) throws ConversionException {</span>
+<span class="source-line-no">696</span><span id="line-696"> if (value instanceof Calendar) {</span>
+<span class="source-line-no">697</span><span id="line-697"> return (Calendar) value;</span>
+<span class="source-line-no">698</span><span id="line-698"> }</span>
+<span class="source-line-no">699</span><span id="line-699"> if (value instanceof Date) {</span>
+<span class="source-line-no">700</span><span id="line-700"> final Calendar calendar = Calendar.getInstance();</span>
+<span class="source-line-no">701</span><span id="line-701"> calendar.setTime((Date) value);</span>
+<span class="source-line-no">702</span><span id="line-702"> return calendar;</span>
+<span class="source-line-no">703</span><span id="line-703"> }</span>
+<span class="source-line-no">704</span><span id="line-704"> if (!(value instanceof String)) {</span>
+<span class="source-line-no">705</span><span id="line-705"> throw new ConversionException("The value " + value + " can't be converted to a Calendar");</span>
+<span class="source-line-no">706</span><span id="line-706"> }</span>
+<span class="source-line-no">707</span><span id="line-707"> try {</span>
+<span class="source-line-no">708</span><span id="line-708"> final Calendar calendar = Calendar.getInstance();</span>
+<span class="source-line-no">709</span><span id="line-709"> calendar.setTime(new SimpleDateFormat(format).parse((String) value));</span>
+<span class="source-line-no">710</span><span id="line-710"> return calendar;</span>
+<span class="source-line-no">711</span><span id="line-711"> } catch (final ParseException e) {</span>
+<span class="source-line-no">712</span><span id="line-712"> throw new ConversionException("The value " + value + " can't be converted to a Calendar", e);</span>
<span class="source-line-no">713</span><span id="line-713"> }</span>
-<span class="source-line-no">714</span><span id="line-714"> try {</span>
-<span class="source-line-no">715</span><span id="line-715"> final Calendar calendar = Calendar.getInstance();</span>
-<span class="source-line-no">716</span><span id="line-716"> calendar.setTime(new SimpleDateFormat(format).parse((String) value));</span>
-<span class="source-line-no">717</span><span id="line-717"> return calendar;</span>
-<span class="source-line-no">718</span><span id="line-718"> } catch (final ParseException e) {</span>
-<span class="source-line-no">719</span><span id="line-719"> throw new ConversionException("The value " + value + " can't be converted to a Calendar", e);</span>
-<span class="source-line-no">720</span><span id="line-720"> }</span>
-<span class="source-line-no">721</span><span id="line-721"> }</span>
-<span class="source-line-no">722</span><span id="line-722"></span>
-<span class="source-line-no">723</span><span id="line-723"> /**</span>
-<span class="source-line-no">724</span><span id="line-724"> * Helper method for converting a value to a constant of an enumeration class.</span>
-<span class="source-line-no">725</span><span id="line-725"> *</span>
-<span class="source-line-no">726</span><span id="line-726"> * @param enumClass the enumeration class</span>
-<span class="source-line-no">727</span><span id="line-727"> * @param value the value to be converted</span>
-<span class="source-line-no">728</span><span id="line-728"> * @return the converted value</span>
-<span class="source-line-no">729</span><span id="line-729"> */</span>
-<span class="source-line-no">730</span><span id="line-730"> @SuppressWarnings("unchecked")</span>
-<span class="source-line-no">731</span><span id="line-731"> // conversion is safe because we know that the class is an Enum class</span>
-<span class="source-line-no">732</span><span id="line-732"> private static Object convertToEnum(final Class<?> enumClass, final Object value) {</span>
-<span class="source-line-no">733</span><span id="line-733"> return toEnum(value, enumClass.asSubclass(Enum.class));</span>
-<span class="source-line-no">734</span><span id="line-734"> }</span>
-<span class="source-line-no">735</span><span id="line-735">}</span>
+<span class="source-line-no">714</span><span id="line-714"> }</span>
+<span class="source-line-no">715</span><span id="line-715"></span>
+<span class="source-line-no">716</span><span id="line-716"> /**</span>
+<span class="source-line-no">717</span><span id="line-717"> * Converts a value to a constant of an enumeration class.</span>
+<span class="source-line-no">718</span><span id="line-718"> *</span>
+<span class="source-line-no">719</span><span id="line-719"> * @param enumClass the enumeration class</span>
+<span class="source-line-no">720</span><span id="line-720"> * @param value the value to be converted</span>
+<span class="source-line-no">721</span><span id="line-721"> * @return the converted value</span>
+<span class="source-line-no">722</span><span id="line-722"> */</span>
+<span class="source-line-no">723</span><span id="line-723"> @SuppressWarnings("unchecked")</span>
+<span class="source-line-no">724</span><span id="line-724"> // conversion is safe because we know that the class is an Enum class</span>
+<span class="source-line-no">725</span><span id="line-725"> private static Object convertToEnum(final Class<?> enumClass, final Object value) {</span>
+<span class="source-line-no">726</span><span id="line-726"> return toEnum(value, enumClass.asSubclass(Enum.class));</span>
+<span class="source-line-no">727</span><span id="line-727"> }</span>
+<span class="source-line-no">728</span><span id="line-728">}</span>
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/io/FileHandlerListener.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/io/FileHandlerListener.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/io/FileHandlerListener.html Wed Mar 20 21:47:44 2024
@@ -43,41 +43,41 @@
<span class="source-line-no">030</span><span id="line-30"> */</span>
<span class="source-line-no">031</span><span id="line-31">public interface FileHandlerListener {</span>
<span class="source-line-no">032</span><span id="line-32"> /**</span>
-<span class="source-line-no">033</span><span id="line-33"> * Notification that the associated file is about to be loaded. This method is called immediately before the load</span>
-<span class="source-line-no">034</span><span id="line-34"> * operation.</span>
-<span class="source-line-no">035</span><span id="line-35"> *</span>
-<span class="source-line-no">036</span><span id="line-36"> * @param handler the file handler</span>
-<span class="source-line-no">037</span><span id="line-37"> */</span>
-<span class="source-line-no">038</span><span id="line-38"> void loading(FileHandler handler);</span>
-<span class="source-line-no">039</span><span id="line-39"></span>
-<span class="source-line-no">040</span><span id="line-40"> /**</span>
-<span class="source-line-no">041</span><span id="line-41"> * Notification that the associated file has been loaded. This method is called directly after the load operation.</span>
+<span class="source-line-no">033</span><span id="line-33"> * Notification that the associated file has been loaded. This method is called directly after the load operation.</span>
+<span class="source-line-no">034</span><span id="line-34"> *</span>
+<span class="source-line-no">035</span><span id="line-35"> * @param handler the file handler</span>
+<span class="source-line-no">036</span><span id="line-36"> */</span>
+<span class="source-line-no">037</span><span id="line-37"> void loaded(FileHandler handler);</span>
+<span class="source-line-no">038</span><span id="line-38"></span>
+<span class="source-line-no">039</span><span id="line-39"> /**</span>
+<span class="source-line-no">040</span><span id="line-40"> * Notification that the associated file is about to be loaded. This method is called immediately before the load</span>
+<span class="source-line-no">041</span><span id="line-41"> * operation.</span>
<span class="source-line-no">042</span><span id="line-42"> *</span>
<span class="source-line-no">043</span><span id="line-43"> * @param handler the file handler</span>
<span class="source-line-no">044</span><span id="line-44"> */</span>
-<span class="source-line-no">045</span><span id="line-45"> void loaded(FileHandler handler);</span>
+<span class="source-line-no">045</span><span id="line-45"> void loading(FileHandler handler);</span>
<span class="source-line-no">046</span><span id="line-46"></span>
<span class="source-line-no">047</span><span id="line-47"> /**</span>
-<span class="source-line-no">048</span><span id="line-48"> * Notification that the associated file is about to be saved. This method is called immediately before the save</span>
-<span class="source-line-no">049</span><span id="line-49"> * operation.</span>
-<span class="source-line-no">050</span><span id="line-50"> *</span>
-<span class="source-line-no">051</span><span id="line-51"> * @param handler the file handler</span>
-<span class="source-line-no">052</span><span id="line-52"> */</span>
-<span class="source-line-no">053</span><span id="line-53"> void saving(FileHandler handler);</span>
-<span class="source-line-no">054</span><span id="line-54"></span>
-<span class="source-line-no">055</span><span id="line-55"> /**</span>
-<span class="source-line-no">056</span><span id="line-56"> * Notification that the associated file has been saved. This method is called directly after the save operation.</span>
-<span class="source-line-no">057</span><span id="line-57"> *</span>
-<span class="source-line-no">058</span><span id="line-58"> * @param handler the file handler</span>
-<span class="source-line-no">059</span><span id="line-59"> */</span>
-<span class="source-line-no">060</span><span id="line-60"> void saved(FileHandler handler);</span>
-<span class="source-line-no">061</span><span id="line-61"></span>
-<span class="source-line-no">062</span><span id="line-62"> /**</span>
-<span class="source-line-no">063</span><span id="line-63"> * Notification that a property of the monitored {@code FileHandler} has changed.</span>
+<span class="source-line-no">048</span><span id="line-48"> * Notification that a property of the monitored {@code FileHandler} has changed.</span>
+<span class="source-line-no">049</span><span id="line-49"> *</span>
+<span class="source-line-no">050</span><span id="line-50"> * @param handler the file handler</span>
+<span class="source-line-no">051</span><span id="line-51"> */</span>
+<span class="source-line-no">052</span><span id="line-52"> void locationChanged(FileHandler handler);</span>
+<span class="source-line-no">053</span><span id="line-53"></span>
+<span class="source-line-no">054</span><span id="line-54"> /**</span>
+<span class="source-line-no">055</span><span id="line-55"> * Notification that the associated file has been saved. This method is called directly after the save operation.</span>
+<span class="source-line-no">056</span><span id="line-56"> *</span>
+<span class="source-line-no">057</span><span id="line-57"> * @param handler the file handler</span>
+<span class="source-line-no">058</span><span id="line-58"> */</span>
+<span class="source-line-no">059</span><span id="line-59"> void saved(FileHandler handler);</span>
+<span class="source-line-no">060</span><span id="line-60"></span>
+<span class="source-line-no">061</span><span id="line-61"> /**</span>
+<span class="source-line-no">062</span><span id="line-62"> * Notification that the associated file is about to be saved. This method is called immediately before the save</span>
+<span class="source-line-no">063</span><span id="line-63"> * operation.</span>
<span class="source-line-no">064</span><span id="line-64"> *</span>
<span class="source-line-no">065</span><span id="line-65"> * @param handler the file handler</span>
<span class="source-line-no">066</span><span id="line-66"> */</span>
-<span class="source-line-no">067</span><span id="line-67"> void locationChanged(FileHandler handler);</span>
+<span class="source-line-no">067</span><span id="line-67"> void saving(FileHandler handler);</span>
<span class="source-line-no">068</span><span id="line-68">}</span>
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/CatalogResolver.Catalog.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/CatalogResolver.Catalog.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/CatalogResolver.Catalog.html Wed Mar 20 21:47:44 2024
@@ -176,7 +176,7 @@
<span class="source-line-no">163</span><span id="line-163"> final String badFilePrefix = "file://";</span>
<span class="source-line-no">164</span><span id="line-164"> final String correctFilePrefix = "file:///";</span>
<span class="source-line-no">165</span><span id="line-165"></span>
-<span class="source-line-no">166</span><span id="line-166"> // Java 5 has a bug when constructing file URLS</span>
+<span class="source-line-no">166</span><span id="line-166"> // Java 5 has a bug when constructing file URLs</span>
<span class="source-line-no">167</span><span id="line-167"> if (resolved.startsWith(badFilePrefix) && !resolved.startsWith(correctFilePrefix)) {</span>
<span class="source-line-no">168</span><span id="line-168"> resolved = correctFilePrefix + resolved.substring(badFilePrefix.length());</span>
<span class="source-line-no">169</span><span id="line-169"> }</span>
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/CatalogResolver.CatalogManager.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/CatalogResolver.CatalogManager.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/CatalogResolver.CatalogManager.html Wed Mar 20 21:47:44 2024
@@ -176,7 +176,7 @@
<span class="source-line-no">163</span><span id="line-163"> final String badFilePrefix = "file://";</span>
<span class="source-line-no">164</span><span id="line-164"> final String correctFilePrefix = "file:///";</span>
<span class="source-line-no">165</span><span id="line-165"></span>
-<span class="source-line-no">166</span><span id="line-166"> // Java 5 has a bug when constructing file URLS</span>
+<span class="source-line-no">166</span><span id="line-166"> // Java 5 has a bug when constructing file URLs</span>
<span class="source-line-no">167</span><span id="line-167"> if (resolved.startsWith(badFilePrefix) && !resolved.startsWith(correctFilePrefix)) {</span>
<span class="source-line-no">168</span><span id="line-168"> resolved = correctFilePrefix + resolved.substring(badFilePrefix.length());</span>
<span class="source-line-no">169</span><span id="line-169"> }</span>
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/CatalogResolver.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/CatalogResolver.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/CatalogResolver.html Wed Mar 20 21:47:44 2024
@@ -176,7 +176,7 @@
<span class="source-line-no">163</span><span id="line-163"> final String badFilePrefix = "file://";</span>
<span class="source-line-no">164</span><span id="line-164"> final String correctFilePrefix = "file:///";</span>
<span class="source-line-no">165</span><span id="line-165"></span>
-<span class="source-line-no">166</span><span id="line-166"> // Java 5 has a bug when constructing file URLS</span>
+<span class="source-line-no">166</span><span id="line-166"> // Java 5 has a bug when constructing file URLs</span>
<span class="source-line-no">167</span><span id="line-167"> if (resolved.startsWith(badFilePrefix) && !resolved.startsWith(correctFilePrefix)) {</span>
<span class="source-line-no">168</span><span id="line-168"> resolved = correctFilePrefix + resolved.substring(badFilePrefix.length());</span>
<span class="source-line-no">169</span><span id="line-169"> }</span>
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/EntityRegistry.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/EntityRegistry.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/resolver/EntityRegistry.html Wed Mar 20 21:47:44 2024
@@ -39,31 +39,31 @@
<span class="source-line-no">026</span><span id="line-26"> */</span>
<span class="source-line-no">027</span><span id="line-27">public interface EntityRegistry {</span>
<span class="source-line-no">028</span><span id="line-28"> /**</span>
-<span class="source-line-no">029</span><span id="line-29"> * <p></span>
-<span class="source-line-no">030</span><span id="line-30"> * Registers the specified URL for the specified public identifier.</span>
-<span class="source-line-no">031</span><span id="line-31"> * </p></span>
-<span class="source-line-no">032</span><span id="line-32"> * <p></span>
-<span class="source-line-no">033</span><span id="line-33"> * This implementation maps {@code PUBLICID}'s to URLs (from which the resource will be loaded). A common use case for</span>
-<span class="source-line-no">034</span><span id="line-34"> * this method is to register local URLs (possibly computed at runtime by a class loader) for DTDs and Schemas. This</span>
-<span class="source-line-no">035</span><span id="line-35"> * allows the performance advantage of using a local version without having to ensure every {@code SYSTEM} URI on every</span>
-<span class="source-line-no">036</span><span id="line-36"> * processed XML document is local. This implementation provides only basic functionality. If more sophisticated</span>
-<span class="source-line-no">037</span><span id="line-37"> * features are required, either calling {@code XMLConfiguration.setDocumentBuilder(DocumentBuilder)} to set a custom</span>
-<span class="source-line-no">038</span><span id="line-38"> * {@code DocumentBuilder} (which also can be initialized with a custom {@code EntityResolver}) or creating a custom</span>
-<span class="source-line-no">039</span><span id="line-39"> * entity resolver and registering it with the XMLConfiguration is recommended.</span>
-<span class="source-line-no">040</span><span id="line-40"> * </p></span>
-<span class="source-line-no">041</span><span id="line-41"> *</span>
-<span class="source-line-no">042</span><span id="line-42"> * @param publicId Public identifier of the Entity to be resolved</span>
-<span class="source-line-no">043</span><span id="line-43"> * @param entityURL The URL to use for reading this Entity</span>
-<span class="source-line-no">044</span><span id="line-44"> * @throws IllegalArgumentException if the public ID is undefined</span>
-<span class="source-line-no">045</span><span id="line-45"> */</span>
-<span class="source-line-no">046</span><span id="line-46"> void registerEntityId(String publicId, URL entityURL);</span>
-<span class="source-line-no">047</span><span id="line-47"></span>
-<span class="source-line-no">048</span><span id="line-48"> /**</span>
-<span class="source-line-no">049</span><span id="line-49"> * Gets a map with the entity IDs that have been registered using the {@code registerEntityId()} method.</span>
-<span class="source-line-no">050</span><span id="line-50"> *</span>
-<span class="source-line-no">051</span><span id="line-51"> * @return a map with the registered entity IDs</span>
+<span class="source-line-no">029</span><span id="line-29"> * Gets a map with the entity IDs that have been registered using the {@code registerEntityId()} method.</span>
+<span class="source-line-no">030</span><span id="line-30"> *</span>
+<span class="source-line-no">031</span><span id="line-31"> * @return a map with the registered entity IDs</span>
+<span class="source-line-no">032</span><span id="line-32"> */</span>
+<span class="source-line-no">033</span><span id="line-33"> Map<String, URL> getRegisteredEntities();</span>
+<span class="source-line-no">034</span><span id="line-34"></span>
+<span class="source-line-no">035</span><span id="line-35"> /**</span>
+<span class="source-line-no">036</span><span id="line-36"> * <p></span>
+<span class="source-line-no">037</span><span id="line-37"> * Registers the specified URL for the specified public identifier.</span>
+<span class="source-line-no">038</span><span id="line-38"> * </p></span>
+<span class="source-line-no">039</span><span id="line-39"> * <p></span>
+<span class="source-line-no">040</span><span id="line-40"> * This implementation maps {@code PUBLICID}'s to URLs (from which the resource will be loaded). A common use case for</span>
+<span class="source-line-no">041</span><span id="line-41"> * this method is to register local URLs (possibly computed at runtime by a class loader) for DTDs and Schemas. This</span>
+<span class="source-line-no">042</span><span id="line-42"> * allows the performance advantage of using a local version without having to ensure every {@code SYSTEM} URI on every</span>
+<span class="source-line-no">043</span><span id="line-43"> * processed XML document is local. This implementation provides only basic functionality. If more sophisticated</span>
+<span class="source-line-no">044</span><span id="line-44"> * features are required, either calling {@code XMLConfiguration.setDocumentBuilder(DocumentBuilder)} to set a custom</span>
+<span class="source-line-no">045</span><span id="line-45"> * {@code DocumentBuilder} (which also can be initialized with a custom {@code EntityResolver}) or creating a custom</span>
+<span class="source-line-no">046</span><span id="line-46"> * entity resolver and registering it with the XMLConfiguration is recommended.</span>
+<span class="source-line-no">047</span><span id="line-47"> * </p></span>
+<span class="source-line-no">048</span><span id="line-48"> *</span>
+<span class="source-line-no">049</span><span id="line-49"> * @param publicId Public identifier of the Entity to be resolved</span>
+<span class="source-line-no">050</span><span id="line-50"> * @param entityURL The URL to use for reading this Entity</span>
+<span class="source-line-no">051</span><span id="line-51"> * @throws IllegalArgumentException if the public ID is undefined</span>
<span class="source-line-no">052</span><span id="line-52"> */</span>
-<span class="source-line-no">053</span><span id="line-53"> Map<String, URL> getRegisteredEntities();</span>
+<span class="source-line-no">053</span><span id="line-53"> void registerEntityId(String publicId, URL entityURL);</span>
<span class="source-line-no">054</span><span id="line-54">}</span>
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/sync/NoOpSynchronizer.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/sync/NoOpSynchronizer.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/sync/NoOpSynchronizer.html Wed Mar 20 21:47:44 2024
@@ -55,11 +55,11 @@
<span class="source-line-no">042</span><span id="line-42"> }</span>
<span class="source-line-no">043</span><span id="line-43"></span>
<span class="source-line-no">044</span><span id="line-44"> @Override</span>
-<span class="source-line-no">045</span><span id="line-45"> public void endRead() {</span>
+<span class="source-line-no">045</span><span id="line-45"> public void beginWrite() {</span>
<span class="source-line-no">046</span><span id="line-46"> }</span>
<span class="source-line-no">047</span><span id="line-47"></span>
<span class="source-line-no">048</span><span id="line-48"> @Override</span>
-<span class="source-line-no">049</span><span id="line-49"> public void beginWrite() {</span>
+<span class="source-line-no">049</span><span id="line-49"> public void endRead() {</span>
<span class="source-line-no">050</span><span id="line-50"> }</span>
<span class="source-line-no">051</span><span id="line-51"></span>
<span class="source-line-no">052</span><span id="line-52"> @Override</span>
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/sync/Synchronizer.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/sync/Synchronizer.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/sync/Synchronizer.html Wed Mar 20 21:47:44 2024
@@ -65,17 +65,17 @@
<span class="source-line-no">052</span><span id="line-52"> void beginRead();</span>
<span class="source-line-no">053</span><span id="line-53"></span>
<span class="source-line-no">054</span><span id="line-54"> /**</span>
-<span class="source-line-no">055</span><span id="line-55"> * Notifies this {@code Synchronizer} that the current thread has finished its read operation. This may cause other</span>
-<span class="source-line-no">056</span><span id="line-56"> * waiting threads to be granted access to the managed configuration.</span>
-<span class="source-line-no">057</span><span id="line-57"> */</span>
-<span class="source-line-no">058</span><span id="line-58"> void endRead();</span>
-<span class="source-line-no">059</span><span id="line-59"></span>
-<span class="source-line-no">060</span><span id="line-60"> /**</span>
-<span class="source-line-no">061</span><span id="line-61"> * Notifies this {@code Synchronizer} that the current thread is going to start a write operation on the managed</span>
-<span class="source-line-no">062</span><span id="line-62"> * configuration. This call may block. For instance, a concrete implementation may suspend the thread until all read</span>
-<span class="source-line-no">063</span><span id="line-63"> * operations currently active are finished,</span>
+<span class="source-line-no">055</span><span id="line-55"> * Notifies this {@code Synchronizer} that the current thread is going to start a write operation on the managed</span>
+<span class="source-line-no">056</span><span id="line-56"> * configuration. This call may block. For instance, a concrete implementation may suspend the thread until all read</span>
+<span class="source-line-no">057</span><span id="line-57"> * operations currently active are finished,</span>
+<span class="source-line-no">058</span><span id="line-58"> */</span>
+<span class="source-line-no">059</span><span id="line-59"> void beginWrite();</span>
+<span class="source-line-no">060</span><span id="line-60"></span>
+<span class="source-line-no">061</span><span id="line-61"> /**</span>
+<span class="source-line-no">062</span><span id="line-62"> * Notifies this {@code Synchronizer} that the current thread has finished its read operation. This may cause other</span>
+<span class="source-line-no">063</span><span id="line-63"> * waiting threads to be granted access to the managed configuration.</span>
<span class="source-line-no">064</span><span id="line-64"> */</span>
-<span class="source-line-no">065</span><span id="line-65"> void beginWrite();</span>
+<span class="source-line-no">065</span><span id="line-65"> void endRead();</span>
<span class="source-line-no">066</span><span id="line-66"></span>
<span class="source-line-no">067</span><span id="line-67"> /**</span>
<span class="source-line-no">068</span><span id="line-68"> * Notifies this {@code Synchronizer} that the current thread has finished its write operation. This may cause other</span>
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/sync/SynchronizerSupport.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/sync/SynchronizerSupport.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/sync/SynchronizerSupport.html Wed Mar 20 21:47:44 2024
@@ -56,40 +56,40 @@
<span class="source-line-no">043</span><span id="line-43"> Synchronizer getSynchronizer();</span>
<span class="source-line-no">044</span><span id="line-44"></span>
<span class="source-line-no">045</span><span id="line-45"> /**</span>
-<span class="source-line-no">046</span><span id="line-46"> * Sets the {@code Synchronizer} to be used by this object. Calling this method and setting an appropriate</span>
-<span class="source-line-no">047</span><span id="line-47"> * {@code Synchronizer} determines whether this object can be accessed in a thread-safe way or not. The argument may be</span>
-<span class="source-line-no">048</span><span id="line-48"> * <b>null</b>; in this case an implementation should switch to a default {@code Synchronizer}.</span>
-<span class="source-line-no">049</span><span id="line-49"> *</span>
-<span class="source-line-no">050</span><span id="line-50"> * @param sync the {@code Synchronizer} for this object</span>
-<span class="source-line-no">051</span><span id="line-51"> */</span>
-<span class="source-line-no">052</span><span id="line-52"> void setSynchronizer(Synchronizer sync);</span>
-<span class="source-line-no">053</span><span id="line-53"></span>
-<span class="source-line-no">054</span><span id="line-54"> /**</span>
-<span class="source-line-no">055</span><span id="line-55"> * Locks this object for the specified mode. This call may block until this object is released from other lock</span>
-<span class="source-line-no">056</span><span id="line-56"> * operations. When it returns the caller can access the object in a way compatible to the specified {@code LockMode}.</span>
-<span class="source-line-no">057</span><span id="line-57"> * When done the {@code unlock()} must be called with the same {@code LockMode} argument. In practice, a</span>
-<span class="source-line-no">058</span><span id="line-58"> * <b>try</b>-<b>finally</b> construct should be used as in the following example:</span>
-<span class="source-line-no">059</span><span id="line-59"> *</span>
-<span class="source-line-no">060</span><span id="line-60"> * <pre></span>
-<span class="source-line-no">061</span><span id="line-61"> * SynchronizerSupport syncSupport = ...;</span>
-<span class="source-line-no">062</span><span id="line-62"> * syncSupport.lock(LockMode.READ);</span>
-<span class="source-line-no">063</span><span id="line-63"> * try</span>
-<span class="source-line-no">064</span><span id="line-64"> * {</span>
-<span class="source-line-no">065</span><span id="line-65"> * // read access to syncSupport</span>
-<span class="source-line-no">066</span><span id="line-66"> * }</span>
-<span class="source-line-no">067</span><span id="line-67"> * finally</span>
-<span class="source-line-no">068</span><span id="line-68"> * {</span>
-<span class="source-line-no">069</span><span id="line-69"> * syncSupport.unlock(LockMode.READ);</span>
-<span class="source-line-no">070</span><span id="line-70"> * }</span>
-<span class="source-line-no">071</span><span id="line-71"> * </pre></span>
-<span class="source-line-no">072</span><span id="line-72"> *</span>
-<span class="source-line-no">073</span><span id="line-73"> * <em>Note:</em> Always use this method for obtaining a lock rather than accessing the object's {@link Synchronizer}</span>
-<span class="source-line-no">074</span><span id="line-74"> * directly. An implementation may perform additional actions which are not executed when only interacting with the</span>
-<span class="source-line-no">075</span><span id="line-75"> * {@code Synchronizer}.</span>
+<span class="source-line-no">046</span><span id="line-46"> * Locks this object for the specified mode. This call may block until this object is released from other lock</span>
+<span class="source-line-no">047</span><span id="line-47"> * operations. When it returns the caller can access the object in a way compatible to the specified {@code LockMode}.</span>
+<span class="source-line-no">048</span><span id="line-48"> * When done the {@code unlock()} must be called with the same {@code LockMode} argument. In practice, a</span>
+<span class="source-line-no">049</span><span id="line-49"> * <b>try</b>-<b>finally</b> construct should be used as in the following example:</span>
+<span class="source-line-no">050</span><span id="line-50"> *</span>
+<span class="source-line-no">051</span><span id="line-51"> * <pre></span>
+<span class="source-line-no">052</span><span id="line-52"> * SynchronizerSupport syncSupport = ...;</span>
+<span class="source-line-no">053</span><span id="line-53"> * syncSupport.lock(LockMode.READ);</span>
+<span class="source-line-no">054</span><span id="line-54"> * try</span>
+<span class="source-line-no">055</span><span id="line-55"> * {</span>
+<span class="source-line-no">056</span><span id="line-56"> * // read access to syncSupport</span>
+<span class="source-line-no">057</span><span id="line-57"> * }</span>
+<span class="source-line-no">058</span><span id="line-58"> * finally</span>
+<span class="source-line-no">059</span><span id="line-59"> * {</span>
+<span class="source-line-no">060</span><span id="line-60"> * syncSupport.unlock(LockMode.READ);</span>
+<span class="source-line-no">061</span><span id="line-61"> * }</span>
+<span class="source-line-no">062</span><span id="line-62"> * </pre></span>
+<span class="source-line-no">063</span><span id="line-63"> *</span>
+<span class="source-line-no">064</span><span id="line-64"> * <em>Note:</em> Always use this method for obtaining a lock rather than accessing the object's {@link Synchronizer}</span>
+<span class="source-line-no">065</span><span id="line-65"> * directly. An implementation may perform additional actions which are not executed when only interacting with the</span>
+<span class="source-line-no">066</span><span id="line-66"> * {@code Synchronizer}.</span>
+<span class="source-line-no">067</span><span id="line-67"> *</span>
+<span class="source-line-no">068</span><span id="line-68"> * @param mode the {@code LockMode}</span>
+<span class="source-line-no">069</span><span id="line-69"> */</span>
+<span class="source-line-no">070</span><span id="line-70"> void lock(LockMode mode);</span>
+<span class="source-line-no">071</span><span id="line-71"></span>
+<span class="source-line-no">072</span><span id="line-72"> /**</span>
+<span class="source-line-no">073</span><span id="line-73"> * Sets the {@code Synchronizer} to be used by this object. Calling this method and setting an appropriate</span>
+<span class="source-line-no">074</span><span id="line-74"> * {@code Synchronizer} determines whether this object can be accessed in a thread-safe way or not. The argument may be</span>
+<span class="source-line-no">075</span><span id="line-75"> * <b>null</b>; in this case an implementation should switch to a default {@code Synchronizer}.</span>
<span class="source-line-no">076</span><span id="line-76"> *</span>
-<span class="source-line-no">077</span><span id="line-77"> * @param mode the {@code LockMode}</span>
+<span class="source-line-no">077</span><span id="line-77"> * @param sync the {@code Synchronizer} for this object</span>
<span class="source-line-no">078</span><span id="line-78"> */</span>
-<span class="source-line-no">079</span><span id="line-79"> void lock(LockMode mode);</span>
+<span class="source-line-no">079</span><span id="line-79"> void setSynchronizer(Synchronizer sync);</span>
<span class="source-line-no">080</span><span id="line-80"></span>
<span class="source-line-no">081</span><span id="line-81"> /**</span>
<span class="source-line-no">082</span><span id="line-82"> * Releases a lock of this object that was obtained using the {@link #lock(LockMode)} method. This method must always be</span>
Modified: websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/tree/ConfigurationNodeVisitor.html
==============================================================================
--- websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/tree/ConfigurationNodeVisitor.html (original)
+++ websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/tree/ConfigurationNodeVisitor.html Wed Mar 20 21:47:44 2024
@@ -48,30 +48,30 @@
<span class="source-line-no">035</span><span id="line-35"> */</span>
<span class="source-line-no">036</span><span id="line-36">public interface ConfigurationNodeVisitor<T> {</span>
<span class="source-line-no">037</span><span id="line-37"> /**</span>
-<span class="source-line-no">038</span><span id="line-38"> * Visits the specified node before the children of this node - if existing - are processed.</span>
-<span class="source-line-no">039</span><span id="line-39"> *</span>
-<span class="source-line-no">040</span><span id="line-40"> * @param node the node to be visited</span>
-<span class="source-line-no">041</span><span id="line-41"> * @param handler the {@code NodeHandler}</span>
-<span class="source-line-no">042</span><span id="line-42"> */</span>
-<span class="source-line-no">043</span><span id="line-43"> void visitBeforeChildren(T node, NodeHandler<T> handler);</span>
-<span class="source-line-no">044</span><span id="line-44"></span>
-<span class="source-line-no">045</span><span id="line-45"> /**</span>
-<span class="source-line-no">046</span><span id="line-46"> * Visits the specified node after after its children - if existing - have been processed.</span>
-<span class="source-line-no">047</span><span id="line-47"> *</span>
-<span class="source-line-no">048</span><span id="line-48"> * @param node the node to be visited</span>
-<span class="source-line-no">049</span><span id="line-49"> * @param handler the {@code NodeHandler}</span>
-<span class="source-line-no">050</span><span id="line-50"> */</span>
-<span class="source-line-no">051</span><span id="line-51"> void visitAfterChildren(T node, NodeHandler<T> handler);</span>
-<span class="source-line-no">052</span><span id="line-52"></span>
-<span class="source-line-no">053</span><span id="line-53"> /**</span>
-<span class="source-line-no">054</span><span id="line-54"> * Returns a flag whether the current visit process should be aborted. This method allows a visitor implementation to</span>
-<span class="source-line-no">055</span><span id="line-55"> * state that it does not need any further data. It may be used e.g. by visitors that search for a certain node in the</span>
-<span class="source-line-no">056</span><span id="line-56"> * hierarchy. After that node was found, there is no need to process the remaining nodes, too. This method is called</span>
-<span class="source-line-no">057</span><span id="line-57"> * after each visited node. A result of <strong>true</strong> indicates that the current iteration is to be aborted.</span>
-<span class="source-line-no">058</span><span id="line-58"> *</span>
-<span class="source-line-no">059</span><span id="line-59"> * @return a flag if the visit process should be stopped</span>
+<span class="source-line-no">038</span><span id="line-38"> * Returns a flag whether the current visit process should be aborted. This method allows a visitor implementation to</span>
+<span class="source-line-no">039</span><span id="line-39"> * state that it does not need any further data. It may be used e.g. by visitors that search for a certain node in the</span>
+<span class="source-line-no">040</span><span id="line-40"> * hierarchy. After that node was found, there is no need to process the remaining nodes, too. This method is called</span>
+<span class="source-line-no">041</span><span id="line-41"> * after each visited node. A result of <strong>true</strong> indicates that the current iteration is to be aborted.</span>
+<span class="source-line-no">042</span><span id="line-42"> *</span>
+<span class="source-line-no">043</span><span id="line-43"> * @return a flag if the visit process should be stopped</span>
+<span class="source-line-no">044</span><span id="line-44"> */</span>
+<span class="source-line-no">045</span><span id="line-45"> boolean terminate();</span>
+<span class="source-line-no">046</span><span id="line-46"></span>
+<span class="source-line-no">047</span><span id="line-47"> /**</span>
+<span class="source-line-no">048</span><span id="line-48"> * Visits the specified node after after its children - if existing - have been processed.</span>
+<span class="source-line-no">049</span><span id="line-49"> *</span>
+<span class="source-line-no">050</span><span id="line-50"> * @param node the node to be visited</span>
+<span class="source-line-no">051</span><span id="line-51"> * @param handler the {@code NodeHandler}</span>
+<span class="source-line-no">052</span><span id="line-52"> */</span>
+<span class="source-line-no">053</span><span id="line-53"> void visitAfterChildren(T node, NodeHandler<T> handler);</span>
+<span class="source-line-no">054</span><span id="line-54"></span>
+<span class="source-line-no">055</span><span id="line-55"> /**</span>
+<span class="source-line-no">056</span><span id="line-56"> * Visits the specified node before the children of this node - if existing - are processed.</span>
+<span class="source-line-no">057</span><span id="line-57"> *</span>
+<span class="source-line-no">058</span><span id="line-58"> * @param node the node to be visited</span>
+<span class="source-line-no">059</span><span id="line-59"> * @param handler the {@code NodeHandler}</span>
<span class="source-line-no">060</span><span id="line-60"> */</span>
-<span class="source-line-no">061</span><span id="line-61"> boolean terminate();</span>
+<span class="source-line-no">061</span><span id="line-61"> void visitBeforeChildren(T node, NodeHandler<T> handler);</span>
<span class="source-line-no">062</span><span id="line-62">}</span>