src/share/classes/com/sun/tools/javac/main/Option.java

Tue, 17 Dec 2013 10:55:59 +0100

author
jlahoda
date
Tue, 17 Dec 2013 10:55:59 +0100
changeset 2413
fe033d997ddf
parent 1988
96b6865eda94
child 2525
2eb010b6cb22
permissions
-rw-r--r--

8029800: Flags.java uses String.toLowerCase without specifying Locale
Summary: Introducing StringUtils.toLowerCase/toUpperCase independent on the default locale, converting almost all usages of String.toLowerCase/toUpperCase to use the new methods.
Reviewed-by: jjg, bpatel

jjg@1158 1 /*
jjg@1485 2 * Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved.
jjg@1158 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
jjg@1158 4 *
jjg@1158 5 * This code is free software; you can redistribute it and/or modify it
jjg@1158 6 * under the terms of the GNU General Public License version 2 only, as
jjg@1158 7 * published by the Free Software Foundation. Oracle designates this
jjg@1158 8 * particular file as subject to the "Classpath" exception as provided
jjg@1158 9 * by Oracle in the LICENSE file that accompanied this code.
jjg@1158 10 *
jjg@1158 11 * This code is distributed in the hope that it will be useful, but WITHOUT
jjg@1158 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
jjg@1158 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
jjg@1158 14 * version 2 for more details (a copy is included in the LICENSE file that
jjg@1158 15 * accompanied this code).
jjg@1158 16 *
jjg@1158 17 * You should have received a copy of the GNU General Public License version
jjg@1158 18 * 2 along with this work; if not, write to the Free Software Foundation,
jjg@1158 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
jjg@1158 20 *
jjg@1158 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
jjg@1158 22 * or visit www.oracle.com if you need additional information or have any
jjg@1158 23 * questions.
jjg@1158 24 */
jjg@1158 25
jjg@1158 26 package com.sun.tools.javac.main;
jjg@1158 27
jjg@1463 28 import java.io.File;
jjg@1463 29 import java.io.FileWriter;
jjg@1463 30 import java.io.PrintWriter;
jjg@1158 31 import java.util.Collections;
jjg@1463 32 import java.util.EnumSet;
jjg@1463 33 import java.util.LinkedHashMap;
jjg@1463 34 import java.util.Map;
jjg@1463 35 import java.util.Set;
jjg@1463 36
jjg@1463 37 import javax.lang.model.SourceVersion;
jjg@1463 38
jjg@1463 39 import com.sun.tools.doclint.DocLint;
jjg@1158 40 import com.sun.tools.javac.code.Lint;
jjg@1158 41 import com.sun.tools.javac.code.Source;
jjg@1158 42 import com.sun.tools.javac.code.Type;
jjg@1569 43 import com.sun.tools.javac.jvm.Profile;
jjg@1158 44 import com.sun.tools.javac.jvm.Target;
jjg@1463 45 import com.sun.tools.javac.processing.JavacProcessingEnvironment;
jjg@1463 46 import com.sun.tools.javac.util.Log;
jjg@1463 47 import com.sun.tools.javac.util.Log.PrefixKind;
jjg@1463 48 import com.sun.tools.javac.util.Log.WriterKind;
jjg@1158 49 import com.sun.tools.javac.util.Options;
jlahoda@2413 50 import com.sun.tools.javac.util.StringUtils;
jjg@1158 51 import static com.sun.tools.javac.main.Option.ChoiceKind.*;
jjg@1463 52 import static com.sun.tools.javac.main.Option.OptionGroup.*;
jjg@1158 53 import static com.sun.tools.javac.main.Option.OptionKind.*;
jjg@1158 54
jjg@1158 55 /**
jjg@1158 56 * Options for javac. The specific Option to handle a command-line option
jjg@1158 57 * is identified by searching the members of this enum in order, looking
jjg@1158 58 * the first {@link #matches match}. The action for an Option is performed
jjg@1158 59 * by calling {@link #process process}, and by providing a suitable
jjg@1158 60 * {@link OptionHelper} to provide access the compiler state.
jjg@1158 61 *
jjg@1158 62 * <p><b>This is NOT part of any supported API.
jjg@1158 63 * If you write code that depends on this, you do so at your own
jjg@1158 64 * risk. This code and its internal interfaces are subject to change
jjg@1158 65 * or deletion without notice.</b></p>
jjg@1158 66 */
jjg@1158 67 public enum Option {
jjg@1158 68 G("-g", "opt.g", STANDARD, BASIC),
jjg@1158 69
jjg@1158 70 G_NONE("-g:none", "opt.g.none", STANDARD, BASIC) {
jjg@1158 71 @Override
jjg@1158 72 public boolean process(OptionHelper helper, String option) {
jjg@1158 73 helper.put("-g:", "none");
jjg@1158 74 return false;
jjg@1158 75 }
jjg@1158 76 },
jjg@1158 77
jjg@1158 78 G_CUSTOM("-g:", "opt.g.lines.vars.source",
jjg@1158 79 STANDARD, BASIC, ANYOF, "lines", "vars", "source"),
jjg@1158 80
jjg@1158 81 XLINT("-Xlint", "opt.Xlint", EXTENDED, BASIC),
jjg@1158 82
jjg@1158 83 XLINT_CUSTOM("-Xlint:", "opt.Xlint.suboptlist",
jjg@1158 84 EXTENDED, BASIC, ANYOF, getXLintChoices()),
jjg@1158 85
jjg@1463 86 XDOCLINT("-Xdoclint", "opt.Xdoclint", EXTENDED, BASIC),
jjg@1463 87
jjg@1463 88 XDOCLINT_CUSTOM("-Xdoclint:", "opt.Xdoclint.subopts", "opt.Xdoclint.custom", EXTENDED, BASIC) {
jjg@1463 89 @Override
jjg@1463 90 public boolean matches(String option) {
jjg@1463 91 return DocLint.isValidOption(
jjg@1463 92 option.replace(XDOCLINT_CUSTOM.text, DocLint.XMSGS_CUSTOM_PREFIX));
jjg@1463 93 }
jjg@1463 94
jjg@1463 95 @Override
jjg@1463 96 public boolean process(OptionHelper helper, String option) {
jjg@1463 97 String prev = helper.get(XDOCLINT_CUSTOM);
jjg@1463 98 String next = (prev == null) ? option : (prev + " " + option);
jjg@1463 99 helper.put(XDOCLINT_CUSTOM.text, next);
jjg@1463 100 return false;
jjg@1463 101 }
jjg@1463 102 },
jjg@1463 103
jjg@1158 104 // -nowarn is retained for command-line backward compatibility
jjg@1158 105 NOWARN("-nowarn", "opt.nowarn", STANDARD, BASIC) {
jjg@1158 106 @Override
jjg@1158 107 public boolean process(OptionHelper helper, String option) {
jjg@1158 108 helper.put("-Xlint:none", option);
jjg@1158 109 return false;
jjg@1158 110 }
jjg@1158 111 },
jjg@1158 112
jjg@1158 113 VERBOSE("-verbose", "opt.verbose", STANDARD, BASIC),
jjg@1158 114
jjg@1158 115 // -deprecation is retained for command-line backward compatibility
jjg@1158 116 DEPRECATION("-deprecation", "opt.deprecation", STANDARD, BASIC) {
jjg@1158 117 @Override
jjg@1158 118 public boolean process(OptionHelper helper, String option) {
jjg@1158 119 helper.put("-Xlint:deprecation", option);
jjg@1158 120 return false;
jjg@1158 121 }
jjg@1158 122 },
jjg@1158 123
jjg@1158 124 CLASSPATH("-classpath", "opt.arg.path", "opt.classpath", STANDARD, FILEMANAGER),
jjg@1158 125
jjg@1158 126 CP("-cp", "opt.arg.path", "opt.classpath", STANDARD, FILEMANAGER) {
jjg@1158 127 @Override
jjg@1158 128 public boolean process(OptionHelper helper, String option, String arg) {
jjg@1158 129 return super.process(helper, "-classpath", arg);
jjg@1158 130 }
jjg@1158 131 },
jjg@1158 132
jjg@1158 133 SOURCEPATH("-sourcepath", "opt.arg.path", "opt.sourcepath", STANDARD, FILEMANAGER),
jjg@1158 134
jjg@1158 135 BOOTCLASSPATH("-bootclasspath", "opt.arg.path", "opt.bootclasspath", STANDARD, FILEMANAGER) {
jjg@1158 136 @Override
jjg@1158 137 public boolean process(OptionHelper helper, String option, String arg) {
jjg@1158 138 helper.remove("-Xbootclasspath/p:");
jjg@1158 139 helper.remove("-Xbootclasspath/a:");
jjg@1158 140 return super.process(helper, option, arg);
jjg@1158 141 }
jjg@1158 142 },
jjg@1158 143
jjg@1158 144 XBOOTCLASSPATH_PREPEND("-Xbootclasspath/p:", "opt.arg.path", "opt.Xbootclasspath.p", EXTENDED, FILEMANAGER),
jjg@1158 145
jjg@1158 146 XBOOTCLASSPATH_APPEND("-Xbootclasspath/a:", "opt.arg.path", "opt.Xbootclasspath.a", EXTENDED, FILEMANAGER),
jjg@1158 147
jjg@1158 148 XBOOTCLASSPATH("-Xbootclasspath:", "opt.arg.path", "opt.bootclasspath", EXTENDED, FILEMANAGER) {
jjg@1158 149 @Override
jjg@1158 150 public boolean process(OptionHelper helper, String option, String arg) {
jjg@1158 151 helper.remove("-Xbootclasspath/p:");
jjg@1158 152 helper.remove("-Xbootclasspath/a:");
jjg@1158 153 return super.process(helper, "-bootclasspath", arg);
jjg@1158 154 }
jjg@1158 155 },
jjg@1158 156
jjg@1158 157 EXTDIRS("-extdirs", "opt.arg.dirs", "opt.extdirs", STANDARD, FILEMANAGER),
jjg@1158 158
jjg@1158 159 DJAVA_EXT_DIRS("-Djava.ext.dirs=", "opt.arg.dirs", "opt.extdirs", EXTENDED, FILEMANAGER) {
jjg@1158 160 @Override
jjg@1158 161 public boolean process(OptionHelper helper, String option, String arg) {
jjg@1158 162 return super.process(helper, "-extdirs", arg);
jjg@1158 163 }
jjg@1158 164 },
jjg@1158 165
jjg@1158 166 ENDORSEDDIRS("-endorseddirs", "opt.arg.dirs", "opt.endorseddirs", STANDARD, FILEMANAGER),
jjg@1158 167
jjg@1158 168 DJAVA_ENDORSED_DIRS("-Djava.endorsed.dirs=", "opt.arg.dirs", "opt.endorseddirs", EXTENDED, FILEMANAGER) {
jjg@1158 169 @Override
jjg@1158 170 public boolean process(OptionHelper helper, String option, String arg) {
jjg@1158 171 return super.process(helper, "-endorseddirs", arg);
jjg@1158 172 }
jjg@1158 173 },
jjg@1158 174
jjg@1158 175 PROC("-proc:", "opt.proc.none.only", STANDARD, BASIC, ONEOF, "none", "only"),
jjg@1158 176
jjg@1158 177 PROCESSOR("-processor", "opt.arg.class.list", "opt.processor", STANDARD, BASIC),
jjg@1158 178
jjg@1158 179 PROCESSORPATH("-processorpath", "opt.arg.path", "opt.processorpath", STANDARD, FILEMANAGER),
jjg@1158 180
jjg@1473 181 PARAMETERS("-parameters","opt.parameters", STANDARD, BASIC),
jjg@1473 182
jjg@1158 183 D("-d", "opt.arg.directory", "opt.d", STANDARD, FILEMANAGER),
jjg@1158 184
jjg@1158 185 S("-s", "opt.arg.directory", "opt.sourceDest", STANDARD, FILEMANAGER),
jjg@1158 186
jjg@1230 187 H("-h", "opt.arg.directory", "opt.headerDest", STANDARD, FILEMANAGER),
jjg@1230 188
jjg@1158 189 IMPLICIT("-implicit:", "opt.implicit", STANDARD, BASIC, ONEOF, "none", "class"),
jjg@1158 190
jjg@1158 191 ENCODING("-encoding", "opt.arg.encoding", "opt.encoding", STANDARD, FILEMANAGER) {
jjg@1158 192 @Override
jjg@1158 193 public boolean process(OptionHelper helper, String option, String operand) {
jjg@1158 194 return super.process(helper, option, operand);
jjg@1158 195 }
jjg@1158 196
jjg@1158 197 },
jjg@1158 198
jjg@1158 199 SOURCE("-source", "opt.arg.release", "opt.source", STANDARD, BASIC) {
jjg@1158 200 @Override
jjg@1158 201 public boolean process(OptionHelper helper, String option, String operand) {
jjg@1158 202 Source source = Source.lookup(operand);
jjg@1158 203 if (source == null) {
jjg@1158 204 helper.error("err.invalid.source", operand);
jjg@1158 205 return true;
jjg@1158 206 }
jjg@1158 207 return super.process(helper, option, operand);
jjg@1158 208 }
jjg@1158 209 },
jjg@1158 210
jjg@1158 211 TARGET("-target", "opt.arg.release", "opt.target", STANDARD, BASIC) {
jjg@1158 212 @Override
jjg@1158 213 public boolean process(OptionHelper helper, String option, String operand) {
jjg@1158 214 Target target = Target.lookup(operand);
jjg@1158 215 if (target == null) {
jjg@1158 216 helper.error("err.invalid.target", operand);
jjg@1158 217 return true;
jjg@1158 218 }
jjg@1158 219 return super.process(helper, option, operand);
jjg@1158 220 }
jjg@1158 221 },
jjg@1158 222
jjg@1569 223 PROFILE("-profile", "opt.arg.profile", "opt.profile", STANDARD, BASIC) {
jjg@1569 224 @Override
jjg@1569 225 public boolean process(OptionHelper helper, String option, String operand) {
jjg@1569 226 Profile profile = Profile.lookup(operand);
jjg@1569 227 if (profile == null) {
jjg@1569 228 helper.error("err.invalid.profile", operand);
jjg@1569 229 return true;
jjg@1569 230 }
jjg@1569 231 return super.process(helper, option, operand);
jjg@1569 232 }
jjg@1569 233 },
jjg@1569 234
jjg@1158 235 VERSION("-version", "opt.version", STANDARD, INFO) {
jjg@1158 236 @Override
jjg@1158 237 public boolean process(OptionHelper helper, String option) {
jjg@1158 238 Log log = helper.getLog();
jjg@1158 239 String ownName = helper.getOwnName();
jjg@1158 240 log.printLines(PrefixKind.JAVAC, "version", ownName, JavaCompiler.version());
jjg@1158 241 return super.process(helper, option);
jjg@1158 242 }
jjg@1158 243 },
jjg@1158 244
jjg@1158 245 FULLVERSION("-fullversion", null, HIDDEN, INFO) {
jjg@1158 246 @Override
jjg@1158 247 public boolean process(OptionHelper helper, String option) {
jjg@1158 248 Log log = helper.getLog();
jjg@1158 249 String ownName = helper.getOwnName();
jjg@1160 250 log.printLines(PrefixKind.JAVAC, "fullVersion", ownName, JavaCompiler.fullVersion());
jjg@1158 251 return super.process(helper, option);
jjg@1158 252 }
jjg@1158 253 },
jjg@1158 254
jjg@1158 255 DIAGS("-XDdiags=", null, HIDDEN, INFO) {
jjg@1158 256 @Override
jjg@1158 257 public boolean process(OptionHelper helper, String option) {
jjg@1158 258 option = option.substring(option.indexOf('=') + 1);
jjg@1158 259 String diagsOption = option.contains("%") ?
jjg@1158 260 "-XDdiagsFormat=" :
jjg@1158 261 "-XDdiags=";
jjg@1158 262 diagsOption += option;
jjg@1158 263 if (XD.matches(diagsOption))
jjg@1158 264 return XD.process(helper, diagsOption);
jjg@1158 265 else
jjg@1158 266 return false;
jjg@1158 267 }
jjg@1158 268 },
jjg@1158 269
jjg@1158 270 HELP("-help", "opt.help", STANDARD, INFO) {
jjg@1158 271 @Override
jjg@1158 272 public boolean process(OptionHelper helper, String option) {
jjg@1158 273 Log log = helper.getLog();
jjg@1158 274 String ownName = helper.getOwnName();
jjg@1158 275 log.printLines(PrefixKind.JAVAC, "msg.usage.header", ownName);
jjg@1158 276 for (Option o: getJavaCompilerOptions()) {
jjg@1158 277 o.help(log, OptionKind.STANDARD);
jjg@1158 278 }
jjg@1158 279 log.printNewline();
jjg@1158 280 return super.process(helper, option);
jjg@1158 281 }
jjg@1158 282 },
jjg@1158 283
vromero@1442 284 A("-A", "opt.arg.key.equals.value", "opt.A", STANDARD, BASIC, true) {
jjg@1158 285 @Override
jjg@1158 286 public boolean matches(String arg) {
jjg@1158 287 return arg.startsWith("-A");
jjg@1158 288 }
jjg@1158 289
jjg@1158 290 @Override
jjg@1158 291 public boolean hasArg() {
jjg@1158 292 return false;
jjg@1158 293 }
jjg@1158 294 // Mapping for processor options created in
jjg@1158 295 // JavacProcessingEnvironment
jjg@1158 296 @Override
jjg@1158 297 public boolean process(OptionHelper helper, String option) {
jjg@1158 298 int argLength = option.length();
jjg@1158 299 if (argLength == 2) {
jjg@1158 300 helper.error("err.empty.A.argument");
jjg@1158 301 return true;
jjg@1158 302 }
jjg@1158 303 int sepIndex = option.indexOf('=');
jjg@1158 304 String key = option.substring(2, (sepIndex != -1 ? sepIndex : argLength) );
jjg@1158 305 if (!JavacProcessingEnvironment.isValidOptionName(key)) {
jjg@1158 306 helper.error("err.invalid.A.key", option);
jjg@1158 307 return true;
jjg@1158 308 }
jjg@1158 309 return process(helper, option, option);
jjg@1158 310 }
jjg@1158 311 },
jjg@1158 312
jjg@1158 313 X("-X", "opt.X", STANDARD, INFO) {
jjg@1158 314 @Override
jjg@1158 315 public boolean process(OptionHelper helper, String option) {
jjg@1158 316 Log log = helper.getLog();
jjg@1158 317 for (Option o: getJavaCompilerOptions()) {
jjg@1158 318 o.help(log, OptionKind.EXTENDED);
jjg@1158 319 }
jjg@1158 320 log.printNewline();
jjg@1158 321 log.printLines(PrefixKind.JAVAC, "msg.usage.nonstandard.footer");
jjg@1158 322 return super.process(helper, option);
jjg@1158 323 }
jjg@1158 324 },
jjg@1158 325
jjg@1158 326 // This option exists only for the purpose of documenting itself.
jjg@1158 327 // It's actually implemented by the launcher.
jjg@1485 328 J("-J", "opt.arg.flag", "opt.J", STANDARD, INFO, true) {
jjg@1158 329 @Override
jjg@1158 330 public boolean process(OptionHelper helper, String option) {
jjg@1158 331 throw new AssertionError
jjg@1158 332 ("the -J flag should be caught by the launcher.");
jjg@1158 333 }
jjg@1158 334 },
jjg@1158 335
jjg@1158 336 MOREINFO("-moreinfo", null, HIDDEN, BASIC) {
jjg@1158 337 @Override
jjg@1158 338 public boolean process(OptionHelper helper, String option) {
jjg@1158 339 Type.moreInfo = true;
jjg@1158 340 return super.process(helper, option);
jjg@1158 341 }
jjg@1158 342 },
jjg@1158 343
jjg@1158 344 // treat warnings as errors
jjg@1158 345 WERROR("-Werror", "opt.Werror", STANDARD, BASIC),
jjg@1158 346
jjg@1158 347 // prompt after each error
jjg@1158 348 // new Option("-prompt", "opt.prompt"),
jjg@1158 349 PROMPT("-prompt", null, HIDDEN, BASIC),
jjg@1158 350
jjg@1158 351 // dump stack on error
jjg@1158 352 DOE("-doe", null, HIDDEN, BASIC),
jjg@1158 353
jjg@1158 354 // output source after type erasure
jjg@1158 355 PRINTSOURCE("-printsource", null, HIDDEN, BASIC),
jjg@1158 356
jjg@1158 357 // display warnings for generic unchecked operations
jjg@1158 358 WARNUNCHECKED("-warnunchecked", null, HIDDEN, BASIC) {
jjg@1158 359 @Override
jjg@1158 360 public boolean process(OptionHelper helper, String option) {
jjg@1158 361 helper.put("-Xlint:unchecked", option);
jjg@1158 362 return false;
jjg@1158 363 }
jjg@1158 364 },
jjg@1158 365
jjg@1158 366 XMAXERRS("-Xmaxerrs", "opt.arg.number", "opt.maxerrs", EXTENDED, BASIC),
jjg@1158 367
jjg@1158 368 XMAXWARNS("-Xmaxwarns", "opt.arg.number", "opt.maxwarns", EXTENDED, BASIC),
jjg@1158 369
jjg@1159 370 XSTDOUT("-Xstdout", "opt.arg.file", "opt.Xstdout", EXTENDED, INFO) {
jjg@1158 371 @Override
jjg@1158 372 public boolean process(OptionHelper helper, String option, String arg) {
jjg@1158 373 try {
jjg@1158 374 Log log = helper.getLog();
jjg@1158 375 // TODO: this file should be closed at the end of compilation
jjg@1158 376 log.setWriters(new PrintWriter(new FileWriter(arg), true));
jjg@1158 377 } catch (java.io.IOException e) {
jjg@1158 378 helper.error("err.error.writing.file", arg, e);
jjg@1158 379 return true;
jjg@1158 380 }
jjg@1158 381 return super.process(helper, option, arg);
jjg@1158 382 }
jjg@1158 383 },
jjg@1158 384
jjg@1158 385 XPRINT("-Xprint", "opt.print", EXTENDED, BASIC),
jjg@1158 386
jjg@1158 387 XPRINTROUNDS("-XprintRounds", "opt.printRounds", EXTENDED, BASIC),
jjg@1158 388
jjg@1158 389 XPRINTPROCESSORINFO("-XprintProcessorInfo", "opt.printProcessorInfo", EXTENDED, BASIC),
jjg@1158 390
jjg@1158 391 XPREFER("-Xprefer:", "opt.prefer", EXTENDED, BASIC, ONEOF, "source", "newer"),
jjg@1158 392
jjg@1988 393 // see enum PkgInfo
jjg@1158 394 XPKGINFO("-Xpkginfo:", "opt.pkginfo", EXTENDED, BASIC, ONEOF, "always", "legacy", "nonempty"),
jjg@1158 395
jjg@1158 396 /* -O is a no-op, accepted for backward compatibility. */
jjg@1158 397 O("-O", null, HIDDEN, BASIC),
jjg@1158 398
jjg@1158 399 /* -Xjcov produces tables to support the code coverage tool jcov. */
jjg@1158 400 XJCOV("-Xjcov", null, HIDDEN, BASIC),
jjg@1158 401
jjg@1416 402 PLUGIN("-Xplugin:", "opt.arg.plugin", "opt.plugin", EXTENDED, BASIC) {
jjg@1416 403 @Override
jjg@1416 404 public boolean process(OptionHelper helper, String option) {
jjg@1416 405 String p = option.substring(option.indexOf(':') + 1);
jjg@1416 406 String prev = helper.get(PLUGIN);
jjg@1416 407 helper.put(PLUGIN.text, (prev == null) ? p : prev + '\0' + p.trim());
jjg@1416 408 return false;
jjg@1416 409 }
jjg@1416 410 },
jjg@1416 411
mcimadamore@1759 412 XDIAGS("-Xdiags:", "opt.diags", EXTENDED, BASIC, ONEOF, "compact", "verbose"),
mcimadamore@1759 413
jjg@1158 414 /* This is a back door to the compiler's option table.
jjg@1158 415 * -XDx=y sets the option x to the value y.
jjg@1158 416 * -XDx sets the option x to the value x.
jjg@1158 417 */
jjg@1158 418 XD("-XD", null, HIDDEN, BASIC) {
jjg@1158 419 @Override
jjg@1158 420 public boolean matches(String s) {
jjg@1158 421 return s.startsWith(text);
jjg@1158 422 }
jjg@1158 423 @Override
jjg@1158 424 public boolean process(OptionHelper helper, String option) {
vromero@1442 425 option = option.substring(text.length());
vromero@1442 426 int eq = option.indexOf('=');
vromero@1442 427 String key = (eq < 0) ? option : option.substring(0, eq);
vromero@1442 428 String value = (eq < 0) ? option : option.substring(eq+1);
jjg@1158 429 helper.put(key, value);
jjg@1158 430 return false;
jjg@1158 431 }
jjg@1158 432 },
jjg@1158 433
jjg@1158 434 // This option exists only for the purpose of documenting itself.
jjg@1158 435 // It's actually implemented by the CommandLine class.
jjg@1485 436 AT("@", "opt.arg.file", "opt.AT", STANDARD, INFO, true) {
jjg@1158 437 @Override
jjg@1158 438 public boolean process(OptionHelper helper, String option) {
jjg@1158 439 throw new AssertionError("the @ flag should be caught by CommandLine.");
jjg@1158 440 }
jjg@1158 441 },
jjg@1158 442
jjg@1158 443 /*
jjg@1158 444 * TODO: With apt, the matches method accepts anything if
jjg@1158 445 * -XclassAsDecls is used; code elsewhere does the lookup to
jjg@1158 446 * see if the class name is both legal and found.
jjg@1158 447 *
jjg@1158 448 * In apt, the process method adds the candidate class file
jjg@1158 449 * name to a separate list.
jjg@1158 450 */
jjg@1158 451 SOURCEFILE("sourcefile", null, HIDDEN, INFO) {
jjg@1158 452 @Override
jjg@1158 453 public boolean matches(String s) {
jjg@1158 454 return s.endsWith(".java") // Java source file
jjg@1158 455 || SourceVersion.isName(s); // Legal type name
jjg@1158 456 }
jjg@1158 457 @Override
jjg@1158 458 public boolean process(OptionHelper helper, String option) {
vromero@1442 459 if (option.endsWith(".java") ) {
vromero@1442 460 File f = new File(option);
jjg@1158 461 if (!f.exists()) {
jjg@1158 462 helper.error("err.file.not.found", f);
jjg@1158 463 return true;
jjg@1158 464 }
jjg@1158 465 if (!f.isFile()) {
jjg@1158 466 helper.error("err.file.not.file", f);
jjg@1158 467 return true;
jjg@1158 468 }
jjg@1158 469 helper.addFile(f);
vromero@1442 470 } else {
vromero@1442 471 helper.addClassName(option);
jjg@1158 472 }
jjg@1158 473 return false;
jjg@1158 474 }
jjg@1158 475 };
jjg@1158 476
jjg@1158 477 /** The kind of an Option. This is used by the -help and -X options. */
jjg@1158 478 public enum OptionKind {
jjg@1158 479 /** A standard option, documented by -help. */
jjg@1158 480 STANDARD,
jjg@1158 481 /** An extended option, documented by -X. */
jjg@1158 482 EXTENDED,
jjg@1158 483 /** A hidden option, not documented. */
jjg@1158 484 HIDDEN,
jjg@1158 485 }
jjg@1158 486
jjg@1158 487 /** The group for an Option. This determines the situations in which the
jjg@1158 488 * option is applicable. */
jjg@1158 489 enum OptionGroup {
jjg@1158 490 /** A basic option, available for use on the command line or via the
jjg@1158 491 * Compiler API. */
jjg@1158 492 BASIC,
jjg@1158 493 /** An option for javac's standard JavaFileManager. Other file managers
jjg@1158 494 * may or may not support these options. */
jjg@1158 495 FILEMANAGER,
jjg@1158 496 /** A command-line option that requests information, such as -help. */
jjg@1158 497 INFO,
jjg@1158 498 /** A command-line "option" representing a file or class name. */
jjg@1158 499 OPERAND
jjg@1158 500 }
jjg@1158 501
jjg@1158 502 /** The kind of choice for "choice" options. */
jjg@1158 503 enum ChoiceKind {
jjg@1158 504 /** The expected value is exactly one of the set of choices. */
jjg@1158 505 ONEOF,
jjg@1158 506 /** The expected value is one of more of the set of choices. */
jjg@1158 507 ANYOF
jjg@1158 508 }
jjg@1158 509
jjg@1158 510 public final String text;
jjg@1158 511
jjg@1158 512 final OptionKind kind;
jjg@1158 513
jjg@1158 514 final OptionGroup group;
jjg@1158 515
jjg@1158 516 /** Documentation key for arguments.
jjg@1158 517 */
jjg@1158 518 final String argsNameKey;
jjg@1158 519
jjg@1158 520 /** Documentation key for description.
jjg@1158 521 */
jjg@1158 522 final String descrKey;
jjg@1158 523
jjg@1158 524 /** Suffix option (-foo=bar or -foo:bar)
jjg@1158 525 */
vromero@1442 526 final boolean hasSuffix;
jjg@1158 527
jjg@1158 528 /** The kind of choices for this option, if any.
jjg@1158 529 */
jjg@1158 530 final ChoiceKind choiceKind;
jjg@1158 531
jjg@1158 532 /** The choices for this option, if any, and whether or not the choices
jjg@1158 533 * are hidden
jjg@1158 534 */
jjg@1158 535 final Map<String,Boolean> choices;
jjg@1158 536
jjg@1158 537
jjg@1158 538 Option(String text, String descrKey,
jjg@1158 539 OptionKind kind, OptionGroup group) {
vromero@1442 540 this(text, null, descrKey, kind, group, null, null, false);
jjg@1158 541 }
jjg@1158 542
jjg@1158 543 Option(String text, String argsNameKey, String descrKey,
jjg@1158 544 OptionKind kind, OptionGroup group) {
vromero@1442 545 this(text, argsNameKey, descrKey, kind, group, null, null, false);
vromero@1442 546 }
vromero@1442 547
vromero@1442 548 Option(String text, String argsNameKey, String descrKey,
vromero@1442 549 OptionKind kind, OptionGroup group, boolean doHasSuffix) {
vromero@1442 550 this(text, argsNameKey, descrKey, kind, group, null, null, doHasSuffix);
jjg@1158 551 }
jjg@1158 552
jjg@1158 553 Option(String text, String descrKey,
jjg@1158 554 OptionKind kind, OptionGroup group,
jjg@1158 555 ChoiceKind choiceKind, Map<String,Boolean> choices) {
vromero@1442 556 this(text, null, descrKey, kind, group, choiceKind, choices, false);
jjg@1158 557 }
jjg@1158 558
jjg@1158 559 Option(String text, String descrKey,
jjg@1158 560 OptionKind kind, OptionGroup group,
jjg@1158 561 ChoiceKind choiceKind, String... choices) {
vromero@1442 562 this(text, null, descrKey, kind, group, choiceKind,
vromero@1442 563 createChoices(choices), false);
jjg@1158 564 }
jjg@1158 565 // where
jjg@1158 566 private static Map<String,Boolean> createChoices(String... choices) {
jjg@1158 567 Map<String,Boolean> map = new LinkedHashMap<String,Boolean>();
jjg@1158 568 for (String c: choices)
jjg@1158 569 map.put(c, false);
jjg@1158 570 return map;
jjg@1158 571 }
jjg@1158 572
jjg@1158 573 private Option(String text, String argsNameKey, String descrKey,
jjg@1158 574 OptionKind kind, OptionGroup group,
vromero@1442 575 ChoiceKind choiceKind, Map<String,Boolean> choices,
vromero@1442 576 boolean doHasSuffix) {
jjg@1158 577 this.text = text;
jjg@1158 578 this.argsNameKey = argsNameKey;
jjg@1158 579 this.descrKey = descrKey;
jjg@1158 580 this.kind = kind;
jjg@1158 581 this.group = group;
jjg@1158 582 this.choiceKind = choiceKind;
jjg@1158 583 this.choices = choices;
jjg@1158 584 char lastChar = text.charAt(text.length()-1);
vromero@1442 585 this.hasSuffix = doHasSuffix || lastChar == ':' || lastChar == '=';
jjg@1158 586 }
jjg@1158 587
jjg@1158 588 public String getText() {
jjg@1158 589 return text;
jjg@1158 590 }
jjg@1158 591
jjg@1158 592 public OptionKind getKind() {
jjg@1158 593 return kind;
jjg@1158 594 }
jjg@1158 595
jjg@1158 596 public boolean hasArg() {
jjg@1158 597 return argsNameKey != null && !hasSuffix;
jjg@1158 598 }
jjg@1158 599
jjg@1158 600 public boolean matches(String option) {
jjg@1158 601 if (!hasSuffix)
jjg@1158 602 return option.equals(text);
jjg@1158 603
jjg@1158 604 if (!option.startsWith(text))
jjg@1158 605 return false;
jjg@1158 606
jjg@1158 607 if (choices != null) {
jjg@1158 608 String arg = option.substring(text.length());
jjg@1158 609 if (choiceKind == ChoiceKind.ONEOF)
jjg@1158 610 return choices.keySet().contains(arg);
jjg@1158 611 else {
jjg@1158 612 for (String a: arg.split(",+")) {
jjg@1158 613 if (!choices.keySet().contains(a))
jjg@1158 614 return false;
jjg@1158 615 }
jjg@1158 616 }
jjg@1158 617 }
jjg@1158 618
jjg@1158 619 return true;
jjg@1158 620 }
jjg@1158 621
jjg@1158 622 public boolean process(OptionHelper helper, String option, String arg) {
jjg@1158 623 if (choices != null) {
jjg@1158 624 if (choiceKind == ChoiceKind.ONEOF) {
jjg@1158 625 // some clients like to see just one of option+choice set
jjg@1158 626 for (String s: choices.keySet())
jjg@1158 627 helper.remove(option + s);
jjg@1158 628 String opt = option + arg;
jjg@1158 629 helper.put(opt, opt);
jjg@1158 630 // some clients like to see option (without trailing ":")
jjg@1158 631 // set to arg
jjg@1158 632 String nm = option.substring(0, option.length() - 1);
jjg@1158 633 helper.put(nm, arg);
jjg@1158 634 } else {
jjg@1158 635 // set option+word for each word in arg
jjg@1158 636 for (String a: arg.split(",+")) {
jjg@1158 637 String opt = option + a;
jjg@1158 638 helper.put(opt, opt);
jjg@1158 639 }
jjg@1158 640 }
jjg@1158 641 }
jjg@1158 642 helper.put(option, arg);
jjg@1158 643 return false;
jjg@1158 644 }
jjg@1158 645
jjg@1158 646 public boolean process(OptionHelper helper, String option) {
jjg@1158 647 if (hasSuffix)
jjg@1158 648 return process(helper, text, option.substring(text.length()));
jjg@1158 649 else
jjg@1158 650 return process(helper, option, option);
jjg@1158 651 }
jjg@1158 652
jjg@1158 653 void help(Log log, OptionKind kind) {
jjg@1158 654 if (this.kind != kind)
jjg@1158 655 return;
jjg@1158 656
jjg@1158 657 log.printRawLines(WriterKind.NOTICE,
jjg@1158 658 String.format(" %-26s %s",
jjg@1158 659 helpSynopsis(log),
jjg@1158 660 log.localize(PrefixKind.JAVAC, descrKey)));
jjg@1158 661
jjg@1158 662 }
jjg@1158 663
jjg@1158 664 private String helpSynopsis(Log log) {
jjg@1158 665 StringBuilder sb = new StringBuilder();
jjg@1158 666 sb.append(text);
jjg@1158 667 if (argsNameKey == null) {
jjg@1158 668 if (choices != null) {
jjg@1158 669 String sep = "{";
jjg@1158 670 for (Map.Entry<String,Boolean> e: choices.entrySet()) {
jjg@1158 671 if (!e.getValue()) {
jjg@1158 672 sb.append(sep);
jjg@1158 673 sb.append(e.getKey());
jjg@1158 674 sep = ",";
jjg@1158 675 }
jjg@1158 676 }
jjg@1158 677 sb.append("}");
jjg@1158 678 }
jjg@1158 679 } else {
jjg@1158 680 if (!hasSuffix)
jjg@1158 681 sb.append(" ");
jjg@1158 682 sb.append(log.localize(PrefixKind.JAVAC, argsNameKey));
jjg@1158 683
jjg@1158 684 }
jjg@1158 685
jjg@1158 686 return sb.toString();
jjg@1158 687 }
jjg@1158 688
jjg@1158 689 // For -XpkgInfo:value
jjg@1158 690 public enum PkgInfo {
jjg@1988 691 /**
jjg@1988 692 * Always generate package-info.class for every package-info.java file.
jjg@1988 693 * The file may be empty if there annotations with a RetentionPolicy
jjg@1988 694 * of CLASS or RUNTIME. This option may be useful in conjunction with
jjg@1988 695 * build systems (such as Ant) that expect javac to generate at least
jjg@1988 696 * one .class file for every .java file.
jjg@1988 697 */
jjg@1988 698 ALWAYS,
jjg@1988 699 /**
jjg@1988 700 * Generate a package-info.class file if package-info.java contains
jjg@1988 701 * annotations. The file may be empty if all the annotations have
jjg@1988 702 * a RetentionPolicy of SOURCE.
jjg@1988 703 * This value is just for backwards compatibility with earlier behavior.
jjg@1988 704 * Either of the other two values are to be preferred to using this one.
jjg@1988 705 */
jjg@1988 706 LEGACY,
jjg@1988 707 /**
jjg@1988 708 * Generate a package-info.class file if and only if there are annotations
jjg@1988 709 * in package-info.java to be written into it.
jjg@1988 710 */
jjg@1988 711 NONEMPTY;
jjg@1988 712
jjg@1158 713 public static PkgInfo get(Options options) {
jjg@1158 714 String v = options.get(XPKGINFO);
jjg@1158 715 return (v == null
jjg@1158 716 ? PkgInfo.LEGACY
jlahoda@2413 717 : PkgInfo.valueOf(StringUtils.toUpperCase(v)));
jjg@1158 718 }
jjg@1158 719 }
jjg@1158 720
jjg@1158 721 private static Map<String,Boolean> getXLintChoices() {
jjg@1158 722 Map<String,Boolean> choices = new LinkedHashMap<String,Boolean>();
jjg@1158 723 choices.put("all", false);
jjg@1158 724 for (Lint.LintCategory c : Lint.LintCategory.values())
jjg@1158 725 choices.put(c.option, c.hidden);
jjg@1158 726 for (Lint.LintCategory c : Lint.LintCategory.values())
jjg@1158 727 choices.put("-" + c.option, c.hidden);
jjg@1158 728 choices.put("none", false);
jjg@1158 729 return choices;
jjg@1158 730 }
jjg@1158 731
jjg@1158 732 static Set<Option> getJavaCompilerOptions() {
jjg@1158 733 return EnumSet.allOf(Option.class);
jjg@1158 734 }
jjg@1158 735
jjg@1158 736 public static Set<Option> getJavacFileManagerOptions() {
jjg@1158 737 return getOptions(EnumSet.of(FILEMANAGER));
jjg@1158 738 }
jjg@1158 739
jjg@1158 740 public static Set<Option> getJavacToolOptions() {
jjg@1158 741 return getOptions(EnumSet.of(BASIC));
jjg@1158 742 }
jjg@1158 743
jjg@1158 744 static Set<Option> getOptions(Set<OptionGroup> desired) {
jjg@1158 745 Set<Option> options = EnumSet.noneOf(Option.class);
jjg@1158 746 for (Option option : Option.values())
jjg@1158 747 if (desired.contains(option.group))
jjg@1158 748 options.add(option);
jjg@1158 749 return Collections.unmodifiableSet(options);
jjg@1158 750 }
jjg@1158 751
jjg@1158 752 }

mercurial