src/share/classes/com/sun/tools/javac/jvm/ClassReader.java

Thu, 05 Sep 2013 11:27:27 +0200

author
jfranck
date
Thu, 05 Sep 2013 11:27:27 +0200
changeset 2007
a76c663a9cac
parent 2001
2bf4c132bf90
child 2040
2375ce96e80d
permissions
-rw-r--r--

8023974: Drop 'implements Completer' and 'implements SourceCompleter' from ClassReader resp. JavaCompiler.
Reviewed-by: jjg, jfranck
Contributed-by: Andreas Lundblad <andreas.lundblad@oracle.com>

     1 /*
     2  * Copyright (c) 1999, 2013, 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.jvm;
    28 import java.io.*;
    29 import java.net.URI;
    30 import java.net.URISyntaxException;
    31 import java.nio.CharBuffer;
    32 import java.util.Arrays;
    33 import java.util.EnumSet;
    34 import java.util.HashMap;
    35 import java.util.HashSet;
    36 import java.util.Map;
    37 import java.util.Set;
    38 import javax.lang.model.SourceVersion;
    39 import javax.tools.JavaFileObject;
    40 import javax.tools.JavaFileManager;
    41 import javax.tools.JavaFileManager.Location;
    42 import javax.tools.StandardJavaFileManager;
    44 import static javax.tools.StandardLocation.*;
    46 import com.sun.tools.javac.comp.Annotate;
    47 import com.sun.tools.javac.code.*;
    48 import com.sun.tools.javac.code.Lint.LintCategory;
    49 import com.sun.tools.javac.code.Type.*;
    50 import com.sun.tools.javac.code.Symbol.*;
    51 import com.sun.tools.javac.code.Symtab;
    52 import com.sun.tools.javac.file.BaseFileObject;
    53 import com.sun.tools.javac.util.*;
    54 import com.sun.tools.javac.util.JCDiagnostic.DiagnosticPosition;
    56 import static com.sun.tools.javac.code.Flags.*;
    57 import static com.sun.tools.javac.code.Kinds.*;
    58 import static com.sun.tools.javac.code.TypeTag.CLASS;
    59 import static com.sun.tools.javac.jvm.ClassFile.*;
    60 import static com.sun.tools.javac.jvm.ClassFile.Version.*;
    62 import static com.sun.tools.javac.main.Option.*;
    64 /** This class provides operations to read a classfile into an internal
    65  *  representation. The internal representation is anchored in a
    66  *  ClassSymbol which contains in its scope symbol representations
    67  *  for all other definitions in the classfile. Top-level Classes themselves
    68  *  appear as members of the scopes of PackageSymbols.
    69  *
    70  *  <p><b>This is NOT part of any supported API.
    71  *  If you write code that depends on this, you do so at your own risk.
    72  *  This code and its internal interfaces are subject to change or
    73  *  deletion without notice.</b>
    74  */
    75 public class ClassReader {
    76     /** The context key for the class reader. */
    77     protected static final Context.Key<ClassReader> classReaderKey =
    78         new Context.Key<ClassReader>();
    80     public static final int INITIAL_BUFFER_SIZE = 0x0fff0;
    82     Annotate annotate;
    84     /** Switch: verbose output.
    85      */
    86     boolean verbose;
    88     /** Switch: check class file for correct minor version, unrecognized
    89      *  attributes.
    90      */
    91     boolean checkClassFile;
    93     /** Switch: read constant pool and code sections. This switch is initially
    94      *  set to false but can be turned on from outside.
    95      */
    96     public boolean readAllOfClassFile = false;
    98     /** Switch: read GJ signature information.
    99      */
   100     boolean allowGenerics;
   102     /** Switch: read varargs attribute.
   103      */
   104     boolean allowVarargs;
   106     /** Switch: allow annotations.
   107      */
   108     boolean allowAnnotations;
   110     /** Switch: allow simplified varargs.
   111      */
   112     boolean allowSimplifiedVarargs;
   114    /** Lint option: warn about classfile issues
   115      */
   116     boolean lintClassfile;
   118     /** Switch: allow default methods
   119      */
   120     boolean allowDefaultMethods;
   122     /** Switch: preserve parameter names from the variable table.
   123      */
   124     public boolean saveParameterNames;
   126     /**
   127      * Switch: cache completion failures unless -XDdev is used
   128      */
   129     private boolean cacheCompletionFailure;
   131     /**
   132      * Switch: prefer source files instead of newer when both source
   133      * and class are available
   134      **/
   135     public boolean preferSource;
   137     /**
   138      * The currently selected profile.
   139      */
   140     public final Profile profile;
   142     /** The log to use for verbose output
   143      */
   144     final Log log;
   146     /** The symbol table. */
   147     Symtab syms;
   149     Types types;
   151     /** The name table. */
   152     final Names names;
   154     /** Force a completion failure on this name
   155      */
   156     final Name completionFailureName;
   158     /** Access to files
   159      */
   160     private final JavaFileManager fileManager;
   162     /** Factory for diagnostics
   163      */
   164     JCDiagnostic.Factory diagFactory;
   166     /** Can be reassigned from outside:
   167      *  the completer to be used for ".java" files. If this remains unassigned
   168      *  ".java" files will not be loaded.
   169      */
   170     public SourceCompleter sourceCompleter = null;
   172     /** A hashtable containing the encountered top-level and member classes,
   173      *  indexed by flat names. The table does not contain local classes.
   174      */
   175     private Map<Name,ClassSymbol> classes;
   177     /** A hashtable containing the encountered packages.
   178      */
   179     private Map<Name, PackageSymbol> packages;
   181     /** The current scope where type variables are entered.
   182      */
   183     protected Scope typevars;
   185     /** The path name of the class file currently being read.
   186      */
   187     protected JavaFileObject currentClassFile = null;
   189     /** The class or method currently being read.
   190      */
   191     protected Symbol currentOwner = null;
   193     /** The buffer containing the currently read class file.
   194      */
   195     byte[] buf = new byte[INITIAL_BUFFER_SIZE];
   197     /** The current input pointer.
   198      */
   199     protected int bp;
   201     /** The objects of the constant pool.
   202      */
   203     Object[] poolObj;
   205     /** For every constant pool entry, an index into buf where the
   206      *  defining section of the entry is found.
   207      */
   208     int[] poolIdx;
   210     /** The major version number of the class file being read. */
   211     int majorVersion;
   212     /** The minor version number of the class file being read. */
   213     int minorVersion;
   215     /** A table to hold the constant pool indices for method parameter
   216      * names, as given in LocalVariableTable attributes.
   217      */
   218     int[] parameterNameIndices;
   220     /**
   221      * Whether or not any parameter names have been found.
   222      */
   223     boolean haveParameterNameIndices;
   225     /** Set this to false every time we start reading a method
   226      * and are saving parameter names.  Set it to true when we see
   227      * MethodParameters, if it's set when we see a LocalVariableTable,
   228      * then we ignore the parameter names from the LVT.
   229      */
   230     boolean sawMethodParameters;
   232     /**
   233      * The set of attribute names for which warnings have been generated for the current class
   234      */
   235     Set<Name> warnedAttrs = new HashSet<Name>();
   237     /**
   238      * Completer that delegates to the complete-method of this class.
   239      */
   240     private final Completer thisCompleter = new Completer() {
   241         @Override
   242         public void complete(Symbol sym) throws CompletionFailure {
   243             ClassReader.this.complete(sym);
   244         }
   245     };
   248     /** Get the ClassReader instance for this invocation. */
   249     public static ClassReader instance(Context context) {
   250         ClassReader instance = context.get(classReaderKey);
   251         if (instance == null)
   252             instance = new ClassReader(context, true);
   253         return instance;
   254     }
   256     /** Initialize classes and packages, treating this as the definitive classreader. */
   257     public void init(Symtab syms) {
   258         init(syms, true);
   259     }
   261     /** Initialize classes and packages, optionally treating this as
   262      *  the definitive classreader.
   263      */
   264     private void init(Symtab syms, boolean definitive) {
   265         if (classes != null) return;
   267         if (definitive) {
   268             Assert.check(packages == null || packages == syms.packages);
   269             packages = syms.packages;
   270             Assert.check(classes == null || classes == syms.classes);
   271             classes = syms.classes;
   272         } else {
   273             packages = new HashMap<Name, PackageSymbol>();
   274             classes = new HashMap<Name, ClassSymbol>();
   275         }
   277         packages.put(names.empty, syms.rootPackage);
   278         syms.rootPackage.completer = thisCompleter;
   279         syms.unnamedPackage.completer = thisCompleter;
   280     }
   282     /** Construct a new class reader, optionally treated as the
   283      *  definitive classreader for this invocation.
   284      */
   285     protected ClassReader(Context context, boolean definitive) {
   286         if (definitive) context.put(classReaderKey, this);
   288         names = Names.instance(context);
   289         syms = Symtab.instance(context);
   290         types = Types.instance(context);
   291         fileManager = context.get(JavaFileManager.class);
   292         if (fileManager == null)
   293             throw new AssertionError("FileManager initialization error");
   294         diagFactory = JCDiagnostic.Factory.instance(context);
   296         init(syms, definitive);
   297         log = Log.instance(context);
   299         Options options = Options.instance(context);
   300         annotate = Annotate.instance(context);
   301         verbose        = options.isSet(VERBOSE);
   302         checkClassFile = options.isSet("-checkclassfile");
   304         Source source = Source.instance(context);
   305         allowGenerics    = source.allowGenerics();
   306         allowVarargs     = source.allowVarargs();
   307         allowAnnotations = source.allowAnnotations();
   308         allowSimplifiedVarargs = source.allowSimplifiedVarargs();
   309         allowDefaultMethods = source.allowDefaultMethods();
   311         saveParameterNames = options.isSet("save-parameter-names");
   312         cacheCompletionFailure = options.isUnset("dev");
   313         preferSource = "source".equals(options.get("-Xprefer"));
   315         profile = Profile.instance(context);
   317         completionFailureName =
   318             options.isSet("failcomplete")
   319             ? names.fromString(options.get("failcomplete"))
   320             : null;
   322         typevars = new Scope(syms.noSymbol);
   324         lintClassfile = Lint.instance(context).isEnabled(LintCategory.CLASSFILE);
   326         initAttributeReaders();
   327     }
   329     /** Add member to class unless it is synthetic.
   330      */
   331     private void enterMember(ClassSymbol c, Symbol sym) {
   332         // Synthetic members are not entered -- reason lost to history (optimization?).
   333         // Lambda methods must be entered because they may have inner classes (which reference them)
   334         if ((sym.flags_field & (SYNTHETIC|BRIDGE)) != SYNTHETIC || sym.name.startsWith(names.lambda))
   335             c.members_field.enter(sym);
   336     }
   338 /************************************************************************
   339  * Error Diagnoses
   340  ***********************************************************************/
   343     public class BadClassFile extends CompletionFailure {
   344         private static final long serialVersionUID = 0;
   346         public BadClassFile(TypeSymbol sym, JavaFileObject file, JCDiagnostic diag) {
   347             super(sym, createBadClassFileDiagnostic(file, diag));
   348         }
   349     }
   350     // where
   351     private JCDiagnostic createBadClassFileDiagnostic(JavaFileObject file, JCDiagnostic diag) {
   352         String key = (file.getKind() == JavaFileObject.Kind.SOURCE
   353                     ? "bad.source.file.header" : "bad.class.file.header");
   354         return diagFactory.fragment(key, file, diag);
   355     }
   357     public BadClassFile badClassFile(String key, Object... args) {
   358         return new BadClassFile (
   359             currentOwner.enclClass(),
   360             currentClassFile,
   361             diagFactory.fragment(key, args));
   362     }
   364 /************************************************************************
   365  * Buffer Access
   366  ***********************************************************************/
   368     /** Read a character.
   369      */
   370     char nextChar() {
   371         return (char)(((buf[bp++] & 0xFF) << 8) + (buf[bp++] & 0xFF));
   372     }
   374     /** Read a byte.
   375      */
   376     int nextByte() {
   377         return buf[bp++] & 0xFF;
   378     }
   380     /** Read an integer.
   381      */
   382     int nextInt() {
   383         return
   384             ((buf[bp++] & 0xFF) << 24) +
   385             ((buf[bp++] & 0xFF) << 16) +
   386             ((buf[bp++] & 0xFF) << 8) +
   387             (buf[bp++] & 0xFF);
   388     }
   390     /** Extract a character at position bp from buf.
   391      */
   392     char getChar(int bp) {
   393         return
   394             (char)(((buf[bp] & 0xFF) << 8) + (buf[bp+1] & 0xFF));
   395     }
   397     /** Extract an integer at position bp from buf.
   398      */
   399     int getInt(int bp) {
   400         return
   401             ((buf[bp] & 0xFF) << 24) +
   402             ((buf[bp+1] & 0xFF) << 16) +
   403             ((buf[bp+2] & 0xFF) << 8) +
   404             (buf[bp+3] & 0xFF);
   405     }
   408     /** Extract a long integer at position bp from buf.
   409      */
   410     long getLong(int bp) {
   411         DataInputStream bufin =
   412             new DataInputStream(new ByteArrayInputStream(buf, bp, 8));
   413         try {
   414             return bufin.readLong();
   415         } catch (IOException e) {
   416             throw new AssertionError(e);
   417         }
   418     }
   420     /** Extract a float at position bp from buf.
   421      */
   422     float getFloat(int bp) {
   423         DataInputStream bufin =
   424             new DataInputStream(new ByteArrayInputStream(buf, bp, 4));
   425         try {
   426             return bufin.readFloat();
   427         } catch (IOException e) {
   428             throw new AssertionError(e);
   429         }
   430     }
   432     /** Extract a double at position bp from buf.
   433      */
   434     double getDouble(int bp) {
   435         DataInputStream bufin =
   436             new DataInputStream(new ByteArrayInputStream(buf, bp, 8));
   437         try {
   438             return bufin.readDouble();
   439         } catch (IOException e) {
   440             throw new AssertionError(e);
   441         }
   442     }
   444 /************************************************************************
   445  * Constant Pool Access
   446  ***********************************************************************/
   448     /** Index all constant pool entries, writing their start addresses into
   449      *  poolIdx.
   450      */
   451     void indexPool() {
   452         poolIdx = new int[nextChar()];
   453         poolObj = new Object[poolIdx.length];
   454         int i = 1;
   455         while (i < poolIdx.length) {
   456             poolIdx[i++] = bp;
   457             byte tag = buf[bp++];
   458             switch (tag) {
   459             case CONSTANT_Utf8: case CONSTANT_Unicode: {
   460                 int len = nextChar();
   461                 bp = bp + len;
   462                 break;
   463             }
   464             case CONSTANT_Class:
   465             case CONSTANT_String:
   466             case CONSTANT_MethodType:
   467                 bp = bp + 2;
   468                 break;
   469             case CONSTANT_MethodHandle:
   470                 bp = bp + 3;
   471                 break;
   472             case CONSTANT_Fieldref:
   473             case CONSTANT_Methodref:
   474             case CONSTANT_InterfaceMethodref:
   475             case CONSTANT_NameandType:
   476             case CONSTANT_Integer:
   477             case CONSTANT_Float:
   478             case CONSTANT_InvokeDynamic:
   479                 bp = bp + 4;
   480                 break;
   481             case CONSTANT_Long:
   482             case CONSTANT_Double:
   483                 bp = bp + 8;
   484                 i++;
   485                 break;
   486             default:
   487                 throw badClassFile("bad.const.pool.tag.at",
   488                                    Byte.toString(tag),
   489                                    Integer.toString(bp -1));
   490             }
   491         }
   492     }
   494     /** Read constant pool entry at start address i, use pool as a cache.
   495      */
   496     Object readPool(int i) {
   497         Object result = poolObj[i];
   498         if (result != null) return result;
   500         int index = poolIdx[i];
   501         if (index == 0) return null;
   503         byte tag = buf[index];
   504         switch (tag) {
   505         case CONSTANT_Utf8:
   506             poolObj[i] = names.fromUtf(buf, index + 3, getChar(index + 1));
   507             break;
   508         case CONSTANT_Unicode:
   509             throw badClassFile("unicode.str.not.supported");
   510         case CONSTANT_Class:
   511             poolObj[i] = readClassOrType(getChar(index + 1));
   512             break;
   513         case CONSTANT_String:
   514             // FIXME: (footprint) do not use toString here
   515             poolObj[i] = readName(getChar(index + 1)).toString();
   516             break;
   517         case CONSTANT_Fieldref: {
   518             ClassSymbol owner = readClassSymbol(getChar(index + 1));
   519             NameAndType nt = (NameAndType)readPool(getChar(index + 3));
   520             poolObj[i] = new VarSymbol(0, nt.name, nt.uniqueType.type, owner);
   521             break;
   522         }
   523         case CONSTANT_Methodref:
   524         case CONSTANT_InterfaceMethodref: {
   525             ClassSymbol owner = readClassSymbol(getChar(index + 1));
   526             NameAndType nt = (NameAndType)readPool(getChar(index + 3));
   527             poolObj[i] = new MethodSymbol(0, nt.name, nt.uniqueType.type, owner);
   528             break;
   529         }
   530         case CONSTANT_NameandType:
   531             poolObj[i] = new NameAndType(
   532                 readName(getChar(index + 1)),
   533                 readType(getChar(index + 3)), types);
   534             break;
   535         case CONSTANT_Integer:
   536             poolObj[i] = getInt(index + 1);
   537             break;
   538         case CONSTANT_Float:
   539             poolObj[i] = new Float(getFloat(index + 1));
   540             break;
   541         case CONSTANT_Long:
   542             poolObj[i] = new Long(getLong(index + 1));
   543             break;
   544         case CONSTANT_Double:
   545             poolObj[i] = new Double(getDouble(index + 1));
   546             break;
   547         case CONSTANT_MethodHandle:
   548             skipBytes(4);
   549             break;
   550         case CONSTANT_MethodType:
   551             skipBytes(3);
   552             break;
   553         case CONSTANT_InvokeDynamic:
   554             skipBytes(5);
   555             break;
   556         default:
   557             throw badClassFile("bad.const.pool.tag", Byte.toString(tag));
   558         }
   559         return poolObj[i];
   560     }
   562     /** Read signature and convert to type.
   563      */
   564     Type readType(int i) {
   565         int index = poolIdx[i];
   566         return sigToType(buf, index + 3, getChar(index + 1));
   567     }
   569     /** If name is an array type or class signature, return the
   570      *  corresponding type; otherwise return a ClassSymbol with given name.
   571      */
   572     Object readClassOrType(int i) {
   573         int index =  poolIdx[i];
   574         int len = getChar(index + 1);
   575         int start = index + 3;
   576         Assert.check(buf[start] == '[' || buf[start + len - 1] != ';');
   577         // by the above assertion, the following test can be
   578         // simplified to (buf[start] == '[')
   579         return (buf[start] == '[' || buf[start + len - 1] == ';')
   580             ? (Object)sigToType(buf, start, len)
   581             : (Object)enterClass(names.fromUtf(internalize(buf, start,
   582                                                            len)));
   583     }
   585     /** Read signature and convert to type parameters.
   586      */
   587     List<Type> readTypeParams(int i) {
   588         int index = poolIdx[i];
   589         return sigToTypeParams(buf, index + 3, getChar(index + 1));
   590     }
   592     /** Read class entry.
   593      */
   594     ClassSymbol readClassSymbol(int i) {
   595         return (ClassSymbol) (readPool(i));
   596     }
   598     /** Read name.
   599      */
   600     Name readName(int i) {
   601         return (Name) (readPool(i));
   602     }
   604 /************************************************************************
   605  * Reading Types
   606  ***********************************************************************/
   608     /** The unread portion of the currently read type is
   609      *  signature[sigp..siglimit-1].
   610      */
   611     byte[] signature;
   612     int sigp;
   613     int siglimit;
   614     boolean sigEnterPhase = false;
   616     /** Convert signature to type, where signature is a byte array segment.
   617      */
   618     Type sigToType(byte[] sig, int offset, int len) {
   619         signature = sig;
   620         sigp = offset;
   621         siglimit = offset + len;
   622         return sigToType();
   623     }
   625     /** Convert signature to type, where signature is implicit.
   626      */
   627     Type sigToType() {
   628         switch ((char) signature[sigp]) {
   629         case 'T':
   630             sigp++;
   631             int start = sigp;
   632             while (signature[sigp] != ';') sigp++;
   633             sigp++;
   634             return sigEnterPhase
   635                 ? Type.noType
   636                 : findTypeVar(names.fromUtf(signature, start, sigp - 1 - start));
   637         case '+': {
   638             sigp++;
   639             Type t = sigToType();
   640             return new WildcardType(t, BoundKind.EXTENDS,
   641                                     syms.boundClass);
   642         }
   643         case '*':
   644             sigp++;
   645             return new WildcardType(syms.objectType, BoundKind.UNBOUND,
   646                                     syms.boundClass);
   647         case '-': {
   648             sigp++;
   649             Type t = sigToType();
   650             return new WildcardType(t, BoundKind.SUPER,
   651                                     syms.boundClass);
   652         }
   653         case 'B':
   654             sigp++;
   655             return syms.byteType;
   656         case 'C':
   657             sigp++;
   658             return syms.charType;
   659         case 'D':
   660             sigp++;
   661             return syms.doubleType;
   662         case 'F':
   663             sigp++;
   664             return syms.floatType;
   665         case 'I':
   666             sigp++;
   667             return syms.intType;
   668         case 'J':
   669             sigp++;
   670             return syms.longType;
   671         case 'L':
   672             {
   673                 // int oldsigp = sigp;
   674                 Type t = classSigToType();
   675                 if (sigp < siglimit && signature[sigp] == '.')
   676                     throw badClassFile("deprecated inner class signature syntax " +
   677                                        "(please recompile from source)");
   678                 /*
   679                 System.err.println(" decoded " +
   680                                    new String(signature, oldsigp, sigp-oldsigp) +
   681                                    " => " + t + " outer " + t.outer());
   682                 */
   683                 return t;
   684             }
   685         case 'S':
   686             sigp++;
   687             return syms.shortType;
   688         case 'V':
   689             sigp++;
   690             return syms.voidType;
   691         case 'Z':
   692             sigp++;
   693             return syms.booleanType;
   694         case '[':
   695             sigp++;
   696             return new ArrayType(sigToType(), syms.arrayClass);
   697         case '(':
   698             sigp++;
   699             List<Type> argtypes = sigToTypes(')');
   700             Type restype = sigToType();
   701             List<Type> thrown = List.nil();
   702             while (signature[sigp] == '^') {
   703                 sigp++;
   704                 thrown = thrown.prepend(sigToType());
   705             }
   706             return new MethodType(argtypes,
   707                                   restype,
   708                                   thrown.reverse(),
   709                                   syms.methodClass);
   710         case '<':
   711             typevars = typevars.dup(currentOwner);
   712             Type poly = new ForAll(sigToTypeParams(), sigToType());
   713             typevars = typevars.leave();
   714             return poly;
   715         default:
   716             throw badClassFile("bad.signature",
   717                                Convert.utf2string(signature, sigp, 10));
   718         }
   719     }
   721     byte[] signatureBuffer = new byte[0];
   722     int sbp = 0;
   723     /** Convert class signature to type, where signature is implicit.
   724      */
   725     Type classSigToType() {
   726         if (signature[sigp] != 'L')
   727             throw badClassFile("bad.class.signature",
   728                                Convert.utf2string(signature, sigp, 10));
   729         sigp++;
   730         Type outer = Type.noType;
   731         int startSbp = sbp;
   733         while (true) {
   734             final byte c = signature[sigp++];
   735             switch (c) {
   737             case ';': {         // end
   738                 ClassSymbol t = enterClass(names.fromUtf(signatureBuffer,
   739                                                          startSbp,
   740                                                          sbp - startSbp));
   742                 try {
   743                     return (outer == Type.noType) ?
   744                             t.erasure(types) :
   745                             new ClassType(outer, List.<Type>nil(), t);
   746                 } finally {
   747                     sbp = startSbp;
   748                 }
   749             }
   751             case '<':           // generic arguments
   752                 ClassSymbol t = enterClass(names.fromUtf(signatureBuffer,
   753                                                          startSbp,
   754                                                          sbp - startSbp));
   755                 outer = new ClassType(outer, sigToTypes('>'), t) {
   756                         boolean completed = false;
   757                         @Override
   758                         public Type getEnclosingType() {
   759                             if (!completed) {
   760                                 completed = true;
   761                                 tsym.complete();
   762                                 Type enclosingType = tsym.type.getEnclosingType();
   763                                 if (enclosingType != Type.noType) {
   764                                     List<Type> typeArgs =
   765                                         super.getEnclosingType().allparams();
   766                                     List<Type> typeParams =
   767                                         enclosingType.allparams();
   768                                     if (typeParams.length() != typeArgs.length()) {
   769                                         // no "rare" types
   770                                         super.setEnclosingType(types.erasure(enclosingType));
   771                                     } else {
   772                                         super.setEnclosingType(types.subst(enclosingType,
   773                                                                            typeParams,
   774                                                                            typeArgs));
   775                                     }
   776                                 } else {
   777                                     super.setEnclosingType(Type.noType);
   778                                 }
   779                             }
   780                             return super.getEnclosingType();
   781                         }
   782                         @Override
   783                         public void setEnclosingType(Type outer) {
   784                             throw new UnsupportedOperationException();
   785                         }
   786                     };
   787                 switch (signature[sigp++]) {
   788                 case ';':
   789                     if (sigp < signature.length && signature[sigp] == '.') {
   790                         // support old-style GJC signatures
   791                         // The signature produced was
   792                         // Lfoo/Outer<Lfoo/X;>;.Lfoo/Outer$Inner<Lfoo/Y;>;
   793                         // rather than say
   794                         // Lfoo/Outer<Lfoo/X;>.Inner<Lfoo/Y;>;
   795                         // so we skip past ".Lfoo/Outer$"
   796                         sigp += (sbp - startSbp) + // "foo/Outer"
   797                             3;  // ".L" and "$"
   798                         signatureBuffer[sbp++] = (byte)'$';
   799                         break;
   800                     } else {
   801                         sbp = startSbp;
   802                         return outer;
   803                     }
   804                 case '.':
   805                     signatureBuffer[sbp++] = (byte)'$';
   806                     break;
   807                 default:
   808                     throw new AssertionError(signature[sigp-1]);
   809                 }
   810                 continue;
   812             case '.':
   813                 //we have seen an enclosing non-generic class
   814                 if (outer != Type.noType) {
   815                     t = enterClass(names.fromUtf(signatureBuffer,
   816                                                  startSbp,
   817                                                  sbp - startSbp));
   818                     outer = new ClassType(outer, List.<Type>nil(), t);
   819                 }
   820                 signatureBuffer[sbp++] = (byte)'$';
   821                 continue;
   822             case '/':
   823                 signatureBuffer[sbp++] = (byte)'.';
   824                 continue;
   825             default:
   826                 signatureBuffer[sbp++] = c;
   827                 continue;
   828             }
   829         }
   830     }
   832     /** Convert (implicit) signature to list of types
   833      *  until `terminator' is encountered.
   834      */
   835     List<Type> sigToTypes(char terminator) {
   836         List<Type> head = List.of(null);
   837         List<Type> tail = head;
   838         while (signature[sigp] != terminator)
   839             tail = tail.setTail(List.of(sigToType()));
   840         sigp++;
   841         return head.tail;
   842     }
   844     /** Convert signature to type parameters, where signature is a byte
   845      *  array segment.
   846      */
   847     List<Type> sigToTypeParams(byte[] sig, int offset, int len) {
   848         signature = sig;
   849         sigp = offset;
   850         siglimit = offset + len;
   851         return sigToTypeParams();
   852     }
   854     /** Convert signature to type parameters, where signature is implicit.
   855      */
   856     List<Type> sigToTypeParams() {
   857         List<Type> tvars = List.nil();
   858         if (signature[sigp] == '<') {
   859             sigp++;
   860             int start = sigp;
   861             sigEnterPhase = true;
   862             while (signature[sigp] != '>')
   863                 tvars = tvars.prepend(sigToTypeParam());
   864             sigEnterPhase = false;
   865             sigp = start;
   866             while (signature[sigp] != '>')
   867                 sigToTypeParam();
   868             sigp++;
   869         }
   870         return tvars.reverse();
   871     }
   873     /** Convert (implicit) signature to type parameter.
   874      */
   875     Type sigToTypeParam() {
   876         int start = sigp;
   877         while (signature[sigp] != ':') sigp++;
   878         Name name = names.fromUtf(signature, start, sigp - start);
   879         TypeVar tvar;
   880         if (sigEnterPhase) {
   881             tvar = new TypeVar(name, currentOwner, syms.botType);
   882             typevars.enter(tvar.tsym);
   883         } else {
   884             tvar = (TypeVar)findTypeVar(name);
   885         }
   886         List<Type> bounds = List.nil();
   887         boolean allInterfaces = false;
   888         if (signature[sigp] == ':' && signature[sigp+1] == ':') {
   889             sigp++;
   890             allInterfaces = true;
   891         }
   892         while (signature[sigp] == ':') {
   893             sigp++;
   894             bounds = bounds.prepend(sigToType());
   895         }
   896         if (!sigEnterPhase) {
   897             types.setBounds(tvar, bounds.reverse(), allInterfaces);
   898         }
   899         return tvar;
   900     }
   902     /** Find type variable with given name in `typevars' scope.
   903      */
   904     Type findTypeVar(Name name) {
   905         Scope.Entry e = typevars.lookup(name);
   906         if (e.scope != null) {
   907             return e.sym.type;
   908         } else {
   909             if (readingClassAttr) {
   910                 // While reading the class attribute, the supertypes
   911                 // might refer to a type variable from an enclosing element
   912                 // (method or class).
   913                 // If the type variable is defined in the enclosing class,
   914                 // we can actually find it in
   915                 // currentOwner.owner.type.getTypeArguments()
   916                 // However, until we have read the enclosing method attribute
   917                 // we don't know for sure if this owner is correct.  It could
   918                 // be a method and there is no way to tell before reading the
   919                 // enclosing method attribute.
   920                 TypeVar t = new TypeVar(name, currentOwner, syms.botType);
   921                 missingTypeVariables = missingTypeVariables.prepend(t);
   922                 // System.err.println("Missing type var " + name);
   923                 return t;
   924             }
   925             throw badClassFile("undecl.type.var", name);
   926         }
   927     }
   929 /************************************************************************
   930  * Reading Attributes
   931  ***********************************************************************/
   933     protected enum AttributeKind { CLASS, MEMBER };
   934     protected abstract class AttributeReader {
   935         protected AttributeReader(Name name, ClassFile.Version version, Set<AttributeKind> kinds) {
   936             this.name = name;
   937             this.version = version;
   938             this.kinds = kinds;
   939         }
   941         protected boolean accepts(AttributeKind kind) {
   942             if (kinds.contains(kind)) {
   943                 if (majorVersion > version.major || (majorVersion == version.major && minorVersion >= version.minor))
   944                     return true;
   946                 if (lintClassfile && !warnedAttrs.contains(name)) {
   947                     JavaFileObject prev = log.useSource(currentClassFile);
   948                     try {
   949                         log.warning(LintCategory.CLASSFILE, (DiagnosticPosition) null, "future.attr",
   950                                 name, version.major, version.minor, majorVersion, minorVersion);
   951                     } finally {
   952                         log.useSource(prev);
   953                     }
   954                     warnedAttrs.add(name);
   955                 }
   956             }
   957             return false;
   958         }
   960         protected abstract void read(Symbol sym, int attrLen);
   962         protected final Name name;
   963         protected final ClassFile.Version version;
   964         protected final Set<AttributeKind> kinds;
   965     }
   967     protected Set<AttributeKind> CLASS_ATTRIBUTE =
   968             EnumSet.of(AttributeKind.CLASS);
   969     protected Set<AttributeKind> MEMBER_ATTRIBUTE =
   970             EnumSet.of(AttributeKind.MEMBER);
   971     protected Set<AttributeKind> CLASS_OR_MEMBER_ATTRIBUTE =
   972             EnumSet.of(AttributeKind.CLASS, AttributeKind.MEMBER);
   974     protected Map<Name, AttributeReader> attributeReaders = new HashMap<Name, AttributeReader>();
   976     private void initAttributeReaders() {
   977         AttributeReader[] readers = {
   978             // v45.3 attributes
   980             new AttributeReader(names.Code, V45_3, MEMBER_ATTRIBUTE) {
   981                 protected void read(Symbol sym, int attrLen) {
   982                     if (readAllOfClassFile || saveParameterNames)
   983                         ((MethodSymbol)sym).code = readCode(sym);
   984                     else
   985                         bp = bp + attrLen;
   986                 }
   987             },
   989             new AttributeReader(names.ConstantValue, V45_3, MEMBER_ATTRIBUTE) {
   990                 protected void read(Symbol sym, int attrLen) {
   991                     Object v = readPool(nextChar());
   992                     // Ignore ConstantValue attribute if field not final.
   993                     if ((sym.flags() & FINAL) != 0)
   994                         ((VarSymbol) sym).setData(v);
   995                 }
   996             },
   998             new AttributeReader(names.Deprecated, V45_3, CLASS_OR_MEMBER_ATTRIBUTE) {
   999                 protected void read(Symbol sym, int attrLen) {
  1000                     sym.flags_field |= DEPRECATED;
  1002             },
  1004             new AttributeReader(names.Exceptions, V45_3, CLASS_OR_MEMBER_ATTRIBUTE) {
  1005                 protected void read(Symbol sym, int attrLen) {
  1006                     int nexceptions = nextChar();
  1007                     List<Type> thrown = List.nil();
  1008                     for (int j = 0; j < nexceptions; j++)
  1009                         thrown = thrown.prepend(readClassSymbol(nextChar()).type);
  1010                     if (sym.type.getThrownTypes().isEmpty())
  1011                         sym.type.asMethodType().thrown = thrown.reverse();
  1013             },
  1015             new AttributeReader(names.InnerClasses, V45_3, CLASS_ATTRIBUTE) {
  1016                 protected void read(Symbol sym, int attrLen) {
  1017                     ClassSymbol c = (ClassSymbol) sym;
  1018                     readInnerClasses(c);
  1020             },
  1022             new AttributeReader(names.LocalVariableTable, V45_3, CLASS_OR_MEMBER_ATTRIBUTE) {
  1023                 protected void read(Symbol sym, int attrLen) {
  1024                     int newbp = bp + attrLen;
  1025                     if (saveParameterNames && !sawMethodParameters) {
  1026                         // Pick up parameter names from the variable table.
  1027                         // Parameter names are not explicitly identified as such,
  1028                         // but all parameter name entries in the LocalVariableTable
  1029                         // have a start_pc of 0.  Therefore, we record the name
  1030                         // indicies of all slots with a start_pc of zero in the
  1031                         // parameterNameIndicies array.
  1032                         // Note that this implicitly honors the JVMS spec that
  1033                         // there may be more than one LocalVariableTable, and that
  1034                         // there is no specified ordering for the entries.
  1035                         int numEntries = nextChar();
  1036                         for (int i = 0; i < numEntries; i++) {
  1037                             int start_pc = nextChar();
  1038                             int length = nextChar();
  1039                             int nameIndex = nextChar();
  1040                             int sigIndex = nextChar();
  1041                             int register = nextChar();
  1042                             if (start_pc == 0) {
  1043                                 // ensure array large enough
  1044                                 if (register >= parameterNameIndices.length) {
  1045                                     int newSize = Math.max(register, parameterNameIndices.length + 8);
  1046                                     parameterNameIndices =
  1047                                             Arrays.copyOf(parameterNameIndices, newSize);
  1049                                 parameterNameIndices[register] = nameIndex;
  1050                                 haveParameterNameIndices = true;
  1054                     bp = newbp;
  1056             },
  1058             new AttributeReader(names.MethodParameters, V52, MEMBER_ATTRIBUTE) {
  1059                 protected void read(Symbol sym, int attrlen) {
  1060                     int newbp = bp + attrlen;
  1061                     if (saveParameterNames) {
  1062                         sawMethodParameters = true;
  1063                         int numEntries = nextByte();
  1064                         parameterNameIndices = new int[numEntries];
  1065                         haveParameterNameIndices = true;
  1066                         for (int i = 0; i < numEntries; i++) {
  1067                             int nameIndex = nextChar();
  1068                             int flags = nextChar();
  1069                             parameterNameIndices[i] = nameIndex;
  1072                     bp = newbp;
  1074             },
  1077             new AttributeReader(names.SourceFile, V45_3, CLASS_ATTRIBUTE) {
  1078                 protected void read(Symbol sym, int attrLen) {
  1079                     ClassSymbol c = (ClassSymbol) sym;
  1080                     Name n = readName(nextChar());
  1081                     c.sourcefile = new SourceFileObject(n, c.flatname);
  1082                     // If the class is a toplevel class, originating from a Java source file,
  1083                     // but the class name does not match the file name, then it is
  1084                     // an auxiliary class.
  1085                     String sn = n.toString();
  1086                     if (c.owner.kind == Kinds.PCK &&
  1087                         sn.endsWith(".java") &&
  1088                         !sn.equals(c.name.toString()+".java")) {
  1089                         c.flags_field |= AUXILIARY;
  1092             },
  1094             new AttributeReader(names.Synthetic, V45_3, CLASS_OR_MEMBER_ATTRIBUTE) {
  1095                 protected void read(Symbol sym, int attrLen) {
  1096                     // bridge methods are visible when generics not enabled
  1097                     if (allowGenerics || (sym.flags_field & BRIDGE) == 0)
  1098                         sym.flags_field |= SYNTHETIC;
  1100             },
  1102             // standard v49 attributes
  1104             new AttributeReader(names.EnclosingMethod, V49, CLASS_ATTRIBUTE) {
  1105                 protected void read(Symbol sym, int attrLen) {
  1106                     int newbp = bp + attrLen;
  1107                     readEnclosingMethodAttr(sym);
  1108                     bp = newbp;
  1110             },
  1112             new AttributeReader(names.Signature, V49, CLASS_OR_MEMBER_ATTRIBUTE) {
  1113                 @Override
  1114                 protected boolean accepts(AttributeKind kind) {
  1115                     return super.accepts(kind) && allowGenerics;
  1118                 protected void read(Symbol sym, int attrLen) {
  1119                     if (sym.kind == TYP) {
  1120                         ClassSymbol c = (ClassSymbol) sym;
  1121                         readingClassAttr = true;
  1122                         try {
  1123                             ClassType ct1 = (ClassType)c.type;
  1124                             Assert.check(c == currentOwner);
  1125                             ct1.typarams_field = readTypeParams(nextChar());
  1126                             ct1.supertype_field = sigToType();
  1127                             ListBuffer<Type> is = new ListBuffer<Type>();
  1128                             while (sigp != siglimit) is.append(sigToType());
  1129                             ct1.interfaces_field = is.toList();
  1130                         } finally {
  1131                             readingClassAttr = false;
  1133                     } else {
  1134                         List<Type> thrown = sym.type.getThrownTypes();
  1135                         sym.type = readType(nextChar());
  1136                         //- System.err.println(" # " + sym.type);
  1137                         if (sym.kind == MTH && sym.type.getThrownTypes().isEmpty())
  1138                             sym.type.asMethodType().thrown = thrown;
  1142             },
  1144             // v49 annotation attributes
  1146             new AttributeReader(names.AnnotationDefault, V49, CLASS_OR_MEMBER_ATTRIBUTE) {
  1147                 protected void read(Symbol sym, int attrLen) {
  1148                     attachAnnotationDefault(sym);
  1150             },
  1152             new AttributeReader(names.RuntimeInvisibleAnnotations, V49, CLASS_OR_MEMBER_ATTRIBUTE) {
  1153                 protected void read(Symbol sym, int attrLen) {
  1154                     attachAnnotations(sym);
  1156             },
  1158             new AttributeReader(names.RuntimeInvisibleParameterAnnotations, V49, CLASS_OR_MEMBER_ATTRIBUTE) {
  1159                 protected void read(Symbol sym, int attrLen) {
  1160                     attachParameterAnnotations(sym);
  1162             },
  1164             new AttributeReader(names.RuntimeVisibleAnnotations, V49, CLASS_OR_MEMBER_ATTRIBUTE) {
  1165                 protected void read(Symbol sym, int attrLen) {
  1166                     attachAnnotations(sym);
  1168             },
  1170             new AttributeReader(names.RuntimeVisibleParameterAnnotations, V49, CLASS_OR_MEMBER_ATTRIBUTE) {
  1171                 protected void read(Symbol sym, int attrLen) {
  1172                     attachParameterAnnotations(sym);
  1174             },
  1176             // additional "legacy" v49 attributes, superceded by flags
  1178             new AttributeReader(names.Annotation, V49, CLASS_OR_MEMBER_ATTRIBUTE) {
  1179                 protected void read(Symbol sym, int attrLen) {
  1180                     if (allowAnnotations)
  1181                         sym.flags_field |= ANNOTATION;
  1183             },
  1185             new AttributeReader(names.Bridge, V49, MEMBER_ATTRIBUTE) {
  1186                 protected void read(Symbol sym, int attrLen) {
  1187                     sym.flags_field |= BRIDGE;
  1188                     if (!allowGenerics)
  1189                         sym.flags_field &= ~SYNTHETIC;
  1191             },
  1193             new AttributeReader(names.Enum, V49, CLASS_OR_MEMBER_ATTRIBUTE) {
  1194                 protected void read(Symbol sym, int attrLen) {
  1195                     sym.flags_field |= ENUM;
  1197             },
  1199             new AttributeReader(names.Varargs, V49, CLASS_OR_MEMBER_ATTRIBUTE) {
  1200                 protected void read(Symbol sym, int attrLen) {
  1201                     if (allowVarargs)
  1202                         sym.flags_field |= VARARGS;
  1204             },
  1206             new AttributeReader(names.RuntimeVisibleTypeAnnotations, V52, CLASS_OR_MEMBER_ATTRIBUTE) {
  1207                 protected void read(Symbol sym, int attrLen) {
  1208                     attachTypeAnnotations(sym);
  1210             },
  1212             new AttributeReader(names.RuntimeInvisibleTypeAnnotations, V52, CLASS_OR_MEMBER_ATTRIBUTE) {
  1213                 protected void read(Symbol sym, int attrLen) {
  1214                     attachTypeAnnotations(sym);
  1216             },
  1219             // The following attributes for a Code attribute are not currently handled
  1220             // StackMapTable
  1221             // SourceDebugExtension
  1222             // LineNumberTable
  1223             // LocalVariableTypeTable
  1224         };
  1226         for (AttributeReader r: readers)
  1227             attributeReaders.put(r.name, r);
  1230     /** Report unrecognized attribute.
  1231      */
  1232     void unrecognized(Name attrName) {
  1233         if (checkClassFile)
  1234             printCCF("ccf.unrecognized.attribute", attrName);
  1239     protected void readEnclosingMethodAttr(Symbol sym) {
  1240         // sym is a nested class with an "Enclosing Method" attribute
  1241         // remove sym from it's current owners scope and place it in
  1242         // the scope specified by the attribute
  1243         sym.owner.members().remove(sym);
  1244         ClassSymbol self = (ClassSymbol)sym;
  1245         ClassSymbol c = readClassSymbol(nextChar());
  1246         NameAndType nt = (NameAndType)readPool(nextChar());
  1248         if (c.members_field == null)
  1249             throw badClassFile("bad.enclosing.class", self, c);
  1251         MethodSymbol m = findMethod(nt, c.members_field, self.flags());
  1252         if (nt != null && m == null)
  1253             throw badClassFile("bad.enclosing.method", self);
  1255         self.name = simpleBinaryName(self.flatname, c.flatname) ;
  1256         self.owner = m != null ? m : c;
  1257         if (self.name.isEmpty())
  1258             self.fullname = names.empty;
  1259         else
  1260             self.fullname = ClassSymbol.formFullName(self.name, self.owner);
  1262         if (m != null) {
  1263             ((ClassType)sym.type).setEnclosingType(m.type);
  1264         } else if ((self.flags_field & STATIC) == 0) {
  1265             ((ClassType)sym.type).setEnclosingType(c.type);
  1266         } else {
  1267             ((ClassType)sym.type).setEnclosingType(Type.noType);
  1269         enterTypevars(self);
  1270         if (!missingTypeVariables.isEmpty()) {
  1271             ListBuffer<Type> typeVars =  new ListBuffer<Type>();
  1272             for (Type typevar : missingTypeVariables) {
  1273                 typeVars.append(findTypeVar(typevar.tsym.name));
  1275             foundTypeVariables = typeVars.toList();
  1276         } else {
  1277             foundTypeVariables = List.nil();
  1281     // See java.lang.Class
  1282     private Name simpleBinaryName(Name self, Name enclosing) {
  1283         String simpleBinaryName = self.toString().substring(enclosing.toString().length());
  1284         if (simpleBinaryName.length() < 1 || simpleBinaryName.charAt(0) != '$')
  1285             throw badClassFile("bad.enclosing.method", self);
  1286         int index = 1;
  1287         while (index < simpleBinaryName.length() &&
  1288                isAsciiDigit(simpleBinaryName.charAt(index)))
  1289             index++;
  1290         return names.fromString(simpleBinaryName.substring(index));
  1293     private MethodSymbol findMethod(NameAndType nt, Scope scope, long flags) {
  1294         if (nt == null)
  1295             return null;
  1297         MethodType type = nt.uniqueType.type.asMethodType();
  1299         for (Scope.Entry e = scope.lookup(nt.name); e.scope != null; e = e.next())
  1300             if (e.sym.kind == MTH && isSameBinaryType(e.sym.type.asMethodType(), type))
  1301                 return (MethodSymbol)e.sym;
  1303         if (nt.name != names.init)
  1304             // not a constructor
  1305             return null;
  1306         if ((flags & INTERFACE) != 0)
  1307             // no enclosing instance
  1308             return null;
  1309         if (nt.uniqueType.type.getParameterTypes().isEmpty())
  1310             // no parameters
  1311             return null;
  1313         // A constructor of an inner class.
  1314         // Remove the first argument (the enclosing instance)
  1315         nt.setType(new MethodType(nt.uniqueType.type.getParameterTypes().tail,
  1316                                  nt.uniqueType.type.getReturnType(),
  1317                                  nt.uniqueType.type.getThrownTypes(),
  1318                                  syms.methodClass));
  1319         // Try searching again
  1320         return findMethod(nt, scope, flags);
  1323     /** Similar to Types.isSameType but avoids completion */
  1324     private boolean isSameBinaryType(MethodType mt1, MethodType mt2) {
  1325         List<Type> types1 = types.erasure(mt1.getParameterTypes())
  1326             .prepend(types.erasure(mt1.getReturnType()));
  1327         List<Type> types2 = mt2.getParameterTypes().prepend(mt2.getReturnType());
  1328         while (!types1.isEmpty() && !types2.isEmpty()) {
  1329             if (types1.head.tsym != types2.head.tsym)
  1330                 return false;
  1331             types1 = types1.tail;
  1332             types2 = types2.tail;
  1334         return types1.isEmpty() && types2.isEmpty();
  1337     /**
  1338      * Character.isDigit answers <tt>true</tt> to some non-ascii
  1339      * digits.  This one does not.  <b>copied from java.lang.Class</b>
  1340      */
  1341     private static boolean isAsciiDigit(char c) {
  1342         return '0' <= c && c <= '9';
  1345     /** Read member attributes.
  1346      */
  1347     void readMemberAttrs(Symbol sym) {
  1348         readAttrs(sym, AttributeKind.MEMBER);
  1351     void readAttrs(Symbol sym, AttributeKind kind) {
  1352         char ac = nextChar();
  1353         for (int i = 0; i < ac; i++) {
  1354             Name attrName = readName(nextChar());
  1355             int attrLen = nextInt();
  1356             AttributeReader r = attributeReaders.get(attrName);
  1357             if (r != null && r.accepts(kind))
  1358                 r.read(sym, attrLen);
  1359             else  {
  1360                 unrecognized(attrName);
  1361                 bp = bp + attrLen;
  1366     private boolean readingClassAttr = false;
  1367     private List<Type> missingTypeVariables = List.nil();
  1368     private List<Type> foundTypeVariables = List.nil();
  1370     /** Read class attributes.
  1371      */
  1372     void readClassAttrs(ClassSymbol c) {
  1373         readAttrs(c, AttributeKind.CLASS);
  1376     /** Read code block.
  1377      */
  1378     Code readCode(Symbol owner) {
  1379         nextChar(); // max_stack
  1380         nextChar(); // max_locals
  1381         final int  code_length = nextInt();
  1382         bp += code_length;
  1383         final char exception_table_length = nextChar();
  1384         bp += exception_table_length * 8;
  1385         readMemberAttrs(owner);
  1386         return null;
  1389 /************************************************************************
  1390  * Reading Java-language annotations
  1391  ***********************************************************************/
  1393     /** Attach annotations.
  1394      */
  1395     void attachAnnotations(final Symbol sym) {
  1396         int numAttributes = nextChar();
  1397         if (numAttributes != 0) {
  1398             ListBuffer<CompoundAnnotationProxy> proxies =
  1399                 new ListBuffer<CompoundAnnotationProxy>();
  1400             for (int i = 0; i<numAttributes; i++) {
  1401                 CompoundAnnotationProxy proxy = readCompoundAnnotation();
  1402                 if (proxy.type.tsym == syms.proprietaryType.tsym)
  1403                     sym.flags_field |= PROPRIETARY;
  1404                 else if (proxy.type.tsym == syms.profileType.tsym) {
  1405                     if (profile != Profile.DEFAULT) {
  1406                         for (Pair<Name,Attribute> v: proxy.values) {
  1407                             if (v.fst == names.value && v.snd instanceof Attribute.Constant) {
  1408                                 Attribute.Constant c = (Attribute.Constant) v.snd;
  1409                                 if (c.type == syms.intType && ((Integer) c.value) > profile.value) {
  1410                                     sym.flags_field |= NOT_IN_PROFILE;
  1415                 } else
  1416                     proxies.append(proxy);
  1418             annotate.normal(new AnnotationCompleter(sym, proxies.toList()));
  1422     /** Attach parameter annotations.
  1423      */
  1424     void attachParameterAnnotations(final Symbol method) {
  1425         final MethodSymbol meth = (MethodSymbol)method;
  1426         int numParameters = buf[bp++] & 0xFF;
  1427         List<VarSymbol> parameters = meth.params();
  1428         int pnum = 0;
  1429         while (parameters.tail != null) {
  1430             attachAnnotations(parameters.head);
  1431             parameters = parameters.tail;
  1432             pnum++;
  1434         if (pnum != numParameters) {
  1435             throw badClassFile("bad.runtime.invisible.param.annotations", meth);
  1439     void attachTypeAnnotations(final Symbol sym) {
  1440         int numAttributes = nextChar();
  1441         if (numAttributes != 0) {
  1442             ListBuffer<TypeAnnotationProxy> proxies =
  1443                 ListBuffer.lb();
  1444             for (int i = 0; i < numAttributes; i++)
  1445                 proxies.append(readTypeAnnotation());
  1446             annotate.normal(new TypeAnnotationCompleter(sym, proxies.toList()));
  1450     /** Attach the default value for an annotation element.
  1451      */
  1452     void attachAnnotationDefault(final Symbol sym) {
  1453         final MethodSymbol meth = (MethodSymbol)sym; // only on methods
  1454         final Attribute value = readAttributeValue();
  1456         // The default value is set later during annotation. It might
  1457         // be the case that the Symbol sym is annotated _after_ the
  1458         // repeating instances that depend on this default value,
  1459         // because of this we set an interim value that tells us this
  1460         // element (most likely) has a default.
  1461         //
  1462         // Set interim value for now, reset just before we do this
  1463         // properly at annotate time.
  1464         meth.defaultValue = value;
  1465         annotate.normal(new AnnotationDefaultCompleter(meth, value));
  1468     Type readTypeOrClassSymbol(int i) {
  1469         // support preliminary jsr175-format class files
  1470         if (buf[poolIdx[i]] == CONSTANT_Class)
  1471             return readClassSymbol(i).type;
  1472         return readType(i);
  1474     Type readEnumType(int i) {
  1475         // support preliminary jsr175-format class files
  1476         int index = poolIdx[i];
  1477         int length = getChar(index + 1);
  1478         if (buf[index + length + 2] != ';')
  1479             return enterClass(readName(i)).type;
  1480         return readType(i);
  1483     CompoundAnnotationProxy readCompoundAnnotation() {
  1484         Type t = readTypeOrClassSymbol(nextChar());
  1485         int numFields = nextChar();
  1486         ListBuffer<Pair<Name,Attribute>> pairs =
  1487             new ListBuffer<Pair<Name,Attribute>>();
  1488         for (int i=0; i<numFields; i++) {
  1489             Name name = readName(nextChar());
  1490             Attribute value = readAttributeValue();
  1491             pairs.append(new Pair<Name,Attribute>(name, value));
  1493         return new CompoundAnnotationProxy(t, pairs.toList());
  1496     TypeAnnotationProxy readTypeAnnotation() {
  1497         TypeAnnotationPosition position = readPosition();
  1498         CompoundAnnotationProxy proxy = readCompoundAnnotation();
  1500         return new TypeAnnotationProxy(proxy, position);
  1503     TypeAnnotationPosition readPosition() {
  1504         int tag = nextByte(); // TargetType tag is a byte
  1506         if (!TargetType.isValidTargetTypeValue(tag))
  1507             throw this.badClassFile("bad.type.annotation.value", String.format("0x%02X", tag));
  1509         TypeAnnotationPosition position = new TypeAnnotationPosition();
  1510         TargetType type = TargetType.fromTargetTypeValue(tag);
  1512         position.type = type;
  1514         switch (type) {
  1515         // instanceof
  1516         case INSTANCEOF:
  1517         // new expression
  1518         case NEW:
  1519         // constructor/method reference receiver
  1520         case CONSTRUCTOR_REFERENCE:
  1521         case METHOD_REFERENCE:
  1522             position.offset = nextChar();
  1523             break;
  1524         // local variable
  1525         case LOCAL_VARIABLE:
  1526         // resource variable
  1527         case RESOURCE_VARIABLE:
  1528             int table_length = nextChar();
  1529             position.lvarOffset = new int[table_length];
  1530             position.lvarLength = new int[table_length];
  1531             position.lvarIndex = new int[table_length];
  1533             for (int i = 0; i < table_length; ++i) {
  1534                 position.lvarOffset[i] = nextChar();
  1535                 position.lvarLength[i] = nextChar();
  1536                 position.lvarIndex[i] = nextChar();
  1538             break;
  1539         // exception parameter
  1540         case EXCEPTION_PARAMETER:
  1541             position.exception_index = nextChar();
  1542             break;
  1543         // method receiver
  1544         case METHOD_RECEIVER:
  1545             // Do nothing
  1546             break;
  1547         // type parameter
  1548         case CLASS_TYPE_PARAMETER:
  1549         case METHOD_TYPE_PARAMETER:
  1550             position.parameter_index = nextByte();
  1551             break;
  1552         // type parameter bound
  1553         case CLASS_TYPE_PARAMETER_BOUND:
  1554         case METHOD_TYPE_PARAMETER_BOUND:
  1555             position.parameter_index = nextByte();
  1556             position.bound_index = nextByte();
  1557             break;
  1558         // class extends or implements clause
  1559         case CLASS_EXTENDS:
  1560             position.type_index = nextChar();
  1561             break;
  1562         // throws
  1563         case THROWS:
  1564             position.type_index = nextChar();
  1565             break;
  1566         // method parameter
  1567         case METHOD_FORMAL_PARAMETER:
  1568             position.parameter_index = nextByte();
  1569             break;
  1570         // type cast
  1571         case CAST:
  1572         // method/constructor/reference type argument
  1573         case CONSTRUCTOR_INVOCATION_TYPE_ARGUMENT:
  1574         case METHOD_INVOCATION_TYPE_ARGUMENT:
  1575         case CONSTRUCTOR_REFERENCE_TYPE_ARGUMENT:
  1576         case METHOD_REFERENCE_TYPE_ARGUMENT:
  1577             position.offset = nextChar();
  1578             position.type_index = nextByte();
  1579             break;
  1580         // We don't need to worry about these
  1581         case METHOD_RETURN:
  1582         case FIELD:
  1583             break;
  1584         case UNKNOWN:
  1585             throw new AssertionError("jvm.ClassReader: UNKNOWN target type should never occur!");
  1586         default:
  1587             throw new AssertionError("jvm.ClassReader: Unknown target type for position: " + position);
  1590         { // See whether there is location info and read it
  1591             int len = nextByte();
  1592             ListBuffer<Integer> loc = ListBuffer.lb();
  1593             for (int i = 0; i < len * TypeAnnotationPosition.TypePathEntry.bytesPerEntry; ++i)
  1594                 loc = loc.append(nextByte());
  1595             position.location = TypeAnnotationPosition.getTypePathFromBinary(loc.toList());
  1598         return position;
  1601     Attribute readAttributeValue() {
  1602         char c = (char) buf[bp++];
  1603         switch (c) {
  1604         case 'B':
  1605             return new Attribute.Constant(syms.byteType, readPool(nextChar()));
  1606         case 'C':
  1607             return new Attribute.Constant(syms.charType, readPool(nextChar()));
  1608         case 'D':
  1609             return new Attribute.Constant(syms.doubleType, readPool(nextChar()));
  1610         case 'F':
  1611             return new Attribute.Constant(syms.floatType, readPool(nextChar()));
  1612         case 'I':
  1613             return new Attribute.Constant(syms.intType, readPool(nextChar()));
  1614         case 'J':
  1615             return new Attribute.Constant(syms.longType, readPool(nextChar()));
  1616         case 'S':
  1617             return new Attribute.Constant(syms.shortType, readPool(nextChar()));
  1618         case 'Z':
  1619             return new Attribute.Constant(syms.booleanType, readPool(nextChar()));
  1620         case 's':
  1621             return new Attribute.Constant(syms.stringType, readPool(nextChar()).toString());
  1622         case 'e':
  1623             return new EnumAttributeProxy(readEnumType(nextChar()), readName(nextChar()));
  1624         case 'c':
  1625             return new Attribute.Class(types, readTypeOrClassSymbol(nextChar()));
  1626         case '[': {
  1627             int n = nextChar();
  1628             ListBuffer<Attribute> l = new ListBuffer<Attribute>();
  1629             for (int i=0; i<n; i++)
  1630                 l.append(readAttributeValue());
  1631             return new ArrayAttributeProxy(l.toList());
  1633         case '@':
  1634             return readCompoundAnnotation();
  1635         default:
  1636             throw new AssertionError("unknown annotation tag '" + c + "'");
  1640     interface ProxyVisitor extends Attribute.Visitor {
  1641         void visitEnumAttributeProxy(EnumAttributeProxy proxy);
  1642         void visitArrayAttributeProxy(ArrayAttributeProxy proxy);
  1643         void visitCompoundAnnotationProxy(CompoundAnnotationProxy proxy);
  1646     static class EnumAttributeProxy extends Attribute {
  1647         Type enumType;
  1648         Name enumerator;
  1649         public EnumAttributeProxy(Type enumType, Name enumerator) {
  1650             super(null);
  1651             this.enumType = enumType;
  1652             this.enumerator = enumerator;
  1654         public void accept(Visitor v) { ((ProxyVisitor)v).visitEnumAttributeProxy(this); }
  1655         @Override
  1656         public String toString() {
  1657             return "/*proxy enum*/" + enumType + "." + enumerator;
  1661     static class ArrayAttributeProxy extends Attribute {
  1662         List<Attribute> values;
  1663         ArrayAttributeProxy(List<Attribute> values) {
  1664             super(null);
  1665             this.values = values;
  1667         public void accept(Visitor v) { ((ProxyVisitor)v).visitArrayAttributeProxy(this); }
  1668         @Override
  1669         public String toString() {
  1670             return "{" + values + "}";
  1674     /** A temporary proxy representing a compound attribute.
  1675      */
  1676     static class CompoundAnnotationProxy extends Attribute {
  1677         final List<Pair<Name,Attribute>> values;
  1678         public CompoundAnnotationProxy(Type type,
  1679                                       List<Pair<Name,Attribute>> values) {
  1680             super(type);
  1681             this.values = values;
  1683         public void accept(Visitor v) { ((ProxyVisitor)v).visitCompoundAnnotationProxy(this); }
  1684         @Override
  1685         public String toString() {
  1686             StringBuilder buf = new StringBuilder();
  1687             buf.append("@");
  1688             buf.append(type.tsym.getQualifiedName());
  1689             buf.append("/*proxy*/{");
  1690             boolean first = true;
  1691             for (List<Pair<Name,Attribute>> v = values;
  1692                  v.nonEmpty(); v = v.tail) {
  1693                 Pair<Name,Attribute> value = v.head;
  1694                 if (!first) buf.append(",");
  1695                 first = false;
  1696                 buf.append(value.fst);
  1697                 buf.append("=");
  1698                 buf.append(value.snd);
  1700             buf.append("}");
  1701             return buf.toString();
  1705     /** A temporary proxy representing a type annotation.
  1706      */
  1707     static class TypeAnnotationProxy {
  1708         final CompoundAnnotationProxy compound;
  1709         final TypeAnnotationPosition position;
  1710         public TypeAnnotationProxy(CompoundAnnotationProxy compound,
  1711                 TypeAnnotationPosition position) {
  1712             this.compound = compound;
  1713             this.position = position;
  1717     class AnnotationDeproxy implements ProxyVisitor {
  1718         private ClassSymbol requestingOwner = currentOwner.kind == MTH
  1719             ? currentOwner.enclClass() : (ClassSymbol)currentOwner;
  1721         List<Attribute.Compound> deproxyCompoundList(List<CompoundAnnotationProxy> pl) {
  1722             // also must fill in types!!!!
  1723             ListBuffer<Attribute.Compound> buf =
  1724                 new ListBuffer<Attribute.Compound>();
  1725             for (List<CompoundAnnotationProxy> l = pl; l.nonEmpty(); l=l.tail) {
  1726                 buf.append(deproxyCompound(l.head));
  1728             return buf.toList();
  1731         Attribute.Compound deproxyCompound(CompoundAnnotationProxy a) {
  1732             ListBuffer<Pair<Symbol.MethodSymbol,Attribute>> buf =
  1733                 new ListBuffer<Pair<Symbol.MethodSymbol,Attribute>>();
  1734             for (List<Pair<Name,Attribute>> l = a.values;
  1735                  l.nonEmpty();
  1736                  l = l.tail) {
  1737                 MethodSymbol meth = findAccessMethod(a.type, l.head.fst);
  1738                 buf.append(new Pair<Symbol.MethodSymbol,Attribute>
  1739                            (meth, deproxy(meth.type.getReturnType(), l.head.snd)));
  1741             return new Attribute.Compound(a.type, buf.toList());
  1744         MethodSymbol findAccessMethod(Type container, Name name) {
  1745             CompletionFailure failure = null;
  1746             try {
  1747                 for (Scope.Entry e = container.tsym.members().lookup(name);
  1748                      e.scope != null;
  1749                      e = e.next()) {
  1750                     Symbol sym = e.sym;
  1751                     if (sym.kind == MTH && sym.type.getParameterTypes().length() == 0)
  1752                         return (MethodSymbol) sym;
  1754             } catch (CompletionFailure ex) {
  1755                 failure = ex;
  1757             // The method wasn't found: emit a warning and recover
  1758             JavaFileObject prevSource = log.useSource(requestingOwner.classfile);
  1759             try {
  1760                 if (failure == null) {
  1761                     log.warning("annotation.method.not.found",
  1762                                 container,
  1763                                 name);
  1764                 } else {
  1765                     log.warning("annotation.method.not.found.reason",
  1766                                 container,
  1767                                 name,
  1768                                 failure.getDetailValue());//diagnostic, if present
  1770             } finally {
  1771                 log.useSource(prevSource);
  1773             // Construct a new method type and symbol.  Use bottom
  1774             // type (typeof null) as return type because this type is
  1775             // a subtype of all reference types and can be converted
  1776             // to primitive types by unboxing.
  1777             MethodType mt = new MethodType(List.<Type>nil(),
  1778                                            syms.botType,
  1779                                            List.<Type>nil(),
  1780                                            syms.methodClass);
  1781             return new MethodSymbol(PUBLIC | ABSTRACT, name, mt, container.tsym);
  1784         Attribute result;
  1785         Type type;
  1786         Attribute deproxy(Type t, Attribute a) {
  1787             Type oldType = type;
  1788             try {
  1789                 type = t;
  1790                 a.accept(this);
  1791                 return result;
  1792             } finally {
  1793                 type = oldType;
  1797         // implement Attribute.Visitor below
  1799         public void visitConstant(Attribute.Constant value) {
  1800             // assert value.type == type;
  1801             result = value;
  1804         public void visitClass(Attribute.Class clazz) {
  1805             result = clazz;
  1808         public void visitEnum(Attribute.Enum e) {
  1809             throw new AssertionError(); // shouldn't happen
  1812         public void visitCompound(Attribute.Compound compound) {
  1813             throw new AssertionError(); // shouldn't happen
  1816         public void visitArray(Attribute.Array array) {
  1817             throw new AssertionError(); // shouldn't happen
  1820         public void visitError(Attribute.Error e) {
  1821             throw new AssertionError(); // shouldn't happen
  1824         public void visitEnumAttributeProxy(EnumAttributeProxy proxy) {
  1825             // type.tsym.flatName() should == proxy.enumFlatName
  1826             TypeSymbol enumTypeSym = proxy.enumType.tsym;
  1827             VarSymbol enumerator = null;
  1828             CompletionFailure failure = null;
  1829             try {
  1830                 for (Scope.Entry e = enumTypeSym.members().lookup(proxy.enumerator);
  1831                      e.scope != null;
  1832                      e = e.next()) {
  1833                     if (e.sym.kind == VAR) {
  1834                         enumerator = (VarSymbol)e.sym;
  1835                         break;
  1839             catch (CompletionFailure ex) {
  1840                 failure = ex;
  1842             if (enumerator == null) {
  1843                 if (failure != null) {
  1844                     log.warning("unknown.enum.constant.reason",
  1845                               currentClassFile, enumTypeSym, proxy.enumerator,
  1846                               failure.getDiagnostic());
  1847                 } else {
  1848                     log.warning("unknown.enum.constant",
  1849                               currentClassFile, enumTypeSym, proxy.enumerator);
  1851                 result = new Attribute.Enum(enumTypeSym.type,
  1852                         new VarSymbol(0, proxy.enumerator, syms.botType, enumTypeSym));
  1853             } else {
  1854                 result = new Attribute.Enum(enumTypeSym.type, enumerator);
  1858         public void visitArrayAttributeProxy(ArrayAttributeProxy proxy) {
  1859             int length = proxy.values.length();
  1860             Attribute[] ats = new Attribute[length];
  1861             Type elemtype = types.elemtype(type);
  1862             int i = 0;
  1863             for (List<Attribute> p = proxy.values; p.nonEmpty(); p = p.tail) {
  1864                 ats[i++] = deproxy(elemtype, p.head);
  1866             result = new Attribute.Array(type, ats);
  1869         public void visitCompoundAnnotationProxy(CompoundAnnotationProxy proxy) {
  1870             result = deproxyCompound(proxy);
  1874     class AnnotationDefaultCompleter extends AnnotationDeproxy implements Annotate.Annotator {
  1875         final MethodSymbol sym;
  1876         final Attribute value;
  1877         final JavaFileObject classFile = currentClassFile;
  1878         @Override
  1879         public String toString() {
  1880             return " ClassReader store default for " + sym.owner + "." + sym + " is " + value;
  1882         AnnotationDefaultCompleter(MethodSymbol sym, Attribute value) {
  1883             this.sym = sym;
  1884             this.value = value;
  1886         // implement Annotate.Annotator.enterAnnotation()
  1887         public void enterAnnotation() {
  1888             JavaFileObject previousClassFile = currentClassFile;
  1889             try {
  1890                 // Reset the interim value set earlier in
  1891                 // attachAnnotationDefault().
  1892                 sym.defaultValue = null;
  1893                 currentClassFile = classFile;
  1894                 sym.defaultValue = deproxy(sym.type.getReturnType(), value);
  1895             } finally {
  1896                 currentClassFile = previousClassFile;
  1901     class AnnotationCompleter extends AnnotationDeproxy implements Annotate.Annotator {
  1902         final Symbol sym;
  1903         final List<CompoundAnnotationProxy> l;
  1904         final JavaFileObject classFile;
  1905         @Override
  1906         public String toString() {
  1907             return " ClassReader annotate " + sym.owner + "." + sym + " with " + l;
  1909         AnnotationCompleter(Symbol sym, List<CompoundAnnotationProxy> l) {
  1910             this.sym = sym;
  1911             this.l = l;
  1912             this.classFile = currentClassFile;
  1914         // implement Annotate.Annotator.enterAnnotation()
  1915         public void enterAnnotation() {
  1916             JavaFileObject previousClassFile = currentClassFile;
  1917             try {
  1918                 currentClassFile = classFile;
  1919                 List<Attribute.Compound> newList = deproxyCompoundList(l);
  1920                 if (sym.annotationsPendingCompletion()) {
  1921                     sym.setDeclarationAttributes(newList);
  1922                 } else {
  1923                     sym.appendAttributes(newList);
  1925             } finally {
  1926                 currentClassFile = previousClassFile;
  1931     class TypeAnnotationCompleter extends AnnotationCompleter {
  1933         List<TypeAnnotationProxy> proxies;
  1935         TypeAnnotationCompleter(Symbol sym,
  1936                 List<TypeAnnotationProxy> proxies) {
  1937             super(sym, List.<CompoundAnnotationProxy>nil());
  1938             this.proxies = proxies;
  1941         List<Attribute.TypeCompound> deproxyTypeCompoundList(List<TypeAnnotationProxy> proxies) {
  1942             ListBuffer<Attribute.TypeCompound> buf = ListBuffer.lb();
  1943             for (TypeAnnotationProxy proxy: proxies) {
  1944                 Attribute.Compound compound = deproxyCompound(proxy.compound);
  1945                 Attribute.TypeCompound typeCompound = new Attribute.TypeCompound(compound, proxy.position);
  1946                 buf.add(typeCompound);
  1948             return buf.toList();
  1951         @Override
  1952         public void enterAnnotation() {
  1953             JavaFileObject previousClassFile = currentClassFile;
  1954             try {
  1955                 currentClassFile = classFile;
  1956                 List<Attribute.TypeCompound> newList = deproxyTypeCompoundList(proxies);
  1957                 sym.setTypeAttributes(newList.prependList(sym.getRawTypeAttributes()));
  1958             } finally {
  1959                 currentClassFile = previousClassFile;
  1965 /************************************************************************
  1966  * Reading Symbols
  1967  ***********************************************************************/
  1969     /** Read a field.
  1970      */
  1971     VarSymbol readField() {
  1972         long flags = adjustFieldFlags(nextChar());
  1973         Name name = readName(nextChar());
  1974         Type type = readType(nextChar());
  1975         VarSymbol v = new VarSymbol(flags, name, type, currentOwner);
  1976         readMemberAttrs(v);
  1977         return v;
  1980     /** Read a method.
  1981      */
  1982     MethodSymbol readMethod() {
  1983         long flags = adjustMethodFlags(nextChar());
  1984         Name name = readName(nextChar());
  1985         Type type = readType(nextChar());
  1986         if (currentOwner.isInterface() &&
  1987                 (flags & ABSTRACT) == 0 && !name.equals(names.clinit)) {
  1988             if (majorVersion > Target.JDK1_8.majorVersion ||
  1989                     (majorVersion == Target.JDK1_8.majorVersion && minorVersion >= Target.JDK1_8.minorVersion)) {
  1990                 currentOwner.flags_field |= DEFAULT;
  1991                 flags |= DEFAULT | ABSTRACT;
  1992             } else {
  1993                 //protect against ill-formed classfiles
  1994                 throw new CompletionFailure(currentOwner, "default method found in pre JDK 8 classfile");
  1997         if (name == names.init && currentOwner.hasOuterInstance()) {
  1998             // Sometimes anonymous classes don't have an outer
  1999             // instance, however, there is no reliable way to tell so
  2000             // we never strip this$n
  2001             if (!currentOwner.name.isEmpty())
  2002                 type = new MethodType(adjustMethodParams(flags, type.getParameterTypes()),
  2003                                       type.getReturnType(),
  2004                                       type.getThrownTypes(),
  2005                                       syms.methodClass);
  2007         MethodSymbol m = new MethodSymbol(flags, name, type, currentOwner);
  2008         if (types.isSignaturePolymorphic(m)) {
  2009             m.flags_field |= SIGNATURE_POLYMORPHIC;
  2011         if (saveParameterNames)
  2012             initParameterNames(m);
  2013         Symbol prevOwner = currentOwner;
  2014         currentOwner = m;
  2015         try {
  2016             readMemberAttrs(m);
  2017         } finally {
  2018             currentOwner = prevOwner;
  2020         if (saveParameterNames)
  2021             setParameterNames(m, type);
  2022         return m;
  2025     private List<Type> adjustMethodParams(long flags, List<Type> args) {
  2026         boolean isVarargs = (flags & VARARGS) != 0;
  2027         if (isVarargs) {
  2028             Type varargsElem = args.last();
  2029             ListBuffer<Type> adjustedArgs = ListBuffer.lb();
  2030             for (Type t : args) {
  2031                 adjustedArgs.append(t != varargsElem ?
  2032                     t :
  2033                     ((ArrayType)t).makeVarargs());
  2035             args = adjustedArgs.toList();
  2037         return args.tail;
  2040     /**
  2041      * Init the parameter names array.
  2042      * Parameter names are currently inferred from the names in the
  2043      * LocalVariableTable attributes of a Code attribute.
  2044      * (Note: this means parameter names are currently not available for
  2045      * methods without a Code attribute.)
  2046      * This method initializes an array in which to store the name indexes
  2047      * of parameter names found in LocalVariableTable attributes. It is
  2048      * slightly supersized to allow for additional slots with a start_pc of 0.
  2049      */
  2050     void initParameterNames(MethodSymbol sym) {
  2051         // make allowance for synthetic parameters.
  2052         final int excessSlots = 4;
  2053         int expectedParameterSlots =
  2054                 Code.width(sym.type.getParameterTypes()) + excessSlots;
  2055         if (parameterNameIndices == null
  2056                 || parameterNameIndices.length < expectedParameterSlots) {
  2057             parameterNameIndices = new int[expectedParameterSlots];
  2058         } else
  2059             Arrays.fill(parameterNameIndices, 0);
  2060         haveParameterNameIndices = false;
  2061         sawMethodParameters = false;
  2064     /**
  2065      * Set the parameter names for a symbol from the name index in the
  2066      * parameterNameIndicies array. The type of the symbol may have changed
  2067      * while reading the method attributes (see the Signature attribute).
  2068      * This may be because of generic information or because anonymous
  2069      * synthetic parameters were added.   The original type (as read from
  2070      * the method descriptor) is used to help guess the existence of
  2071      * anonymous synthetic parameters.
  2072      * On completion, sym.savedParameter names will either be null (if
  2073      * no parameter names were found in the class file) or will be set to a
  2074      * list of names, one per entry in sym.type.getParameterTypes, with
  2075      * any missing names represented by the empty name.
  2076      */
  2077     void setParameterNames(MethodSymbol sym, Type jvmType) {
  2078         // if no names were found in the class file, there's nothing more to do
  2079         if (!haveParameterNameIndices)
  2080             return;
  2081         // If we get parameter names from MethodParameters, then we
  2082         // don't need to skip.
  2083         int firstParam = 0;
  2084         if (!sawMethodParameters) {
  2085             firstParam = ((sym.flags() & STATIC) == 0) ? 1 : 0;
  2086             // the code in readMethod may have skipped the first
  2087             // parameter when setting up the MethodType. If so, we
  2088             // make a corresponding allowance here for the position of
  2089             // the first parameter.  Note that this assumes the
  2090             // skipped parameter has a width of 1 -- i.e. it is not
  2091         // a double width type (long or double.)
  2092         if (sym.name == names.init && currentOwner.hasOuterInstance()) {
  2093             // Sometimes anonymous classes don't have an outer
  2094             // instance, however, there is no reliable way to tell so
  2095             // we never strip this$n
  2096             if (!currentOwner.name.isEmpty())
  2097                 firstParam += 1;
  2100         if (sym.type != jvmType) {
  2101                 // reading the method attributes has caused the
  2102                 // symbol's type to be changed. (i.e. the Signature
  2103                 // attribute.)  This may happen if there are hidden
  2104                 // (synthetic) parameters in the descriptor, but not
  2105                 // in the Signature.  The position of these hidden
  2106                 // parameters is unspecified; for now, assume they are
  2107                 // at the beginning, and so skip over them. The
  2108                 // primary case for this is two hidden parameters
  2109                 // passed into Enum constructors.
  2110             int skip = Code.width(jvmType.getParameterTypes())
  2111                     - Code.width(sym.type.getParameterTypes());
  2112             firstParam += skip;
  2115         List<Name> paramNames = List.nil();
  2116         int index = firstParam;
  2117         for (Type t: sym.type.getParameterTypes()) {
  2118             int nameIdx = (index < parameterNameIndices.length
  2119                     ? parameterNameIndices[index] : 0);
  2120             Name name = nameIdx == 0 ? names.empty : readName(nameIdx);
  2121             paramNames = paramNames.prepend(name);
  2122             index += Code.width(t);
  2124         sym.savedParameterNames = paramNames.reverse();
  2127     /**
  2128      * skip n bytes
  2129      */
  2130     void skipBytes(int n) {
  2131         bp = bp + n;
  2134     /** Skip a field or method
  2135      */
  2136     void skipMember() {
  2137         bp = bp + 6;
  2138         char ac = nextChar();
  2139         for (int i = 0; i < ac; i++) {
  2140             bp = bp + 2;
  2141             int attrLen = nextInt();
  2142             bp = bp + attrLen;
  2146     /** Enter type variables of this classtype and all enclosing ones in
  2147      *  `typevars'.
  2148      */
  2149     protected void enterTypevars(Type t) {
  2150         if (t.getEnclosingType() != null && t.getEnclosingType().hasTag(CLASS))
  2151             enterTypevars(t.getEnclosingType());
  2152         for (List<Type> xs = t.getTypeArguments(); xs.nonEmpty(); xs = xs.tail)
  2153             typevars.enter(xs.head.tsym);
  2156     protected void enterTypevars(Symbol sym) {
  2157         if (sym.owner.kind == MTH) {
  2158             enterTypevars(sym.owner);
  2159             enterTypevars(sym.owner.owner);
  2161         enterTypevars(sym.type);
  2164     /** Read contents of a given class symbol `c'. Both external and internal
  2165      *  versions of an inner class are read.
  2166      */
  2167     void readClass(ClassSymbol c) {
  2168         ClassType ct = (ClassType)c.type;
  2170         // allocate scope for members
  2171         c.members_field = new Scope(c);
  2173         // prepare type variable table
  2174         typevars = typevars.dup(currentOwner);
  2175         if (ct.getEnclosingType().hasTag(CLASS))
  2176             enterTypevars(ct.getEnclosingType());
  2178         // read flags, or skip if this is an inner class
  2179         long flags = adjustClassFlags(nextChar());
  2180         if (c.owner.kind == PCK) c.flags_field = flags;
  2182         // read own class name and check that it matches
  2183         ClassSymbol self = readClassSymbol(nextChar());
  2184         if (c != self)
  2185             throw badClassFile("class.file.wrong.class",
  2186                                self.flatname);
  2188         // class attributes must be read before class
  2189         // skip ahead to read class attributes
  2190         int startbp = bp;
  2191         nextChar();
  2192         char interfaceCount = nextChar();
  2193         bp += interfaceCount * 2;
  2194         char fieldCount = nextChar();
  2195         for (int i = 0; i < fieldCount; i++) skipMember();
  2196         char methodCount = nextChar();
  2197         for (int i = 0; i < methodCount; i++) skipMember();
  2198         readClassAttrs(c);
  2200         if (readAllOfClassFile) {
  2201             for (int i = 1; i < poolObj.length; i++) readPool(i);
  2202             c.pool = new Pool(poolObj.length, poolObj, types);
  2205         // reset and read rest of classinfo
  2206         bp = startbp;
  2207         int n = nextChar();
  2208         if (ct.supertype_field == null)
  2209             ct.supertype_field = (n == 0)
  2210                 ? Type.noType
  2211                 : readClassSymbol(n).erasure(types);
  2212         n = nextChar();
  2213         List<Type> is = List.nil();
  2214         for (int i = 0; i < n; i++) {
  2215             Type _inter = readClassSymbol(nextChar()).erasure(types);
  2216             is = is.prepend(_inter);
  2218         if (ct.interfaces_field == null)
  2219             ct.interfaces_field = is.reverse();
  2221         Assert.check(fieldCount == nextChar());
  2222         for (int i = 0; i < fieldCount; i++) enterMember(c, readField());
  2223         Assert.check(methodCount == nextChar());
  2224         for (int i = 0; i < methodCount; i++) enterMember(c, readMethod());
  2226         typevars = typevars.leave();
  2229     /** Read inner class info. For each inner/outer pair allocate a
  2230      *  member class.
  2231      */
  2232     void readInnerClasses(ClassSymbol c) {
  2233         int n = nextChar();
  2234         for (int i = 0; i < n; i++) {
  2235             nextChar(); // skip inner class symbol
  2236             ClassSymbol outer = readClassSymbol(nextChar());
  2237             Name name = readName(nextChar());
  2238             if (name == null) name = names.empty;
  2239             long flags = adjustClassFlags(nextChar());
  2240             if (outer != null) { // we have a member class
  2241                 if (name == names.empty)
  2242                     name = names.one;
  2243                 ClassSymbol member = enterClass(name, outer);
  2244                 if ((flags & STATIC) == 0) {
  2245                     ((ClassType)member.type).setEnclosingType(outer.type);
  2246                     if (member.erasure_field != null)
  2247                         ((ClassType)member.erasure_field).setEnclosingType(types.erasure(outer.type));
  2249                 if (c == outer) {
  2250                     member.flags_field = flags;
  2251                     enterMember(c, member);
  2257     /** Read a class file.
  2258      */
  2259     private void readClassFile(ClassSymbol c) throws IOException {
  2260         int magic = nextInt();
  2261         if (magic != JAVA_MAGIC)
  2262             throw badClassFile("illegal.start.of.class.file");
  2264         minorVersion = nextChar();
  2265         majorVersion = nextChar();
  2266         int maxMajor = Target.MAX().majorVersion;
  2267         int maxMinor = Target.MAX().minorVersion;
  2268         if (majorVersion > maxMajor ||
  2269             majorVersion * 1000 + minorVersion <
  2270             Target.MIN().majorVersion * 1000 + Target.MIN().minorVersion)
  2272             if (majorVersion == (maxMajor + 1))
  2273                 log.warning("big.major.version",
  2274                             currentClassFile,
  2275                             majorVersion,
  2276                             maxMajor);
  2277             else
  2278                 throw badClassFile("wrong.version",
  2279                                    Integer.toString(majorVersion),
  2280                                    Integer.toString(minorVersion),
  2281                                    Integer.toString(maxMajor),
  2282                                    Integer.toString(maxMinor));
  2284         else if (checkClassFile &&
  2285                  majorVersion == maxMajor &&
  2286                  minorVersion > maxMinor)
  2288             printCCF("found.later.version",
  2289                      Integer.toString(minorVersion));
  2291         indexPool();
  2292         if (signatureBuffer.length < bp) {
  2293             int ns = Integer.highestOneBit(bp) << 1;
  2294             signatureBuffer = new byte[ns];
  2296         readClass(c);
  2299 /************************************************************************
  2300  * Adjusting flags
  2301  ***********************************************************************/
  2303     long adjustFieldFlags(long flags) {
  2304         return flags;
  2306     long adjustMethodFlags(long flags) {
  2307         if ((flags & ACC_BRIDGE) != 0) {
  2308             flags &= ~ACC_BRIDGE;
  2309             flags |= BRIDGE;
  2310             if (!allowGenerics)
  2311                 flags &= ~SYNTHETIC;
  2313         if ((flags & ACC_VARARGS) != 0) {
  2314             flags &= ~ACC_VARARGS;
  2315             flags |= VARARGS;
  2317         return flags;
  2319     long adjustClassFlags(long flags) {
  2320         return flags & ~ACC_SUPER; // SUPER and SYNCHRONIZED bits overloaded
  2323 /************************************************************************
  2324  * Loading Classes
  2325  ***********************************************************************/
  2327     /** Define a new class given its name and owner.
  2328      */
  2329     public ClassSymbol defineClass(Name name, Symbol owner) {
  2330         ClassSymbol c = new ClassSymbol(0, name, owner);
  2331         if (owner.kind == PCK)
  2332             Assert.checkNull(classes.get(c.flatname), c);
  2333         c.completer = thisCompleter;
  2334         return c;
  2337     /** Create a new toplevel or member class symbol with given name
  2338      *  and owner and enter in `classes' unless already there.
  2339      */
  2340     public ClassSymbol enterClass(Name name, TypeSymbol owner) {
  2341         Name flatname = TypeSymbol.formFlatName(name, owner);
  2342         ClassSymbol c = classes.get(flatname);
  2343         if (c == null) {
  2344             c = defineClass(name, owner);
  2345             classes.put(flatname, c);
  2346         } else if ((c.name != name || c.owner != owner) && owner.kind == TYP && c.owner.kind == PCK) {
  2347             // reassign fields of classes that might have been loaded with
  2348             // their flat names.
  2349             c.owner.members().remove(c);
  2350             c.name = name;
  2351             c.owner = owner;
  2352             c.fullname = ClassSymbol.formFullName(name, owner);
  2354         return c;
  2357     /**
  2358      * Creates a new toplevel class symbol with given flat name and
  2359      * given class (or source) file.
  2361      * @param flatName a fully qualified binary class name
  2362      * @param classFile the class file or compilation unit defining
  2363      * the class (may be {@code null})
  2364      * @return a newly created class symbol
  2365      * @throws AssertionError if the class symbol already exists
  2366      */
  2367     public ClassSymbol enterClass(Name flatName, JavaFileObject classFile) {
  2368         ClassSymbol cs = classes.get(flatName);
  2369         if (cs != null) {
  2370             String msg = Log.format("%s: completer = %s; class file = %s; source file = %s",
  2371                                     cs.fullname,
  2372                                     cs.completer,
  2373                                     cs.classfile,
  2374                                     cs.sourcefile);
  2375             throw new AssertionError(msg);
  2377         Name packageName = Convert.packagePart(flatName);
  2378         PackageSymbol owner = packageName.isEmpty()
  2379                                 ? syms.unnamedPackage
  2380                                 : enterPackage(packageName);
  2381         cs = defineClass(Convert.shortName(flatName), owner);
  2382         cs.classfile = classFile;
  2383         classes.put(flatName, cs);
  2384         return cs;
  2387     /** Create a new member or toplevel class symbol with given flat name
  2388      *  and enter in `classes' unless already there.
  2389      */
  2390     public ClassSymbol enterClass(Name flatname) {
  2391         ClassSymbol c = classes.get(flatname);
  2392         if (c == null)
  2393             return enterClass(flatname, (JavaFileObject)null);
  2394         else
  2395             return c;
  2398     private boolean suppressFlush = false;
  2400     /** Completion for classes to be loaded. Before a class is loaded
  2401      *  we make sure its enclosing class (if any) is loaded.
  2402      */
  2403     private void complete(Symbol sym) throws CompletionFailure {
  2404         if (sym.kind == TYP) {
  2405             ClassSymbol c = (ClassSymbol)sym;
  2406             c.members_field = new Scope.ErrorScope(c); // make sure it's always defined
  2407             boolean saveSuppressFlush = suppressFlush;
  2408             suppressFlush = true;
  2409             try {
  2410                 completeOwners(c.owner);
  2411                 completeEnclosing(c);
  2412             } finally {
  2413                 suppressFlush = saveSuppressFlush;
  2415             fillIn(c);
  2416         } else if (sym.kind == PCK) {
  2417             PackageSymbol p = (PackageSymbol)sym;
  2418             try {
  2419                 fillIn(p);
  2420             } catch (IOException ex) {
  2421                 throw new CompletionFailure(sym, ex.getLocalizedMessage()).initCause(ex);
  2424         if (!filling && !suppressFlush)
  2425             annotate.flush(); // finish attaching annotations
  2428     /** complete up through the enclosing package. */
  2429     private void completeOwners(Symbol o) {
  2430         if (o.kind != PCK) completeOwners(o.owner);
  2431         o.complete();
  2434     /**
  2435      * Tries to complete lexically enclosing classes if c looks like a
  2436      * nested class.  This is similar to completeOwners but handles
  2437      * the situation when a nested class is accessed directly as it is
  2438      * possible with the Tree API or javax.lang.model.*.
  2439      */
  2440     private void completeEnclosing(ClassSymbol c) {
  2441         if (c.owner.kind == PCK) {
  2442             Symbol owner = c.owner;
  2443             for (Name name : Convert.enclosingCandidates(Convert.shortName(c.name))) {
  2444                 Symbol encl = owner.members().lookup(name).sym;
  2445                 if (encl == null)
  2446                     encl = classes.get(TypeSymbol.formFlatName(name, owner));
  2447                 if (encl != null)
  2448                     encl.complete();
  2453     /** We can only read a single class file at a time; this
  2454      *  flag keeps track of when we are currently reading a class
  2455      *  file.
  2456      */
  2457     private boolean filling = false;
  2459     /** Fill in definition of class `c' from corresponding class or
  2460      *  source file.
  2461      */
  2462     private void fillIn(ClassSymbol c) {
  2463         if (completionFailureName == c.fullname) {
  2464             throw new CompletionFailure(c, "user-selected completion failure by class name");
  2466         currentOwner = c;
  2467         warnedAttrs.clear();
  2468         JavaFileObject classfile = c.classfile;
  2469         if (classfile != null) {
  2470             JavaFileObject previousClassFile = currentClassFile;
  2471             try {
  2472                 if (filling) {
  2473                     Assert.error("Filling " + classfile.toUri() + " during " + previousClassFile);
  2475                 currentClassFile = classfile;
  2476                 if (verbose) {
  2477                     log.printVerbose("loading", currentClassFile.toString());
  2479                 if (classfile.getKind() == JavaFileObject.Kind.CLASS) {
  2480                     filling = true;
  2481                     try {
  2482                         bp = 0;
  2483                         buf = readInputStream(buf, classfile.openInputStream());
  2484                         readClassFile(c);
  2485                         if (!missingTypeVariables.isEmpty() && !foundTypeVariables.isEmpty()) {
  2486                             List<Type> missing = missingTypeVariables;
  2487                             List<Type> found = foundTypeVariables;
  2488                             missingTypeVariables = List.nil();
  2489                             foundTypeVariables = List.nil();
  2490                             filling = false;
  2491                             ClassType ct = (ClassType)currentOwner.type;
  2492                             ct.supertype_field =
  2493                                 types.subst(ct.supertype_field, missing, found);
  2494                             ct.interfaces_field =
  2495                                 types.subst(ct.interfaces_field, missing, found);
  2496                         } else if (missingTypeVariables.isEmpty() !=
  2497                                    foundTypeVariables.isEmpty()) {
  2498                             Name name = missingTypeVariables.head.tsym.name;
  2499                             throw badClassFile("undecl.type.var", name);
  2501                     } finally {
  2502                         missingTypeVariables = List.nil();
  2503                         foundTypeVariables = List.nil();
  2504                         filling = false;
  2506                 } else {
  2507                     if (sourceCompleter != null) {
  2508                         sourceCompleter.complete(c);
  2509                     } else {
  2510                         throw new IllegalStateException("Source completer required to read "
  2511                                                         + classfile.toUri());
  2514                 return;
  2515             } catch (IOException ex) {
  2516                 throw badClassFile("unable.to.access.file", ex.getMessage());
  2517             } finally {
  2518                 currentClassFile = previousClassFile;
  2520         } else {
  2521             JCDiagnostic diag =
  2522                 diagFactory.fragment("class.file.not.found", c.flatname);
  2523             throw
  2524                 newCompletionFailure(c, diag);
  2527     // where
  2528         private static byte[] readInputStream(byte[] buf, InputStream s) throws IOException {
  2529             try {
  2530                 buf = ensureCapacity(buf, s.available());
  2531                 int r = s.read(buf);
  2532                 int bp = 0;
  2533                 while (r != -1) {
  2534                     bp += r;
  2535                     buf = ensureCapacity(buf, bp);
  2536                     r = s.read(buf, bp, buf.length - bp);
  2538                 return buf;
  2539             } finally {
  2540                 try {
  2541                     s.close();
  2542                 } catch (IOException e) {
  2543                     /* Ignore any errors, as this stream may have already
  2544                      * thrown a related exception which is the one that
  2545                      * should be reported.
  2546                      */
  2550         /*
  2551          * ensureCapacity will increase the buffer as needed, taking note that
  2552          * the new buffer will always be greater than the needed and never
  2553          * exactly equal to the needed size or bp. If equal then the read (above)
  2554          * will infinitely loop as buf.length - bp == 0.
  2555          */
  2556         private static byte[] ensureCapacity(byte[] buf, int needed) {
  2557             if (buf.length <= needed) {
  2558                 byte[] old = buf;
  2559                 buf = new byte[Integer.highestOneBit(needed) << 1];
  2560                 System.arraycopy(old, 0, buf, 0, old.length);
  2562             return buf;
  2564         /** Static factory for CompletionFailure objects.
  2565          *  In practice, only one can be used at a time, so we share one
  2566          *  to reduce the expense of allocating new exception objects.
  2567          */
  2568         private CompletionFailure newCompletionFailure(TypeSymbol c,
  2569                                                        JCDiagnostic diag) {
  2570             if (!cacheCompletionFailure) {
  2571                 // log.warning("proc.messager",
  2572                 //             Log.getLocalizedString("class.file.not.found", c.flatname));
  2573                 // c.debug.printStackTrace();
  2574                 return new CompletionFailure(c, diag);
  2575             } else {
  2576                 CompletionFailure result = cachedCompletionFailure;
  2577                 result.sym = c;
  2578                 result.diag = diag;
  2579                 return result;
  2582         private CompletionFailure cachedCompletionFailure =
  2583             new CompletionFailure(null, (JCDiagnostic) null);
  2585             cachedCompletionFailure.setStackTrace(new StackTraceElement[0]);
  2588     /** Load a toplevel class with given fully qualified name
  2589      *  The class is entered into `classes' only if load was successful.
  2590      */
  2591     public ClassSymbol loadClass(Name flatname) throws CompletionFailure {
  2592         boolean absent = classes.get(flatname) == null;
  2593         ClassSymbol c = enterClass(flatname);
  2594         if (c.members_field == null && c.completer != null) {
  2595             try {
  2596                 c.complete();
  2597             } catch (CompletionFailure ex) {
  2598                 if (absent) classes.remove(flatname);
  2599                 throw ex;
  2602         return c;
  2605 /************************************************************************
  2606  * Loading Packages
  2607  ***********************************************************************/
  2609     /** Check to see if a package exists, given its fully qualified name.
  2610      */
  2611     public boolean packageExists(Name fullname) {
  2612         return enterPackage(fullname).exists();
  2615     /** Make a package, given its fully qualified name.
  2616      */
  2617     public PackageSymbol enterPackage(Name fullname) {
  2618         PackageSymbol p = packages.get(fullname);
  2619         if (p == null) {
  2620             Assert.check(!fullname.isEmpty(), "rootPackage missing!");
  2621             p = new PackageSymbol(
  2622                 Convert.shortName(fullname),
  2623                 enterPackage(Convert.packagePart(fullname)));
  2624             p.completer = thisCompleter;
  2625             packages.put(fullname, p);
  2627         return p;
  2630     /** Make a package, given its unqualified name and enclosing package.
  2631      */
  2632     public PackageSymbol enterPackage(Name name, PackageSymbol owner) {
  2633         return enterPackage(TypeSymbol.formFullName(name, owner));
  2636     /** Include class corresponding to given class file in package,
  2637      *  unless (1) we already have one the same kind (.class or .java), or
  2638      *         (2) we have one of the other kind, and the given class file
  2639      *             is older.
  2640      */
  2641     protected void includeClassFile(PackageSymbol p, JavaFileObject file) {
  2642         if ((p.flags_field & EXISTS) == 0)
  2643             for (Symbol q = p; q != null && q.kind == PCK; q = q.owner)
  2644                 q.flags_field |= EXISTS;
  2645         JavaFileObject.Kind kind = file.getKind();
  2646         int seen;
  2647         if (kind == JavaFileObject.Kind.CLASS)
  2648             seen = CLASS_SEEN;
  2649         else
  2650             seen = SOURCE_SEEN;
  2651         String binaryName = fileManager.inferBinaryName(currentLoc, file);
  2652         int lastDot = binaryName.lastIndexOf(".");
  2653         Name classname = names.fromString(binaryName.substring(lastDot + 1));
  2654         boolean isPkgInfo = classname == names.package_info;
  2655         ClassSymbol c = isPkgInfo
  2656             ? p.package_info
  2657             : (ClassSymbol) p.members_field.lookup(classname).sym;
  2658         if (c == null) {
  2659             c = enterClass(classname, p);
  2660             if (c.classfile == null) // only update the file if's it's newly created
  2661                 c.classfile = file;
  2662             if (isPkgInfo) {
  2663                 p.package_info = c;
  2664             } else {
  2665                 if (c.owner == p)  // it might be an inner class
  2666                     p.members_field.enter(c);
  2668         } else if (c.classfile != null && (c.flags_field & seen) == 0) {
  2669             // if c.classfile == null, we are currently compiling this class
  2670             // and no further action is necessary.
  2671             // if (c.flags_field & seen) != 0, we have already encountered
  2672             // a file of the same kind; again no further action is necessary.
  2673             if ((c.flags_field & (CLASS_SEEN | SOURCE_SEEN)) != 0)
  2674                 c.classfile = preferredFileObject(file, c.classfile);
  2676         c.flags_field |= seen;
  2679     /** Implement policy to choose to derive information from a source
  2680      *  file or a class file when both are present.  May be overridden
  2681      *  by subclasses.
  2682      */
  2683     protected JavaFileObject preferredFileObject(JavaFileObject a,
  2684                                            JavaFileObject b) {
  2686         if (preferSource)
  2687             return (a.getKind() == JavaFileObject.Kind.SOURCE) ? a : b;
  2688         else {
  2689             long adate = a.getLastModified();
  2690             long bdate = b.getLastModified();
  2691             // 6449326: policy for bad lastModifiedTime in ClassReader
  2692             //assert adate >= 0 && bdate >= 0;
  2693             return (adate > bdate) ? a : b;
  2697     /**
  2698      * specifies types of files to be read when filling in a package symbol
  2699      */
  2700     protected EnumSet<JavaFileObject.Kind> getPackageFileKinds() {
  2701         return EnumSet.of(JavaFileObject.Kind.CLASS, JavaFileObject.Kind.SOURCE);
  2704     /**
  2705      * this is used to support javadoc
  2706      */
  2707     protected void extraFileActions(PackageSymbol pack, JavaFileObject fe) {
  2710     protected Location currentLoc; // FIXME
  2712     private boolean verbosePath = true;
  2714     /** Load directory of package into members scope.
  2715      */
  2716     private void fillIn(PackageSymbol p) throws IOException {
  2717         if (p.members_field == null) p.members_field = new Scope(p);
  2718         String packageName = p.fullname.toString();
  2720         Set<JavaFileObject.Kind> kinds = getPackageFileKinds();
  2722         fillIn(p, PLATFORM_CLASS_PATH,
  2723                fileManager.list(PLATFORM_CLASS_PATH,
  2724                                 packageName,
  2725                                 EnumSet.of(JavaFileObject.Kind.CLASS),
  2726                                 false));
  2728         Set<JavaFileObject.Kind> classKinds = EnumSet.copyOf(kinds);
  2729         classKinds.remove(JavaFileObject.Kind.SOURCE);
  2730         boolean wantClassFiles = !classKinds.isEmpty();
  2732         Set<JavaFileObject.Kind> sourceKinds = EnumSet.copyOf(kinds);
  2733         sourceKinds.remove(JavaFileObject.Kind.CLASS);
  2734         boolean wantSourceFiles = !sourceKinds.isEmpty();
  2736         boolean haveSourcePath = fileManager.hasLocation(SOURCE_PATH);
  2738         if (verbose && verbosePath) {
  2739             if (fileManager instanceof StandardJavaFileManager) {
  2740                 StandardJavaFileManager fm = (StandardJavaFileManager)fileManager;
  2741                 if (haveSourcePath && wantSourceFiles) {
  2742                     List<File> path = List.nil();
  2743                     for (File file : fm.getLocation(SOURCE_PATH)) {
  2744                         path = path.prepend(file);
  2746                     log.printVerbose("sourcepath", path.reverse().toString());
  2747                 } else if (wantSourceFiles) {
  2748                     List<File> path = List.nil();
  2749                     for (File file : fm.getLocation(CLASS_PATH)) {
  2750                         path = path.prepend(file);
  2752                     log.printVerbose("sourcepath", path.reverse().toString());
  2754                 if (wantClassFiles) {
  2755                     List<File> path = List.nil();
  2756                     for (File file : fm.getLocation(PLATFORM_CLASS_PATH)) {
  2757                         path = path.prepend(file);
  2759                     for (File file : fm.getLocation(CLASS_PATH)) {
  2760                         path = path.prepend(file);
  2762                     log.printVerbose("classpath",  path.reverse().toString());
  2767         if (wantSourceFiles && !haveSourcePath) {
  2768             fillIn(p, CLASS_PATH,
  2769                    fileManager.list(CLASS_PATH,
  2770                                     packageName,
  2771                                     kinds,
  2772                                     false));
  2773         } else {
  2774             if (wantClassFiles)
  2775                 fillIn(p, CLASS_PATH,
  2776                        fileManager.list(CLASS_PATH,
  2777                                         packageName,
  2778                                         classKinds,
  2779                                         false));
  2780             if (wantSourceFiles)
  2781                 fillIn(p, SOURCE_PATH,
  2782                        fileManager.list(SOURCE_PATH,
  2783                                         packageName,
  2784                                         sourceKinds,
  2785                                         false));
  2787         verbosePath = false;
  2789     // where
  2790         private void fillIn(PackageSymbol p,
  2791                             Location location,
  2792                             Iterable<JavaFileObject> files)
  2794             currentLoc = location;
  2795             for (JavaFileObject fo : files) {
  2796                 switch (fo.getKind()) {
  2797                 case CLASS:
  2798                 case SOURCE: {
  2799                     // TODO pass binaryName to includeClassFile
  2800                     String binaryName = fileManager.inferBinaryName(currentLoc, fo);
  2801                     String simpleName = binaryName.substring(binaryName.lastIndexOf(".") + 1);
  2802                     if (SourceVersion.isIdentifier(simpleName) ||
  2803                         simpleName.equals("package-info"))
  2804                         includeClassFile(p, fo);
  2805                     break;
  2807                 default:
  2808                     extraFileActions(p, fo);
  2813     /** Output for "-checkclassfile" option.
  2814      *  @param key The key to look up the correct internationalized string.
  2815      *  @param arg An argument for substitution into the output string.
  2816      */
  2817     private void printCCF(String key, Object arg) {
  2818         log.printLines(key, arg);
  2822     public interface SourceCompleter {
  2823         void complete(ClassSymbol sym)
  2824             throws CompletionFailure;
  2827     /**
  2828      * A subclass of JavaFileObject for the sourcefile attribute found in a classfile.
  2829      * The attribute is only the last component of the original filename, so is unlikely
  2830      * to be valid as is, so operations other than those to access the name throw
  2831      * UnsupportedOperationException
  2832      */
  2833     private static class SourceFileObject extends BaseFileObject {
  2835         /** The file's name.
  2836          */
  2837         private Name name;
  2838         private Name flatname;
  2840         public SourceFileObject(Name name, Name flatname) {
  2841             super(null); // no file manager; never referenced for this file object
  2842             this.name = name;
  2843             this.flatname = flatname;
  2846         @Override
  2847         public URI toUri() {
  2848             try {
  2849                 return new URI(null, name.toString(), null);
  2850             } catch (URISyntaxException e) {
  2851                 throw new CannotCreateUriError(name.toString(), e);
  2855         @Override
  2856         public String getName() {
  2857             return name.toString();
  2860         @Override
  2861         public String getShortName() {
  2862             return getName();
  2865         @Override
  2866         public JavaFileObject.Kind getKind() {
  2867             return getKind(getName());
  2870         @Override
  2871         public InputStream openInputStream() {
  2872             throw new UnsupportedOperationException();
  2875         @Override
  2876         public OutputStream openOutputStream() {
  2877             throw new UnsupportedOperationException();
  2880         @Override
  2881         public CharBuffer getCharContent(boolean ignoreEncodingErrors) {
  2882             throw new UnsupportedOperationException();
  2885         @Override
  2886         public Reader openReader(boolean ignoreEncodingErrors) {
  2887             throw new UnsupportedOperationException();
  2890         @Override
  2891         public Writer openWriter() {
  2892             throw new UnsupportedOperationException();
  2895         @Override
  2896         public long getLastModified() {
  2897             throw new UnsupportedOperationException();
  2900         @Override
  2901         public boolean delete() {
  2902             throw new UnsupportedOperationException();
  2905         @Override
  2906         protected String inferBinaryName(Iterable<? extends File> path) {
  2907             return flatname.toString();
  2910         @Override
  2911         public boolean isNameCompatible(String simpleName, JavaFileObject.Kind kind) {
  2912             return true; // fail-safe mode
  2915         /**
  2916          * Check if two file objects are equal.
  2917          * SourceFileObjects are just placeholder objects for the value of a
  2918          * SourceFile attribute, and do not directly represent specific files.
  2919          * Two SourceFileObjects are equal if their names are equal.
  2920          */
  2921         @Override
  2922         public boolean equals(Object other) {
  2923             if (this == other)
  2924                 return true;
  2926             if (!(other instanceof SourceFileObject))
  2927                 return false;
  2929             SourceFileObject o = (SourceFileObject) other;
  2930             return name.equals(o.name);
  2933         @Override
  2934         public int hashCode() {
  2935             return name.hashCode();

mercurial