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