jdk8-mips64-public/langtools: src/share/classes/com/sun/tools/classfile/ExtendedAnnotation.java@664edca41e34 (annotated)

src/share/classes/com/sun/tools/classfile/ExtendedAnnotation.java@664edca41e34 (annotated)

src/share/classes/com/sun/tools/classfile/ExtendedAnnotation.java

Fri, 26 Jun 2009 19:12:41 -0700

author: jjg
date: Fri, 26 Jun 2009 19:12:41 -0700
changeset 309: 664edca41e34
child 328: 99b7a25185aa
permissions: -rw-r--r--

6855544: add missing files
Reviewed-by: jjg, mcimadamore, darcy
Contributed-by: mernst@cs.washington.edu, mali@csail.mit.edu, mpapi@csail.mit.edu

 /*
  * Copyright 2009 Sun Microsystems, Inc.  All Rights Reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Sun designates this
  * particular file as subject to the "Classpath" exception as provided
  * by Sun in the LICENSE file that accompanied this code.
  *
  * This code is distributed in the hope that it will be useful, but WITHOUT
  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  * version 2 for more details (a copy is included in the LICENSE file that
  * accompanied this code).
  *
  * You should have received a copy of the GNU General Public License version
  * 2 along with this work; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  *
  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  * CA 95054 USA or visit www.sun.com if you need additional information or
  * have any questions.
  */
 package com.sun.tools.classfile;
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.EnumSet;
 import java.util.List;
 import java.util.Set;
 import static com.sun.tools.classfile.ExtendedAnnotation.TargetAttribute.*;
 /**
  * See JSR 308 specification, section 4.1
  *
  *  <p><b>This is NOT part of any API supported by Sun Microsystems.  If
  *  you write code that depends on this, you do so at your own risk.
  *  This code and its internal interfaces are subject to change or
  *  deletion without notice.</b>
  */
 public class ExtendedAnnotation {
     ExtendedAnnotation(ClassReader cr) throws IOException, Annotation.InvalidAnnotation {
         annotation = new Annotation(cr);
         position = read_position(cr);
     }
     public ExtendedAnnotation(ConstantPool constant_pool,
             Annotation annotation, Position position) {
         this.annotation = annotation;
         this.position = position;
     }
     public int length() {
         int n = annotation.length();
         n += position_length(position);
         return n;
     }
     public final Annotation annotation;
     public final Position position;
     private static Position read_position(ClassReader cr) throws IOException, Annotation.InvalidAnnotation {
         // Copied from ClassReader
         int tag = (byte)cr.readUnsignedByte();  // cast to introduce signedness
         if (!TargetType.isValidTargetTypeValue(tag))
             throw new Annotation.InvalidAnnotation("invalid type annotation target type value: " + tag);
         TargetType type = TargetType.fromTargetTypeValue(tag);
         Position position = new Position();
         position.type = type;
         switch (type) {
         // type case
         case TYPECAST:
         case TYPECAST_GENERIC_OR_ARRAY:
         // object creation
         case INSTANCEOF:
         case INSTANCEOF_GENERIC_OR_ARRAY:
         // new expression
         case NEW:
         case NEW_GENERIC_OR_ARRAY:
             position.offset = cr.readUnsignedShort();
             break;
          // local variable
         case LOCAL_VARIABLE:
         case LOCAL_VARIABLE_GENERIC_OR_ARRAY:
             int table_length = cr.readUnsignedShort();
             position.lvarOffset = new int[table_length];
             position.lvarLength = new int[table_length];
             position.lvarIndex = new int[table_length];
             for (int i = 0; i < table_length; ++i) {
                 position.lvarOffset[i] = cr.readUnsignedShort();
                 position.lvarLength[i] = cr.readUnsignedShort();
                 position.lvarIndex[i] = cr.readUnsignedShort();
             }
             break;
          // method receiver
         case METHOD_RECEIVER:
             // Do nothing
             break;
         // type parameters
         case CLASS_TYPE_PARAMETER:
         case METHOD_TYPE_PARAMETER:
             position.parameter_index = cr.readUnsignedByte();
             break;
         // type parameter bounds
         case CLASS_TYPE_PARAMETER_BOUND:
         case CLASS_TYPE_PARAMETER_BOUND_GENERIC_OR_ARRAY:
         case METHOD_TYPE_PARAMETER_BOUND:
         case METHOD_TYPE_PARAMETER_BOUND_GENERIC_OR_ARRAY:
             position.parameter_index = cr.readUnsignedByte();
             position.bound_index = cr.readUnsignedByte();
             break;
          // wildcards
         case WILDCARD_BOUND:
         case WILDCARD_BOUND_GENERIC_OR_ARRAY:
             position.wildcard_position = read_position(cr);
             break;
          // Class extends and implements clauses
         case CLASS_EXTENDS:
         case CLASS_EXTENDS_GENERIC_OR_ARRAY:
             position.type_index = cr.readUnsignedByte();
             break;
         // throws
         case THROWS:
             position.type_index = cr.readUnsignedByte();
             break;
         case CLASS_LITERAL:
         case CLASS_LITERAL_GENERIC_OR_ARRAY:
             position.offset = cr.readUnsignedShort();
             break;
         // method parameter: not specified
         case METHOD_PARAMETER_GENERIC_OR_ARRAY:
             position.parameter_index = cr.readUnsignedByte();
             break;
         // method type argument: wasn't specified
         case NEW_TYPE_ARGUMENT:
         case NEW_TYPE_ARGUMENT_GENERIC_OR_ARRAY:
         case METHOD_TYPE_ARGUMENT:
         case METHOD_TYPE_ARGUMENT_GENERIC_OR_ARRAY:
             position.offset = cr.readUnsignedShort();
             position.type_index = cr.readUnsignedByte();
             break;
         // We don't need to worry abut these
         case METHOD_RETURN_GENERIC_OR_ARRAY:
         case FIELD_GENERIC_OR_ARRAY:
             break;
         case UNKNOWN:
             break;
         default:
             throw new AssertionError("Cannot be here");
         }
         if (type.hasLocation()) {
             int len = cr.readUnsignedShort();
             List<Integer> loc = new ArrayList<Integer>(len);
             for (int i = 0; i < len; i++)
                 loc.add(cr.readUnsignedByte());
             position.location = loc;
         }
         return position;
     }
     private static int position_length(Position pos) {
         int n = 0;
         n += 1; // target_type
         switch (pos.type) {
         // type case
         case TYPECAST:
         case TYPECAST_GENERIC_OR_ARRAY:
         // object creation
         case INSTANCEOF:
         case INSTANCEOF_GENERIC_OR_ARRAY:
         // new expression
         case NEW:
         case NEW_GENERIC_OR_ARRAY:
             n += 2;
             break;
          // local variable
         case LOCAL_VARIABLE:
         case LOCAL_VARIABLE_GENERIC_OR_ARRAY:
             n += 2; // table_length;
             int table_length = pos.lvarOffset.length;
             n += 2 * table_length; // offset
             n += 2 * table_length; // length;
             n += 2 * table_length; // index
             break;
          // method receiver
         case METHOD_RECEIVER:
             // Do nothing
             break;
         // type parameters
         case CLASS_TYPE_PARAMETER:
         case METHOD_TYPE_PARAMETER:
             n += 1; // parameter_index;
             break;
         // type parameter bounds
         case CLASS_TYPE_PARAMETER_BOUND:
         case CLASS_TYPE_PARAMETER_BOUND_GENERIC_OR_ARRAY:
         case METHOD_TYPE_PARAMETER_BOUND:
         case METHOD_TYPE_PARAMETER_BOUND_GENERIC_OR_ARRAY:
             n += 1; // parameter_index
             n += 1; // bound_index
             break;
         case WILDCARD_BOUND:
         case WILDCARD_BOUND_GENERIC_OR_ARRAY:
             n += position_length(pos.wildcard_position);
             break;
          // Class extends and implements clauses
         case CLASS_EXTENDS:
         case CLASS_EXTENDS_GENERIC_OR_ARRAY:
             n += 1; // type_index
             break;
         // throws
         case THROWS:
             n += 1; // type_index
             break;
         case CLASS_LITERAL:
         case CLASS_LITERAL_GENERIC_OR_ARRAY:
             n += 1; // offset
             break;
         // method parameter: not specified
         case METHOD_PARAMETER_GENERIC_OR_ARRAY:
             n += 1; // parameter_index
             break;
         // method type argument: wasn't specified
         case NEW_TYPE_ARGUMENT:
         case NEW_TYPE_ARGUMENT_GENERIC_OR_ARRAY:
         case METHOD_TYPE_ARGUMENT:
         case METHOD_TYPE_ARGUMENT_GENERIC_OR_ARRAY:
             n += 2; // offset
             n += 1; // type index
             break;
         // We don't need to worry abut these
         case METHOD_RETURN_GENERIC_OR_ARRAY:
         case FIELD_GENERIC_OR_ARRAY:
             break;
         case UNKNOWN:
             break;
         default:
         }
         if (pos.type.hasLocation()) {
             n += 2; // length
             n += 1 * pos.location.size(); // actual array size
         }
         return n;
     }
     // Code duplicated from com.sun.tools.javac.code.TypeAnnotations.Position
     public static class Position {
         public TargetType type = TargetType.UNKNOWN;
         // For generic/array types.
         public List<Integer> location = new ArrayList<Integer>();
         // Tree position.
         public int pos = -1;
         // For typecasts, type tests, new (and locals, as start_pc).
         public int offset = -1;
         // For locals.
         public int[] lvarOffset = new int[] { -1 };
         public int[] lvarLength = new int[] { -1 };
         public int[] lvarIndex = new int[] { -1 };
         // For type parameter bound
         public int bound_index = -1;
         // For type parameter and method parameter
         public int parameter_index = -1;
         // For class extends, implements, and throws classes
         public int type_index = -2;
         // For wildcards
         public Position wildcard_position = null;
         @Override
         public String toString() {
             StringBuilder sb = new StringBuilder();
             sb.append('[');
             sb.append(type);
             switch (type) {
             // type case
             case TYPECAST:
             case TYPECAST_GENERIC_OR_ARRAY:
             // object creation
             case INSTANCEOF:
             case INSTANCEOF_GENERIC_OR_ARRAY:
             // new expression
             case NEW:
             case NEW_GENERIC_OR_ARRAY:
             case NEW_TYPE_ARGUMENT:
             case NEW_TYPE_ARGUMENT_GENERIC_OR_ARRAY:
                 sb.append(", offset = ");
                 sb.append(offset);
                 break;
              // local variable
             case LOCAL_VARIABLE:
             case LOCAL_VARIABLE_GENERIC_OR_ARRAY:
                 sb.append(", {");
                 for (int i = 0; i < lvarOffset.length; ++i) {
                     if (i != 0) sb.append("; ");
                     sb.append(", start_pc = ");
                     sb.append(lvarOffset[i]);
                     sb.append(", length = ");
                     sb.append(lvarLength[i]);
                     sb.append(", index = ");
                     sb.append(lvarIndex[i]);
                 }
                 sb.append("}");
                 break;
              // method receiver
             case METHOD_RECEIVER:
                 // Do nothing
                 break;
             // type parameters
             case CLASS_TYPE_PARAMETER:
             case METHOD_TYPE_PARAMETER:
                 sb.append(", param_index = ");
                 sb.append(parameter_index);
                 break;
             // type parameters bound
             case CLASS_TYPE_PARAMETER_BOUND:
             case CLASS_TYPE_PARAMETER_BOUND_GENERIC_OR_ARRAY:
             case METHOD_TYPE_PARAMETER_BOUND:
             case METHOD_TYPE_PARAMETER_BOUND_GENERIC_OR_ARRAY:
                 sb.append(", param_index = ");
                 sb.append(parameter_index);
                 sb.append(", bound_index = ");
                 sb.append(bound_index);
                 break;
              // wildcard
             case WILDCARD_BOUND:
             case WILDCARD_BOUND_GENERIC_OR_ARRAY:
                 sb.append(", wild_card = ");
                 sb.append(wildcard_position);
                 break;
              // Class extends and implements clauses
             case CLASS_EXTENDS:
             case CLASS_EXTENDS_GENERIC_OR_ARRAY:
                 sb.append(", type_index = ");
                 sb.append(type_index);
                 break;
             // throws
             case THROWS:
                 sb.append(", type_index = ");
                 sb.append(type_index);
                 break;
             case CLASS_LITERAL:
                 sb.append(", offset = ");
                 sb.append(offset);
                 break;
             // method parameter: not specified
             case METHOD_PARAMETER_GENERIC_OR_ARRAY:
                 sb.append(", param_index = ");
                 sb.append(parameter_index);
                 break;
             // method type argument: wasn't specified
             case METHOD_TYPE_ARGUMENT:
             case METHOD_TYPE_ARGUMENT_GENERIC_OR_ARRAY:
                 sb.append(", offset = ");
                 sb.append(offset);
                 sb.append(", type_index = ");
                 sb.append(type_index);
                 break;
             // We don't need to worry abut these
             case METHOD_RETURN_GENERIC_OR_ARRAY:
             case FIELD_GENERIC_OR_ARRAY:
                 break;
             case UNKNOWN:
                 break;
             default:
                 throw new AssertionError("unknown type: " + type);
             }
             // Append location data for generics/arrays.
             if (type.hasLocation()) {
                 sb.append(", location = (");
                 sb.append(location);
                 sb.append(")");
             }
             sb.append(", pos = ");
             sb.append(pos);
             sb.append(']');
             return sb.toString();
         }
     }
     // Code duplicated from com.sun.tools.javac.comp.TargetType
     public enum TargetType {
         /** For annotations on typecasts. */
         TYPECAST(0x00),
         /** For annotations on a type argument or nested array of a typecast. */
         TYPECAST_GENERIC_OR_ARRAY(0x01, HasLocation),
         /** For annotations on type tests. */
         INSTANCEOF(0x02),
         /** For annotations on a type argument or nested array of a type test. */
         INSTANCEOF_GENERIC_OR_ARRAY(0x03, HasLocation),
         /** For annotations on object creation expressions. */
         NEW(0x04),
         /**
          * For annotations on a type argument or nested array of an object creation
          * expression.
          */
         NEW_GENERIC_OR_ARRAY(0x05, HasLocation),
         /** For annotations on the method receiver. */
         METHOD_RECEIVER(0x06),
         // invalid location
         // METHOD_RECEIVER_GENERIC_OR_ARRAY(0x07, HasLocation),
         /** For annotations on local variables. */
         LOCAL_VARIABLE(0x08),
         /** For annotations on a type argument or nested array of a local. */
         LOCAL_VARIABLE_GENERIC_OR_ARRAY(0x09, HasLocation),
         // already handled by regular annotations
         // METHOD_RETURN(0x0A),
         /**
          * For annotations on a type argument or nested array of a method return
          * type.
          */
         METHOD_RETURN_GENERIC_OR_ARRAY(0x0B, HasLocation),
         // already handled by regular annotations
         // METHOD_PARAMETER(0x0C),
         /** For annotations on a type argument or nested array of a method parameter. */
         METHOD_PARAMETER_GENERIC_OR_ARRAY(0x0D, HasLocation),
         // already handled by regular annotations
         // FIELD(0x0E),
         /** For annotations on a type argument or nested array of a field. */
         FIELD_GENERIC_OR_ARRAY(0x0F, HasLocation),
         /** For annotations on a bound of a type parameter of a class. */
         CLASS_TYPE_PARAMETER_BOUND(0x10, HasBound, HasParameter),
         /**
          * For annotations on a type argument or nested array of a bound of a type
          * parameter of a class.
          */
         CLASS_TYPE_PARAMETER_BOUND_GENERIC_OR_ARRAY(0x11, HasBound, HasLocation, HasParameter),
         /** For annotations on a bound of a type parameter of a method. */
         METHOD_TYPE_PARAMETER_BOUND(0x12, HasBound, HasParameter),
         /**
          * For annotations on a type argument or nested array of a bound of a type
          * parameter of a method.
          */
         METHOD_TYPE_PARAMETER_BOUND_GENERIC_OR_ARRAY(0x13, HasBound, HasLocation, HasParameter),
         /** For annotations on the type of an "extends" or "implements" clause. */
         CLASS_EXTENDS(0x14),
         /** For annotations on the inner type of an "extends" or "implements" clause. */
         CLASS_EXTENDS_GENERIC_OR_ARRAY(0x15, HasLocation),
         /** For annotations on a throws clause in a method declaration. */
         THROWS(0x16),
         // invalid location
         // THROWS_GENERIC_OR_ARRAY(0x17, HasLocation),
         /** For annotations in type arguments of object creation expressions. */
         NEW_TYPE_ARGUMENT(0x18),
         NEW_TYPE_ARGUMENT_GENERIC_OR_ARRAY(0x19, HasLocation),
         METHOD_TYPE_ARGUMENT(0x1A),
         METHOD_TYPE_ARGUMENT_GENERIC_OR_ARRAY(0x1B, HasLocation),
         WILDCARD_BOUND(0x1C, HasBound),
         WILDCARD_BOUND_GENERIC_OR_ARRAY(0x1D, HasBound, HasLocation),
         CLASS_LITERAL(0x1E),
         CLASS_LITERAL_GENERIC_OR_ARRAY(0x1F, HasLocation),
         METHOD_TYPE_PARAMETER(0x20, HasParameter),
         // invalid location
         // METHOD_TYPE_PARAMETER_GENERIC_OR_ARRAY(0x21, HasLocation, HasParameter),
         CLASS_TYPE_PARAMETER(0x22, HasParameter),
         // invalid location
         // CLASS_TYPE_PARAMETER_GENERIC_OR_ARRAY(0x23, HasLocation, HasParameter),
         /** For annotations with an unknown target. */
         UNKNOWN(-1);
         static final int MAXIMUM_TARGET_TYPE_VALUE = 0x22;
         private final int targetTypeValue;
         private Set<TargetAttribute> flags;
         TargetType(int targetTypeValue, TargetAttribute... attrs) {
             if (targetTypeValue < Byte.MIN_VALUE
                 || targetTypeValue > Byte.MAX_VALUE)
                 throw new AssertionError("attribute type value needs to be a byte: " + targetTypeValue);
             this.targetTypeValue = (byte)targetTypeValue;
             this.flags = EnumSet.noneOf(TargetAttribute.class);
             for (TargetAttribute attr : attrs)
                 this.flags.add(attr);
         }
         /**
          * Returns whether or not this TargetType represents an annotation whose
          * target is an inner type of a generic or array type.
          *
          * @return true if this TargetType represents an annotation on an inner
          *         type, false otherwise
          */
         public boolean hasLocation() {
             return flags.contains(HasLocation);
         }
         public TargetType getGenericComplement() {
             if (hasLocation())
                 return this;
             else
                 return fromTargetTypeValue(targetTypeValue() + 1);
         }
         /**
          * Returns whether or not this TargetType represents an annotation whose
          * target has a parameter index.
          *
          * @return true if this TargetType has a parameter index,
          *         false otherwise
          */
         public boolean hasParameter() {
             return flags.contains(HasParameter);
         }
         /**
          * Returns whether or not this TargetType represents an annotation whose
          * target is a type parameter bound.
          *
          * @return true if this TargetType represents an type parameter bound
          *         annotation, false otherwise
          */
         public boolean hasBound() {
             return flags.contains(HasBound);
         }
         public int targetTypeValue() {
             return this.targetTypeValue;
         }
         private static TargetType[] targets = null;
         private static TargetType[] buildTargets() {
             TargetType[] targets = new TargetType[MAXIMUM_TARGET_TYPE_VALUE + 1];
             TargetType[] alltargets = values();
             for (TargetType target : alltargets)
                 if (target.targetTypeValue >= 0)
                     targets[target.targetTypeValue] = target;
             for (int i = 0; i <= MAXIMUM_TARGET_TYPE_VALUE; ++i)
                 if (targets[i] == null)
                     targets[i] = UNKNOWN;
             return targets;
         }
         public static boolean isValidTargetTypeValue(int tag) {
             if (targets == null)
                 targets = buildTargets();
             if (((byte)tag) == ((byte)UNKNOWN.targetTypeValue))
                 return true;
             return (tag >= 0 && tag < targets.length);
         }
         public static TargetType fromTargetTypeValue(int tag) {
             if (targets == null)
                 targets = buildTargets();
             if (((byte)tag) == ((byte)UNKNOWN.targetTypeValue))
                 return UNKNOWN;
             if (tag < 0 || tag >= targets.length)
                 throw new IllegalArgumentException("Unknown TargetType: " + tag);
             return targets[tag];
         }
     }
     static enum TargetAttribute {
         HasLocation, HasParameter, HasBound;
     }
 }

Mercurial > jdk8-mips64-public > langtools / annotate

src/share/classes/com/sun/tools/classfile/ExtendedAnnotation.java@664edca41e34 (annotated)

src/share/classes/com/sun/tools/classfile/ExtendedAnnotation.java