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

Tue, 28 Dec 2010 15:54:52 -0800

author
ohair
date
Tue, 28 Dec 2010 15:54:52 -0800
changeset 798
4868a36f6fd8
parent 597
d2b7ecf33b35
child 899
67d6b2df47ba
permissions
-rw-r--r--

6962318: Update copyright year
Reviewed-by: xdono

duke@1 1 /*
ohair@798 2 * Copyright (c) 1999, 2010, 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
mcimadamore@80 28 import java.util.EnumSet;
mcimadamore@136 29 import java.util.Locale;
mcimadamore@80 30
mcimadamore@80 31 import com.sun.tools.javac.api.Formattable;
mcimadamore@136 32 import com.sun.tools.javac.api.Messages;
mcimadamore@80 33
mcimadamore@80 34 import static com.sun.tools.javac.code.TypeTags.*;
mcimadamore@80 35 import static com.sun.tools.javac.code.Flags.*;
duke@1 36
duke@1 37 /** Internal symbol kinds, which distinguish between elements of
duke@1 38 * different subclasses of Symbol. Symbol kinds are organized so they can be
duke@1 39 * or'ed to sets.
duke@1 40 *
jjg@581 41 * <p><b>This is NOT part of any supported API.
jjg@581 42 * If you write code that depends on this, you do so at your own risk.
duke@1 43 * This code and its internal interfaces are subject to change or
duke@1 44 * deletion without notice.</b>
duke@1 45 */
duke@1 46 public class Kinds {
duke@1 47
duke@1 48 private Kinds() {} // uninstantiable
duke@1 49
duke@1 50 /** The empty set of kinds.
duke@1 51 */
duke@1 52 public final static int NIL = 0;
duke@1 53
duke@1 54 /** The kind of package symbols.
duke@1 55 */
duke@1 56 public final static int PCK = 1 << 0;
duke@1 57
duke@1 58 /** The kind of type symbols (classes, interfaces and type variables).
duke@1 59 */
duke@1 60 public final static int TYP = 1 << 1;
duke@1 61
duke@1 62 /** The kind of variable symbols.
duke@1 63 */
duke@1 64 public final static int VAR = 1 << 2;
duke@1 65
duke@1 66 /** The kind of values (variables or non-variable expressions), includes VAR.
duke@1 67 */
duke@1 68 public final static int VAL = (1 << 3) | VAR;
duke@1 69
duke@1 70 /** The kind of methods.
duke@1 71 */
duke@1 72 public final static int MTH = 1 << 4;
duke@1 73
duke@1 74 /** The error kind, which includes all other kinds.
duke@1 75 */
duke@1 76 public final static int ERR = (1 << 5) - 1;
duke@1 77
duke@1 78 /** The set of all kinds.
duke@1 79 */
duke@1 80 public final static int AllKinds = ERR;
duke@1 81
duke@1 82 /** Kinds for erroneous symbols that complement the above
duke@1 83 */
duke@1 84 public static final int ERRONEOUS = 1 << 6;
duke@1 85 public static final int AMBIGUOUS = ERRONEOUS+1; // ambiguous reference
duke@1 86 public static final int HIDDEN = ERRONEOUS+2; // hidden method or field
duke@1 87 public static final int STATICERR = ERRONEOUS+3; // nonstatic member from static context
duke@1 88 public static final int ABSENT_VAR = ERRONEOUS+4; // missing variable
duke@1 89 public static final int WRONG_MTHS = ERRONEOUS+5; // methods with wrong arguments
duke@1 90 public static final int WRONG_MTH = ERRONEOUS+6; // one method with wrong arguments
duke@1 91 public static final int ABSENT_MTH = ERRONEOUS+7; // missing method
duke@1 92 public static final int ABSENT_TYP = ERRONEOUS+8; // missing type
mcimadamore@80 93
mcimadamore@80 94 public enum KindName implements Formattable {
jjg@597 95 ANNOTATION("kindname.annotation"),
mcimadamore@80 96 CONSTRUCTOR("kindname.constructor"),
mcimadamore@80 97 INTERFACE("kindname.interface"),
mcimadamore@302 98 ENUM("kindname.enum"),
mcimadamore@80 99 STATIC("kindname.static"),
mcimadamore@80 100 TYPEVAR("kindname.type.variable"),
mcimadamore@80 101 BOUND("kindname.type.variable.bound"),
mcimadamore@80 102 VAR("kindname.variable"),
mcimadamore@80 103 VAL("kindname.value"),
mcimadamore@80 104 METHOD("kindname.method"),
mcimadamore@80 105 CLASS("kindname.class"),
mcimadamore@80 106 PACKAGE("kindname.package");
mcimadamore@80 107
mcimadamore@80 108 private String name;
mcimadamore@80 109
mcimadamore@80 110 KindName(String name) {
mcimadamore@80 111 this.name = name;
mcimadamore@80 112 }
mcimadamore@80 113
mcimadamore@80 114 public String toString() {
mcimadamore@80 115 return name;
mcimadamore@80 116 }
mcimadamore@80 117
mcimadamore@80 118 public String getKind() {
mcimadamore@80 119 return "Kindname";
mcimadamore@80 120 }
mcimadamore@80 121
mcimadamore@136 122 public String toString(Locale locale, Messages messages) {
mcimadamore@80 123 String s = toString();
mcimadamore@136 124 return messages.getLocalizedString(locale, "compiler.misc." + s);
mcimadamore@80 125 }
mcimadamore@80 126 }
mcimadamore@80 127
mcimadamore@80 128 /** A KindName representing a given symbol kind
mcimadamore@80 129 */
mcimadamore@80 130 public static KindName kindName(int kind) {
mcimadamore@80 131 switch (kind) {
mcimadamore@80 132 case PCK: return KindName.PACKAGE;
mcimadamore@80 133 case TYP: return KindName.CLASS;
mcimadamore@80 134 case VAR: return KindName.VAR;
mcimadamore@80 135 case VAL: return KindName.VAL;
mcimadamore@80 136 case MTH: return KindName.METHOD;
mcimadamore@80 137 default : throw new AssertionError("Unexpected kind: "+kind);
mcimadamore@80 138 }
mcimadamore@80 139 }
mcimadamore@80 140
mcimadamore@80 141 /** A KindName representing a given symbol
mcimadamore@80 142 */
mcimadamore@80 143 public static KindName kindName(Symbol sym) {
mcimadamore@80 144 switch (sym.getKind()) {
mcimadamore@80 145 case PACKAGE:
mcimadamore@80 146 return KindName.PACKAGE;
mcimadamore@80 147
mcimadamore@80 148 case ENUM:
mcimadamore@302 149 return KindName.ENUM;
mcimadamore@302 150
mcimadamore@80 151 case ANNOTATION_TYPE:
mcimadamore@80 152 case CLASS:
mcimadamore@80 153 return KindName.CLASS;
mcimadamore@80 154
mcimadamore@302 155 case INTERFACE:
mcimadamore@302 156 return KindName.INTERFACE;
mcimadamore@302 157
mcimadamore@80 158 case TYPE_PARAMETER:
mcimadamore@80 159 return KindName.TYPEVAR;
mcimadamore@80 160
mcimadamore@80 161 case ENUM_CONSTANT:
mcimadamore@80 162 case FIELD:
mcimadamore@80 163 case PARAMETER:
mcimadamore@80 164 case LOCAL_VARIABLE:
mcimadamore@80 165 case EXCEPTION_PARAMETER:
mcimadamore@80 166 return KindName.VAR;
mcimadamore@80 167
mcimadamore@302 168 case CONSTRUCTOR:
mcimadamore@302 169 return KindName.CONSTRUCTOR;
mcimadamore@302 170
mcimadamore@80 171 case METHOD:
mcimadamore@80 172 case STATIC_INIT:
mcimadamore@80 173 case INSTANCE_INIT:
mcimadamore@80 174 return KindName.METHOD;
mcimadamore@80 175
mcimadamore@80 176 default:
mcimadamore@80 177 if (sym.kind == VAL)
mcimadamore@80 178 // I don't think this can happen but it can't harm
mcimadamore@80 179 // playing it safe --ahe
mcimadamore@80 180 return KindName.VAL;
mcimadamore@80 181 else
mcimadamore@80 182 throw new AssertionError("Unexpected kind: "+sym.getKind());
mcimadamore@80 183 }
mcimadamore@80 184 }
mcimadamore@80 185
mcimadamore@80 186 /** A set of KindName(s) representing a set of symbol's kinds.
mcimadamore@80 187 */
mcimadamore@80 188 public static EnumSet<KindName> kindNames(int kind) {
mcimadamore@80 189 EnumSet<KindName> kinds = EnumSet.noneOf(KindName.class);
mcimadamore@80 190 if ((kind & VAL) != 0)
mcimadamore@80 191 kinds.add(((kind & VAL) == VAR) ? KindName.VAR : KindName.VAL);
mcimadamore@80 192 if ((kind & MTH) != 0) kinds.add(KindName.METHOD);
mcimadamore@80 193 if ((kind & TYP) != 0) kinds.add(KindName.CLASS);
mcimadamore@80 194 if ((kind & PCK) != 0) kinds.add(KindName.PACKAGE);
mcimadamore@80 195 return kinds;
mcimadamore@80 196 }
mcimadamore@80 197
mcimadamore@80 198 /** A KindName representing the kind of a given class/interface type.
mcimadamore@80 199 */
mcimadamore@80 200 public static KindName typeKindName(Type t) {
mcimadamore@80 201 if (t.tag == TYPEVAR ||
mcimadamore@80 202 t.tag == CLASS && (t.tsym.flags() & COMPOUND) != 0)
mcimadamore@80 203 return KindName.BOUND;
mcimadamore@80 204 else if (t.tag == PACKAGE)
mcimadamore@80 205 return KindName.PACKAGE;
mcimadamore@80 206 else if ((t.tsym.flags_field & ANNOTATION) != 0)
mcimadamore@80 207 return KindName.ANNOTATION;
mcimadamore@80 208 else if ((t.tsym.flags_field & INTERFACE) != 0)
mcimadamore@80 209 return KindName.INTERFACE;
mcimadamore@80 210 else
mcimadamore@80 211 return KindName.CLASS;
mcimadamore@80 212 }
mcimadamore@80 213
mcimadamore@80 214 /** A KindName representing the kind of a a missing symbol, given an
mcimadamore@80 215 * error kind.
mcimadamore@80 216 * */
mcimadamore@80 217 public static KindName absentKind(int kind) {
mcimadamore@80 218 switch (kind) {
mcimadamore@80 219 case ABSENT_VAR:
mcimadamore@80 220 return KindName.VAR;
mcimadamore@80 221 case WRONG_MTHS: case WRONG_MTH: case ABSENT_MTH:
mcimadamore@80 222 return KindName.METHOD;
mcimadamore@80 223 case ABSENT_TYP:
mcimadamore@80 224 return KindName.CLASS;
mcimadamore@80 225 default:
mcimadamore@80 226 throw new AssertionError("Unexpected kind: "+kind);
mcimadamore@80 227 }
mcimadamore@80 228 }
duke@1 229 }

mercurial