arrayKlass.hpp revision 3602:da91efe96a93 
1/*
2 * Copyright (c) 1997, 2012, 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.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25#ifndef SHARE_VM_OOPS_ARRAYKLASS_HPP
26#define SHARE_VM_OOPS_ARRAYKLASS_HPP
27
28#include "memory/universe.hpp"
29#include "oops/klass.hpp"
30
31class klassVtable;
32
33// arrayKlass is the abstract baseclass for all array classes
34
35class arrayKlass: public Klass {
36  friend class VMStructs;
37 private:
38  int      _dimension;         // This is n'th-dimensional array.
39  Klass* volatile _higher_dimension;  // Refers the (n+1)'th-dimensional array (if present).
40  Klass* volatile _lower_dimension;   // Refers the (n-1)'th-dimensional array (if present).
41  int      _vtable_len;        // size of vtable for this klass
42  juint    _alloc_size;        // allocation profiling support
43  oop      _component_mirror;  // component type, as a java/lang/Class
44
45 protected:
46  // Constructors
47  // The constructor with the Symbol argument does the real array
48  // initialization, the other is a dummy
49  arrayKlass(Symbol* name);
50  arrayKlass() { assert(DumpSharedSpaces || UseSharedSpaces, "only for cds"); }
51
52 public:
53  // Testing operation
54  bool oop_is_array_slow() const { return true; }
55
56  // Instance variables
57  int dimension() const                 { return _dimension;      }
58  void set_dimension(int dimension)     { _dimension = dimension; }
59
60  Klass* higher_dimension() const     { return _higher_dimension; }
61  void set_higher_dimension(Klass* k) { _higher_dimension = k; }
62  Klass** adr_higher_dimension()      { return (Klass**)&this->_higher_dimension;}
63
64  Klass* lower_dimension() const      { return _lower_dimension; }
65  void set_lower_dimension(Klass* k)  { _lower_dimension = k; }
66  Klass** adr_lower_dimension()       { return (Klass**)&this->_lower_dimension;}
67
68  // Allocation profiling support
69  juint alloc_size() const              { return _alloc_size; }
70  void set_alloc_size(juint n)          { _alloc_size = n; }
71
72  // offset of first element, including any padding for the sake of alignment
73  int  array_header_in_bytes() const    { return layout_helper_header_size(layout_helper()); }
74  int  log2_element_size() const        { return layout_helper_log2_element_size(layout_helper()); }
75  // type of elements (T_OBJECT for both oop arrays and array-arrays)
76  BasicType element_type() const        { return layout_helper_element_type(layout_helper()); }
77
78  oop  component_mirror() const         { return _component_mirror; }
79  void set_component_mirror(oop m)      { klass_oop_store(&_component_mirror, m); }
80  oop* adr_component_mirror()           { return (oop*)&this->_component_mirror;}
81
82  // Compiler/Interpreter offset
83  static ByteSize component_mirror_offset() { return in_ByteSize(offset_of(arrayKlass, _component_mirror)); }
84
85  virtual Klass* java_super() const;//{ return SystemDictionary::Object_klass(); }
86
87  // Allocation
88  // Sizes points to the first dimension of the array, subsequent dimensions
89  // are always in higher memory.  The callers of these set that up.
90  virtual oop multi_allocate(int rank, jint* sizes, TRAPS);
91  objArrayOop allocate_arrayArray(int n, int length, TRAPS);
92
93  // Lookup operations
94  Method* uncached_lookup_method(Symbol* name, Symbol* signature) const;
95
96  // Casting from Klass*
97  static arrayKlass* cast(Klass* k) {
98    assert(k->oop_is_array(), "cast to arrayKlass");
99    return (arrayKlass*) k;
100  }
101
102  GrowableArray<Klass*>* compute_secondary_supers(int num_extra_slots);
103  bool compute_is_subtype_of(Klass* k);
104
105  // Sizing
106  static int header_size()                 { return sizeof(arrayKlass)/HeapWordSize; }
107  static int static_size(int header_size);
108
109  // Java vtable
110  klassVtable* vtable() const;             // return new klassVtable
111  int  vtable_length() const               { return _vtable_len; }
112  static int base_vtable_length()          { return Universe::base_vtable_size(); }
113  void set_vtable_length(int len)          { assert(len == base_vtable_length(), "bad length"); _vtable_len = len; }
114 protected:
115  inline intptr_t* start_of_vtable() const;
116
117 public:
118  // Iterators
119  void array_klasses_do(void f(Klass* k));
120  void array_klasses_do(void f(Klass* k, TRAPS), TRAPS);
121  void with_array_klasses_do(void f(Klass* k));
122
123  // GC support
124  virtual void oops_do(OopClosure* cl);
125
126  // Return a handle.
127  static void     complete_create_array_klass(arrayKlass* k, KlassHandle super_klass, TRAPS);
128
129
130  // jvm support
131  jint compute_modifier_flags(TRAPS) const;
132
133  // JVMTI support
134  jint jvmti_class_status() const;
135
136  // CDS support - remove and restore oops from metadata. Oops are not shared.
137  virtual void remove_unshareable_info();
138  virtual void restore_unshareable_info(TRAPS);
139
140  // Printing
141  void print_on(outputStream* st) const;
142  void print_value_on(outputStream* st) const;
143
144  void oop_print_on(oop obj, outputStream* st);
145
146  // Verification
147  void verify_on(outputStream* st);
148
149  void oop_verify_on(oop obj, outputStream* st);
150};
151
152#endif // SHARE_VM_OOPS_ARRAYKLASS_HPP
153