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