2.11 在ClassFile、method_info、field_info中同时存在的Attribute
2.11.1 Synthetic Attribute
Synthetic Attribute用于指示当前类、接口、方法或字段由编译器生成,而不在源代码中存在(不包含类初始函数和实例初始函数)。相同的功能还有一种方式就是在类、接口、方法或字段的访问权限中设置ACC_SYNTHETIC标记。
Synthetic Attribute由JDK1.1中引入,以支持内嵌类和接口(nested classes and interfaces)。但是以我现在所知,这些功能都是可以通过ACC_SYNTHETIC标记来表达的,为什么还需要存在Synthetic Attribute呢?在什么样的情况下会生成Synthetic Attribute项呢?我还没有找到,需要继续研究。
| Synthetic Attribute |
||
| type |
descriptor |
remark |
| u2 |
attribute_name_index |
constant_pool中的索引,CONSTANT_Utf8_info类型。指定Attribute名称(“Synthetic”)。 |
| u4 |
attribute_length |
该Attribute内容的字节长度(0)。 |
2.11.2 Signature Attribute
| Signature Attribute |
||
| type |
descriptor |
remark |
| u2 |
attribute_name_index |
constant_pool中的索引,CONSTANT_Utf8_info类型。指定Attribute名称(“Signature”)。 |
| u4 |
attribute_length |
该Attribute内容的字节长度(2)。 |
| u2 |
signature_index |
constant_pool中的索引,CONSTANT_Utf8_info类型。记录当前类型的签名(类签名、字段签名、方法签名)。 |
JVM规范中没有指定什么情况下需要生成Signature Attribute。但是从Signature的目的是用于泛型类型,可以推测Signature Attribute存在于当前Signature Attribute所在类型是泛型(泛型类、泛型方法、泛型字段)的时候。它和field_info、method_info、this_class一起对应于局部变量中的LocalVariableTable Attribute和LocalVariableTypeTable Attribute,他们同时都有descriptor版本和signature版本。
2.11.3 Deprecated Attribute
Deprecated Attribute指示当前类、方法、字段已经过时了,一些工具,如编译器可以根据该Attribute提示用户他们使用的类、方法、字段已经过时了,最好使用最新版本的类、方法、字段。
| Deprecated Attribute |
||
| type |
descriptor |
remark |
| u2 |
attribute_name_index |
constant_pool中的索引,CONSTANT_Utf8_info类型。指定Attribute名称(“Deprecated”)。 |
| u4 |
attribute_length |
该Attribute内容的字节长度(0)。 |
2.11.4 RuntimeVisibleAnnotations Attribute
RuntimeVisibleAnnotations Attribute记录了当前类、方法、字段在源代码中定义的、在运行时可见的Annotation。Java程序可以通过反射函数获取这些Annotation。一个attributes集合中只能包含一项RuntimeVisibleAnnotations Attribute,记录所有运行时可见的Annotation。
| RuntimeVisibleAnnotations Attribute |
||
| type |
descriptor |
remark |
| u2 |
attribute_name_index |
constant_pool中的索引,CONSTANT_Utf8_info类型。指定Attribute名称(“RuntimeVisibleAnnotations”)。 |
| u4 |
attribute_length |
该Attribute内容的字节长度。 |
| u2 |
num_annotations |
annotations集合长度。 |
| annotation |
annotations[num_annotations] |
记录所有运行时可见的annotation的集合。annotation类型详见附录E。 |
2.11.5 RuntimeInvisibleParameterAnotations Attribute
RuntimeInvisibleAnnotations Attribute记录了当前类、方法、字段在源代码中定义的、在运行时不可见的Annotation。默认情况下,这些Annotation是不可被Java提供的反射函数获取的,需要通过和实现相关的机制来获取这些Annotation。一个attributes集合中只能包含一项RuntimeInvisibleAnnotations Attribute,记录所有运行时不可见的Annotation。
| RuntimeInvisibleAnnotations Attribute |
||
| type |
descriptor |
remark |
| u2 |
attribute_name_index |
constant_pool中的索引,CONSTANT_Utf8_info类型。指定Attribute名称(“RuntimeInvisibleAnnotations”)。 |
| u4 |
attribute_length |
该Attribute内容的字节长度。 |
| u2 |
num_annotations |
annotations集合长度。 |
| annotation |
annotations[num_annotations] |
记录所有运行时不可见的annotation的集合。annotation类型详见附录E。 |
总体格式
| magic(0xCAFEBABE) |
|||||||||||||
| version(major.minor) |
|||||||||||||
| constant pool
| |||||||||||||