blob: 01fe6570483d8fa37cd334ce668786778f9b7c49 [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.session.mgt;</a>
<span class="sourceLineNo">020</span><a id="line.20"></a>
<span class="sourceLineNo">021</span><a id="line.21">import org.apache.shiro.cache.CacheManager;</a>
<span class="sourceLineNo">022</span><a id="line.22">import org.apache.shiro.cache.CacheManagerAware;</a>
<span class="sourceLineNo">023</span><a id="line.23">import org.apache.shiro.session.Session;</a>
<span class="sourceLineNo">024</span><a id="line.24">import org.apache.shiro.session.UnknownSessionException;</a>
<span class="sourceLineNo">025</span><a id="line.25">import org.apache.shiro.session.mgt.eis.MemorySessionDAO;</a>
<span class="sourceLineNo">026</span><a id="line.26">import org.apache.shiro.session.mgt.eis.SessionDAO;</a>
<span class="sourceLineNo">027</span><a id="line.27">import org.slf4j.Logger;</a>
<span class="sourceLineNo">028</span><a id="line.28">import org.slf4j.LoggerFactory;</a>
<span class="sourceLineNo">029</span><a id="line.29"></a>
<span class="sourceLineNo">030</span><a id="line.30">import java.io.Serializable;</a>
<span class="sourceLineNo">031</span><a id="line.31">import java.util.Collection;</a>
<span class="sourceLineNo">032</span><a id="line.32">import java.util.Collections;</a>
<span class="sourceLineNo">033</span><a id="line.33">import java.util.Date;</a>
<span class="sourceLineNo">034</span><a id="line.34"></a>
<span class="sourceLineNo">035</span><a id="line.35">/**</a>
<span class="sourceLineNo">036</span><a id="line.36"> * Default business-tier implementation of a {@link ValidatingSessionManager}. All session CRUD operations are</a>
<span class="sourceLineNo">037</span><a id="line.37"> * delegated to an internal {@link SessionDAO}.</a>
<span class="sourceLineNo">038</span><a id="line.38"> *</a>
<span class="sourceLineNo">039</span><a id="line.39"> * @since 0.1</a>
<span class="sourceLineNo">040</span><a id="line.40"> */</a>
<span class="sourceLineNo">041</span><a id="line.41">public class DefaultSessionManager extends AbstractValidatingSessionManager implements CacheManagerAware {</a>
<span class="sourceLineNo">042</span><a id="line.42"></a>
<span class="sourceLineNo">043</span><a id="line.43"> //TODO - complete JavaDoc</a>
<span class="sourceLineNo">044</span><a id="line.44"></a>
<span class="sourceLineNo">045</span><a id="line.45"> private static final Logger log = LoggerFactory.getLogger(DefaultSessionManager.class);</a>
<span class="sourceLineNo">046</span><a id="line.46"></a>
<span class="sourceLineNo">047</span><a id="line.47"> private SessionFactory sessionFactory;</a>
<span class="sourceLineNo">048</span><a id="line.48"></a>
<span class="sourceLineNo">049</span><a id="line.49"> protected SessionDAO sessionDAO; //todo - move SessionDAO up to AbstractValidatingSessionManager?</a>
<span class="sourceLineNo">050</span><a id="line.50"></a>
<span class="sourceLineNo">051</span><a id="line.51"> private CacheManager cacheManager;</a>
<span class="sourceLineNo">052</span><a id="line.52"></a>
<span class="sourceLineNo">053</span><a id="line.53"> private boolean deleteInvalidSessions;</a>
<span class="sourceLineNo">054</span><a id="line.54"></a>
<span class="sourceLineNo">055</span><a id="line.55"> public DefaultSessionManager() {</a>
<span class="sourceLineNo">056</span><a id="line.56"> this.deleteInvalidSessions = true;</a>
<span class="sourceLineNo">057</span><a id="line.57"> this.sessionFactory = new SimpleSessionFactory();</a>
<span class="sourceLineNo">058</span><a id="line.58"> this.sessionDAO = new MemorySessionDAO();</a>
<span class="sourceLineNo">059</span><a id="line.59"> }</a>
<span class="sourceLineNo">060</span><a id="line.60"></a>
<span class="sourceLineNo">061</span><a id="line.61"> public void setSessionDAO(SessionDAO sessionDAO) {</a>
<span class="sourceLineNo">062</span><a id="line.62"> this.sessionDAO = sessionDAO;</a>
<span class="sourceLineNo">063</span><a id="line.63"> applyCacheManagerToSessionDAO();</a>
<span class="sourceLineNo">064</span><a id="line.64"> }</a>
<span class="sourceLineNo">065</span><a id="line.65"></a>
<span class="sourceLineNo">066</span><a id="line.66"> public SessionDAO getSessionDAO() {</a>
<span class="sourceLineNo">067</span><a id="line.67"> return this.sessionDAO;</a>
<span class="sourceLineNo">068</span><a id="line.68"> }</a>
<span class="sourceLineNo">069</span><a id="line.69"></a>
<span class="sourceLineNo">070</span><a id="line.70"> /**</a>
<span class="sourceLineNo">071</span><a id="line.71"> * Returns the {@code SessionFactory} used to generate new {@link Session} instances. The default instance</a>
<span class="sourceLineNo">072</span><a id="line.72"> * is a {@link SimpleSessionFactory}.</a>
<span class="sourceLineNo">073</span><a id="line.73"> *</a>
<span class="sourceLineNo">074</span><a id="line.74"> * @return the {@code SessionFactory} used to generate new {@link Session} instances.</a>
<span class="sourceLineNo">075</span><a id="line.75"> * @since 1.0</a>
<span class="sourceLineNo">076</span><a id="line.76"> */</a>
<span class="sourceLineNo">077</span><a id="line.77"> public SessionFactory getSessionFactory() {</a>
<span class="sourceLineNo">078</span><a id="line.78"> return sessionFactory;</a>
<span class="sourceLineNo">079</span><a id="line.79"> }</a>
<span class="sourceLineNo">080</span><a id="line.80"></a>
<span class="sourceLineNo">081</span><a id="line.81"> /**</a>
<span class="sourceLineNo">082</span><a id="line.82"> * Sets the {@code SessionFactory} used to generate new {@link Session} instances. The default instance</a>
<span class="sourceLineNo">083</span><a id="line.83"> * is a {@link SimpleSessionFactory}.</a>
<span class="sourceLineNo">084</span><a id="line.84"> *</a>
<span class="sourceLineNo">085</span><a id="line.85"> * @param sessionFactory the {@code SessionFactory} used to generate new {@link Session} instances.</a>
<span class="sourceLineNo">086</span><a id="line.86"> * @since 1.0</a>
<span class="sourceLineNo">087</span><a id="line.87"> */</a>
<span class="sourceLineNo">088</span><a id="line.88"> public void setSessionFactory(SessionFactory sessionFactory) {</a>
<span class="sourceLineNo">089</span><a id="line.89"> this.sessionFactory = sessionFactory;</a>
<span class="sourceLineNo">090</span><a id="line.90"> }</a>
<span class="sourceLineNo">091</span><a id="line.91"></a>
<span class="sourceLineNo">092</span><a id="line.92"> /**</a>
<span class="sourceLineNo">093</span><a id="line.93"> * Returns {@code true} if sessions should be automatically deleted after they are discovered to be invalid,</a>
<span class="sourceLineNo">094</span><a id="line.94"> * {@code false} if invalid sessions will be manually deleted by some process external to Shiro's control. The</a>
<span class="sourceLineNo">095</span><a id="line.95"> * default is {@code true} to ensure no orphans exist in the underlying data store.</a>
<span class="sourceLineNo">096</span><a id="line.96"> * &lt;h4&gt;Usage&lt;/h4&gt;</a>
<span class="sourceLineNo">097</span><a id="line.97"> * It is ok to set this to {@code false} &lt;b&gt;&lt;em&gt;ONLY&lt;/em&gt;&lt;/b&gt; if you have some other process that you manage yourself</a>
<span class="sourceLineNo">098</span><a id="line.98"> * that periodically deletes invalid sessions from the backing data store over time, such as via a Quartz or Cron</a>
<span class="sourceLineNo">099</span><a id="line.99"> * job. If you do not do this, the invalid sessions will become 'orphans' and fill up the data store over time.</a>
<span class="sourceLineNo">100</span><a id="line.100"> * &lt;p/&gt;</a>
<span class="sourceLineNo">101</span><a id="line.101"> * This property is provided because some systems need the ability to perform querying/reporting against sessions in</a>
<span class="sourceLineNo">102</span><a id="line.102"> * the data store, even after they have stopped or expired. Setting this attribute to {@code false} will allow</a>
<span class="sourceLineNo">103</span><a id="line.103"> * such querying, but with the caveat that the application developer/configurer deletes the sessions themselves by</a>
<span class="sourceLineNo">104</span><a id="line.104"> * some other means (cron, quartz, etc).</a>
<span class="sourceLineNo">105</span><a id="line.105"> *</a>
<span class="sourceLineNo">106</span><a id="line.106"> * @return {@code true} if sessions should be automatically deleted after they are discovered to be invalid,</a>
<span class="sourceLineNo">107</span><a id="line.107"> * {@code false} if invalid sessions will be manually deleted by some process external to Shiro's control.</a>
<span class="sourceLineNo">108</span><a id="line.108"> * @since 1.0</a>
<span class="sourceLineNo">109</span><a id="line.109"> */</a>
<span class="sourceLineNo">110</span><a id="line.110"> public boolean isDeleteInvalidSessions() {</a>
<span class="sourceLineNo">111</span><a id="line.111"> return deleteInvalidSessions;</a>
<span class="sourceLineNo">112</span><a id="line.112"> }</a>
<span class="sourceLineNo">113</span><a id="line.113"></a>
<span class="sourceLineNo">114</span><a id="line.114"> /**</a>
<span class="sourceLineNo">115</span><a id="line.115"> * Sets whether or not sessions should be automatically deleted after they are discovered to be invalid. Default</a>
<span class="sourceLineNo">116</span><a id="line.116"> * value is {@code true} to ensure no orphans will exist in the underlying data store.</a>
<span class="sourceLineNo">117</span><a id="line.117"> * &lt;h4&gt;WARNING&lt;/h4&gt;</a>
<span class="sourceLineNo">118</span><a id="line.118"> * Only set this value to {@code false} if you are manually going to delete sessions yourself by some process</a>
<span class="sourceLineNo">119</span><a id="line.119"> * (quartz, cron, etc) external to Shiro's control. See the</a>
<span class="sourceLineNo">120</span><a id="line.120"> * {@link #isDeleteInvalidSessions() isDeleteInvalidSessions()} JavaDoc for more.</a>
<span class="sourceLineNo">121</span><a id="line.121"> *</a>
<span class="sourceLineNo">122</span><a id="line.122"> * @param deleteInvalidSessions whether or not sessions should be automatically deleted after they are discovered</a>
<span class="sourceLineNo">123</span><a id="line.123"> * to be invalid.</a>
<span class="sourceLineNo">124</span><a id="line.124"> * @since 1.0</a>
<span class="sourceLineNo">125</span><a id="line.125"> */</a>
<span class="sourceLineNo">126</span><a id="line.126"> @SuppressWarnings({"UnusedDeclaration"})</a>
<span class="sourceLineNo">127</span><a id="line.127"> public void setDeleteInvalidSessions(boolean deleteInvalidSessions) {</a>
<span class="sourceLineNo">128</span><a id="line.128"> this.deleteInvalidSessions = deleteInvalidSessions;</a>
<span class="sourceLineNo">129</span><a id="line.129"> }</a>
<span class="sourceLineNo">130</span><a id="line.130"></a>
<span class="sourceLineNo">131</span><a id="line.131"> public void setCacheManager(CacheManager cacheManager) {</a>
<span class="sourceLineNo">132</span><a id="line.132"> this.cacheManager = cacheManager;</a>
<span class="sourceLineNo">133</span><a id="line.133"> applyCacheManagerToSessionDAO();</a>
<span class="sourceLineNo">134</span><a id="line.134"> }</a>
<span class="sourceLineNo">135</span><a id="line.135"></a>
<span class="sourceLineNo">136</span><a id="line.136"> /**</a>
<span class="sourceLineNo">137</span><a id="line.137"> * Sets the internal {@code CacheManager} on the {@code SessionDAO} if it implements the</a>
<span class="sourceLineNo">138</span><a id="line.138"> * {@link org.apache.shiro.cache.CacheManagerAware CacheManagerAware} interface.</a>
<span class="sourceLineNo">139</span><a id="line.139"> * &lt;p/&gt;</a>
<span class="sourceLineNo">140</span><a id="line.140"> * This method is called after setting a cacheManager via the</a>
<span class="sourceLineNo">141</span><a id="line.141"> * {@link #setCacheManager(org.apache.shiro.cache.CacheManager) setCacheManager} method &lt;em&gt;em&lt;/em&gt; when</a>
<span class="sourceLineNo">142</span><a id="line.142"> * setting a {@code SessionDAO} via the {@link #setSessionDAO} method to allow it to be propagated</a>
<span class="sourceLineNo">143</span><a id="line.143"> * in either case.</a>
<span class="sourceLineNo">144</span><a id="line.144"> *</a>
<span class="sourceLineNo">145</span><a id="line.145"> * @since 1.0</a>
<span class="sourceLineNo">146</span><a id="line.146"> */</a>
<span class="sourceLineNo">147</span><a id="line.147"> private void applyCacheManagerToSessionDAO() {</a>
<span class="sourceLineNo">148</span><a id="line.148"> if (this.cacheManager != null &amp;&amp; this.sessionDAO != null &amp;&amp; this.sessionDAO instanceof CacheManagerAware) {</a>
<span class="sourceLineNo">149</span><a id="line.149"> ((CacheManagerAware) this.sessionDAO).setCacheManager(this.cacheManager);</a>
<span class="sourceLineNo">150</span><a id="line.150"> }</a>
<span class="sourceLineNo">151</span><a id="line.151"> }</a>
<span class="sourceLineNo">152</span><a id="line.152"></a>
<span class="sourceLineNo">153</span><a id="line.153"> protected Session doCreateSession(SessionContext context) {</a>
<span class="sourceLineNo">154</span><a id="line.154"> Session s = newSessionInstance(context);</a>
<span class="sourceLineNo">155</span><a id="line.155"> if (log.isTraceEnabled()) {</a>
<span class="sourceLineNo">156</span><a id="line.156"> log.trace("Creating session for host {}", s.getHost());</a>
<span class="sourceLineNo">157</span><a id="line.157"> }</a>
<span class="sourceLineNo">158</span><a id="line.158"> create(s);</a>
<span class="sourceLineNo">159</span><a id="line.159"> return s;</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"> protected Session newSessionInstance(SessionContext context) {</a>
<span class="sourceLineNo">163</span><a id="line.163"> return getSessionFactory().createSession(context);</a>
<span class="sourceLineNo">164</span><a id="line.164"> }</a>
<span class="sourceLineNo">165</span><a id="line.165"></a>
<span class="sourceLineNo">166</span><a id="line.166"> /**</a>
<span class="sourceLineNo">167</span><a id="line.167"> * Persists the given session instance to an underlying EIS (Enterprise Information System). This implementation</a>
<span class="sourceLineNo">168</span><a id="line.168"> * delegates and calls</a>
<span class="sourceLineNo">169</span><a id="line.169"> * &lt;code&gt;this.{@link SessionDAO sessionDAO}.{@link SessionDAO#create(org.apache.shiro.session.Session) create}(session);&lt;code&gt;</a>
<span class="sourceLineNo">170</span><a id="line.170"> *</a>
<span class="sourceLineNo">171</span><a id="line.171"> * @param session the Session instance to persist to the underlying EIS.</a>
<span class="sourceLineNo">172</span><a id="line.172"> */</a>
<span class="sourceLineNo">173</span><a id="line.173"> protected void create(Session session) {</a>
<span class="sourceLineNo">174</span><a id="line.174"> if (log.isDebugEnabled()) {</a>
<span class="sourceLineNo">175</span><a id="line.175"> log.debug("Creating new EIS record for new session instance [" + session + "]");</a>
<span class="sourceLineNo">176</span><a id="line.176"> }</a>
<span class="sourceLineNo">177</span><a id="line.177"> sessionDAO.create(session);</a>
<span class="sourceLineNo">178</span><a id="line.178"> }</a>
<span class="sourceLineNo">179</span><a id="line.179"></a>
<span class="sourceLineNo">180</span><a id="line.180"> @Override</a>
<span class="sourceLineNo">181</span><a id="line.181"> protected void onStop(Session session) {</a>
<span class="sourceLineNo">182</span><a id="line.182"> if (session instanceof SimpleSession) {</a>
<span class="sourceLineNo">183</span><a id="line.183"> SimpleSession ss = (SimpleSession) session;</a>
<span class="sourceLineNo">184</span><a id="line.184"> Date stopTs = ss.getStopTimestamp();</a>
<span class="sourceLineNo">185</span><a id="line.185"> ss.setLastAccessTime(stopTs);</a>
<span class="sourceLineNo">186</span><a id="line.186"> }</a>
<span class="sourceLineNo">187</span><a id="line.187"> onChange(session);</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"> @Override</a>
<span class="sourceLineNo">191</span><a id="line.191"> protected void afterStopped(Session session) {</a>
<span class="sourceLineNo">192</span><a id="line.192"> if (isDeleteInvalidSessions()) {</a>
<span class="sourceLineNo">193</span><a id="line.193"> delete(session);</a>
<span class="sourceLineNo">194</span><a id="line.194"> }</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"> protected void onExpiration(Session session) {</a>
<span class="sourceLineNo">198</span><a id="line.198"> if (session instanceof SimpleSession) {</a>
<span class="sourceLineNo">199</span><a id="line.199"> ((SimpleSession) session).setExpired(true);</a>
<span class="sourceLineNo">200</span><a id="line.200"> }</a>
<span class="sourceLineNo">201</span><a id="line.201"> onChange(session);</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"> @Override</a>
<span class="sourceLineNo">205</span><a id="line.205"> protected void afterExpired(Session session) {</a>
<span class="sourceLineNo">206</span><a id="line.206"> if (isDeleteInvalidSessions()) {</a>
<span class="sourceLineNo">207</span><a id="line.207"> delete(session);</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"></a>
<span class="sourceLineNo">211</span><a id="line.211"> protected void onChange(Session session) {</a>
<span class="sourceLineNo">212</span><a id="line.212"> sessionDAO.update(session);</a>
<span class="sourceLineNo">213</span><a id="line.213"> }</a>
<span class="sourceLineNo">214</span><a id="line.214"></a>
<span class="sourceLineNo">215</span><a id="line.215"> protected Session retrieveSession(SessionKey sessionKey) throws UnknownSessionException {</a>
<span class="sourceLineNo">216</span><a id="line.216"> Serializable sessionId = getSessionId(sessionKey);</a>
<span class="sourceLineNo">217</span><a id="line.217"> if (sessionId == null) {</a>
<span class="sourceLineNo">218</span><a id="line.218"> log.debug("Unable to resolve session ID from SessionKey [{}]. Returning null to indicate a " +</a>
<span class="sourceLineNo">219</span><a id="line.219"> "session could not be found.", sessionKey);</a>
<span class="sourceLineNo">220</span><a id="line.220"> return null;</a>
<span class="sourceLineNo">221</span><a id="line.221"> }</a>
<span class="sourceLineNo">222</span><a id="line.222"> Session s = retrieveSessionFromDataSource(sessionId);</a>
<span class="sourceLineNo">223</span><a id="line.223"> if (s == null) {</a>
<span class="sourceLineNo">224</span><a id="line.224"> //session ID was provided, meaning one is expected to be found, but we couldn't find one:</a>
<span class="sourceLineNo">225</span><a id="line.225"> String msg = "Could not find session with ID [" + sessionId + "]";</a>
<span class="sourceLineNo">226</span><a id="line.226"> throw new UnknownSessionException(msg);</a>
<span class="sourceLineNo">227</span><a id="line.227"> }</a>
<span class="sourceLineNo">228</span><a id="line.228"> return s;</a>
<span class="sourceLineNo">229</span><a id="line.229"> }</a>
<span class="sourceLineNo">230</span><a id="line.230"></a>
<span class="sourceLineNo">231</span><a id="line.231"> protected Serializable getSessionId(SessionKey sessionKey) {</a>
<span class="sourceLineNo">232</span><a id="line.232"> return sessionKey.getSessionId();</a>
<span class="sourceLineNo">233</span><a id="line.233"> }</a>
<span class="sourceLineNo">234</span><a id="line.234"></a>
<span class="sourceLineNo">235</span><a id="line.235"> protected Session retrieveSessionFromDataSource(Serializable sessionId) throws UnknownSessionException {</a>
<span class="sourceLineNo">236</span><a id="line.236"> return sessionDAO.readSession(sessionId);</a>
<span class="sourceLineNo">237</span><a id="line.237"> }</a>
<span class="sourceLineNo">238</span><a id="line.238"></a>
<span class="sourceLineNo">239</span><a id="line.239"> protected void delete(Session session) {</a>
<span class="sourceLineNo">240</span><a id="line.240"> sessionDAO.delete(session);</a>
<span class="sourceLineNo">241</span><a id="line.241"> }</a>
<span class="sourceLineNo">242</span><a id="line.242"></a>
<span class="sourceLineNo">243</span><a id="line.243"> protected Collection&lt;Session&gt; getActiveSessions() {</a>
<span class="sourceLineNo">244</span><a id="line.244"> Collection&lt;Session&gt; active = sessionDAO.getActiveSessions();</a>
<span class="sourceLineNo">245</span><a id="line.245"> return active != null ? active : Collections.&lt;Session&gt;emptySet();</a>
<span class="sourceLineNo">246</span><a id="line.246"> }</a>
<span class="sourceLineNo">247</span><a id="line.247"></a>
<span class="sourceLineNo">248</span><a id="line.248">}</a>
</pre>
</div>
</main>
</body>
</html>