blob: 0d74903abc81497d8a7f50ec8ba6dc6706a7f206 [file] [log] [blame]
<!DOCTYPE HTML>
<html lang="en">
<head>
<title>Source code</title>
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
</head>
<body>
<main role="main">
<div class="sourceContainer">
<pre><span class="sourceLineNo">001</span><a id="line.1">/*</a>
<span class="sourceLineNo">002</span><a id="line.2"> * Licensed to the Apache Software Foundation (ASF) under one</a>
<span class="sourceLineNo">003</span><a id="line.3"> * or more contributor license agreements. See the NOTICE file</a>
<span class="sourceLineNo">004</span><a id="line.4"> * distributed with this work for additional information</a>
<span class="sourceLineNo">005</span><a id="line.5"> * regarding copyright ownership. The ASF licenses this file</a>
<span class="sourceLineNo">006</span><a id="line.6"> * to you under the Apache License, Version 2.0 (the</a>
<span class="sourceLineNo">007</span><a id="line.7"> * "License"); you may not use this file except in compliance</a>
<span class="sourceLineNo">008</span><a id="line.8"> * with the License. You may obtain a copy of the License at</a>
<span class="sourceLineNo">009</span><a id="line.9"> *</a>
<span class="sourceLineNo">010</span><a id="line.10"> * http://www.apache.org/licenses/LICENSE-2.0</a>
<span class="sourceLineNo">011</span><a id="line.11"> *</a>
<span class="sourceLineNo">012</span><a id="line.12"> * Unless required by applicable law or agreed to in writing,</a>
<span class="sourceLineNo">013</span><a id="line.13"> * software distributed under the License is distributed on an</a>
<span class="sourceLineNo">014</span><a id="line.14"> * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</a>
<span class="sourceLineNo">015</span><a id="line.15"> * KIND, either express or implied. See the License for the</a>
<span class="sourceLineNo">016</span><a id="line.16"> * specific language governing permissions and limitations</a>
<span class="sourceLineNo">017</span><a id="line.17"> * under the License.</a>
<span class="sourceLineNo">018</span><a id="line.18"> */</a>
<span class="sourceLineNo">019</span><a id="line.19">package org.apache.shiro.config;</a>
<span class="sourceLineNo">020</span><a id="line.20"></a>
<span class="sourceLineNo">021</span><a id="line.21">import java.beans.PropertyDescriptor;</a>
<span class="sourceLineNo">022</span><a id="line.22">import java.util.ArrayList;</a>
<span class="sourceLineNo">023</span><a id="line.23">import java.util.Arrays;</a>
<span class="sourceLineNo">024</span><a id="line.24">import java.util.Collection;</a>
<span class="sourceLineNo">025</span><a id="line.25">import java.util.Collections;</a>
<span class="sourceLineNo">026</span><a id="line.26">import java.util.LinkedHashMap;</a>
<span class="sourceLineNo">027</span><a id="line.27">import java.util.LinkedHashSet;</a>
<span class="sourceLineNo">028</span><a id="line.28">import java.util.List;</a>
<span class="sourceLineNo">029</span><a id="line.29">import java.util.Map;</a>
<span class="sourceLineNo">030</span><a id="line.30">import java.util.Set;</a>
<span class="sourceLineNo">031</span><a id="line.31">import org.apache.commons.beanutils.BeanUtilsBean;</a>
<span class="sourceLineNo">032</span><a id="line.32">import org.apache.commons.beanutils.ConvertUtilsBean;</a>
<span class="sourceLineNo">033</span><a id="line.33">import org.apache.commons.beanutils.SuppressPropertiesBeanIntrospector;</a>
<span class="sourceLineNo">034</span><a id="line.34">import org.apache.shiro.codec.Base64;</a>
<span class="sourceLineNo">035</span><a id="line.35">import org.apache.shiro.codec.Hex;</a>
<span class="sourceLineNo">036</span><a id="line.36">import org.apache.shiro.config.event.BeanEvent;</a>
<span class="sourceLineNo">037</span><a id="line.37">import org.apache.shiro.config.event.ConfiguredBeanEvent;</a>
<span class="sourceLineNo">038</span><a id="line.38">import org.apache.shiro.config.event.DestroyedBeanEvent;</a>
<span class="sourceLineNo">039</span><a id="line.39">import org.apache.shiro.config.event.InitializedBeanEvent;</a>
<span class="sourceLineNo">040</span><a id="line.40">import org.apache.shiro.config.event.InstantiatedBeanEvent;</a>
<span class="sourceLineNo">041</span><a id="line.41">import org.apache.shiro.event.EventBus;</a>
<span class="sourceLineNo">042</span><a id="line.42">import org.apache.shiro.event.EventBusAware;</a>
<span class="sourceLineNo">043</span><a id="line.43">import org.apache.shiro.event.Subscribe;</a>
<span class="sourceLineNo">044</span><a id="line.44">import org.apache.shiro.event.support.DefaultEventBus;</a>
<span class="sourceLineNo">045</span><a id="line.45">import org.apache.shiro.util.Assert;</a>
<span class="sourceLineNo">046</span><a id="line.46">import org.apache.shiro.util.ByteSource;</a>
<span class="sourceLineNo">047</span><a id="line.47">import org.apache.shiro.util.ClassUtils;</a>
<span class="sourceLineNo">048</span><a id="line.48">import org.apache.shiro.util.Factory;</a>
<span class="sourceLineNo">049</span><a id="line.49">import org.apache.shiro.util.LifecycleUtils;</a>
<span class="sourceLineNo">050</span><a id="line.50">import org.apache.shiro.util.Nameable;</a>
<span class="sourceLineNo">051</span><a id="line.51">import org.apache.shiro.util.StringUtils;</a>
<span class="sourceLineNo">052</span><a id="line.52">import org.slf4j.Logger;</a>
<span class="sourceLineNo">053</span><a id="line.53">import org.slf4j.LoggerFactory;</a>
<span class="sourceLineNo">054</span><a id="line.54"></a>
<span class="sourceLineNo">055</span><a id="line.55"></a>
<span class="sourceLineNo">056</span><a id="line.56">/**</a>
<span class="sourceLineNo">057</span><a id="line.57"> * Object builder that uses reflection and Apache Commons BeanUtils to build objects given a</a>
<span class="sourceLineNo">058</span><a id="line.58"> * map of "property values". Typically these come from the Shiro INI configuration and are used</a>
<span class="sourceLineNo">059</span><a id="line.59"> * to construct or modify the SecurityManager, its dependencies, and web-based security filters.</a>
<span class="sourceLineNo">060</span><a id="line.60"> * &lt;p/&gt;</a>
<span class="sourceLineNo">061</span><a id="line.61"> * Recognizes {@link Factory} implementations and will call</a>
<span class="sourceLineNo">062</span><a id="line.62"> * {@link org.apache.shiro.util.Factory#getInstance() getInstance} to satisfy any reference to this bean.</a>
<span class="sourceLineNo">063</span><a id="line.63"> *</a>
<span class="sourceLineNo">064</span><a id="line.64"> * @since 0.9</a>
<span class="sourceLineNo">065</span><a id="line.65"> */</a>
<span class="sourceLineNo">066</span><a id="line.66">public class ReflectionBuilder {</a>
<span class="sourceLineNo">067</span><a id="line.67"></a>
<span class="sourceLineNo">068</span><a id="line.68"> //TODO - complete JavaDoc</a>
<span class="sourceLineNo">069</span><a id="line.69"></a>
<span class="sourceLineNo">070</span><a id="line.70"> private static final Logger log = LoggerFactory.getLogger(ReflectionBuilder.class);</a>
<span class="sourceLineNo">071</span><a id="line.71"></a>
<span class="sourceLineNo">072</span><a id="line.72"> private static final String OBJECT_REFERENCE_BEGIN_TOKEN = "$";</a>
<span class="sourceLineNo">073</span><a id="line.73"> private static final String ESCAPED_OBJECT_REFERENCE_BEGIN_TOKEN = "\\$";</a>
<span class="sourceLineNo">074</span><a id="line.74"> private static final String GLOBAL_PROPERTY_PREFIX = "shiro";</a>
<span class="sourceLineNo">075</span><a id="line.75"> private static final char MAP_KEY_VALUE_DELIMITER = ':';</a>
<span class="sourceLineNo">076</span><a id="line.76"> private static final String HEX_BEGIN_TOKEN = "0x";</a>
<span class="sourceLineNo">077</span><a id="line.77"> private static final String NULL_VALUE_TOKEN = "null";</a>
<span class="sourceLineNo">078</span><a id="line.78"> private static final String EMPTY_STRING_VALUE_TOKEN = "\"\"";</a>
<span class="sourceLineNo">079</span><a id="line.79"> private static final char STRING_VALUE_DELIMETER = '"';</a>
<span class="sourceLineNo">080</span><a id="line.80"> private static final char MAP_PROPERTY_BEGIN_TOKEN = '[';</a>
<span class="sourceLineNo">081</span><a id="line.81"> private static final char MAP_PROPERTY_END_TOKEN = ']';</a>
<span class="sourceLineNo">082</span><a id="line.82"></a>
<span class="sourceLineNo">083</span><a id="line.83"> private static final String EVENT_BUS_NAME = "eventBus";</a>
<span class="sourceLineNo">084</span><a id="line.84"></a>
<span class="sourceLineNo">085</span><a id="line.85"> private final Map&lt;String, Object&gt; objects;</a>
<span class="sourceLineNo">086</span><a id="line.86"></a>
<span class="sourceLineNo">087</span><a id="line.87"> /**</a>
<span class="sourceLineNo">088</span><a id="line.88"> * Interpolation allows for ${key} substitution of values.</a>
<span class="sourceLineNo">089</span><a id="line.89"> * @since 1.4</a>
<span class="sourceLineNo">090</span><a id="line.90"> */</a>
<span class="sourceLineNo">091</span><a id="line.91"> private Interpolator interpolator;</a>
<span class="sourceLineNo">092</span><a id="line.92"></a>
<span class="sourceLineNo">093</span><a id="line.93"> /**</a>
<span class="sourceLineNo">094</span><a id="line.94"> * @since 1.3</a>
<span class="sourceLineNo">095</span><a id="line.95"> */</a>
<span class="sourceLineNo">096</span><a id="line.96"> private EventBus eventBus;</a>
<span class="sourceLineNo">097</span><a id="line.97"> /**</a>
<span class="sourceLineNo">098</span><a id="line.98"> * Keeps track of event subscribers that were automatically registered by this ReflectionBuilder during</a>
<span class="sourceLineNo">099</span><a id="line.99"> * object construction. This is used in case a new EventBus is discovered during object graph</a>
<span class="sourceLineNo">100</span><a id="line.100"> * construction: upon discovery of the new EventBus, the existing subscribers will be unregistered from the</a>
<span class="sourceLineNo">101</span><a id="line.101"> * old EventBus and then re-registered with the new EventBus.</a>
<span class="sourceLineNo">102</span><a id="line.102"> *</a>
<span class="sourceLineNo">103</span><a id="line.103"> * @since 1.3</a>
<span class="sourceLineNo">104</span><a id="line.104"> */</a>
<span class="sourceLineNo">105</span><a id="line.105"> private final Map&lt;String,Object&gt; registeredEventSubscribers;</a>
<span class="sourceLineNo">106</span><a id="line.106"></a>
<span class="sourceLineNo">107</span><a id="line.107"> /**</a>
<span class="sourceLineNo">108</span><a id="line.108"> * @since 1.4</a>
<span class="sourceLineNo">109</span><a id="line.109"> */</a>
<span class="sourceLineNo">110</span><a id="line.110"> private final BeanUtilsBean beanUtilsBean;</a>
<span class="sourceLineNo">111</span><a id="line.111"></a>
<span class="sourceLineNo">112</span><a id="line.112"> //@since 1.3</a>
<span class="sourceLineNo">113</span><a id="line.113"> private Map&lt;String,Object&gt; createDefaultObjectMap() {</a>
<span class="sourceLineNo">114</span><a id="line.114"> Map&lt;String,Object&gt; map = new LinkedHashMap&lt;String, Object&gt;();</a>
<span class="sourceLineNo">115</span><a id="line.115"> map.put(EVENT_BUS_NAME, new DefaultEventBus());</a>
<span class="sourceLineNo">116</span><a id="line.116"> return map;</a>
<span class="sourceLineNo">117</span><a id="line.117"> }</a>
<span class="sourceLineNo">118</span><a id="line.118"></a>
<span class="sourceLineNo">119</span><a id="line.119"> public ReflectionBuilder() {</a>
<span class="sourceLineNo">120</span><a id="line.120"> this(null);</a>
<span class="sourceLineNo">121</span><a id="line.121"> }</a>
<span class="sourceLineNo">122</span><a id="line.122"></a>
<span class="sourceLineNo">123</span><a id="line.123"> public ReflectionBuilder(Map&lt;String, ?&gt; defaults) {</a>
<span class="sourceLineNo">124</span><a id="line.124"></a>
<span class="sourceLineNo">125</span><a id="line.125"> // SHIRO-619</a>
<span class="sourceLineNo">126</span><a id="line.126"> // SHIRO-739</a>
<span class="sourceLineNo">127</span><a id="line.127"> beanUtilsBean = new BeanUtilsBean(new ConvertUtilsBean() {</a>
<span class="sourceLineNo">128</span><a id="line.128"> @Override</a>
<span class="sourceLineNo">129</span><a id="line.129"> public Object convert(String value, Class clazz) {</a>
<span class="sourceLineNo">130</span><a id="line.130"> if (clazz.isEnum()){</a>
<span class="sourceLineNo">131</span><a id="line.131"> return Enum.valueOf(clazz, value);</a>
<span class="sourceLineNo">132</span><a id="line.132"> }else{</a>
<span class="sourceLineNo">133</span><a id="line.133"> return super.convert(value, clazz);</a>
<span class="sourceLineNo">134</span><a id="line.134"> }</a>
<span class="sourceLineNo">135</span><a id="line.135"> }</a>
<span class="sourceLineNo">136</span><a id="line.136"> });</a>
<span class="sourceLineNo">137</span><a id="line.137"> beanUtilsBean.getPropertyUtils().addBeanIntrospector(SuppressPropertiesBeanIntrospector.SUPPRESS_CLASS);</a>
<span class="sourceLineNo">138</span><a id="line.138"></a>
<span class="sourceLineNo">139</span><a id="line.139"> this.interpolator = createInterpolator();</a>
<span class="sourceLineNo">140</span><a id="line.140"></a>
<span class="sourceLineNo">141</span><a id="line.141"> this.objects = createDefaultObjectMap();</a>
<span class="sourceLineNo">142</span><a id="line.142"> this.registeredEventSubscribers = new LinkedHashMap&lt;String,Object&gt;();</a>
<span class="sourceLineNo">143</span><a id="line.143"> apply(defaults);</a>
<span class="sourceLineNo">144</span><a id="line.144"> }</a>
<span class="sourceLineNo">145</span><a id="line.145"></a>
<span class="sourceLineNo">146</span><a id="line.146"> private void apply(Map&lt;String, ?&gt; objects) {</a>
<span class="sourceLineNo">147</span><a id="line.147"> if(!isEmpty(objects)) {</a>
<span class="sourceLineNo">148</span><a id="line.148"> this.objects.putAll(objects);</a>
<span class="sourceLineNo">149</span><a id="line.149"> }</a>
<span class="sourceLineNo">150</span><a id="line.150"> EventBus found = findEventBus(this.objects);</a>
<span class="sourceLineNo">151</span><a id="line.151"> Assert.notNull(found, "An " + EventBus.class.getName() + " instance must be present in the object defaults");</a>
<span class="sourceLineNo">152</span><a id="line.152"> enableEvents(found);</a>
<span class="sourceLineNo">153</span><a id="line.153"> }</a>
<span class="sourceLineNo">154</span><a id="line.154"></a>
<span class="sourceLineNo">155</span><a id="line.155"> public Map&lt;String, ?&gt; getObjects() {</a>
<span class="sourceLineNo">156</span><a id="line.156"> return objects;</a>
<span class="sourceLineNo">157</span><a id="line.157"> }</a>
<span class="sourceLineNo">158</span><a id="line.158"></a>
<span class="sourceLineNo">159</span><a id="line.159"> /**</a>
<span class="sourceLineNo">160</span><a id="line.160"> * @param objects</a>
<span class="sourceLineNo">161</span><a id="line.161"> */</a>
<span class="sourceLineNo">162</span><a id="line.162"> public void setObjects(Map&lt;String, ?&gt; objects) {</a>
<span class="sourceLineNo">163</span><a id="line.163"> this.objects.clear();</a>
<span class="sourceLineNo">164</span><a id="line.164"> this.objects.putAll(createDefaultObjectMap());</a>
<span class="sourceLineNo">165</span><a id="line.165"> apply(objects);</a>
<span class="sourceLineNo">166</span><a id="line.166"> }</a>
<span class="sourceLineNo">167</span><a id="line.167"></a>
<span class="sourceLineNo">168</span><a id="line.168"> //@since 1.3</a>
<span class="sourceLineNo">169</span><a id="line.169"> private void enableEvents(EventBus eventBus) {</a>
<span class="sourceLineNo">170</span><a id="line.170"> Assert.notNull(eventBus, "EventBus argument cannot be null.");</a>
<span class="sourceLineNo">171</span><a id="line.171"> //clean up old auto-registered subscribers:</a>
<span class="sourceLineNo">172</span><a id="line.172"> for (Object subscriber : this.registeredEventSubscribers.values()) {</a>
<span class="sourceLineNo">173</span><a id="line.173"> this.eventBus.unregister(subscriber);</a>
<span class="sourceLineNo">174</span><a id="line.174"> }</a>
<span class="sourceLineNo">175</span><a id="line.175"> this.registeredEventSubscribers.clear();</a>
<span class="sourceLineNo">176</span><a id="line.176"></a>
<span class="sourceLineNo">177</span><a id="line.177"> this.eventBus = eventBus;</a>
<span class="sourceLineNo">178</span><a id="line.178"></a>
<span class="sourceLineNo">179</span><a id="line.179"> for(Map.Entry&lt;String,Object&gt; entry : this.objects.entrySet()) {</a>
<span class="sourceLineNo">180</span><a id="line.180"> enableEventsIfNecessary(entry.getValue(), entry.getKey());</a>
<span class="sourceLineNo">181</span><a id="line.181"> }</a>
<span class="sourceLineNo">182</span><a id="line.182"> }</a>
<span class="sourceLineNo">183</span><a id="line.183"></a>
<span class="sourceLineNo">184</span><a id="line.184"> //@since 1.3</a>
<span class="sourceLineNo">185</span><a id="line.185"> private void enableEventsIfNecessary(Object bean, String name) {</a>
<span class="sourceLineNo">186</span><a id="line.186"> boolean applied = applyEventBusIfNecessary(bean);</a>
<span class="sourceLineNo">187</span><a id="line.187"> if (!applied) {</a>
<span class="sourceLineNo">188</span><a id="line.188"> //if the event bus is applied, and the bean wishes to be a subscriber as well (not just a publisher),</a>
<span class="sourceLineNo">189</span><a id="line.189"> // we assume that the implementation registers itself with the event bus, i.e. eventBus.register(this);</a>
<span class="sourceLineNo">190</span><a id="line.190"></a>
<span class="sourceLineNo">191</span><a id="line.191"> //if the event bus isn't applied, only then do we need to check to see if the bean is an event subscriber,</a>
<span class="sourceLineNo">192</span><a id="line.192"> // and if so, register it on the event bus automatically since it has no ability to do so itself:</a>
<span class="sourceLineNo">193</span><a id="line.193"> if (isEventSubscriber(bean, name)) {</a>
<span class="sourceLineNo">194</span><a id="line.194"> //found an event subscriber, so register them with the EventBus:</a>
<span class="sourceLineNo">195</span><a id="line.195"> this.eventBus.register(bean);</a>
<span class="sourceLineNo">196</span><a id="line.196"> this.registeredEventSubscribers.put(name, bean);</a>
<span class="sourceLineNo">197</span><a id="line.197"> }</a>
<span class="sourceLineNo">198</span><a id="line.198"> }</a>
<span class="sourceLineNo">199</span><a id="line.199"> }</a>
<span class="sourceLineNo">200</span><a id="line.200"></a>
<span class="sourceLineNo">201</span><a id="line.201"> //@since 1.3</a>
<span class="sourceLineNo">202</span><a id="line.202"> private boolean isEventSubscriber(Object bean, String name) {</a>
<span class="sourceLineNo">203</span><a id="line.203"> List annotatedMethods = ClassUtils.getAnnotatedMethods(bean.getClass(), Subscribe.class);</a>
<span class="sourceLineNo">204</span><a id="line.204"> return !isEmpty(annotatedMethods);</a>
<span class="sourceLineNo">205</span><a id="line.205"> }</a>
<span class="sourceLineNo">206</span><a id="line.206"></a>
<span class="sourceLineNo">207</span><a id="line.207"> //@since 1.3</a>
<span class="sourceLineNo">208</span><a id="line.208"> protected EventBus findEventBus(Map&lt;String,?&gt; objects) {</a>
<span class="sourceLineNo">209</span><a id="line.209"></a>
<span class="sourceLineNo">210</span><a id="line.210"> if (isEmpty(objects)) {</a>
<span class="sourceLineNo">211</span><a id="line.211"> return null;</a>
<span class="sourceLineNo">212</span><a id="line.212"> }</a>
<span class="sourceLineNo">213</span><a id="line.213"></a>
<span class="sourceLineNo">214</span><a id="line.214"> //prefer a named object first:</a>
<span class="sourceLineNo">215</span><a id="line.215"> Object value = objects.get(EVENT_BUS_NAME);</a>
<span class="sourceLineNo">216</span><a id="line.216"> if (value != null &amp;&amp; value instanceof EventBus) {</a>
<span class="sourceLineNo">217</span><a id="line.217"> return (EventBus)value;</a>
<span class="sourceLineNo">218</span><a id="line.218"> }</a>
<span class="sourceLineNo">219</span><a id="line.219"></a>
<span class="sourceLineNo">220</span><a id="line.220"> //couldn't find a named 'eventBus' EventBus object. Try to find the first typed value we can:</a>
<span class="sourceLineNo">221</span><a id="line.221"> for( Object v : objects.values()) {</a>
<span class="sourceLineNo">222</span><a id="line.222"> if (v instanceof EventBus) {</a>
<span class="sourceLineNo">223</span><a id="line.223"> return (EventBus)v;</a>
<span class="sourceLineNo">224</span><a id="line.224"> }</a>
<span class="sourceLineNo">225</span><a id="line.225"> }</a>
<span class="sourceLineNo">226</span><a id="line.226"></a>
<span class="sourceLineNo">227</span><a id="line.227"> return null;</a>
<span class="sourceLineNo">228</span><a id="line.228"> }</a>
<span class="sourceLineNo">229</span><a id="line.229"></a>
<span class="sourceLineNo">230</span><a id="line.230"> private boolean applyEventBusIfNecessary(Object value) {</a>
<span class="sourceLineNo">231</span><a id="line.231"> if (value instanceof EventBusAware) {</a>
<span class="sourceLineNo">232</span><a id="line.232"> ((EventBusAware)value).setEventBus(this.eventBus);</a>
<span class="sourceLineNo">233</span><a id="line.233"> return true;</a>
<span class="sourceLineNo">234</span><a id="line.234"> }</a>
<span class="sourceLineNo">235</span><a id="line.235"> return false;</a>
<span class="sourceLineNo">236</span><a id="line.236"> }</a>
<span class="sourceLineNo">237</span><a id="line.237"></a>
<span class="sourceLineNo">238</span><a id="line.238"> public Object getBean(String id) {</a>
<span class="sourceLineNo">239</span><a id="line.239"> return objects.get(id);</a>
<span class="sourceLineNo">240</span><a id="line.240"> }</a>
<span class="sourceLineNo">241</span><a id="line.241"></a>
<span class="sourceLineNo">242</span><a id="line.242"> @SuppressWarnings({"unchecked"})</a>
<span class="sourceLineNo">243</span><a id="line.243"> public &lt;T&gt; T getBean(String id, Class&lt;T&gt; requiredType) {</a>
<span class="sourceLineNo">244</span><a id="line.244"> if (requiredType == null) {</a>
<span class="sourceLineNo">245</span><a id="line.245"> throw new NullPointerException("requiredType argument cannot be null.");</a>
<span class="sourceLineNo">246</span><a id="line.246"> }</a>
<span class="sourceLineNo">247</span><a id="line.247"> Object bean = getBean(id);</a>
<span class="sourceLineNo">248</span><a id="line.248"> if (bean == null) {</a>
<span class="sourceLineNo">249</span><a id="line.249"> return null;</a>
<span class="sourceLineNo">250</span><a id="line.250"> }</a>
<span class="sourceLineNo">251</span><a id="line.251"> Assert.state(requiredType.isAssignableFrom(bean.getClass()),</a>
<span class="sourceLineNo">252</span><a id="line.252"> "Bean with id [" + id + "] is not of the required type [" + requiredType.getName() + "].");</a>
<span class="sourceLineNo">253</span><a id="line.253"> return (T) bean;</a>
<span class="sourceLineNo">254</span><a id="line.254"> }</a>
<span class="sourceLineNo">255</span><a id="line.255"></a>
<span class="sourceLineNo">256</span><a id="line.256"> private String parseBeanId(String lhs) {</a>
<span class="sourceLineNo">257</span><a id="line.257"> Assert.notNull(lhs);</a>
<span class="sourceLineNo">258</span><a id="line.258"> if (lhs.indexOf('.') &lt; 0) {</a>
<span class="sourceLineNo">259</span><a id="line.259"> return lhs;</a>
<span class="sourceLineNo">260</span><a id="line.260"> }</a>
<span class="sourceLineNo">261</span><a id="line.261"> String classSuffix = ".class";</a>
<span class="sourceLineNo">262</span><a id="line.262"> int index = lhs.indexOf(classSuffix);</a>
<span class="sourceLineNo">263</span><a id="line.263"> if (index &gt;= 0) {</a>
<span class="sourceLineNo">264</span><a id="line.264"> return lhs.substring(0, index);</a>
<span class="sourceLineNo">265</span><a id="line.265"> }</a>
<span class="sourceLineNo">266</span><a id="line.266"> return null;</a>
<span class="sourceLineNo">267</span><a id="line.267"> }</a>
<span class="sourceLineNo">268</span><a id="line.268"></a>
<span class="sourceLineNo">269</span><a id="line.269"> @SuppressWarnings({"unchecked"})</a>
<span class="sourceLineNo">270</span><a id="line.270"> public Map&lt;String, ?&gt; buildObjects(Map&lt;String, String&gt; kvPairs) {</a>
<span class="sourceLineNo">271</span><a id="line.271"></a>
<span class="sourceLineNo">272</span><a id="line.272"> if (kvPairs != null &amp;&amp; !kvPairs.isEmpty()) {</a>
<span class="sourceLineNo">273</span><a id="line.273"></a>
<span class="sourceLineNo">274</span><a id="line.274"> BeanConfigurationProcessor processor = new BeanConfigurationProcessor();</a>
<span class="sourceLineNo">275</span><a id="line.275"></a>
<span class="sourceLineNo">276</span><a id="line.276"> for (Map.Entry&lt;String, String&gt; entry : kvPairs.entrySet()) {</a>
<span class="sourceLineNo">277</span><a id="line.277"> String lhs = entry.getKey();</a>
<span class="sourceLineNo">278</span><a id="line.278"> String rhs = interpolator.interpolate(entry.getValue());</a>
<span class="sourceLineNo">279</span><a id="line.279"></a>
<span class="sourceLineNo">280</span><a id="line.280"> String beanId = parseBeanId(lhs);</a>
<span class="sourceLineNo">281</span><a id="line.281"> if (beanId != null) { //a beanId could be parsed, so the line is a bean instance definition</a>
<span class="sourceLineNo">282</span><a id="line.282"> processor.add(new InstantiationStatement(beanId, rhs));</a>
<span class="sourceLineNo">283</span><a id="line.283"> } else { //the line must be a property configuration</a>
<span class="sourceLineNo">284</span><a id="line.284"> processor.add(new AssignmentStatement(lhs, rhs));</a>
<span class="sourceLineNo">285</span><a id="line.285"> }</a>
<span class="sourceLineNo">286</span><a id="line.286"> }</a>
<span class="sourceLineNo">287</span><a id="line.287"></a>
<span class="sourceLineNo">288</span><a id="line.288"> processor.execute();</a>
<span class="sourceLineNo">289</span><a id="line.289"> }</a>
<span class="sourceLineNo">290</span><a id="line.290"></a>
<span class="sourceLineNo">291</span><a id="line.291"> //SHIRO-413: init method must be called for constructed objects that are Initializable</a>
<span class="sourceLineNo">292</span><a id="line.292"> LifecycleUtils.init(objects.values());</a>
<span class="sourceLineNo">293</span><a id="line.293"></a>
<span class="sourceLineNo">294</span><a id="line.294"> return objects;</a>
<span class="sourceLineNo">295</span><a id="line.295"> }</a>
<span class="sourceLineNo">296</span><a id="line.296"></a>
<span class="sourceLineNo">297</span><a id="line.297"> public void destroy() {</a>
<span class="sourceLineNo">298</span><a id="line.298"> final Map&lt;String, Object&gt; immutableObjects = Collections.unmodifiableMap(objects);</a>
<span class="sourceLineNo">299</span><a id="line.299"></a>
<span class="sourceLineNo">300</span><a id="line.300"> //destroy objects in the opposite order they were initialized:</a>
<span class="sourceLineNo">301</span><a id="line.301"> List&lt;Map.Entry&lt;String,?&gt;&gt; entries = new ArrayList&lt;Map.Entry&lt;String,?&gt;&gt;(objects.entrySet());</a>
<span class="sourceLineNo">302</span><a id="line.302"> Collections.reverse(entries);</a>
<span class="sourceLineNo">303</span><a id="line.303"></a>
<span class="sourceLineNo">304</span><a id="line.304"> for(Map.Entry&lt;String, ?&gt; entry: entries) {</a>
<span class="sourceLineNo">305</span><a id="line.305"> String id = entry.getKey();</a>
<span class="sourceLineNo">306</span><a id="line.306"> Object bean = entry.getValue();</a>
<span class="sourceLineNo">307</span><a id="line.307"></a>
<span class="sourceLineNo">308</span><a id="line.308"> //don't destroy the eventbus until the end - we need it to still be 'alive' while publishing destroy events:</a>
<span class="sourceLineNo">309</span><a id="line.309"> if (bean != this.eventBus) { //memory equality check (not .equals) on purpose</a>
<span class="sourceLineNo">310</span><a id="line.310"> LifecycleUtils.destroy(bean);</a>
<span class="sourceLineNo">311</span><a id="line.311"> BeanEvent event = new DestroyedBeanEvent(id, bean, immutableObjects);</a>
<span class="sourceLineNo">312</span><a id="line.312"> eventBus.publish(event);</a>
<span class="sourceLineNo">313</span><a id="line.313"> this.eventBus.unregister(bean); //bean is now destroyed - it should not receive any other events</a>
<span class="sourceLineNo">314</span><a id="line.314"> }</a>
<span class="sourceLineNo">315</span><a id="line.315"> }</a>
<span class="sourceLineNo">316</span><a id="line.316"> //only now destroy the event bus:</a>
<span class="sourceLineNo">317</span><a id="line.317"> LifecycleUtils.destroy(this.eventBus);</a>
<span class="sourceLineNo">318</span><a id="line.318"> }</a>
<span class="sourceLineNo">319</span><a id="line.319"></a>
<span class="sourceLineNo">320</span><a id="line.320"> protected void createNewInstance(Map&lt;String, Object&gt; objects, String name, String value) {</a>
<span class="sourceLineNo">321</span><a id="line.321"></a>
<span class="sourceLineNo">322</span><a id="line.322"> Object currentInstance = objects.get(name);</a>
<span class="sourceLineNo">323</span><a id="line.323"> if (currentInstance != null) {</a>
<span class="sourceLineNo">324</span><a id="line.324"> log.info("An instance with name '{}' already exists. " +</a>
<span class="sourceLineNo">325</span><a id="line.325"> "Redefining this object as a new instance of type {}", name, value);</a>
<span class="sourceLineNo">326</span><a id="line.326"> }</a>
<span class="sourceLineNo">327</span><a id="line.327"></a>
<span class="sourceLineNo">328</span><a id="line.328"> Object instance;//name with no property, assume right hand side of equals sign is the class name:</a>
<span class="sourceLineNo">329</span><a id="line.329"> try {</a>
<span class="sourceLineNo">330</span><a id="line.330"> instance = ClassUtils.newInstance(value);</a>
<span class="sourceLineNo">331</span><a id="line.331"> if (instance instanceof Nameable) {</a>
<span class="sourceLineNo">332</span><a id="line.332"> ((Nameable) instance).setName(name);</a>
<span class="sourceLineNo">333</span><a id="line.333"> }</a>
<span class="sourceLineNo">334</span><a id="line.334"> } catch (Exception e) {</a>
<span class="sourceLineNo">335</span><a id="line.335"> String msg = "Unable to instantiate class [" + value + "] for object named '" + name + "'. " +</a>
<span class="sourceLineNo">336</span><a id="line.336"> "Please ensure you've specified the fully qualified class name correctly.";</a>
<span class="sourceLineNo">337</span><a id="line.337"> throw new ConfigurationException(msg, e);</a>
<span class="sourceLineNo">338</span><a id="line.338"> }</a>
<span class="sourceLineNo">339</span><a id="line.339"> objects.put(name, instance);</a>
<span class="sourceLineNo">340</span><a id="line.340"> }</a>
<span class="sourceLineNo">341</span><a id="line.341"></a>
<span class="sourceLineNo">342</span><a id="line.342"> protected void applyProperty(String key, String value, Map objects) {</a>
<span class="sourceLineNo">343</span><a id="line.343"></a>
<span class="sourceLineNo">344</span><a id="line.344"> int index = key.indexOf('.');</a>
<span class="sourceLineNo">345</span><a id="line.345"></a>
<span class="sourceLineNo">346</span><a id="line.346"> if (index &gt;= 0) {</a>
<span class="sourceLineNo">347</span><a id="line.347"> String name = key.substring(0, index);</a>
<span class="sourceLineNo">348</span><a id="line.348"> String property = key.substring(index + 1, key.length());</a>
<span class="sourceLineNo">349</span><a id="line.349"></a>
<span class="sourceLineNo">350</span><a id="line.350"> if (GLOBAL_PROPERTY_PREFIX.equalsIgnoreCase(name)) {</a>
<span class="sourceLineNo">351</span><a id="line.351"> applyGlobalProperty(objects, property, value);</a>
<span class="sourceLineNo">352</span><a id="line.352"> } else {</a>
<span class="sourceLineNo">353</span><a id="line.353"> applySingleProperty(objects, name, property, value);</a>
<span class="sourceLineNo">354</span><a id="line.354"> }</a>
<span class="sourceLineNo">355</span><a id="line.355"></a>
<span class="sourceLineNo">356</span><a id="line.356"> } else {</a>
<span class="sourceLineNo">357</span><a id="line.357"> throw new IllegalArgumentException("All property keys must contain a '.' character. " +</a>
<span class="sourceLineNo">358</span><a id="line.358"> "(e.g. myBean.property = value) These should already be separated out by buildObjects().");</a>
<span class="sourceLineNo">359</span><a id="line.359"> }</a>
<span class="sourceLineNo">360</span><a id="line.360"> }</a>
<span class="sourceLineNo">361</span><a id="line.361"></a>
<span class="sourceLineNo">362</span><a id="line.362"> protected void applyGlobalProperty(Map objects, String property, String value) {</a>
<span class="sourceLineNo">363</span><a id="line.363"> for (Object instance : objects.values()) {</a>
<span class="sourceLineNo">364</span><a id="line.364"> try {</a>
<span class="sourceLineNo">365</span><a id="line.365"> PropertyDescriptor pd = beanUtilsBean.getPropertyUtils().getPropertyDescriptor(instance, property);</a>
<span class="sourceLineNo">366</span><a id="line.366"> if (pd != null) {</a>
<span class="sourceLineNo">367</span><a id="line.367"> applyProperty(instance, property, value);</a>
<span class="sourceLineNo">368</span><a id="line.368"> }</a>
<span class="sourceLineNo">369</span><a id="line.369"> } catch (Exception e) {</a>
<span class="sourceLineNo">370</span><a id="line.370"> String msg = "Error retrieving property descriptor for instance " +</a>
<span class="sourceLineNo">371</span><a id="line.371"> "of type [" + instance.getClass().getName() + "] " +</a>
<span class="sourceLineNo">372</span><a id="line.372"> "while setting property [" + property + "]";</a>
<span class="sourceLineNo">373</span><a id="line.373"> throw new ConfigurationException(msg, e);</a>
<span class="sourceLineNo">374</span><a id="line.374"> }</a>
<span class="sourceLineNo">375</span><a id="line.375"> }</a>
<span class="sourceLineNo">376</span><a id="line.376"> }</a>
<span class="sourceLineNo">377</span><a id="line.377"></a>
<span class="sourceLineNo">378</span><a id="line.378"> protected void applySingleProperty(Map objects, String name, String property, String value) {</a>
<span class="sourceLineNo">379</span><a id="line.379"> Object instance = objects.get(name);</a>
<span class="sourceLineNo">380</span><a id="line.380"> if (property.equals("class")) {</a>
<span class="sourceLineNo">381</span><a id="line.381"> throw new IllegalArgumentException("Property keys should not contain 'class' properties since these " +</a>
<span class="sourceLineNo">382</span><a id="line.382"> "should already be separated out by buildObjects().");</a>
<span class="sourceLineNo">383</span><a id="line.383"></a>
<span class="sourceLineNo">384</span><a id="line.384"> } else if (instance == null) {</a>
<span class="sourceLineNo">385</span><a id="line.385"> String msg = "Configuration error. Specified object [" + name + "] with property [" +</a>
<span class="sourceLineNo">386</span><a id="line.386"> property + "] without first defining that object's class. Please first " +</a>
<span class="sourceLineNo">387</span><a id="line.387"> "specify the class property first, e.g. myObject = fully_qualified_class_name " +</a>
<span class="sourceLineNo">388</span><a id="line.388"> "and then define additional properties.";</a>
<span class="sourceLineNo">389</span><a id="line.389"> throw new IllegalArgumentException(msg);</a>
<span class="sourceLineNo">390</span><a id="line.390"></a>
<span class="sourceLineNo">391</span><a id="line.391"> } else {</a>
<span class="sourceLineNo">392</span><a id="line.392"> applyProperty(instance, property, value);</a>
<span class="sourceLineNo">393</span><a id="line.393"> }</a>
<span class="sourceLineNo">394</span><a id="line.394"> }</a>
<span class="sourceLineNo">395</span><a id="line.395"></a>
<span class="sourceLineNo">396</span><a id="line.396"> protected boolean isReference(String value) {</a>
<span class="sourceLineNo">397</span><a id="line.397"> return value != null &amp;&amp; value.startsWith(OBJECT_REFERENCE_BEGIN_TOKEN);</a>
<span class="sourceLineNo">398</span><a id="line.398"> }</a>
<span class="sourceLineNo">399</span><a id="line.399"></a>
<span class="sourceLineNo">400</span><a id="line.400"> protected String getId(String referenceToken) {</a>
<span class="sourceLineNo">401</span><a id="line.401"> return referenceToken.substring(OBJECT_REFERENCE_BEGIN_TOKEN.length());</a>
<span class="sourceLineNo">402</span><a id="line.402"> }</a>
<span class="sourceLineNo">403</span><a id="line.403"></a>
<span class="sourceLineNo">404</span><a id="line.404"> protected Object getReferencedObject(String id) {</a>
<span class="sourceLineNo">405</span><a id="line.405"> Object o = objects != null &amp;&amp; !objects.isEmpty() ? objects.get(id) : null;</a>
<span class="sourceLineNo">406</span><a id="line.406"> if (o == null) {</a>
<span class="sourceLineNo">407</span><a id="line.407"> String msg = "The object with id [" + id + "] has not yet been defined and therefore cannot be " +</a>
<span class="sourceLineNo">408</span><a id="line.408"> "referenced. Please ensure objects are defined in the order in which they should be " +</a>
<span class="sourceLineNo">409</span><a id="line.409"> "created and made available for future reference.";</a>
<span class="sourceLineNo">410</span><a id="line.410"> throw new UnresolveableReferenceException(msg);</a>
<span class="sourceLineNo">411</span><a id="line.411"> }</a>
<span class="sourceLineNo">412</span><a id="line.412"> return o;</a>
<span class="sourceLineNo">413</span><a id="line.413"> }</a>
<span class="sourceLineNo">414</span><a id="line.414"></a>
<span class="sourceLineNo">415</span><a id="line.415"> protected String unescapeIfNecessary(String value) {</a>
<span class="sourceLineNo">416</span><a id="line.416"> if (value != null &amp;&amp; value.startsWith(ESCAPED_OBJECT_REFERENCE_BEGIN_TOKEN)) {</a>
<span class="sourceLineNo">417</span><a id="line.417"> return value.substring(ESCAPED_OBJECT_REFERENCE_BEGIN_TOKEN.length() - 1);</a>
<span class="sourceLineNo">418</span><a id="line.418"> }</a>
<span class="sourceLineNo">419</span><a id="line.419"> return value;</a>
<span class="sourceLineNo">420</span><a id="line.420"> }</a>
<span class="sourceLineNo">421</span><a id="line.421"></a>
<span class="sourceLineNo">422</span><a id="line.422"> protected Object resolveReference(String reference) {</a>
<span class="sourceLineNo">423</span><a id="line.423"> String id = getId(reference);</a>
<span class="sourceLineNo">424</span><a id="line.424"> log.debug("Encountered object reference '{}'. Looking up object with id '{}'", reference, id);</a>
<span class="sourceLineNo">425</span><a id="line.425"> final Object referencedObject = getReferencedObject(id);</a>
<span class="sourceLineNo">426</span><a id="line.426"> if (referencedObject instanceof Factory) {</a>
<span class="sourceLineNo">427</span><a id="line.427"> return ((Factory) referencedObject).getInstance();</a>
<span class="sourceLineNo">428</span><a id="line.428"> }</a>
<span class="sourceLineNo">429</span><a id="line.429"> return referencedObject;</a>
<span class="sourceLineNo">430</span><a id="line.430"> }</a>
<span class="sourceLineNo">431</span><a id="line.431"></a>
<span class="sourceLineNo">432</span><a id="line.432"> protected boolean isTypedProperty(Object object, String propertyName, Class clazz) {</a>
<span class="sourceLineNo">433</span><a id="line.433"> if (clazz == null) {</a>
<span class="sourceLineNo">434</span><a id="line.434"> throw new NullPointerException("type (class) argument cannot be null.");</a>
<span class="sourceLineNo">435</span><a id="line.435"> }</a>
<span class="sourceLineNo">436</span><a id="line.436"> try {</a>
<span class="sourceLineNo">437</span><a id="line.437"> PropertyDescriptor descriptor = beanUtilsBean.getPropertyUtils().getPropertyDescriptor(object, propertyName);</a>
<span class="sourceLineNo">438</span><a id="line.438"> if (descriptor == null) {</a>
<span class="sourceLineNo">439</span><a id="line.439"> String msg = "Property '" + propertyName + "' does not exist for object of " +</a>
<span class="sourceLineNo">440</span><a id="line.440"> "type " + object.getClass().getName() + ".";</a>
<span class="sourceLineNo">441</span><a id="line.441"> throw new ConfigurationException(msg);</a>
<span class="sourceLineNo">442</span><a id="line.442"> }</a>
<span class="sourceLineNo">443</span><a id="line.443"> Class propertyClazz = descriptor.getPropertyType();</a>
<span class="sourceLineNo">444</span><a id="line.444"> return clazz.isAssignableFrom(propertyClazz);</a>
<span class="sourceLineNo">445</span><a id="line.445"> } catch (ConfigurationException ce) {</a>
<span class="sourceLineNo">446</span><a id="line.446"> //let it propagate:</a>
<span class="sourceLineNo">447</span><a id="line.447"> throw ce;</a>
<span class="sourceLineNo">448</span><a id="line.448"> } catch (Exception e) {</a>
<span class="sourceLineNo">449</span><a id="line.449"> String msg = "Unable to determine if property [" + propertyName + "] represents a " + clazz.getName();</a>
<span class="sourceLineNo">450</span><a id="line.450"> throw new ConfigurationException(msg, e);</a>
<span class="sourceLineNo">451</span><a id="line.451"> }</a>
<span class="sourceLineNo">452</span><a id="line.452"> }</a>
<span class="sourceLineNo">453</span><a id="line.453"></a>
<span class="sourceLineNo">454</span><a id="line.454"> protected Set&lt;?&gt; toSet(String sValue) {</a>
<span class="sourceLineNo">455</span><a id="line.455"> String[] tokens = StringUtils.split(sValue);</a>
<span class="sourceLineNo">456</span><a id="line.456"> if (tokens == null || tokens.length &lt;= 0) {</a>
<span class="sourceLineNo">457</span><a id="line.457"> return null;</a>
<span class="sourceLineNo">458</span><a id="line.458"> }</a>
<span class="sourceLineNo">459</span><a id="line.459"></a>
<span class="sourceLineNo">460</span><a id="line.460"> //SHIRO-423: check to see if the value is a referenced Set already, and if so, return it immediately:</a>
<span class="sourceLineNo">461</span><a id="line.461"> if (tokens.length == 1 &amp;&amp; isReference(tokens[0])) {</a>
<span class="sourceLineNo">462</span><a id="line.462"> Object reference = resolveReference(tokens[0]);</a>
<span class="sourceLineNo">463</span><a id="line.463"> if (reference instanceof Set) {</a>
<span class="sourceLineNo">464</span><a id="line.464"> return (Set)reference;</a>
<span class="sourceLineNo">465</span><a id="line.465"> }</a>
<span class="sourceLineNo">466</span><a id="line.466"> }</a>
<span class="sourceLineNo">467</span><a id="line.467"></a>
<span class="sourceLineNo">468</span><a id="line.468"> Set&lt;String&gt; setTokens = new LinkedHashSet&lt;String&gt;(Arrays.asList(tokens));</a>
<span class="sourceLineNo">469</span><a id="line.469"></a>
<span class="sourceLineNo">470</span><a id="line.470"> //now convert into correct values and/or references:</a>
<span class="sourceLineNo">471</span><a id="line.471"> Set&lt;Object&gt; values = new LinkedHashSet&lt;Object&gt;(setTokens.size());</a>
<span class="sourceLineNo">472</span><a id="line.472"> for (String token : setTokens) {</a>
<span class="sourceLineNo">473</span><a id="line.473"> Object value = resolveValue(token);</a>
<span class="sourceLineNo">474</span><a id="line.474"> values.add(value);</a>
<span class="sourceLineNo">475</span><a id="line.475"> }</a>
<span class="sourceLineNo">476</span><a id="line.476"> return values;</a>
<span class="sourceLineNo">477</span><a id="line.477"> }</a>
<span class="sourceLineNo">478</span><a id="line.478"></a>
<span class="sourceLineNo">479</span><a id="line.479"> protected Map&lt;?, ?&gt; toMap(String sValue) {</a>
<span class="sourceLineNo">480</span><a id="line.480"> String[] tokens = StringUtils.split(sValue, StringUtils.DEFAULT_DELIMITER_CHAR,</a>
<span class="sourceLineNo">481</span><a id="line.481"> StringUtils.DEFAULT_QUOTE_CHAR, StringUtils.DEFAULT_QUOTE_CHAR, true, true);</a>
<span class="sourceLineNo">482</span><a id="line.482"> if (tokens == null || tokens.length &lt;= 0) {</a>
<span class="sourceLineNo">483</span><a id="line.483"> return null;</a>
<span class="sourceLineNo">484</span><a id="line.484"> }</a>
<span class="sourceLineNo">485</span><a id="line.485"></a>
<span class="sourceLineNo">486</span><a id="line.486"> //SHIRO-423: check to see if the value is a referenced Map already, and if so, return it immediately:</a>
<span class="sourceLineNo">487</span><a id="line.487"> if (tokens.length == 1 &amp;&amp; isReference(tokens[0])) {</a>
<span class="sourceLineNo">488</span><a id="line.488"> Object reference = resolveReference(tokens[0]);</a>
<span class="sourceLineNo">489</span><a id="line.489"> if (reference instanceof Map) {</a>
<span class="sourceLineNo">490</span><a id="line.490"> return (Map)reference;</a>
<span class="sourceLineNo">491</span><a id="line.491"> }</a>
<span class="sourceLineNo">492</span><a id="line.492"> }</a>
<span class="sourceLineNo">493</span><a id="line.493"></a>
<span class="sourceLineNo">494</span><a id="line.494"> Map&lt;String, String&gt; mapTokens = new LinkedHashMap&lt;String, String&gt;(tokens.length);</a>
<span class="sourceLineNo">495</span><a id="line.495"> for (String token : tokens) {</a>
<span class="sourceLineNo">496</span><a id="line.496"> String[] kvPair = StringUtils.split(token, MAP_KEY_VALUE_DELIMITER);</a>
<span class="sourceLineNo">497</span><a id="line.497"> if (kvPair == null || kvPair.length != 2) {</a>
<span class="sourceLineNo">498</span><a id="line.498"> String msg = "Map property value [" + sValue + "] contained key-value pair token [" +</a>
<span class="sourceLineNo">499</span><a id="line.499"> token + "] that does not properly split to a single key and pair. This must be the " +</a>
<span class="sourceLineNo">500</span><a id="line.500"> "case for all map entries.";</a>
<span class="sourceLineNo">501</span><a id="line.501"> throw new ConfigurationException(msg);</a>
<span class="sourceLineNo">502</span><a id="line.502"> }</a>
<span class="sourceLineNo">503</span><a id="line.503"> mapTokens.put(kvPair[0], kvPair[1]);</a>
<span class="sourceLineNo">504</span><a id="line.504"> }</a>
<span class="sourceLineNo">505</span><a id="line.505"></a>
<span class="sourceLineNo">506</span><a id="line.506"> //now convert into correct values and/or references:</a>
<span class="sourceLineNo">507</span><a id="line.507"> Map&lt;Object, Object&gt; map = new LinkedHashMap&lt;Object, Object&gt;(mapTokens.size());</a>
<span class="sourceLineNo">508</span><a id="line.508"> for (Map.Entry&lt;String, String&gt; entry : mapTokens.entrySet()) {</a>
<span class="sourceLineNo">509</span><a id="line.509"> Object key = resolveValue(entry.getKey());</a>
<span class="sourceLineNo">510</span><a id="line.510"> Object value = resolveValue(entry.getValue());</a>
<span class="sourceLineNo">511</span><a id="line.511"> map.put(key, value);</a>
<span class="sourceLineNo">512</span><a id="line.512"> }</a>
<span class="sourceLineNo">513</span><a id="line.513"> return map;</a>
<span class="sourceLineNo">514</span><a id="line.514"> }</a>
<span class="sourceLineNo">515</span><a id="line.515"></a>
<span class="sourceLineNo">516</span><a id="line.516"> // @since 1.2.2</a>
<span class="sourceLineNo">517</span><a id="line.517"> protected Collection&lt;?&gt; toCollection(String sValue) {</a>
<span class="sourceLineNo">518</span><a id="line.518"></a>
<span class="sourceLineNo">519</span><a id="line.519"> String[] tokens = StringUtils.split(sValue);</a>
<span class="sourceLineNo">520</span><a id="line.520"> if (tokens == null || tokens.length &lt;= 0) {</a>
<span class="sourceLineNo">521</span><a id="line.521"> return null;</a>
<span class="sourceLineNo">522</span><a id="line.522"> }</a>
<span class="sourceLineNo">523</span><a id="line.523"></a>
<span class="sourceLineNo">524</span><a id="line.524"> //SHIRO-423: check to see if the value is a referenced Collection already, and if so, return it immediately:</a>
<span class="sourceLineNo">525</span><a id="line.525"> if (tokens.length == 1 &amp;&amp; isReference(tokens[0])) {</a>
<span class="sourceLineNo">526</span><a id="line.526"> Object reference = resolveReference(tokens[0]);</a>
<span class="sourceLineNo">527</span><a id="line.527"> if (reference instanceof Collection) {</a>
<span class="sourceLineNo">528</span><a id="line.528"> return (Collection)reference;</a>
<span class="sourceLineNo">529</span><a id="line.529"> }</a>
<span class="sourceLineNo">530</span><a id="line.530"> }</a>
<span class="sourceLineNo">531</span><a id="line.531"></a>
<span class="sourceLineNo">532</span><a id="line.532"> //now convert into correct values and/or references:</a>
<span class="sourceLineNo">533</span><a id="line.533"> List&lt;Object&gt; values = new ArrayList&lt;Object&gt;(tokens.length);</a>
<span class="sourceLineNo">534</span><a id="line.534"> for (String token : tokens) {</a>
<span class="sourceLineNo">535</span><a id="line.535"> Object value = resolveValue(token);</a>
<span class="sourceLineNo">536</span><a id="line.536"> values.add(value);</a>
<span class="sourceLineNo">537</span><a id="line.537"> }</a>
<span class="sourceLineNo">538</span><a id="line.538"> return values;</a>
<span class="sourceLineNo">539</span><a id="line.539"> }</a>
<span class="sourceLineNo">540</span><a id="line.540"></a>
<span class="sourceLineNo">541</span><a id="line.541"> protected List&lt;?&gt; toList(String sValue) {</a>
<span class="sourceLineNo">542</span><a id="line.542"> String[] tokens = StringUtils.split(sValue);</a>
<span class="sourceLineNo">543</span><a id="line.543"> if (tokens == null || tokens.length &lt;= 0) {</a>
<span class="sourceLineNo">544</span><a id="line.544"> return null;</a>
<span class="sourceLineNo">545</span><a id="line.545"> }</a>
<span class="sourceLineNo">546</span><a id="line.546"></a>
<span class="sourceLineNo">547</span><a id="line.547"> //SHIRO-423: check to see if the value is a referenced List already, and if so, return it immediately:</a>
<span class="sourceLineNo">548</span><a id="line.548"> if (tokens.length == 1 &amp;&amp; isReference(tokens[0])) {</a>
<span class="sourceLineNo">549</span><a id="line.549"> Object reference = resolveReference(tokens[0]);</a>
<span class="sourceLineNo">550</span><a id="line.550"> if (reference instanceof List) {</a>
<span class="sourceLineNo">551</span><a id="line.551"> return (List)reference;</a>
<span class="sourceLineNo">552</span><a id="line.552"> }</a>
<span class="sourceLineNo">553</span><a id="line.553"> }</a>
<span class="sourceLineNo">554</span><a id="line.554"></a>
<span class="sourceLineNo">555</span><a id="line.555"> //now convert into correct values and/or references:</a>
<span class="sourceLineNo">556</span><a id="line.556"> List&lt;Object&gt; values = new ArrayList&lt;Object&gt;(tokens.length);</a>
<span class="sourceLineNo">557</span><a id="line.557"> for (String token : tokens) {</a>
<span class="sourceLineNo">558</span><a id="line.558"> Object value = resolveValue(token);</a>
<span class="sourceLineNo">559</span><a id="line.559"> values.add(value);</a>
<span class="sourceLineNo">560</span><a id="line.560"> }</a>
<span class="sourceLineNo">561</span><a id="line.561"> return values;</a>
<span class="sourceLineNo">562</span><a id="line.562"> }</a>
<span class="sourceLineNo">563</span><a id="line.563"></a>
<span class="sourceLineNo">564</span><a id="line.564"> protected byte[] toBytes(String sValue) {</a>
<span class="sourceLineNo">565</span><a id="line.565"> if (sValue == null) {</a>
<span class="sourceLineNo">566</span><a id="line.566"> return null;</a>
<span class="sourceLineNo">567</span><a id="line.567"> }</a>
<span class="sourceLineNo">568</span><a id="line.568"> byte[] bytes;</a>
<span class="sourceLineNo">569</span><a id="line.569"> if (sValue.startsWith(HEX_BEGIN_TOKEN)) {</a>
<span class="sourceLineNo">570</span><a id="line.570"> String hex = sValue.substring(HEX_BEGIN_TOKEN.length());</a>
<span class="sourceLineNo">571</span><a id="line.571"> bytes = Hex.decode(hex);</a>
<span class="sourceLineNo">572</span><a id="line.572"> } else {</a>
<span class="sourceLineNo">573</span><a id="line.573"> //assume base64 encoded:</a>
<span class="sourceLineNo">574</span><a id="line.574"> bytes = Base64.decode(sValue);</a>
<span class="sourceLineNo">575</span><a id="line.575"> }</a>
<span class="sourceLineNo">576</span><a id="line.576"> return bytes;</a>
<span class="sourceLineNo">577</span><a id="line.577"> }</a>
<span class="sourceLineNo">578</span><a id="line.578"></a>
<span class="sourceLineNo">579</span><a id="line.579"> protected Object resolveValue(String stringValue) {</a>
<span class="sourceLineNo">580</span><a id="line.580"> Object value;</a>
<span class="sourceLineNo">581</span><a id="line.581"> if (isReference(stringValue)) {</a>
<span class="sourceLineNo">582</span><a id="line.582"> value = resolveReference(stringValue);</a>
<span class="sourceLineNo">583</span><a id="line.583"> } else {</a>
<span class="sourceLineNo">584</span><a id="line.584"> value = unescapeIfNecessary(stringValue);</a>
<span class="sourceLineNo">585</span><a id="line.585"> }</a>
<span class="sourceLineNo">586</span><a id="line.586"> return value;</a>
<span class="sourceLineNo">587</span><a id="line.587"> }</a>
<span class="sourceLineNo">588</span><a id="line.588"></a>
<span class="sourceLineNo">589</span><a id="line.589"> protected String checkForNullOrEmptyLiteral(String stringValue) {</a>
<span class="sourceLineNo">590</span><a id="line.590"> if (stringValue == null) {</a>
<span class="sourceLineNo">591</span><a id="line.591"> return null;</a>
<span class="sourceLineNo">592</span><a id="line.592"> }</a>
<span class="sourceLineNo">593</span><a id="line.593"> //check if the value is the actual literal string 'null' (expected to be wrapped in quotes):</a>
<span class="sourceLineNo">594</span><a id="line.594"> if (stringValue.equals("\"null\"")) {</a>
<span class="sourceLineNo">595</span><a id="line.595"> return NULL_VALUE_TOKEN;</a>
<span class="sourceLineNo">596</span><a id="line.596"> }</a>
<span class="sourceLineNo">597</span><a id="line.597"> //or the actual literal string of two quotes '""' (expected to be wrapped in quotes):</a>
<span class="sourceLineNo">598</span><a id="line.598"> else if (stringValue.equals("\"\"\"\"")) {</a>
<span class="sourceLineNo">599</span><a id="line.599"> return EMPTY_STRING_VALUE_TOKEN;</a>
<span class="sourceLineNo">600</span><a id="line.600"> } else {</a>
<span class="sourceLineNo">601</span><a id="line.601"> return stringValue;</a>
<span class="sourceLineNo">602</span><a id="line.602"> }</a>
<span class="sourceLineNo">603</span><a id="line.603"> }</a>
<span class="sourceLineNo">604</span><a id="line.604"> </a>
<span class="sourceLineNo">605</span><a id="line.605"> protected void applyProperty(Object object, String propertyPath, Object value) {</a>
<span class="sourceLineNo">606</span><a id="line.606"></a>
<span class="sourceLineNo">607</span><a id="line.607"> int mapBegin = propertyPath.indexOf(MAP_PROPERTY_BEGIN_TOKEN);</a>
<span class="sourceLineNo">608</span><a id="line.608"> int mapEnd = -1;</a>
<span class="sourceLineNo">609</span><a id="line.609"> String mapPropertyPath = null;</a>
<span class="sourceLineNo">610</span><a id="line.610"> String keyString = null;</a>
<span class="sourceLineNo">611</span><a id="line.611"></a>
<span class="sourceLineNo">612</span><a id="line.612"> String remaining = null;</a>
<span class="sourceLineNo">613</span><a id="line.613"> </a>
<span class="sourceLineNo">614</span><a id="line.614"> if (mapBegin &gt;= 0) {</a>
<span class="sourceLineNo">615</span><a id="line.615"> //a map is being referenced in the overall property path. Find just the map's path:</a>
<span class="sourceLineNo">616</span><a id="line.616"> mapPropertyPath = propertyPath.substring(0, mapBegin);</a>
<span class="sourceLineNo">617</span><a id="line.617"> //find the end of the map reference:</a>
<span class="sourceLineNo">618</span><a id="line.618"> mapEnd = propertyPath.indexOf(MAP_PROPERTY_END_TOKEN, mapBegin);</a>
<span class="sourceLineNo">619</span><a id="line.619"> //find the token in between the [ and the ] (the map/array key or index):</a>
<span class="sourceLineNo">620</span><a id="line.620"> keyString = propertyPath.substring(mapBegin+1, mapEnd);</a>
<span class="sourceLineNo">621</span><a id="line.621"></a>
<span class="sourceLineNo">622</span><a id="line.622"> //find out if there is more path reference to follow. If not, we're at a terminal of the OGNL expression</a>
<span class="sourceLineNo">623</span><a id="line.623"> if (propertyPath.length() &gt; (mapEnd+1)) {</a>
<span class="sourceLineNo">624</span><a id="line.624"> remaining = propertyPath.substring(mapEnd+1);</a>
<span class="sourceLineNo">625</span><a id="line.625"> if (remaining.startsWith(".")) {</a>
<span class="sourceLineNo">626</span><a id="line.626"> remaining = StringUtils.clean(remaining.substring(1));</a>
<span class="sourceLineNo">627</span><a id="line.627"> }</a>
<span class="sourceLineNo">628</span><a id="line.628"> }</a>
<span class="sourceLineNo">629</span><a id="line.629"> }</a>
<span class="sourceLineNo">630</span><a id="line.630"> </a>
<span class="sourceLineNo">631</span><a id="line.631"> if (remaining == null) {</a>
<span class="sourceLineNo">632</span><a id="line.632"> //we've terminated the OGNL expression. Check to see if we're assigning a property or a map entry:</a>
<span class="sourceLineNo">633</span><a id="line.633"> if (keyString == null) {</a>
<span class="sourceLineNo">634</span><a id="line.634"> //not a map or array value assignment - assign the property directly:</a>
<span class="sourceLineNo">635</span><a id="line.635"> setProperty(object, propertyPath, value);</a>
<span class="sourceLineNo">636</span><a id="line.636"> } else {</a>
<span class="sourceLineNo">637</span><a id="line.637"> //we're assigning a map or array entry. Check to see which we should call:</a>
<span class="sourceLineNo">638</span><a id="line.638"> if (isTypedProperty(object, mapPropertyPath, Map.class)) {</a>
<span class="sourceLineNo">639</span><a id="line.639"> Map map = (Map)getProperty(object, mapPropertyPath);</a>
<span class="sourceLineNo">640</span><a id="line.640"> Object mapKey = resolveValue(keyString);</a>
<span class="sourceLineNo">641</span><a id="line.641"> //noinspection unchecked</a>
<span class="sourceLineNo">642</span><a id="line.642"> map.put(mapKey, value);</a>
<span class="sourceLineNo">643</span><a id="line.643"> } else {</a>
<span class="sourceLineNo">644</span><a id="line.644"> //must be an array property. Convert the key string to an index:</a>
<span class="sourceLineNo">645</span><a id="line.645"> int index = Integer.valueOf(keyString);</a>
<span class="sourceLineNo">646</span><a id="line.646"> setIndexedProperty(object, mapPropertyPath, index, value);</a>
<span class="sourceLineNo">647</span><a id="line.647"> }</a>
<span class="sourceLineNo">648</span><a id="line.648"> }</a>
<span class="sourceLineNo">649</span><a id="line.649"> } else {</a>
<span class="sourceLineNo">650</span><a id="line.650"> //property is being referenced as part of a nested path. Find the referenced map/array entry and</a>
<span class="sourceLineNo">651</span><a id="line.651"> //recursively call this method with the remaining property path</a>
<span class="sourceLineNo">652</span><a id="line.652"> Object referencedValue = null;</a>
<span class="sourceLineNo">653</span><a id="line.653"> if (isTypedProperty(object, mapPropertyPath, Map.class)) {</a>
<span class="sourceLineNo">654</span><a id="line.654"> Map map = (Map)getProperty(object, mapPropertyPath);</a>
<span class="sourceLineNo">655</span><a id="line.655"> Object mapKey = resolveValue(keyString);</a>
<span class="sourceLineNo">656</span><a id="line.656"> referencedValue = map.get(mapKey);</a>
<span class="sourceLineNo">657</span><a id="line.657"> } else {</a>
<span class="sourceLineNo">658</span><a id="line.658"> //must be an array property:</a>
<span class="sourceLineNo">659</span><a id="line.659"> int index = Integer.valueOf(keyString);</a>
<span class="sourceLineNo">660</span><a id="line.660"> referencedValue = getIndexedProperty(object, mapPropertyPath, index);</a>
<span class="sourceLineNo">661</span><a id="line.661"> }</a>
<span class="sourceLineNo">662</span><a id="line.662"></a>
<span class="sourceLineNo">663</span><a id="line.663"> if (referencedValue == null) {</a>
<span class="sourceLineNo">664</span><a id="line.664"> throw new ConfigurationException("Referenced map/array value '" + mapPropertyPath + "[" +</a>
<span class="sourceLineNo">665</span><a id="line.665"> keyString + "]' does not exist.");</a>
<span class="sourceLineNo">666</span><a id="line.666"> }</a>
<span class="sourceLineNo">667</span><a id="line.667"></a>
<span class="sourceLineNo">668</span><a id="line.668"> applyProperty(referencedValue, remaining, value);</a>
<span class="sourceLineNo">669</span><a id="line.669"> }</a>
<span class="sourceLineNo">670</span><a id="line.670"> }</a>
<span class="sourceLineNo">671</span><a id="line.671"> </a>
<span class="sourceLineNo">672</span><a id="line.672"> private void setProperty(Object object, String propertyPath, Object value) {</a>
<span class="sourceLineNo">673</span><a id="line.673"> try {</a>
<span class="sourceLineNo">674</span><a id="line.674"> if (log.isTraceEnabled()) {</a>
<span class="sourceLineNo">675</span><a id="line.675"> log.trace("Applying property [{}] value [{}] on object of type [{}]",</a>
<span class="sourceLineNo">676</span><a id="line.676"> new Object[]{propertyPath, value, object.getClass().getName()});</a>
<span class="sourceLineNo">677</span><a id="line.677"> }</a>
<span class="sourceLineNo">678</span><a id="line.678"> beanUtilsBean.setProperty(object, propertyPath, value);</a>
<span class="sourceLineNo">679</span><a id="line.679"> } catch (Exception e) {</a>
<span class="sourceLineNo">680</span><a id="line.680"> String msg = "Unable to set property '" + propertyPath + "' with value [" + value + "] on object " +</a>
<span class="sourceLineNo">681</span><a id="line.681"> "of type " + (object != null ? object.getClass().getName() : null) + ". If " +</a>
<span class="sourceLineNo">682</span><a id="line.682"> "'" + value + "' is a reference to another (previously defined) object, prefix it with " +</a>
<span class="sourceLineNo">683</span><a id="line.683"> "'" + OBJECT_REFERENCE_BEGIN_TOKEN + "' to indicate that the referenced " +</a>
<span class="sourceLineNo">684</span><a id="line.684"> "object should be used as the actual value. " +</a>
<span class="sourceLineNo">685</span><a id="line.685"> "For example, " + OBJECT_REFERENCE_BEGIN_TOKEN + value;</a>
<span class="sourceLineNo">686</span><a id="line.686"> throw new ConfigurationException(msg, e);</a>
<span class="sourceLineNo">687</span><a id="line.687"> }</a>
<span class="sourceLineNo">688</span><a id="line.688"> }</a>
<span class="sourceLineNo">689</span><a id="line.689"> </a>
<span class="sourceLineNo">690</span><a id="line.690"> private Object getProperty(Object object, String propertyPath) {</a>
<span class="sourceLineNo">691</span><a id="line.691"> try {</a>
<span class="sourceLineNo">692</span><a id="line.692"> return beanUtilsBean.getPropertyUtils().getProperty(object, propertyPath);</a>
<span class="sourceLineNo">693</span><a id="line.693"> } catch (Exception e) {</a>
<span class="sourceLineNo">694</span><a id="line.694"> throw new ConfigurationException("Unable to access property '" + propertyPath + "'", e);</a>
<span class="sourceLineNo">695</span><a id="line.695"> }</a>
<span class="sourceLineNo">696</span><a id="line.696"> }</a>
<span class="sourceLineNo">697</span><a id="line.697"> </a>
<span class="sourceLineNo">698</span><a id="line.698"> private void setIndexedProperty(Object object, String propertyPath, int index, Object value) {</a>
<span class="sourceLineNo">699</span><a id="line.699"> try {</a>
<span class="sourceLineNo">700</span><a id="line.700"> beanUtilsBean.getPropertyUtils().setIndexedProperty(object, propertyPath, index, value);</a>
<span class="sourceLineNo">701</span><a id="line.701"> } catch (Exception e) {</a>
<span class="sourceLineNo">702</span><a id="line.702"> throw new ConfigurationException("Unable to set array property '" + propertyPath + "'", e);</a>
<span class="sourceLineNo">703</span><a id="line.703"> }</a>
<span class="sourceLineNo">704</span><a id="line.704"> }</a>
<span class="sourceLineNo">705</span><a id="line.705"> </a>
<span class="sourceLineNo">706</span><a id="line.706"> private Object getIndexedProperty(Object object, String propertyPath, int index) {</a>
<span class="sourceLineNo">707</span><a id="line.707"> try {</a>
<span class="sourceLineNo">708</span><a id="line.708"> return beanUtilsBean.getPropertyUtils().getIndexedProperty(object, propertyPath, index);</a>
<span class="sourceLineNo">709</span><a id="line.709"> } catch (Exception e) {</a>
<span class="sourceLineNo">710</span><a id="line.710"> throw new ConfigurationException("Unable to acquire array property '" + propertyPath + "'", e);</a>
<span class="sourceLineNo">711</span><a id="line.711"> }</a>
<span class="sourceLineNo">712</span><a id="line.712"> }</a>
<span class="sourceLineNo">713</span><a id="line.713"> </a>
<span class="sourceLineNo">714</span><a id="line.714"> protected boolean isIndexedPropertyAssignment(String propertyPath) {</a>
<span class="sourceLineNo">715</span><a id="line.715"> return propertyPath.endsWith("" + MAP_PROPERTY_END_TOKEN);</a>
<span class="sourceLineNo">716</span><a id="line.716"> }</a>
<span class="sourceLineNo">717</span><a id="line.717"></a>
<span class="sourceLineNo">718</span><a id="line.718"> protected void applyProperty(Object object, String propertyName, String stringValue) {</a>
<span class="sourceLineNo">719</span><a id="line.719"></a>
<span class="sourceLineNo">720</span><a id="line.720"> Object value;</a>
<span class="sourceLineNo">721</span><a id="line.721"></a>
<span class="sourceLineNo">722</span><a id="line.722"> if (NULL_VALUE_TOKEN.equals(stringValue)) {</a>
<span class="sourceLineNo">723</span><a id="line.723"> value = null;</a>
<span class="sourceLineNo">724</span><a id="line.724"> } else if (EMPTY_STRING_VALUE_TOKEN.equals(stringValue)) {</a>
<span class="sourceLineNo">725</span><a id="line.725"> value = StringUtils.EMPTY_STRING;</a>
<span class="sourceLineNo">726</span><a id="line.726"> } else if (isIndexedPropertyAssignment(propertyName)) {</a>
<span class="sourceLineNo">727</span><a id="line.727"> String checked = checkForNullOrEmptyLiteral(stringValue);</a>
<span class="sourceLineNo">728</span><a id="line.728"> value = resolveValue(checked);</a>
<span class="sourceLineNo">729</span><a id="line.729"> } else if (isTypedProperty(object, propertyName, Set.class)) {</a>
<span class="sourceLineNo">730</span><a id="line.730"> value = toSet(stringValue);</a>
<span class="sourceLineNo">731</span><a id="line.731"> } else if (isTypedProperty(object, propertyName, Map.class)) {</a>
<span class="sourceLineNo">732</span><a id="line.732"> value = toMap(stringValue);</a>
<span class="sourceLineNo">733</span><a id="line.733"> } else if (isTypedProperty(object, propertyName, List.class)) {</a>
<span class="sourceLineNo">734</span><a id="line.734"> value = toList(stringValue);</a>
<span class="sourceLineNo">735</span><a id="line.735"> } else if (isTypedProperty(object, propertyName, Collection.class)) {</a>
<span class="sourceLineNo">736</span><a id="line.736"> value = toCollection(stringValue);</a>
<span class="sourceLineNo">737</span><a id="line.737"> } else if (isTypedProperty(object, propertyName, byte[].class)) {</a>
<span class="sourceLineNo">738</span><a id="line.738"> value = toBytes(stringValue);</a>
<span class="sourceLineNo">739</span><a id="line.739"> } else if (isTypedProperty(object, propertyName, ByteSource.class)) {</a>
<span class="sourceLineNo">740</span><a id="line.740"> byte[] bytes = toBytes(stringValue);</a>
<span class="sourceLineNo">741</span><a id="line.741"> value = ByteSource.Util.bytes(bytes);</a>
<span class="sourceLineNo">742</span><a id="line.742"> } else {</a>
<span class="sourceLineNo">743</span><a id="line.743"> String checked = checkForNullOrEmptyLiteral(stringValue);</a>
<span class="sourceLineNo">744</span><a id="line.744"> value = resolveValue(checked);</a>
<span class="sourceLineNo">745</span><a id="line.745"> }</a>
<span class="sourceLineNo">746</span><a id="line.746"></a>
<span class="sourceLineNo">747</span><a id="line.747"> applyProperty(object, propertyName, value);</a>
<span class="sourceLineNo">748</span><a id="line.748"> }</a>
<span class="sourceLineNo">749</span><a id="line.749"></a>
<span class="sourceLineNo">750</span><a id="line.750"> private Interpolator createInterpolator() {</a>
<span class="sourceLineNo">751</span><a id="line.751"></a>
<span class="sourceLineNo">752</span><a id="line.752"> if (ClassUtils.isAvailable("org.apache.commons.configuration2.interpol.ConfigurationInterpolator")) {</a>
<span class="sourceLineNo">753</span><a id="line.753"> return new CommonsInterpolator();</a>
<span class="sourceLineNo">754</span><a id="line.754"> }</a>
<span class="sourceLineNo">755</span><a id="line.755"></a>
<span class="sourceLineNo">756</span><a id="line.756"> return new DefaultInterpolator();</a>
<span class="sourceLineNo">757</span><a id="line.757"> }</a>
<span class="sourceLineNo">758</span><a id="line.758"></a>
<span class="sourceLineNo">759</span><a id="line.759"> /**</a>
<span class="sourceLineNo">760</span><a id="line.760"> * Sets the {@link Interpolator} used when evaluating the right side of the expressions.</a>
<span class="sourceLineNo">761</span><a id="line.761"> * @since 1.4</a>
<span class="sourceLineNo">762</span><a id="line.762"> */</a>
<span class="sourceLineNo">763</span><a id="line.763"> public void setInterpolator(Interpolator interpolator) {</a>
<span class="sourceLineNo">764</span><a id="line.764"> this.interpolator = interpolator;</a>
<span class="sourceLineNo">765</span><a id="line.765"> }</a>
<span class="sourceLineNo">766</span><a id="line.766"></a>
<span class="sourceLineNo">767</span><a id="line.767"> private class BeanConfigurationProcessor {</a>
<span class="sourceLineNo">768</span><a id="line.768"></a>
<span class="sourceLineNo">769</span><a id="line.769"> private final List&lt;Statement&gt; statements = new ArrayList&lt;Statement&gt;();</a>
<span class="sourceLineNo">770</span><a id="line.770"> private final List&lt;BeanConfiguration&gt; beanConfigurations = new ArrayList&lt;BeanConfiguration&gt;();</a>
<span class="sourceLineNo">771</span><a id="line.771"></a>
<span class="sourceLineNo">772</span><a id="line.772"> public void add(Statement statement) {</a>
<span class="sourceLineNo">773</span><a id="line.773"></a>
<span class="sourceLineNo">774</span><a id="line.774"> statements.add(statement); //we execute bean configuration statements in the order they are declared.</a>
<span class="sourceLineNo">775</span><a id="line.775"></a>
<span class="sourceLineNo">776</span><a id="line.776"> if (statement instanceof InstantiationStatement) {</a>
<span class="sourceLineNo">777</span><a id="line.777"> InstantiationStatement is = (InstantiationStatement)statement;</a>
<span class="sourceLineNo">778</span><a id="line.778"> beanConfigurations.add(new BeanConfiguration(is));</a>
<span class="sourceLineNo">779</span><a id="line.779"> } else {</a>
<span class="sourceLineNo">780</span><a id="line.780"> AssignmentStatement as = (AssignmentStatement)statement;</a>
<span class="sourceLineNo">781</span><a id="line.781"> //statements always apply to the most recently defined bean configuration with the same name, so we</a>
<span class="sourceLineNo">782</span><a id="line.782"> //have to traverse the configuration list starting at the end (most recent elements are appended):</a>
<span class="sourceLineNo">783</span><a id="line.783"> boolean addedToConfig = false;</a>
<span class="sourceLineNo">784</span><a id="line.784"> String beanName = as.getRootBeanName();</a>
<span class="sourceLineNo">785</span><a id="line.785"> for( int i = beanConfigurations.size()-1; i &gt;= 0; i--) {</a>
<span class="sourceLineNo">786</span><a id="line.786"> BeanConfiguration mostRecent = beanConfigurations.get(i);</a>
<span class="sourceLineNo">787</span><a id="line.787"> String mostRecentBeanName = mostRecent.getBeanName();</a>
<span class="sourceLineNo">788</span><a id="line.788"> if (beanName.equals(mostRecentBeanName)) {</a>
<span class="sourceLineNo">789</span><a id="line.789"> mostRecent.add(as);</a>
<span class="sourceLineNo">790</span><a id="line.790"> addedToConfig = true;</a>
<span class="sourceLineNo">791</span><a id="line.791"> break;</a>
<span class="sourceLineNo">792</span><a id="line.792"> }</a>
<span class="sourceLineNo">793</span><a id="line.793"> }</a>
<span class="sourceLineNo">794</span><a id="line.794"></a>
<span class="sourceLineNo">795</span><a id="line.795"> if (!addedToConfig) {</a>
<span class="sourceLineNo">796</span><a id="line.796"> // the AssignmentStatement must be for an existing bean that does not yet have a corresponding</a>
<span class="sourceLineNo">797</span><a id="line.797"> // configuration object (this would happen if the bean is in the default objects map). Because</a>
<span class="sourceLineNo">798</span><a id="line.798"> // BeanConfiguration instances don't exist for default (already instantiated) beans,</a>
<span class="sourceLineNo">799</span><a id="line.799"> // we simulate a creation of one to satisfy this processors implementation:</a>
<span class="sourceLineNo">800</span><a id="line.800"> beanConfigurations.add(new BeanConfiguration(as));</a>
<span class="sourceLineNo">801</span><a id="line.801"> }</a>
<span class="sourceLineNo">802</span><a id="line.802"> }</a>
<span class="sourceLineNo">803</span><a id="line.803"> }</a>
<span class="sourceLineNo">804</span><a id="line.804"></a>
<span class="sourceLineNo">805</span><a id="line.805"> public void execute() {</a>
<span class="sourceLineNo">806</span><a id="line.806"></a>
<span class="sourceLineNo">807</span><a id="line.807"> for( Statement statement : statements) {</a>
<span class="sourceLineNo">808</span><a id="line.808"></a>
<span class="sourceLineNo">809</span><a id="line.809"> statement.execute();</a>
<span class="sourceLineNo">810</span><a id="line.810"></a>
<span class="sourceLineNo">811</span><a id="line.811"> BeanConfiguration bd = statement.getBeanConfiguration();</a>
<span class="sourceLineNo">812</span><a id="line.812"></a>
<span class="sourceLineNo">813</span><a id="line.813"> if (bd.isExecuted()) { //bean is fully configured, no more statements to execute for it:</a>
<span class="sourceLineNo">814</span><a id="line.814"></a>
<span class="sourceLineNo">815</span><a id="line.815"> //bean configured overrides the 'eventBus' bean - replace the existing eventBus with the one configured:</a>
<span class="sourceLineNo">816</span><a id="line.816"> if (bd.getBeanName().equals(EVENT_BUS_NAME)) {</a>
<span class="sourceLineNo">817</span><a id="line.817"> EventBus eventBus = (EventBus)bd.getBean();</a>
<span class="sourceLineNo">818</span><a id="line.818"> enableEvents(eventBus);</a>
<span class="sourceLineNo">819</span><a id="line.819"> }</a>
<span class="sourceLineNo">820</span><a id="line.820"></a>
<span class="sourceLineNo">821</span><a id="line.821"> //ignore global 'shiro.' shortcut mechanism:</a>
<span class="sourceLineNo">822</span><a id="line.822"> if (!bd.isGlobalConfig()) {</a>
<span class="sourceLineNo">823</span><a id="line.823"> BeanEvent event = new ConfiguredBeanEvent(bd.getBeanName(), bd.getBean(),</a>
<span class="sourceLineNo">824</span><a id="line.824"> Collections.unmodifiableMap(objects));</a>
<span class="sourceLineNo">825</span><a id="line.825"> eventBus.publish(event);</a>
<span class="sourceLineNo">826</span><a id="line.826"> }</a>
<span class="sourceLineNo">827</span><a id="line.827"></a>
<span class="sourceLineNo">828</span><a id="line.828"> //initialize the bean if necessary:</a>
<span class="sourceLineNo">829</span><a id="line.829"> LifecycleUtils.init(bd.getBean());</a>
<span class="sourceLineNo">830</span><a id="line.830"></a>
<span class="sourceLineNo">831</span><a id="line.831"> //ignore global 'shiro.' shortcut mechanism:</a>
<span class="sourceLineNo">832</span><a id="line.832"> if (!bd.isGlobalConfig()) {</a>
<span class="sourceLineNo">833</span><a id="line.833"> BeanEvent event = new InitializedBeanEvent(bd.getBeanName(), bd.getBean(),</a>
<span class="sourceLineNo">834</span><a id="line.834"> Collections.unmodifiableMap(objects));</a>
<span class="sourceLineNo">835</span><a id="line.835"> eventBus.publish(event);</a>
<span class="sourceLineNo">836</span><a id="line.836"> }</a>
<span class="sourceLineNo">837</span><a id="line.837"> }</a>
<span class="sourceLineNo">838</span><a id="line.838"> }</a>
<span class="sourceLineNo">839</span><a id="line.839"> }</a>
<span class="sourceLineNo">840</span><a id="line.840"> }</a>
<span class="sourceLineNo">841</span><a id="line.841"></a>
<span class="sourceLineNo">842</span><a id="line.842"> private class BeanConfiguration {</a>
<span class="sourceLineNo">843</span><a id="line.843"></a>
<span class="sourceLineNo">844</span><a id="line.844"> private final InstantiationStatement instantiationStatement;</a>
<span class="sourceLineNo">845</span><a id="line.845"> private final List&lt;AssignmentStatement&gt; assignments = new ArrayList&lt;AssignmentStatement&gt;();</a>
<span class="sourceLineNo">846</span><a id="line.846"> private final String beanName;</a>
<span class="sourceLineNo">847</span><a id="line.847"> private Object bean;</a>
<span class="sourceLineNo">848</span><a id="line.848"></a>
<span class="sourceLineNo">849</span><a id="line.849"> private BeanConfiguration(InstantiationStatement statement) {</a>
<span class="sourceLineNo">850</span><a id="line.850"> statement.setBeanConfiguration(this);</a>
<span class="sourceLineNo">851</span><a id="line.851"> this.instantiationStatement = statement;</a>
<span class="sourceLineNo">852</span><a id="line.852"> this.beanName = statement.lhs;</a>
<span class="sourceLineNo">853</span><a id="line.853"> }</a>
<span class="sourceLineNo">854</span><a id="line.854"></a>
<span class="sourceLineNo">855</span><a id="line.855"> private BeanConfiguration(AssignmentStatement as) {</a>
<span class="sourceLineNo">856</span><a id="line.856"> this.instantiationStatement = null;</a>
<span class="sourceLineNo">857</span><a id="line.857"> this.beanName = as.getRootBeanName();</a>
<span class="sourceLineNo">858</span><a id="line.858"> add(as);</a>
<span class="sourceLineNo">859</span><a id="line.859"> }</a>
<span class="sourceLineNo">860</span><a id="line.860"></a>
<span class="sourceLineNo">861</span><a id="line.861"> public String getBeanName() {</a>
<span class="sourceLineNo">862</span><a id="line.862"> return this.beanName;</a>
<span class="sourceLineNo">863</span><a id="line.863"> }</a>
<span class="sourceLineNo">864</span><a id="line.864"></a>
<span class="sourceLineNo">865</span><a id="line.865"> public boolean isGlobalConfig() { //BeanConfiguration instance representing the global 'shiro.' properties</a>
<span class="sourceLineNo">866</span><a id="line.866"> // (we should remove this concept).</a>
<span class="sourceLineNo">867</span><a id="line.867"> return GLOBAL_PROPERTY_PREFIX.equals(getBeanName());</a>
<span class="sourceLineNo">868</span><a id="line.868"> }</a>
<span class="sourceLineNo">869</span><a id="line.869"></a>
<span class="sourceLineNo">870</span><a id="line.870"> public void add(AssignmentStatement as) {</a>
<span class="sourceLineNo">871</span><a id="line.871"> as.setBeanConfiguration(this);</a>
<span class="sourceLineNo">872</span><a id="line.872"> assignments.add(as);</a>
<span class="sourceLineNo">873</span><a id="line.873"> }</a>
<span class="sourceLineNo">874</span><a id="line.874"></a>
<span class="sourceLineNo">875</span><a id="line.875"> /**</a>
<span class="sourceLineNo">876</span><a id="line.876"> * When this configuration is parsed sufficiently to create (or find) an actual bean instance, that instance</a>
<span class="sourceLineNo">877</span><a id="line.877"> * will be associated with its configuration by setting it via this method.</a>
<span class="sourceLineNo">878</span><a id="line.878"> *</a>
<span class="sourceLineNo">879</span><a id="line.879"> * @param bean the bean instantiated (or found) that corresponds to this BeanConfiguration instance.</a>
<span class="sourceLineNo">880</span><a id="line.880"> */</a>
<span class="sourceLineNo">881</span><a id="line.881"> public void setBean(Object bean) {</a>
<span class="sourceLineNo">882</span><a id="line.882"> this.bean = bean;</a>
<span class="sourceLineNo">883</span><a id="line.883"> }</a>
<span class="sourceLineNo">884</span><a id="line.884"></a>
<span class="sourceLineNo">885</span><a id="line.885"> public Object getBean() {</a>
<span class="sourceLineNo">886</span><a id="line.886"> return this.bean;</a>
<span class="sourceLineNo">887</span><a id="line.887"> }</a>
<span class="sourceLineNo">888</span><a id="line.888"></a>
<span class="sourceLineNo">889</span><a id="line.889"> /**</a>
<span class="sourceLineNo">890</span><a id="line.890"> * Returns true if all configuration statements have been executed.</a>
<span class="sourceLineNo">891</span><a id="line.891"> * @return true if all configuration statements have been executed.</a>
<span class="sourceLineNo">892</span><a id="line.892"> */</a>
<span class="sourceLineNo">893</span><a id="line.893"> public boolean isExecuted() {</a>
<span class="sourceLineNo">894</span><a id="line.894"> if (instantiationStatement != null &amp;&amp; !instantiationStatement.isExecuted()) {</a>
<span class="sourceLineNo">895</span><a id="line.895"> return false;</a>
<span class="sourceLineNo">896</span><a id="line.896"> }</a>
<span class="sourceLineNo">897</span><a id="line.897"> for (AssignmentStatement as : assignments) {</a>
<span class="sourceLineNo">898</span><a id="line.898"> if (!as.isExecuted()) {</a>
<span class="sourceLineNo">899</span><a id="line.899"> return false;</a>
<span class="sourceLineNo">900</span><a id="line.900"> }</a>
<span class="sourceLineNo">901</span><a id="line.901"> }</a>
<span class="sourceLineNo">902</span><a id="line.902"> return true;</a>
<span class="sourceLineNo">903</span><a id="line.903"> }</a>
<span class="sourceLineNo">904</span><a id="line.904"> }</a>
<span class="sourceLineNo">905</span><a id="line.905"></a>
<span class="sourceLineNo">906</span><a id="line.906"> private abstract class Statement {</a>
<span class="sourceLineNo">907</span><a id="line.907"></a>
<span class="sourceLineNo">908</span><a id="line.908"> protected final String lhs;</a>
<span class="sourceLineNo">909</span><a id="line.909"> protected final String rhs;</a>
<span class="sourceLineNo">910</span><a id="line.910"> protected Object bean;</a>
<span class="sourceLineNo">911</span><a id="line.911"> private Object result;</a>
<span class="sourceLineNo">912</span><a id="line.912"> private boolean executed;</a>
<span class="sourceLineNo">913</span><a id="line.913"> private BeanConfiguration beanConfiguration;</a>
<span class="sourceLineNo">914</span><a id="line.914"></a>
<span class="sourceLineNo">915</span><a id="line.915"> private Statement(String lhs, String rhs) {</a>
<span class="sourceLineNo">916</span><a id="line.916"> this.lhs = lhs;</a>
<span class="sourceLineNo">917</span><a id="line.917"> this.rhs = rhs;</a>
<span class="sourceLineNo">918</span><a id="line.918"> this.executed = false;</a>
<span class="sourceLineNo">919</span><a id="line.919"> }</a>
<span class="sourceLineNo">920</span><a id="line.920"></a>
<span class="sourceLineNo">921</span><a id="line.921"> public void setBeanConfiguration(BeanConfiguration bd) {</a>
<span class="sourceLineNo">922</span><a id="line.922"> this.beanConfiguration = bd;</a>
<span class="sourceLineNo">923</span><a id="line.923"> }</a>
<span class="sourceLineNo">924</span><a id="line.924"></a>
<span class="sourceLineNo">925</span><a id="line.925"> public BeanConfiguration getBeanConfiguration() {</a>
<span class="sourceLineNo">926</span><a id="line.926"> return this.beanConfiguration;</a>
<span class="sourceLineNo">927</span><a id="line.927"> }</a>
<span class="sourceLineNo">928</span><a id="line.928"></a>
<span class="sourceLineNo">929</span><a id="line.929"> public Object execute() {</a>
<span class="sourceLineNo">930</span><a id="line.930"> if (!isExecuted()) {</a>
<span class="sourceLineNo">931</span><a id="line.931"> this.result = doExecute();</a>
<span class="sourceLineNo">932</span><a id="line.932"> this.executed = true;</a>
<span class="sourceLineNo">933</span><a id="line.933"> }</a>
<span class="sourceLineNo">934</span><a id="line.934"> if (!getBeanConfiguration().isGlobalConfig()) {</a>
<span class="sourceLineNo">935</span><a id="line.935"> Assert.notNull(this.bean, "Implementation must set the root bean for which it executed.");</a>
<span class="sourceLineNo">936</span><a id="line.936"> }</a>
<span class="sourceLineNo">937</span><a id="line.937"> return this.result;</a>
<span class="sourceLineNo">938</span><a id="line.938"> }</a>
<span class="sourceLineNo">939</span><a id="line.939"></a>
<span class="sourceLineNo">940</span><a id="line.940"> public Object getBean() {</a>
<span class="sourceLineNo">941</span><a id="line.941"> return this.bean;</a>
<span class="sourceLineNo">942</span><a id="line.942"> }</a>
<span class="sourceLineNo">943</span><a id="line.943"></a>
<span class="sourceLineNo">944</span><a id="line.944"> protected void setBean(Object bean) {</a>
<span class="sourceLineNo">945</span><a id="line.945"> this.bean = bean;</a>
<span class="sourceLineNo">946</span><a id="line.946"> if (this.beanConfiguration.getBean() == null) {</a>
<span class="sourceLineNo">947</span><a id="line.947"> this.beanConfiguration.setBean(bean);</a>
<span class="sourceLineNo">948</span><a id="line.948"> }</a>
<span class="sourceLineNo">949</span><a id="line.949"> }</a>
<span class="sourceLineNo">950</span><a id="line.950"></a>
<span class="sourceLineNo">951</span><a id="line.951"> public Object getResult() {</a>
<span class="sourceLineNo">952</span><a id="line.952"> return result;</a>
<span class="sourceLineNo">953</span><a id="line.953"> }</a>
<span class="sourceLineNo">954</span><a id="line.954"></a>
<span class="sourceLineNo">955</span><a id="line.955"> protected abstract Object doExecute();</a>
<span class="sourceLineNo">956</span><a id="line.956"></a>
<span class="sourceLineNo">957</span><a id="line.957"> public boolean isExecuted() {</a>
<span class="sourceLineNo">958</span><a id="line.958"> return executed;</a>
<span class="sourceLineNo">959</span><a id="line.959"> }</a>
<span class="sourceLineNo">960</span><a id="line.960"> }</a>
<span class="sourceLineNo">961</span><a id="line.961"></a>
<span class="sourceLineNo">962</span><a id="line.962"> private class InstantiationStatement extends Statement {</a>
<span class="sourceLineNo">963</span><a id="line.963"></a>
<span class="sourceLineNo">964</span><a id="line.964"> private InstantiationStatement(String lhs, String rhs) {</a>
<span class="sourceLineNo">965</span><a id="line.965"> super(lhs, rhs);</a>
<span class="sourceLineNo">966</span><a id="line.966"> }</a>
<span class="sourceLineNo">967</span><a id="line.967"></a>
<span class="sourceLineNo">968</span><a id="line.968"> @Override</a>
<span class="sourceLineNo">969</span><a id="line.969"> protected Object doExecute() {</a>
<span class="sourceLineNo">970</span><a id="line.970"> String beanName = this.lhs;</a>
<span class="sourceLineNo">971</span><a id="line.971"> createNewInstance(objects, beanName, this.rhs);</a>
<span class="sourceLineNo">972</span><a id="line.972"> Object instantiated = objects.get(beanName);</a>
<span class="sourceLineNo">973</span><a id="line.973"> setBean(instantiated);</a>
<span class="sourceLineNo">974</span><a id="line.974"></a>
<span class="sourceLineNo">975</span><a id="line.975"> //also ensure the instantiated bean has access to the event bus or is subscribed to events if necessary:</a>
<span class="sourceLineNo">976</span><a id="line.976"> //Note: because events are being enabled on this bean here (before the instantiated event below is</a>
<span class="sourceLineNo">977</span><a id="line.977"> //triggered), beans can react to their own instantiation events.</a>
<span class="sourceLineNo">978</span><a id="line.978"> enableEventsIfNecessary(instantiated, beanName);</a>
<span class="sourceLineNo">979</span><a id="line.979"></a>
<span class="sourceLineNo">980</span><a id="line.980"> BeanEvent event = new InstantiatedBeanEvent(beanName, instantiated, Collections.unmodifiableMap(objects));</a>
<span class="sourceLineNo">981</span><a id="line.981"> eventBus.publish(event);</a>
<span class="sourceLineNo">982</span><a id="line.982"></a>
<span class="sourceLineNo">983</span><a id="line.983"> return instantiated;</a>
<span class="sourceLineNo">984</span><a id="line.984"> }</a>
<span class="sourceLineNo">985</span><a id="line.985"> }</a>
<span class="sourceLineNo">986</span><a id="line.986"></a>
<span class="sourceLineNo">987</span><a id="line.987"> private class AssignmentStatement extends Statement {</a>
<span class="sourceLineNo">988</span><a id="line.988"></a>
<span class="sourceLineNo">989</span><a id="line.989"> private final String rootBeanName;</a>
<span class="sourceLineNo">990</span><a id="line.990"></a>
<span class="sourceLineNo">991</span><a id="line.991"> private AssignmentStatement(String lhs, String rhs) {</a>
<span class="sourceLineNo">992</span><a id="line.992"> super(lhs, rhs);</a>
<span class="sourceLineNo">993</span><a id="line.993"> int index = lhs.indexOf('.');</a>
<span class="sourceLineNo">994</span><a id="line.994"> this.rootBeanName = lhs.substring(0, index);</a>
<span class="sourceLineNo">995</span><a id="line.995"> }</a>
<span class="sourceLineNo">996</span><a id="line.996"></a>
<span class="sourceLineNo">997</span><a id="line.997"> @Override</a>
<span class="sourceLineNo">998</span><a id="line.998"> protected Object doExecute() {</a>
<span class="sourceLineNo">999</span><a id="line.999"> applyProperty(lhs, rhs, objects);</a>
<span class="sourceLineNo">1000</span><a id="line.1000"> Object bean = objects.get(this.rootBeanName);</a>
<span class="sourceLineNo">1001</span><a id="line.1001"> setBean(bean);</a>
<span class="sourceLineNo">1002</span><a id="line.1002"> return null;</a>
<span class="sourceLineNo">1003</span><a id="line.1003"> }</a>
<span class="sourceLineNo">1004</span><a id="line.1004"></a>
<span class="sourceLineNo">1005</span><a id="line.1005"> public String getRootBeanName() {</a>
<span class="sourceLineNo">1006</span><a id="line.1006"> return this.rootBeanName;</a>
<span class="sourceLineNo">1007</span><a id="line.1007"> }</a>
<span class="sourceLineNo">1008</span><a id="line.1008"> }</a>
<span class="sourceLineNo">1009</span><a id="line.1009"></a>
<span class="sourceLineNo">1010</span><a id="line.1010"> //////////////////////////</a>
<span class="sourceLineNo">1011</span><a id="line.1011"> // From CollectionUtils //</a>
<span class="sourceLineNo">1012</span><a id="line.1012"> //////////////////////////</a>
<span class="sourceLineNo">1013</span><a id="line.1013"> // CollectionUtils cannot be removed from shiro-core until 2.0 as it has a dependency on PrincipalCollection</a>
<span class="sourceLineNo">1014</span><a id="line.1014"></a>
<span class="sourceLineNo">1015</span><a id="line.1015"> private static boolean isEmpty(Map m) {</a>
<span class="sourceLineNo">1016</span><a id="line.1016"> return m == null || m.isEmpty();</a>
<span class="sourceLineNo">1017</span><a id="line.1017"> }</a>
<span class="sourceLineNo">1018</span><a id="line.1018"></a>
<span class="sourceLineNo">1019</span><a id="line.1019"> private static boolean isEmpty(Collection c) {</a>
<span class="sourceLineNo">1020</span><a id="line.1020"> return c == null || c.isEmpty();</a>
<span class="sourceLineNo">1021</span><a id="line.1021"> }</a>
<span class="sourceLineNo">1022</span><a id="line.1022"></a>
<span class="sourceLineNo">1023</span><a id="line.1023">}</a>
</pre>
</div>
</main>
</body>
</html>