1 /*
  2  * Copyright (c) 2007, 2020, Oracle and/or its affiliates. All rights reserved.
  3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  4  *
  5  * This code is free software; you can redistribute it and/or modify it
  6  * under the terms of the GNU General Public License version 2 only, as
  7  * published by the Free Software Foundation.  Oracle designates this
  8  * particular file as subject to the "Classpath" exception as provided
  9  * by Oracle in the LICENSE file that accompanied this code.
 10  *
 11  * This code is distributed in the hope that it will be useful, but WITHOUT
 12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 14  * version 2 for more details (a copy is included in the LICENSE file that
 15  * accompanied this code).
 16  *
 17  * You should have received a copy of the GNU General Public License version
 18  * 2 along with this work; if not, write to the Free Software Foundation,
 19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 20  *
 21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 22  * or visit www.oracle.com if you need additional information or have any
 23  * questions.
 24  */
 25 
 26 package com.sun.tools.classfile;
 27 
 28 import java.io.IOException;
 29 import java.lang.reflect.Constructor;
 30 import java.util.HashMap;
 31 import java.util.Map;
 32 
 33 /**
 34  *  <p><b>This is NOT part of any supported API.
 35  *  If you write code that depends on this, you do so at your own risk.
 36  *  This code and its internal interfaces are subject to change or
 37  *  deletion without notice.</b>
 38  */
 39 
 40 public abstract class Attribute {
 41     public static final String AnnotationDefault        = "AnnotationDefault";
 42     public static final String BootstrapMethods         = "BootstrapMethods";
 43     public static final String CharacterRangeTable      = "CharacterRangeTable";
 44     public static final String Code                     = "Code";
 45     public static final String ConstantValue            = "ConstantValue";
 46     public static final String CompilationID            = "CompilationID";
 47     public static final String Deprecated               = "Deprecated";
 48     public static final String EnclosingMethod          = "EnclosingMethod";
 49     public static final String Exceptions               = "Exceptions";
 50     public static final String InnerClasses             = "InnerClasses";
 51     public static final String LineNumberTable          = "LineNumberTable";
 52     public static final String LocalVariableTable       = "LocalVariableTable";
 53     public static final String LocalVariableTypeTable   = "LocalVariableTypeTable";
 54     public static final String MethodParameters         = "MethodParameters";
 55     public static final String Module                   = "Module";
 56     public static final String ModuleHashes             = "ModuleHashes";
 57     public static final String ModuleMainClass          = "ModuleMainClass";
 58     public static final String ModulePackages           = "ModulePackages";
 59     public static final String ModuleResolution         = "ModuleResolution";
 60     public static final String ModuleTarget             = "ModuleTarget";
 61     public static final String NestHost                 = "NestHost";
 62     public static final String NestMembers              = "NestMembers";
 63     public static final String LoadableDescriptors      = "LoadableDescriptors";
 64     public static final String Record                   = "Record";
 65     public static final String RuntimeVisibleAnnotations = "RuntimeVisibleAnnotations";
 66     public static final String RuntimeInvisibleAnnotations = "RuntimeInvisibleAnnotations";
 67     public static final String RuntimeVisibleParameterAnnotations = "RuntimeVisibleParameterAnnotations";
 68     public static final String RuntimeInvisibleParameterAnnotations = "RuntimeInvisibleParameterAnnotations";
 69     public static final String RuntimeVisibleTypeAnnotations = "RuntimeVisibleTypeAnnotations";
 70     public static final String RuntimeInvisibleTypeAnnotations = "RuntimeInvisibleTypeAnnotations";
 71     public static final String PermittedSubclasses      = "PermittedSubclasses";
 72     public static final String Signature                = "Signature";
 73     public static final String SourceDebugExtension     = "SourceDebugExtension";
 74     public static final String SourceFile               = "SourceFile";
 75     public static final String SourceID                 = "SourceID";
 76     public static final String StackMap                 = "StackMap";
 77     public static final String StackMapTable            = "StackMapTable";
 78     public static final String Synthetic                = "Synthetic";
 79 
 80     public static class Factory {
 81         public Factory() {
 82             // defer init of standardAttributeClasses until after options set up
 83         }
 84 
 85         public Attribute createAttribute(ClassReader cr, int name_index, byte[] data)
 86                 throws IOException {
 87             if (standardAttributes == null) {
 88                 init();
 89             }
 90 
 91             ConstantPool cp = cr.getConstantPool();
 92             String reasonForDefaultAttr;
 93             try {
 94                 String name = cp.getUTF8Value(name_index);
 95                 Class<? extends Attribute> attrClass = standardAttributes.get(name);
 96                 if (attrClass != null) {
 97                     try {
 98                         Class<?>[] constrArgTypes = {ClassReader.class, int.class, int.class};
 99                         Constructor<? extends Attribute> constr = attrClass.getDeclaredConstructor(constrArgTypes);
100                         return constr.newInstance(cr, name_index, data.length);
101                     } catch (Throwable t) {
102                         reasonForDefaultAttr = t.toString();
103                         // fall through and use DefaultAttribute
104                         // t.printStackTrace();
105                     }
106                 } else {
107                     reasonForDefaultAttr = "unknown attribute";
108                 }
109             } catch (ConstantPoolException e) {
110                 reasonForDefaultAttr = e.toString();
111                 // fall through and use DefaultAttribute
112             }
113             return new DefaultAttribute(cr, name_index, data, reasonForDefaultAttr);
114         }
115 
116         protected void init() {
117             standardAttributes = new HashMap<>();
118             standardAttributes.put(AnnotationDefault, AnnotationDefault_attribute.class);
119             standardAttributes.put(BootstrapMethods,  BootstrapMethods_attribute.class);
120             standardAttributes.put(CharacterRangeTable, CharacterRangeTable_attribute.class);
121             standardAttributes.put(Code,              Code_attribute.class);
122             standardAttributes.put(CompilationID,     CompilationID_attribute.class);
123             standardAttributes.put(ConstantValue,     ConstantValue_attribute.class);
124             standardAttributes.put(Deprecated,        Deprecated_attribute.class);
125             standardAttributes.put(EnclosingMethod,   EnclosingMethod_attribute.class);
126             standardAttributes.put(Exceptions,        Exceptions_attribute.class);
127             standardAttributes.put(InnerClasses,      InnerClasses_attribute.class);
128             standardAttributes.put(LineNumberTable,   LineNumberTable_attribute.class);
129             standardAttributes.put(LocalVariableTable, LocalVariableTable_attribute.class);
130             standardAttributes.put(LocalVariableTypeTable, LocalVariableTypeTable_attribute.class);
131             standardAttributes.put(MethodParameters,  MethodParameters_attribute.class);
132             standardAttributes.put(Module,            Module_attribute.class);
133             standardAttributes.put(ModuleHashes,      ModuleHashes_attribute.class);
134             standardAttributes.put(ModuleMainClass,   ModuleMainClass_attribute.class);
135             standardAttributes.put(ModulePackages,    ModulePackages_attribute.class);
136             standardAttributes.put(ModuleResolution,  ModuleResolution_attribute.class);
137             standardAttributes.put(ModuleTarget,      ModuleTarget_attribute.class);
138             standardAttributes.put(NestHost, NestHost_attribute.class);
139             standardAttributes.put(NestMembers, NestMembers_attribute.class);
140             standardAttributes.put(LoadableDescriptors, LoadableDescriptors_attribute.class);
141             standardAttributes.put(Record, Record_attribute.class);
142             standardAttributes.put(RuntimeInvisibleAnnotations, RuntimeInvisibleAnnotations_attribute.class);
143             standardAttributes.put(RuntimeInvisibleParameterAnnotations, RuntimeInvisibleParameterAnnotations_attribute.class);
144             standardAttributes.put(RuntimeVisibleAnnotations, RuntimeVisibleAnnotations_attribute.class);
145             standardAttributes.put(RuntimeVisibleParameterAnnotations, RuntimeVisibleParameterAnnotations_attribute.class);
146             standardAttributes.put(RuntimeVisibleTypeAnnotations, RuntimeVisibleTypeAnnotations_attribute.class);
147             standardAttributes.put(RuntimeInvisibleTypeAnnotations, RuntimeInvisibleTypeAnnotations_attribute.class);
148             standardAttributes.put(PermittedSubclasses, PermittedSubclasses_attribute.class);
149             standardAttributes.put(Signature,         Signature_attribute.class);
150             standardAttributes.put(SourceDebugExtension, SourceDebugExtension_attribute.class);
151             standardAttributes.put(SourceFile,        SourceFile_attribute.class);
152             standardAttributes.put(SourceID,          SourceID_attribute.class);
153             standardAttributes.put(StackMap,          StackMap_attribute.class);
154             standardAttributes.put(StackMapTable,     StackMapTable_attribute.class);
155             standardAttributes.put(Synthetic,         Synthetic_attribute.class);
156         }
157 
158         private Map<String,Class<? extends Attribute>> standardAttributes;
159     }
160 
161     public static Attribute read(ClassReader cr) throws IOException {
162         return cr.readAttribute();
163     }
164 
165     protected Attribute(int name_index, int length) {
166         attribute_name_index = name_index;
167         attribute_length = length;
168     }
169 
170     public String getName(ConstantPool constant_pool) throws ConstantPoolException {
171         return constant_pool.getUTF8Value(attribute_name_index);
172     }
173 
174     public abstract <R,D> R accept(Attribute.Visitor<R,D> visitor, D data);
175 
176     public int byteLength() {
177         return 6 + attribute_length;
178     }
179 
180     public final int attribute_name_index;
181     public final int attribute_length;
182 
183 
184     public interface Visitor<R,P> {
185         R visitBootstrapMethods(BootstrapMethods_attribute attr, P p);
186         R visitDefault(DefaultAttribute attr, P p);
187         R visitAnnotationDefault(AnnotationDefault_attribute attr, P p);
188         R visitCharacterRangeTable(CharacterRangeTable_attribute attr, P p);
189         R visitCode(Code_attribute attr, P p);
190         R visitCompilationID(CompilationID_attribute attr, P p);
191         R visitConstantValue(ConstantValue_attribute attr, P p);
192         R visitDeprecated(Deprecated_attribute attr, P p);
193         R visitEnclosingMethod(EnclosingMethod_attribute attr, P p);
194         R visitExceptions(Exceptions_attribute attr, P p);
195         R visitInnerClasses(InnerClasses_attribute attr, P p);
196         R visitLineNumberTable(LineNumberTable_attribute attr, P p);
197         R visitLoadableDescriptors(LoadableDescriptors_attribute attr, P p);
198         R visitLocalVariableTable(LocalVariableTable_attribute attr, P p);
199         R visitLocalVariableTypeTable(LocalVariableTypeTable_attribute attr, P p);
200         R visitMethodParameters(MethodParameters_attribute attr, P p);
201         R visitModule(Module_attribute attr, P p);
202         R visitModuleHashes(ModuleHashes_attribute attr, P p);
203         R visitModuleMainClass(ModuleMainClass_attribute attr, P p);
204         R visitModulePackages(ModulePackages_attribute attr, P p);
205         R visitModuleResolution(ModuleResolution_attribute attr, P p);
206         R visitModuleTarget(ModuleTarget_attribute attr, P p);
207         R visitNestHost(NestHost_attribute attr, P p);
208         R visitNestMembers(NestMembers_attribute attr, P p);
209         R visitRecord(Record_attribute attr, P p);
210         R visitRuntimeVisibleAnnotations(RuntimeVisibleAnnotations_attribute attr, P p);
211         R visitRuntimeInvisibleAnnotations(RuntimeInvisibleAnnotations_attribute attr, P p);
212         R visitRuntimeVisibleParameterAnnotations(RuntimeVisibleParameterAnnotations_attribute attr, P p);
213         R visitRuntimeInvisibleParameterAnnotations(RuntimeInvisibleParameterAnnotations_attribute attr, P p);
214         R visitRuntimeVisibleTypeAnnotations(RuntimeVisibleTypeAnnotations_attribute attr, P p);
215         R visitRuntimeInvisibleTypeAnnotations(RuntimeInvisibleTypeAnnotations_attribute attr, P p);
216         R visitPermittedSubclasses(PermittedSubclasses_attribute attr, P p);
217         R visitSignature(Signature_attribute attr, P p);
218         R visitSourceDebugExtension(SourceDebugExtension_attribute attr, P p);
219         R visitSourceFile(SourceFile_attribute attr, P p);
220         R visitSourceID(SourceID_attribute attr, P p);
221         R visitStackMap(StackMap_attribute attr, P p);
222         R visitStackMapTable(StackMapTable_attribute attr, P p);
223         R visitSynthetic(Synthetic_attribute attr, P p);
224     }
225 }