Modified:
websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/CompositeConfiguration.html
==============================================================================
---
websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/CompositeConfiguration.html
(original)
+++
websites/production/commons/content/proper/commons-configuration/apidocs/src-html/org/apache/commons/configuration2/CompositeConfiguration.html
Wed Mar 20 22:19:06 2024
@@ -73,438 +73,439 @@
<span class="source-line-no">060</span><span id="line-60"> * </p></span>
<span class="source-line-no">061</span><span id="line-61"> */</span>
<span class="source-line-no">062</span><span id="line-62">public class
CompositeConfiguration extends AbstractConfiguration implements Cloneable
{</span>
-<span class="source-line-no">063</span><span id="line-63"> /** List holding
all the configuration */</span>
-<span class="source-line-no">064</span><span id="line-64"> private
List<Configuration> configList = new LinkedList<>();</span>
-<span class="source-line-no">065</span><span id="line-65"></span>
-<span class="source-line-no">066</span><span id="line-66"> /**</span>
-<span class="source-line-no">067</span><span id="line-67"> * Configuration
that holds in memory stuff. Inserted as first so any setProperty() override
anything else added.</span>
-<span class="source-line-no">068</span><span id="line-68"> */</span>
-<span class="source-line-no">069</span><span id="line-69"> private
Configuration inMemoryConfiguration;</span>
-<span class="source-line-no">070</span><span id="line-70"></span>
-<span class="source-line-no">071</span><span id="line-71"> /**</span>
-<span class="source-line-no">072</span><span id="line-72"> * Stores a flag
whether the current in-memory configuration is also a child
configuration.</span>
-<span class="source-line-no">073</span><span id="line-73"> */</span>
-<span class="source-line-no">074</span><span id="line-74"> private boolean
inMemoryConfigIsChild;</span>
-<span class="source-line-no">075</span><span id="line-75"></span>
-<span class="source-line-no">076</span><span id="line-76"> /**</span>
-<span class="source-line-no">077</span><span id="line-77"> * Creates an
empty CompositeConfiguration object which can then be added some other
Configuration files</span>
-<span class="source-line-no">078</span><span id="line-78"> */</span>
-<span class="source-line-no">079</span><span id="line-79"> public
CompositeConfiguration() {</span>
-<span class="source-line-no">080</span><span id="line-80">
clear();</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"> * Creates a
CompositeConfiguration object with a specified <em>in-memory
configuration</em>. This configuration will</span>
-<span class="source-line-no">085</span><span id="line-85"> * store any
changes made to the {@code CompositeConfiguration}. Note: Use this constructor
if you want to set a special</span>
-<span class="source-line-no">086</span><span id="line-86"> * type of
in-memory configuration. If you have a configuration which should act as both a
child configuration and as</span>
-<span class="source-line-no">087</span><span id="line-87"> * in-memory
configuration, use {@link #addConfiguration(Configuration, boolean)} with a
value of <b>true</b> instead.</span>
-<span class="source-line-no">088</span><span id="line-88"> *</span>
-<span class="source-line-no">089</span><span id="line-89"> * @param
inMemoryConfiguration the in memory configuration to use</span>
-<span class="source-line-no">090</span><span id="line-90"> */</span>
-<span class="source-line-no">091</span><span id="line-91"> public
CompositeConfiguration(final Configuration inMemoryConfiguration) {</span>
-<span class="source-line-no">092</span><span id="line-92">
configList.clear();</span>
-<span class="source-line-no">093</span><span id="line-93">
this.inMemoryConfiguration = inMemoryConfiguration;</span>
-<span class="source-line-no">094</span><span id="line-94">
configList.add(inMemoryConfiguration);</span>
-<span class="source-line-no">095</span><span id="line-95"> }</span>
-<span class="source-line-no">096</span><span id="line-96"></span>
-<span class="source-line-no">097</span><span id="line-97"> /**</span>
-<span class="source-line-no">098</span><span id="line-98"> * Create a
CompositeConfiguration with an empty in memory configuration and adds the
collection of configurations</span>
-<span class="source-line-no">099</span><span id="line-99"> *
specified.</span>
-<span class="source-line-no">100</span><span id="line-100"> *</span>
-<span class="source-line-no">101</span><span id="line-101"> * @param
configurations the collection of configurations to add</span>
-<span class="source-line-no">102</span><span id="line-102"> */</span>
-<span class="source-line-no">103</span><span id="line-103"> public
CompositeConfiguration(final Collection<? extends Configuration>
configurations) {</span>
-<span class="source-line-no">104</span><span id="line-104"> this(new
BaseConfiguration(), configurations);</span>
-<span class="source-line-no">105</span><span id="line-105"> }</span>
-<span class="source-line-no">106</span><span id="line-106"></span>
-<span class="source-line-no">107</span><span id="line-107"> /**</span>
-<span class="source-line-no">108</span><span id="line-108"> * Creates a
CompositeConfiguration with a specified <em>in-memory
configuration</em>, and then adds the given</span>
-<span class="source-line-no">109</span><span id="line-109"> * collection
of configurations.</span>
-<span class="source-line-no">110</span><span id="line-110"> *</span>
-<span class="source-line-no">111</span><span id="line-111"> * @param
inMemoryConfiguration the in memory configuration to use</span>
-<span class="source-line-no">112</span><span id="line-112"> * @param
configurations the collection of configurations to add</span>
-<span class="source-line-no">113</span><span id="line-113"> * @see
#CompositeConfiguration(Configuration)</span>
-<span class="source-line-no">114</span><span id="line-114"> */</span>
-<span class="source-line-no">115</span><span id="line-115"> public
CompositeConfiguration(final Configuration inMemoryConfiguration, final
Collection<? extends Configuration> configurations) {</span>
-<span class="source-line-no">116</span><span id="line-116">
this(inMemoryConfiguration);</span>
-<span class="source-line-no">117</span><span id="line-117"> if
(configurations != null) {</span>
-<span class="source-line-no">118</span><span id="line-118">
configurations.forEach(this::addConfiguration);</span>
-<span class="source-line-no">119</span><span id="line-119"> }</span>
-<span class="source-line-no">120</span><span id="line-120"> }</span>
-<span class="source-line-no">121</span><span id="line-121"></span>
-<span class="source-line-no">122</span><span id="line-122"> /**</span>
-<span class="source-line-no">123</span><span id="line-123"> * Add a
configuration.</span>
-<span class="source-line-no">124</span><span id="line-124"> *</span>
-<span class="source-line-no">125</span><span id="line-125"> * @param
config the configuration to add</span>
-<span class="source-line-no">126</span><span id="line-126"> */</span>
-<span class="source-line-no">127</span><span id="line-127"> public void
addConfiguration(final Configuration config) {</span>
-<span class="source-line-no">128</span><span id="line-128">
addConfiguration(config, false);</span>
-<span class="source-line-no">129</span><span id="line-129"> }</span>
-<span class="source-line-no">130</span><span id="line-130"></span>
-<span class="source-line-no">131</span><span id="line-131"> /**</span>
-<span class="source-line-no">132</span><span id="line-132"> * Adds a child
configuration and optionally makes it the <em>in-memory
configuration</em>. This means that all future</span>
-<span class="source-line-no">133</span><span id="line-133"> * property
write operations are executed on this configuration. Note that the current
in-memory configuration is</span>
-<span class="source-line-no">134</span><span id="line-134"> * replaced by
the new one. If it was created automatically or passed to the constructor, it
is removed from the list of</span>
-<span class="source-line-no">135</span><span id="line-135"> * child
configurations! Otherwise, it stays in the list of child configurations at its
current position, but it passes</span>
-<span class="source-line-no">136</span><span id="line-136"> * its role as
in-memory configuration to the new one.</span>
-<span class="source-line-no">137</span><span id="line-137"> *</span>
-<span class="source-line-no">138</span><span id="line-138"> * @param
config the configuration to be added</span>
-<span class="source-line-no">139</span><span id="line-139"> * @param
asInMemory <b>true</b> if this configuration becomes the new
<em>in-memory</em> configuration, <b>false</b></span>
-<span class="source-line-no">140</span><span id="line-140"> *
otherwise</span>
-<span class="source-line-no">141</span><span id="line-141"> * @since
1.8</span>
-<span class="source-line-no">142</span><span id="line-142"> */</span>
-<span class="source-line-no">143</span><span id="line-143"> public void
addConfiguration(final Configuration config, final boolean asInMemory) {</span>
-<span class="source-line-no">144</span><span id="line-144">
beginWrite(false);</span>
-<span class="source-line-no">145</span><span id="line-145"> try {</span>
-<span class="source-line-no">146</span><span id="line-146"> if
(!configList.contains(config)) {</span>
-<span class="source-line-no">147</span><span id="line-147"> if
(asInMemory) {</span>
-<span class="source-line-no">148</span><span id="line-148">
replaceInMemoryConfiguration(config);</span>
-<span class="source-line-no">149</span><span id="line-149">
inMemoryConfigIsChild = true;</span>
-<span class="source-line-no">150</span><span id="line-150">
}</span>
-<span class="source-line-no">151</span><span id="line-151"></span>
-<span class="source-line-no">152</span><span id="line-152"> if
(!inMemoryConfigIsChild) {</span>
-<span class="source-line-no">153</span><span id="line-153">
// As the inMemoryConfiguration contains all manually added</span>
-<span class="source-line-no">154</span><span id="line-154">
// keys, we must make sure that it is always last. "Normal", non</span>
-<span class="source-line-no">155</span><span id="line-155">
// composed configurations add their keys at the end of the</span>
-<span class="source-line-no">156</span><span id="line-156">
// configuration and we want to mimic this behavior.</span>
-<span class="source-line-no">157</span><span id="line-157">
configList.add(configList.indexOf(inMemoryConfiguration), config);</span>
-<span class="source-line-no">158</span><span id="line-158"> }
else {</span>
-<span class="source-line-no">159</span><span id="line-159">
// However, if the in-memory configuration is a regular child,</span>
-<span class="source-line-no">160</span><span id="line-160">
// only the order in which child configurations are added is relevant</span>
-<span class="source-line-no">161</span><span id="line-161">
configList.add(config);</span>
-<span class="source-line-no">162</span><span id="line-162">
}</span>
-<span class="source-line-no">163</span><span id="line-163"></span>
-<span class="source-line-no">164</span><span id="line-164"> if
(config instanceof AbstractConfiguration) {</span>
-<span class="source-line-no">165</span><span id="line-165">
((AbstractConfiguration)
config).setThrowExceptionOnMissing(isThrowExceptionOnMissing());</span>
-<span class="source-line-no">166</span><span id="line-166">
}</span>
-<span class="source-line-no">167</span><span id="line-167"> }</span>
-<span class="source-line-no">168</span><span id="line-168"> } finally
{</span>
-<span class="source-line-no">169</span><span id="line-169">
endWrite();</span>
-<span class="source-line-no">170</span><span id="line-170"> }</span>
-<span class="source-line-no">171</span><span id="line-171"> }</span>
-<span class="source-line-no">172</span><span id="line-172"></span>
-<span class="source-line-no">173</span><span id="line-173"> /**</span>
-<span class="source-line-no">174</span><span id="line-174"> * Add a
configuration to the start of the list of child configurations.</span>
-<span class="source-line-no">175</span><span id="line-175"> *</span>
-<span class="source-line-no">176</span><span id="line-176"> * @param
config the configuration to add</span>
-<span class="source-line-no">177</span><span id="line-177"> * @since
2.3</span>
-<span class="source-line-no">178</span><span id="line-178"> */</span>
-<span class="source-line-no">179</span><span id="line-179"> public void
addConfigurationFirst(final Configuration config) {</span>
-<span class="source-line-no">180</span><span id="line-180">
addConfigurationFirst(config, false);</span>
-<span class="source-line-no">181</span><span id="line-181"> }</span>
-<span class="source-line-no">182</span><span id="line-182"></span>
-<span class="source-line-no">183</span><span id="line-183"> /**</span>
-<span class="source-line-no">184</span><span id="line-184"> * Adds a child
configuration to the start of the collection and optionally makes it the
<em>in-memory</span>
-<span class="source-line-no">185</span><span id="line-185"> *
configuration</em>. This means that all future property write operations
are executed on this configuration. Note</span>
-<span class="source-line-no">186</span><span id="line-186"> * that the
current in-memory configuration is replaced by the new one. If it was created
automatically or passed to the</span>
-<span class="source-line-no">187</span><span id="line-187"> * constructor,
it is removed from the list of child configurations! Otherwise, it stays in the
list of child</span>
-<span class="source-line-no">188</span><span id="line-188"> *
configurations at its current position, but it passes its role as in-memory
configuration to the new one.</span>
-<span class="source-line-no">189</span><span id="line-189"> *</span>
-<span class="source-line-no">190</span><span id="line-190"> * @param
config the configuration to be added</span>
-<span class="source-line-no">191</span><span id="line-191"> * @param
asInMemory <b>true</b> if this configuration becomes the new
<em>in-memory</em> configuration, <b>false</b></span>
-<span class="source-line-no">192</span><span id="line-192"> *
otherwise</span>
-<span class="source-line-no">193</span><span id="line-193"> * @since
2.3</span>
-<span class="source-line-no">194</span><span id="line-194"> */</span>
-<span class="source-line-no">195</span><span id="line-195"> public void
addConfigurationFirst(final Configuration config, final boolean asInMemory)
{</span>
-<span class="source-line-no">196</span><span id="line-196">
beginWrite(false);</span>
-<span class="source-line-no">197</span><span id="line-197"> try {</span>
-<span class="source-line-no">198</span><span id="line-198"> if
(!configList.contains(config)) {</span>
-<span class="source-line-no">199</span><span id="line-199"> if
(asInMemory) {</span>
-<span class="source-line-no">200</span><span id="line-200">
replaceInMemoryConfiguration(config);</span>
-<span class="source-line-no">201</span><span id="line-201">
inMemoryConfigIsChild = true;</span>
-<span class="source-line-no">202</span><span id="line-202">
}</span>
-<span class="source-line-no">203</span><span id="line-203">
configList.add(0, config);</span>
-<span class="source-line-no">204</span><span id="line-204"></span>
-<span class="source-line-no">205</span><span id="line-205"> if
(config instanceof AbstractConfiguration) {</span>
-<span class="source-line-no">206</span><span id="line-206">
((AbstractConfiguration)
config).setThrowExceptionOnMissing(isThrowExceptionOnMissing());</span>
-<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"> } finally
{</span>
-<span class="source-line-no">210</span><span id="line-210">
endWrite();</span>
-<span class="source-line-no">211</span><span id="line-211"> }</span>
-<span class="source-line-no">212</span><span id="line-212"> }</span>
-<span class="source-line-no">213</span><span id="line-213"></span>
-<span class="source-line-no">214</span><span id="line-214"> /**</span>
-<span class="source-line-no">215</span><span id="line-215"> * Remove a
configuration. The in memory configuration cannot be removed.</span>
-<span class="source-line-no">216</span><span id="line-216"> *</span>
-<span class="source-line-no">217</span><span id="line-217"> * @param
config The configuration to remove</span>
-<span class="source-line-no">218</span><span id="line-218"> */</span>
-<span class="source-line-no">219</span><span id="line-219"> public void
removeConfiguration(final Configuration config) {</span>
-<span class="source-line-no">220</span><span id="line-220">
beginWrite(false);</span>
-<span class="source-line-no">221</span><span id="line-221"> try {</span>
-<span class="source-line-no">222</span><span id="line-222"> // Make
sure that you can't remove the inMemoryConfiguration from</span>
-<span class="source-line-no">223</span><span id="line-223"> // the
CompositeConfiguration object</span>
-<span class="source-line-no">224</span><span id="line-224"> if
(!config.equals(inMemoryConfiguration)) {</span>
-<span class="source-line-no">225</span><span id="line-225">
configList.remove(config);</span>
-<span class="source-line-no">226</span><span id="line-226"> }</span>
-<span class="source-line-no">227</span><span id="line-227"> } finally
{</span>
-<span class="source-line-no">228</span><span id="line-228">
endWrite();</span>
-<span class="source-line-no">229</span><span id="line-229"> }</span>
-<span class="source-line-no">230</span><span id="line-230"> }</span>
-<span class="source-line-no">231</span><span id="line-231"></span>
-<span class="source-line-no">232</span><span id="line-232"> /**</span>
-<span class="source-line-no">233</span><span id="line-233"> * Gets the
number of configurations.</span>
-<span class="source-line-no">234</span><span id="line-234"> *</span>
-<span class="source-line-no">235</span><span id="line-235"> * @return the
number of configuration</span>
-<span class="source-line-no">236</span><span id="line-236"> */</span>
-<span class="source-line-no">237</span><span id="line-237"> public int
getNumberOfConfigurations() {</span>
-<span class="source-line-no">238</span><span id="line-238">
beginRead(false);</span>
-<span class="source-line-no">239</span><span id="line-239"> try {</span>
-<span class="source-line-no">240</span><span id="line-240"> return
configList.size();</span>
-<span class="source-line-no">241</span><span id="line-241"> } finally
{</span>
-<span class="source-line-no">242</span><span id="line-242">
endRead();</span>
-<span class="source-line-no">243</span><span id="line-243"> }</span>
-<span class="source-line-no">244</span><span id="line-244"> }</span>
-<span class="source-line-no">245</span><span id="line-245"></span>
-<span class="source-line-no">246</span><span id="line-246"> /**</span>
-<span class="source-line-no">247</span><span id="line-247"> * Removes all
child configurations and reinitializes the <em>in-memory
configuration</em>. <strong>Attention:</strong></span>
-<span class="source-line-no">248</span><span id="line-248"> * A new
in-memory configuration is created; the old one is lost.</span>
-<span class="source-line-no">249</span><span id="line-249"> */</span>
-<span class="source-line-no">250</span><span id="line-250"> @Override</span>
-<span class="source-line-no">251</span><span id="line-251"> protected void
clearInternal() {</span>
-<span class="source-line-no">252</span><span id="line-252">
configList.clear();</span>
-<span class="source-line-no">253</span><span id="line-253"> // recreate
the in memory configuration</span>
-<span class="source-line-no">254</span><span id="line-254">
inMemoryConfiguration = new BaseConfiguration();</span>
-<span class="source-line-no">255</span><span id="line-255">
((BaseConfiguration)
inMemoryConfiguration).setThrowExceptionOnMissing(isThrowExceptionOnMissing());</span>
-<span class="source-line-no">256</span><span id="line-256">
((BaseConfiguration)
inMemoryConfiguration).setListDelimiterHandler(getListDelimiterHandler());</span>
-<span class="source-line-no">257</span><span id="line-257">
configList.add(inMemoryConfiguration);</span>
-<span class="source-line-no">258</span><span id="line-258">
inMemoryConfigIsChild = false;</span>
-<span class="source-line-no">259</span><span id="line-259"> }</span>
-<span class="source-line-no">260</span><span id="line-260"></span>
-<span class="source-line-no">261</span><span id="line-261"> /**</span>
-<span class="source-line-no">262</span><span id="line-262"> * Add this
property to the in-memory Configuration.</span>
-<span class="source-line-no">263</span><span id="line-263"> *</span>
-<span class="source-line-no">264</span><span id="line-264"> * @param key
The Key to add the property to.</span>
-<span class="source-line-no">265</span><span id="line-265"> * @param token
The Value to add.</span>
-<span class="source-line-no">266</span><span id="line-266"> */</span>
-<span class="source-line-no">267</span><span id="line-267"> @Override</span>
-<span class="source-line-no">268</span><span id="line-268"> protected void
addPropertyDirect(final String key, final Object token) {</span>
-<span class="source-line-no">269</span><span id="line-269">
inMemoryConfiguration.addProperty(key, token);</span>
-<span class="source-line-no">270</span><span id="line-270"> }</span>
-<span class="source-line-no">271</span><span id="line-271"></span>
-<span class="source-line-no">272</span><span id="line-272"> /**</span>
-<span class="source-line-no">273</span><span id="line-273"> * Read
property from underlying composite</span>
-<span class="source-line-no">274</span><span id="line-274"> *</span>
-<span class="source-line-no">275</span><span id="line-275"> * @param key
key to use for mapping</span>
-<span class="source-line-no">276</span><span id="line-276"> *</span>
-<span class="source-line-no">277</span><span id="line-277"> * @return
object associated with the given configuration key.</span>
-<span class="source-line-no">278</span><span id="line-278"> */</span>
-<span class="source-line-no">279</span><span id="line-279"> @Override</span>
-<span class="source-line-no">280</span><span id="line-280"> protected
Object getPropertyInternal(final String key) {</span>
-<span class="source-line-no">281</span><span id="line-281"> return
configList.stream().filter(config ->
config.containsKey(key)).findFirst().map(config ->
config.getProperty(key)).orElse(null);</span>
-<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"> @Override</span>
-<span class="source-line-no">285</span><span id="line-285"> protected
Iterator<String> getKeysInternal() {</span>
-<span class="source-line-no">286</span><span id="line-286"> final
Set<String> keys = new LinkedHashSet<>();</span>
-<span class="source-line-no">287</span><span id="line-287">
configList.forEach(config ->
config.getKeys().forEachRemaining(keys::add));</span>
-<span class="source-line-no">288</span><span id="line-288"> return
keys.iterator();</span>
-<span class="source-line-no">289</span><span id="line-289"> }</span>
-<span class="source-line-no">290</span><span id="line-290"></span>
-<span class="source-line-no">291</span><span id="line-291"> @Override</span>
-<span class="source-line-no">292</span><span id="line-292"> protected
Iterator<String> getKeysInternal(final String key) {</span>
-<span class="source-line-no">293</span><span id="line-293"> final
Set<String> keys = new LinkedHashSet<>();</span>
-<span class="source-line-no">294</span><span id="line-294">
configList.forEach(config ->
config.getKeys(key).forEachRemaining(keys::add));</span>
-<span class="source-line-no">295</span><span id="line-295"> return
keys.iterator();</span>
-<span class="source-line-no">296</span><span id="line-296"> }</span>
-<span class="source-line-no">297</span><span id="line-297"></span>
-<span class="source-line-no">298</span><span id="line-298"> @Override</span>
-<span class="source-line-no">299</span><span id="line-299"> protected
boolean isEmptyInternal() {</span>
-<span class="source-line-no">300</span><span id="line-300"> return
configList.stream().allMatch(Configuration::isEmpty);</span>
-<span class="source-line-no">301</span><span id="line-301"> }</span>
-<span class="source-line-no">302</span><span id="line-302"></span>
-<span class="source-line-no">303</span><span id="line-303"> @Override</span>
-<span class="source-line-no">304</span><span id="line-304"> protected void
clearPropertyDirect(final String key) {</span>
-<span class="source-line-no">305</span><span id="line-305">
configList.forEach(config -> config.clearProperty(key));</span>
-<span class="source-line-no">306</span><span id="line-306"> }</span>
-<span class="source-line-no">307</span><span id="line-307"></span>
-<span class="source-line-no">308</span><span id="line-308"> @Override</span>
-<span class="source-line-no">309</span><span id="line-309"> protected
boolean containsKeyInternal(final String key) {</span>
-<span class="source-line-no">310</span><span id="line-310"> return
configList.stream().anyMatch(config -> config.containsKey(key));</span>
-<span class="source-line-no">311</span><span id="line-311"> }</span>
-<span class="source-line-no">312</span><span id="line-312"></span>
-<span class="source-line-no">313</span><span id="line-313"> @Override</span>
-<span class="source-line-no">314</span><span id="line-314"> public
List<Object> getList(final String key, final List<?> defaultValue)
{</span>
-<span class="source-line-no">315</span><span id="line-315"> final
List<Object> list = new ArrayList<>();</span>
-<span class="source-line-no">316</span><span id="line-316"></span>
-<span class="source-line-no">317</span><span id="line-317"> // add all
elements from the first configuration containing the requested key</span>
-<span class="source-line-no">318</span><span id="line-318"> final
Iterator<Configuration> it = configList.iterator();</span>
-<span class="source-line-no">319</span><span id="line-319"> while
(it.hasNext() && list.isEmpty()) {</span>
-<span class="source-line-no">320</span><span id="line-320"> final
Configuration config = it.next();</span>
-<span class="source-line-no">321</span><span id="line-321"> if
(config != inMemoryConfiguration && config.containsKey(key)) {</span>
-<span class="source-line-no">322</span><span id="line-322">
appendListProperty(list, config, key);</span>
-<span class="source-line-no">323</span><span id="line-323"> }</span>
-<span class="source-line-no">324</span><span id="line-324"> }</span>
-<span class="source-line-no">325</span><span id="line-325"></span>
-<span class="source-line-no">326</span><span id="line-326"> // add all
elements from the in memory configuration</span>
-<span class="source-line-no">327</span><span id="line-327">
appendListProperty(list, inMemoryConfiguration, key);</span>
-<span class="source-line-no">328</span><span id="line-328"></span>
-<span class="source-line-no">329</span><span id="line-329"> if
(list.isEmpty()) {</span>
-<span class="source-line-no">330</span><span id="line-330"> // This
is okay because we just return this list to the caller</span>
-<span class="source-line-no">331</span><span id="line-331">
@SuppressWarnings("unchecked")</span>
-<span class="source-line-no">332</span><span id="line-332"> final
List<Object> resultList = (List<Object>) defaultValue;</span>
-<span class="source-line-no">333</span><span id="line-333"> return
resultList;</span>
-<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"> final
ListIterator<Object> lit = list.listIterator();</span>
-<span class="source-line-no">337</span><span id="line-337"> while
(lit.hasNext()) {</span>
-<span class="source-line-no">338</span><span id="line-338">
lit.set(interpolate(lit.next()));</span>
-<span class="source-line-no">339</span><span id="line-339"> }</span>
-<span class="source-line-no">340</span><span id="line-340"></span>
-<span class="source-line-no">341</span><span id="line-341"> return
list;</span>
-<span class="source-line-no">342</span><span id="line-342"> }</span>
-<span class="source-line-no">343</span><span id="line-343"></span>
-<span class="source-line-no">344</span><span id="line-344"> @Override</span>
-<span class="source-line-no">345</span><span id="line-345"> public String[]
getStringArray(final String key) {</span>
-<span class="source-line-no">346</span><span id="line-346"> final
List<Object> list = getList(key);</span>
-<span class="source-line-no">347</span><span id="line-347"></span>
-<span class="source-line-no">348</span><span id="line-348"> //
transform property values into strings</span>
-<span class="source-line-no">349</span><span id="line-349"> final
String[] tokens = new String[list.size()];</span>
-<span class="source-line-no">350</span><span id="line-350"></span>
-<span class="source-line-no">351</span><span id="line-351"> for (int i
= 0; i < tokens.length; i++) {</span>
-<span class="source-line-no">352</span><span id="line-352">
tokens[i] = String.valueOf(list.get(i));</span>
-<span class="source-line-no">353</span><span id="line-353"> }</span>
-<span class="source-line-no">354</span><span id="line-354"></span>
-<span class="source-line-no">355</span><span id="line-355"> return
tokens;</span>
-<span class="source-line-no">356</span><span id="line-356"> }</span>
-<span class="source-line-no">357</span><span id="line-357"></span>
-<span class="source-line-no">358</span><span id="line-358"> /**</span>
-<span class="source-line-no">359</span><span id="line-359"> * Gets the
configuration at the specified index.</span>
-<span class="source-line-no">360</span><span id="line-360"> *</span>
-<span class="source-line-no">361</span><span id="line-361"> * @param index
The index of the configuration to retrieve</span>
-<span class="source-line-no">362</span><span id="line-362"> * @return the
configuration at this index</span>
-<span class="source-line-no">363</span><span id="line-363"> */</span>
-<span class="source-line-no">364</span><span id="line-364"> public
Configuration getConfiguration(final int index) {</span>
-<span class="source-line-no">365</span><span id="line-365">
beginRead(false);</span>
-<span class="source-line-no">366</span><span id="line-366"> try {</span>
-<span class="source-line-no">367</span><span id="line-367"> return
configList.get(index);</span>
-<span class="source-line-no">368</span><span id="line-368"> } finally
{</span>
-<span class="source-line-no">369</span><span id="line-369">
endRead();</span>
-<span class="source-line-no">370</span><span id="line-370"> }</span>
-<span class="source-line-no">371</span><span id="line-371"> }</span>
-<span class="source-line-no">372</span><span id="line-372"></span>
-<span class="source-line-no">373</span><span id="line-373"> /**</span>
-<span class="source-line-no">374</span><span id="line-374"> * Gets the
&quot;in memory configuration&quot;. In this configuration changes are
stored.</span>
-<span class="source-line-no">375</span><span id="line-375"> *</span>
-<span class="source-line-no">376</span><span id="line-376"> * @return the
in memory configuration</span>
-<span class="source-line-no">377</span><span id="line-377"> */</span>
-<span class="source-line-no">378</span><span id="line-378"> public
Configuration getInMemoryConfiguration() {</span>
-<span class="source-line-no">379</span><span id="line-379">
beginRead(false);</span>
-<span class="source-line-no">380</span><span id="line-380"> try {</span>
-<span class="source-line-no">381</span><span id="line-381"> return
inMemoryConfiguration;</span>
-<span class="source-line-no">382</span><span id="line-382"> } finally
{</span>
-<span class="source-line-no">383</span><span id="line-383">
endRead();</span>
-<span class="source-line-no">384</span><span id="line-384"> }</span>
-<span class="source-line-no">385</span><span id="line-385"> }</span>
-<span class="source-line-no">386</span><span id="line-386"></span>
-<span class="source-line-no">387</span><span id="line-387"> /**</span>
-<span class="source-line-no">388</span><span id="line-388"> * Returns a
copy of this object. This implementation will create a deep clone, i.e. all
configurations contained in</span>
-<span class="source-line-no">389</span><span id="line-389"> * this
composite will also be cloned. This only works if all contained configurations
support cloning; otherwise a</span>
-<span class="source-line-no">390</span><span id="line-390"> * runtime
exception will be thrown. Registered event handlers won't get cloned.</span>
-<span class="source-line-no">391</span><span id="line-391"> *</span>
-<span class="source-line-no">392</span><span id="line-392"> * @return the
copy</span>
-<span class="source-line-no">393</span><span id="line-393"> * @since
1.3</span>
-<span class="source-line-no">394</span><span id="line-394"> */</span>
-<span class="source-line-no">395</span><span id="line-395"> @Override</span>
-<span class="source-line-no">396</span><span id="line-396"> public Object
clone() {</span>
-<span class="source-line-no">397</span><span id="line-397"> try {</span>
-<span class="source-line-no">398</span><span id="line-398"> final
CompositeConfiguration copy = (CompositeConfiguration) super.clone();</span>
-<span class="source-line-no">399</span><span id="line-399">
copy.configList = new LinkedList<>();</span>
-<span class="source-line-no">400</span><span id="line-400">
copy.inMemoryConfiguration =
ConfigurationUtils.cloneConfiguration(getInMemoryConfiguration());</span>
-<span class="source-line-no">401</span><span id="line-401">
copy.configList.add(copy.inMemoryConfiguration);</span>
-<span class="source-line-no">402</span><span id="line-402"></span>
-<span class="source-line-no">403</span><span id="line-403">
configList.forEach(config -> {</span>
-<span class="source-line-no">404</span><span id="line-404"> if
(config != getInMemoryConfiguration()) {</span>
-<span class="source-line-no">405</span><span id="line-405">
copy.addConfiguration(ConfigurationUtils.cloneConfiguration(config));</span>
-<span class="source-line-no">406</span><span id="line-406">
}</span>
-<span class="source-line-no">407</span><span id="line-407">
});</span>
-<span class="source-line-no">408</span><span id="line-408"></span>
-<span class="source-line-no">409</span><span id="line-409">
copy.cloneInterpolator(this);</span>
-<span class="source-line-no">410</span><span id="line-410"> return
copy;</span>
-<span class="source-line-no">411</span><span id="line-411"> } catch
(final CloneNotSupportedException cnex) {</span>
-<span class="source-line-no">412</span><span id="line-412"> //
cannot happen</span>
-<span class="source-line-no">413</span><span id="line-413"> throw
new ConfigurationRuntimeException(cnex);</span>
-<span class="source-line-no">414</span><span id="line-414"> }</span>
-<span class="source-line-no">415</span><span id="line-415"> }</span>
-<span class="source-line-no">416</span><span id="line-416"></span>
-<span class="source-line-no">417</span><span id="line-417"> /**</span>
-<span class="source-line-no">418</span><span id="line-418"> *
{@inheritDoc} This implementation ensures that the in memory configuration is
correctly initialized.</span>
-<span class="source-line-no">419</span><span id="line-419"> */</span>
-<span class="source-line-no">420</span><span id="line-420"> @Override</span>
-<span class="source-line-no">421</span><span id="line-421"> public void
setListDelimiterHandler(final ListDelimiterHandler listDelimiterHandler)
{</span>
-<span class="source-line-no">422</span><span id="line-422"> if
(inMemoryConfiguration instanceof AbstractConfiguration) {</span>
-<span class="source-line-no">423</span><span id="line-423">
((AbstractConfiguration)
inMemoryConfiguration).setListDelimiterHandler(listDelimiterHandler);</span>
-<span class="source-line-no">424</span><span id="line-424"> }</span>
-<span class="source-line-no">425</span><span id="line-425">
super.setListDelimiterHandler(listDelimiterHandler);</span>
-<span class="source-line-no">426</span><span id="line-426"> }</span>
-<span class="source-line-no">427</span><span id="line-427"></span>
-<span class="source-line-no">428</span><span id="line-428"> /**</span>
-<span class="source-line-no">429</span><span id="line-429"> * Gets the
configuration source, in which the specified key is defined. This method will
iterate over all existing</span>
-<span class="source-line-no">430</span><span id="line-430"> * child
configurations and check whether they contain the specified key. The following
constellations are possible:</span>
-<span class="source-line-no">431</span><span id="line-431"> *
<ul></span>
-<span class="source-line-no">432</span><span id="line-432"> * <li>If
exactly one child configuration contains the key, this configuration is
returned as the source configuration.</span>
-<span class="source-line-no">433</span><span id="line-433"> * This may be
the <em>in memory configuration</em> (this has to be explicitly
checked by the calling application).</li></span>
-<span class="source-line-no">434</span><span id="line-434"> * <li>If
none of the child configurations contain the key, <b>null</b> is
returned.</li></span>
-<span class="source-line-no">435</span><span id="line-435"> * <li>If
the key is contained in multiple child configurations or if the key is
<b>null</b>, a</span>
-<span class="source-line-no">436</span><span id="line-436"> * {@code
IllegalArgumentException} is thrown. In this case the source configuration
cannot be determined.</li></span>
-<span class="source-line-no">437</span><span id="line-437"> *
</ul></span>
-<span class="source-line-no">438</span><span id="line-438"> *</span>
-<span class="source-line-no">439</span><span id="line-439"> * @param key
the key to be checked</span>
-<span class="source-line-no">440</span><span id="line-440"> * @return the
source configuration of this key</span>
-<span class="source-line-no">441</span><span id="line-441"> * @throws
IllegalArgumentException if the source configuration cannot be determined</span>
-<span class="source-line-no">442</span><span id="line-442"> * @since
1.5</span>
-<span class="source-line-no">443</span><span id="line-443"> */</span>
-<span class="source-line-no">444</span><span id="line-444"> public
Configuration getSource(final String key) {</span>
-<span class="source-line-no">445</span><span id="line-445"> if (key ==
null) {</span>
-<span class="source-line-no">446</span><span id="line-446"> throw
new IllegalArgumentException("Key must not be null!");</span>
-<span class="source-line-no">447</span><span id="line-447"> }</span>
-<span class="source-line-no">448</span><span id="line-448"></span>
-<span class="source-line-no">449</span><span id="line-449">
Configuration source = null;</span>
-<span class="source-line-no">450</span><span id="line-450"> for (final
Configuration conf : configList) {</span>
-<span class="source-line-no">451</span><span id="line-451"> if
(conf.containsKey(key)) {</span>
-<span class="source-line-no">452</span><span id="line-452"> if
(source != null) {</span>
-<span class="source-line-no">453</span><span id="line-453">
throw new IllegalArgumentException("The key " + key + " is defined by multiple
sources!");</span>
-<span class="source-line-no">454</span><span id="line-454">
}</span>
-<span class="source-line-no">455</span><span id="line-455">
source = conf;</span>
-<span class="source-line-no">456</span><span id="line-456"> }</span>
-<span class="source-line-no">457</span><span id="line-457"> }</span>
-<span class="source-line-no">458</span><span id="line-458"></span>
-<span class="source-line-no">459</span><span id="line-459"> return
source;</span>
-<span class="source-line-no">460</span><span id="line-460"> }</span>
-<span class="source-line-no">461</span><span id="line-461"></span>
-<span class="source-line-no">462</span><span id="line-462"> /**</span>
-<span class="source-line-no">463</span><span id="line-463"> * Replaces the
current in-memory configuration by the given one.</span>
-<span class="source-line-no">464</span><span id="line-464"> *</span>
-<span class="source-line-no">465</span><span id="line-465"> * @param
config the new in-memory configuration</span>
-<span class="source-line-no">466</span><span id="line-466"> */</span>
-<span class="source-line-no">467</span><span id="line-467"> private void
replaceInMemoryConfiguration(final Configuration config) {</span>
-<span class="source-line-no">468</span><span id="line-468"> if
(!inMemoryConfigIsChild) {</span>
-<span class="source-line-no">469</span><span id="line-469"> //
remove current in-memory configuration</span>
-<span class="source-line-no">470</span><span id="line-470">
configList.remove(inMemoryConfiguration);</span>
-<span class="source-line-no">471</span><span id="line-471"> }</span>
-<span class="source-line-no">472</span><span id="line-472">
inMemoryConfiguration = config;</span>
-<span class="source-line-no">473</span><span id="line-473"> }</span>
-<span class="source-line-no">474</span><span id="line-474"></span>
-<span class="source-line-no">475</span><span id="line-475"> /**</span>
-<span class="source-line-no">476</span><span id="line-476"> * Adds the
value of a property to the given list. This method is used by {@code getList()}
for gathering property</span>
-<span class="source-line-no">477</span><span id="line-477"> * values from
the child configurations.</span>
-<span class="source-line-no">478</span><span id="line-478"> *</span>
-<span class="source-line-no">479</span><span id="line-479"> * @param dest
the list for collecting the data</span>
-<span class="source-line-no">480</span><span id="line-480"> * @param
config the configuration to query</span>
-<span class="source-line-no">481</span><span id="line-481"> * @param key
the key of the property</span>
-<span class="source-line-no">482</span><span id="line-482"> */</span>
-<span class="source-line-no">483</span><span id="line-483"> private void
appendListProperty(final List<Object> dest, final Configuration config,
final String key) {</span>
-<span class="source-line-no">484</span><span id="line-484"> final
Object value = interpolate(config.getProperty(key));</span>
-<span class="source-line-no">485</span><span id="line-485"> if (value
!= null) {</span>
-<span class="source-line-no">486</span><span id="line-486"> if
(value instanceof Collection) {</span>
-<span class="source-line-no">487</span><span id="line-487">
final Collection<?> col = (Collection<?>) value;</span>
-<span class="source-line-no">488</span><span id="line-488">
dest.addAll(col);</span>
-<span class="source-line-no">489</span><span id="line-489"> } else
{</span>
-<span class="source-line-no">490</span><span id="line-490">
dest.add(value);</span>
-<span class="source-line-no">491</span><span id="line-491"> }</span>
-<span class="source-line-no">492</span><span id="line-492"> }</span>
-<span class="source-line-no">493</span><span id="line-493"> }</span>
-<span class="source-line-no">494</span><span id="line-494">}</span>
+<span class="source-line-no">063</span><span id="line-63"></span>
+<span class="source-line-no">064</span><span id="line-64"> /** List holding
all the configuration */</span>
+<span class="source-line-no">065</span><span id="line-65"> private
List<Configuration> configList = new LinkedList<>();</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"> * Configuration
that holds in memory stuff. Inserted as first so any setProperty() override
anything else added.</span>
+<span class="source-line-no">069</span><span id="line-69"> */</span>
+<span class="source-line-no">070</span><span id="line-70"> private
Configuration inMemoryConfiguration;</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"> * Stores a flag
whether the current in-memory configuration is also a child
configuration.</span>
+<span class="source-line-no">074</span><span id="line-74"> */</span>
+<span class="source-line-no">075</span><span id="line-75"> private boolean
inMemoryConfigIsChild;</span>
+<span class="source-line-no">076</span><span id="line-76"></span>
+<span class="source-line-no">077</span><span id="line-77"> /**</span>
+<span class="source-line-no">078</span><span id="line-78"> * Creates an
empty CompositeConfiguration object which can then be added some other
Configuration files</span>
+<span class="source-line-no">079</span><span id="line-79"> */</span>
+<span class="source-line-no">080</span><span id="line-80"> public
CompositeConfiguration() {</span>
+<span class="source-line-no">081</span><span id="line-81">
clear();</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"> /**</span>
+<span class="source-line-no">085</span><span id="line-85"> * Creates a
CompositeConfiguration object with a specified <em>in-memory
configuration</em>. This configuration will</span>
+<span class="source-line-no">086</span><span id="line-86"> * store any
changes made to the {@code CompositeConfiguration}. Note: Use this constructor
if you want to set a special</span>
+<span class="source-line-no">087</span><span id="line-87"> * type of
in-memory configuration. If you have a configuration which should act as both a
child configuration and as</span>
+<span class="source-line-no">088</span><span id="line-88"> * in-memory
configuration, use {@link #addConfiguration(Configuration, boolean)} with a
value of <b>true</b> instead.</span>
+<span class="source-line-no">089</span><span id="line-89"> *</span>
+<span class="source-line-no">090</span><span id="line-90"> * @param
inMemoryConfiguration the in memory configuration to use</span>
+<span class="source-line-no">091</span><span id="line-91"> */</span>
+<span class="source-line-no">092</span><span id="line-92"> public
CompositeConfiguration(final Configuration inMemoryConfiguration) {</span>
+<span class="source-line-no">093</span><span id="line-93">
this.configList.clear();</span>
+<span class="source-line-no">094</span><span id="line-94">
this.inMemoryConfiguration = inMemoryConfiguration;</span>
+<span class="source-line-no">095</span><span id="line-95">
this.configList.add(inMemoryConfiguration);</span>
+<span class="source-line-no">096</span><span id="line-96"> }</span>
+<span class="source-line-no">097</span><span id="line-97"></span>
+<span class="source-line-no">098</span><span id="line-98"> /**</span>
+<span class="source-line-no">099</span><span id="line-99"> * Create a
CompositeConfiguration with an empty in memory configuration and adds the
collection of configurations</span>
+<span class="source-line-no">100</span><span id="line-100"> *
specified.</span>
+<span class="source-line-no">101</span><span id="line-101"> *</span>
+<span class="source-line-no">102</span><span id="line-102"> * @param
configurations the collection of configurations to add</span>
+<span class="source-line-no">103</span><span id="line-103"> */</span>
+<span class="source-line-no">104</span><span id="line-104"> public
CompositeConfiguration(final Collection<? extends Configuration>
configurations) {</span>
+<span class="source-line-no">105</span><span id="line-105"> this(new
BaseConfiguration(), configurations);</span>
+<span class="source-line-no">106</span><span id="line-106"> }</span>
+<span class="source-line-no">107</span><span id="line-107"></span>
+<span class="source-line-no">108</span><span id="line-108"> /**</span>
+<span class="source-line-no">109</span><span id="line-109"> * Creates a
CompositeConfiguration with a specified <em>in-memory
configuration</em>, and then adds the given</span>
+<span class="source-line-no">110</span><span id="line-110"> * collection
of configurations.</span>
+<span class="source-line-no">111</span><span id="line-111"> *</span>
+<span class="source-line-no">112</span><span id="line-112"> * @param
inMemoryConfiguration the in memory configuration to use</span>
+<span class="source-line-no">113</span><span id="line-113"> * @param
configurations the collection of configurations to add</span>
+<span class="source-line-no">114</span><span id="line-114"> * @see
#CompositeConfiguration(Configuration)</span>
+<span class="source-line-no">115</span><span id="line-115"> */</span>
+<span class="source-line-no">116</span><span id="line-116"> public
CompositeConfiguration(final Configuration inMemoryConfiguration, final
Collection<? extends Configuration> configurations) {</span>
+<span class="source-line-no">117</span><span id="line-117">
this(inMemoryConfiguration);</span>
+<span class="source-line-no">118</span><span id="line-118"> if
(configurations != null) {</span>
+<span class="source-line-no">119</span><span id="line-119">
configurations.forEach(this::addConfiguration);</span>
+<span class="source-line-no">120</span><span id="line-120"> }</span>
+<span class="source-line-no">121</span><span id="line-121"> }</span>
+<span class="source-line-no">122</span><span id="line-122"></span>
+<span class="source-line-no">123</span><span id="line-123"> /**</span>
+<span class="source-line-no">124</span><span id="line-124"> * Add a
configuration.</span>
+<span class="source-line-no">125</span><span id="line-125"> *</span>
+<span class="source-line-no">126</span><span id="line-126"> * @param
config the configuration to add</span>
+<span class="source-line-no">127</span><span id="line-127"> */</span>
+<span class="source-line-no">128</span><span id="line-128"> public void
addConfiguration(final Configuration config) {</span>
+<span class="source-line-no">129</span><span id="line-129">
addConfiguration(config, false);</span>
+<span class="source-line-no">130</span><span id="line-130"> }</span>
+<span class="source-line-no">131</span><span id="line-131"></span>
+<span class="source-line-no">132</span><span id="line-132"> /**</span>
+<span class="source-line-no">133</span><span id="line-133"> * Adds a child
configuration and optionally makes it the <em>in-memory
configuration</em>. This means that all future</span>
+<span class="source-line-no">134</span><span id="line-134"> * property
write operations are executed on this configuration. Note that the current
in-memory configuration is</span>
+<span class="source-line-no">135</span><span id="line-135"> * replaced by
the new one. If it was created automatically or passed to the constructor, it
is removed from the list of</span>
+<span class="source-line-no">136</span><span id="line-136"> * child
configurations! Otherwise, it stays in the list of child configurations at its
current position, but it passes</span>
+<span class="source-line-no">137</span><span id="line-137"> * its role as
in-memory configuration to the new one.</span>
+<span class="source-line-no">138</span><span id="line-138"> *</span>
+<span class="source-line-no">139</span><span id="line-139"> * @param
config the configuration to be added</span>
+<span class="source-line-no">140</span><span id="line-140"> * @param
asInMemory <b>true</b> if this configuration becomes the new
<em>in-memory</em> configuration, <b>false</b></span>
+<span class="source-line-no">141</span><span id="line-141"> *
otherwise</span>
+<span class="source-line-no">142</span><span id="line-142"> * @since
1.8</span>
+<span class="source-line-no">143</span><span id="line-143"> */</span>
+<span class="source-line-no">144</span><span id="line-144"> public void
addConfiguration(final Configuration config, final boolean asInMemory) {</span>
+<span class="source-line-no">145</span><span id="line-145">
beginWrite(false);</span>
+<span class="source-line-no">146</span><span id="line-146"> try {</span>
+<span class="source-line-no">147</span><span id="line-147"> if
(!configList.contains(config)) {</span>
+<span class="source-line-no">148</span><span id="line-148"> if
(asInMemory) {</span>
+<span class="source-line-no">149</span><span id="line-149">
replaceInMemoryConfiguration(config);</span>
+<span class="source-line-no">150</span><span id="line-150">
inMemoryConfigIsChild = true;</span>
+<span class="source-line-no">151</span><span id="line-151">
}</span>
+<span class="source-line-no">152</span><span id="line-152"></span>
+<span class="source-line-no">153</span><span id="line-153"> if
(!inMemoryConfigIsChild) {</span>
+<span class="source-line-no">154</span><span id="line-154">
// As the inMemoryConfiguration contains all manually added</span>
+<span class="source-line-no">155</span><span id="line-155">
// keys, we must make sure that it is always last. "Normal", non</span>
+<span class="source-line-no">156</span><span id="line-156">
// composed configurations add their keys at the end of the</span>
+<span class="source-line-no">157</span><span id="line-157">
// configuration and we want to mimic this behavior.</span>
+<span class="source-line-no">158</span><span id="line-158">
configList.add(configList.indexOf(inMemoryConfiguration), config);</span>
+<span class="source-line-no">159</span><span id="line-159"> }
else {</span>
+<span class="source-line-no">160</span><span id="line-160">
// However, if the in-memory configuration is a regular child,</span>
+<span class="source-line-no">161</span><span id="line-161">
// only the order in which child configurations are added is relevant</span>
+<span class="source-line-no">162</span><span id="line-162">
configList.add(config);</span>
+<span class="source-line-no">163</span><span id="line-163">
}</span>
+<span class="source-line-no">164</span><span id="line-164"></span>
+<span class="source-line-no">165</span><span id="line-165"> if
(config instanceof AbstractConfiguration) {</span>
+<span class="source-line-no">166</span><span id="line-166">
((AbstractConfiguration)
config).setThrowExceptionOnMissing(isThrowExceptionOnMissing());</span>
+<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"> } finally
{</span>
+<span class="source-line-no">170</span><span id="line-170">
endWrite();</span>
+<span class="source-line-no">171</span><span id="line-171"> }</span>
+<span class="source-line-no">172</span><span id="line-172"> }</span>
+<span class="source-line-no">173</span><span id="line-173"></span>
+<span class="source-line-no">174</span><span id="line-174"> /**</span>
+<span class="source-line-no">175</span><span id="line-175"> * Add a
configuration to the start of the list of child configurations.</span>
+<span class="source-line-no">176</span><span id="line-176"> *</span>
+<span class="source-line-no">177</span><span id="line-177"> * @param
config the configuration to add</span>
+<span class="source-line-no">178</span><span id="line-178"> * @since
2.3</span>
+<span class="source-line-no">179</span><span id="line-179"> */</span>
+<span class="source-line-no">180</span><span id="line-180"> public void
addConfigurationFirst(final Configuration config) {</span>
+<span class="source-line-no">181</span><span id="line-181">
addConfigurationFirst(config, false);</span>
+<span class="source-line-no">182</span><span id="line-182"> }</span>
+<span class="source-line-no">183</span><span id="line-183"></span>
+<span class="source-line-no">184</span><span id="line-184"> /**</span>
+<span class="source-line-no">185</span><span id="line-185"> * Adds a child
configuration to the start of the collection and optionally makes it the
<em>in-memory</span>
+<span class="source-line-no">186</span><span id="line-186"> *
configuration</em>. This means that all future property write operations
are executed on this configuration. Note</span>
+<span class="source-line-no">187</span><span id="line-187"> * that the
current in-memory configuration is replaced by the new one. If it was created
automatically or passed to the</span>
+<span class="source-line-no">188</span><span id="line-188"> * constructor,
it is removed from the list of child configurations! Otherwise, it stays in the
list of child</span>
+<span class="source-line-no">189</span><span id="line-189"> *
configurations at its current position, but it passes its role as in-memory
configuration to the new one.</span>
+<span class="source-line-no">190</span><span id="line-190"> *</span>
+<span class="source-line-no">191</span><span id="line-191"> * @param
config the configuration to be added</span>
+<span class="source-line-no">192</span><span id="line-192"> * @param
asInMemory <b>true</b> if this configuration becomes the new
<em>in-memory</em> configuration, <b>false</b></span>
+<span class="source-line-no">193</span><span id="line-193"> *
otherwise</span>
+<span class="source-line-no">194</span><span id="line-194"> * @since
2.3</span>
+<span class="source-line-no">195</span><span id="line-195"> */</span>
+<span class="source-line-no">196</span><span id="line-196"> public void
addConfigurationFirst(final Configuration config, final boolean asInMemory)
{</span>
+<span class="source-line-no">197</span><span id="line-197">
beginWrite(false);</span>
+<span class="source-line-no">198</span><span id="line-198"> try {</span>
+<span class="source-line-no">199</span><span id="line-199"> if
(!configList.contains(config)) {</span>
+<span class="source-line-no">200</span><span id="line-200"> if
(asInMemory) {</span>
+<span class="source-line-no">201</span><span id="line-201">
replaceInMemoryConfiguration(config);</span>
+<span class="source-line-no">202</span><span id="line-202">
inMemoryConfigIsChild = true;</span>
+<span class="source-line-no">203</span><span id="line-203">
}</span>
+<span class="source-line-no">204</span><span id="line-204">
configList.add(0, config);</span>
+<span class="source-line-no">205</span><span id="line-205"></span>
+<span class="source-line-no">206</span><span id="line-206"> if
(config instanceof AbstractConfiguration) {</span>
+<span class="source-line-no">207</span><span id="line-207">
((AbstractConfiguration)
config).setThrowExceptionOnMissing(isThrowExceptionOnMissing());</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"> } finally
{</span>
+<span class="source-line-no">211</span><span id="line-211">
endWrite();</span>
+<span class="source-line-no">212</span><span id="line-212"> }</span>
+<span class="source-line-no">213</span><span id="line-213"> }</span>
+<span class="source-line-no">214</span><span id="line-214"></span>
+<span class="source-line-no">215</span><span id="line-215"> /**</span>
+<span class="source-line-no">216</span><span id="line-216"> * Remove a
configuration. The in memory configuration cannot be removed.</span>
+<span class="source-line-no">217</span><span id="line-217"> *</span>
+<span class="source-line-no">218</span><span id="line-218"> * @param
config The configuration to remove</span>
+<span class="source-line-no">219</span><span id="line-219"> */</span>
+<span class="source-line-no">220</span><span id="line-220"> public void
removeConfiguration(final Configuration config) {</span>
+<span class="source-line-no">221</span><span id="line-221">
beginWrite(false);</span>
+<span class="source-line-no">222</span><span id="line-222"> try {</span>
+<span class="source-line-no">223</span><span id="line-223"> // Make
sure that you can't remove the inMemoryConfiguration from</span>
+<span class="source-line-no">224</span><span id="line-224"> // the
CompositeConfiguration object</span>
+<span class="source-line-no">225</span><span id="line-225"> if
(!config.equals(inMemoryConfiguration)) {</span>
+<span class="source-line-no">226</span><span id="line-226">
configList.remove(config);</span>
+<span class="source-line-no">227</span><span id="line-227"> }</span>
+<span class="source-line-no">228</span><span id="line-228"> } finally
{</span>
+<span class="source-line-no">229</span><span id="line-229">
endWrite();</span>
+<span class="source-line-no">230</span><span id="line-230"> }</span>
+<span class="source-line-no">231</span><span id="line-231"> }</span>
+<span class="source-line-no">232</span><span id="line-232"></span>
+<span class="source-line-no">233</span><span id="line-233"> /**</span>
+<span class="source-line-no">234</span><span id="line-234"> * Gets the
number of configurations.</span>
+<span class="source-line-no">235</span><span id="line-235"> *</span>
+<span class="source-line-no">236</span><span id="line-236"> * @return the
number of configuration</span>
+<span class="source-line-no">237</span><span id="line-237"> */</span>
+<span class="source-line-no">238</span><span id="line-238"> public int
getNumberOfConfigurations() {</span>
+<span class="source-line-no">239</span><span id="line-239">
beginRead(false);</span>
+<span class="source-line-no">240</span><span id="line-240"> try {</span>
+<span class="source-line-no">241</span><span id="line-241"> return
configList.size();</span>
+<span class="source-line-no">242</span><span id="line-242"> } finally
{</span>
+<span class="source-line-no">243</span><span id="line-243">
endRead();</span>
+<span class="source-line-no">244</span><span id="line-244"> }</span>
+<span class="source-line-no">245</span><span id="line-245"> }</span>
+<span class="source-line-no">246</span><span id="line-246"></span>
+<span class="source-line-no">247</span><span id="line-247"> /**</span>
+<span class="source-line-no">248</span><span id="line-248"> * Removes all
child configurations and reinitializes the <em>in-memory
configuration</em>. <strong>Attention:</strong></span>
+<span class="source-line-no">249</span><span id="line-249"> * A new
in-memory configuration is created; the old one is lost.</span>
+<span class="source-line-no">250</span><span id="line-250"> */</span>
+<span class="source-line-no">251</span><span id="line-251"> @Override</span>
+<span class="source-line-no">252</span><span id="line-252"> protected void
clearInternal() {</span>
+<span class="source-line-no">253</span><span id="line-253">
configList.clear();</span>
+<span class="source-line-no">254</span><span id="line-254"> // recreate
the in memory configuration</span>
+<span class="source-line-no">255</span><span id="line-255">
inMemoryConfiguration = new BaseConfiguration();</span>
+<span class="source-line-no">256</span><span id="line-256">
((BaseConfiguration)
inMemoryConfiguration).setThrowExceptionOnMissing(isThrowExceptionOnMissing());</span>
+<span class="source-line-no">257</span><span id="line-257">
((BaseConfiguration)
inMemoryConfiguration).setListDelimiterHandler(getListDelimiterHandler());</span>
+<span class="source-line-no">258</span><span id="line-258">
configList.add(inMemoryConfiguration);</span>
+<span class="source-line-no">259</span><span id="line-259">
inMemoryConfigIsChild = false;</span>
+<span class="source-line-no">260</span><span id="line-260"> }</span>
+<span class="source-line-no">261</span><span id="line-261"></span>
+<span class="source-line-no">262</span><span id="line-262"> /**</span>
+<span class="source-line-no">263</span><span id="line-263"> * Add this
property to the in-memory Configuration.</span>
+<span class="source-line-no">264</span><span id="line-264"> *</span>
+<span class="source-line-no">265</span><span id="line-265"> * @param key
The Key to add the property to.</span>
+<span class="source-line-no">266</span><span id="line-266"> * @param token
The Value to add.</span>
+<span class="source-line-no">267</span><span id="line-267"> */</span>
+<span class="source-line-no">268</span><span id="line-268"> @Override</span>
+<span class="source-line-no">269</span><span id="line-269"> protected void
addPropertyDirect(final String key, final Object token) {</span>
+<span class="source-line-no">270</span><span id="line-270">
inMemoryConfiguration.addProperty(key, token);</span>
+<span class="source-line-no">271</span><span id="line-271"> }</span>
+<span class="source-line-no">272</span><span id="line-272"></span>
+<span class="source-line-no">273</span><span id="line-273"> /**</span>
+<span class="source-line-no">274</span><span id="line-274"> * Read
property from underlying composite</span>
+<span class="source-line-no">275</span><span id="line-275"> *</span>
+<span class="source-line-no">276</span><span id="line-276"> * @param key
key to use for mapping</span>
+<span class="source-line-no">277</span><span id="line-277"> *</span>
+<span class="source-line-no">278</span><span id="line-278"> * @return
object associated with the given configuration key.</span>
+<span class="source-line-no">279</span><span id="line-279"> */</span>
+<span class="source-line-no">280</span><span id="line-280"> @Override</span>
+<span class="source-line-no">281</span><span id="line-281"> protected
Object getPropertyInternal(final String key) {</span>
+<span class="source-line-no">282</span><span id="line-282"> return
configList.stream().filter(config ->
config.containsKey(key)).findFirst().map(config ->
config.getProperty(key)).orElse(null);</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"> @Override</span>
+<span class="source-line-no">286</span><span id="line-286"> protected
Iterator<String> getKeysInternal() {</span>
+<span class="source-line-no">287</span><span id="line-287"> final
Set<String> keys = new LinkedHashSet<>();</span>
+<span class="source-line-no">288</span><span id="line-288">
configList.forEach(config ->
config.getKeys().forEachRemaining(keys::add));</span>
+<span class="source-line-no">289</span><span id="line-289"> return
keys.iterator();</span>
+<span class="source-line-no">290</span><span id="line-290"> }</span>
+<span class="source-line-no">291</span><span id="line-291"></span>
+<span class="source-line-no">292</span><span id="line-292"> @Override</span>
+<span class="source-line-no">293</span><span id="line-293"> protected
Iterator<String> getKeysInternal(final String key) {</span>
+<span class="source-line-no">294</span><span id="line-294"> final
Set<String> keys = new LinkedHashSet<>();</span>
+<span class="source-line-no">295</span><span id="line-295">
configList.forEach(config ->
config.getKeys(key).forEachRemaining(keys::add));</span>
+<span class="source-line-no">296</span><span id="line-296"> return
keys.iterator();</span>
+<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"> @Override</span>
+<span class="source-line-no">300</span><span id="line-300"> protected
boolean isEmptyInternal() {</span>
+<span class="source-line-no">301</span><span id="line-301"> return
configList.stream().allMatch(Configuration::isEmpty);</span>
+<span class="source-line-no">302</span><span id="line-302"> }</span>
+<span class="source-line-no">303</span><span id="line-303"></span>
+<span class="source-line-no">304</span><span id="line-304"> @Override</span>
+<span class="source-line-no">305</span><span id="line-305"> protected void
clearPropertyDirect(final String key) {</span>
+<span class="source-line-no">306</span><span id="line-306">
configList.forEach(config -> config.clearProperty(key));</span>
+<span class="source-line-no">307</span><span id="line-307"> }</span>
+<span class="source-line-no">308</span><span id="line-308"></span>
+<span class="source-line-no">309</span><span id="line-309"> @Override</span>
+<span class="source-line-no">310</span><span id="line-310"> protected
boolean containsKeyInternal(final String key) {</span>
+<span class="source-line-no">311</span><span id="line-311"> return
configList.stream().anyMatch(config -> config.containsKey(key));</span>
+<span class="source-line-no">312</span><span id="line-312"> }</span>
+<span class="source-line-no">313</span><span id="line-313"></span>
+<span class="source-line-no">314</span><span id="line-314"> @Override</span>
+<span class="source-line-no">315</span><span id="line-315"> public
List<Object> getList(final String key, final List<?> defaultValue)
{</span>
+<span class="source-line-no">316</span><span id="line-316"> final
List<Object> list = new ArrayList<>();</span>
+<span class="source-line-no">317</span><span id="line-317"></span>
+<span class="source-line-no">318</span><span id="line-318"> // add all
elements from the first configuration containing the requested key</span>
+<span class="source-line-no">319</span><span id="line-319"> final
Iterator<Configuration> it = configList.iterator();</span>
+<span class="source-line-no">320</span><span id="line-320"> while
(it.hasNext() && list.isEmpty()) {</span>
+<span class="source-line-no">321</span><span id="line-321"> final
Configuration config = it.next();</span>
+<span class="source-line-no">322</span><span id="line-322"> if
(config != inMemoryConfiguration && config.containsKey(key)) {</span>
+<span class="source-line-no">323</span><span id="line-323">
appendListProperty(list, config, key);</span>
+<span class="source-line-no">324</span><span id="line-324"> }</span>
+<span class="source-line-no">325</span><span id="line-325"> }</span>
+<span class="source-line-no">326</span><span id="line-326"></span>
+<span class="source-line-no">327</span><span id="line-327"> // add all
elements from the in memory configuration</span>
+<span class="source-line-no">328</span><span id="line-328">
appendListProperty(list, inMemoryConfiguration, key);</span>
+<span class="source-line-no">329</span><span id="line-329"></span>
+<span class="source-line-no">330</span><span id="line-330"> if
(list.isEmpty()) {</span>
+<span class="source-line-no">331</span><span id="line-331"> // This
is okay because we just return this list to the caller</span>
+<span class="source-line-no">332</span><span id="line-332">
@SuppressWarnings("unchecked")</span>
+<span class="source-line-no">333</span><span id="line-333"> final
List<Object> resultList = (List<Object>) defaultValue;</span>
+<span class="source-line-no">334</span><span id="line-334"> return
resultList;</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"> final
ListIterator<Object> lit = list.listIterator();</span>
+<span class="source-line-no">338</span><span id="line-338"> while
(lit.hasNext()) {</span>
+<span class="source-line-no">339</span><span id="line-339">
lit.set(interpolate(lit.next()));</span>
+<span class="source-line-no">340</span><span id="line-340"> }</span>
+<span class="source-line-no">341</span><span id="line-341"></span>
+<span class="source-line-no">342</span><span id="line-342"> return
list;</span>
+<span class="source-line-no">343</span><span id="line-343"> }</span>
+<span class="source-line-no">344</span><span id="line-344"></span>
+<span class="source-line-no">345</span><span id="line-345"> @Override</span>
+<span class="source-line-no">346</span><span id="line-346"> public String[]
getStringArray(final String key) {</span>
+<span class="source-line-no">347</span><span id="line-347"> final
List<Object> list = getList(key);</span>
+<span class="source-line-no">348</span><span id="line-348"></span>
+<span class="source-line-no">349</span><span id="line-349"> //
transform property values into strings</span>
+<span class="source-line-no">350</span><span id="line-350"> final
String[] tokens = new String[list.size()];</span>
+<span class="source-line-no">351</span><span id="line-351"></span>
+<span class="source-line-no">352</span><span id="line-352"> for (int i
= 0; i < tokens.length; i++) {</span>
+<span class="source-line-no">353</span><span id="line-353">
tokens[i] = String.valueOf(list.get(i));</span>
+<span class="source-line-no">354</span><span id="line-354"> }</span>
+<span class="source-line-no">355</span><span id="line-355"></span>
+<span class="source-line-no">356</span><span id="line-356"> return
tokens;</span>
+<span class="source-line-no">357</span><span id="line-357"> }</span>
+<span class="source-line-no">358</span><span id="line-358"></span>
+<span class="source-line-no">359</span><span id="line-359"> /**</span>
+<span class="source-line-no">360</span><span id="line-360"> * Gets the
configuration at the specified index.</span>
+<span class="source-line-no">361</span><span id="line-361"> *</span>
+<span class="source-line-no">362</span><span id="line-362"> * @param index
The index of the configuration to retrieve</span>
+<span class="source-line-no">363</span><span id="line-363"> * @return the
configuration at this index</span>
+<span class="source-line-no">364</span><span id="line-364"> */</span>
+<span class="source-line-no">365</span><span id="line-365"> public
Configuration getConfiguration(final int index) {</span>
+<span class="source-line-no">366</span><span id="line-366">
beginRead(false);</span>
+<span class="source-line-no">367</span><span id="line-367"> try {</span>
+<span class="source-line-no">368</span><span id="line-368"> return
configList.get(index);</span>
+<span class="source-line-no">369</span><span id="line-369"> } finally
{</span>
+<span class="source-line-no">370</span><span id="line-370">
endRead();</span>
+<span class="source-line-no">371</span><span id="line-371"> }</span>
+<span class="source-line-no">372</span><span id="line-372"> }</span>
+<span class="source-line-no">373</span><span id="line-373"></span>
+<span class="source-line-no">374</span><span id="line-374"> /**</span>
+<span class="source-line-no">375</span><span id="line-375"> * Gets the
&quot;in memory configuration&quot;. In this configuration changes are
stored.</span>
+<span class="source-line-no">376</span><span id="line-376"> *</span>
+<span class="source-line-no">377</span><span id="line-377"> * @return the
in memory configuration</span>
+<span class="source-line-no">378</span><span id="line-378"> */</span>
+<span class="source-line-no">379</span><span id="line-379"> public
Configuration getInMemoryConfiguration() {</span>
+<span class="source-line-no">380</span><span id="line-380">
beginRead(false);</span>
+<span class="source-line-no">381</span><span id="line-381"> try {</span>
+<span class="source-line-no">382</span><span id="line-382"> return
inMemoryConfiguration;</span>
+<span class="source-line-no">383</span><span id="line-383"> } finally
{</span>
+<span class="source-line-no">384</span><span id="line-384">
endRead();</span>
+<span class="source-line-no">385</span><span id="line-385"> }</span>
+<span class="source-line-no">386</span><span id="line-386"> }</span>
+<span class="source-line-no">387</span><span id="line-387"></span>
+<span class="source-line-no">388</span><span id="line-388"> /**</span>
+<span class="source-line-no">389</span><span id="line-389"> * Returns a
copy of this object. This implementation will create a deep clone, i.e. all
configurations contained in</span>
+<span class="source-line-no">390</span><span id="line-390"> * this
composite will also be cloned. This only works if all contained configurations
support cloning; otherwise a</span>
+<span class="source-line-no">391</span><span id="line-391"> * runtime
exception will be thrown. Registered event handlers won't get cloned.</span>
+<span class="source-line-no">392</span><span id="line-392"> *</span>
+<span class="source-line-no">393</span><span id="line-393"> * @return the
copy</span>
+<span class="source-line-no">394</span><span id="line-394"> * @since
1.3</span>
+<span class="source-line-no">395</span><span id="line-395"> */</span>
+<span class="source-line-no">396</span><span id="line-396"> @Override</span>
+<span class="source-line-no">397</span><span id="line-397"> public Object
clone() {</span>
+<span class="source-line-no">398</span><span id="line-398"> try {</span>
+<span class="source-line-no">399</span><span id="line-399"> final
CompositeConfiguration copy = (CompositeConfiguration) super.clone();</span>
+<span class="source-line-no">400</span><span id="line-400">
copy.configList = new LinkedList<>();</span>
+<span class="source-line-no">401</span><span id="line-401">
copy.inMemoryConfiguration =
ConfigurationUtils.cloneConfiguration(getInMemoryConfiguration());</span>
+<span class="source-line-no">402</span><span id="line-402">
copy.configList.add(copy.inMemoryConfiguration);</span>
+<span class="source-line-no">403</span><span id="line-403"></span>
+<span class="source-line-no">404</span><span id="line-404">
configList.forEach(config -> {</span>
+<span class="source-line-no">405</span><span id="line-405"> if
(config != getInMemoryConfiguration()) {</span>
+<span class="source-line-no">406</span><span id="line-406">
copy.addConfiguration(ConfigurationUtils.cloneConfiguration(config));</span>
+<span class="source-line-no">407</span><span id="line-407">
}</span>
+<span class="source-line-no">408</span><span id="line-408">
});</span>
+<span class="source-line-no">409</span><span id="line-409"></span>
+<span class="source-line-no">410</span><span id="line-410">
copy.cloneInterpolator(this);</span>
+<span class="source-line-no">411</span><span id="line-411"> return
copy;</span>
+<span class="source-line-no">412</span><span id="line-412"> } catch
(final CloneNotSupportedException cnex) {</span>
+<span class="source-line-no">413</span><span id="line-413"> //
cannot happen</span>
+<span class="source-line-no">414</span><span id="line-414"> throw
new ConfigurationRuntimeException(cnex);</span>
+<span class="source-line-no">415</span><span id="line-415"> }</span>
+<span class="source-line-no">416</span><span id="line-416"> }</span>
+<span class="source-line-no">417</span><span id="line-417"></span>
+<span class="source-line-no">418</span><span id="line-418"> /**</span>
+<span class="source-line-no">419</span><span id="line-419"> *
{@inheritDoc} This implementation ensures that the in memory configuration is
correctly initialized.</span>
+<span class="source-line-no">420</span><span id="line-420"> */</span>
+<span class="source-line-no">421</span><span id="line-421"> @Override</span>
+<span class="source-line-no">422</span><span id="line-422"> public void
setListDelimiterHandler(final ListDelimiterHandler listDelimiterHandler)
{</span>
+<span class="source-line-no">423</span><span id="line-423"> if
(inMemoryConfiguration instanceof AbstractConfiguration) {</span>
+<span class="source-line-no">424</span><span id="line-424">
((AbstractConfiguration)
inMemoryConfiguration).setListDelimiterHandler(listDelimiterHandler);</span>
+<span class="source-line-no">425</span><span id="line-425"> }</span>
+<span class="source-line-no">426</span><span id="line-426">
super.setListDelimiterHandler(listDelimiterHandler);</span>
+<span class="source-line-no">427</span><span id="line-427"> }</span>
+<span class="source-line-no">428</span><span id="line-428"></span>
+<span class="source-line-no">429</span><span id="line-429"> /**</span>
+<span class="source-line-no">430</span><span id="line-430"> * Gets the
configuration source, in which the specified key is defined. This method will
iterate over all existing</span>
+<span class="source-line-no">431</span><span id="line-431"> * child
configurations and check whether they contain the specified key. The following
constellations are possible:</span>
+<span class="source-line-no">432</span><span id="line-432"> *
<ul></span>
+<span class="source-line-no">433</span><span id="line-433"> * <li>If
exactly one child configuration contains the key, this configuration is
returned as the source configuration.</span>
+<span class="source-line-no">434</span><span id="line-434"> * This may be
the <em>in memory configuration</em> (this has to be explicitly
checked by the calling application).</li></span>
+<span class="source-line-no">435</span><span id="line-435"> * <li>If
none of the child configurations contain the key, <b>null</b> is
returned.</li></span>
+<span class="source-line-no">436</span><span id="line-436"> * <li>If
the key is contained in multiple child configurations or if the key is
<b>null</b>, a</span>
+<span class="source-line-no">437</span><span id="line-437"> * {@code
IllegalArgumentException} is thrown. In this case the source configuration
cannot be determined.</li></span>
+<span class="source-line-no">438</span><span id="line-438"> *
</ul></span>
+<span class="source-line-no">439</span><span id="line-439"> *</span>
+<span class="source-line-no">440</span><span id="line-440"> * @param key
the key to be checked</span>
+<span class="source-line-no">441</span><span id="line-441"> * @return the
source configuration of this key</span>
+<span class="source-line-no">442</span><span id="line-442"> * @throws
IllegalArgumentException if the source configuration cannot be determined</span>
+<span class="source-line-no">443</span><span id="line-443"> * @since
1.5</span>
+<span class="source-line-no">444</span><span id="line-444"> */</span>
+<span class="source-line-no">445</span><span id="line-445"> public
Configuration getSource(final String key) {</span>
+<span class="source-line-no">446</span><span id="line-446"> if (key ==
null) {</span>
+<span class="source-line-no">447</span><span id="line-447"> throw
new IllegalArgumentException("Key must not be null!");</span>
+<span class="source-line-no">448</span><span id="line-448"> }</span>
+<span class="source-line-no">449</span><span id="line-449"></span>
+<span class="source-line-no">450</span><span id="line-450">
Configuration source = null;</span>
+<span class="source-line-no">451</span><span id="line-451"> for (final
Configuration conf : configList) {</span>
+<span class="source-line-no">452</span><span id="line-452"> if
(conf.containsKey(key)) {</span>
+<span class="source-line-no">453</span><span id="line-453"> if
(source != null) {</span>
+<span class="source-line-no">454</span><span id="line-454">
throw new IllegalArgumentException("The key " + key + " is defined by multiple
sources!");</span>
+<span class="source-line-no">455</span><span id="line-455">
}</span>
+<span class="source-line-no">456</span><span id="line-456">
source = conf;</span>
+<span class="source-line-no">457</span><span id="line-457"> }</span>
+<span class="source-line-no">458</span><span id="line-458"> }</span>
+<span class="source-line-no">459</span><span id="line-459"></span>
+<span class="source-line-no">460</span><span id="line-460"> return
source;</span>
+<span class="source-line-no">461</span><span id="line-461"> }</span>
+<span class="source-line-no">462</span><span id="line-462"></span>
+<span class="source-line-no">463</span><span id="line-463"> /**</span>
+<span class="source-line-no">464</span><span id="line-464"> * Replaces the
current in-memory configuration by the given one.</span>
+<span class="source-line-no">465</span><span id="line-465"> *</span>
+<span class="source-line-no">466</span><span id="line-466"> * @param
config the new in-memory configuration</span>
+<span class="source-line-no">467</span><span id="line-467"> */</span>
+<span class="source-line-no">468</span><span id="line-468"> private void
replaceInMemoryConfiguration(final Configuration config) {</span>
+<span class="source-line-no">469</span><span id="line-469"> if
(!inMemoryConfigIsChild) {</span>
[... 30 lines stripped ...]
