/usr/share/doc/libcobertura-java/api/src-html/net/sourceforge/cobertura/util/CommandLineBuilder.html is in libcobertura-java-doc 1.9.4.1+dfsg-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 | <HTML>
<BODY BGCOLOR="white">
<PRE>
<FONT color="green">001</FONT> /*<a name="line.1"></a>
<FONT color="green">002</FONT> * Cobertura - http://cobertura.sourceforge.net/<a name="line.2"></a>
<FONT color="green">003</FONT> *<a name="line.3"></a>
<FONT color="green">004</FONT> * Copyright (C) 2005 Grzegorz Lukasik<a name="line.4"></a>
<FONT color="green">005</FONT> *<a name="line.5"></a>
<FONT color="green">006</FONT> * Note: This file is dual licensed under the GPL and the Apache<a name="line.6"></a>
<FONT color="green">007</FONT> * Source License (so that it can be used from both the main<a name="line.7"></a>
<FONT color="green">008</FONT> * Cobertura classes and the ant tasks).<a name="line.8"></a>
<FONT color="green">009</FONT> *<a name="line.9"></a>
<FONT color="green">010</FONT> * Cobertura is free software; you can redistribute it and/or modify<a name="line.10"></a>
<FONT color="green">011</FONT> * it under the terms of the GNU General Public License as published<a name="line.11"></a>
<FONT color="green">012</FONT> * by the Free Software Foundation; either version 2 of the License,<a name="line.12"></a>
<FONT color="green">013</FONT> * or (at your option) any later version.<a name="line.13"></a>
<FONT color="green">014</FONT> *<a name="line.14"></a>
<FONT color="green">015</FONT> * Cobertura is distributed in the hope that it will be useful, but<a name="line.15"></a>
<FONT color="green">016</FONT> * WITHOUT ANY WARRANTY; without even the implied warranty of<a name="line.16"></a>
<FONT color="green">017</FONT> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU<a name="line.17"></a>
<FONT color="green">018</FONT> * General Public License for more details.<a name="line.18"></a>
<FONT color="green">019</FONT> *<a name="line.19"></a>
<FONT color="green">020</FONT> * You should have received a copy of the GNU General Public License<a name="line.20"></a>
<FONT color="green">021</FONT> * along with Cobertura; if not, write to the Free Software<a name="line.21"></a>
<FONT color="green">022</FONT> * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307<a name="line.22"></a>
<FONT color="green">023</FONT> * USA<a name="line.23"></a>
<FONT color="green">024</FONT> */<a name="line.24"></a>
<FONT color="green">025</FONT> <a name="line.25"></a>
<FONT color="green">026</FONT> package net.sourceforge.cobertura.util;<a name="line.26"></a>
<FONT color="green">027</FONT> <a name="line.27"></a>
<FONT color="green">028</FONT> import java.io.BufferedReader;<a name="line.28"></a>
<FONT color="green">029</FONT> import java.io.File;<a name="line.29"></a>
<FONT color="green">030</FONT> import java.io.FileReader;<a name="line.30"></a>
<FONT color="green">031</FONT> import java.io.FileWriter;<a name="line.31"></a>
<FONT color="green">032</FONT> import java.io.IOException;<a name="line.32"></a>
<FONT color="green">033</FONT> import java.util.ArrayList;<a name="line.33"></a>
<FONT color="green">034</FONT> import java.util.List;<a name="line.34"></a>
<FONT color="green">035</FONT> <a name="line.35"></a>
<FONT color="green">036</FONT> import org.apache.log4j.Logger;<a name="line.36"></a>
<FONT color="green">037</FONT> <a name="line.37"></a>
<FONT color="green">038</FONT> /**<a name="line.38"></a>
<FONT color="green">039</FONT> * Helper class for storing long command lines inside temporary file.<a name="line.39"></a>
<FONT color="green">040</FONT> * <p><a name="line.40"></a>
<FONT color="green">041</FONT> * Typical usage:<a name="line.41"></a>
<FONT color="green">042</FONT> * <a name="line.42"></a>
<FONT color="green">043</FONT> * <pre><a name="line.43"></a>
<FONT color="green">044</FONT> * builder = new CommandLineBuilder();<a name="line.44"></a>
<FONT color="green">045</FONT> * builder.addArg(&quot;--someoption&quot;);<a name="line.45"></a>
<FONT color="green">046</FONT> * builder.addArg(&quot;optionValue&quot;);<a name="line.46"></a>
<FONT color="green">047</FONT> * ...<a name="line.47"></a>
<FONT color="green">048</FONT> * builder.saveArgs();<a name="line.48"></a>
<FONT color="green">049</FONT> * doSomething(builder.getCommandLineFile());<a name="line.49"></a>
<FONT color="green">050</FONT> * builder.dispose();<a name="line.50"></a>
<FONT color="green">051</FONT> * </pre><a name="line.51"></a>
<FONT color="green">052</FONT> * <a name="line.52"></a>
<FONT color="green">053</FONT> * It will save options in <code>builder.getCommandLineFile()</code>. Options<a name="line.53"></a>
<FONT color="green">054</FONT> * will be stored one in a line. To retrieve options from file helper method can<a name="line.54"></a>
<FONT color="green">055</FONT> * be used (see documentation):<a name="line.55"></a>
<FONT color="green">056</FONT> * <a name="line.56"></a>
<FONT color="green">057</FONT> * <pre><a name="line.57"></a>
<FONT color="green">058</FONT> * String[] args = CommandLineBuilder.preprocessCommandLineArguments(args);<a name="line.58"></a>
<FONT color="green">059</FONT> * </pre><a name="line.59"></a>
<FONT color="green">060</FONT> * <a name="line.60"></a>
<FONT color="green">061</FONT> * </p><a name="line.61"></a>
<FONT color="green">062</FONT> * <a name="line.62"></a>
<FONT color="green">063</FONT> * <p><a name="line.63"></a>
<FONT color="green">064</FONT> * NOTICE: No protection against line separators in arguments, should be OK for<a name="line.64"></a>
<FONT color="green">065</FONT> * Cobertura needs.<a name="line.65"></a>
<FONT color="green">066</FONT> * </p><a name="line.66"></a>
<FONT color="green">067</FONT> * <p><a name="line.67"></a>
<FONT color="green">068</FONT> * NOTICE: This class depends on local machine settings (line separator, default<a name="line.68"></a>
<FONT color="green">069</FONT> * encoding). If arguments are saved on different machine than they are loaded,<a name="line.69"></a>
<FONT color="green">070</FONT> * results are unspecified. No problem in Cobertura.<a name="line.70"></a>
<FONT color="green">071</FONT> * </p><a name="line.71"></a>
<FONT color="green">072</FONT> * <a name="line.72"></a>
<FONT color="green">073</FONT> * @author Grzegorz Lukasik<a name="line.73"></a>
<FONT color="green">074</FONT> */<a name="line.74"></a>
<FONT color="green">075</FONT> public class CommandLineBuilder {<a name="line.75"></a>
<FONT color="green">076</FONT> private static final Logger logger = Logger<a name="line.76"></a>
<FONT color="green">077</FONT> .getLogger(CommandLineBuilder.class);<a name="line.77"></a>
<FONT color="green">078</FONT> <a name="line.78"></a>
<FONT color="green">079</FONT> private static final String LINESEP = System.getProperty("line.separator");<a name="line.79"></a>
<FONT color="green">080</FONT> <a name="line.80"></a>
<FONT color="green">081</FONT> // File that will be used to store arguments<a name="line.81"></a>
<FONT color="green">082</FONT> private File commandLineFile = null;<a name="line.82"></a>
<FONT color="green">083</FONT> <a name="line.83"></a>
<FONT color="green">084</FONT> // Writer that will be used to write arguments to the file<a name="line.84"></a>
<FONT color="green">085</FONT> private FileWriter commandLineWriter = null;<a name="line.85"></a>
<FONT color="green">086</FONT> <a name="line.86"></a>
<FONT color="green">087</FONT> /**<a name="line.87"></a>
<FONT color="green">088</FONT> * Creates a new instance of the builder. Instances of this class should not<a name="line.88"></a>
<FONT color="green">089</FONT> * be reused to create many command lines.<a name="line.89"></a>
<FONT color="green">090</FONT> * <a name="line.90"></a>
<FONT color="green">091</FONT> * @throws IOException<a name="line.91"></a>
<FONT color="green">092</FONT> * if problems with creating temporary file for storing command<a name="line.92"></a>
<FONT color="green">093</FONT> * line occur<a name="line.93"></a>
<FONT color="green">094</FONT> */<a name="line.94"></a>
<FONT color="green">095</FONT> public CommandLineBuilder() throws IOException {<a name="line.95"></a>
<FONT color="green">096</FONT> commandLineFile = File.createTempFile("cobertura.", ".cmdline");<a name="line.96"></a>
<FONT color="green">097</FONT> commandLineFile.deleteOnExit();<a name="line.97"></a>
<FONT color="green">098</FONT> commandLineWriter = new FileWriter(commandLineFile);<a name="line.98"></a>
<FONT color="green">099</FONT> }<a name="line.99"></a>
<FONT color="green">100</FONT> <a name="line.100"></a>
<FONT color="green">101</FONT> /**<a name="line.101"></a>
<FONT color="green">102</FONT> * Adds command line argument. Each argument can be thought as a single cell<a name="line.102"></a>
<FONT color="green">103</FONT> * in array passed to main method. This method should not be used after<a name="line.103"></a>
<FONT color="green">104</FONT> * arguments were saved.<a name="line.104"></a>
<FONT color="green">105</FONT> * <a name="line.105"></a>
<FONT color="green">106</FONT> * @param arg command line argument to save<a name="line.106"></a>
<FONT color="green">107</FONT> * @throws IOException<a name="line.107"></a>
<FONT color="green">108</FONT> * if problems with temporary file occur<a name="line.108"></a>
<FONT color="green">109</FONT> * @throws NullPointerException <a name="line.109"></a>
<FONT color="green">110</FONT> * if <code>arg</code> is <code>null</code> <a name="line.110"></a>
<FONT color="green">111</FONT> */<a name="line.111"></a>
<FONT color="green">112</FONT> public void addArg(String arg) throws IOException {<a name="line.112"></a>
<FONT color="green">113</FONT> if( arg==null)<a name="line.113"></a>
<FONT color="green">114</FONT> throw new NullPointerException();<a name="line.114"></a>
<FONT color="green">115</FONT> commandLineWriter.write(arg + LINESEP);<a name="line.115"></a>
<FONT color="green">116</FONT> }<a name="line.116"></a>
<FONT color="green">117</FONT> <a name="line.117"></a>
<FONT color="green">118</FONT> <a name="line.118"></a>
<FONT color="green">119</FONT> /**<a name="line.119"></a>
<FONT color="green">120</FONT> * Adds two command line arguments. Convienience function, calls<a name="line.120"></a>
<FONT color="green">121</FONT> * {@link #addArg(String)} two times. <a name="line.121"></a>
<FONT color="green">122</FONT> * <a name="line.122"></a>
<FONT color="green">123</FONT> * @param arg1 first command line argument to save<a name="line.123"></a>
<FONT color="green">124</FONT> * @param arg2 second command line argument to save<a name="line.124"></a>
<FONT color="green">125</FONT> * @throws IOException<a name="line.125"></a>
<FONT color="green">126</FONT> * if problems with temporary file occur<a name="line.126"></a>
<FONT color="green">127</FONT> * @throws NullPointerException <a name="line.127"></a>
<FONT color="green">128</FONT> * if any <code>arg</code> is <code>null</code> <a name="line.128"></a>
<FONT color="green">129</FONT> */<a name="line.129"></a>
<FONT color="green">130</FONT> public void addArg(String arg1, String arg2) throws IOException {<a name="line.130"></a>
<FONT color="green">131</FONT> addArg(arg1);<a name="line.131"></a>
<FONT color="green">132</FONT> addArg(arg2);<a name="line.132"></a>
<FONT color="green">133</FONT> }<a name="line.133"></a>
<FONT color="green">134</FONT> <a name="line.134"></a>
<FONT color="green">135</FONT> <a name="line.135"></a>
<FONT color="green">136</FONT> /**<a name="line.136"></a>
<FONT color="green">137</FONT> * Saves options and made file available to use. Use method<a name="line.137"></a>
<FONT color="green">138</FONT> * {@link #getCommandLineFile} to get the file the arguments are saved in.<a name="line.138"></a>
<FONT color="green">139</FONT> * <a name="line.139"></a>
<FONT color="green">140</FONT> * @throws IOException<a name="line.140"></a>
<FONT color="green">141</FONT> * if problems with temporary file occur<a name="line.141"></a>
<FONT color="green">142</FONT> */<a name="line.142"></a>
<FONT color="green">143</FONT> public void saveArgs() throws IOException {<a name="line.143"></a>
<FONT color="green">144</FONT> commandLineWriter.flush();<a name="line.144"></a>
<FONT color="green">145</FONT> commandLineWriter.close();<a name="line.145"></a>
<FONT color="green">146</FONT> }<a name="line.146"></a>
<FONT color="green">147</FONT> <a name="line.147"></a>
<FONT color="green">148</FONT> /**<a name="line.148"></a>
<FONT color="green">149</FONT> * Gets absolute path to the file with saved arguments. Notice, that however<a name="line.149"></a>
<FONT color="green">150</FONT> * this method can be used as soon as an instance of this class is created,<a name="line.150"></a>
<FONT color="green">151</FONT> * arguments should be read from the file after a call to<a name="line.151"></a>
<FONT color="green">152</FONT> * {@link #saveArgs} method.<a name="line.152"></a>
<FONT color="green">153</FONT> * <a name="line.153"></a>
<FONT color="green">154</FONT> * @return absolute path to the file with arguments<a name="line.154"></a>
<FONT color="green">155</FONT> */<a name="line.155"></a>
<FONT color="green">156</FONT> public String getCommandLineFile() {<a name="line.156"></a>
<FONT color="green">157</FONT> return commandLineFile.getAbsolutePath();<a name="line.157"></a>
<FONT color="green">158</FONT> }<a name="line.158"></a>
<FONT color="green">159</FONT> <a name="line.159"></a>
<FONT color="green">160</FONT> /**<a name="line.160"></a>
<FONT color="green">161</FONT> * Explicity frees all resources associated with this instance. Result of<a name="line.161"></a>
<FONT color="green">162</FONT> * any other method call after disposing an instance of this class is<a name="line.162"></a>
<FONT color="green">163</FONT> * unspecified.<a name="line.163"></a>
<FONT color="green">164</FONT> */<a name="line.164"></a>
<FONT color="green">165</FONT> public void dispose() {<a name="line.165"></a>
<FONT color="green">166</FONT> commandLineFile.delete();<a name="line.166"></a>
<FONT color="green">167</FONT> }<a name="line.167"></a>
<FONT color="green">168</FONT> <a name="line.168"></a>
<FONT color="green">169</FONT> /**<a name="line.169"></a>
<FONT color="green">170</FONT> * Loads arguments from file if <code>--commandsfile</code> option is used. Checks<a name="line.170"></a>
<FONT color="green">171</FONT> * if passed array contains <code>--commandsfile</code> String, and if<a name="line.171"></a>
<FONT color="green">172</FONT> * so arguments from file specified in the very next array cell are read. If<a name="line.172"></a>
<FONT color="green">173</FONT> * there are more then one <code>--commandsfile</code> the result is unspecified. <a name="line.173"></a>
<FONT color="green">174</FONT> *<a name="line.174"></a>
<FONT color="green">175</FONT> * @return The list of arguments read from commandsfile, or<a name="line.175"></a>
<FONT color="green">176</FONT> * <code>args</code> if commandsfile option was not specified<a name="line.176"></a>
<FONT color="green">177</FONT> * or the file cannot be read.<a name="line.177"></a>
<FONT color="green">178</FONT> * @throws NullPointerException if args is null, or any argument is null<a name="line.178"></a>
<FONT color="green">179</FONT> * @throws IllegalArgumentException if --commandsfile is specified as last option<a name="line.179"></a>
<FONT color="green">180</FONT> * @throws IOException if I/O related error with temporary command line file occur<a name="line.180"></a>
<FONT color="green">181</FONT> */<a name="line.181"></a>
<FONT color="green">182</FONT> public static String[] preprocessCommandLineArguments(String[] args) throws IOException {<a name="line.182"></a>
<FONT color="green">183</FONT> boolean hasCommandsFile = false;<a name="line.183"></a>
<FONT color="green">184</FONT> String commandsFileName = null;<a name="line.184"></a>
<FONT color="green">185</FONT> for (int i = 0; i < args.length; i++) {<a name="line.185"></a>
<FONT color="green">186</FONT> if ( args[i].equals( "--commandsfile")) {<a name="line.186"></a>
<FONT color="green">187</FONT> if( i==args.length-1) {<a name="line.187"></a>
<FONT color="green">188</FONT> throw new IllegalArgumentException("'--commandsfile' specified as last option.");<a name="line.188"></a>
<FONT color="green">189</FONT> }<a name="line.189"></a>
<FONT color="green">190</FONT> hasCommandsFile = true;<a name="line.190"></a>
<FONT color="green">191</FONT> commandsFileName = args[++i];<a name="line.191"></a>
<FONT color="green">192</FONT> }<a name="line.192"></a>
<FONT color="green">193</FONT> }<a name="line.193"></a>
<FONT color="green">194</FONT> <a name="line.194"></a>
<FONT color="green">195</FONT> if (hasCommandsFile) {<a name="line.195"></a>
<FONT color="green">196</FONT> List arglist = new ArrayList();<a name="line.196"></a>
<FONT color="green">197</FONT> BufferedReader bufferedReader = null;<a name="line.197"></a>
<FONT color="green">198</FONT> <a name="line.198"></a>
<FONT color="green">199</FONT> try {<a name="line.199"></a>
<FONT color="green">200</FONT> bufferedReader = new BufferedReader(new FileReader(<a name="line.200"></a>
<FONT color="green">201</FONT> commandsFileName));<a name="line.201"></a>
<FONT color="green">202</FONT> String line;<a name="line.202"></a>
<FONT color="green">203</FONT> <a name="line.203"></a>
<FONT color="green">204</FONT> while ((line = bufferedReader.readLine()) != null)<a name="line.204"></a>
<FONT color="green">205</FONT> arglist.add(line);<a name="line.205"></a>
<FONT color="green">206</FONT> <a name="line.206"></a>
<FONT color="green">207</FONT> } catch (IOException e) {<a name="line.207"></a>
<FONT color="green">208</FONT> logger.info( "I/O error when reading temporary commands file", e);<a name="line.208"></a>
<FONT color="green">209</FONT> throw new IOException( "Unable to read temporary commands file "<a name="line.209"></a>
<FONT color="green">210</FONT> + commandsFileName + ".");<a name="line.210"></a>
<FONT color="green">211</FONT> } finally {<a name="line.211"></a>
<FONT color="green">212</FONT> if (bufferedReader != null) {<a name="line.212"></a>
<FONT color="green">213</FONT> try {<a name="line.213"></a>
<FONT color="green">214</FONT> bufferedReader.close();<a name="line.214"></a>
<FONT color="green">215</FONT> } catch (IOException e) {<a name="line.215"></a>
<FONT color="green">216</FONT> }<a name="line.216"></a>
<FONT color="green">217</FONT> }<a name="line.217"></a>
<FONT color="green">218</FONT> }<a name="line.218"></a>
<FONT color="green">219</FONT> <a name="line.219"></a>
<FONT color="green">220</FONT> args = (String[]) arglist.toArray(new String[arglist.size()]);<a name="line.220"></a>
<FONT color="green">221</FONT> }<a name="line.221"></a>
<FONT color="green">222</FONT> return args;<a name="line.222"></a>
<FONT color="green">223</FONT> }<a name="line.223"></a>
<FONT color="green">224</FONT> }<a name="line.224"></a>
</PRE>
</BODY>
</HTML>
|