src/share/vm/classfile/classFileParser.hpp

Tue, 22 Mar 2011 13:36:33 -0700

author
jcoomes
date
Tue, 22 Mar 2011 13:36:33 -0700
changeset 2661
b099aaf51bf8
parent 2658
c7f3d0b4570f
child 2698
38fea01eb669
permissions
-rw-r--r--

6962931: move interned strings out of the perm gen
Reviewed-by: never, coleenp, ysr, jwilhelm

duke@435 1 /*
jrose@2639 2 * Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved.
duke@435 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@435 4 *
duke@435 5 * This code is free software; you can redistribute it and/or modify it
duke@435 6 * under the terms of the GNU General Public License version 2 only, as
duke@435 7 * published by the Free Software Foundation.
duke@435 8 *
duke@435 9 * This code is distributed in the hope that it will be useful, but WITHOUT
duke@435 10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@435 11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@435 12 * version 2 for more details (a copy is included in the LICENSE file that
duke@435 13 * accompanied this code).
duke@435 14 *
duke@435 15 * You should have received a copy of the GNU General Public License version
duke@435 16 * 2 along with this work; if not, write to the Free Software Foundation,
duke@435 17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@435 18 *
trims@1907 19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
trims@1907 20 * or visit www.oracle.com if you need additional information or have any
trims@1907 21 * questions.
duke@435 22 *
duke@435 23 */
duke@435 24
stefank@2314 25 #ifndef SHARE_VM_CLASSFILE_CLASSFILEPARSER_HPP
stefank@2314 26 #define SHARE_VM_CLASSFILE_CLASSFILEPARSER_HPP
stefank@2314 27
stefank@2314 28 #include "classfile/classFileStream.hpp"
stefank@2314 29 #include "memory/resourceArea.hpp"
stefank@2314 30 #include "oops/oop.inline.hpp"
stefank@2314 31 #include "oops/typeArrayOop.hpp"
stefank@2314 32 #include "runtime/handles.inline.hpp"
stefank@2314 33 #include "utilities/accessFlags.hpp"
stefank@2314 34
coleenp@2497 35 class TempNewSymbol;
duke@435 36 // Parser for for .class files
duke@435 37 //
duke@435 38 // The bytes describing the class file structure is read from a Stream object
duke@435 39
duke@435 40 class ClassFileParser VALUE_OBJ_CLASS_SPEC {
duke@435 41 private:
duke@435 42 bool _need_verify;
duke@435 43 bool _relax_verify;
duke@435 44 u2 _major_version;
duke@435 45 u2 _minor_version;
coleenp@2497 46 Symbol* _class_name;
jrose@1145 47 KlassHandle _host_klass;
jrose@866 48 GrowableArray<Handle>* _cp_patches; // overrides for CP entries
duke@435 49
duke@435 50 bool _has_finalizer;
duke@435 51 bool _has_empty_finalizer;
duke@435 52 bool _has_vanilla_constructor;
duke@435 53
jrose@2353 54 int _max_bootstrap_specifier_index;
jrose@2353 55
duke@435 56 enum { fixed_buffer_size = 128 };
duke@435 57 u_char linenumbertable_buffer[fixed_buffer_size];
duke@435 58
duke@435 59 ClassFileStream* _stream; // Actual input stream
duke@435 60
duke@435 61 enum { LegalClass, LegalField, LegalMethod }; // used to verify unqualified names
duke@435 62
duke@435 63 // Accessors
duke@435 64 ClassFileStream* stream() { return _stream; }
duke@435 65 void set_stream(ClassFileStream* st) { _stream = st; }
duke@435 66
duke@435 67 // Constant pool parsing
duke@435 68 void parse_constant_pool_entries(constantPoolHandle cp, int length, TRAPS);
duke@435 69
duke@435 70 constantPoolHandle parse_constant_pool(TRAPS);
duke@435 71
duke@435 72 // Interface parsing
duke@435 73 objArrayHandle parse_interfaces(constantPoolHandle cp,
duke@435 74 int length,
duke@435 75 Handle class_loader,
duke@435 76 Handle protection_domain,
coleenp@2497 77 Symbol* class_name,
duke@435 78 TRAPS);
duke@435 79
duke@435 80 // Field parsing
duke@435 81 void parse_field_attributes(constantPoolHandle cp, u2 attributes_count,
duke@435 82 bool is_static, u2 signature_index,
duke@435 83 u2* constantvalue_index_addr,
duke@435 84 bool* is_synthetic_addr,
duke@435 85 u2* generic_signature_index_addr,
duke@435 86 typeArrayHandle* field_annotations, TRAPS);
duke@435 87 typeArrayHandle parse_fields(constantPoolHandle cp, bool is_interface,
duke@435 88 struct FieldAllocationCount *fac,
duke@435 89 objArrayHandle* fields_annotations, TRAPS);
duke@435 90
duke@435 91 // Method parsing
duke@435 92 methodHandle parse_method(constantPoolHandle cp, bool is_interface,
duke@435 93 AccessFlags* promoted_flags,
duke@435 94 typeArrayHandle* method_annotations,
duke@435 95 typeArrayHandle* method_parameter_annotations,
duke@435 96 typeArrayHandle* method_default_annotations,
duke@435 97 TRAPS);
duke@435 98 objArrayHandle parse_methods (constantPoolHandle cp, bool is_interface,
duke@435 99 AccessFlags* promoted_flags,
duke@435 100 bool* has_final_method,
duke@435 101 objArrayOop* methods_annotations_oop,
duke@435 102 objArrayOop* methods_parameter_annotations_oop,
duke@435 103 objArrayOop* methods_default_annotations_oop,
duke@435 104 TRAPS);
duke@435 105 typeArrayHandle sort_methods (objArrayHandle methods,
duke@435 106 objArrayHandle methods_annotations,
duke@435 107 objArrayHandle methods_parameter_annotations,
duke@435 108 objArrayHandle methods_default_annotations,
duke@435 109 TRAPS);
duke@435 110 typeArrayHandle parse_exception_table(u4 code_length, u4 exception_table_length,
duke@435 111 constantPoolHandle cp, TRAPS);
duke@435 112 void parse_linenumber_table(
duke@435 113 u4 code_attribute_length, u4 code_length,
duke@435 114 CompressedLineNumberWriteStream** write_stream, TRAPS);
duke@435 115 u2* parse_localvariable_table(u4 code_length, u2 max_locals, u4 code_attribute_length,
duke@435 116 constantPoolHandle cp, u2* localvariable_table_length,
duke@435 117 bool isLVTT, TRAPS);
duke@435 118 u2* parse_checked_exceptions(u2* checked_exceptions_length, u4 method_attribute_length,
duke@435 119 constantPoolHandle cp, TRAPS);
duke@435 120 void parse_type_array(u2 array_length, u4 code_length, u4* u1_index, u4* u2_index,
duke@435 121 u1* u1_array, u2* u2_array, constantPoolHandle cp, TRAPS);
duke@435 122 typeArrayOop parse_stackmap_table(u4 code_attribute_length, TRAPS);
duke@435 123
duke@435 124 // Classfile attribute parsing
duke@435 125 void parse_classfile_sourcefile_attribute(constantPoolHandle cp, instanceKlassHandle k, TRAPS);
duke@435 126 void parse_classfile_source_debug_extension_attribute(constantPoolHandle cp,
duke@435 127 instanceKlassHandle k, int length, TRAPS);
duke@435 128 u2 parse_classfile_inner_classes_attribute(constantPoolHandle cp,
duke@435 129 instanceKlassHandle k, TRAPS);
duke@435 130 void parse_classfile_attributes(constantPoolHandle cp, instanceKlassHandle k, TRAPS);
duke@435 131 void parse_classfile_synthetic_attribute(constantPoolHandle cp, instanceKlassHandle k, TRAPS);
duke@435 132 void parse_classfile_signature_attribute(constantPoolHandle cp, instanceKlassHandle k, TRAPS);
jrose@2353 133 void parse_classfile_bootstrap_methods_attribute(constantPoolHandle cp, instanceKlassHandle k, u4 attribute_length, TRAPS);
duke@435 134
duke@435 135 // Annotations handling
duke@435 136 typeArrayHandle assemble_annotations(u1* runtime_visible_annotations,
duke@435 137 int runtime_visible_annotations_length,
duke@435 138 u1* runtime_invisible_annotations,
duke@435 139 int runtime_invisible_annotations_length, TRAPS);
duke@435 140
duke@435 141 // Final setup
jcoomes@1374 142 unsigned int compute_oop_map_count(instanceKlassHandle super,
jcoomes@1374 143 unsigned int nonstatic_oop_count,
jcoomes@1374 144 int first_nonstatic_oop_offset);
jcoomes@1374 145 void fill_oop_maps(instanceKlassHandle k,
jcoomes@1374 146 unsigned int nonstatic_oop_map_count,
jcoomes@1374 147 int* nonstatic_oop_offsets,
jcoomes@1374 148 unsigned int* nonstatic_oop_counts);
duke@435 149 void set_precomputed_flags(instanceKlassHandle k);
duke@435 150 objArrayHandle compute_transitive_interfaces(instanceKlassHandle super,
duke@435 151 objArrayHandle local_ifs, TRAPS);
duke@435 152
duke@435 153 // Special handling for certain classes.
duke@435 154 // Add the "discovered" field to java.lang.ref.Reference if
duke@435 155 // it does not exist.
duke@435 156 void java_lang_ref_Reference_fix_pre(typeArrayHandle* fields_ptr,
never@2658 157 constantPoolHandle cp,
never@2658 158 FieldAllocationCount *fac_ptr, TRAPS);
duke@435 159 // Adjust the field allocation counts for java.lang.Class to add
duke@435 160 // fake fields.
never@2658 161 void java_lang_Class_fix_pre(int* nonstatic_field_size,
never@2658 162 FieldAllocationCount *fac_ptr);
duke@435 163 // Adjust the next_nonstatic_oop_offset to place the fake fields
duke@435 164 // before any Java fields.
duke@435 165 void java_lang_Class_fix_post(int* next_nonstatic_oop_offset);
jrose@2639 166 // Adjust the field allocation counts for java.lang.invoke.MethodHandle to add
jrose@1145 167 // a fake address (void*) field.
jrose@2639 168 void java_lang_invoke_MethodHandle_fix_pre(constantPoolHandle cp,
twisti@2264 169 typeArrayHandle fields,
jrose@1145 170 FieldAllocationCount *fac_ptr, TRAPS);
duke@435 171
duke@435 172 // Format checker methods
duke@435 173 void classfile_parse_error(const char* msg, TRAPS);
duke@435 174 void classfile_parse_error(const char* msg, int index, TRAPS);
duke@435 175 void classfile_parse_error(const char* msg, const char *name, TRAPS);
duke@435 176 void classfile_parse_error(const char* msg, int index, const char *name, TRAPS);
duke@435 177 inline void guarantee_property(bool b, const char* msg, TRAPS) {
duke@435 178 if (!b) { classfile_parse_error(msg, CHECK); }
duke@435 179 }
duke@435 180
duke@435 181 inline void assert_property(bool b, const char* msg, TRAPS) {
duke@435 182 #ifdef ASSERT
duke@435 183 if (!b) { fatal(msg); }
duke@435 184 #endif
duke@435 185 }
duke@435 186
duke@435 187 inline void check_property(bool property, const char* msg, int index, TRAPS) {
duke@435 188 if (_need_verify) {
duke@435 189 guarantee_property(property, msg, index, CHECK);
duke@435 190 } else {
duke@435 191 assert_property(property, msg, CHECK);
duke@435 192 }
duke@435 193 }
duke@435 194
duke@435 195 inline void check_property(bool property, const char* msg, TRAPS) {
duke@435 196 if (_need_verify) {
duke@435 197 guarantee_property(property, msg, CHECK);
duke@435 198 } else {
duke@435 199 assert_property(property, msg, CHECK);
duke@435 200 }
duke@435 201 }
duke@435 202
duke@435 203 inline void guarantee_property(bool b, const char* msg, int index, TRAPS) {
duke@435 204 if (!b) { classfile_parse_error(msg, index, CHECK); }
duke@435 205 }
duke@435 206 inline void guarantee_property(bool b, const char* msg, const char *name, TRAPS) {
duke@435 207 if (!b) { classfile_parse_error(msg, name, CHECK); }
duke@435 208 }
duke@435 209 inline void guarantee_property(bool b, const char* msg, int index, const char *name, TRAPS) {
duke@435 210 if (!b) { classfile_parse_error(msg, index, name, CHECK); }
duke@435 211 }
duke@435 212
kamg@1941 213 void throwIllegalSignature(
coleenp@2497 214 const char* type, Symbol* name, Symbol* sig, TRAPS);
kamg@1941 215
duke@435 216 bool is_supported_version(u2 major, u2 minor);
duke@435 217 bool has_illegal_visibility(jint flags);
duke@435 218
duke@435 219 void verify_constantvalue(int constantvalue_index, int signature_index, constantPoolHandle cp, TRAPS);
duke@435 220 void verify_legal_utf8(const unsigned char* buffer, int length, TRAPS);
coleenp@2497 221 void verify_legal_class_name(Symbol* name, TRAPS);
coleenp@2497 222 void verify_legal_field_name(Symbol* name, TRAPS);
coleenp@2497 223 void verify_legal_method_name(Symbol* name, TRAPS);
coleenp@2497 224 void verify_legal_field_signature(Symbol* fieldname, Symbol* signature, TRAPS);
coleenp@2497 225 int verify_legal_method_signature(Symbol* methodname, Symbol* signature, TRAPS);
duke@435 226 void verify_legal_class_modifiers(jint flags, TRAPS);
duke@435 227 void verify_legal_field_modifiers(jint flags, bool is_interface, TRAPS);
coleenp@2497 228 void verify_legal_method_modifiers(jint flags, bool is_interface, Symbol* name, TRAPS);
duke@435 229 bool verify_unqualified_name(char* name, unsigned int length, int type);
duke@435 230 char* skip_over_field_name(char* name, bool slash_ok, unsigned int length);
duke@435 231 char* skip_over_field_signature(char* signature, bool void_ok, unsigned int length, TRAPS);
duke@435 232
jrose@1145 233 bool is_anonymous() {
jrose@1145 234 assert(AnonymousClasses || _host_klass.is_null(), "");
jrose@1145 235 return _host_klass.not_null();
jrose@1145 236 }
jrose@866 237 bool has_cp_patch_at(int index) {
jrose@866 238 assert(AnonymousClasses, "");
jrose@866 239 assert(index >= 0, "oob");
jrose@866 240 return (_cp_patches != NULL
jrose@866 241 && index < _cp_patches->length()
jrose@866 242 && _cp_patches->adr_at(index)->not_null());
jrose@866 243 }
jrose@866 244 Handle cp_patch_at(int index) {
jrose@866 245 assert(has_cp_patch_at(index), "oob");
jrose@866 246 return _cp_patches->at(index);
jrose@866 247 }
jrose@866 248 Handle clear_cp_patch_at(int index) {
jrose@866 249 Handle patch = cp_patch_at(index);
jrose@866 250 _cp_patches->at_put(index, Handle());
jrose@866 251 assert(!has_cp_patch_at(index), "");
jrose@866 252 return patch;
jrose@866 253 }
jrose@866 254 void patch_constant_pool(constantPoolHandle cp, int index, Handle patch, TRAPS);
jrose@866 255
jrose@866 256 // Wrapper for constantTag.is_klass_[or_]reference.
jrose@866 257 // In older versions of the VM, klassOops cannot sneak into early phases of
jrose@866 258 // constant pool construction, but in later versions they can.
jrose@866 259 // %%% Let's phase out the old is_klass_reference.
jrose@866 260 bool is_klass_reference(constantPoolHandle cp, int index) {
jrose@866 261 return ((LinkWellKnownClasses || AnonymousClasses)
jrose@866 262 ? cp->tag_at(index).is_klass_or_reference()
jrose@866 263 : cp->tag_at(index).is_klass_reference());
jrose@866 264 }
jrose@866 265
duke@435 266 public:
duke@435 267 // Constructor
duke@435 268 ClassFileParser(ClassFileStream* st) { set_stream(st); }
duke@435 269
duke@435 270 // Parse .class file and return new klassOop. The klassOop is not hooked up
duke@435 271 // to the system dictionary or any other structures, so a .class file can
duke@435 272 // be loaded several times if desired.
duke@435 273 // The system dictionary hookup is done by the caller.
duke@435 274 //
duke@435 275 // "parsed_name" is updated by this method, and is the name found
duke@435 276 // while parsing the stream.
coleenp@2497 277 instanceKlassHandle parseClassFile(Symbol* name,
duke@435 278 Handle class_loader,
duke@435 279 Handle protection_domain,
coleenp@2497 280 TempNewSymbol& parsed_name,
acorn@1408 281 bool verify,
jrose@866 282 TRAPS) {
jrose@1145 283 KlassHandle no_host_klass;
acorn@1408 284 return parseClassFile(name, class_loader, protection_domain, no_host_klass, NULL, parsed_name, verify, THREAD);
jrose@866 285 }
coleenp@2497 286 instanceKlassHandle parseClassFile(Symbol* name,
jrose@866 287 Handle class_loader,
jrose@866 288 Handle protection_domain,
jrose@1145 289 KlassHandle host_klass,
jrose@866 290 GrowableArray<Handle>* cp_patches,
coleenp@2497 291 TempNewSymbol& parsed_name,
acorn@1408 292 bool verify,
duke@435 293 TRAPS);
duke@435 294
duke@435 295 // Verifier checks
duke@435 296 static void check_super_class_access(instanceKlassHandle this_klass, TRAPS);
duke@435 297 static void check_super_interface_access(instanceKlassHandle this_klass, TRAPS);
duke@435 298 static void check_final_method_override(instanceKlassHandle this_klass, TRAPS);
duke@435 299 static void check_illegal_static_method(instanceKlassHandle this_klass, TRAPS);
duke@435 300 };
stefank@2314 301
stefank@2314 302 #endif // SHARE_VM_CLASSFILE_CLASSFILEPARSER_HPP

mercurial