Modified: websites/production/commons/content/proper/commons-daemon/apidocs/src-html/org/apache/commons/daemon/support/DaemonLoader.html ============================================================================== --- websites/production/commons/content/proper/commons-daemon/apidocs/src-html/org/apache/commons/daemon/support/DaemonLoader.html (original) +++ websites/production/commons/content/proper/commons-daemon/apidocs/src-html/org/apache/commons/daemon/support/DaemonLoader.html Fri May 24 09:43:12 2024 @@ -1,425 +1,426 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> +<!DOCTYPE HTML> <html lang="en"> <head> +<!-- Generated by javadoc (17) --> <title>Source code</title> +<meta name="viewport" content="width=device-width, initial-scale=1"> +<meta name="description" content="source: package: org.apache.commons.daemon.support, class: DaemonLoader"> +<meta name="generator" content="javadoc/SourceToHTMLConverter"> <link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style"> </head> -<body> -<div class="sourceContainer"> -<pre><span class="sourceLineNo">001</span>/*<a name="line.1"></a> -<span class="sourceLineNo">002</span> * Licensed to the Apache Software Foundation (ASF) under one or more<a name="line.2"></a> -<span class="sourceLineNo">003</span> * contributor license agreements. See the NOTICE file distributed with<a name="line.3"></a> -<span class="sourceLineNo">004</span> * this work for additional information regarding copyright ownership.<a name="line.4"></a> -<span class="sourceLineNo">005</span> * The ASF licenses this file to You under the Apache License, Version 2.0<a name="line.5"></a> -<span class="sourceLineNo">006</span> * (the "License"); you may not use this file except in compliance with<a name="line.6"></a> -<span class="sourceLineNo">007</span> * the License. You may obtain a copy of the License at<a name="line.7"></a> -<span class="sourceLineNo">008</span> *<a name="line.8"></a> -<span class="sourceLineNo">009</span> * http://www.apache.org/licenses/LICENSE-2.0<a name="line.9"></a> -<span class="sourceLineNo">010</span> *<a name="line.10"></a> -<span class="sourceLineNo">011</span> * Unless required by applicable law or agreed to in writing, software<a name="line.11"></a> -<span class="sourceLineNo">012</span> * distributed under the License is distributed on an "AS IS" BASIS,<a name="line.12"></a> -<span class="sourceLineNo">013</span> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<a name="line.13"></a> -<span class="sourceLineNo">014</span> * See the License for the specific language governing permissions and<a name="line.14"></a> -<span class="sourceLineNo">015</span> * limitations under the License.<a name="line.15"></a> -<span class="sourceLineNo">016</span> */<a name="line.16"></a> -<span class="sourceLineNo">017</span><a name="line.17"></a> -<span class="sourceLineNo">018</span>package org.apache.commons.daemon.support;<a name="line.18"></a> -<span class="sourceLineNo">019</span><a name="line.19"></a> -<span class="sourceLineNo">020</span>import org.apache.commons.daemon.DaemonContext;<a name="line.20"></a> -<span class="sourceLineNo">021</span>import org.apache.commons.daemon.DaemonController;<a name="line.21"></a> -<span class="sourceLineNo">022</span>import org.apache.commons.daemon.DaemonInitException;<a name="line.22"></a> -<span class="sourceLineNo">023</span><a name="line.23"></a> -<span class="sourceLineNo">024</span>import java.lang.reflect.InvocationTargetException;<a name="line.24"></a> -<span class="sourceLineNo">025</span>import java.lang.reflect.Method;<a name="line.25"></a> -<span class="sourceLineNo">026</span>import java.util.Objects;<a name="line.26"></a> -<span class="sourceLineNo">027</span><a name="line.27"></a> -<span class="sourceLineNo">028</span>/**<a name="line.28"></a> -<span class="sourceLineNo">029</span> * Used by jsvc for Daemon management.<a name="line.29"></a> -<span class="sourceLineNo">030</span> */<a name="line.30"></a> -<span class="sourceLineNo">031</span>public final class DaemonLoader<a name="line.31"></a> -<span class="sourceLineNo">032</span>{<a name="line.32"></a> -<span class="sourceLineNo">033</span><a name="line.33"></a> -<span class="sourceLineNo">034</span> // N.B. These static mutable variables need to be accessed using synch.<a name="line.34"></a> -<span class="sourceLineNo">035</span> private static Controller controller; //@GuardedBy("this")<a name="line.35"></a> -<span class="sourceLineNo">036</span> private static Object daemon; //@GuardedBy("this")<a name="line.36"></a> -<span class="sourceLineNo">037</span> /* Methods to call */<a name="line.37"></a> -<span class="sourceLineNo">038</span> private static Method init; //@GuardedBy("this")<a name="line.38"></a> -<span class="sourceLineNo">039</span> private static Method start; //@GuardedBy("this")<a name="line.39"></a> -<span class="sourceLineNo">040</span> private static Method stop; //@GuardedBy("this")<a name="line.40"></a> -<span class="sourceLineNo">041</span> private static Method destroy; //@GuardedBy("this")<a name="line.41"></a> -<span class="sourceLineNo">042</span> private static Method signal; //@GuardedBy("this")<a name="line.42"></a> -<span class="sourceLineNo">043</span><a name="line.43"></a> -<span class="sourceLineNo">044</span> public static void version()<a name="line.44"></a> -<span class="sourceLineNo">045</span> {<a name="line.45"></a> -<span class="sourceLineNo">046</span> System.err.println("java version \"" +<a name="line.46"></a> -<span class="sourceLineNo">047</span> System.getProperty("java.version") + "\"");<a name="line.47"></a> -<span class="sourceLineNo">048</span> System.err.println(System.getProperty("java.runtime.name") +<a name="line.48"></a> -<span class="sourceLineNo">049</span> " (build " +<a name="line.49"></a> -<span class="sourceLineNo">050</span> System.getProperty("java.runtime.version") + ")");<a name="line.50"></a> -<span class="sourceLineNo">051</span> System.err.println(System.getProperty("java.vm.name") +<a name="line.51"></a> -<span class="sourceLineNo">052</span> " (build " +<a name="line.52"></a> -<span class="sourceLineNo">053</span> System.getProperty("java.vm.version") +<a name="line.53"></a> -<span class="sourceLineNo">054</span> ", " + System.getProperty("java.vm.info") + ")");<a name="line.54"></a> -<span class="sourceLineNo">055</span> System.err.println("commons daemon version \"" +<a name="line.55"></a> -<span class="sourceLineNo">056</span> System.getProperty("commons.daemon.version") + "\"");<a name="line.56"></a> -<span class="sourceLineNo">057</span> System.err.println("commons daemon process (id: " +<a name="line.57"></a> -<span class="sourceLineNo">058</span> System.getProperty("commons.daemon.process.id") +<a name="line.58"></a> -<span class="sourceLineNo">059</span> ", parent: " +<a name="line.59"></a> -<span class="sourceLineNo">060</span> System.getProperty("commons.daemon.process.parent") + ")");<a name="line.60"></a> -<span class="sourceLineNo">061</span> }<a name="line.61"></a> -<span class="sourceLineNo">062</span><a name="line.62"></a> -<span class="sourceLineNo">063</span> public static boolean check(final String className)<a name="line.63"></a> -<span class="sourceLineNo">064</span> {<a name="line.64"></a> -<span class="sourceLineNo">065</span> try {<a name="line.65"></a> -<span class="sourceLineNo">066</span> /* Check the class name */<a name="line.66"></a> -<span class="sourceLineNo">067</span> Objects.requireNonNull(className, "className");<a name="line.67"></a> -<span class="sourceLineNo">068</span> /* Get the ClassLoader loading this class */<a name="line.68"></a> -<span class="sourceLineNo">069</span> final ClassLoader cl = DaemonLoader.class.getClassLoader();<a name="line.69"></a> -<span class="sourceLineNo">070</span> if (cl == null) {<a name="line.70"></a> -<span class="sourceLineNo">071</span> System.err.println("Cannot retrieve ClassLoader instance");<a name="line.71"></a> -<span class="sourceLineNo">072</span> return false;<a name="line.72"></a> -<span class="sourceLineNo">073</span> }<a name="line.73"></a> -<span class="sourceLineNo">074</span><a name="line.74"></a> -<span class="sourceLineNo">075</span> /* Find the required class */<a name="line.75"></a> -<span class="sourceLineNo">076</span> final Class<?> c = cl.loadClass(className);<a name="line.76"></a> -<span class="sourceLineNo">077</span><a name="line.77"></a> -<span class="sourceLineNo">078</span> /* This should _never_ happen, but double-checking doesn't harm */<a name="line.78"></a> -<span class="sourceLineNo">079</span> if (c == null) {<a name="line.79"></a> -<span class="sourceLineNo">080</span> throw new ClassNotFoundException(className);<a name="line.80"></a> -<span class="sourceLineNo">081</span> }<a name="line.81"></a> -<span class="sourceLineNo">082</span><a name="line.82"></a> -<span class="sourceLineNo">083</span> /* Create a new instance of the daemon */<a name="line.83"></a> -<span class="sourceLineNo">084</span> c.getConstructor().newInstance();<a name="line.84"></a> -<span class="sourceLineNo">085</span><a name="line.85"></a> -<span class="sourceLineNo">086</span> } catch (final Throwable t) {<a name="line.86"></a> -<span class="sourceLineNo">087</span> /* In case we encounter ANY error, we dump the stack trace and<a name="line.87"></a> -<span class="sourceLineNo">088</span> * return false (load, start and stop won't be called).<a name="line.88"></a> -<span class="sourceLineNo">089</span> */<a name="line.89"></a> -<span class="sourceLineNo">090</span> t.printStackTrace(System.err);<a name="line.90"></a> -<span class="sourceLineNo">091</span> return false;<a name="line.91"></a> -<span class="sourceLineNo">092</span> }<a name="line.92"></a> -<span class="sourceLineNo">093</span> /* The class was loaded and instantiated correctly, we can return<a name="line.93"></a> -<span class="sourceLineNo">094</span> */<a name="line.94"></a> -<span class="sourceLineNo">095</span> return true;<a name="line.95"></a> -<span class="sourceLineNo">096</span> }<a name="line.96"></a> -<span class="sourceLineNo">097</span><a name="line.97"></a> -<span class="sourceLineNo">098</span> public static boolean signal()<a name="line.98"></a> -<span class="sourceLineNo">099</span> {<a name="line.99"></a> -<span class="sourceLineNo">100</span> try {<a name="line.100"></a> -<span class="sourceLineNo">101</span> if (signal != null) {<a name="line.101"></a> -<span class="sourceLineNo">102</span> signal.invoke(daemon);<a name="line.102"></a> -<span class="sourceLineNo">103</span> return true;<a name="line.103"></a> -<span class="sourceLineNo">104</span> }<a name="line.104"></a> -<span class="sourceLineNo">105</span> System.out.println("Daemon doesn't support signaling");<a name="line.105"></a> -<span class="sourceLineNo">106</span> } catch (final Throwable ex) {<a name="line.106"></a> -<span class="sourceLineNo">107</span> System.err.println("Cannot send signal: " + ex);<a name="line.107"></a> -<span class="sourceLineNo">108</span> ex.printStackTrace(System.err);<a name="line.108"></a> -<span class="sourceLineNo">109</span> }<a name="line.109"></a> -<span class="sourceLineNo">110</span> return false;<a name="line.110"></a> -<span class="sourceLineNo">111</span> }<a name="line.111"></a> -<span class="sourceLineNo">112</span><a name="line.112"></a> -<span class="sourceLineNo">113</span> public static boolean load(final String className, String[] args)<a name="line.113"></a> -<span class="sourceLineNo">114</span> {<a name="line.114"></a> -<span class="sourceLineNo">115</span> try {<a name="line.115"></a> -<span class="sourceLineNo">116</span> /* Check if the underlying library supplied a valid list of<a name="line.116"></a> -<span class="sourceLineNo">117</span> arguments */<a name="line.117"></a> -<span class="sourceLineNo">118</span> if (args == null) {<a name="line.118"></a> -<span class="sourceLineNo">119</span> args = new String[0];<a name="line.119"></a> -<span class="sourceLineNo">120</span> }<a name="line.120"></a> -<span class="sourceLineNo">121</span><a name="line.121"></a> -<span class="sourceLineNo">122</span> /* Check the class name */<a name="line.122"></a> -<span class="sourceLineNo">123</span> Objects.requireNonNull(className, "className");<a name="line.123"></a> -<span class="sourceLineNo">124</span><a name="line.124"></a> -<span class="sourceLineNo">125</span> /* Get the ClassLoader loading this class */<a name="line.125"></a> -<span class="sourceLineNo">126</span> final ClassLoader cl = DaemonLoader.class.getClassLoader();<a name="line.126"></a> -<span class="sourceLineNo">127</span> if (cl == null) {<a name="line.127"></a> -<span class="sourceLineNo">128</span> System.err.println("Cannot retrieve ClassLoader instance");<a name="line.128"></a> -<span class="sourceLineNo">129</span> return false;<a name="line.129"></a> -<span class="sourceLineNo">130</span> }<a name="line.130"></a> -<span class="sourceLineNo">131</span> final Class<?> c;<a name="line.131"></a> -<span class="sourceLineNo">132</span> if (className.charAt(0) == '@') {<a name="line.132"></a> -<span class="sourceLineNo">133</span> /* Wrap the class with DaemonWrapper<a name="line.133"></a> -<span class="sourceLineNo">134</span> * and modify arguments to include the real class name.<a name="line.134"></a> -<span class="sourceLineNo">135</span> */<a name="line.135"></a> -<span class="sourceLineNo">136</span> c = DaemonWrapper.class;<a name="line.136"></a> -<span class="sourceLineNo">137</span> final String[] a = new String[args.length + 2];<a name="line.137"></a> -<span class="sourceLineNo">138</span> a[0] = "-start";<a name="line.138"></a> -<span class="sourceLineNo">139</span> a[1] = className.substring(1);<a name="line.139"></a> -<span class="sourceLineNo">140</span> System.arraycopy(args, 0, a, 2, args.length);<a name="line.140"></a> -<span class="sourceLineNo">141</span> args = a;<a name="line.141"></a> -<span class="sourceLineNo">142</span> }<a name="line.142"></a> -<span class="sourceLineNo">143</span> else {<a name="line.143"></a> -<span class="sourceLineNo">144</span> c = cl.loadClass(className);<a name="line.144"></a> -<span class="sourceLineNo">145</span> }<a name="line.145"></a> -<span class="sourceLineNo">146</span> /* This should _never_ happen, but double-checking doesn't harm */<a name="line.146"></a> -<span class="sourceLineNo">147</span> if (c == null) {<a name="line.147"></a> -<span class="sourceLineNo">148</span> throw new ClassNotFoundException(className);<a name="line.148"></a> -<span class="sourceLineNo">149</span> }<a name="line.149"></a> -<span class="sourceLineNo">150</span> /* Check interfaces */<a name="line.150"></a> -<span class="sourceLineNo">151</span> boolean isdaemon = false;<a name="line.151"></a> -<span class="sourceLineNo">152</span><a name="line.152"></a> -<span class="sourceLineNo">153</span> try {<a name="line.153"></a> -<span class="sourceLineNo">154</span> final Class<?> dclass = cl.loadClass("org.apache.commons.daemon.Daemon");<a name="line.154"></a> -<span class="sourceLineNo">155</span> isdaemon = dclass.isAssignableFrom(c);<a name="line.155"></a> -<span class="sourceLineNo">156</span> }<a name="line.156"></a> -<span class="sourceLineNo">157</span> catch (final Exception ignored) {<a name="line.157"></a> -<span class="sourceLineNo">158</span> // Swallow if Daemon not found.<a name="line.158"></a> -<span class="sourceLineNo">159</span> }<a name="line.159"></a> -<span class="sourceLineNo">160</span><a name="line.160"></a> -<span class="sourceLineNo">161</span> /* Check methods */<a name="line.161"></a> -<span class="sourceLineNo">162</span> final Class<?>[] myclass = new Class[1];<a name="line.162"></a> -<span class="sourceLineNo">163</span> if (isdaemon) {<a name="line.163"></a> -<span class="sourceLineNo">164</span> myclass[0] = DaemonContext.class;<a name="line.164"></a> -<span class="sourceLineNo">165</span> }<a name="line.165"></a> -<span class="sourceLineNo">166</span> else {<a name="line.166"></a> -<span class="sourceLineNo">167</span> myclass[0] = args.getClass();<a name="line.167"></a> -<span class="sourceLineNo">168</span> }<a name="line.168"></a> -<span class="sourceLineNo">169</span><a name="line.169"></a> -<span class="sourceLineNo">170</span> init = c.getMethod("init", myclass);<a name="line.170"></a> -<span class="sourceLineNo">171</span><a name="line.171"></a> -<span class="sourceLineNo">172</span> start = c.getMethod("start");<a name="line.172"></a> -<span class="sourceLineNo">173</span> stop = c.getMethod("stop");<a name="line.173"></a> -<span class="sourceLineNo">174</span> destroy = c.getMethod("destroy");<a name="line.174"></a> -<span class="sourceLineNo">175</span><a name="line.175"></a> -<span class="sourceLineNo">176</span> try {<a name="line.176"></a> -<span class="sourceLineNo">177</span> signal = c.getMethod("signal");<a name="line.177"></a> -<span class="sourceLineNo">178</span> } catch (final NoSuchMethodException ignored) {<a name="line.178"></a> -<span class="sourceLineNo">179</span> // Signalling will be disabled.<a name="line.179"></a> -<span class="sourceLineNo">180</span> }<a name="line.180"></a> -<span class="sourceLineNo">181</span><a name="line.181"></a> -<span class="sourceLineNo">182</span> /* Create a new instance of the daemon */<a name="line.182"></a> -<span class="sourceLineNo">183</span> daemon = c.getConstructor().newInstance();<a name="line.183"></a> -<span class="sourceLineNo">184</span><a name="line.184"></a> -<span class="sourceLineNo">185</span> if (isdaemon) {<a name="line.185"></a> -<span class="sourceLineNo">186</span> /* Create a new controller instance */<a name="line.186"></a> -<span class="sourceLineNo">187</span> controller = new Controller();<a name="line.187"></a> -<span class="sourceLineNo">188</span><a name="line.188"></a> -<span class="sourceLineNo">189</span> /* Set the availability flag in the controller */<a name="line.189"></a> -<span class="sourceLineNo">190</span> controller.setAvailable(false);<a name="line.190"></a> -<span class="sourceLineNo">191</span><a name="line.191"></a> -<span class="sourceLineNo">192</span> /* Create context */<a name="line.192"></a> -<span class="sourceLineNo">193</span> final Context context = new Context();<a name="line.193"></a> -<span class="sourceLineNo">194</span> context.setArguments(args);<a name="line.194"></a> -<span class="sourceLineNo">195</span> context.setController(controller);<a name="line.195"></a> -<span class="sourceLineNo">196</span><a name="line.196"></a> -<span class="sourceLineNo">197</span> /* Now we want to call the init method in the class */<a name="line.197"></a> -<span class="sourceLineNo">198</span> final Object[] arg = new Object[1];<a name="line.198"></a> -<span class="sourceLineNo">199</span> arg[0] = context;<a name="line.199"></a> -<span class="sourceLineNo">200</span> init.invoke(daemon, arg);<a name="line.200"></a> -<span class="sourceLineNo">201</span> }<a name="line.201"></a> -<span class="sourceLineNo">202</span> else {<a name="line.202"></a> -<span class="sourceLineNo">203</span> final Object[] arg = new Object[1];<a name="line.203"></a> -<span class="sourceLineNo">204</span> arg[0] = args;<a name="line.204"></a> -<span class="sourceLineNo">205</span> init.invoke(daemon, arg);<a name="line.205"></a> -<span class="sourceLineNo">206</span> }<a name="line.206"></a> -<span class="sourceLineNo">207</span><a name="line.207"></a> -<span class="sourceLineNo">208</span> }<a name="line.208"></a> -<span class="sourceLineNo">209</span> catch (final InvocationTargetException e) {<a name="line.209"></a> -<span class="sourceLineNo">210</span> final Throwable thrown = e.getTargetException();<a name="line.210"></a> -<span class="sourceLineNo">211</span> /* DaemonInitExceptions can fail with a nicer message */<a name="line.211"></a> -<span class="sourceLineNo">212</span> if (thrown instanceof DaemonInitException) {<a name="line.212"></a> -<span class="sourceLineNo">213</span> failed(((DaemonInitException) thrown).getMessageWithCause());<a name="line.213"></a> -<span class="sourceLineNo">214</span> }<a name="line.214"></a> -<span class="sourceLineNo">215</span> else {<a name="line.215"></a> -<span class="sourceLineNo">216</span> thrown.printStackTrace(System.err);<a name="line.216"></a> -<span class="sourceLineNo">217</span> }<a name="line.217"></a> -<span class="sourceLineNo">218</span> return false;<a name="line.218"></a> -<span class="sourceLineNo">219</span> }<a name="line.219"></a> -<span class="sourceLineNo">220</span> catch (final Throwable t) {<a name="line.220"></a> -<span class="sourceLineNo">221</span> /* In case we encounter ANY error, we dump the stack trace and<a name="line.221"></a> -<span class="sourceLineNo">222</span> * return false (load, start and stop won't be called).<a name="line.222"></a> -<span class="sourceLineNo">223</span> */<a name="line.223"></a> -<span class="sourceLineNo">224</span> t.printStackTrace(System.err);<a name="line.224"></a> -<span class="sourceLineNo">225</span> return false;<a name="line.225"></a> -<span class="sourceLineNo">226</span> }<a name="line.226"></a> -<span class="sourceLineNo">227</span> /* The class was loaded and instantiated correctly, we can return */<a name="line.227"></a> -<span class="sourceLineNo">228</span> return true;<a name="line.228"></a> -<span class="sourceLineNo">229</span> }<a name="line.229"></a> -<span class="sourceLineNo">230</span><a name="line.230"></a> -<span class="sourceLineNo">231</span> public static boolean start()<a name="line.231"></a> -<span class="sourceLineNo">232</span> {<a name="line.232"></a> -<span class="sourceLineNo">233</span> try {<a name="line.233"></a> -<span class="sourceLineNo">234</span> /* Attempt to start the daemon */<a name="line.234"></a> -<span class="sourceLineNo">235</span> start.invoke(daemon);<a name="line.235"></a> -<span class="sourceLineNo">236</span><a name="line.236"></a> -<span class="sourceLineNo">237</span> /* Set the availability flag in the controller */<a name="line.237"></a> -<span class="sourceLineNo">238</span> if (controller != null) {<a name="line.238"></a> -<span class="sourceLineNo">239</span> controller.setAvailable(true);<a name="line.239"></a> -<span class="sourceLineNo">240</span> }<a name="line.240"></a> -<span class="sourceLineNo">241</span><a name="line.241"></a> -<span class="sourceLineNo">242</span> } catch (final Throwable t) {<a name="line.242"></a> -<span class="sourceLineNo">243</span> /* In case we encounter ANY error, we dump the stack trace and<a name="line.243"></a> -<span class="sourceLineNo">244</span> * return false (load, start and stop won't be called).<a name="line.244"></a> -<span class="sourceLineNo">245</span> */<a name="line.245"></a> -<span class="sourceLineNo">246</span> t.printStackTrace(System.err);<a name="line.246"></a> -<span class="sourceLineNo">247</span> return false;<a name="line.247"></a> -<span class="sourceLineNo">248</span> }<a name="line.248"></a> -<span class="sourceLineNo">249</span> return true;<a name="line.249"></a> -<span class="sourceLineNo">250</span> }<a name="line.250"></a> -<span class="sourceLineNo">251</span><a name="line.251"></a> -<span class="sourceLineNo">252</span> public static boolean stop()<a name="line.252"></a> -<span class="sourceLineNo">253</span> {<a name="line.253"></a> -<span class="sourceLineNo">254</span> try {<a name="line.254"></a> -<span class="sourceLineNo">255</span> /* Set the availability flag in the controller */<a name="line.255"></a> -<span class="sourceLineNo">256</span> if (controller != null) {<a name="line.256"></a> -<span class="sourceLineNo">257</span> controller.setAvailable(false);<a name="line.257"></a> -<span class="sourceLineNo">258</span> }<a name="line.258"></a> -<span class="sourceLineNo">259</span><a name="line.259"></a> -<span class="sourceLineNo">260</span> /* Attempt to stop the daemon */<a name="line.260"></a> -<span class="sourceLineNo">261</span> stop.invoke(daemon);<a name="line.261"></a> -<span class="sourceLineNo">262</span> }<a name="line.262"></a> -<span class="sourceLineNo">263</span> catch (final Throwable t) {<a name="line.263"></a> -<span class="sourceLineNo">264</span> /* In case we encounter ANY error, we dump the stack trace and<a name="line.264"></a> -<span class="sourceLineNo">265</span> * return false (load, start and stop won't be called).<a name="line.265"></a> -<span class="sourceLineNo">266</span> */<a name="line.266"></a> -<span class="sourceLineNo">267</span> t.printStackTrace(System.err);<a name="line.267"></a> -<span class="sourceLineNo">268</span> return false;<a name="line.268"></a> -<span class="sourceLineNo">269</span> }<a name="line.269"></a> -<span class="sourceLineNo">270</span> return true;<a name="line.270"></a> -<span class="sourceLineNo">271</span> }<a name="line.271"></a> -<span class="sourceLineNo">272</span><a name="line.272"></a> -<span class="sourceLineNo">273</span> public static boolean destroy()<a name="line.273"></a> -<span class="sourceLineNo">274</span> {<a name="line.274"></a> -<span class="sourceLineNo">275</span> try {<a name="line.275"></a> -<span class="sourceLineNo">276</span> /* Attempt to stop the daemon */<a name="line.276"></a> -<span class="sourceLineNo">277</span> destroy.invoke(daemon);<a name="line.277"></a> -<span class="sourceLineNo">278</span><a name="line.278"></a> -<span class="sourceLineNo">279</span> daemon = null;<a name="line.279"></a> -<span class="sourceLineNo">280</span> controller = null;<a name="line.280"></a> -<span class="sourceLineNo">281</span> } catch (final Throwable t) {<a name="line.281"></a> -<span class="sourceLineNo">282</span> /* In case we encounter ANY error, we dump the stack trace and<a name="line.282"></a> -<span class="sourceLineNo">283</span> * return false (load, start and stop won't be called).<a name="line.283"></a> -<span class="sourceLineNo">284</span> */<a name="line.284"></a> -<span class="sourceLineNo">285</span> t.printStackTrace(System.err);<a name="line.285"></a> -<span class="sourceLineNo">286</span> return false;<a name="line.286"></a> -<span class="sourceLineNo">287</span> }<a name="line.287"></a> -<span class="sourceLineNo">288</span> return true;<a name="line.288"></a> -<span class="sourceLineNo">289</span> }<a name="line.289"></a> -<span class="sourceLineNo">290</span><a name="line.290"></a> -<span class="sourceLineNo">291</span> private static native void shutdown(boolean reload);<a name="line.291"></a> -<span class="sourceLineNo">292</span> private static native void failed(String message);<a name="line.292"></a> -<span class="sourceLineNo">293</span><a name="line.293"></a> -<span class="sourceLineNo">294</span> public static class Controller<a name="line.294"></a> -<span class="sourceLineNo">295</span> implements DaemonController<a name="line.295"></a> -<span class="sourceLineNo">296</span> {<a name="line.296"></a> -<span class="sourceLineNo">297</span><a name="line.297"></a> -<span class="sourceLineNo">298</span> private boolean available;<a name="line.298"></a> -<span class="sourceLineNo">299</span><a name="line.299"></a> -<span class="sourceLineNo">300</span> private Controller()<a name="line.300"></a> -<span class="sourceLineNo">301</span> {<a name="line.301"></a> -<span class="sourceLineNo">302</span> this.setAvailable(false);<a name="line.302"></a> -<span class="sourceLineNo">303</span> }<a name="line.303"></a> -<span class="sourceLineNo">304</span><a name="line.304"></a> -<span class="sourceLineNo">305</span> private boolean isAvailable()<a name="line.305"></a> -<span class="sourceLineNo">306</span> {<a name="line.306"></a> -<span class="sourceLineNo">307</span> synchronized (this) {<a name="line.307"></a> -<span class="sourceLineNo">308</span> return this.available;<a name="line.308"></a> -<span class="sourceLineNo">309</span> }<a name="line.309"></a> -<span class="sourceLineNo">310</span> }<a name="line.310"></a> -<span class="sourceLineNo">311</span><a name="line.311"></a> -<span class="sourceLineNo">312</span> private void setAvailable(final boolean available)<a name="line.312"></a> -<span class="sourceLineNo">313</span> {<a name="line.313"></a> -<span class="sourceLineNo">314</span> synchronized (this) {<a name="line.314"></a> -<span class="sourceLineNo">315</span> this.available = available;<a name="line.315"></a> -<span class="sourceLineNo">316</span> }<a name="line.316"></a> -<span class="sourceLineNo">317</span> }<a name="line.317"></a> -<span class="sourceLineNo">318</span><a name="line.318"></a> -<span class="sourceLineNo">319</span> @Override<a name="line.319"></a> -<span class="sourceLineNo">320</span> public void shutdown()<a name="line.320"></a> -<span class="sourceLineNo">321</span> throws IllegalStateException<a name="line.321"></a> -<span class="sourceLineNo">322</span> {<a name="line.322"></a> -<span class="sourceLineNo">323</span> synchronized (this) {<a name="line.323"></a> -<span class="sourceLineNo">324</span> if (!this.isAvailable()) {<a name="line.324"></a> -<span class="sourceLineNo">325</span> throw new IllegalStateException();<a name="line.325"></a> -<span class="sourceLineNo">326</span> }<a name="line.326"></a> -<span class="sourceLineNo">327</span> this.setAvailable(false);<a name="line.327"></a> -<span class="sourceLineNo">328</span> DaemonLoader.shutdown(false);<a name="line.328"></a> -<span class="sourceLineNo">329</span> }<a name="line.329"></a> -<span class="sourceLineNo">330</span> }<a name="line.330"></a> -<span class="sourceLineNo">331</span><a name="line.331"></a> -<span class="sourceLineNo">332</span> @Override<a name="line.332"></a> -<span class="sourceLineNo">333</span> public void reload()<a name="line.333"></a> -<span class="sourceLineNo">334</span> throws IllegalStateException<a name="line.334"></a> -<span class="sourceLineNo">335</span> {<a name="line.335"></a> -<span class="sourceLineNo">336</span> synchronized (this) {<a name="line.336"></a> -<span class="sourceLineNo">337</span> if (!this.isAvailable()) {<a name="line.337"></a> -<span class="sourceLineNo">338</span> throw new IllegalStateException();<a name="line.338"></a> -<span class="sourceLineNo">339</span> }<a name="line.339"></a> -<span class="sourceLineNo">340</span> this.setAvailable(false);<a name="line.340"></a> -<span class="sourceLineNo">341</span> DaemonLoader.shutdown(true);<a name="line.341"></a> -<span class="sourceLineNo">342</span> }<a name="line.342"></a> -<span class="sourceLineNo">343</span> }<a name="line.343"></a> -<span class="sourceLineNo">344</span><a name="line.344"></a> -<span class="sourceLineNo">345</span> @Override<a name="line.345"></a> -<span class="sourceLineNo">346</span> public void fail()<a name="line.346"></a> -<span class="sourceLineNo">347</span> {<a name="line.347"></a> -<span class="sourceLineNo">348</span> fail(null, null);<a name="line.348"></a> -<span class="sourceLineNo">349</span> }<a name="line.349"></a> -<span class="sourceLineNo">350</span><a name="line.350"></a> -<span class="sourceLineNo">351</span> @Override<a name="line.351"></a> -<span class="sourceLineNo">352</span> public void fail(final String message)<a name="line.352"></a> -<span class="sourceLineNo">353</span> {<a name="line.353"></a> -<span class="sourceLineNo">354</span> fail(message, null);<a name="line.354"></a> -<span class="sourceLineNo">355</span> }<a name="line.355"></a> -<span class="sourceLineNo">356</span><a name="line.356"></a> -<span class="sourceLineNo">357</span> @Override<a name="line.357"></a> -<span class="sourceLineNo">358</span> public void fail(final Exception exception)<a name="line.358"></a> -<span class="sourceLineNo">359</span> {<a name="line.359"></a> -<span class="sourceLineNo">360</span> fail(null, exception);<a name="line.360"></a> -<span class="sourceLineNo">361</span> }<a name="line.361"></a> -<span class="sourceLineNo">362</span><a name="line.362"></a> -<span class="sourceLineNo">363</span> @Override<a name="line.363"></a> -<span class="sourceLineNo">364</span> public void fail(final String message, final Exception exception)<a name="line.364"></a> -<span class="sourceLineNo">365</span> {<a name="line.365"></a> -<span class="sourceLineNo">366</span> synchronized (this) {<a name="line.366"></a> -<span class="sourceLineNo">367</span> this.setAvailable(false);<a name="line.367"></a> -<span class="sourceLineNo">368</span> String msg = message;<a name="line.368"></a> -<span class="sourceLineNo">369</span> if (exception != null) {<a name="line.369"></a> -<span class="sourceLineNo">370</span> if (msg != null) {<a name="line.370"></a> -<span class="sourceLineNo">371</span> msg = msg + ": " + exception.toString();<a name="line.371"></a> -<span class="sourceLineNo">372</span> }<a name="line.372"></a> -<span class="sourceLineNo">373</span> else {<a name="line.373"></a> -<span class="sourceLineNo">374</span> msg = exception.toString();<a name="line.374"></a> -<span class="sourceLineNo">375</span> }<a name="line.375"></a> -<span class="sourceLineNo">376</span> }<a name="line.376"></a> -<span class="sourceLineNo">377</span> DaemonLoader.failed(msg);<a name="line.377"></a> -<span class="sourceLineNo">378</span> }<a name="line.378"></a> -<span class="sourceLineNo">379</span> }<a name="line.379"></a> -<span class="sourceLineNo">380</span><a name="line.380"></a> -<span class="sourceLineNo">381</span> }<a name="line.381"></a> -<span class="sourceLineNo">382</span><a name="line.382"></a> -<span class="sourceLineNo">383</span> public static class Context<a name="line.383"></a> -<span class="sourceLineNo">384</span> implements DaemonContext<a name="line.384"></a> -<span class="sourceLineNo">385</span> {<a name="line.385"></a> -<span class="sourceLineNo">386</span><a name="line.386"></a> -<span class="sourceLineNo">387</span> private DaemonController daemonController;<a name="line.387"></a> -<span class="sourceLineNo">388</span><a name="line.388"></a> -<span class="sourceLineNo">389</span> private String[] args;<a name="line.389"></a> -<span class="sourceLineNo">390</span><a name="line.390"></a> -<span class="sourceLineNo">391</span> @Override<a name="line.391"></a> -<span class="sourceLineNo">392</span> public DaemonController getController()<a name="line.392"></a> -<span class="sourceLineNo">393</span> {<a name="line.393"></a> -<span class="sourceLineNo">394</span> return daemonController;<a name="line.394"></a> -<span class="sourceLineNo">395</span> }<a name="line.395"></a> -<span class="sourceLineNo">396</span><a name="line.396"></a> -<span class="sourceLineNo">397</span> public void setController(final DaemonController controller)<a name="line.397"></a> -<span class="sourceLineNo">398</span> {<a name="line.398"></a> -<span class="sourceLineNo">399</span> this.daemonController = controller;<a name="line.399"></a> -<span class="sourceLineNo">400</span> }<a name="line.400"></a> -<span class="sourceLineNo">401</span><a name="line.401"></a> -<span class="sourceLineNo">402</span> @Override<a name="line.402"></a> -<span class="sourceLineNo">403</span> public String[] getArguments()<a name="line.403"></a> -<span class="sourceLineNo">404</span> {<a name="line.404"></a> -<span class="sourceLineNo">405</span> return args;<a name="line.405"></a> -<span class="sourceLineNo">406</span> }<a name="line.406"></a> -<span class="sourceLineNo">407</span><a name="line.407"></a> -<span class="sourceLineNo">408</span> public void setArguments(final String[]args)<a name="line.408"></a> -<span class="sourceLineNo">409</span> {<a name="line.409"></a> -<span class="sourceLineNo">410</span> this.args = args;<a name="line.410"></a> -<span class="sourceLineNo">411</span> }<a name="line.411"></a> -<span class="sourceLineNo">412</span><a name="line.412"></a> -<span class="sourceLineNo">413</span> }<a name="line.413"></a> -<span class="sourceLineNo">414</span>}<a name="line.414"></a> +<body class="source-page"> +<main role="main"> +<div class="source-container"> +<pre><span class="source-line-no">001</span><span id="line-1">/*</span> +<span class="source-line-no">002</span><span id="line-2"> * Licensed to the Apache Software Foundation (ASF) under one or more</span> +<span class="source-line-no">003</span><span id="line-3"> * contributor license agreements. See the NOTICE file distributed with</span> +<span class="source-line-no">004</span><span id="line-4"> * this work for additional information regarding copyright ownership.</span> +<span class="source-line-no">005</span><span id="line-5"> * The ASF licenses this file to You under the Apache License, Version 2.0</span> +<span class="source-line-no">006</span><span id="line-6"> * (the "License"); you may not use this file except in compliance with</span> +<span class="source-line-no">007</span><span id="line-7"> * the License. You may obtain a copy of the License at</span> +<span class="source-line-no">008</span><span id="line-8"> *</span> +<span class="source-line-no">009</span><span id="line-9"> * http://www.apache.org/licenses/LICENSE-2.0</span> +<span class="source-line-no">010</span><span id="line-10"> *</span> +<span class="source-line-no">011</span><span id="line-11"> * Unless required by applicable law or agreed to in writing, software</span> +<span class="source-line-no">012</span><span id="line-12"> * distributed under the License is distributed on an "AS IS" BASIS,</span> +<span class="source-line-no">013</span><span id="line-13"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span> +<span class="source-line-no">014</span><span id="line-14"> * See the License for the specific language governing permissions and</span> +<span class="source-line-no">015</span><span id="line-15"> * limitations under the License.</span> +<span class="source-line-no">016</span><span id="line-16"> */</span> +<span class="source-line-no">017</span><span id="line-17"></span> +<span class="source-line-no">018</span><span id="line-18">package org.apache.commons.daemon.support;</span> +<span class="source-line-no">019</span><span id="line-19"></span> +<span class="source-line-no">020</span><span id="line-20">import org.apache.commons.daemon.DaemonContext;</span> +<span class="source-line-no">021</span><span id="line-21">import org.apache.commons.daemon.DaemonController;</span> +<span class="source-line-no">022</span><span id="line-22">import org.apache.commons.daemon.DaemonInitException;</span> +<span class="source-line-no">023</span><span id="line-23"></span> +<span class="source-line-no">024</span><span id="line-24">import java.lang.reflect.InvocationTargetException;</span> +<span class="source-line-no">025</span><span id="line-25">import java.lang.reflect.Method;</span> +<span class="source-line-no">026</span><span id="line-26">import java.util.Objects;</span> +<span class="source-line-no">027</span><span id="line-27"></span> +<span class="source-line-no">028</span><span id="line-28">/**</span> +<span class="source-line-no">029</span><span id="line-29"> * Used by jsvc for Daemon management.</span> +<span class="source-line-no">030</span><span id="line-30"> */</span> +<span class="source-line-no">031</span><span id="line-31">public final class DaemonLoader</span> +<span class="source-line-no">032</span><span id="line-32">{</span> +<span class="source-line-no">033</span><span id="line-33"></span> +<span class="source-line-no">034</span><span id="line-34"> // N.B. These static mutable variables need to be accessed using synch.</span> +<span class="source-line-no">035</span><span id="line-35"> private static Controller controller; //@GuardedBy("this")</span> +<span class="source-line-no">036</span><span id="line-36"> private static Object daemon; //@GuardedBy("this")</span> +<span class="source-line-no">037</span><span id="line-37"> /* Methods to call */</span> +<span class="source-line-no">038</span><span id="line-38"> private static Method init; //@GuardedBy("this")</span> +<span class="source-line-no">039</span><span id="line-39"> private static Method start; //@GuardedBy("this")</span> +<span class="source-line-no">040</span><span id="line-40"> private static Method stop; //@GuardedBy("this")</span> +<span class="source-line-no">041</span><span id="line-41"> private static Method destroy; //@GuardedBy("this")</span> +<span class="source-line-no">042</span><span id="line-42"> private static Method signal; //@GuardedBy("this")</span> +<span class="source-line-no">043</span><span id="line-43"></span> +<span class="source-line-no">044</span><span id="line-44"> public static void version()</span> +<span class="source-line-no">045</span><span id="line-45"> {</span> +<span class="source-line-no">046</span><span id="line-46"> System.err.println("java version \"" +</span> +<span class="source-line-no">047</span><span id="line-47"> System.getProperty("java.version") + "\"");</span> +<span class="source-line-no">048</span><span id="line-48"> System.err.println(System.getProperty("java.runtime.name") +</span> +<span class="source-line-no">049</span><span id="line-49"> " (build " +</span> +<span class="source-line-no">050</span><span id="line-50"> System.getProperty("java.runtime.version") + ")");</span> +<span class="source-line-no">051</span><span id="line-51"> System.err.println(System.getProperty("java.vm.name") +</span> +<span class="source-line-no">052</span><span id="line-52"> " (build " +</span> +<span class="source-line-no">053</span><span id="line-53"> System.getProperty("java.vm.version") +</span> +<span class="source-line-no">054</span><span id="line-54"> ", " + System.getProperty("java.vm.info") + ")");</span> +<span class="source-line-no">055</span><span id="line-55"> System.err.println("commons daemon version \"" +</span> +<span class="source-line-no">056</span><span id="line-56"> System.getProperty("commons.daemon.version") + "\"");</span> +<span class="source-line-no">057</span><span id="line-57"> System.err.println("commons daemon process (id: " +</span> +<span class="source-line-no">058</span><span id="line-58"> System.getProperty("commons.daemon.process.id") +</span> +<span class="source-line-no">059</span><span id="line-59"> ", parent: " +</span> +<span class="source-line-no">060</span><span id="line-60"> System.getProperty("commons.daemon.process.parent") + ")");</span> +<span class="source-line-no">061</span><span id="line-61"> }</span> +<span class="source-line-no">062</span><span id="line-62"></span> +<span class="source-line-no">063</span><span id="line-63"> public static boolean check(final String className)</span> +<span class="source-line-no">064</span><span id="line-64"> {</span> +<span class="source-line-no">065</span><span id="line-65"> try {</span> +<span class="source-line-no">066</span><span id="line-66"> /* Check the class name */</span> +<span class="source-line-no">067</span><span id="line-67"> Objects.requireNonNull(className, "className");</span> +<span class="source-line-no">068</span><span id="line-68"> /* Gets the ClassLoader loading this class */</span> +<span class="source-line-no">069</span><span id="line-69"> final ClassLoader cl = DaemonLoader.class.getClassLoader();</span> +<span class="source-line-no">070</span><span id="line-70"> if (cl == null) {</span> +<span class="source-line-no">071</span><span id="line-71"> System.err.println("Cannot retrieve ClassLoader instance");</span> +<span class="source-line-no">072</span><span id="line-72"> return false;</span> +<span class="source-line-no">073</span><span id="line-73"> }</span> +<span class="source-line-no">074</span><span id="line-74"></span> +<span class="source-line-no">075</span><span id="line-75"> /* Find the required class */</span> +<span class="source-line-no">076</span><span id="line-76"> final Class<?> c = cl.loadClass(className);</span> +<span class="source-line-no">077</span><span id="line-77"></span> +<span class="source-line-no">078</span><span id="line-78"> /* This should _never_ happen, but double-checking doesn't harm */</span> +<span class="source-line-no">079</span><span id="line-79"> if (c == null) {</span> +<span class="source-line-no">080</span><span id="line-80"> throw new ClassNotFoundException(className);</span> +<span class="source-line-no">081</span><span id="line-81"> }</span> +<span class="source-line-no">082</span><span id="line-82"></span> +<span class="source-line-no">083</span><span id="line-83"> /* Create a new instance of the daemon */</span> +<span class="source-line-no">084</span><span id="line-84"> c.getConstructor().newInstance();</span> +<span class="source-line-no">085</span><span id="line-85"></span> +<span class="source-line-no">086</span><span id="line-86"> } catch (final Throwable t) {</span> +<span class="source-line-no">087</span><span id="line-87"> /* In case we encounter ANY error, we dump the stack trace and</span> +<span class="source-line-no">088</span><span id="line-88"> * return false (load, start and stop won't be called).</span> +<span class="source-line-no">089</span><span id="line-89"> */</span> +<span class="source-line-no">090</span><span id="line-90"> t.printStackTrace(System.err);</span> +<span class="source-line-no">091</span><span id="line-91"> return false;</span> +<span class="source-line-no">092</span><span id="line-92"> }</span> +<span class="source-line-no">093</span><span id="line-93"> /* The class was loaded and instantiated correctly, we can return</span> +<span class="source-line-no">094</span><span id="line-94"> */</span> +<span class="source-line-no">095</span><span id="line-95"> return true;</span> +<span class="source-line-no">096</span><span id="line-96"> }</span> +<span class="source-line-no">097</span><span id="line-97"></span> +<span class="source-line-no">098</span><span id="line-98"> public static boolean signal()</span> +<span class="source-line-no">099</span><span id="line-99"> {</span> +<span class="source-line-no">100</span><span id="line-100"> try {</span> +<span class="source-line-no">101</span><span id="line-101"> if (signal != null) {</span> +<span class="source-line-no">102</span><span id="line-102"> signal.invoke(daemon);</span> +<span class="source-line-no">103</span><span id="line-103"> return true;</span> +<span class="source-line-no">104</span><span id="line-104"> }</span> +<span class="source-line-no">105</span><span id="line-105"> System.out.println("Daemon doesn't support signaling");</span> +<span class="source-line-no">106</span><span id="line-106"> } catch (final Throwable ex) {</span> +<span class="source-line-no">107</span><span id="line-107"> System.err.println("Cannot send signal: " + ex);</span> +<span class="source-line-no">108</span><span id="line-108"> ex.printStackTrace(System.err);</span> +<span class="source-line-no">109</span><span id="line-109"> }</span> +<span class="source-line-no">110</span><span id="line-110"> return false;</span> +<span class="source-line-no">111</span><span id="line-111"> }</span> +<span class="source-line-no">112</span><span id="line-112"></span> +<span class="source-line-no">113</span><span id="line-113"> public static boolean load(final String className, String[] args)</span> +<span class="source-line-no">114</span><span id="line-114"> {</span> +<span class="source-line-no">115</span><span id="line-115"> try {</span> +<span class="source-line-no">116</span><span id="line-116"> /* Check if the underlying library supplied a valid list of</span> +<span class="source-line-no">117</span><span id="line-117"> arguments */</span> +<span class="source-line-no">118</span><span id="line-118"> if (args == null) {</span> +<span class="source-line-no">119</span><span id="line-119"> args = new String[0];</span> +<span class="source-line-no">120</span><span id="line-120"> }</span> +<span class="source-line-no">121</span><span id="line-121"></span> +<span class="source-line-no">122</span><span id="line-122"> /* Check the class name */</span> +<span class="source-line-no">123</span><span id="line-123"> Objects.requireNonNull(className, "className");</span> +<span class="source-line-no">124</span><span id="line-124"></span> +<span class="source-line-no">125</span><span id="line-125"> /* Gets the ClassLoader loading this class */</span> +<span class="source-line-no">126</span><span id="line-126"> final ClassLoader cl = DaemonLoader.class.getClassLoader();</span> +<span class="source-line-no">127</span><span id="line-127"> if (cl == null) {</span> +<span class="source-line-no">128</span><span id="line-128"> System.err.println("Cannot retrieve ClassLoader instance");</span> +<span class="source-line-no">129</span><span id="line-129"> return false;</span> +<span class="source-line-no">130</span><span id="line-130"> }</span> +<span class="source-line-no">131</span><span id="line-131"> final Class<?> c;</span> +<span class="source-line-no">132</span><span id="line-132"> if (className.charAt(0) == '@') {</span> +<span class="source-line-no">133</span><span id="line-133"> /* Wrap the class with DaemonWrapper</span> +<span class="source-line-no">134</span><span id="line-134"> * and modify arguments to include the real class name.</span> +<span class="source-line-no">135</span><span id="line-135"> */</span> +<span class="source-line-no">136</span><span id="line-136"> c = DaemonWrapper.class;</span> +<span class="source-line-no">137</span><span id="line-137"> final String[] a = new String[args.length + 2];</span> +<span class="source-line-no">138</span><span id="line-138"> a[0] = "-start";</span> +<span class="source-line-no">139</span><span id="line-139"> a[1] = className.substring(1);</span> +<span class="source-line-no">140</span><span id="line-140"> System.arraycopy(args, 0, a, 2, args.length);</span> +<span class="source-line-no">141</span><span id="line-141"> args = a;</span> +<span class="source-line-no">142</span><span id="line-142"> }</span> +<span class="source-line-no">143</span><span id="line-143"> else {</span> +<span class="source-line-no">144</span><span id="line-144"> c = cl.loadClass(className);</span> +<span class="source-line-no">145</span><span id="line-145"> }</span> +<span class="source-line-no">146</span><span id="line-146"> /* This should _never_ happen, but double-checking doesn't harm */</span> +<span class="source-line-no">147</span><span id="line-147"> if (c == null) {</span> +<span class="source-line-no">148</span><span id="line-148"> throw new ClassNotFoundException(className);</span> +<span class="source-line-no">149</span><span id="line-149"> }</span> +<span class="source-line-no">150</span><span id="line-150"> /* Check interfaces */</span> +<span class="source-line-no">151</span><span id="line-151"> boolean isdaemon = false;</span> +<span class="source-line-no">152</span><span id="line-152"></span> +<span class="source-line-no">153</span><span id="line-153"> try {</span> +<span class="source-line-no">154</span><span id="line-154"> final Class<?> dclass = cl.loadClass("org.apache.commons.daemon.Daemon");</span> +<span class="source-line-no">155</span><span id="line-155"> isdaemon = dclass.isAssignableFrom(c);</span> +<span class="source-line-no">156</span><span id="line-156"> }</span> +<span class="source-line-no">157</span><span id="line-157"> catch (final Exception ignored) {</span> +<span class="source-line-no">158</span><span id="line-158"> // Swallow if Daemon not found.</span> +<span class="source-line-no">159</span><span id="line-159"> }</span> +<span class="source-line-no">160</span><span id="line-160"></span> +<span class="source-line-no">161</span><span id="line-161"> /* Check methods */</span> +<span class="source-line-no">162</span><span id="line-162"> final Class<?>[] myclass = new Class[1];</span> +<span class="source-line-no">163</span><span id="line-163"> if (isdaemon) {</span> +<span class="source-line-no">164</span><span id="line-164"> myclass[0] = DaemonContext.class;</span> +<span class="source-line-no">165</span><span id="line-165"> }</span> +<span class="source-line-no">166</span><span id="line-166"> else {</span> +<span class="source-line-no">167</span><span id="line-167"> myclass[0] = args.getClass();</span> +<span class="source-line-no">168</span><span id="line-168"> }</span> +<span class="source-line-no">169</span><span id="line-169"></span> +<span class="source-line-no">170</span><span id="line-170"> init = c.getMethod("init", myclass);</span> +<span class="source-line-no">171</span><span id="line-171"></span> +<span class="source-line-no">172</span><span id="line-172"> start = c.getMethod("start");</span> +<span class="source-line-no">173</span><span id="line-173"> stop = c.getMethod("stop");</span> +<span class="source-line-no">174</span><span id="line-174"> destroy = c.getMethod("destroy");</span> +<span class="source-line-no">175</span><span id="line-175"></span> +<span class="source-line-no">176</span><span id="line-176"> try {</span> +<span class="source-line-no">177</span><span id="line-177"> signal = c.getMethod("signal");</span> +<span class="source-line-no">178</span><span id="line-178"> } catch (final NoSuchMethodException ignored) {</span> +<span class="source-line-no">179</span><span id="line-179"> // Signalling will be disabled.</span> +<span class="source-line-no">180</span><span id="line-180"> }</span> +<span class="source-line-no">181</span><span id="line-181"></span> +<span class="source-line-no">182</span><span id="line-182"> /* Create a new instance of the daemon */</span> +<span class="source-line-no">183</span><span id="line-183"> daemon = c.getConstructor().newInstance();</span> +<span class="source-line-no">184</span><span id="line-184"></span> +<span class="source-line-no">185</span><span id="line-185"> if (isdaemon) {</span> +<span class="source-line-no">186</span><span id="line-186"> // Create a new controller instance</span> +<span class="source-line-no">187</span><span id="line-187"> controller = new Controller();</span> +<span class="source-line-no">188</span><span id="line-188"></span> +<span class="source-line-no">189</span><span id="line-189"> // Set the availability flag in the controller</span> +<span class="source-line-no">190</span><span id="line-190"> controller.setAvailable(false);</span> +<span class="source-line-no">191</span><span id="line-191"></span> +<span class="source-line-no">192</span><span id="line-192"> /* Create context */</span> +<span class="source-line-no">193</span><span id="line-193"> final Context context = new Context();</span> +<span class="source-line-no">194</span><span id="line-194"> context.setArguments(args);</span> +<span class="source-line-no">195</span><span id="line-195"> context.setController(controller);</span> +<span class="source-line-no">196</span><span id="line-196"></span> +<span class="source-line-no">197</span><span id="line-197"> // Now we want to call the init method in the class</span> +<span class="source-line-no">198</span><span id="line-198"> final Object[] arg = new Object[1];</span> +<span class="source-line-no">199</span><span id="line-199"> arg[0] = context;</span> +<span class="source-line-no">200</span><span id="line-200"> init.invoke(daemon, arg);</span> +<span class="source-line-no">201</span><span id="line-201"> }</span> +<span class="source-line-no">202</span><span id="line-202"> else {</span> +<span class="source-line-no">203</span><span id="line-203"> final Object[] arg = new Object[1];</span> +<span class="source-line-no">204</span><span id="line-204"> arg[0] = args;</span> +<span class="source-line-no">205</span><span id="line-205"> init.invoke(daemon, arg);</span> +<span class="source-line-no">206</span><span id="line-206"> }</span> +<span class="source-line-no">207</span><span id="line-207"></span> +<span class="source-line-no">208</span><span id="line-208"> }</span> +<span class="source-line-no">209</span><span id="line-209"> catch (final InvocationTargetException e) {</span> +<span class="source-line-no">210</span><span id="line-210"> final Throwable thrown = e.getTargetException();</span> +<span class="source-line-no">211</span><span id="line-211"> // DaemonInitExceptions can fail with a nicer message</span> +<span class="source-line-no">212</span><span id="line-212"> if (thrown instanceof DaemonInitException) {</span> +<span class="source-line-no">213</span><span id="line-213"> failed(((DaemonInitException) thrown).getMessageWithCause());</span> +<span class="source-line-no">214</span><span id="line-214"> }</span> +<span class="source-line-no">215</span><span id="line-215"> else {</span> +<span class="source-line-no">216</span><span id="line-216"> thrown.printStackTrace(System.err);</span> +<span class="source-line-no">217</span><span id="line-217"> }</span> +<span class="source-line-no">218</span><span id="line-218"> return false;</span> +<span class="source-line-no">219</span><span id="line-219"> }</span> +<span class="source-line-no">220</span><span id="line-220"> catch (final Throwable t) {</span> +<span class="source-line-no">221</span><span id="line-221"> // In case we encounter ANY error, we dump the stack trace and</span> +<span class="source-line-no">222</span><span id="line-222"> // return false (load, start and stop won't be called).</span> +<span class="source-line-no">223</span><span id="line-223"> t.printStackTrace(System.err);</span> +<span class="source-line-no">224</span><span id="line-224"> return false;</span> +<span class="source-line-no">225</span><span id="line-225"> }</span> +<span class="source-line-no">226</span><span id="line-226"> // The class was loaded and instantiated correctly, we can return</span> +<span class="source-line-no">227</span><span id="line-227"> return true;</span> +<span class="source-line-no">228</span><span id="line-228"> }</span> +<span class="source-line-no">229</span><span id="line-229"></span> +<span class="source-line-no">230</span><span id="line-230"> public static boolean start()</span> +<span class="source-line-no">231</span><span id="line-231"> {</span> +<span class="source-line-no">232</span><span id="line-232"> try {</span> +<span class="source-line-no">233</span><span id="line-233"> // Attempt to start the daemon</span> +<span class="source-line-no">234</span><span id="line-234"> start.invoke(daemon);</span> +<span class="source-line-no">235</span><span id="line-235"></span> +<span class="source-line-no">236</span><span id="line-236"> // Set the availability flag in the controller</span> +<span class="source-line-no">237</span><span id="line-237"> if (controller != null) {</span> +<span class="source-line-no">238</span><span id="line-238"> controller.setAvailable(true);</span> +<span class="source-line-no">239</span><span id="line-239"> }</span> +<span class="source-line-no">240</span><span id="line-240"></span> +<span class="source-line-no">241</span><span id="line-241"> } catch (final Throwable t) {</span> +<span class="source-line-no">242</span><span id="line-242"> // In case we encounter ANY error, we dump the stack trace and</span> +<span class="source-line-no">243</span><span id="line-243"> // return false (load, start and stop won't be called).</span> +<span class="source-line-no">244</span><span id="line-244"> t.printStackTrace(System.err);</span> +<span class="source-line-no">245</span><span id="line-245"> return false;</span> +<span class="source-line-no">246</span><span id="line-246"> }</span> +<span class="source-line-no">247</span><span id="line-247"> return true;</span> +<span class="source-line-no">248</span><span id="line-248"> }</span> +<span class="source-line-no">249</span><span id="line-249"></span> +<span class="source-line-no">250</span><span id="line-250"> public static boolean stop()</span> +<span class="source-line-no">251</span><span id="line-251"> {</span> +<span class="source-line-no">252</span><span id="line-252"> try {</span> +<span class="source-line-no">253</span><span id="line-253"> // Set the availability flag in the controller</span> +<span class="source-line-no">254</span><span id="line-254"> if (controller != null) {</span> +<span class="source-line-no">255</span><span id="line-255"> controller.setAvailable(false);</span> +<span class="source-line-no">256</span><span id="line-256"> }</span> +<span class="source-line-no">257</span><span id="line-257"></span> +<span class="source-line-no">258</span><span id="line-258"> /* Attempt to stop the daemon */</span> +<span class="source-line-no">259</span><span id="line-259"> stop.invoke(daemon);</span> +<span class="source-line-no">260</span><span id="line-260"> }</span> +<span class="source-line-no">261</span><span id="line-261"> catch (final Throwable t) {</span> +<span class="source-line-no">262</span><span id="line-262"> // In case we encounter ANY error, we dump the stack trace and</span> +<span class="source-line-no">263</span><span id="line-263"> // return false (load, start and stop won't be called).</span> +<span class="source-line-no">264</span><span id="line-264"> t.printStackTrace(System.err);</span> +<span class="source-line-no">265</span><span id="line-265"> return false;</span> +<span class="source-line-no">266</span><span id="line-266"> }</span> +<span class="source-line-no">267</span><span id="line-267"> return true;</span> +<span class="source-line-no">268</span><span id="line-268"> }</span> +<span class="source-line-no">269</span><span id="line-269"></span> +<span class="source-line-no">270</span><span id="line-270"> public static boolean destroy()</span> +<span class="source-line-no">271</span><span id="line-271"> {</span> +<span class="source-line-no">272</span><span id="line-272"> try {</span> +<span class="source-line-no">273</span><span id="line-273"> /* Attempt to stop the daemon */</span> +<span class="source-line-no">274</span><span id="line-274"> destroy.invoke(daemon);</span> +<span class="source-line-no">275</span><span id="line-275"></span> +<span class="source-line-no">276</span><span id="line-276"> daemon = null;</span> +<span class="source-line-no">277</span><span id="line-277"> controller = null;</span> +<span class="source-line-no">278</span><span id="line-278"> } catch (final Throwable t) {</span> +<span class="source-line-no">279</span><span id="line-279"> // In case we encounter ANY error, we dump the stack trace and</span> +<span class="source-line-no">280</span><span id="line-280"> // return false (load, start and stop won't be called).</span> +<span class="source-line-no">281</span><span id="line-281"> t.printStackTrace(System.err);</span> +<span class="source-line-no">282</span><span id="line-282"> return false;</span> +<span class="source-line-no">283</span><span id="line-283"> }</span> +<span class="source-line-no">284</span><span id="line-284"> return true;</span> +<span class="source-line-no">285</span><span id="line-285"> }</span> +<span class="source-line-no">286</span><span id="line-286"></span> +<span class="source-line-no">287</span><span id="line-287"> private static native void shutdown(boolean reload);</span> +<span class="source-line-no">288</span><span id="line-288"> private static native void failed(String message);</span> +<span class="source-line-no">289</span><span id="line-289"></span> +<span class="source-line-no">290</span><span id="line-290"> public static class Controller</span> +<span class="source-line-no">291</span><span id="line-291"> implements DaemonController</span> +<span class="source-line-no">292</span><span id="line-292"> {</span> +<span class="source-line-no">293</span><span id="line-293"></span> +<span class="source-line-no">294</span><span id="line-294"> private boolean available;</span> +<span class="source-line-no">295</span><span id="line-295"></span> +<span class="source-line-no">296</span><span id="line-296"> private Controller()</span> +<span class="source-line-no">297</span><span id="line-297"> {</span> +<span class="source-line-no">298</span><span id="line-298"> this.setAvailable(false);</span> +<span class="source-line-no">299</span><span id="line-299"> }</span> +<span class="source-line-no">300</span><span id="line-300"></span> +<span class="source-line-no">301</span><span id="line-301"> private boolean isAvailable()</span> +<span class="source-line-no">302</span><span id="line-302"> {</span> +<span class="source-line-no">303</span><span id="line-303"> synchronized (this) {</span> +<span class="source-line-no">304</span><span id="line-304"> return this.available;</span> +<span class="source-line-no">305</span><span id="line-305"> }</span> +<span class="source-line-no">306</span><span id="line-306"> }</span> +<span class="source-line-no">307</span><span id="line-307"></span> +<span class="source-line-no">308</span><span id="line-308"> private void setAvailable(final boolean available)</span> +<span class="source-line-no">309</span><span id="line-309"> {</span> +<span class="source-line-no">310</span><span id="line-310"> synchronized (this) {</span> +<span class="source-line-no">311</span><span id="line-311"> this.available = available;</span> +<span class="source-line-no">312</span><span id="line-312"> }</span> +<span class="source-line-no">313</span><span id="line-313"> }</span> +<span class="source-line-no">314</span><span id="line-314"></span> +<span class="source-line-no">315</span><span id="line-315"> @Override</span> +<span class="source-line-no">316</span><span id="line-316"> public void shutdown()</span> +<span class="source-line-no">317</span><span id="line-317"> throws IllegalStateException</span> +<span class="source-line-no">318</span><span id="line-318"> {</span> +<span class="source-line-no">319</span><span id="line-319"> synchronized (this) {</span> +<span class="source-line-no">320</span><span id="line-320"> if (!this.isAvailable()) {</span> +<span class="source-line-no">321</span><span id="line-321"> throw new IllegalStateException();</span> +<span class="source-line-no">322</span><span id="line-322"> }</span> +<span class="source-line-no">323</span><span id="line-323"> this.setAvailable(false);</span> +<span class="source-line-no">324</span><span id="line-324"> DaemonLoader.shutdown(false);</span> +<span class="source-line-no">325</span><span id="line-325"> }</span> +<span class="source-line-no">326</span><span id="line-326"> }</span> +<span class="source-line-no">327</span><span id="line-327"></span> +<span class="source-line-no">328</span><span id="line-328"> @Override</span> +<span class="source-line-no">329</span><span id="line-329"> public void reload()</span> +<span class="source-line-no">330</span><span id="line-330"> throws IllegalStateException</span> +<span class="source-line-no">331</span><span id="line-331"> {</span> +<span class="source-line-no">332</span><span id="line-332"> synchronized (this) {</span> +<span class="source-line-no">333</span><span id="line-333"> if (!this.isAvailable()) {</span> +<span class="source-line-no">334</span><span id="line-334"> throw new IllegalStateException();</span> +<span class="source-line-no">335</span><span id="line-335"> }</span> +<span class="source-line-no">336</span><span id="line-336"> this.setAvailable(false);</span> +<span class="source-line-no">337</span><span id="line-337"> DaemonLoader.shutdown(true);</span> +<span class="source-line-no">338</span><span id="line-338"> }</span> +<span class="source-line-no">339</span><span id="line-339"> }</span> +<span class="source-line-no">340</span><span id="line-340"></span> +<span class="source-line-no">341</span><span id="line-341"> @Override</span> +<span class="source-line-no">342</span><span id="line-342"> public void fail()</span> +<span class="source-line-no">343</span><span id="line-343"> {</span> +<span class="source-line-no">344</span><span id="line-344"> fail(null, null);</span> +<span class="source-line-no">345</span><span id="line-345"> }</span> +<span class="source-line-no">346</span><span id="line-346"></span> +<span class="source-line-no">347</span><span id="line-347"> @Override</span> +<span class="source-line-no">348</span><span id="line-348"> public void fail(final String message)</span> +<span class="source-line-no">349</span><span id="line-349"> {</span> +<span class="source-line-no">350</span><span id="line-350"> fail(message, null);</span> +<span class="source-line-no">351</span><span id="line-351"> }</span> +<span class="source-line-no">352</span><span id="line-352"></span> +<span class="source-line-no">353</span><span id="line-353"> @Override</span> +<span class="source-line-no">354</span><span id="line-354"> public void fail(final Exception exception)</span> +<span class="source-line-no">355</span><span id="line-355"> {</span> +<span class="source-line-no">356</span><span id="line-356"> fail(null, exception);</span> +<span class="source-line-no">357</span><span id="line-357"> }</span> +<span class="source-line-no">358</span><span id="line-358"></span> +<span class="source-line-no">359</span><span id="line-359"> @Override</span> +<span class="source-line-no">360</span><span id="line-360"> public void fail(final String message, final Exception exception)</span> +<span class="source-line-no">361</span><span id="line-361"> {</span> +<span class="source-line-no">362</span><span id="line-362"> synchronized (this) {</span> +<span class="source-line-no">363</span><span id="line-363"> this.setAvailable(false);</span> +<span class="source-line-no">364</span><span id="line-364"> String msg = message;</span> +<span class="source-line-no">365</span><span id="line-365"> if (exception != null) {</span> +<span class="source-line-no">366</span><span id="line-366"> if (msg != null) {</span> +<span class="source-line-no">367</span><span id="line-367"> msg = msg + ": " + exception.toString();</span> +<span class="source-line-no">368</span><span id="line-368"> }</span> +<span class="source-line-no">369</span><span id="line-369"> else {</span> +<span class="source-line-no">370</span><span id="line-370"> msg = exception.toString();</span> +<span class="source-line-no">371</span><span id="line-371"> }</span> +<span class="source-line-no">372</span><span id="line-372"> }</span> +<span class="source-line-no">373</span><span id="line-373"> failed(msg);</span> +<span class="source-line-no">374</span><span id="line-374"> }</span> +<span class="source-line-no">375</span><span id="line-375"> }</span> +<span class="source-line-no">376</span><span id="line-376"></span> +<span class="source-line-no">377</span><span id="line-377"> }</span> +<span class="source-line-no">378</span><span id="line-378"></span> +<span class="source-line-no">379</span><span id="line-379"> public static class Context</span> +<span class="source-line-no">380</span><span id="line-380"> implements DaemonContext</span> +<span class="source-line-no">381</span><span id="line-381"> {</span> +<span class="source-line-no">382</span><span id="line-382"></span> +<span class="source-line-no">383</span><span id="line-383"> private DaemonController daemonController;</span> +<span class="source-line-no">384</span><span id="line-384"></span> +<span class="source-line-no">385</span><span id="line-385"> private String[] args;</span> +<span class="source-line-no">386</span><span id="line-386"></span> +<span class="source-line-no">387</span><span id="line-387"> @Override</span> +<span class="source-line-no">388</span><span id="line-388"> public DaemonController getController()</span> +<span class="source-line-no">389</span><span id="line-389"> {</span> +<span class="source-line-no">390</span><span id="line-390"> return daemonController;</span> +<span class="source-line-no">391</span><span id="line-391"> }</span> +<span class="source-line-no">392</span><span id="line-392"></span> +<span class="source-line-no">393</span><span id="line-393"> public void setController(final DaemonController controller)</span> +<span class="source-line-no">394</span><span id="line-394"> {</span> +<span class="source-line-no">395</span><span id="line-395"> this.daemonController = controller;</span> +<span class="source-line-no">396</span><span id="line-396"> }</span> +<span class="source-line-no">397</span><span id="line-397"></span> +<span class="source-line-no">398</span><span id="line-398"> @Override</span> +<span class="source-line-no">399</span><span id="line-399"> public String[] getArguments()</span> +<span class="source-line-no">400</span><span id="line-400"> {</span> +<span class="source-line-no">401</span><span id="line-401"> return args;</span> +<span class="source-line-no">402</span><span id="line-402"> }</span> +<span class="source-line-no">403</span><span id="line-403"></span> +<span class="source-line-no">404</span><span id="line-404"> public void setArguments(final String[]args)</span> +<span class="source-line-no">405</span><span id="line-405"> {</span> +<span class="source-line-no">406</span><span id="line-406"> this.args = args;</span> +<span class="source-line-no">407</span><span id="line-407"> }</span> +<span class="source-line-no">408</span><span id="line-408"></span> +<span class="source-line-no">409</span><span id="line-409"> }</span> +<span class="source-line-no">410</span><span id="line-410">}</span> @@ -482,5 +483,6 @@ </pre> </div> +</main> </body> </html> \ No newline at end of file
