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