1 /*
2 * Copyright (c) 1999, 2014, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 package com.sun.tools.javac.main;
27
28 import java.io.*;
29 import java.util.Collection;
30 import java.util.HashMap;
31 import java.util.HashSet;
32 import java.util.LinkedHashMap;
33 import java.util.LinkedHashSet;
34 import java.util.Map;
35 import java.util.MissingResourceException;
36 import java.util.Queue;
37 import java.util.ResourceBundle;
38 import java.util.Set;
39
40 import javax.annotation.processing.Processor;
41 import javax.lang.model.SourceVersion;
42 import javax.tools.DiagnosticListener;
43 import javax.tools.JavaFileManager;
44 import javax.tools.JavaFileObject;
45 import javax.tools.StandardLocation;
46
47 import com.sun.source.util.TaskEvent;
48 import com.sun.tools.javac.api.MultiTaskListener;
49 import com.sun.tools.javac.code.*;
50 import com.sun.tools.javac.code.Lint.LintCategory;
51 import com.sun.tools.javac.code.Symbol.ClassSymbol;
52 import com.sun.tools.javac.code.Symbol.CompletionFailure;
53 import com.sun.tools.javac.code.Symbol.PackageSymbol;
54 import com.sun.tools.javac.comp.*;
55 import com.sun.tools.javac.comp.CompileStates.CompileState;
56 import com.sun.tools.javac.file.JavacFileManager;
57 import com.sun.tools.javac.jvm.*;
58 import com.sun.tools.javac.parser.*;
59 import com.sun.tools.javac.processing.*;
60 import com.sun.tools.javac.tree.*;
61 import com.sun.tools.javac.tree.JCTree.JCClassDecl;
62 import com.sun.tools.javac.tree.JCTree.JCCompilationUnit;
63 import com.sun.tools.javac.tree.JCTree.JCExpression;
64 import com.sun.tools.javac.tree.JCTree.JCLambda;
65 import com.sun.tools.javac.tree.JCTree.JCMemberReference;
66 import com.sun.tools.javac.tree.JCTree.JCMethodDecl;
67 import com.sun.tools.javac.tree.JCTree.JCVariableDecl;
68 import com.sun.tools.javac.util.*;
69 import com.sun.tools.javac.util.Log.WriterKind;
70
71 import static com.sun.tools.javac.code.Kinds.Kind.*;
72 import static com.sun.tools.javac.code.TypeTag.CLASS;
73 import static com.sun.tools.javac.main.Option.*;
74 import static com.sun.tools.javac.util.JCDiagnostic.DiagnosticFlag.*;
75 import static javax.tools.StandardLocation.CLASS_OUTPUT;
76
77 /** This class could be the main entry point for GJC when GJC is used as a
78 * component in a larger software system. It provides operations to
79 * construct a new compiler, and to run a new compiler on a set of source
80 * files.
81 *
82 * <p><b>This is NOT part of any supported API.
83 * If you write code that depends on this, you do so at your own risk.
84 * This code and its internal interfaces are subject to change or
85 * deletion without notice.</b>
86 */
87 public class JavaCompiler {
88 /** The context key for the compiler. */
89 protected static final Context.Key<JavaCompiler> compilerKey = new Context.Key<>();
90
91 /** Get the JavaCompiler instance for this context. */
92 public static JavaCompiler instance(Context context) {
93 JavaCompiler instance = context.get(compilerKey);
94 if (instance == null)
95 instance = new JavaCompiler(context);
96 return instance;
97 }
98
99 /** The current version number as a string.
100 */
101 public static String version() {
102 return version("release"); // mm.nn.oo[-milestone]
103 }
104
105 /** The current full version number as a string.
106 */
107 public static String fullVersion() {
108 return version("full"); // mm.mm.oo[-milestone]-build
109 }
110
111 private static final String versionRBName = "com.sun.tools.javac.resources.version";
112 private static ResourceBundle versionRB;
113
114 private static String version(String key) {
115 if (versionRB == null) {
116 try {
117 versionRB = ResourceBundle.getBundle(versionRBName);
118 } catch (MissingResourceException e) {
119 return Log.getLocalizedString("version.not.available");
120 }
121 }
122 try {
123 return versionRB.getString(key);
124 }
125 catch (MissingResourceException e) {
126 return Log.getLocalizedString("version.not.available");
127 }
128 }
129
130 /**
131 * Control how the compiler's latter phases (attr, flow, desugar, generate)
132 * are connected. Each individual file is processed by each phase in turn,
133 * but with different compile policies, you can control the order in which
134 * each class is processed through its next phase.
135 *
136 * <p>Generally speaking, the compiler will "fail fast" in the face of
137 * errors, although not aggressively so. flow, desugar, etc become no-ops
138 * once any errors have occurred. No attempt is currently made to determine
139 * if it might be safe to process a class through its next phase because
140 * it does not depend on any unrelated errors that might have occurred.
141 */
142 protected static enum CompilePolicy {
143 /**
144 * Just attribute the parse trees.
145 */
146 ATTR_ONLY,
147
148 /**
149 * Just attribute and do flow analysis on the parse trees.
150 * This should catch most user errors.
151 */
152 CHECK_ONLY,
153
154 /**
155 * Attribute everything, then do flow analysis for everything,
156 * then desugar everything, and only then generate output.
157 * This means no output will be generated if there are any
158 * errors in any classes.
159 */
160 SIMPLE,
161
162 /**
163 * Groups the classes for each source file together, then process
164 * each group in a manner equivalent to the {@code SIMPLE} policy.
165 * This means no output will be generated if there are any
166 * errors in any of the classes in a source file.
167 */
168 BY_FILE,
169
170 /**
171 * Completely process each entry on the todo list in turn.
172 * -- this is the same for 1.5.
173 * Means output might be generated for some classes in a compilation unit
174 * and not others.
175 */
176 BY_TODO;
177
178 static CompilePolicy decode(String option) {
179 if (option == null)
180 return DEFAULT_COMPILE_POLICY;
181 else if (option.equals("attr"))
182 return ATTR_ONLY;
183 else if (option.equals("check"))
184 return CHECK_ONLY;
185 else if (option.equals("simple"))
186 return SIMPLE;
187 else if (option.equals("byfile"))
188 return BY_FILE;
189 else if (option.equals("bytodo"))
190 return BY_TODO;
191 else
192 return DEFAULT_COMPILE_POLICY;
193 }
194 }
195
196 private static final CompilePolicy DEFAULT_COMPILE_POLICY = CompilePolicy.BY_TODO;
197
198 protected static enum ImplicitSourcePolicy {
199 /** Don't generate or process implicitly read source files. */
200 NONE,
201 /** Generate classes for implicitly read source files. */
202 CLASS,
203 /** Like CLASS, but generate warnings if annotation processing occurs */
204 UNSET;
205
206 static ImplicitSourcePolicy decode(String option) {
207 if (option == null)
208 return UNSET;
209 else if (option.equals("none"))
210 return NONE;
211 else if (option.equals("class"))
212 return CLASS;
213 else
214 return UNSET;
215 }
216 }
217
218 /** The log to be used for error reporting.
219 */
220 public Log log;
221
222 /** Factory for creating diagnostic objects
223 */
224 JCDiagnostic.Factory diagFactory;
225
226 /** The tree factory module.
227 */
228 protected TreeMaker make;
229
230 /** The class finder.
231 */
232 protected ClassFinder finder;
233
234 /** The class reader.
235 */
236 protected ClassReader reader;
237
238 /** The class writer.
239 */
240 protected ClassWriter writer;
241
242 /** The native header writer.
243 */
244 protected JNIWriter jniWriter;
245
246 /** The module for the symbol table entry phases.
247 */
248 protected Enter enter;
249
250 /** The symbol table.
251 */
252 protected Symtab syms;
253
254 /** The language version.
255 */
256 protected Source source;
257
258 /** The module for code generation.
259 */
260 protected Gen gen;
261
262 /** The name table.
263 */
264 protected Names names;
265
266 /** The attributor.
267 */
268 protected Attr attr;
269
270 /** The attributor.
271 */
272 protected Check chk;
273
274 /** The flow analyzer.
275 */
276 protected Flow flow;
277
278 /** The type eraser.
279 */
280 protected TransTypes transTypes;
281
282 /** The syntactic sugar desweetener.
283 */
284 protected Lower lower;
285
286 /** The annotation annotator.
287 */
288 protected Annotate annotate;
289
290 /** Force a completion failure on this name
291 */
292 protected final Name completionFailureName;
293
294 /** Type utilities.
295 */
296 protected Types types;
297
298 /** Access to file objects.
299 */
300 protected JavaFileManager fileManager;
301
302 /** Factory for parsers.
303 */
304 protected ParserFactory parserFactory;
305
306 /** Broadcasting listener for progress events
307 */
308 protected MultiTaskListener taskListener;
309
310 /**
311 * SourceCompleter that delegates to the readSourceFile method of this class.
312 */
313 protected final Symbol.Completer sourceCompleter =
314 new Symbol.Completer() {
315 @Override
316 public void complete(Symbol sym) throws CompletionFailure {
317 readSourceFile((ClassSymbol) sym);
318 }
319 };
320
321 /**
322 * Command line options.
323 */
324 protected Options options;
325
326 protected Context context;
327
328 /**
329 * Flag set if any annotation processing occurred.
330 **/
331 protected boolean annotationProcessingOccurred;
332
333 /**
334 * Flag set if any implicit source files read.
335 **/
336 protected boolean implicitSourceFilesRead;
337
338 protected CompileStates compileStates;
339
340 /** Construct a new compiler using a shared context.
341 */
342 public JavaCompiler(Context context) {
343 this.context = context;
344 context.put(compilerKey, this);
345
346 // if fileManager not already set, register the JavacFileManager to be used
347 if (context.get(JavaFileManager.class) == null)
348 JavacFileManager.preRegister(context);
349
350 names = Names.instance(context);
351 log = Log.instance(context);
352 diagFactory = JCDiagnostic.Factory.instance(context);
353 finder = ClassFinder.instance(context);
354 reader = ClassReader.instance(context);
355 make = TreeMaker.instance(context);
356 writer = ClassWriter.instance(context);
357 jniWriter = JNIWriter.instance(context);
358 enter = Enter.instance(context);
359 todo = Todo.instance(context);
360
361 fileManager = context.get(JavaFileManager.class);
362 parserFactory = ParserFactory.instance(context);
363 compileStates = CompileStates.instance(context);
364
365 try {
366 // catch completion problems with predefineds
367 syms = Symtab.instance(context);
368 } catch (CompletionFailure ex) {
369 // inlined Check.completionError as it is not initialized yet
370 log.error("cant.access", ex.sym, ex.getDetailValue());
371 if (ex instanceof ClassFinder.BadClassFile)
372 throw new Abort();
373 }
374 source = Source.instance(context);
375 Target target = Target.instance(context);
376 attr = Attr.instance(context);
377 chk = Check.instance(context);
378 gen = Gen.instance(context);
379 flow = Flow.instance(context);
380 transTypes = TransTypes.instance(context);
381 lower = Lower.instance(context);
382 annotate = Annotate.instance(context);
383 types = Types.instance(context);
384 taskListener = MultiTaskListener.instance(context);
385
386 finder.sourceCompleter = sourceCompleter;
387
388 options = Options.instance(context);
389
390 verbose = options.isSet(VERBOSE);
391 sourceOutput = options.isSet(PRINTSOURCE); // used to be -s
392 stubOutput = options.isSet("-stubs");
393 relax = options.isSet("-relax");
394 printFlat = options.isSet("-printflat");
395 attrParseOnly = options.isSet("-attrparseonly");
396 encoding = options.get(ENCODING);
397 lineDebugInfo = options.isUnset(G_CUSTOM) ||
398 options.isSet(G_CUSTOM, "lines");
399 genEndPos = options.isSet(XJCOV) ||
400 context.get(DiagnosticListener.class) != null;
401 devVerbose = options.isSet("dev");
402 processPcks = options.isSet("process.packages");
403 werror = options.isSet(WERROR);
404
405 verboseCompilePolicy = options.isSet("verboseCompilePolicy");
406
407 if (attrParseOnly)
408 compilePolicy = CompilePolicy.ATTR_ONLY;
409 else
410 compilePolicy = CompilePolicy.decode(options.get("compilePolicy"));
411
412 implicitSourcePolicy = ImplicitSourcePolicy.decode(options.get("-implicit"));
413
414 completionFailureName =
415 options.isSet("failcomplete")
416 ? names.fromString(options.get("failcomplete"))
417 : null;
418
419 shouldStopPolicyIfError =
420 options.isSet("shouldStopPolicy") // backwards compatible
421 ? CompileState.valueOf(options.get("shouldStopPolicy"))
422 : options.isSet("shouldStopPolicyIfError")
423 ? CompileState.valueOf(options.get("shouldStopPolicyIfError"))
424 : CompileState.INIT;
425 shouldStopPolicyIfNoError =
426 options.isSet("shouldStopPolicyIfNoError")
427 ? CompileState.valueOf(options.get("shouldStopPolicyIfNoError"))
428 : CompileState.GENERATE;
429
430 if (options.isUnset("oldDiags"))
431 log.setDiagnosticFormatter(RichDiagnosticFormatter.instance(context));
432 }
433
434 /* Switches:
435 */
436
437 /** Verbose output.
438 */
439 public boolean verbose;
440
441 /** Emit plain Java source files rather than class files.
442 */
443 public boolean sourceOutput;
444
445 /** Emit stub source files rather than class files.
446 */
447 public boolean stubOutput;
448
449 /** Generate attributed parse tree only.
450 */
451 public boolean attrParseOnly;
452
453 /** Switch: relax some constraints for producing the jsr14 prototype.
454 */
455 boolean relax;
456
457 /** Debug switch: Emit Java sources after inner class flattening.
458 */
459 public boolean printFlat;
460
461 /** The encoding to be used for source input.
462 */
463 public String encoding;
464
465 /** Generate code with the LineNumberTable attribute for debugging
466 */
467 public boolean lineDebugInfo;
468
469 /** Switch: should we store the ending positions?
470 */
471 public boolean genEndPos;
472
473 /** Switch: should we debug ignored exceptions
474 */
475 protected boolean devVerbose;
476
477 /** Switch: should we (annotation) process packages as well
478 */
479 protected boolean processPcks;
480
481 /** Switch: treat warnings as errors
482 */
483 protected boolean werror;
484
485 /** Switch: is annotation processing requested explicitly via
486 * CompilationTask.setProcessors?
487 */
488 protected boolean explicitAnnotationProcessingRequested = false;
489
490 /**
491 * The policy for the order in which to perform the compilation
492 */
493 protected CompilePolicy compilePolicy;
494
495 /**
496 * The policy for what to do with implicitly read source files
497 */
498 protected ImplicitSourcePolicy implicitSourcePolicy;
499
500 /**
501 * Report activity related to compilePolicy
502 */
503 public boolean verboseCompilePolicy;
504
505 /**
506 * Policy of how far to continue compilation after errors have occurred.
507 * Set this to minimum CompileState (INIT) to stop as soon as possible
508 * after errors.
509 */
510 public CompileState shouldStopPolicyIfError;
511
512 /**
513 * Policy of how far to continue compilation when no errors have occurred.
514 * Set this to maximum CompileState (GENERATE) to perform full compilation.
515 * Set this lower to perform partial compilation, such as -proc:only.
516 */
517 public CompileState shouldStopPolicyIfNoError;
518
519 /** A queue of all as yet unattributed classes.
520 */
521 public Todo todo;
522
523 /** A list of items to be closed when the compilation is complete.
524 */
525 public List<Closeable> closeables = List.nil();
526
527 /** The set of currently compiled inputfiles, needed to ensure
528 * we don't accidentally overwrite an input file when -s is set.
529 * initialized by `compile'.
530 */
531 protected Set<JavaFileObject> inputFiles = new HashSet<>();
532
533 protected boolean shouldStop(CompileState cs) {
534 CompileState shouldStopPolicy = (errorCount() > 0 || unrecoverableError())
535 ? shouldStopPolicyIfError
536 : shouldStopPolicyIfNoError;
537 return cs.isAfter(shouldStopPolicy);
538 }
539
540 /** The number of errors reported so far.
541 */
542 public int errorCount() {
543 if (werror && log.nerrors == 0 && log.nwarnings > 0) {
544 log.error("warnings.and.werror");
545 }
546 return log.nerrors;
547 }
548
549 protected final <T> Queue<T> stopIfError(CompileState cs, Queue<T> queue) {
550 return shouldStop(cs) ? new ListBuffer<T>() : queue;
551 }
552
553 protected final <T> List<T> stopIfError(CompileState cs, List<T> list) {
554 return shouldStop(cs) ? List.<T>nil() : list;
555 }
556
557 /** The number of warnings reported so far.
558 */
559 public int warningCount() {
560 return log.nwarnings;
561 }
562
563 /** Try to open input stream with given name.
564 * Report an error if this fails.
565 * @param filename The file name of the input stream to be opened.
566 */
567 public CharSequence readSource(JavaFileObject filename) {
568 try {
569 inputFiles.add(filename);
570 return filename.getCharContent(false);
571 } catch (IOException e) {
572 log.error("error.reading.file", filename, JavacFileManager.getMessage(e));
573 return null;
574 }
575 }
576
577 /** Parse contents of input stream.
578 * @param filename The name of the file from which input stream comes.
579 * @param content The characters to be parsed.
580 */
581 protected JCCompilationUnit parse(JavaFileObject filename, CharSequence content) {
582 long msec = now();
583 JCCompilationUnit tree = make.TopLevel(List.<JCTree>nil());
584 if (content != null) {
585 if (verbose) {
586 log.printVerbose("parsing.started", filename);
587 }
588 if (!taskListener.isEmpty()) {
589 TaskEvent e = new TaskEvent(TaskEvent.Kind.PARSE, filename);
590 taskListener.started(e);
591 keepComments = true;
592 genEndPos = true;
593 }
594 Parser parser = parserFactory.newParser(content, keepComments(), genEndPos, lineDebugInfo);
595 tree = parser.parseCompilationUnit();
596 if (verbose) {
597 log.printVerbose("parsing.done", Long.toString(elapsed(msec)));
598 }
599 }
600
601 tree.sourcefile = filename;
602
603 if (content != null && !taskListener.isEmpty()) {
604 TaskEvent e = new TaskEvent(TaskEvent.Kind.PARSE, tree);
605 taskListener.finished(e);
606 }
607
608 return tree;
609 }
610 // where
611 public boolean keepComments = false;
612 protected boolean keepComments() {
613 return keepComments || sourceOutput || stubOutput;
614 }
615
616
617 /** Parse contents of file.
618 * @param filename The name of the file to be parsed.
619 */
620 @Deprecated
621 public JCTree.JCCompilationUnit parse(String filename) {
622 JavacFileManager fm = (JavacFileManager)fileManager;
623 return parse(fm.getJavaFileObjectsFromStrings(List.of(filename)).iterator().next());
624 }
625
626 /** Parse contents of file.
627 * @param filename The name of the file to be parsed.
628 */
629 public JCTree.JCCompilationUnit parse(JavaFileObject filename) {
630 JavaFileObject prev = log.useSource(filename);
631 try {
632 JCTree.JCCompilationUnit t = parse(filename, readSource(filename));
633 if (t.endPositions != null)
634 log.setEndPosTable(filename, t.endPositions);
635 return t;
636 } finally {
637 log.useSource(prev);
638 }
639 }
640
641 /** Resolve an identifier which may be the binary name of a class or
642 * the Java name of a class or package.
643 * @param name The name to resolve
644 */
645 public Symbol resolveBinaryNameOrIdent(String name) {
646 try {
647 Name flatname = names.fromString(name.replace("/", "."));
648 return finder.loadClass(flatname);
649 } catch (CompletionFailure ignore) {
650 return resolveIdent(name);
651 }
652 }
653
654 /** Resolve an identifier.
655 * @param name The identifier to resolve
656 */
657 public Symbol resolveIdent(String name) {
658 if (name.equals(""))
659 return syms.errSymbol;
660 JavaFileObject prev = log.useSource(null);
661 try {
662 JCExpression tree = null;
663 for (String s : name.split("\\.", -1)) {
664 if (!SourceVersion.isIdentifier(s)) // TODO: check for keywords
665 return syms.errSymbol;
666 tree = (tree == null) ? make.Ident(names.fromString(s))
667 : make.Select(tree, names.fromString(s));
668 }
669 JCCompilationUnit toplevel =
670 make.TopLevel(List.<JCTree>nil());
671 toplevel.packge = syms.unnamedPackage;
672 return attr.attribIdent(tree, toplevel);
673 } finally {
674 log.useSource(prev);
675 }
676 }
677
678 /** Emit plain Java source for a class.
679 * @param env The attribution environment of the outermost class
680 * containing this class.
681 * @param cdef The class definition to be printed.
682 */
683 JavaFileObject printSource(Env<AttrContext> env, JCClassDecl cdef) throws IOException {
684 JavaFileObject outFile
685 = fileManager.getJavaFileForOutput(CLASS_OUTPUT,
686 cdef.sym.flatname.toString(),
687 JavaFileObject.Kind.SOURCE,
688 null);
689 if (inputFiles.contains(outFile)) {
690 log.error(cdef.pos(), "source.cant.overwrite.input.file", outFile);
691 return null;
692 } else {
693 try (BufferedWriter out = new BufferedWriter(outFile.openWriter())) {
694 new Pretty(out, true).printUnit(env.toplevel, cdef);
695 if (verbose)
696 log.printVerbose("wrote.file", outFile);
697 }
698 return outFile;
699 }
700 }
701
702 /** Generate code and emit a class file for a given class
703 * @param env The attribution environment of the outermost class
704 * containing this class.
705 * @param cdef The class definition from which code is generated.
706 */
707 JavaFileObject genCode(Env<AttrContext> env, JCClassDecl cdef) throws IOException {
708 try {
709 if (gen.genClass(env, cdef) && (errorCount() == 0))
710 return writer.writeClass(cdef.sym);
711 } catch (ClassWriter.PoolOverflow ex) {
712 log.error(cdef.pos(), "limit.pool");
713 } catch (ClassWriter.StringOverflow ex) {
714 log.error(cdef.pos(), "limit.string.overflow",
715 ex.value.substring(0, 20));
716 } catch (CompletionFailure ex) {
717 chk.completionError(cdef.pos(), ex);
718 }
719 return null;
720 }
721
722 /** Compile a source file that has been accessed by the class finder.
723 * @param c The class the source file of which needs to be compiled.
724 */
725 private void readSourceFile(ClassSymbol c) throws CompletionFailure {
726 readSourceFile(null, c);
727 }
728
729 /** Compile a ClassSymbol from source, optionally using the given compilation unit as
730 * the source tree.
731 * @param tree the compilation unit in which the given ClassSymbol resides,
732 * or null if should be parsed from source
733 * @param c the ClassSymbol to complete
734 */
735 public void readSourceFile(JCCompilationUnit tree, ClassSymbol c) throws CompletionFailure {
736 if (completionFailureName == c.fullname) {
737 throw new CompletionFailure(c, "user-selected completion failure by class name");
738 }
739 JavaFileObject filename = c.classfile;
740 JavaFileObject prev = log.useSource(filename);
741
742 if (tree == null) {
743 try {
744 tree = parse(filename, filename.getCharContent(false));
745 } catch (IOException e) {
746 log.error("error.reading.file", filename, JavacFileManager.getMessage(e));
747 tree = make.TopLevel(List.<JCTree>nil());
748 } finally {
749 log.useSource(prev);
750 }
751 }
752
753 if (!taskListener.isEmpty()) {
754 TaskEvent e = new TaskEvent(TaskEvent.Kind.ENTER, tree);
755 taskListener.started(e);
756 }
757
758 enter.complete(List.of(tree), c);
759
760 if (!taskListener.isEmpty()) {
761 TaskEvent e = new TaskEvent(TaskEvent.Kind.ENTER, tree);
762 taskListener.finished(e);
763 }
764
765 if (enter.getEnv(c) == null) {
766 boolean isPkgInfo =
767 tree.sourcefile.isNameCompatible("package-info",
768 JavaFileObject.Kind.SOURCE);
769 if (isPkgInfo) {
770 if (enter.getEnv(tree.packge) == null) {
771 JCDiagnostic diag =
772 diagFactory.fragment("file.does.not.contain.package",
773 c.location());
774 throw new ClassFinder.BadClassFile(c, filename, diag, diagFactory);
775 }
776 } else {
777 JCDiagnostic diag =
778 diagFactory.fragment("file.doesnt.contain.class",
779 c.getQualifiedName());
780 throw new ClassFinder.BadClassFile(c, filename, diag, diagFactory);
781 }
782 }
783
784 implicitSourceFilesRead = true;
785 }
786
787 /** Track when the JavaCompiler has been used to compile something. */
788 private boolean hasBeenUsed = false;
789 private long start_msec = 0;
790 public long elapsed_msec = 0;
791
792 public void compile(List<JavaFileObject> sourceFileObject)
793 throws Throwable {
794 compile(sourceFileObject, List.<String>nil(), null);
795 }
796
797 /**
798 * Main method: compile a list of files, return all compiled classes
799 *
800 * @param sourceFileObjects file objects to be compiled
801 * @param classnames class names to process for annotations
802 * @param processors user provided annotation processors to bypass
803 * discovery, {@code null} means that no processors were provided
804 */
805 public void compile(Collection<JavaFileObject> sourceFileObjects,
806 Collection<String> classnames,
807 Iterable<? extends Processor> processors)
808 {
809 if (!taskListener.isEmpty()) {
810 taskListener.started(new TaskEvent(TaskEvent.Kind.COMPILATION));
811 }
812
813 if (processors != null && processors.iterator().hasNext())
814 explicitAnnotationProcessingRequested = true;
815 // as a JavaCompiler can only be used once, throw an exception if
816 // it has been used before.
817 if (hasBeenUsed)
818 throw new AssertionError("attempt to reuse JavaCompiler");
819 hasBeenUsed = true;
820
821 // forcibly set the equivalent of -Xlint:-options, so that no further
822 // warnings about command line options are generated from this point on
823 options.put(XLINT_CUSTOM.text + "-" + LintCategory.OPTIONS.option, "true");
824 options.remove(XLINT_CUSTOM.text + LintCategory.OPTIONS.option);
825
826 start_msec = now();
827
828 try {
829 initProcessAnnotations(processors);
830
831 // These method calls must be chained to avoid memory leaks
832 processAnnotations(
833 enterTrees(stopIfError(CompileState.PARSE, parseFiles(sourceFileObjects))),
834 classnames);
835
836 // If it's safe to do so, skip attr / flow / gen for implicit classes
837 if (taskListener.isEmpty() &&
838 implicitSourcePolicy == ImplicitSourcePolicy.NONE) {
839 todo.retainFiles(inputFiles);
840 }
841
842 switch (compilePolicy) {
843 case ATTR_ONLY:
844 attribute(todo);
845 break;
846
847 case CHECK_ONLY:
848 flow(attribute(todo));
849 break;
850
851 case SIMPLE:
852 generate(desugar(flow(attribute(todo))));
853 break;
854
855 case BY_FILE: {
856 Queue<Queue<Env<AttrContext>>> q = todo.groupByFile();
857 while (!q.isEmpty() && !shouldStop(CompileState.ATTR)) {
858 generate(desugar(flow(attribute(q.remove()))));
859 }
860 }
861 break;
862
863 case BY_TODO:
864 while (!todo.isEmpty())
865 generate(desugar(flow(attribute(todo.remove()))));
866 break;
867
868 default:
869 Assert.error("unknown compile policy");
870 }
871 } catch (Abort ex) {
872 if (devVerbose)
873 ex.printStackTrace(System.err);
874 } finally {
875 if (verbose) {
876 elapsed_msec = elapsed(start_msec);
877 log.printVerbose("total", Long.toString(elapsed_msec));
878 }
879
880 reportDeferredDiagnostics();
881
882 if (!log.hasDiagnosticListener()) {
883 printCount("error", errorCount());
884 printCount("warn", warningCount());
885 }
886 if (!taskListener.isEmpty()) {
887 taskListener.finished(new TaskEvent(TaskEvent.Kind.COMPILATION));
888 }
889 close();
890 if (procEnvImpl != null)
891 procEnvImpl.close();
892 }
893 }
894
895 /**
896 * Set needRootClasses to true, in JavaCompiler subclass constructor
897 * that want to collect public apis of classes supplied on the command line.
898 */
899 protected boolean needRootClasses = false;
900
901 /**
902 * The list of classes explicitly supplied on the command line for compilation.
903 * Not always populated.
904 */
905 private List<JCClassDecl> rootClasses;
906
907 /**
908 * Parses a list of files.
909 */
910 public List<JCCompilationUnit> parseFiles(Iterable<JavaFileObject> fileObjects) {
911 if (shouldStop(CompileState.PARSE))
912 return List.nil();
913
914 //parse all files
915 ListBuffer<JCCompilationUnit> trees = new ListBuffer<>();
916 Set<JavaFileObject> filesSoFar = new HashSet<>();
917 for (JavaFileObject fileObject : fileObjects) {
918 if (!filesSoFar.contains(fileObject)) {
919 filesSoFar.add(fileObject);
920 trees.append(parse(fileObject));
921 }
922 }
923 return trees.toList();
924 }
925
926 /**
927 * Enter the symbols found in a list of parse trees if the compilation
928 * is expected to proceed beyond anno processing into attr.
929 * As a side-effect, this puts elements on the "todo" list.
930 * Also stores a list of all top level classes in rootClasses.
931 */
932 public List<JCCompilationUnit> enterTreesIfNeeded(List<JCCompilationUnit> roots) {
933 if (shouldStop(CompileState.ATTR))
934 return List.nil();
935 return enterTrees(roots);
936 }
937
938 /**
939 * Enter the symbols found in a list of parse trees.
940 * As a side-effect, this puts elements on the "todo" list.
941 * Also stores a list of all top level classes in rootClasses.
942 */
943 public List<JCCompilationUnit> enterTrees(List<JCCompilationUnit> roots) {
944 //enter symbols for all files
945 if (!taskListener.isEmpty()) {
946 for (JCCompilationUnit unit: roots) {
947 TaskEvent e = new TaskEvent(TaskEvent.Kind.ENTER, unit);
948 taskListener.started(e);
949 }
950 }
951
952 enter.main(roots);
953
954 if (!taskListener.isEmpty()) {
955 for (JCCompilationUnit unit: roots) {
956 TaskEvent e = new TaskEvent(TaskEvent.Kind.ENTER, unit);
957 taskListener.finished(e);
958 }
959 }
960
961 // If generating source, or if tracking public apis,
962 // then remember the classes declared in
963 // the original compilation units listed on the command line.
964 if (needRootClasses || sourceOutput || stubOutput) {
965 ListBuffer<JCClassDecl> cdefs = new ListBuffer<>();
966 for (JCCompilationUnit unit : roots) {
967 for (List<JCTree> defs = unit.defs;
968 defs.nonEmpty();
969 defs = defs.tail) {
970 if (defs.head instanceof JCClassDecl)
971 cdefs.append((JCClassDecl)defs.head);
972 }
973 }
974 rootClasses = cdefs.toList();
975 }
976
977 // Ensure the input files have been recorded. Although this is normally
978 // done by readSource, it may not have been done if the trees were read
979 // in a prior round of annotation processing, and the trees have been
980 // cleaned and are being reused.
981 for (JCCompilationUnit unit : roots) {
982 inputFiles.add(unit.sourcefile);
983 }
984
985 return roots;
986 }
987
988 /**
989 * Set to true to enable skeleton annotation processing code.
990 * Currently, we assume this variable will be replaced more
991 * advanced logic to figure out if annotation processing is
992 * needed.
993 */
994 boolean processAnnotations = false;
995
996 Log.DeferredDiagnosticHandler deferredDiagnosticHandler;
997
998 /**
999 * Object to handle annotation processing.
1000 */
1001 private JavacProcessingEnvironment procEnvImpl = null;
1002
1003 /**
1004 * Check if we should process annotations.
1005 * If so, and if no scanner is yet registered, then set up the DocCommentScanner
1006 * to catch doc comments, and set keepComments so the parser records them in
1007 * the compilation unit.
1008 *
1009 * @param processors user provided annotation processors to bypass
1010 * discovery, {@code null} means that no processors were provided
1011 */
1012 public void initProcessAnnotations(Iterable<? extends Processor> processors) {
1013 // Process annotations if processing is not disabled and there
1014 // is at least one Processor available.
1015 if (options.isSet(PROC, "none")) {
1016 processAnnotations = false;
1017 } else if (procEnvImpl == null) {
1018 procEnvImpl = JavacProcessingEnvironment.instance(context);
1019 procEnvImpl.setProcessors(processors);
1020 processAnnotations = procEnvImpl.atLeastOneProcessor();
1021
1022 if (processAnnotations) {
1023 options.put("save-parameter-names", "save-parameter-names");
1024 reader.saveParameterNames = true;
1025 keepComments = true;
1026 genEndPos = true;
1027 if (!taskListener.isEmpty())
1028 taskListener.started(new TaskEvent(TaskEvent.Kind.ANNOTATION_PROCESSING));
1029 deferredDiagnosticHandler = new Log.DeferredDiagnosticHandler(log);
1030 } else { // free resources
1031 procEnvImpl.close();
1032 }
1033 }
1034 }
1035
1036 // TODO: called by JavacTaskImpl
1037 public void processAnnotations(List<JCCompilationUnit> roots) {
1038 processAnnotations(roots, List.<String>nil());
1039 }
1040
1041 /**
1042 * Process any annotations found in the specified compilation units.
1043 * @param roots a list of compilation units
1044 * @return an instance of the compiler in which to complete the compilation
1045 */
1046 // Implementation note: when this method is called, log.deferredDiagnostics
1047 // will have been set true by initProcessAnnotations, meaning that any diagnostics
1048 // that are reported will go into the log.deferredDiagnostics queue.
1049 // By the time this method exits, log.deferDiagnostics must be set back to false,
1050 // and all deferredDiagnostics must have been handled: i.e. either reported
1051 // or determined to be transient, and therefore suppressed.
1052 public void processAnnotations(List<JCCompilationUnit> roots,
1053 Collection<String> classnames) {
1054 if (shouldStop(CompileState.PROCESS)) {
1055 // Errors were encountered.
1056 // Unless all the errors are resolve errors, the errors were parse errors
1057 // or other errors during enter which cannot be fixed by running
1058 // any annotation processors.
1059 if (unrecoverableError()) {
1060 deferredDiagnosticHandler.reportDeferredDiagnostics();
1061 log.popDiagnosticHandler(deferredDiagnosticHandler);
1062 return ;
1063 }
1064 }
1065
1066 // ASSERT: processAnnotations and procEnvImpl should have been set up by
1067 // by initProcessAnnotations
1068
1069 // NOTE: The !classnames.isEmpty() checks should be refactored to Main.
1070
1071 if (!processAnnotations) {
1072 // If there are no annotation processors present, and
1073 // annotation processing is to occur with compilation,
1074 // emit a warning.
1075 if (options.isSet(PROC, "only")) {
1076 log.warning("proc.proc-only.requested.no.procs");
1077 todo.clear();
1078 }
1079 // If not processing annotations, classnames must be empty
1080 if (!classnames.isEmpty()) {
1081 log.error("proc.no.explicit.annotation.processing.requested",
1082 classnames);
1083 }
1084 Assert.checkNull(deferredDiagnosticHandler);
1085 return ; // continue regular compilation
1086 }
1087
1088 Assert.checkNonNull(deferredDiagnosticHandler);
1089
1090 try {
1091 List<ClassSymbol> classSymbols = List.nil();
1092 List<PackageSymbol> pckSymbols = List.nil();
1093 if (!classnames.isEmpty()) {
1094 // Check for explicit request for annotation
1095 // processing
1096 if (!explicitAnnotationProcessingRequested()) {
1097 log.error("proc.no.explicit.annotation.processing.requested",
1098 classnames);
1099 deferredDiagnosticHandler.reportDeferredDiagnostics();
1100 log.popDiagnosticHandler(deferredDiagnosticHandler);
1101 return ; // TODO: Will this halt compilation?
1102 } else {
1103 boolean errors = false;
1104 for (String nameStr : classnames) {
1105 Symbol sym = resolveBinaryNameOrIdent(nameStr);
1106 if (sym == null ||
1107 (sym.kind == PCK && !processPcks) ||
1108 sym.kind == ABSENT_TYP) {
1109 log.error("proc.cant.find.class", nameStr);
1110 errors = true;
1111 continue;
1112 }
1113 try {
1114 if (sym.kind == PCK)
1115 sym.complete();
1116 if (sym.exists()) {
1117 if (sym.kind == PCK)
1118 pckSymbols = pckSymbols.prepend((PackageSymbol)sym);
1119 else
1120 classSymbols = classSymbols.prepend((ClassSymbol)sym);
1121 continue;
1122 }
1123 Assert.check(sym.kind == PCK);
1124 log.warning("proc.package.does.not.exist", nameStr);
1125 pckSymbols = pckSymbols.prepend((PackageSymbol)sym);
1126 } catch (CompletionFailure e) {
1127 log.error("proc.cant.find.class", nameStr);
1128 errors = true;
1129 continue;
1130 }
1131 }
1132 if (errors) {
1133 deferredDiagnosticHandler.reportDeferredDiagnostics();
1134 log.popDiagnosticHandler(deferredDiagnosticHandler);
1135 return ;
1136 }
1137 }
1138 }
1139 try {
1140 annotationProcessingOccurred =
1141 procEnvImpl.doProcessing(roots,
1142 classSymbols,
1143 pckSymbols,
1144 deferredDiagnosticHandler);
1145 // doProcessing will have handled deferred diagnostics
1146 } finally {
1147 procEnvImpl.close();
1148 }
1149 } catch (CompletionFailure ex) {
1150 log.error("cant.access", ex.sym, ex.getDetailValue());
1151 if (deferredDiagnosticHandler != null) {
1152 deferredDiagnosticHandler.reportDeferredDiagnostics();
1153 log.popDiagnosticHandler(deferredDiagnosticHandler);
1154 }
1155 }
1156 }
1157
1158 private boolean unrecoverableError() {
1159 if (deferredDiagnosticHandler != null) {
1160 for (JCDiagnostic d: deferredDiagnosticHandler.getDiagnostics()) {
1161 if (d.getKind() == JCDiagnostic.Kind.ERROR && !d.isFlagSet(RECOVERABLE))
1162 return true;
1163 }
1164 }
1165 return false;
1166 }
1167
1168 boolean explicitAnnotationProcessingRequested() {
1169 return
1170 explicitAnnotationProcessingRequested ||
1171 explicitAnnotationProcessingRequested(options);
1172 }
1173
1174 static boolean explicitAnnotationProcessingRequested(Options options) {
1175 return
1176 options.isSet(PROCESSOR) ||
1177 options.isSet(PROCESSORPATH) ||
1178 options.isSet(PROC, "only") ||
1179 options.isSet(XPRINT);
1180 }
1181
1182 public void setDeferredDiagnosticHandler(Log.DeferredDiagnosticHandler deferredDiagnosticHandler) {
1183 this.deferredDiagnosticHandler = deferredDiagnosticHandler;
1184 }
1185
1186 /**
1187 * Attribute a list of parse trees, such as found on the "todo" list.
1188 * Note that attributing classes may cause additional files to be
1189 * parsed and entered via the SourceCompleter.
1190 * Attribution of the entries in the list does not stop if any errors occur.
1191 * @returns a list of environments for attributd classes.
1192 */
1193 public Queue<Env<AttrContext>> attribute(Queue<Env<AttrContext>> envs) {
1194 ListBuffer<Env<AttrContext>> results = new ListBuffer<>();
1195 while (!envs.isEmpty())
1196 results.append(attribute(envs.remove()));
1197 return stopIfError(CompileState.ATTR, results);
1198 }
1199
1200 /**
1201 * Attribute a parse tree.
1202 * @returns the attributed parse tree
1203 */
1204 public Env<AttrContext> attribute(Env<AttrContext> env) {
1205 if (compileStates.isDone(env, CompileState.ATTR))
1206 return env;
1207
1208 if (verboseCompilePolicy)
1209 printNote("[attribute " + env.enclClass.sym + "]");
1210 if (verbose)
1211 log.printVerbose("checking.attribution", env.enclClass.sym);
1212
1213 if (!taskListener.isEmpty()) {
1214 TaskEvent e = new TaskEvent(TaskEvent.Kind.ANALYZE, env.toplevel, env.enclClass.sym);
1215 taskListener.started(e);
1216 }
1217
1218 JavaFileObject prev = log.useSource(
1219 env.enclClass.sym.sourcefile != null ?
1220 env.enclClass.sym.sourcefile :
1221 env.toplevel.sourcefile);
1222 try {
1223 attr.attrib(env);
1224 if (errorCount() > 0 && !shouldStop(CompileState.ATTR)) {
1225 //if in fail-over mode, ensure that AST expression nodes
1226 //are correctly initialized (e.g. they have a type/symbol)
1227 attr.postAttr(env.tree);
1228 }
1229 compileStates.put(env, CompileState.ATTR);
1230 }
1231 finally {
1232 log.useSource(prev);
1233 }
1234
1235 return env;
1236 }
1237
1238 /**
1239 * Perform dataflow checks on attributed parse trees.
1240 * These include checks for definite assignment and unreachable statements.
1241 * If any errors occur, an empty list will be returned.
1242 * @returns the list of attributed parse trees
1243 */
1244 public Queue<Env<AttrContext>> flow(Queue<Env<AttrContext>> envs) {
1245 ListBuffer<Env<AttrContext>> results = new ListBuffer<>();
1246 for (Env<AttrContext> env: envs) {
1247 flow(env, results);
1248 }
1249 return stopIfError(CompileState.FLOW, results);
1250 }
1251
1252 /**
1253 * Perform dataflow checks on an attributed parse tree.
1254 */
1255 public Queue<Env<AttrContext>> flow(Env<AttrContext> env) {
1256 ListBuffer<Env<AttrContext>> results = new ListBuffer<>();
1257 flow(env, results);
1258 return stopIfError(CompileState.FLOW, results);
1259 }
1260
1261 /**
1262 * Perform dataflow checks on an attributed parse tree.
1263 */
1264 protected void flow(Env<AttrContext> env, Queue<Env<AttrContext>> results) {
1265 if (compileStates.isDone(env, CompileState.FLOW)) {
1266 results.add(env);
1267 return;
1268 }
1269
1270 try {
1271 if (shouldStop(CompileState.FLOW))
1272 return;
1273
1274 if (relax) {
1275 results.add(env);
1276 return;
1277 }
1278
1279 if (verboseCompilePolicy)
1280 printNote("[flow " + env.enclClass.sym + "]");
1281 JavaFileObject prev = log.useSource(
1282 env.enclClass.sym.sourcefile != null ?
1283 env.enclClass.sym.sourcefile :
1284 env.toplevel.sourcefile);
1285 try {
1286 make.at(Position.FIRSTPOS);
1287 TreeMaker localMake = make.forToplevel(env.toplevel);
1288 flow.analyzeTree(env, localMake);
1289 compileStates.put(env, CompileState.FLOW);
1290
1291 if (shouldStop(CompileState.FLOW))
1292 return;
1293
1294 results.add(env);
1295 }
1296 finally {
1297 log.useSource(prev);
1298 }
1299 }
1300 finally {
1301 if (!taskListener.isEmpty()) {
1302 TaskEvent e = new TaskEvent(TaskEvent.Kind.ANALYZE, env.toplevel, env.enclClass.sym);
1303 taskListener.finished(e);
1304 }
1305 }
1306 }
1307
1308 /**
1309 * Prepare attributed parse trees, in conjunction with their attribution contexts,
1310 * for source or code generation.
1311 * If any errors occur, an empty list will be returned.
1312 * @returns a list containing the classes to be generated
1313 */
1314 public Queue<Pair<Env<AttrContext>, JCClassDecl>> desugar(Queue<Env<AttrContext>> envs) {
1315 ListBuffer<Pair<Env<AttrContext>, JCClassDecl>> results = new ListBuffer<>();
1316 for (Env<AttrContext> env: envs)
1317 desugar(env, results);
1318 return stopIfError(CompileState.FLOW, results);
1319 }
1320
1321 HashMap<Env<AttrContext>, Queue<Pair<Env<AttrContext>, JCClassDecl>>> desugaredEnvs = new HashMap<>();
1322
1323 /**
1324 * Prepare attributed parse trees, in conjunction with their attribution contexts,
1325 * for source or code generation. If the file was not listed on the command line,
1326 * the current implicitSourcePolicy is taken into account.
1327 * The preparation stops as soon as an error is found.
1328 */
1329 protected void desugar(final Env<AttrContext> env, Queue<Pair<Env<AttrContext>, JCClassDecl>> results) {
1330 if (shouldStop(CompileState.TRANSTYPES))
1331 return;
1332
1333 if (implicitSourcePolicy == ImplicitSourcePolicy.NONE
1334 && !inputFiles.contains(env.toplevel.sourcefile)) {
1335 return;
1336 }
1337
1338 if (compileStates.isDone(env, CompileState.LOWER)) {
1339 results.addAll(desugaredEnvs.get(env));
1340 return;
1341 }
1342
1343 /**
1344 * Ensure that superclasses of C are desugared before C itself. This is
1345 * required for two reasons: (i) as erasure (TransTypes) destroys
1346 * information needed in flow analysis and (ii) as some checks carried
1347 * out during lowering require that all synthetic fields/methods have
1348 * already been added to C and its superclasses.
1349 */
1350 class ScanNested extends TreeScanner {
1351 Set<Env<AttrContext>> dependencies = new LinkedHashSet<>();
1352 protected boolean hasLambdas;
1353 @Override
1354 public void visitClassDef(JCClassDecl node) {
1355 Type st = types.supertype(node.sym.type);
1356 boolean envForSuperTypeFound = false;
1357 while (!envForSuperTypeFound && st.hasTag(CLASS)) {
1358 ClassSymbol c = st.tsym.outermostClass();
1359 Env<AttrContext> stEnv = enter.getEnv(c);
1360 if (stEnv != null && env != stEnv) {
1361 if (dependencies.add(stEnv)) {
1362 boolean prevHasLambdas = hasLambdas;
1363 try {
1364 scan(stEnv.tree);
1365 } finally {
1366 /*
1367 * ignore any updates to hasLambdas made during
1368 * the nested scan, this ensures an initalized
1369 * LambdaToMethod is available only to those
1370 * classes that contain lambdas
1371 */
1372 hasLambdas = prevHasLambdas;
1373 }
1374 }
1375 envForSuperTypeFound = true;
1376 }
1377 st = types.supertype(st);
1378 }
1379 super.visitClassDef(node);
1380 }
1381 @Override
1382 public void visitLambda(JCLambda tree) {
1383 hasLambdas = true;
1384 super.visitLambda(tree);
1385 }
1386 @Override
1387 public void visitReference(JCMemberReference tree) {
1388 hasLambdas = true;
1389 super.visitReference(tree);
1390 }
1391 }
1392 ScanNested scanner = new ScanNested();
1393 scanner.scan(env.tree);
1394 for (Env<AttrContext> dep: scanner.dependencies) {
1395 if (!compileStates.isDone(dep, CompileState.FLOW))
1396 desugaredEnvs.put(dep, desugar(flow(attribute(dep))));
1397 }
1398
1399 //We need to check for error another time as more classes might
1400 //have been attributed and analyzed at this stage
1401 if (shouldStop(CompileState.TRANSTYPES))
1402 return;
1403
1404 if (verboseCompilePolicy)
1405 printNote("[desugar " + env.enclClass.sym + "]");
1406
1407 JavaFileObject prev = log.useSource(env.enclClass.sym.sourcefile != null ?
1408 env.enclClass.sym.sourcefile :
1409 env.toplevel.sourcefile);
1410 try {
1411 //save tree prior to rewriting
1412 JCTree untranslated = env.tree;
1413
1414 make.at(Position.FIRSTPOS);
1415 TreeMaker localMake = make.forToplevel(env.toplevel);
1416
1417 if (env.tree.hasTag(JCTree.Tag.PACKAGEDEF)) {
1418 if (!(stubOutput || sourceOutput || printFlat)) {
1419 if (shouldStop(CompileState.LOWER))
1420 return;
1421 List<JCTree> pdef = lower.translateTopLevelClass(env, env.tree, localMake);
1422 if (pdef.head != null) {
1423 Assert.check(pdef.tail.isEmpty());
1424 results.add(new Pair<>(env, (JCClassDecl)pdef.head));
1425 }
1426 }
1427 return;
1428 }
1429
1430 if (stubOutput) {
1431 //emit stub Java source file, only for compilation
1432 //units enumerated explicitly on the command line
1433 JCClassDecl cdef = (JCClassDecl)env.tree;
1434 if (untranslated instanceof JCClassDecl &&
1435 rootClasses.contains((JCClassDecl)untranslated) &&
1436 ((cdef.mods.flags & (Flags.PROTECTED|Flags.PUBLIC)) != 0 ||
1437 cdef.sym.packge().getQualifiedName() == names.java_lang)) {
1438 results.add(new Pair<>(env, removeMethodBodies(cdef)));
1439 }
1440 return;
1441 }
1442
1443 if (shouldStop(CompileState.TRANSTYPES))
1444 return;
1445
1446 env.tree = transTypes.translateTopLevelClass(env.tree, localMake);
1447 compileStates.put(env, CompileState.TRANSTYPES);
1448
1449 if (source.allowLambda() && scanner.hasLambdas) {
1450 if (shouldStop(CompileState.UNLAMBDA))
1451 return;
1452
1453 env.tree = LambdaToMethod.instance(context).translateTopLevelClass(env, env.tree, localMake);
1454 compileStates.put(env, CompileState.UNLAMBDA);
1455 }
1456
1457 if (shouldStop(CompileState.LOWER))
1458 return;
1459
1460 if (sourceOutput) {
1461 //emit standard Java source file, only for compilation
1462 //units enumerated explicitly on the command line
1463 JCClassDecl cdef = (JCClassDecl)env.tree;
1464 if (untranslated instanceof JCClassDecl &&
1465 rootClasses.contains((JCClassDecl)untranslated)) {
1466 results.add(new Pair<>(env, cdef));
1467 }
1468 return;
1469 }
1470
1471 //translate out inner classes
1472 List<JCTree> cdefs = lower.translateTopLevelClass(env, env.tree, localMake);
1473 compileStates.put(env, CompileState.LOWER);
1474
1475 if (shouldStop(CompileState.LOWER))
1476 return;
1477
1478 //generate code for each class
1479 for (List<JCTree> l = cdefs; l.nonEmpty(); l = l.tail) {
1480 JCClassDecl cdef = (JCClassDecl)l.head;
1481 results.add(new Pair<>(env, cdef));
1482 }
1483 }
1484 finally {
1485 log.useSource(prev);
1486 }
1487
1488 }
1489
1490 /** Generates the source or class file for a list of classes.
1491 * The decision to generate a source file or a class file is
1492 * based upon the compiler's options.
1493 * Generation stops if an error occurs while writing files.
1494 */
1495 public void generate(Queue<Pair<Env<AttrContext>, JCClassDecl>> queue) {
1496 generate(queue, null);
1497 }
1498
1499 public void generate(Queue<Pair<Env<AttrContext>, JCClassDecl>> queue, Queue<JavaFileObject> results) {
1500 if (shouldStop(CompileState.GENERATE))
1501 return;
1502
1503 boolean usePrintSource = (stubOutput || sourceOutput || printFlat);
1504
1505 for (Pair<Env<AttrContext>, JCClassDecl> x: queue) {
1506 Env<AttrContext> env = x.fst;
1507 JCClassDecl cdef = x.snd;
1508
1509 if (verboseCompilePolicy) {
1510 printNote("[generate "
1511 + (usePrintSource ? " source" : "code")
1512 + " " + cdef.sym + "]");
1513 }
1514
1515 if (!taskListener.isEmpty()) {
1516 TaskEvent e = new TaskEvent(TaskEvent.Kind.GENERATE, env.toplevel, cdef.sym);
1517 taskListener.started(e);
1518 }
1519
1520 JavaFileObject prev = log.useSource(env.enclClass.sym.sourcefile != null ?
1521 env.enclClass.sym.sourcefile :
1522 env.toplevel.sourcefile);
1523 try {
1524 JavaFileObject file;
1525 if (usePrintSource)
1526 file = printSource(env, cdef);
1527 else {
1528 if (fileManager.hasLocation(StandardLocation.NATIVE_HEADER_OUTPUT)
1529 && jniWriter.needsHeader(cdef.sym)) {
1530 jniWriter.write(cdef.sym);
1531 }
1532 file = genCode(env, cdef);
1533 }
1534 if (results != null && file != null)
1535 results.add(file);
1536 } catch (IOException ex) {
1537 log.error(cdef.pos(), "class.cant.write",
1538 cdef.sym, ex.getMessage());
1539 return;
1540 } finally {
1541 log.useSource(prev);
1542 }
1543
1544 if (!taskListener.isEmpty()) {
1545 TaskEvent e = new TaskEvent(TaskEvent.Kind.GENERATE, env.toplevel, cdef.sym);
1546 taskListener.finished(e);
1547 }
1548 }
1549 }
1550
1551 // where
1552 Map<JCCompilationUnit, Queue<Env<AttrContext>>> groupByFile(Queue<Env<AttrContext>> envs) {
1553 // use a LinkedHashMap to preserve the order of the original list as much as possible
1554 Map<JCCompilationUnit, Queue<Env<AttrContext>>> map = new LinkedHashMap<>();
1555 for (Env<AttrContext> env: envs) {
1556 Queue<Env<AttrContext>> sublist = map.get(env.toplevel);
1557 if (sublist == null) {
1558 sublist = new ListBuffer<>();
1559 map.put(env.toplevel, sublist);
1560 }
1561 sublist.add(env);
1562 }
1563 return map;
1564 }
1565
1566 JCClassDecl removeMethodBodies(JCClassDecl cdef) {
1567 final boolean isInterface = (cdef.mods.flags & Flags.INTERFACE) != 0;
1568 class MethodBodyRemover extends TreeTranslator {
1569 @Override
1570 public void visitMethodDef(JCMethodDecl tree) {
1571 tree.mods.flags &= ~Flags.SYNCHRONIZED;
1572 for (JCVariableDecl vd : tree.params)
1573 vd.mods.flags &= ~Flags.FINAL;
1574 tree.body = null;
1575 super.visitMethodDef(tree);
1576 }
1577 @Override
1578 public void visitVarDef(JCVariableDecl tree) {
1579 if (tree.init != null && tree.init.type.constValue() == null)
1580 tree.init = null;
1581 super.visitVarDef(tree);
1582 }
1583 @Override
1584 public void visitClassDef(JCClassDecl tree) {
1585 ListBuffer<JCTree> newdefs = new ListBuffer<>();
1586 for (List<JCTree> it = tree.defs; it.tail != null; it = it.tail) {
1587 JCTree t = it.head;
1588 switch (t.getTag()) {
1589 case CLASSDEF:
1590 if (isInterface ||
1591 (((JCClassDecl) t).mods.flags & (Flags.PROTECTED|Flags.PUBLIC)) != 0 ||
1592 (((JCClassDecl) t).mods.flags & (Flags.PRIVATE)) == 0 && ((JCClassDecl) t).sym.packge().getQualifiedName() == names.java_lang)
1593 newdefs.append(t);
1594 break;
1595 case METHODDEF:
1596 if (isInterface ||
1597 (((JCMethodDecl) t).mods.flags & (Flags.PROTECTED|Flags.PUBLIC)) != 0 ||
1598 ((JCMethodDecl) t).sym.name == names.init ||
1599 (((JCMethodDecl) t).mods.flags & (Flags.PRIVATE)) == 0 && ((JCMethodDecl) t).sym.packge().getQualifiedName() == names.java_lang)
1600 newdefs.append(t);
1601 break;
1602 case VARDEF:
1603 if (isInterface || (((JCVariableDecl) t).mods.flags & (Flags.PROTECTED|Flags.PUBLIC)) != 0 ||
1604 (((JCVariableDecl) t).mods.flags & (Flags.PRIVATE)) == 0 && ((JCVariableDecl) t).sym.packge().getQualifiedName() == names.java_lang)
1605 newdefs.append(t);
1606 break;
1607 default:
1608 break;
1609 }
1610 }
1611 tree.defs = newdefs.toList();
1612 super.visitClassDef(tree);
1613 }
1614 }
1615 MethodBodyRemover r = new MethodBodyRemover();
1616 return r.translate(cdef);
1617 }
1618
1619 public void reportDeferredDiagnostics() {
1620 if (errorCount() == 0
1621 && annotationProcessingOccurred
1622 && implicitSourceFilesRead
1623 && implicitSourcePolicy == ImplicitSourcePolicy.UNSET) {
1624 if (explicitAnnotationProcessingRequested())
1625 log.warning("proc.use.implicit");
1626 else
1627 log.warning("proc.use.proc.or.implicit");
1628 }
1629 chk.reportDeferredDiagnostics();
1630 if (log.compressedOutput) {
1631 log.mandatoryNote(null, "compressed.diags");
1632 }
1633 }
1634
1635 /** Close the compiler, flushing the logs
1636 */
1637 public void close() {
1638 rootClasses = null;
1639 finder = null;
1640 reader = null;
1641 make = null;
1642 writer = null;
1643 enter = null;
1644 if (todo != null)
1645 todo.clear();
1646 todo = null;
1647 parserFactory = null;
1648 syms = null;
1649 source = null;
1650 attr = null;
1651 chk = null;
1652 gen = null;
1653 flow = null;
1654 transTypes = null;
1655 lower = null;
1656 annotate = null;
1657 types = null;
1658
1659 log.flush();
1660 try {
1661 fileManager.flush();
1662 } catch (IOException e) {
1663 throw new Abort(e);
1664 } finally {
1665 if (names != null)
1666 names.dispose();
1667 names = null;
1668
1669 for (Closeable c: closeables) {
1670 try {
1671 c.close();
1672 } catch (IOException e) {
1673 // When javac uses JDK 7 as a baseline, this code would be
1674 // better written to set any/all exceptions from all the
1675 // Closeables as suppressed exceptions on the FatalError
1676 // that is thrown.
1677 JCDiagnostic msg = diagFactory.fragment("fatal.err.cant.close");
1678 throw new FatalError(msg, e);
1679 }
1680 }
1681 closeables = List.nil();
1682 }
1683 }
1684
1685 protected void printNote(String lines) {
1686 log.printRawLines(Log.WriterKind.NOTICE, lines);
1687 }
1688
1689 /** Print numbers of errors and warnings.
1690 */
1691 public void printCount(String kind, int count) {
1692 if (count != 0) {
1693 String key;
1694 if (count == 1)
1695 key = "count." + kind;
1696 else
1697 key = "count." + kind + ".plural";
1698 log.printLines(WriterKind.ERROR, key, String.valueOf(count));
1699 log.flush(Log.WriterKind.ERROR);
1700 }
1701 }
1702
1703 private static long now() {
1704 return System.currentTimeMillis();
1705 }
1706
1707 private static long elapsed(long then) {
1708 return now() - then;
1709 }
1710
1711 public void newRound() {
1712 inputFiles.clear();
1713 todo.clear();
1714 }
1715 }