src/share/classes/com/sun/tools/javac/code/Symbol.java

Thu, 04 Jul 2013 10:41:08 +0100

author
vromero
date
Thu, 04 Jul 2013 10:41:08 +0100
changeset 1886
79c3146e417b
parent 1853
831467c4c6a7
child 1918
a218f7befd55
permissions
-rw-r--r--

6356530: -Xlint:serial does not flag abstract classes with concrete methods/members
Reviewed-by: mcimadamore

duke@1 1 /*
jfranck@1491 2 * Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
duke@1 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@1 4 *
duke@1 5 * This code is free software; you can redistribute it and/or modify it
duke@1 6 * under the terms of the GNU General Public License version 2 only, as
ohair@554 7 * published by the Free Software Foundation. Oracle designates this
duke@1 8 * particular file as subject to the "Classpath" exception as provided
ohair@554 9 * by Oracle in the LICENSE file that accompanied this code.
duke@1 10 *
duke@1 11 * This code is distributed in the hope that it will be useful, but WITHOUT
duke@1 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@1 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@1 14 * version 2 for more details (a copy is included in the LICENSE file that
duke@1 15 * accompanied this code).
duke@1 16 *
duke@1 17 * You should have received a copy of the GNU General Public License version
duke@1 18 * 2 along with this work; if not, write to the Free Software Foundation,
duke@1 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@1 20 *
ohair@554 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@554 22 * or visit www.oracle.com if you need additional information or have any
ohair@554 23 * questions.
duke@1 24 */
duke@1 25
duke@1 26 package com.sun.tools.javac.code;
duke@1 27
duke@1 28 import java.util.Set;
duke@1 29 import java.util.concurrent.Callable;
jjg@1357 30
duke@1 31 import javax.lang.model.element.*;
duke@1 32 import javax.tools.JavaFileObject;
duke@1 33
duke@1 34 import com.sun.tools.javac.code.Type.*;
jjg@1802 35 import com.sun.tools.javac.comp.Annotate;
duke@1 36 import com.sun.tools.javac.comp.Attr;
duke@1 37 import com.sun.tools.javac.comp.AttrContext;
duke@1 38 import com.sun.tools.javac.comp.Env;
duke@1 39 import com.sun.tools.javac.jvm.*;
duke@1 40 import com.sun.tools.javac.model.*;
duke@1 41 import com.sun.tools.javac.tree.JCTree;
jjg@1357 42 import com.sun.tools.javac.util.*;
jjg@1357 43 import com.sun.tools.javac.util.Name;
duke@1 44 import static com.sun.tools.javac.code.Flags.*;
duke@1 45 import static com.sun.tools.javac.code.Kinds.*;
jjg@1374 46 import static com.sun.tools.javac.code.TypeTag.CLASS;
jjg@1374 47 import static com.sun.tools.javac.code.TypeTag.FORALL;
jjg@1374 48 import static com.sun.tools.javac.code.TypeTag.TYPEVAR;
duke@1 49
duke@1 50 /** Root class for Java symbols. It contains subclasses
duke@1 51 * for specific sorts of symbols, such as variables, methods and operators,
duke@1 52 * types, packages. Each subclass is represented as a static inner class
duke@1 53 * inside Symbol.
duke@1 54 *
jjg@581 55 * <p><b>This is NOT part of any supported API.
jjg@581 56 * If you write code that depends on this, you do so at your own risk.
duke@1 57 * This code and its internal interfaces are subject to change or
duke@1 58 * deletion without notice.</b>
duke@1 59 */
duke@1 60 public abstract class Symbol implements Element {
duke@1 61 // public Throwable debug = new Throwable();
duke@1 62
duke@1 63 /** The kind of this symbol.
duke@1 64 * @see Kinds
duke@1 65 */
duke@1 66 public int kind;
duke@1 67
duke@1 68 /** The flags of this symbol.
duke@1 69 */
duke@1 70 public long flags_field;
duke@1 71
duke@1 72 /** An accessor method for the flags of this symbol.
duke@1 73 * Flags of class symbols should be accessed through the accessor
duke@1 74 * method to make sure that the class symbol is loaded.
duke@1 75 */
duke@1 76 public long flags() { return flags_field; }
duke@1 77
duke@1 78 /** The name of this symbol in Utf8 representation.
duke@1 79 */
duke@1 80 public Name name;
duke@1 81
duke@1 82 /** The type of this symbol.
duke@1 83 */
duke@1 84 public Type type;
duke@1 85
duke@1 86 /** The owner of this symbol.
duke@1 87 */
duke@1 88 public Symbol owner;
duke@1 89
duke@1 90 /** The completer of this symbol.
duke@1 91 */
duke@1 92 public Completer completer;
duke@1 93
duke@1 94 /** A cache for the type erasure of this symbol.
duke@1 95 */
duke@1 96 public Type erasure_field;
duke@1 97
jjg@1802 98 // <editor-fold defaultstate="collapsed" desc="annotations">
jjg@1802 99
jjg@1802 100 /** The attributes of this symbol are contained in this
jjg@1802 101 * Annotations. The Annotations instance is NOT immutable.
jjg@1802 102 */
jjg@1802 103 protected Annotations annotations;
jjg@1802 104
jjg@1802 105 /** An accessor method for the attributes of this symbol.
jjg@1802 106 * Attributes of class symbols should be accessed through the accessor
jjg@1802 107 * method to make sure that the class symbol is loaded.
jjg@1802 108 */
jjg@1802 109 public List<Attribute.Compound> getRawAttributes() {
jjg@1802 110 return (annotations == null)
jjg@1802 111 ? List.<Attribute.Compound>nil()
jjg@1802 112 : annotations.getDeclarationAttributes();
jjg@1802 113 }
jjg@1802 114
jjg@1802 115 /** An accessor method for the type attributes of this symbol.
jjg@1802 116 * Attributes of class symbols should be accessed through the accessor
jjg@1802 117 * method to make sure that the class symbol is loaded.
jjg@1802 118 */
jjg@1802 119 public List<Attribute.TypeCompound> getRawTypeAttributes() {
jjg@1802 120 return (annotations == null)
jjg@1802 121 ? List.<Attribute.TypeCompound>nil()
jjg@1802 122 : annotations.getTypeAttributes();
jjg@1802 123 }
jjg@1802 124
jjg@1802 125 /** Fetch a particular annotation from a symbol. */
jjg@1802 126 public Attribute.Compound attribute(Symbol anno) {
jjg@1802 127 for (Attribute.Compound a : getRawAttributes()) {
jjg@1802 128 if (a.type.tsym == anno) return a;
jjg@1802 129 }
jjg@1802 130 return null;
jjg@1802 131 }
jjg@1802 132
jjg@1802 133 public boolean annotationsPendingCompletion() {
jjg@1802 134 return annotations == null ? false : annotations.pendingCompletion();
jjg@1802 135 }
jjg@1802 136
jjg@1802 137 public void appendAttributes(List<Attribute.Compound> l) {
jjg@1802 138 if (l.nonEmpty()) {
jjg@1802 139 initedAnnos().append(l);
jjg@1802 140 }
jjg@1802 141 }
jjg@1802 142
jjg@1802 143 public void appendClassInitTypeAttributes(List<Attribute.TypeCompound> l) {
jjg@1802 144 if (l.nonEmpty()) {
jjg@1802 145 initedAnnos().appendClassInitTypeAttributes(l);
jjg@1802 146 }
jjg@1802 147 }
jjg@1802 148
jjg@1802 149 public void appendInitTypeAttributes(List<Attribute.TypeCompound> l) {
jjg@1802 150 if (l.nonEmpty()) {
jjg@1802 151 initedAnnos().appendInitTypeAttributes(l);
jjg@1802 152 }
jjg@1802 153 }
jjg@1802 154
jjg@1802 155 public void appendTypeAttributesWithCompletion(final Annotate.AnnotateRepeatedContext<Attribute.TypeCompound> ctx) {
jjg@1802 156 initedAnnos().appendTypeAttributesWithCompletion(ctx);
jjg@1802 157 }
jjg@1802 158
jjg@1802 159 public void appendUniqueTypeAttributes(List<Attribute.TypeCompound> l) {
jjg@1802 160 if (l.nonEmpty()) {
jjg@1802 161 initedAnnos().appendUniqueTypes(l);
jjg@1802 162 }
jjg@1802 163 }
jjg@1802 164
jjg@1802 165 public List<Attribute.TypeCompound> getClassInitTypeAttributes() {
jjg@1802 166 return (annotations == null)
jjg@1802 167 ? List.<Attribute.TypeCompound>nil()
jjg@1802 168 : annotations.getClassInitTypeAttributes();
jjg@1802 169 }
jjg@1802 170
jjg@1802 171 public List<Attribute.TypeCompound> getInitTypeAttributes() {
jjg@1802 172 return (annotations == null)
jjg@1802 173 ? List.<Attribute.TypeCompound>nil()
jjg@1802 174 : annotations.getInitTypeAttributes();
jjg@1802 175 }
jjg@1802 176
jjg@1802 177 public List<Attribute.Compound> getDeclarationAttributes() {
jjg@1802 178 return (annotations == null)
jjg@1802 179 ? List.<Attribute.Compound>nil()
jjg@1802 180 : annotations.getDeclarationAttributes();
jjg@1802 181 }
jjg@1802 182
jjg@1802 183 public boolean hasAnnotations() {
jjg@1802 184 return (annotations != null && !annotations.isEmpty());
jjg@1802 185 }
jjg@1802 186
jjg@1802 187 public boolean hasTypeAnnotations() {
jjg@1802 188 return (annotations != null && !annotations.isTypesEmpty());
jjg@1802 189 }
jjg@1802 190
jjg@1802 191 public void prependAttributes(List<Attribute.Compound> l) {
jjg@1802 192 if (l.nonEmpty()) {
jjg@1802 193 initedAnnos().prepend(l);
jjg@1802 194 }
jjg@1802 195 }
jjg@1802 196
jjg@1802 197 public void resetAnnotations() {
jjg@1802 198 initedAnnos().reset();
jjg@1802 199 }
jjg@1802 200
jjg@1802 201 public void setAttributes(Symbol other) {
jjg@1802 202 if (annotations != null || other.annotations != null) {
jjg@1802 203 initedAnnos().setAttributes(other.annotations);
jjg@1802 204 }
jjg@1802 205 }
jjg@1802 206
jjg@1802 207 public void setDeclarationAttributes(List<Attribute.Compound> a) {
jjg@1802 208 if (annotations != null || a.nonEmpty()) {
jjg@1802 209 initedAnnos().setDeclarationAttributes(a);
jjg@1802 210 }
jjg@1802 211 }
jjg@1802 212
jjg@1802 213 public void setDeclarationAttributesWithCompletion(final Annotate.AnnotateRepeatedContext<Attribute.Compound> ctx) {
jjg@1802 214 initedAnnos().setDeclarationAttributesWithCompletion(ctx);
jjg@1802 215 }
jjg@1802 216
jjg@1802 217 public void setTypeAttributes(List<Attribute.TypeCompound> a) {
jjg@1802 218 if (annotations != null || a.nonEmpty()) {
jjg@1802 219 if (annotations == null)
jjg@1802 220 annotations = new Annotations(this);
jjg@1802 221 annotations.setTypeAttributes(a);
jjg@1802 222 }
jjg@1802 223 }
jjg@1802 224
jjg@1802 225 private Annotations initedAnnos() {
jjg@1802 226 if (annotations == null)
jjg@1802 227 annotations = new Annotations(this);
jjg@1802 228 return annotations;
jjg@1802 229 }
jjg@1802 230
jjg@1802 231 /** This method is intended for debugging only. */
jjg@1802 232 public Annotations getAnnotations() {
jjg@1802 233 return annotations;
jjg@1802 234 }
jjg@1802 235
jjg@1802 236 // </editor-fold>
jjg@1802 237
duke@1 238 /** Construct a symbol with given kind, flags, name, type and owner.
duke@1 239 */
duke@1 240 public Symbol(int kind, long flags, Name name, Type type, Symbol owner) {
duke@1 241 this.kind = kind;
duke@1 242 this.flags_field = flags;
duke@1 243 this.type = type;
duke@1 244 this.owner = owner;
duke@1 245 this.completer = null;
duke@1 246 this.erasure_field = null;
duke@1 247 this.name = name;
duke@1 248 }
duke@1 249
duke@1 250 /** Clone this symbol with new owner.
duke@1 251 * Legal only for fields and methods.
duke@1 252 */
duke@1 253 public Symbol clone(Symbol newOwner) {
duke@1 254 throw new AssertionError();
duke@1 255 }
duke@1 256
mcimadamore@121 257 public <R, P> R accept(Symbol.Visitor<R, P> v, P p) {
mcimadamore@121 258 return v.visitSymbol(this, p);
mcimadamore@121 259 }
mcimadamore@121 260
duke@1 261 /** The Java source which this symbol represents.
duke@1 262 * A description of this symbol; overrides Object.
duke@1 263 */
duke@1 264 public String toString() {
duke@1 265 return name.toString();
duke@1 266 }
duke@1 267
duke@1 268 /** A Java source description of the location of this symbol; used for
mcimadamore@80 269 * error reporting.
mcimadamore@80 270 *
mcimadamore@80 271 * @return null if the symbol is a package or a toplevel class defined in
mcimadamore@80 272 * the default package; otherwise, the owner symbol is returned
duke@1 273 */
mcimadamore@80 274 public Symbol location() {
mcimadamore@1085 275 if (owner.name == null || (owner.name.isEmpty() &&
mcimadamore@1085 276 (owner.flags() & BLOCK) == 0 && owner.kind != PCK && owner.kind != TYP)) {
mcimadamore@80 277 return null;
duke@1 278 }
mcimadamore@80 279 return owner;
duke@1 280 }
duke@1 281
mcimadamore@80 282 public Symbol location(Type site, Types types) {
jjg@113 283 if (owner.name == null || owner.name.isEmpty()) {
duke@1 284 return location();
duke@1 285 }
jjg@1374 286 if (owner.type.hasTag(CLASS)) {
duke@1 287 Type ownertype = types.asOuterSuper(site, owner);
mcimadamore@80 288 if (ownertype != null) return ownertype.tsym;
duke@1 289 }
mcimadamore@80 290 return owner;
duke@1 291 }
duke@1 292
mcimadamore@1341 293 public Symbol baseSymbol() {
mcimadamore@1341 294 return this;
mcimadamore@1341 295 }
mcimadamore@1341 296
duke@1 297 /** The symbol's erased type.
duke@1 298 */
duke@1 299 public Type erasure(Types types) {
duke@1 300 if (erasure_field == null)
duke@1 301 erasure_field = types.erasure(type);
duke@1 302 return erasure_field;
duke@1 303 }
duke@1 304
duke@1 305 /** The external type of a symbol. This is the symbol's erased type
duke@1 306 * except for constructors of inner classes which get the enclosing
duke@1 307 * instance class added as first argument.
duke@1 308 */
duke@1 309 public Type externalType(Types types) {
duke@1 310 Type t = erasure(types);
jjg@113 311 if (name == name.table.names.init && owner.hasOuterInstance()) {
duke@1 312 Type outerThisType = types.erasure(owner.type.getEnclosingType());
duke@1 313 return new MethodType(t.getParameterTypes().prepend(outerThisType),
duke@1 314 t.getReturnType(),
duke@1 315 t.getThrownTypes(),
duke@1 316 t.tsym);
duke@1 317 } else {
duke@1 318 return t;
duke@1 319 }
duke@1 320 }
duke@1 321
jjg@1802 322 public boolean isDeprecated() {
jjg@1802 323 return (flags_field & DEPRECATED) != 0;
jjg@1802 324 }
jjg@1802 325
duke@1 326 public boolean isStatic() {
duke@1 327 return
duke@1 328 (flags() & STATIC) != 0 ||
duke@1 329 (owner.flags() & INTERFACE) != 0 && kind != MTH;
duke@1 330 }
duke@1 331
duke@1 332 public boolean isInterface() {
duke@1 333 return (flags() & INTERFACE) != 0;
duke@1 334 }
duke@1 335
mcimadamore@1565 336 public boolean isPrivate() {
mcimadamore@1565 337 return (flags_field & Flags.AccessFlags) == PRIVATE;
mcimadamore@1565 338 }
mcimadamore@1565 339
mcimadamore@1565 340 public boolean isEnum() {
mcimadamore@1565 341 return (flags() & ENUM) != 0;
mcimadamore@1565 342 }
mcimadamore@1565 343
duke@1 344 /** Is this symbol declared (directly or indirectly) local
duke@1 345 * to a method or variable initializer?
duke@1 346 * Also includes fields of inner classes which are in
duke@1 347 * turn local to a method or variable initializer.
duke@1 348 */
duke@1 349 public boolean isLocal() {
duke@1 350 return
duke@1 351 (owner.kind & (VAR | MTH)) != 0 ||
duke@1 352 (owner.kind == TYP && owner.isLocal());
duke@1 353 }
duke@1 354
mcimadamore@537 355 /** Has this symbol an empty name? This includes anonymous
vromero@1620 356 * inner classes.
mcimadamore@537 357 */
mcimadamore@537 358 public boolean isAnonymous() {
mcimadamore@537 359 return name.isEmpty();
mcimadamore@537 360 }
mcimadamore@537 361
duke@1 362 /** Is this symbol a constructor?
duke@1 363 */
duke@1 364 public boolean isConstructor() {
jjg@113 365 return name == name.table.names.init;
duke@1 366 }
duke@1 367
duke@1 368 /** The fully qualified name of this symbol.
duke@1 369 * This is the same as the symbol's name except for class symbols,
duke@1 370 * which are handled separately.
duke@1 371 */
duke@1 372 public Name getQualifiedName() {
duke@1 373 return name;
duke@1 374 }
duke@1 375
duke@1 376 /** The fully qualified name of this symbol after converting to flat
duke@1 377 * representation. This is the same as the symbol's name except for
duke@1 378 * class symbols, which are handled separately.
duke@1 379 */
duke@1 380 public Name flatName() {
duke@1 381 return getQualifiedName();
duke@1 382 }
duke@1 383
duke@1 384 /** If this is a class or package, its members, otherwise null.
duke@1 385 */
duke@1 386 public Scope members() {
duke@1 387 return null;
duke@1 388 }
duke@1 389
duke@1 390 /** A class is an inner class if it it has an enclosing instance class.
duke@1 391 */
duke@1 392 public boolean isInner() {
jjg@1374 393 return type.getEnclosingType().hasTag(CLASS);
duke@1 394 }
duke@1 395
duke@1 396 /** An inner class has an outer instance if it is not an interface
duke@1 397 * it has an enclosing instance class which might be referenced from the class.
duke@1 398 * Nested classes can see instance members of their enclosing class.
duke@1 399 * Their constructors carry an additional this$n parameter, inserted
duke@1 400 * implicitly by the compiler.
duke@1 401 *
duke@1 402 * @see #isInner
duke@1 403 */
duke@1 404 public boolean hasOuterInstance() {
duke@1 405 return
jjg@1374 406 type.getEnclosingType().hasTag(CLASS) && (flags() & (INTERFACE | NOOUTERTHIS)) == 0;
duke@1 407 }
duke@1 408
duke@1 409 /** The closest enclosing class of this symbol's declaration.
duke@1 410 */
duke@1 411 public ClassSymbol enclClass() {
duke@1 412 Symbol c = this;
duke@1 413 while (c != null &&
jjg@1374 414 ((c.kind & TYP) == 0 || !c.type.hasTag(CLASS))) {
duke@1 415 c = c.owner;
duke@1 416 }
duke@1 417 return (ClassSymbol)c;
duke@1 418 }
duke@1 419
duke@1 420 /** The outermost class which indirectly owns this symbol.
duke@1 421 */
duke@1 422 public ClassSymbol outermostClass() {
duke@1 423 Symbol sym = this;
duke@1 424 Symbol prev = null;
duke@1 425 while (sym.kind != PCK) {
duke@1 426 prev = sym;
duke@1 427 sym = sym.owner;
duke@1 428 }
duke@1 429 return (ClassSymbol) prev;
duke@1 430 }
duke@1 431
duke@1 432 /** The package which indirectly owns this symbol.
duke@1 433 */
duke@1 434 public PackageSymbol packge() {
duke@1 435 Symbol sym = this;
duke@1 436 while (sym.kind != PCK) {
duke@1 437 sym = sym.owner;
duke@1 438 }
duke@1 439 return (PackageSymbol) sym;
duke@1 440 }
duke@1 441
duke@1 442 /** Is this symbol a subclass of `base'? Only defined for ClassSymbols.
duke@1 443 */
duke@1 444 public boolean isSubClass(Symbol base, Types types) {
duke@1 445 throw new AssertionError("isSubClass " + this);
duke@1 446 }
duke@1 447
duke@1 448 /** Fully check membership: hierarchy, protection, and hiding.
duke@1 449 * Does not exclude methods not inherited due to overriding.
duke@1 450 */
duke@1 451 public boolean isMemberOf(TypeSymbol clazz, Types types) {
duke@1 452 return
duke@1 453 owner == clazz ||
duke@1 454 clazz.isSubClass(owner, types) &&
duke@1 455 isInheritedIn(clazz, types) &&
duke@1 456 !hiddenIn((ClassSymbol)clazz, types);
duke@1 457 }
duke@1 458
duke@1 459 /** Is this symbol the same as or enclosed by the given class? */
duke@1 460 public boolean isEnclosedBy(ClassSymbol clazz) {
duke@1 461 for (Symbol sym = this; sym.kind != PCK; sym = sym.owner)
duke@1 462 if (sym == clazz) return true;
duke@1 463 return false;
duke@1 464 }
duke@1 465
duke@1 466 /** Check for hiding. Note that this doesn't handle multiple
duke@1 467 * (interface) inheritance. */
duke@1 468 private boolean hiddenIn(ClassSymbol clazz, Types types) {
duke@1 469 if (kind == MTH && (flags() & STATIC) == 0) return false;
duke@1 470 while (true) {
duke@1 471 if (owner == clazz) return false;
duke@1 472 Scope.Entry e = clazz.members().lookup(name);
duke@1 473 while (e.scope != null) {
duke@1 474 if (e.sym == this) return false;
duke@1 475 if (e.sym.kind == kind &&
duke@1 476 (kind != MTH ||
duke@1 477 (e.sym.flags() & STATIC) != 0 &&
duke@1 478 types.isSubSignature(e.sym.type, type)))
duke@1 479 return true;
duke@1 480 e = e.next();
duke@1 481 }
duke@1 482 Type superType = types.supertype(clazz.type);
jjg@1374 483 if (!superType.hasTag(CLASS)) return false;
duke@1 484 clazz = (ClassSymbol)superType.tsym;
duke@1 485 }
duke@1 486 }
duke@1 487
duke@1 488 /** Is this symbol inherited into a given class?
duke@1 489 * PRE: If symbol's owner is a interface,
duke@1 490 * it is already assumed that the interface is a superinterface
duke@1 491 * of given class.
duke@1 492 * @param clazz The class for which we want to establish membership.
duke@1 493 * This must be a subclass of the member's owner.
duke@1 494 */
duke@1 495 public boolean isInheritedIn(Symbol clazz, Types types) {
duke@1 496 switch ((int)(flags_field & Flags.AccessFlags)) {
duke@1 497 default: // error recovery
duke@1 498 case PUBLIC:
duke@1 499 return true;
duke@1 500 case PRIVATE:
duke@1 501 return this.owner == clazz;
duke@1 502 case PROTECTED:
duke@1 503 // we model interfaces as extending Object
duke@1 504 return (clazz.flags() & INTERFACE) == 0;
duke@1 505 case 0:
duke@1 506 PackageSymbol thisPackage = this.packge();
duke@1 507 for (Symbol sup = clazz;
duke@1 508 sup != null && sup != this.owner;
duke@1 509 sup = types.supertype(sup.type).tsym) {
jjg@1374 510 while (sup.type.hasTag(TYPEVAR))
mcimadamore@155 511 sup = sup.type.getUpperBound().tsym;
duke@1 512 if (sup.type.isErroneous())
duke@1 513 return true; // error recovery
duke@1 514 if ((sup.flags() & COMPOUND) != 0)
duke@1 515 continue;
duke@1 516 if (sup.packge() != thisPackage)
duke@1 517 return false;
duke@1 518 }
duke@1 519 return (clazz.flags() & INTERFACE) == 0;
duke@1 520 }
duke@1 521 }
duke@1 522
duke@1 523 /** The (variable or method) symbol seen as a member of given
duke@1 524 * class type`site' (this might change the symbol's type).
duke@1 525 * This is used exclusively for producing diagnostics.
duke@1 526 */
duke@1 527 public Symbol asMemberOf(Type site, Types types) {
duke@1 528 throw new AssertionError();
duke@1 529 }
duke@1 530
duke@1 531 /** Does this method symbol override `other' symbol, when both are seen as
duke@1 532 * members of class `origin'? It is assumed that _other is a member
duke@1 533 * of origin.
duke@1 534 *
duke@1 535 * It is assumed that both symbols have the same name. The static
duke@1 536 * modifier is ignored for this test.
duke@1 537 *
duke@1 538 * See JLS 8.4.6.1 (without transitivity) and 8.4.6.4
duke@1 539 */
duke@1 540 public boolean overrides(Symbol _other, TypeSymbol origin, Types types, boolean checkResult) {
duke@1 541 return false;
duke@1 542 }
duke@1 543
duke@1 544 /** Complete the elaboration of this symbol's definition.
duke@1 545 */
duke@1 546 public void complete() throws CompletionFailure {
duke@1 547 if (completer != null) {
duke@1 548 Completer c = completer;
duke@1 549 completer = null;
duke@1 550 c.complete(this);
duke@1 551 }
duke@1 552 }
duke@1 553
duke@1 554 /** True if the symbol represents an entity that exists.
duke@1 555 */
duke@1 556 public boolean exists() {
duke@1 557 return true;
duke@1 558 }
duke@1 559
duke@1 560 public Type asType() {
duke@1 561 return type;
duke@1 562 }
duke@1 563
duke@1 564 public Symbol getEnclosingElement() {
duke@1 565 return owner;
duke@1 566 }
duke@1 567
duke@1 568 public ElementKind getKind() {
duke@1 569 return ElementKind.OTHER; // most unkind
duke@1 570 }
duke@1 571
duke@1 572 public Set<Modifier> getModifiers() {
mcimadamore@1692 573 return Flags.asModifierSet(flags());
duke@1 574 }
duke@1 575
duke@1 576 public Name getSimpleName() {
duke@1 577 return name;
duke@1 578 }
duke@1 579
duke@1 580 /**
jfranck@1464 581 * This is the implementation for {@code
jfranck@1464 582 * javax.lang.model.element.Element.getAnnotationMirrors()}.
jfranck@1464 583 */
jfranck@1709 584 @Override
jfranck@1709 585 public List<Attribute.Compound> getAnnotationMirrors() {
jfranck@1464 586 return getRawAttributes();
jfranck@1464 587 }
jfranck@1464 588
jfranck@1464 589 /**
duke@1 590 * @deprecated this method should never be used by javac internally.
duke@1 591 */
duke@1 592 @Deprecated
duke@1 593 public <A extends java.lang.annotation.Annotation> A getAnnotation(Class<A> annoType) {
jjg@1645 594 return JavacAnnoConstructs.getAnnotation(this, annoType);
duke@1 595 }
duke@1 596
jfranck@1491 597 // This method is part of the javax.lang.model API, do not use this in javac code.
jfranck@1564 598 public <A extends java.lang.annotation.Annotation> A[] getAnnotationsByType(Class<A> annoType) {
jjg@1645 599 return JavacAnnoConstructs.getAnnotations(this, annoType);
jfranck@1491 600 }
jfranck@1491 601
duke@1 602 // TODO: getEnclosedElements should return a javac List, fix in FilteredMemberList
duke@1 603 public java.util.List<Symbol> getEnclosedElements() {
duke@1 604 return List.nil();
duke@1 605 }
duke@1 606
jfranck@1689 607 public List<TypeVariableSymbol> getTypeParameters() {
jfranck@1689 608 ListBuffer<TypeVariableSymbol> l = ListBuffer.lb();
duke@1 609 for (Type t : type.getTypeArguments()) {
jfranck@1689 610 Assert.check(t.tsym.getKind() == ElementKind.TYPE_PARAMETER);
jfranck@1689 611 l.append((TypeVariableSymbol)t.tsym);
duke@1 612 }
duke@1 613 return l.toList();
duke@1 614 }
duke@1 615
vromero@1541 616 public static class DelegatedSymbol<T extends Symbol> extends Symbol {
vromero@1541 617 protected T other;
vromero@1541 618 public DelegatedSymbol(T other) {
duke@1 619 super(other.kind, other.flags_field, other.name, other.type, other.owner);
duke@1 620 this.other = other;
duke@1 621 }
duke@1 622 public String toString() { return other.toString(); }
mcimadamore@80 623 public Symbol location() { return other.location(); }
mcimadamore@80 624 public Symbol location(Type site, Types types) { return other.location(site, types); }
mcimadamore@1415 625 public Symbol baseSymbol() { return other; }
duke@1 626 public Type erasure(Types types) { return other.erasure(types); }
duke@1 627 public Type externalType(Types types) { return other.externalType(types); }
duke@1 628 public boolean isLocal() { return other.isLocal(); }
duke@1 629 public boolean isConstructor() { return other.isConstructor(); }
duke@1 630 public Name getQualifiedName() { return other.getQualifiedName(); }
duke@1 631 public Name flatName() { return other.flatName(); }
duke@1 632 public Scope members() { return other.members(); }
duke@1 633 public boolean isInner() { return other.isInner(); }
duke@1 634 public boolean hasOuterInstance() { return other.hasOuterInstance(); }
duke@1 635 public ClassSymbol enclClass() { return other.enclClass(); }
duke@1 636 public ClassSymbol outermostClass() { return other.outermostClass(); }
duke@1 637 public PackageSymbol packge() { return other.packge(); }
duke@1 638 public boolean isSubClass(Symbol base, Types types) { return other.isSubClass(base, types); }
duke@1 639 public boolean isMemberOf(TypeSymbol clazz, Types types) { return other.isMemberOf(clazz, types); }
duke@1 640 public boolean isEnclosedBy(ClassSymbol clazz) { return other.isEnclosedBy(clazz); }
duke@1 641 public boolean isInheritedIn(Symbol clazz, Types types) { return other.isInheritedIn(clazz, types); }
duke@1 642 public Symbol asMemberOf(Type site, Types types) { return other.asMemberOf(site, types); }
duke@1 643 public void complete() throws CompletionFailure { other.complete(); }
duke@1 644
duke@1 645 public <R, P> R accept(ElementVisitor<R, P> v, P p) {
duke@1 646 return other.accept(v, p);
duke@1 647 }
mcimadamore@121 648
mcimadamore@121 649 public <R, P> R accept(Symbol.Visitor<R, P> v, P p) {
mcimadamore@121 650 return v.visitSymbol(other, p);
mcimadamore@121 651 }
vromero@1541 652
vromero@1541 653 public T getUnderlyingSymbol() {
vromero@1541 654 return other;
vromero@1541 655 }
duke@1 656 }
duke@1 657
jfranck@1689 658 /** A base class for Symbols representing types.
duke@1 659 */
jfranck@1689 660 public static abstract class TypeSymbol extends Symbol {
jfranck@1689 661 public TypeSymbol(int kind, long flags, Name name, Type type, Symbol owner) {
jfranck@1689 662 super(kind, flags, name, type, owner);
duke@1 663 }
duke@1 664 /** form a fully qualified name from a name and an owner
duke@1 665 */
duke@1 666 static public Name formFullName(Name name, Symbol owner) {
duke@1 667 if (owner == null) return name;
duke@1 668 if (((owner.kind != ERR)) &&
duke@1 669 ((owner.kind & (VAR | MTH)) != 0
jjg@1374 670 || (owner.kind == TYP && owner.type.hasTag(TYPEVAR))
duke@1 671 )) return name;
duke@1 672 Name prefix = owner.getQualifiedName();
jjg@113 673 if (prefix == null || prefix == prefix.table.names.empty)
duke@1 674 return name;
duke@1 675 else return prefix.append('.', name);
duke@1 676 }
duke@1 677
duke@1 678 /** form a fully qualified name from a name and an owner, after
duke@1 679 * converting to flat representation
duke@1 680 */
duke@1 681 static public Name formFlatName(Name name, Symbol owner) {
duke@1 682 if (owner == null ||
duke@1 683 (owner.kind & (VAR | MTH)) != 0
jjg@1374 684 || (owner.kind == TYP && owner.type.hasTag(TYPEVAR))
duke@1 685 ) return name;
duke@1 686 char sep = owner.kind == TYP ? '$' : '.';
duke@1 687 Name prefix = owner.flatName();
jjg@113 688 if (prefix == null || prefix == prefix.table.names.empty)
duke@1 689 return name;
duke@1 690 else return prefix.append(sep, name);
duke@1 691 }
duke@1 692
duke@1 693 /**
duke@1 694 * A total ordering between type symbols that refines the
duke@1 695 * class inheritance graph.
duke@1 696 *
duke@1 697 * Typevariables always precede other kinds of symbols.
duke@1 698 */
duke@1 699 public final boolean precedes(TypeSymbol that, Types types) {
duke@1 700 if (this == that)
duke@1 701 return false;
vromero@1853 702 if (type.hasTag(that.type.getTag())) {
vromero@1853 703 if (type.hasTag(CLASS)) {
duke@1 704 return
duke@1 705 types.rank(that.type) < types.rank(this.type) ||
duke@1 706 types.rank(that.type) == types.rank(this.type) &&
duke@1 707 that.getQualifiedName().compareTo(this.getQualifiedName()) < 0;
vromero@1853 708 } else if (type.hasTag(TYPEVAR)) {
duke@1 709 return types.isSubtype(this.type, that.type);
duke@1 710 }
duke@1 711 }
vromero@1853 712 return type.hasTag(TYPEVAR);
duke@1 713 }
duke@1 714
jfranck@1689 715 @Override
duke@1 716 public java.util.List<Symbol> getEnclosedElements() {
duke@1 717 List<Symbol> list = List.nil();
jjg@1374 718 if (kind == TYP && type.hasTag(TYPEVAR)) {
sundar@666 719 return list;
sundar@666 720 }
duke@1 721 for (Scope.Entry e = members().elems; e != null; e = e.sibling) {
duke@1 722 if (e.sym != null && (e.sym.flags() & SYNTHETIC) == 0 && e.sym.owner == this)
duke@1 723 list = list.prepend(e.sym);
duke@1 724 }
duke@1 725 return list;
duke@1 726 }
duke@1 727
jfranck@1689 728 @Override
jfranck@1689 729 public <R, P> R accept(Symbol.Visitor<R, P> v, P p) {
jfranck@1689 730 return v.visitTypeSymbol(this, p);
jfranck@1689 731 }
jfranck@1689 732 }
jfranck@1689 733
jfranck@1689 734 /**
jfranck@1689 735 * Type variables are represented by instances of this class.
jfranck@1689 736 */
jfranck@1689 737 public static class TypeVariableSymbol
jfranck@1689 738 extends TypeSymbol implements TypeParameterElement {
jfranck@1689 739
jfranck@1689 740 public TypeVariableSymbol(long flags, Name name, Type type, Symbol owner) {
jfranck@1689 741 super(TYP, flags, name, type, owner);
jfranck@1689 742 }
jfranck@1689 743
jfranck@1689 744 public ElementKind getKind() {
jfranck@1689 745 return ElementKind.TYPE_PARAMETER;
jfranck@1689 746 }
jfranck@1689 747
jfranck@1689 748 @Override
duke@1 749 public Symbol getGenericElement() {
duke@1 750 return owner;
duke@1 751 }
duke@1 752
duke@1 753 public List<Type> getBounds() {
duke@1 754 TypeVar t = (TypeVar)type;
duke@1 755 Type bound = t.getUpperBound();
duke@1 756 if (!bound.isCompound())
duke@1 757 return List.of(bound);
duke@1 758 ClassType ct = (ClassType)bound;
duke@1 759 if (!ct.tsym.erasure_field.isInterface()) {
duke@1 760 return ct.interfaces_field.prepend(ct.supertype_field);
duke@1 761 } else {
duke@1 762 // No superclass was given in bounds.
duke@1 763 // In this case, supertype is Object, erasure is first interface.
duke@1 764 return ct.interfaces_field;
duke@1 765 }
duke@1 766 }
jfranck@1689 767
jfranck@1689 768 @Override
jfranck@1709 769 public List<Attribute.Compound> getAnnotationMirrors() {
jfranck@1709 770 return onlyTypeVariableAnnotations(owner.getRawTypeAttributes());
jfranck@1709 771 }
jfranck@1709 772
jfranck@1709 773 private List<Attribute.Compound> onlyTypeVariableAnnotations(
jfranck@1709 774 List<Attribute.TypeCompound> candidates) {
jfranck@1709 775 // Declaration annotations on TypeParameters are stored in type attributes
jfranck@1709 776 List<Attribute.Compound> res = List.nil();
jfranck@1709 777 for (Attribute.TypeCompound a : candidates) {
jfranck@1709 778 if (a.position.type == TargetType.CLASS_TYPE_PARAMETER ||
jfranck@1709 779 a.position.type == TargetType.METHOD_TYPE_PARAMETER)
jfranck@1709 780 res = res.prepend(a);
jfranck@1709 781 }
jfranck@1709 782
jfranck@1709 783 return res = res.reverse();
jfranck@1709 784 }
jfranck@1709 785
jfranck@1709 786 @Override
jfranck@1689 787 public <R, P> R accept(ElementVisitor<R, P> v, P p) {
jfranck@1689 788 return v.visitTypeParameter(this, p);
jfranck@1689 789 }
duke@1 790 }
duke@1 791
duke@1 792 /** A class for package symbols
duke@1 793 */
duke@1 794 public static class PackageSymbol extends TypeSymbol
duke@1 795 implements PackageElement {
duke@1 796
duke@1 797 public Scope members_field;
duke@1 798 public Name fullname;
duke@1 799 public ClassSymbol package_info; // see bug 6443073
duke@1 800
duke@1 801 public PackageSymbol(Name name, Type type, Symbol owner) {
jfranck@1689 802 super(PCK, 0, name, type, owner);
duke@1 803 this.members_field = null;
duke@1 804 this.fullname = formFullName(name, owner);
duke@1 805 }
duke@1 806
duke@1 807 public PackageSymbol(Name name, Symbol owner) {
duke@1 808 this(name, null, owner);
duke@1 809 this.type = new PackageType(this);
duke@1 810 }
duke@1 811
duke@1 812 public String toString() {
duke@1 813 return fullname.toString();
duke@1 814 }
duke@1 815
duke@1 816 public Name getQualifiedName() {
duke@1 817 return fullname;
duke@1 818 }
duke@1 819
duke@1 820 public boolean isUnnamed() {
duke@1 821 return name.isEmpty() && owner != null;
duke@1 822 }
duke@1 823
duke@1 824 public Scope members() {
duke@1 825 if (completer != null) complete();
duke@1 826 return members_field;
duke@1 827 }
duke@1 828
duke@1 829 public long flags() {
duke@1 830 if (completer != null) complete();
duke@1 831 return flags_field;
duke@1 832 }
duke@1 833
jfranck@1464 834 @Override
jfranck@1464 835 public List<Attribute.Compound> getRawAttributes() {
duke@1 836 if (completer != null) complete();
jjg@483 837 if (package_info != null && package_info.completer != null) {
jjg@483 838 package_info.complete();
jfranck@1464 839 mergeAttributes();
jjg@483 840 }
jfranck@1464 841 return super.getRawAttributes();
jfranck@1464 842 }
jfranck@1464 843
jfranck@1464 844 private void mergeAttributes() {
jjg@1802 845 if (annotations == null &&
jjg@1802 846 package_info.annotations != null) {
jjg@1802 847 annotations = new Annotations(this);
jfranck@1464 848 annotations.setAttributes(package_info.annotations);
jfranck@1313 849 }
duke@1 850 }
duke@1 851
duke@1 852 /** A package "exists" if a type or package that exists has
duke@1 853 * been seen within it.
duke@1 854 */
duke@1 855 public boolean exists() {
duke@1 856 return (flags_field & EXISTS) != 0;
duke@1 857 }
duke@1 858
duke@1 859 public ElementKind getKind() {
duke@1 860 return ElementKind.PACKAGE;
duke@1 861 }
duke@1 862
duke@1 863 public Symbol getEnclosingElement() {
duke@1 864 return null;
duke@1 865 }
duke@1 866
duke@1 867 public <R, P> R accept(ElementVisitor<R, P> v, P p) {
duke@1 868 return v.visitPackage(this, p);
duke@1 869 }
mcimadamore@121 870
mcimadamore@121 871 public <R, P> R accept(Symbol.Visitor<R, P> v, P p) {
mcimadamore@121 872 return v.visitPackageSymbol(this, p);
mcimadamore@121 873 }
duke@1 874 }
duke@1 875
duke@1 876 /** A class for class symbols
duke@1 877 */
duke@1 878 public static class ClassSymbol extends TypeSymbol implements TypeElement {
duke@1 879
duke@1 880 /** a scope for all class members; variables, methods and inner classes
duke@1 881 * type parameters are not part of this scope
duke@1 882 */
duke@1 883 public Scope members_field;
duke@1 884
duke@1 885 /** the fully qualified name of the class, i.e. pck.outer.inner.
duke@1 886 * null for anonymous classes
duke@1 887 */
duke@1 888 public Name fullname;
duke@1 889
duke@1 890 /** the fully qualified name of the class after converting to flat
duke@1 891 * representation, i.e. pck.outer$inner,
duke@1 892 * set externally for local and anonymous classes
duke@1 893 */
duke@1 894 public Name flatname;
duke@1 895
duke@1 896 /** the sourcefile where the class came from
duke@1 897 */
duke@1 898 public JavaFileObject sourcefile;
duke@1 899
duke@1 900 /** the classfile from where to load this class
duke@1 901 * this will have extension .class or .java
duke@1 902 */
duke@1 903 public JavaFileObject classfile;
duke@1 904
mcimadamore@1086 905 /** the list of translated local classes (used for generating
mcimadamore@1086 906 * InnerClasses attribute)
mcimadamore@1086 907 */
mcimadamore@1086 908 public List<ClassSymbol> trans_local;
mcimadamore@1086 909
duke@1 910 /** the constant pool of the class
duke@1 911 */
duke@1 912 public Pool pool;
duke@1 913
duke@1 914 public ClassSymbol(long flags, Name name, Type type, Symbol owner) {
jfranck@1689 915 super(TYP, flags, name, type, owner);
duke@1 916 this.members_field = null;
duke@1 917 this.fullname = formFullName(name, owner);
duke@1 918 this.flatname = formFlatName(name, owner);
duke@1 919 this.sourcefile = null;
duke@1 920 this.classfile = null;
duke@1 921 this.pool = null;
duke@1 922 }
duke@1 923
duke@1 924 public ClassSymbol(long flags, Name name, Symbol owner) {
duke@1 925 this(
duke@1 926 flags,
duke@1 927 name,
duke@1 928 new ClassType(Type.noType, null, null),
duke@1 929 owner);
duke@1 930 this.type.tsym = this;
duke@1 931 }
duke@1 932
duke@1 933 /** The Java source which this symbol represents.
duke@1 934 */
duke@1 935 public String toString() {
duke@1 936 return className();
duke@1 937 }
duke@1 938
duke@1 939 public long flags() {
duke@1 940 if (completer != null) complete();
duke@1 941 return flags_field;
duke@1 942 }
duke@1 943
duke@1 944 public Scope members() {
duke@1 945 if (completer != null) complete();
duke@1 946 return members_field;
duke@1 947 }
duke@1 948
jfranck@1464 949 @Override
jfranck@1464 950 public List<Attribute.Compound> getRawAttributes() {
duke@1 951 if (completer != null) complete();
jfranck@1464 952 return super.getRawAttributes();
duke@1 953 }
duke@1 954
jjg@1521 955 @Override
jjg@1521 956 public List<Attribute.TypeCompound> getRawTypeAttributes() {
jjg@1521 957 if (completer != null) complete();
jjg@1521 958 return super.getRawTypeAttributes();
jjg@1521 959 }
jjg@1521 960
duke@1 961 public Type erasure(Types types) {
duke@1 962 if (erasure_field == null)
duke@1 963 erasure_field = new ClassType(types.erasure(type.getEnclosingType()),
duke@1 964 List.<Type>nil(), this);
duke@1 965 return erasure_field;
duke@1 966 }
duke@1 967
duke@1 968 public String className() {
jjg@113 969 if (name.isEmpty())
duke@1 970 return
duke@1 971 Log.getLocalizedString("anonymous.class", flatname);
duke@1 972 else
duke@1 973 return fullname.toString();
duke@1 974 }
duke@1 975
duke@1 976 public Name getQualifiedName() {
duke@1 977 return fullname;
duke@1 978 }
duke@1 979
duke@1 980 public Name flatName() {
duke@1 981 return flatname;
duke@1 982 }
duke@1 983
duke@1 984 public boolean isSubClass(Symbol base, Types types) {
duke@1 985 if (this == base) {
duke@1 986 return true;
duke@1 987 } else if ((base.flags() & INTERFACE) != 0) {
jjg@1374 988 for (Type t = type; t.hasTag(CLASS); t = types.supertype(t))
duke@1 989 for (List<Type> is = types.interfaces(t);
duke@1 990 is.nonEmpty();
duke@1 991 is = is.tail)
duke@1 992 if (is.head.tsym.isSubClass(base, types)) return true;
duke@1 993 } else {
jjg@1374 994 for (Type t = type; t.hasTag(CLASS); t = types.supertype(t))
duke@1 995 if (t.tsym == base) return true;
duke@1 996 }
duke@1 997 return false;
duke@1 998 }
duke@1 999
duke@1 1000 /** Complete the elaboration of this symbol's definition.
duke@1 1001 */
duke@1 1002 public void complete() throws CompletionFailure {
duke@1 1003 try {
duke@1 1004 super.complete();
duke@1 1005 } catch (CompletionFailure ex) {
duke@1 1006 // quiet error recovery
duke@1 1007 flags_field |= (PUBLIC|STATIC);
jjg@110 1008 this.type = new ErrorType(this, Type.noType);
duke@1 1009 throw ex;
duke@1 1010 }
duke@1 1011 }
duke@1 1012
duke@1 1013 public List<Type> getInterfaces() {
duke@1 1014 complete();
duke@1 1015 if (type instanceof ClassType) {
duke@1 1016 ClassType t = (ClassType)type;
duke@1 1017 if (t.interfaces_field == null) // FIXME: shouldn't be null
duke@1 1018 t.interfaces_field = List.nil();
jjg@904 1019 if (t.all_interfaces_field != null)
jjg@904 1020 return Type.getModelTypes(t.all_interfaces_field);
duke@1 1021 return t.interfaces_field;
duke@1 1022 } else {
duke@1 1023 return List.nil();
duke@1 1024 }
duke@1 1025 }
duke@1 1026
duke@1 1027 public Type getSuperclass() {
duke@1 1028 complete();
duke@1 1029 if (type instanceof ClassType) {
duke@1 1030 ClassType t = (ClassType)type;
duke@1 1031 if (t.supertype_field == null) // FIXME: shouldn't be null
duke@1 1032 t.supertype_field = Type.noType;
duke@1 1033 // An interface has no superclass; its supertype is Object.
duke@1 1034 return t.isInterface()
duke@1 1035 ? Type.noType
jjg@904 1036 : t.supertype_field.getModelType();
duke@1 1037 } else {
duke@1 1038 return Type.noType;
duke@1 1039 }
duke@1 1040 }
duke@1 1041
duke@1 1042 public ElementKind getKind() {
duke@1 1043 long flags = flags();
duke@1 1044 if ((flags & ANNOTATION) != 0)
duke@1 1045 return ElementKind.ANNOTATION_TYPE;
duke@1 1046 else if ((flags & INTERFACE) != 0)
duke@1 1047 return ElementKind.INTERFACE;
duke@1 1048 else if ((flags & ENUM) != 0)
duke@1 1049 return ElementKind.ENUM;
duke@1 1050 else
duke@1 1051 return ElementKind.CLASS;
duke@1 1052 }
duke@1 1053
duke@1 1054 public NestingKind getNestingKind() {
duke@1 1055 complete();
duke@1 1056 if (owner.kind == PCK)
duke@1 1057 return NestingKind.TOP_LEVEL;
duke@1 1058 else if (name.isEmpty())
duke@1 1059 return NestingKind.ANONYMOUS;
duke@1 1060 else if (owner.kind == MTH)
duke@1 1061 return NestingKind.LOCAL;
duke@1 1062 else
duke@1 1063 return NestingKind.MEMBER;
duke@1 1064 }
duke@1 1065
duke@1 1066 /**
jjg@1645 1067 * Since this method works in terms of the runtime representation
jjg@1645 1068 * of annotations, it should never be used by javac internally.
duke@1 1069 */
jjg@1645 1070 @Override
duke@1 1071 public <A extends java.lang.annotation.Annotation> A getAnnotation(Class<A> annoType) {
jjg@1645 1072 return JavacAnnoConstructs.getAnnotation(this, annoType);
duke@1 1073 }
duke@1 1074
duke@1 1075 public <R, P> R accept(ElementVisitor<R, P> v, P p) {
duke@1 1076 return v.visitType(this, p);
duke@1 1077 }
mcimadamore@121 1078
mcimadamore@121 1079 public <R, P> R accept(Symbol.Visitor<R, P> v, P p) {
mcimadamore@121 1080 return v.visitClassSymbol(this, p);
mcimadamore@121 1081 }
duke@1 1082 }
duke@1 1083
duke@1 1084
duke@1 1085 /** A class for variable symbols
duke@1 1086 */
duke@1 1087 public static class VarSymbol extends Symbol implements VariableElement {
duke@1 1088
duke@1 1089 /** The variable's declaration position.
duke@1 1090 */
duke@1 1091 public int pos = Position.NOPOS;
duke@1 1092
duke@1 1093 /** The variable's address. Used for different purposes during
duke@1 1094 * flow analysis, translation and code generation.
duke@1 1095 * Flow analysis:
duke@1 1096 * If this is a blank final or local variable, its sequence number.
duke@1 1097 * Translation:
duke@1 1098 * If this is a private field, its access number.
duke@1 1099 * Code generation:
duke@1 1100 * If this is a local variable, its logical slot number.
duke@1 1101 */
duke@1 1102 public int adr = -1;
duke@1 1103
duke@1 1104 /** Construct a variable symbol, given its flags, name, type and owner.
duke@1 1105 */
duke@1 1106 public VarSymbol(long flags, Name name, Type type, Symbol owner) {
duke@1 1107 super(VAR, flags, name, type, owner);
duke@1 1108 }
duke@1 1109
duke@1 1110 /** Clone this symbol with new owner.
duke@1 1111 */
duke@1 1112 public VarSymbol clone(Symbol newOwner) {
mcimadamore@1352 1113 VarSymbol v = new VarSymbol(flags_field, name, type, newOwner) {
mcimadamore@1352 1114 @Override
mcimadamore@1352 1115 public Symbol baseSymbol() {
mcimadamore@1352 1116 return VarSymbol.this;
mcimadamore@1352 1117 }
mcimadamore@1352 1118 };
duke@1 1119 v.pos = pos;
duke@1 1120 v.adr = adr;
duke@1 1121 v.data = data;
duke@1 1122 // System.out.println("clone " + v + " in " + newOwner);//DEBUG
duke@1 1123 return v;
duke@1 1124 }
duke@1 1125
duke@1 1126 public String toString() {
duke@1 1127 return name.toString();
duke@1 1128 }
duke@1 1129
duke@1 1130 public Symbol asMemberOf(Type site, Types types) {
duke@1 1131 return new VarSymbol(flags_field, name, types.memberType(site, this), owner);
duke@1 1132 }
duke@1 1133
duke@1 1134 public ElementKind getKind() {
duke@1 1135 long flags = flags();
duke@1 1136 if ((flags & PARAMETER) != 0) {
duke@1 1137 if (isExceptionParameter())
duke@1 1138 return ElementKind.EXCEPTION_PARAMETER;
duke@1 1139 else
duke@1 1140 return ElementKind.PARAMETER;
duke@1 1141 } else if ((flags & ENUM) != 0) {
duke@1 1142 return ElementKind.ENUM_CONSTANT;
duke@1 1143 } else if (owner.kind == TYP || owner.kind == ERR) {
duke@1 1144 return ElementKind.FIELD;
sundar@697 1145 } else if (isResourceVariable()) {
sundar@697 1146 return ElementKind.RESOURCE_VARIABLE;
duke@1 1147 } else {
duke@1 1148 return ElementKind.LOCAL_VARIABLE;
duke@1 1149 }
duke@1 1150 }
duke@1 1151
duke@1 1152 public <R, P> R accept(ElementVisitor<R, P> v, P p) {
duke@1 1153 return v.visitVariable(this, p);
duke@1 1154 }
duke@1 1155
duke@1 1156 public Object getConstantValue() { // Mirror API
duke@1 1157 return Constants.decode(getConstValue(), type);
duke@1 1158 }
duke@1 1159
duke@1 1160 public void setLazyConstValue(final Env<AttrContext> env,
duke@1 1161 final Attr attr,
duke@1 1162 final JCTree.JCExpression initializer)
duke@1 1163 {
duke@1 1164 setData(new Callable<Object>() {
duke@1 1165 public Object call() {
jjg@841 1166 return attr.attribLazyConstantValue(env, initializer, type);
duke@1 1167 }
duke@1 1168 });
duke@1 1169 }
duke@1 1170
duke@1 1171 /**
duke@1 1172 * The variable's constant value, if this is a constant.
duke@1 1173 * Before the constant value is evaluated, it points to an
duke@1 1174 * initalizer environment. If this is not a constant, it can
duke@1 1175 * be used for other stuff.
duke@1 1176 */
duke@1 1177 private Object data;
duke@1 1178
duke@1 1179 public boolean isExceptionParameter() {
duke@1 1180 return data == ElementKind.EXCEPTION_PARAMETER;
duke@1 1181 }
duke@1 1182
darcy@609 1183 public boolean isResourceVariable() {
darcy@609 1184 return data == ElementKind.RESOURCE_VARIABLE;
darcy@609 1185 }
darcy@609 1186
duke@1 1187 public Object getConstValue() {
duke@1 1188 // TODO: Consider if getConstValue and getConstantValue can be collapsed
darcy@609 1189 if (data == ElementKind.EXCEPTION_PARAMETER ||
darcy@609 1190 data == ElementKind.RESOURCE_VARIABLE) {
duke@1 1191 return null;
duke@1 1192 } else if (data instanceof Callable<?>) {
darcy@609 1193 // In this case, this is a final variable, with an as
duke@1 1194 // yet unevaluated initializer.
duke@1 1195 Callable<?> eval = (Callable<?>)data;
duke@1 1196 data = null; // to make sure we don't evaluate this twice.
duke@1 1197 try {
duke@1 1198 data = eval.call();
duke@1 1199 } catch (Exception ex) {
duke@1 1200 throw new AssertionError(ex);
duke@1 1201 }
duke@1 1202 }
duke@1 1203 return data;
duke@1 1204 }
duke@1 1205
duke@1 1206 public void setData(Object data) {
jjg@816 1207 Assert.check(!(data instanceof Env<?>), this);
duke@1 1208 this.data = data;
duke@1 1209 }
mcimadamore@121 1210
mcimadamore@121 1211 public <R, P> R accept(Symbol.Visitor<R, P> v, P p) {
mcimadamore@121 1212 return v.visitVarSymbol(this, p);
mcimadamore@121 1213 }
duke@1 1214 }
duke@1 1215
duke@1 1216 /** A class for method symbols.
duke@1 1217 */
duke@1 1218 public static class MethodSymbol extends Symbol implements ExecutableElement {
duke@1 1219
duke@1 1220 /** The code of the method. */
duke@1 1221 public Code code = null;
duke@1 1222
mcimadamore@1565 1223 /** The extra (synthetic/mandated) parameters of the method. */
mcimadamore@1565 1224 public List<VarSymbol> extraParams = List.nil();
mcimadamore@1565 1225
duke@1 1226 /** The parameters of the method. */
duke@1 1227 public List<VarSymbol> params = null;
duke@1 1228
duke@1 1229 /** The names of the parameters */
duke@1 1230 public List<Name> savedParameterNames;
duke@1 1231
duke@1 1232 /** For an attribute field accessor, its default value if any.
duke@1 1233 * The value is null if none appeared in the method
duke@1 1234 * declaration.
duke@1 1235 */
duke@1 1236 public Attribute defaultValue = null;
duke@1 1237
duke@1 1238 /** Construct a method symbol, given its flags, name, type and owner.
duke@1 1239 */
duke@1 1240 public MethodSymbol(long flags, Name name, Type type, Symbol owner) {
duke@1 1241 super(MTH, flags, name, type, owner);
jjg@1374 1242 if (owner.type.hasTag(TYPEVAR)) Assert.error(owner + "." + name);
duke@1 1243 }
duke@1 1244
duke@1 1245 /** Clone this symbol with new owner.
duke@1 1246 */
duke@1 1247 public MethodSymbol clone(Symbol newOwner) {
mcimadamore@1352 1248 MethodSymbol m = new MethodSymbol(flags_field, name, type, newOwner) {
mcimadamore@1352 1249 @Override
mcimadamore@1352 1250 public Symbol baseSymbol() {
mcimadamore@1352 1251 return MethodSymbol.this;
mcimadamore@1352 1252 }
mcimadamore@1352 1253 };
duke@1 1254 m.code = code;
duke@1 1255 return m;
duke@1 1256 }
duke@1 1257
mcimadamore@1692 1258 @Override
mcimadamore@1692 1259 public Set<Modifier> getModifiers() {
mcimadamore@1692 1260 long flags = flags();
mcimadamore@1692 1261 return Flags.asModifierSet((flags & DEFAULT) != 0 ? flags & ~ABSTRACT : flags);
mcimadamore@1692 1262 }
mcimadamore@1692 1263
duke@1 1264 /** The Java source which this symbol represents.
duke@1 1265 */
duke@1 1266 public String toString() {
duke@1 1267 if ((flags() & BLOCK) != 0) {
duke@1 1268 return owner.name.toString();
duke@1 1269 } else {
jjg@113 1270 String s = (name == name.table.names.init)
duke@1 1271 ? owner.name.toString()
duke@1 1272 : name.toString();
duke@1 1273 if (type != null) {
jjg@1374 1274 if (type.hasTag(FORALL))
duke@1 1275 s = "<" + ((ForAll)type).getTypeArguments() + ">" + s;
duke@1 1276 s += "(" + type.argtypes((flags() & VARARGS) != 0) + ")";
duke@1 1277 }
duke@1 1278 return s;
duke@1 1279 }
duke@1 1280 }
duke@1 1281
mcimadamore@1336 1282 public boolean isDynamic() {
mcimadamore@1336 1283 return false;
mcimadamore@1336 1284 }
mcimadamore@1336 1285
duke@1 1286 /** find a symbol that this (proxy method) symbol implements.
duke@1 1287 * @param c The class whose members are searched for
duke@1 1288 * implementations
duke@1 1289 */
duke@1 1290 public Symbol implemented(TypeSymbol c, Types types) {
duke@1 1291 Symbol impl = null;
duke@1 1292 for (List<Type> is = types.interfaces(c.type);
duke@1 1293 impl == null && is.nonEmpty();
duke@1 1294 is = is.tail) {
duke@1 1295 TypeSymbol i = is.head.tsym;
mcimadamore@780 1296 impl = implementedIn(i, types);
mcimadamore@780 1297 if (impl == null)
mcimadamore@780 1298 impl = implemented(i, types);
mcimadamore@780 1299 }
mcimadamore@780 1300 return impl;
mcimadamore@780 1301 }
mcimadamore@780 1302
mcimadamore@780 1303 public Symbol implementedIn(TypeSymbol c, Types types) {
mcimadamore@780 1304 Symbol impl = null;
mcimadamore@780 1305 for (Scope.Entry e = c.members().lookup(name);
mcimadamore@780 1306 impl == null && e.scope != null;
mcimadamore@780 1307 e = e.next()) {
mcimadamore@780 1308 if (this.overrides(e.sym, (TypeSymbol)owner, types, true) &&
mcimadamore@780 1309 // FIXME: I suspect the following requires a
mcimadamore@780 1310 // subst() for a parametric return type.
mcimadamore@780 1311 types.isSameType(type.getReturnType(),
mcimadamore@780 1312 types.memberType(owner.type, e.sym).getReturnType())) {
mcimadamore@780 1313 impl = e.sym;
duke@1 1314 }
duke@1 1315 }
duke@1 1316 return impl;
duke@1 1317 }
duke@1 1318
duke@1 1319 /** Will the erasure of this method be considered by the VM to
duke@1 1320 * override the erasure of the other when seen from class `origin'?
duke@1 1321 */
duke@1 1322 public boolean binaryOverrides(Symbol _other, TypeSymbol origin, Types types) {
duke@1 1323 if (isConstructor() || _other.kind != MTH) return false;
duke@1 1324
duke@1 1325 if (this == _other) return true;
duke@1 1326 MethodSymbol other = (MethodSymbol)_other;
duke@1 1327
duke@1 1328 // check for a direct implementation
duke@1 1329 if (other.isOverridableIn((TypeSymbol)owner) &&
duke@1 1330 types.asSuper(owner.type, other.owner) != null &&
duke@1 1331 types.isSameType(erasure(types), other.erasure(types)))
duke@1 1332 return true;
duke@1 1333
duke@1 1334 // check for an inherited implementation
duke@1 1335 return
duke@1 1336 (flags() & ABSTRACT) == 0 &&
duke@1 1337 other.isOverridableIn(origin) &&
duke@1 1338 this.isMemberOf(origin, types) &&
duke@1 1339 types.isSameType(erasure(types), other.erasure(types));
duke@1 1340 }
duke@1 1341
duke@1 1342 /** The implementation of this (abstract) symbol in class origin,
duke@1 1343 * from the VM's point of view, null if method does not have an
duke@1 1344 * implementation in class.
duke@1 1345 * @param origin The class of which the implementation is a member.
duke@1 1346 */
duke@1 1347 public MethodSymbol binaryImplementation(ClassSymbol origin, Types types) {
duke@1 1348 for (TypeSymbol c = origin; c != null; c = types.supertype(c.type).tsym) {
duke@1 1349 for (Scope.Entry e = c.members().lookup(name);
duke@1 1350 e.scope != null;
duke@1 1351 e = e.next()) {
duke@1 1352 if (e.sym.kind == MTH &&
duke@1 1353 ((MethodSymbol)e.sym).binaryOverrides(this, origin, types))
duke@1 1354 return (MethodSymbol)e.sym;
duke@1 1355 }
duke@1 1356 }
duke@1 1357 return null;
duke@1 1358 }
duke@1 1359
duke@1 1360 /** Does this symbol override `other' symbol, when both are seen as
duke@1 1361 * members of class `origin'? It is assumed that _other is a member
duke@1 1362 * of origin.
duke@1 1363 *
duke@1 1364 * It is assumed that both symbols have the same name. The static
duke@1 1365 * modifier is ignored for this test.
duke@1 1366 *
duke@1 1367 * See JLS 8.4.6.1 (without transitivity) and 8.4.6.4
duke@1 1368 */
duke@1 1369 public boolean overrides(Symbol _other, TypeSymbol origin, Types types, boolean checkResult) {
duke@1 1370 if (isConstructor() || _other.kind != MTH) return false;
duke@1 1371
duke@1 1372 if (this == _other) return true;
duke@1 1373 MethodSymbol other = (MethodSymbol)_other;
duke@1 1374
duke@1 1375 // check for a direct implementation
duke@1 1376 if (other.isOverridableIn((TypeSymbol)owner) &&
duke@1 1377 types.asSuper(owner.type, other.owner) != null) {
duke@1 1378 Type mt = types.memberType(owner.type, this);
duke@1 1379 Type ot = types.memberType(owner.type, other);
duke@1 1380 if (types.isSubSignature(mt, ot)) {
duke@1 1381 if (!checkResult)
duke@1 1382 return true;
duke@1 1383 if (types.returnTypeSubstitutable(mt, ot))
duke@1 1384 return true;
duke@1 1385 }
duke@1 1386 }
duke@1 1387
duke@1 1388 // check for an inherited implementation
duke@1 1389 if ((flags() & ABSTRACT) != 0 ||
mcimadamore@1415 1390 ((other.flags() & ABSTRACT) == 0 && (other.flags() & DEFAULT) == 0) ||
mcimadamore@1393 1391 !other.isOverridableIn(origin) ||
mcimadamore@1393 1392 !this.isMemberOf(origin, types))
duke@1 1393 return false;
duke@1 1394
duke@1 1395 // assert types.asSuper(origin.type, other.owner) != null;
duke@1 1396 Type mt = types.memberType(origin.type, this);
duke@1 1397 Type ot = types.memberType(origin.type, other);
duke@1 1398 return
duke@1 1399 types.isSubSignature(mt, ot) &&
mcimadamore@1415 1400 (!checkResult || types.resultSubtype(mt, ot, types.noWarnings));
duke@1 1401 }
duke@1 1402
duke@1 1403 private boolean isOverridableIn(TypeSymbol origin) {
jjh@972 1404 // JLS 8.4.6.1
duke@1 1405 switch ((int)(flags_field & Flags.AccessFlags)) {
duke@1 1406 case Flags.PRIVATE:
duke@1 1407 return false;
duke@1 1408 case Flags.PUBLIC:
mcimadamore@1513 1409 return !this.owner.isInterface() ||
mcimadamore@1513 1410 (flags_field & STATIC) == 0;
duke@1 1411 case Flags.PROTECTED:
duke@1 1412 return (origin.flags() & INTERFACE) == 0;
duke@1 1413 case 0:
duke@1 1414 // for package private: can only override in the same
duke@1 1415 // package
duke@1 1416 return
duke@1 1417 this.packge() == origin.packge() &&
duke@1 1418 (origin.flags() & INTERFACE) == 0;
duke@1 1419 default:
duke@1 1420 return false;
duke@1 1421 }
duke@1 1422 }
duke@1 1423
mcimadamore@1513 1424 @Override
mcimadamore@1513 1425 public boolean isInheritedIn(Symbol clazz, Types types) {
mcimadamore@1513 1426 switch ((int)(flags_field & Flags.AccessFlags)) {
mcimadamore@1513 1427 case PUBLIC:
mcimadamore@1513 1428 return !this.owner.isInterface() ||
mcimadamore@1513 1429 clazz == owner ||
mcimadamore@1513 1430 (flags_field & STATIC) == 0;
mcimadamore@1513 1431 default:
mcimadamore@1513 1432 return super.isInheritedIn(clazz, types);
mcimadamore@1513 1433 }
mcimadamore@1513 1434 }
mcimadamore@1513 1435
duke@1 1436 /** The implementation of this (abstract) symbol in class origin;
duke@1 1437 * null if none exists. Synthetic methods are not considered
duke@1 1438 * as possible implementations.
duke@1 1439 */
duke@1 1440 public MethodSymbol implementation(TypeSymbol origin, Types types, boolean checkResult) {
mcimadamore@673 1441 return implementation(origin, types, checkResult, implementation_filter);
mcimadamore@673 1442 }
mcimadamore@673 1443 // where
vromero@1607 1444 public static final Filter<Symbol> implementation_filter = new Filter<Symbol>() {
mcimadamore@673 1445 public boolean accepts(Symbol s) {
mcimadamore@673 1446 return s.kind == Kinds.MTH &&
mcimadamore@673 1447 (s.flags() & SYNTHETIC) == 0;
mcimadamore@673 1448 }
mcimadamore@673 1449 };
mcimadamore@673 1450
mcimadamore@673 1451 public MethodSymbol implementation(TypeSymbol origin, Types types, boolean checkResult, Filter<Symbol> implFilter) {
mcimadamore@858 1452 MethodSymbol res = types.implementation(this, origin, checkResult, implFilter);
mcimadamore@341 1453 if (res != null)
mcimadamore@341 1454 return res;
duke@1 1455 // if origin is derived from a raw type, we might have missed
duke@1 1456 // an implementation because we do not know enough about instantiations.
duke@1 1457 // in this case continue with the supertype as origin.
mcimadamore@1222 1458 if (types.isDerivedRaw(origin.type) && !origin.isInterface())
duke@1 1459 return implementation(types.supertype(origin.type).tsym, types, checkResult);
duke@1 1460 else
duke@1 1461 return null;
duke@1 1462 }
duke@1 1463
duke@1 1464 public List<VarSymbol> params() {
duke@1 1465 owner.complete();
duke@1 1466 if (params == null) {
jjg@428 1467 // If ClassReader.saveParameterNames has been set true, then
jjg@428 1468 // savedParameterNames will be set to a list of names that
jjg@428 1469 // matches the types in type.getParameterTypes(). If any names
jjg@428 1470 // were not found in the class file, those names in the list will
jjg@428 1471 // be set to the empty name.
jjg@428 1472 // If ClassReader.saveParameterNames has been set false, then
jjg@428 1473 // savedParameterNames will be null.
jjg@428 1474 List<Name> paramNames = savedParameterNames;
duke@1 1475 savedParameterNames = null;
jjg@428 1476 // discard the provided names if the list of names is the wrong size.
jjg@1473 1477 if (paramNames == null || paramNames.size() != type.getParameterTypes().size()) {
jjg@428 1478 paramNames = List.nil();
jjg@1473 1479 }
duke@1 1480 ListBuffer<VarSymbol> buf = new ListBuffer<VarSymbol>();
jjg@428 1481 List<Name> remaining = paramNames;
jjg@428 1482 // assert: remaining and paramNames are both empty or both
jjg@428 1483 // have same cardinality as type.getParameterTypes()
jjg@428 1484 int i = 0;
duke@1 1485 for (Type t : type.getParameterTypes()) {
jjg@428 1486 Name paramName;
jjg@428 1487 if (remaining.isEmpty()) {
jjg@428 1488 // no names for any parameters available
jjg@428 1489 paramName = createArgName(i, paramNames);
jjg@428 1490 } else {
jjg@428 1491 paramName = remaining.head;
jjg@428 1492 remaining = remaining.tail;
jjg@428 1493 if (paramName.isEmpty()) {
jjg@428 1494 // no name for this specific parameter
jjg@428 1495 paramName = createArgName(i, paramNames);
jjg@428 1496 }
jjg@428 1497 }
jjg@428 1498 buf.append(new VarSymbol(PARAMETER, paramName, t, this));
jjg@428 1499 i++;
duke@1 1500 }
duke@1 1501 params = buf.toList();
duke@1 1502 }
duke@1 1503 return params;
duke@1 1504 }
duke@1 1505
jjg@428 1506 // Create a name for the argument at position 'index' that is not in
jjg@428 1507 // the exclude list. In normal use, either no names will have been
jjg@428 1508 // provided, in which case the exclude list is empty, or all the names
jjg@428 1509 // will have been provided, in which case this method will not be called.
jjg@428 1510 private Name createArgName(int index, List<Name> exclude) {
jjg@428 1511 String prefix = "arg";
jjg@428 1512 while (true) {
jjg@428 1513 Name argName = name.table.fromString(prefix + index);
jjg@428 1514 if (!exclude.contains(argName))
jjg@428 1515 return argName;
jjg@428 1516 prefix += "$";
jjg@428 1517 }
jjg@428 1518 }
jjg@428 1519
duke@1 1520 public Symbol asMemberOf(Type site, Types types) {
duke@1 1521 return new MethodSymbol(flags_field, name, types.memberType(site, this), owner);
duke@1 1522 }
duke@1 1523
duke@1 1524 public ElementKind getKind() {
jjg@113 1525 if (name == name.table.names.init)
duke@1 1526 return ElementKind.CONSTRUCTOR;
jjg@113 1527 else if (name == name.table.names.clinit)
duke@1 1528 return ElementKind.STATIC_INIT;
mcimadamore@1085 1529 else if ((flags() & BLOCK) != 0)
mcimadamore@1085 1530 return isStatic() ? ElementKind.STATIC_INIT : ElementKind.INSTANCE_INIT;
duke@1 1531 else
duke@1 1532 return ElementKind.METHOD;
duke@1 1533 }
duke@1 1534
mcimadamore@1085 1535 public boolean isStaticOrInstanceInit() {
mcimadamore@1085 1536 return getKind() == ElementKind.STATIC_INIT ||
mcimadamore@1085 1537 getKind() == ElementKind.INSTANCE_INIT;
mcimadamore@1085 1538 }
mcimadamore@1085 1539
duke@1 1540 public Attribute getDefaultValue() {
duke@1 1541 return defaultValue;
duke@1 1542 }
duke@1 1543
jjg@1521 1544 public List<VarSymbol> getParameters() {
duke@1 1545 return params();
duke@1 1546 }
duke@1 1547
duke@1 1548 public boolean isVarArgs() {
duke@1 1549 return (flags() & VARARGS) != 0;
duke@1 1550 }
duke@1 1551
darcy@1459 1552 public boolean isDefault() {
darcy@1459 1553 return (flags() & DEFAULT) != 0;
darcy@1459 1554 }
darcy@1459 1555
duke@1 1556 public <R, P> R accept(ElementVisitor<R, P> v, P p) {
duke@1 1557 return v.visitExecutable(this, p);
duke@1 1558 }
duke@1 1559
mcimadamore@121 1560 public <R, P> R accept(Symbol.Visitor<R, P> v, P p) {
mcimadamore@121 1561 return v.visitMethodSymbol(this, p);
mcimadamore@121 1562 }
mcimadamore@121 1563
jjg@1645 1564 public Type getReceiverType() {
jjg@1645 1565 return asType().getReceiverType();
jjg@1645 1566 }
jjg@1645 1567
duke@1 1568 public Type getReturnType() {
duke@1 1569 return asType().getReturnType();
duke@1 1570 }
duke@1 1571
duke@1 1572 public List<Type> getThrownTypes() {
duke@1 1573 return asType().getThrownTypes();
duke@1 1574 }
duke@1 1575 }
duke@1 1576
mcimadamore@1336 1577 /** A class for invokedynamic method calls.
mcimadamore@1336 1578 */
mcimadamore@1336 1579 public static class DynamicMethodSymbol extends MethodSymbol {
mcimadamore@1336 1580
mcimadamore@1336 1581 public Object[] staticArgs;
mcimadamore@1336 1582 public Symbol bsm;
mcimadamore@1336 1583 public int bsmKind;
mcimadamore@1336 1584
mcimadamore@1336 1585 public DynamicMethodSymbol(Name name, Symbol owner, int bsmKind, MethodSymbol bsm, Type type, Object[] staticArgs) {
mcimadamore@1336 1586 super(0, name, type, owner);
mcimadamore@1336 1587 this.bsm = bsm;
mcimadamore@1336 1588 this.bsmKind = bsmKind;
mcimadamore@1336 1589 this.staticArgs = staticArgs;
mcimadamore@1336 1590 }
mcimadamore@1336 1591
mcimadamore@1336 1592 @Override
mcimadamore@1336 1593 public boolean isDynamic() {
mcimadamore@1336 1594 return true;
mcimadamore@1336 1595 }
mcimadamore@1336 1596 }
mcimadamore@1336 1597
duke@1 1598 /** A class for predefined operators.
duke@1 1599 */
duke@1 1600 public static class OperatorSymbol extends MethodSymbol {
duke@1 1601
duke@1 1602 public int opcode;
duke@1 1603
duke@1 1604 public OperatorSymbol(Name name, Type type, int opcode, Symbol owner) {
duke@1 1605 super(PUBLIC | STATIC, name, type, owner);
duke@1 1606 this.opcode = opcode;
duke@1 1607 }
mcimadamore@121 1608
mcimadamore@121 1609 public <R, P> R accept(Symbol.Visitor<R, P> v, P p) {
mcimadamore@121 1610 return v.visitOperatorSymbol(this, p);
mcimadamore@121 1611 }
duke@1 1612 }
duke@1 1613
duke@1 1614 /** Symbol completer interface.
duke@1 1615 */
duke@1 1616 public static interface Completer {
duke@1 1617 void complete(Symbol sym) throws CompletionFailure;
duke@1 1618 }
duke@1 1619
duke@1 1620 public static class CompletionFailure extends RuntimeException {
duke@1 1621 private static final long serialVersionUID = 0;
duke@1 1622 public Symbol sym;
duke@1 1623
jjg@12 1624 /** A diagnostic object describing the failure
jjg@12 1625 */
jjg@12 1626 public JCDiagnostic diag;
jjg@12 1627
duke@1 1628 /** A localized string describing the failure.
jjg@12 1629 * @deprecated Use {@code getDetail()} or {@code getMessage()}
duke@1 1630 */
jjg@12 1631 @Deprecated
duke@1 1632 public String errmsg;
duke@1 1633
duke@1 1634 public CompletionFailure(Symbol sym, String errmsg) {
duke@1 1635 this.sym = sym;
duke@1 1636 this.errmsg = errmsg;
duke@1 1637 // this.printStackTrace();//DEBUG
duke@1 1638 }
duke@1 1639
jjg@12 1640 public CompletionFailure(Symbol sym, JCDiagnostic diag) {
jjg@12 1641 this.sym = sym;
jjg@12 1642 this.diag = diag;
jjg@12 1643 // this.printStackTrace();//DEBUG
jjg@12 1644 }
jjg@12 1645
jjg@12 1646 public JCDiagnostic getDiagnostic() {
jjg@12 1647 return diag;
jjg@12 1648 }
jjg@12 1649
jjg@12 1650 @Override
duke@1 1651 public String getMessage() {
jjg@12 1652 if (diag != null)
jjg@12 1653 return diag.getMessage(null);
jjg@12 1654 else
jjg@12 1655 return errmsg;
jjg@12 1656 }
jjg@12 1657
jjg@12 1658 public Object getDetailValue() {
jjg@12 1659 return (diag != null ? diag : errmsg);
duke@1 1660 }
duke@1 1661
duke@1 1662 @Override
duke@1 1663 public CompletionFailure initCause(Throwable cause) {
duke@1 1664 super.initCause(cause);
duke@1 1665 return this;
duke@1 1666 }
duke@1 1667
duke@1 1668 }
mcimadamore@121 1669
mcimadamore@121 1670 /**
mcimadamore@121 1671 * A visitor for symbols. A visitor is used to implement operations
mcimadamore@121 1672 * (or relations) on symbols. Most common operations on types are
mcimadamore@121 1673 * binary relations and this interface is designed for binary
mcimadamore@121 1674 * relations, that is, operations on the form
mcimadamore@121 1675 * Symbol&nbsp;&times;&nbsp;P&nbsp;&rarr;&nbsp;R.
mcimadamore@121 1676 * <!-- In plain text: Type x P -> R -->
mcimadamore@121 1677 *
mcimadamore@121 1678 * @param <R> the return type of the operation implemented by this
mcimadamore@121 1679 * visitor; use Void if no return type is needed.
mcimadamore@121 1680 * @param <P> the type of the second argument (the first being the
mcimadamore@121 1681 * symbol itself) of the operation implemented by this visitor; use
mcimadamore@121 1682 * Void if a second argument is not needed.
mcimadamore@121 1683 */
mcimadamore@121 1684 public interface Visitor<R,P> {
mcimadamore@121 1685 R visitClassSymbol(ClassSymbol s, P arg);
mcimadamore@121 1686 R visitMethodSymbol(MethodSymbol s, P arg);
mcimadamore@121 1687 R visitPackageSymbol(PackageSymbol s, P arg);
mcimadamore@121 1688 R visitOperatorSymbol(OperatorSymbol s, P arg);
mcimadamore@121 1689 R visitVarSymbol(VarSymbol s, P arg);
mcimadamore@121 1690 R visitTypeSymbol(TypeSymbol s, P arg);
mcimadamore@121 1691 R visitSymbol(Symbol s, P arg);
mcimadamore@121 1692 }
duke@1 1693 }

mercurial